HandsOnChain

基準価額で注文をまとめて約定する

作るもの

このレッスンを終えると、締め切りの15時を過ぎた後に運用会社が純資産の総額を入れ、その日の基準価額で溜めた注文をsettleでまとめて約定できます。
申込は、預けた円で買える口数から1口未満を切り捨てた口数を受け取ります。
口数に見合う額の円は運用会社へ渡り、超えた分の円は投資家へ戻ります。
解約は、預けた口数が消え、約定日の基準価額で代金が決まります。

代金を払うのは、後のレッスンで作る受渡日です。
15時ちょうどまでは純資産を入れられず、純資産を入れていない約定日の注文は約定できません。

背景

トークン化ファンドの元になる投資信託では、ファンドの運用を指図する運用会社を、目論見書で委託会社と呼びます。
委託会社は毎営業日の市場が閉じた後に、その日の終わりの値段でファンドの資産を評価します。
資産の評価額から未払いの費用を引いたものが純資産の総額で、発行済みの口数で割って1万口あたりにしたものが基準価額です。

申込と解約の注文は、締め切りまでに受け付けた分を、その日の基準価額でまとめて約定します。
注文する人は値段を知らずに注文するので、この決まりをブラインド方式と呼びます。
前の日の基準価額で約定できると、その日の相場が上がったのを見てから申し込んだ人が、上がる前の安い値段で口数を受け取れます。
その分は、前から持っている人の持分が薄まる形で負うことになります。

申込の代金は、販売会社を通じて受託会社の信託銀行へ渡り、ファンドの資産に入ります。
委託会社はその円で株や債券を買うよう指図し、運用に回します。
解約では、消した口数に基準価額を掛けた代金を、数営業日後の受渡日に払います。
解約の代金から信託財産留保額を差し引くファンドもあり、このコースでは最後の節で足します。

口数は1口が最小の単位で、円は1円が最小の単位なので、割り算の端数をどちらかへ寄せる必要があります。
このコースでは、どの端数もファンドを持ち続ける人が損をしない側へ寄せます。

場面 端数 寄せ方 寄せる理由
申込で渡す口数 1口未満 切り捨てる 払った円より多い口数を渡さない
申込で受け取る円 1円未満 切り上げる 渡した口数の価値より少ない円で口数を渡さない
解約の代金 1円未満 切り捨てる 消した口数の価値より多い円を払わない。
切り捨てた分はファンドに残る

木曜に1億2,000万口があり、運用会社が純資産の総額122,868,000円を入れると、基準価額は10,239円です。
300,000円の申込で買えるのは300,000 × 10,000 ÷ 10,239 = 292,997.36口なので、1口未満を切り捨てて292,997口を渡します。
292,997口の価値は292,997 × 10,239 ÷ 10,000 = 299,999.6283円で、切り上げた300,000円を受け取ります。
返す円は0円です。

1円未満を切り捨てて299,999円を受け取ると、投資家へ1円を返すことになります。
その時は299,999.6283円の価値の口数を299,999円で渡すので、足りない0.6283円を前から持っている人が負います。
切り上げると、投資家が価値より多く払うのは1円未満で、その分はファンドに残ります。

解約の代金も同じ考えで、1円未満を切り捨てて払います。
切り捨てた1円未満は払わずにファンドに残るので、持ち続ける人の純資産に入ります。

運用会社が入れる純資産の総額は、その日の注文を約定する前の額です。
解約で預かった口数も約定するまでは発行済みの口数に入っているので、基準価額はその日の申込と解約を数える前の口数で割った値になります。

オンチェーンでは、運用会社が入れた純資産の総額から、ファンドのコントラクトが基準価額を出します。
同じ約定日の注文は全て同じ基準価額で約定し、渡した口数と返した円と解約の代金は注文の記録に残ります。
誰でも記録を読み、同じ式で数え直せます。
締め切りの前に純資産を入れられないことも、コントラクトが時刻で確かめます。

このコースには、受託会社の信託銀行の役を置きません。
申込の円は約定の時に運用会社のアカウントへ渡し、運用の損益は運用会社が入れる純資産の総額で表します。

木曜の申込を基準価額10,239円で約定する
チェーンに残る値基準価額10,239円預かっている円300,000円0円投資家Aの口数0口292,997口運用会社MANAGER_ROLEを持つファンドのコントラクトTokenizedFund投資家A300,000円を申し込んだ11223344setNav(木曜, 122,868,000)setNav(木曜, 122,868,000)settle(木曜)settle(木曜)292,997 HOF292,997 HOF300,000 HJPY

実装

starter/contracts/contracts/TokenizedFund.solのAccessControlの読み込みの下に、OpenZeppelin ContractsのMathを読み込みます。

import {AccessControl} from "@openzeppelin/contracts/access/AccessControl.sol";
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";

Math.ceilDivは、割り算の1未満を切り上げる関数です。
申込で受け取る円を切り上げる所で使います。

OrderのplacedAtの下に、約定の結果を残す2つの欄を足します。

        // 注文した時刻
        uint64 placedAt;
        // 約定で渡した口数 (申込) か、約定で消した口数 (解約)
        uint256 units;
        // 約定で返した円 (申込) か、解約の代金 (解約)
        uint256 yen;
    }

lastNavDayの下に約定し終えた数を、Cancelledのイベントの下に約定のイベントを足します。

    /// @notice 最後に純資産を入れた約定日
    uint256 public lastNavDay;
    /// @notice 約定日ごとの、約定し終えた注文の数
    mapping(uint256 day => uint256) public settledCount;
    event Cancelled(uint256 indexed day, uint256 index, address indexed investor);
    event Settled(uint256 indexed day, uint256 index, address indexed investor, uint256 units, uint256 yen);

エラーの末尾のCancelAfterCutoffの下に、3つのエラーを足します。

    error CancelAfterCutoff(uint256 day);
    error NavBeforeCutoff(uint256 day);
    error NavNotSet(uint256 day);
    error AlreadySettled(uint256 day);
行 意味
units 申込では渡した口数を、解約では消した口数を残す
yen 申込では投資家へ返した円を、解約では決まった代金を残す
settledCount 約定日ごとに、前から何件目まで約定したかを残す
Settled どの注文に何口を渡したか消したかと、返した円か代金を残す
NavBeforeCutoff 締め切りの15時ちょうどまでに、その日の純資産を入れようとした
NavNotSet 純資産を入れていない約定日の注文を約定しようとした
AlreadySettled 約定し終えた約定日を、もう一度約定しようとした

setNavのNotBusinessDayの行の下に、時刻を確かめる行を足します。

    function setNav(uint256 day, uint256 netAssets) external onlyRole(MANAGER_ROLE) {
        if (day <= lastNavDay) revert NavOutOfOrder(day, lastNavDay);
        if (!isBusinessDay(day)) revert NotBusinessDay(day);
        if (block.timestamp <= cutoffAt(day)) revert NavBeforeCutoff(day);

前のレッスンまでに、15時ちょうどの注文はその日の約定日に入り、15時ちょうどまでは取り消せるようにしました。
15時ちょうどに純資産を入れられると、同じ時刻に出た注文が、基準価額の決まった後にその日へ入ってしまいます。
そのため、<=で15時ちょうども断り、15時を1秒でも過ぎてから入れられるようにします。

cancelの後に、約定の関数を足します。

    /// @notice 運用会社が、純資産を入れた約定日の注文を前から順にまとめて約定する
    function settle(uint256 day) external onlyRole(MANAGER_ROLE) {
        Order[] storage orders = _orders[day];
        uint256 end = orders.length;
        uint256 nav = navOf[day];
        if (nav == 0) revert NavNotSet(day);
        uint256 start = settledCount[day];
        if (start == orders.length) revert AlreadySettled(day);
        for (uint256 i = start; i < end; i++) {
            Order storage order = orders[i];
            if (order.status != Status.Pending) continue;
            order.status = Status.Settled;
            if (order.kind == Kind.Subscribe) {
                _settleSubscription(order, nav);
            } else {
                _settleRedemption(order, nav);
            }
            emit Settled(day, i, order.investor, order.units, order.yen);
        }
        settledCount[day] = end;
    }
行 意味
onlyRole(MANAGER_ROLE) 約定できるのは運用会社の役を持つアカウントだけ
uint256 end = orders.length この回で約定する範囲の終わり。
このレッスンでは注文の数にし、全件を1回で約定する
if (nav == 0) revert NavNotSet(day) 基準価額のない約定日は約定できない
uint256 start = settledCount[day] 前の回が約定し終えた所から始める。
このレッスンでは0か注文の数のどちらか
start == orders.length 約定し終えた約定日と、注文が1件もない約定日をAlreadySettledで断る
order.status != Status.Pending 取り消した注文は飛ばす
order.status = Status.Settled 円と口数を動かす前に、注文の状態を約定に書き換える
settledCount[day] = end どこまで約定したかを残す

同じ約定日の注文は、全てnavOf[day]の同じ基準価額で約定します。
navOf[day]はsetNavの時に書いた値なので、約定の途中で口数が増えても変わりません。

最後に、_placeOrderの後に、申込と解約を1件ずつ約定する2つの関数を足します。

    // 申込の円で買える口数を渡す。口数は1口未満を切り捨て、口数に見合う額を超えた円は投資家へ返す
    function _settleSubscription(Order storage order, uint256 nav) private {
        uint256 units = order.amount * NAV_UNITS / nav;
        // 口数に見合う額は1円未満を切り上げ、足りない分を持ち続ける人に負わせない
        uint256 cost = Math.ceilDiv(units * nav, NAV_UNITS);
        uint256 refund = order.amount - cost;
        pendingYen -= order.amount;
        order.units = units;
        order.yen = refund;
        if (units > 0) _mint(order.investor, units);
        // 申込の円は運用会社へ渡して運用に回す
        if (cost > 0) jpy.transfer(manager, cost * YEN);
        if (refund > 0) jpy.transfer(order.investor, refund * YEN);
    }

    // 預かった口数を消し、約定日の基準価額で代金を決める。代金の1円未満は切り捨ててファンドに残す
    function _settleRedemption(Order storage order, uint256 nav) private {
        uint256 proceeds = order.amount * nav / NAV_UNITS;
        heldUnits -= order.amount;
        order.units = order.amount;
        order.yen = proceeds;
        _burn(address(this), order.amount);
    }
行 意味
order.amount * NAV_UNITS / nav 預けた円に1万を掛けて1万口あたりの基準価額で割り、1口未満を切り捨てる
Math.ceilDiv(units * nav, NAV_UNITS) 渡す口数の価値を出し、1円未満を切り上げる
order.amount - cost 預けた円のうち、口数の価値を超えた分。
投資家へ返す
pendingYen -= order.amount 約定した申込の円を、預かっている円の合計から外す
_mint(order.investor, units) 口数を発行して投資家へ渡す。
持分の移転と同じく、許可リストにいる投資家にしか渡せない
jpy.transfer(manager, cost * YEN) 口数の価値の円を運用会社へ渡す。
円で数えた額を18桁の単位に直して送る
order.amount * nav / NAV_UNITS 解約の代金。
口数に基準価額を掛けて1万で割り、1円未満を切り捨てる
heldUnits -= order.amount 約定した解約の口数を、預かっている口数の合計から外す
_burn(address(this), order.amount) 預かっていた口数をburnして、発行済みの口数から減らす

costは預けた円を超えないので、refundは負になりません。
unitsを切り捨てたのでunits * navはorder.amount * NAV_UNITS以下になり、1万で割って切り上げても整数のorder.amountを超えないためです。
解約の代金はここでは決めるだけで、円は動きません。
代金を払う仕組みは、後のレッスンで受渡日と一緒に作ります。

次に、starter/contracts/test/TokenizedFund.t.solのTokenizedFundTestの末尾に、テストの中で使う2つの関数を足します。

    // その日の18時 (日本時間) へ時計を進めて、運用会社が純資産を入れる。時計は戻さない
    function _setNavAfterCutoff(uint256 day, uint256 netAssets) internal {
        uint256 at = day * 1 days + 9 hours;
        if (block.timestamp < at) vm.warp(at);
        vm.prank(manager);
        fund.setNav(day, netAssets);
    }

    // 約定日の注文を全て約定する
    function _settleAll(uint256 day) internal {
        vm.prank(manager);
        fund.settle(day);
    }
行 意味
day * 1 days + 9 hours 約定日の番号に1日を掛けると協定世界時のその日の0時になり、9時間を足すと日本時間の18時になる
if (block.timestamp < at) vm.warp(at) 今の時刻が18時より前の時だけ進める。
後の時は時計を戻さない
_settleAll 運用会社の名義でsettleを呼び、その約定日の注文を全て約定する

続けて、締め切りちょうどに純資産を入れられないことと、基準価額で口数を渡すことを確かめるテストを足します。

    function test_RevertWhen_NavBeforeCutoff() public {
        vm.warp(_at(0, 15, 0));
        vm.prank(manager);
        vm.expectRevert(abi.encodeWithSelector(TokenizedFund.NavBeforeCutoff.selector, THU));
        fund.setNav(THU, 0);
        assertEq(fund.navOf(THU), 0);
    }

    function test_SettleMintsUnitsAtNav() public {
        // 1億2,000万口がある所に、純資産122,868,000円を入れると基準価額は10,239円
        fund.mintForTest(bob, 120_000_000);
        vm.prank(alice);
        fund.subscribe(300_000);
        _setNavAfterCutoff(THU, 122_868_000);
        _settleAll(THU);
        assertEq(fund.navOf(THU), 10_239);
        // 300,000円を10,239円で割り1万口を掛けた292,997.36口の、1口未満を切り捨てる
        assertEq(fund.balanceOf(alice), 292_997);
        TokenizedFund.Order memory order = fund.ordersOf(THU)[0];
        assertEq(uint8(order.status), uint8(TokenizedFund.Status.Settled));
        assertEq(order.units, 292_997);
        assertEq(fund.pendingYen(), 0);
    }
テスト 確かめること
test_RevertWhen_NavBeforeCutoff 木曜の15時ちょうどはNavBeforeCutoffで断られ、基準価額は0のまま
test_SettleMintsUnitsAtNav 122,868,000円を1億2,000万口で割った10,239円で約定し、aliceが292,997口を受け取る。
預かっている円は0円になる

test_SettleMintsUnitsAtNavでは、bobが1億2,000万口を持つ所にaliceが300,000円を申し込みます。
aliceの申込は約定する前なので、setNavはbobの1億2,000万口だけで割ります。
122,868,000 × 10,000 ÷ 120,000,000はちょうど10,239円です。

最後に、余りの円を返すことと、申込の円が運用会社へ渡ることを確かめるテストを足します。

    function test_SubscribeRemainderRefunded() public {
        // 1万口あたり25,000円 (1口2.5円) の日に100,001円を申し込む
        fund.mintForTest(bob, 10_000_000);
        vm.prank(alice);
        fund.subscribe(100_001);
        _setNavAfterCutoff(THU, 25_000_000);
        _settleAll(THU);
        // 買えるのは40,000口 (100,000円) で、余りの1円を返す
        assertEq(fund.balanceOf(alice), 40_000);
        assertEq(fund.ordersOf(THU)[0].yen, 1);
        assertEq(jpy.balanceOf(alice), (5_000_000 - 100_000) * YEN);
        assertEq(jpy.balanceOf(address(fund)), 0);
    }

    function test_SubscriptionYenGoesToManager() public {
        vm.prank(alice);
        fund.subscribe(300_000);
        uint256 before = jpy.balanceOf(manager);
        // 口数が0の日の基準価額は10,000円なので、300,000円で300,000口になる
        _setNavAfterCutoff(THU, 0);
        _settleAll(THU);
        assertEq(fund.balanceOf(alice), 300_000);
        assertEq(jpy.balanceOf(manager) - before, 300_000 * YEN);
        assertEq(jpy.balanceOf(address(fund)), 0);
    }
テスト 確かめること
test_SubscribeRemainderRefunded 基準価額25,000円の日の100,001円の申込は40,000口になり、余りの1円がaliceへ戻る。
ファンドのコントラクトに円は残らない
test_SubscriptionYenGoesToManager 口数が0の日は基準価額10,000円で約定し、300,000円が全て運用会社へ渡る

test_SubscribeRemainderRefundedでは、25,000,000 × 10,000 ÷ 10,000,000で基準価額は25,000円です。
100,001 × 10,000 ÷ 25,000 = 40,000.4口の1口未満を切り捨てて、40,000口を渡します。
40,000口の価値は40,000 × 25,000 ÷ 10,000 = 100,000円でちょうど割り切れ、預けた100,001円との差の1円を返します。
aliceはsetUpで5,000,000円を受け取っているので、約定の後の円は5,000,000 − 100,000円になります。

確かめる

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

forge test

次の行が出れば、基準価額で注文を約定できています。

[PASS] test_RevertWhen_NavBeforeCutoff()
[PASS] test_SettleMintsUnitsAtNav()
[PASS] test_SubscribeRemainderRefunded()
[PASS] test_SubscriptionYenGoesToManager()
Suite result: ok. 17 passed; 0 failed; 0 skipped

締め切りちょうどに純資産を入れられないことも確かめます。
setNavのif (block.timestamp <= cutoffAt(day)) revert NavBeforeCutoff(day);の<=を<に変えて実行すると、test_RevertWhen_NavBeforeCutoffが失敗します。

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

15時ちょうどは、まだその日の注文を受け付ける時刻だと分かります。
試したら<=に戻しておきます。

次のレッスンで、注文を件数で区切って何回かに分けて約定できるようにします。