HandsOnChain

純資産から基準価額を出す

作るもの

このレッスンを終えると、運用会社の役割を持つアカウントだけが、約定日の純資産の総額をファンドに入れられます。
ファンドは入れた額を口数で割り、1万口あたりの基準価額を約定日ごとに残します。
口数が0の間の基準価額は10,000円です。
役割のない人が純資産を入れようとすると断ることは、Foundryのテストで確かめられます。

背景

基準価額は、ファンドの純資産の総額を口数で割り、1万口あたりに直した値段です。
純資産の総額は、ファンドが持つ株や債券をその日の時価で評価した額に現金や受け取る配当を足し、払う費用を引いた額です。
委託会社は毎営業日、市場が閉まった後の時価で純資産の総額を計算し、その日の基準価額を出して公表します。
受託会社の信託銀行も同じ計算を別に行い、2つの結果を突き合わせます。

値 このコースのテストの例
純資産の総額 122,550,000円
口数 120,000,000口
1口あたり 122,550,000円 ÷ 120,000,000口 = 1.02125円
1万口あたりの基準価額 1.02125円 × 10,000 = 10,212.5円。
1円未満を切り捨てて10,212円

ファンドを始める日は口数がまだ0なので、純資産の総額を口数で割れません。
そこで口数が0の間は、始めの基準価額の1万口あたり10,000円を使います。
1口を1円として始めるファンドと同じ値です。

チェーンの上のコントラクトは、株や債券の時価を自分で読めません。
そのため純資産の総額は、委託会社にあたる運用会社がチェーンの外で計算し、取引を送って入れます。
口数はチェーンの上のトークンの総量なので、コントラクトが自分で数えられます。
運用会社が入れるのは純資産の総額だけにし、口数で割る計算はコントラクトが行います。

入れた純資産の総額と口数はどちらもチェーンに残るため、誰でも同じ基準価額を計算し直せます。
純資産を入れられるのは、運用会社の役割を持つアカウントだけにします。
投資家が自分で純資産を書けると、基準価額を高くして解約の代金を増やせてしまうためです。

役割 持つアカウント できること
DEFAULT_ADMIN_ROLE デプロイのアカウント 運用会社の役割を渡し、取り上げる
MANAGER_ROLE 運用会社 約定日の純資産の総額を入れる。
後の節では注文の約定も行う

基準価額は約定日ごとに1つ決まります。
コントラクトは、日本時間の日付を1970-01-01からの日の通し番号で表します。
2026-03-05 (木) の番号は20517です。

純資産は約定日の順に入れ、前に入れた日と同じ日やそれより前の日には入れられません。
一度決めた基準価額を、後から書き換えられないようにするためです。
後の節では、この基準価額で申込と解約の注文を約定します。
信託報酬を純資産から差し引く計算は、信託報酬と解約の上限の節で足します。

運用会社が入れた純資産から基準価額が決まる
チェーンに残る値口数120,000,000口2026-03-05の基準価額まだない10,212円運用会社MANAGER_ROLE を持つ投資家A役割を持たないファンドTokenizedFund112233setNav(20517, 122,550,000)setNav(20517, 122,550,000)setNav(20517, 0)navFor(122,550,000)navFor(122,550,000)AccessControlUnauthorizedAccount で断る

実装

starter/contracts/contracts/TokenizedFund.solに書き足します。
まず、AccessControlを読み込んでファンドに継承させ、運用会社の役割と基準価額の決まりの値を並べます。

import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import {AccessControl} from "@openzeppelin/contracts/access/AccessControl.sol";
import {JpyToken} from "@handsonchain/jpy-stablecoin-contracts/contracts/JpyToken.sol";
contract TokenizedFund is ERC20, AccessControl {
    /// @notice 約定日の純資産の総額を入れ、注文を約定する運用会社の役
    bytes32 public constant MANAGER_ROLE = keccak256("MANAGER_ROLE");
    /// @notice 基準価額を表す口数 (1万口)
    uint256 public constant NAV_UNITS = 10_000;
    /// @notice 口数が0の時の基準価額 (1万口あたり10,000円)
    uint256 public constant INITIAL_NAV = 10_000;
    // 日本時間と協定世界時の差
    uint256 private constant JST = 9 hours;

    /// @notice 申込と解約に使う1作目の円トークン
    JpyToken public immutable jpy;
行 意味
import {AccessControl} ... OpenZeppelin Contractsの役割の仕組みを読み込む
is ERC20, AccessControl 持分のトークンのまま、関数を呼べるアカウントを役割で分けられるようにする
MANAGER_ROLE 純資産の総額を入れる運用会社の役割の名前
NAV_UNITS 基準価額を何口あたりで表すか。
1万口にする
INITIAL_NAV 口数が0の時に使う、1万口あたり10,000円の基準価額
JST 日本時間は協定世界時より9時間進んでいる。
ブロックの時刻から日本時間の日付を出す時に足す

続けて、managerの後に約定日ごとの基準価額とイベントを足し、NotAllowedの後にエラーを足します。

    /// @notice 約定日ごとの1万口あたりの基準価額。入れる前は0
    mapping(uint256 day => uint256) public navOf;
    /// @notice 最後に純資産を入れた約定日
    uint256 public lastNavDay;

    event NavSet(uint256 indexed day, uint256 netAssets, uint256 nav);

    error NotAllowed(address account);
    error NavOutOfOrder(uint256 day, uint256 lastNavDay);
    error ZeroNav(uint256 day);
行 意味
navOf 約定日の番号から、その日の1万口あたりの基準価額を引く。
まだ入れていない日は0
lastNavDay 最後に純資産を入れた約定日の番号。
次に入れる日はこれより後でなければならない
NavSet 純資産を入れた時に、約定日と純資産の総額と基準価額をイベントとして残す。
画面が基準価額の移り変わりを追える
NavOutOfOrder 前に入れた約定日と同じ日か、それより前の日の純資産を入れようとした
ZeroNav 口数に比べて純資産が小さすぎて、基準価額が0円になった

constructorの最後に、2つの役割を渡す行を足します。

    constructor(JpyToken jpy_, address manager_) ERC20("HandsOn Fund", "HOF") {
        jpy = jpy_;
        manager = manager_;
        _grantRole(DEFAULT_ADMIN_ROLE, msg.sender);
        _grantRole(MANAGER_ROLE, manager_);
    }
行 意味
_grantRole(DEFAULT_ADMIN_ROLE, msg.sender) デプロイしたアカウントに、役割を渡し直す管理の役割を持たせる
_grantRole(MANAGER_ROLE, manager_) 運用会社のアカウントに、純資産を入れる役割を渡す

次に、decimalsの後に3つの関数を足します。
日付の番号を出すdayOf、基準価額を出すnavFor、純資産を入れるsetNavです。

    /// @notice 日本時間の日付を、1970-01-01からの日の通し番号で返す。約定日はこの番号で表す
    function dayOf(uint256 timestamp) public pure returns (uint256) {
        return (timestamp + JST) / 1 days;
    }

    /// @notice 純資産の額から1万口あたりの基準価額を出す。1円未満は切り捨て、口数が0の時は10,000円
    function navFor(uint256 netAssets) public view returns (uint256) {
        uint256 units = totalSupply();
        if (units == 0) return INITIAL_NAV;
        return netAssets * NAV_UNITS / units;
    }

    /// @notice 運用会社が約定日の純資産の総額 (円) を入れ、その日の基準価額を決める
    function setNav(uint256 day, uint256 netAssets) external onlyRole(MANAGER_ROLE) {
        if (day <= lastNavDay) revert NavOutOfOrder(day, lastNavDay);
        uint256 nav = navFor(netAssets);
        if (nav == 0) revert ZeroNav(day);
        navOf[day] = nav;
        lastNavDay = day;
        emit NavSet(day, netAssets, nav);
    }
行 意味
(timestamp + JST) / 1 days 日本時間に直した時刻を1日の秒数で割り、余りを捨てる。
2026-03-05 (木) の0時から23時59分までは、どれも20517になる
totalSupply() 今ある全ての口数。
トークンの総量をそのまま口数として数える
if (units == 0) return INITIAL_NAV 口数が0の間は0で割らずに、1万口あたり10,000円を返す
netAssets * NAV_UNITS / units 先に1万を掛けてから口数で割り、1円未満を切り捨てる
onlyRole(MANAGER_ROLE) 運用会社の役割を持たないアカウントが呼ぶと、AccessControlがAccessControlUnauthorizedAccountのエラーで断る
day <= lastNavDay 前に入れた約定日と同じ日か、それより前の日を断る。
決めた基準価額は書き換えられない
nav == 0 基準価額が0円になる時は断る。
後の節では申込の円を基準価額で割って口数を出すため、0円の基準価額は使えない
navOf[day] = navとlastNavDay = day その日の基準価額と、最後に入れた約定日を書く

navForはpublicなので、運用会社は純資産を入れる前に、その額でいくらの基準価額になるかを読めます。
setNavも同じnavForで計算するため、読んだ値と入れた後の値は食い違いません。

次に、starter/contracts/test/TokenizedFund.t.solのimportに、役割のエラーを読む行を足します。

import {Test} from "forge-std/Test.sol";
import {IAccessControl} from "@openzeppelin/contracts/access/IAccessControl.sol";

続けて、test_RevertWhen_TransferToNotAllowedの後に3つのテストを足します。

    function test_FirstNavIsTenThousandYen() public {
        assertEq(fund.navFor(0), 10_000);
        vm.warp(_at(0, 18, 0));
        vm.prank(manager);
        fund.setNav(THU, 0);
        assertEq(fund.navOf(THU), 10_000);
    }

    function test_NavPerTenThousandUnits() public {
        fund.mintForTest(alice, 120_000_000);
        vm.warp(_at(0, 18, 0));
        vm.prank(manager);
        // 122,550,000円を1億2,000万口で割ると1万口あたり10,212.5円で、1円未満を切り捨てる
        fund.setNav(THU, 122_550_000);
        assertEq(fund.navOf(THU), 10_212);
        assertEq(fund.lastNavDay(), THU);
    }

    function test_RevertWhen_NavSetWithoutRole() public {
        bytes32 role = fund.MANAGER_ROLE();
        vm.warp(_at(0, 18, 0));
        vm.prank(alice);
        vm.expectRevert(abi.encodeWithSelector(IAccessControl.AccessControlUnauthorizedAccount.selector, alice, role));
        fund.setNav(THU, 0);
        assertEq(fund.navOf(THU), 0);
    }
コード 意味
vm.warp(_at(0, 18, 0)) テストのチェーンの時刻を、木曜の18時にする。
純資産を締め切りの15時より後に入れる決まりを後の節で足すため、最初から18時に入れておく
fund.setNav(THU, ...) 2026-03-05の番号の20517を約定日にして、純資産の総額を入れる
fund.mintForTest(alice, 120_000_000) 口数を1億2,000万口にする。
前のレッスンのテストの準備の関数を使う
bytes32 role = fund.MANAGER_ROLE() エラーに入る役割の名前をvm.prankより前に読む。
後に読むとaliceの名義がこの読み出しに使われ、setNavがaliceから送られない
テスト 確かめること
test_FirstNavIsTenThousandYen 口数が0の間は、純資産が0円でも基準価額が10,000円になる。
navFor(0)も入れた後のnavOf(THU)も10,000円
test_NavPerTenThousandUnits 1億2,000万口の時に122,550,000円を入れると、122,550,000 × 10,000 ÷ 120,000,000 = 10,212.5の1円未満を切り捨てて10,212円になる。
最後に入れた約定日も20517になる
test_RevertWhen_NavSetWithoutRole 役割のないaliceのsetNavはAccessControlUnauthorizedAccountで断られ、その日の基準価額は0のまま

test_FirstNavIsTenThousandYenでは、口数が0なのでnavForは純資産の額を見ずに10,000を返します。
test_NavPerTenThousandUnitsの122,550,000円は、1口が1.02125円になる額です。
1万口あたりの10,212.5円に1円未満が出るため、切り捨ての決まりも一緒に確かめられます。

確かめる

starter/contractsのディレクトリでテストを実行します。

forge test --match-contract TokenizedFundTest

前のレッスンの2つと、このレッスンの3つの行が出れば、テストは通っています。

[PASS] test_FirstNavIsTenThousandYen()
[PASS] test_NavPerTenThousandUnits()
[PASS] test_RevertWhen_NavSetWithoutRole()
[PASS] test_RevertWhen_TransferToNotAllowed()
[PASS] test_UnitsHaveNoDecimals()
Suite result: ok. 5 passed; 0 failed; 0 skipped

役割の決まりが効いていることも確かめます。
setNavの行からonlyRole(MANAGER_ROLE)を消して、テストを実行します。

    function setNav(uint256 day, uint256 netAssets) external {

test_RevertWhen_NavSetWithoutRoleが失敗し、次の行が出ます。

[FAIL: next call did not revert as expected] test_RevertWhen_NavSetWithoutRole()

役割を持たないaliceの純資産が、断られずに入ったことを示します。
この形のままだと、誰でも基準価額を書いて、約定の値段を決められてしまいます。
確かめたら、onlyRole(MANAGER_ROLE)を戻しておきます。