HandsOnChain

受渡日に解約の代金を受け取る

作るもの

このレッスンを終えると、運用会社が約定し終えた約定日の解約の代金をfundProceedsでまとめて入れ、投資家が受渡日からclaimで受け取れます。
受渡日は約定日から土日を数えずに3営業日後で、その日の日本時間の0時から受け取れます。
木曜の約定日の代金は翌週の火曜から、月曜の約定日の代金は木曜から受け取れます。
受渡日の前の受け取りと、運用会社が代金を入れる前の受け取りは拒みます。

背景

投資信託を解約すると、代金は約定した日ではなく、数営業日後の受渡日に払われます。
委託会社は解約に応じるため、ファンドの株や債券を売って円を用意します。
売った株や債券の代金が入るのも、それぞれの市場の受渡日です。
そのため、解約の代金を払う日は約定日より後になります。

約定日から受渡日までの日数は、ファンドごとに目論見書で決まります。
外国の資産に投資するファンドでは、海外の市場の休日を挟む分だけ長くなることがあります。
このコースでは祝日を数えず、土日だけを除いた3営業日後を受渡日にします。

約定日 1営業日後 2営業日後 3営業日後 (受渡日)
2026-03-05 (木) 2026-03-06 (金) 2026-03-09 (月) 2026-03-10 (火)
2026-03-09 (月) 2026-03-10 (火) 2026-03-11 (水) 2026-03-12 (木)

受渡日に代金を払えるよう、運用会社は受渡日までに円を用意しておく必要があります。
オンチェーンでは、運用会社が約定日ごとの解約の代金の合計を、1回でファンドのコントラクトへ入れます。
投資家は受渡日になったら、自分の代金を自分で受け取りに来ます。
受渡日の時刻と代金が入ったかはコントラクトが確かめるので、受渡日より前に払われることも、入っていない代金が払われることもありません。

ファンドのコントラクトは、約定の前の申込の円と、入ったのにまだ受け取られていない代金を一緒に持っています。
代金が入る前の約定日の受け取りを許すと、他の人の円から払ってしまいます。
そのため、約定日ごとに代金が入ったかを残し、入った約定日の代金だけを払います。

木曜に約定した解約の代金を火曜に受け取る
チェーンに残る値時刻木曜の18時月曜の23時59分59秒火曜の0時投資家Aの代金204,240円0円受け取られていない代金0円204,240円0円運用会社MANAGER_ROLEを持つファンドのコントラクトTokenizedFund投資家A20万口を解約した11223344settle(木曜, 全件)settle(木曜, 全件)fundProceeds(木曜)fundProceeds(木曜)204,240 HJPY204,240 HJPYclaim(木曜)claim(木曜)BeforeDeliveryDateBeforeDeliveryDateclaim(木曜)204,240 HJPY

実装

starter/contracts/contracts/TokenizedFund.solのCUTOFFの下に、受渡日までの営業日の数を足します。

    /// @notice 申込と解約の締め切り (日本時間の15時)
    uint256 public constant CUTOFF = 15 hours;
    /// @notice 約定日から解約の代金の受渡日までの営業日の数
    uint256 public constant DELIVERY_DAYS = 3;

dayCursorの下に、解約の代金を数える4つの値を足します。

    /// @notice 次に約定する約定日の、注文のある約定日の配列での位置
    uint256 public dayCursor;
    /// @notice 約定日ごとの解約の代金の合計
    mapping(uint256 day => uint256) public proceedsDue;
    /// @notice 運用会社が約定日の解約の代金を入れたか
    mapping(uint256 day => bool) public proceedsFunded;
    /// @notice 投資家ごとの、約定日の受け取っていない解約の代金
    mapping(uint256 day => mapping(address investor => uint256)) public proceedsOf;
    /// @notice 運用会社が入れたのに、まだ受け取られていない解約の代金の合計
    uint256 public unclaimedYen;
行 意味
DELIVERY_DAYS 約定日から受渡日までの営業日の数。
3営業日後にする
proceedsDue 約定日ごとの解約の代金の合計。
運用会社が入れる額になる
proceedsFunded 運用会社がその約定日の代金を入れたか
proceedsOf 約定日と投資家ごとの、まだ受け取っていない代金。
同じ日に2件を解約した投資家は2件の和になる
unclaimedYen 運用会社が入れたのに、まだ受け取られていない代金の合計

Settledのイベントの下に2つのイベントを、NavSkipsDayのエラーの下に5つのエラーを足します。

    event Settled(uint256 indexed day, uint256 index, address indexed investor, uint256 units, uint256 yen);
    event ProceedsFunded(uint256 indexed day, uint256 amount);
    event ProceedsClaimed(uint256 indexed day, address indexed investor, uint256 amount);
    error NavSkipsDay(uint256 day, uint256 pendingDay);
    error NotSettled(uint256 day);
    error AlreadyFunded(uint256 day);
    error BeforeDeliveryDate(uint256 day, uint256 deliveryAt);
    error ProceedsNotFunded(uint256 day);
    error NothingToClaim(uint256 day);
行 意味
ProceedsFunded 運用会社がどの約定日の代金をいくら入れたかを残す
ProceedsClaimed 誰がどの約定日の代金をいくら受け取ったかを残す
NotSettled 約定し終えていない約定日の代金を入れようとした
AlreadyFunded 同じ約定日の代金を2回入れようとした
BeforeDeliveryDate 受渡日の前に受け取ろうとした。
エラーには受け取れる時刻が入る
ProceedsNotFunded 運用会社が代金を入れる前に受け取ろうとした
NothingToClaim その約定日に受け取る代金のない投資家が受け取ろうとした

cutoffAtの下に、受渡日の始まる時刻を返す関数を足します。

    /// @notice 約定日から3営業日後の受渡日が始まる時刻 (日本時間の0時)
    function deliveryAt(uint256 day) public pure returns (uint256) {
        for (uint256 i = 0; i < DELIVERY_DAYS; i++) {
            day = nextBusinessDay(day);
        }
        return day * 1 days - JST;
    }
行 意味
day = nextBusinessDay(day) 次の営業日へ1日ずつ進める。
土日はnextBusinessDayが飛ばす
DELIVERY_DAYS回 3回進めて、3営業日後の日の番号にする
day * 1 days - JST 日の番号は日本時間で数えているので、9時間を引いて日本時間の0時の時刻にする

settleの解約の分の後に、決まった代金を約定日ごとと投資家ごとに足す2行を加えます。

            } else {
                _settleRedemption(order, nav);
                proceedsDue[day] += order.yen;
                proceedsOf[day][order.investor] += order.yen;
            }

settleの後に、代金を入れる関数と受け取る関数を足します。

    /// @notice 運用会社が、約定し終えた約定日の解約の代金をまとめて入れる
    function fundProceeds(uint256 day) external onlyRole(MANAGER_ROLE) {
        if (navOf[day] == 0 || settledCount[day] < _orders[day].length) revert NotSettled(day);
        if (proceedsFunded[day]) revert AlreadyFunded(day);
        proceedsFunded[day] = true;
        uint256 amount = proceedsDue[day];
        unclaimedYen += amount;
        jpy.transferFrom(msg.sender, address(this), amount * YEN);
        emit ProceedsFunded(day, amount);
    }
行 意味
onlyRole(MANAGER_ROLE) 代金を入れるのは運用会社の役を持つアカウント
settledCount[day] < _orders[day].length 約定し終えていない約定日は断る。
分けて約定する途中では、代金の合計がまだ決まっていない
proceedsFunded[day] 入れるのは約定日ごとに1回だけ
proceedsFunded[day] = true 円を動かす前に、入れたことを書いておく
unclaimedYen += amount 入れた代金を、受け取られていない代金の合計に足す
jpy.transferFrom(msg.sender, ...) 運用会社から代金の合計を受け取る。
運用会社は先にapproveでファンドのコントラクトに任せておく
    /// @notice 受渡日を過ぎ、運用会社が代金を入れた後に、投資家が約定日の解約の代金を受け取る
    function claim(uint256 day) external {
        uint256 at = deliveryAt(day);
        if (block.timestamp < at) revert BeforeDeliveryDate(day, at);
        if (!proceedsFunded[day]) revert ProceedsNotFunded(day);
        uint256 amount = proceedsOf[day][msg.sender];
        if (amount == 0) revert NothingToClaim(day);
        proceedsOf[day][msg.sender] = 0;
        unclaimedYen -= amount;
        jpy.transfer(msg.sender, amount * YEN);
        emit ProceedsClaimed(day, msg.sender, amount);
    }
行 意味
block.timestamp < at 受渡日の0時より前は断る。
0時ちょうどからは受け取れる
!proceedsFunded[day] 運用会社がその約定日の代金を入れていなければ断る
proceedsOf[day][msg.sender] 呼んだ投資家のその約定日の代金を読む
proceedsOf[day][msg.sender] = 0 円を送る前に0にする。
同じ代金を2回受け取れない
unclaimedYen -= amount 受け取った代金を、受け取られていない代金の合計から引く
jpy.transfer(msg.sender, ...) 代金を投資家へ送る

運用会社が代金を入れるのは約定日ごとに1回で、投資家ごとに送る手間は投資家のclaimに任せます。
受け取りに来ない投資家の代金は、proceedsOfとunclaimedYenに残ったまま、ファンドのコントラクトが持ち続けます。

次に、starter/contracts/test/TokenizedFund.t.solのTokenizedFundTestの末尾に、解約して約定する所までを行う関数を足します。

    // 投資家Aが50万口を持ち、約定日dayに20万口を解約して約定する。基準価額は10,212円
    function _redeemAndSettle(uint256 day) internal returns (uint256 proceeds) {
        fund.mintForTest(alice, 500_000);
        vm.prank(alice);
        fund.redeem(200_000);
        _setNavAfterCutoff(day, 510_600);
        _settleAll(day);
        proceeds = fund.proceedsOf(day, alice);
        assertGt(proceeds, 0);
    }

解約で預かった20万口も約定するまでは発行済みの口数に入っているので、純資産の総額510,600円を50万口で割ります。
510,600 × 10,000 ÷ 500,000で基準価額は10,212円になり、代金は200,000 × 10,212 ÷ 10,000 = 204,240円です。

続けて、受渡日から受け取れることを確かめるテストを足します。

    function test_RedemptionPayableAfterThreeBusinessDays() public {
        // 月曜の約定日の代金は、3営業日後の木曜の0時から受け取れる
        vm.warp(_at(4, 10, 0));
        uint256 monday = THU + 4;
        uint256 proceeds = _redeemAndSettle(monday);
        vm.prank(manager);
        fund.fundProceeds(monday);
        assertEq(fund.deliveryAt(monday), THU_START + 7 days);
        vm.warp(THU_START + 7 days);
        uint256 before = jpy.balanceOf(alice);
        vm.prank(alice);
        fund.claim(monday);
        assertEq(jpy.balanceOf(alice) - before, proceeds * YEN);
        assertEq(fund.proceedsOf(monday, alice), 0);
        assertEq(fund.unclaimedYen(), 0);
    }

    function test_DeliveryDateSkipsWeekend() public {
        // 木曜の約定日の代金は、土日を数えず翌週の火曜から受け取れる
        assertEq(fund.deliveryAt(THU), THU_START + 5 days);
        _redeemAndSettle(THU);
        vm.prank(manager);
        fund.fundProceeds(THU);
        vm.warp(THU_START + 5 days);
        vm.prank(alice);
        fund.claim(THU);
        assertEq(fund.proceedsOf(THU, alice), 0);
    }
テスト 確かめること
test_RedemptionPayableAfterThreeBusinessDays 2026-03-09 (月) の約定日の受渡日は、2026-03-12 (木) の0時。
その時刻にaliceが204,240円を受け取り、受け取られていない代金が0円になる
test_DeliveryDateSkipsWeekend 2026-03-05 (木) の約定日の受渡日は、土日を数えない2026-03-10 (火) の0時。
その時刻ちょうどに受け取れる

THU_STARTは2026-03-05 (木) の日本時間の0時です。
月曜から3営業日後の木曜は7日後で、木曜から3営業日後の火曜は5日後です。
どちらも受渡日の0時ちょうどに受け取れることを確かめます。

最後に、受け取りを拒む2つのテストを足します。

    function test_RevertWhen_ClaimBeforeDeliveryDate() public {
        uint256 proceeds = _redeemAndSettle(THU);
        vm.prank(manager);
        fund.fundProceeds(THU);
        // 月曜の終わりの1秒前は、まだ受渡日の前
        vm.warp(THU_START + 5 days - 1);
        vm.prank(alice);
        vm.expectRevert(abi.encodeWithSelector(TokenizedFund.BeforeDeliveryDate.selector, THU, THU_START + 5 days));
        fund.claim(THU);
        assertEq(fund.proceedsOf(THU, alice), proceeds);
        assertEq(fund.unclaimedYen(), proceeds);
    }

    function test_RevertWhen_ClaimUnfunded() public {
        uint256 proceeds = _redeemAndSettle(THU);
        // 運用会社が代金を入れないまま受渡日になっても、受け取れない
        vm.warp(THU_START + 5 days);
        uint256 before = jpy.balanceOf(alice);
        vm.prank(alice);
        vm.expectRevert(abi.encodeWithSelector(TokenizedFund.ProceedsNotFunded.selector, THU));
        fund.claim(THU);
        assertEq(jpy.balanceOf(alice), before);
        assertEq(fund.proceedsOf(THU, alice), proceeds);
    }
テスト 確かめること
test_RevertWhen_ClaimBeforeDeliveryDate 火曜の0時の1秒前の月曜の23時59分59秒は、BeforeDeliveryDateで拒む。
エラーには受け取れる火曜の0時が入り、代金は残る
test_RevertWhen_ClaimUnfunded 受渡日の火曜の0時になっても、運用会社が代金を入れていなければProceedsNotFundedで拒む。
aliceの円は増えない

確かめる

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

forge test

次の行が出れば、受渡日から解約の代金を受け取れています。

[PASS] test_DeliveryDateSkipsWeekend()
[PASS] test_RedemptionPayableAfterThreeBusinessDays()
[PASS] test_RevertWhen_ClaimBeforeDeliveryDate()
[PASS] test_RevertWhen_ClaimUnfunded()
Suite result: ok. 24 passed; 0 failed; 0 skipped

代金が入ったかを確かめる行が効いているかも見ておきます。
claimのif (!proceedsFunded[day]) revert ProceedsNotFunded(day);の行を消して実行すると、test_RevertWhen_ClaimUnfundedが失敗します。

[FAIL: Error != expected error: panic: arithmetic underflow or overflow (0x11) != ProceedsNotFunded(20517 [2.051e4])] test_RevertWhen_ClaimUnfunded()

このテストではunclaimedYenが0円なので、unclaimedYen -= amountが負になって止まりました。
他の約定日の代金が入っていてunclaimedYenが足りる時は、止まらずに払ってしまいます。
木曜の代金が入る前でも、金曜の代金が入った後なら、木曜のclaimが金曜の代金から払われます。
試したら行を戻しておきます。

次のレッスンで、どの順に操作してもファンドの円と口数が注文の記録と合うことを、invariantのテストで確かめます。