HandsOnChain

申込と解約の注文を溜める

作るもの

このレッスンを終えると、投資家が円の額で申し込み、口数で解約する注文を出せます。
申込の円と解約の口数は、注文した時にファンドのコントラクトが預かります。
注文は約定日ごとの列に溜まり、ordersOfで約定日の注文を全て読めます。
円トークンの許可リストにいない人の申込は、NotAllowedのエラーで拒みます。

aliceが300,000円を申し込むと、ファンドのコントラクトが300,000円を預かり、aliceの円は5,000,000円から4,700,000円に減ります。

背景

投資信託は、証券会社や銀行のような販売会社を通して買い、手放す時も販売会社へ解約を申し込みます。
買う注文を申込と呼び、「10万円分」のように金額で指定できます。
解約は、持っている口数のうち何口を手放すかで指定できます。
販売会社によっては、申込を口数で指定することも、解約を金額で指定することもできます。

このコースでは、申込を円の額で受け、解約を口数で受けます。
どちらの注文も、投資家は今持っている側の量を決めて出します。
申込では払う円を決め、受け取る口数は約定日の基準価額で決まります。
解約では手放す口数を決め、受け取る代金は約定日の基準価額で決まります。

注文した時点では、約定日の基準価額はまだ出ていません。
値段を知らずに注文するこの決まりをブラインド方式と呼びます。
いつまでの注文をどの約定日に入れるかは、次のレッスンで締め切りと営業日から決めます。
このレッスンでは、注文した日の日本時間の日付をそのまま約定日にします。

販売会社は注文を受けると、約定までの間、申込の代金と解約する口数を投資家が他に使えないようにしておきます。
注文は締め切りの後にまとめて運用会社へ伝わり、運用会社がその日の基準価額を出します。
申込と解約が約定するのは、その基準価額が出た後です。
投資信託を買う人の本人確認は、販売会社が取引を始める前に済ませます。

チェーンの上では、販売会社の帳簿の代わりに、ファンドのコントラクトが円と口数を預かります。
預かった円の合計と口数の合計、約定日ごとの注文の列は誰でも読めるので、運用会社と投資家が同じ注文を見て約定を待てます。
注文できるのは、1作目の円トークンの許可リストに載り、凍結されていない人だけです。
預けた円と口数を戻す取り消しは2つ後のレッスンで、約定は次の節で足します。

申込の円と解約の口数を預かる
ファンドが預かる値申込の円0円300,000円解約の口数0口200,000口約定日20517の注文0件1件2件投資家A円と持分を持つファンドのコントラクトTokenizedFund円トークンJpyToken112233approve(ファンド, 上限)approve(ファンド, 上限)subscribe(300,000)subscribe(300,000)transferFrom(投資家A, ファンド, 300,000円)transferFrom(投資家A, ファンド, 300,000円)300,000 HJPY300,000 HJPYredeem(200,000)200,000 HOF許可リストと凍結を確かめる許可リストと凍結を確かめる投資家Aの口数をファンドへ移す
注文 投資家が決める量 ファンドが預かるもの 約定日に決まるもの
申込 (subscribe) 払う円の額 円トークン 受け取る口数
解約 (redeem) 手放す口数 持分の口数 受け取る代金

実装

starter/contracts/contracts/TokenizedFund.solを開き、JSTの下に円トークンの1円を表す定数を足します。

    // 日本時間と協定世界時の差
    uint256 private constant JST = 9 hours;
    /// @notice 円トークンの1円 (18桁)
    uint256 public constant YEN = 1e18;

ファンドの中の額は全て円で数え、円トークンを動かす時だけYENを掛けて18桁の最小単位へ直します。

managerの後に、注文の種類と状態と1件の注文の形を足します。

    /// @notice 注文の種類
    enum Kind {
        Subscribe,
        Redeem
    }

    /// @notice 注文の状態。取り消しは締め切りの前、約定は純資産を入れた後に起きる
    enum Status {
        Pending,
        Cancelled,
        Settled
    }

    /// @notice 1件の注文
    struct Order {
        // 注文した投資家
        address investor;
        // 申込か解約か
        Kind kind;
        // 約定の前か、取り消したか、約定したか
        Status status;
        // 申込は預けた円、解約は預けた口数
        uint256 amount;
        // 注文した時刻
        uint64 placedAt;
    }
行 意味
Kind 申込のSubscribeと解約のRedeemの2つ
Status 約定の前のPendingと取り消したCancelledと約定したSettledの3つ。
新しい注文は最初の値のPendingになる
amount 申込なら預けた円の額で、解約なら預けた口数。
注文の種類で単位が変わる
placedAt 注文を受けた時刻。
どの時刻の注文がどの約定日に入ったかを後から確かめられる

CancelledとSettledは、取り消しのレッスンと次の節の約定で使います。
先に3つを並べておくと、後のレッスンで状態の値の順が変わりません。

navOfの前に、注文の列と預かった額の合計を足します。

    // 約定日ごとの注文
    mapping(uint256 day => Order[]) private _orders;
    // 注文のある約定日を古い順に並べた配列
    uint256[] private _orderDays;
    /// @notice 約定の前の申込で預かっている円の合計
    uint256 public pendingYen;
    /// @notice 約定の前の解約で預かっている口数の合計
    uint256 public heldUnits;
    /// @notice 約定日ごとの1万口あたりの基準価額。入れる前は0
    mapping(uint256 day => uint256) public navOf;
行 意味
_orders 約定日の番号ごとに、注文を来た順に並べた列。
注文は約定日と列の番号の組で名指す
_orderDays 注文が1件でもある約定日の一覧。
次の節で、約定日を古い順に約定するのに使う
pendingYen 申込で預かっている円の合計。
円トークンの18桁ではなく円で数える
heldUnits 解約で預かっている口数の合計

イベントの末尾に注文のイベントを、エラーの末尾に0の注文を拒むエラーを足します。

    event NavSet(uint256 indexed day, uint256 netAssets, uint256 nav);
    event Ordered(uint256 indexed day, uint256 index, address indexed investor, Kind kind, uint256 amount);
    error ZeroNav(uint256 day);
    error ZeroAmount();
行 意味
Ordered 注文の約定日と列の番号と投資家を残す。
indexedを付けた約定日と投資家で、イベントを絞り込める
ZeroAmount 0円の申込と0口の解約を拒む

setNavの後に、申込と解約の関数を足します。

    /// @notice 円の額で申し込む。円は注文の時に預かり、約定日に口数を渡す
    function subscribe(uint256 amount) external returns (uint256 day, uint256 index) {
        if (amount == 0) revert ZeroAmount();
        _checkInvestor(msg.sender);
        jpy.transferFrom(msg.sender, address(this), amount * YEN);
        pendingYen += amount;
        return _placeOrder(Kind.Subscribe, amount);
    }

    /// @notice 口数で解約する。口数は注文の時に預かり、約定日の基準価額で代金が決まる
    function redeem(uint256 units) external returns (uint256 day, uint256 index) {
        if (units == 0) revert ZeroAmount();
        _checkInvestor(msg.sender);
        _transfer(msg.sender, address(this), units);
        heldUnits += units;
        return _placeOrder(Kind.Redeem, units);
    }
行 意味
_checkInvestor(msg.sender) 注文する人が円トークンの許可リストにいて、凍結されていないかを確かめる。
外れていればNotAllowedで拒む
jpy.transferFrom(msg.sender, address(this), amount * YEN) 投資家から申込の円を引き取る。
投資家は先に円トークンのapproveでファンドに任せておく
pendingYen += amount 預かった円の合計に足す
_transfer(msg.sender, address(this), units) 投資家の口数をファンドのコントラクトへ移す。
持分のトークンはこのコントラクトそのものなので、approveは要らない
heldUnits += units 預かった口数の合計に足す
returns (uint256 day, uint256 index) 注文が入った約定日と列の番号を返す。
取り消す時はこの組で注文を名指す

redeemでも注文する人を確かめるのは、持分のトークンの_updateが移す先しか確かめないためです。
解約の口数を移す先はファンドのコントラクトなので、_updateだけでは凍結された投資家の解約を拒めません。
ファンドのコントラクト自身も、円と口数を受け取るために円トークンの許可リストに載せておきます。

続けて、注文を読む2つの関数と、注文を列に足す内側の関数を足します。

    /// @notice 約定日の注文を全て返す
    function ordersOf(uint256 day) external view returns (Order[] memory) {
        return _orders[day];
    }

    /// @notice 注文のある約定日を古い順に全て返す
    function orderDays() external view returns (uint256[] memory) {
        return _orderDays;
    }

    // 注文を約定日の注文の列の最後に足す。その約定日の最初の注文なら、注文のある約定日の配列にも足す
    function _placeOrder(Kind kind, uint256 amount) private returns (uint256 day, uint256 index) {
        day = dayOf(block.timestamp);
        Order[] storage orders = _orders[day];
        if (orders.length == 0) _orderDays.push(day);
        index = orders.length;
        Order storage order = orders.push();
        order.investor = msg.sender;
        order.kind = kind;
        order.amount = amount;
        order.placedAt = uint64(block.timestamp);
        emit Ordered(day, index, msg.sender, kind, amount);
    }
行 意味
day = dayOf(block.timestamp) 今のブロックの時刻を日本時間の日付にして約定日にする。
締め切りと土日は次のレッスンで足す
if (orders.length == 0) _orderDays.push(day) その約定日の最初の注文の時だけ、約定日の一覧に足す。
ブロックの時刻は戻らないので、一覧は古い順に並ぶ
index = orders.length 足す前の件数が、新しい注文の列の番号になる。
最初の注文は0
orders.push() 列の最後に空の注文を足し、その場所をorderで指す。
statusを書かなくても最初の値のPendingになる
uint64(block.timestamp) 時刻を64ビットに縮める。
Unixの時刻は64ビットに十分収まる

最後に、starter/contracts/test/TokenizedFund.t.solのTokenizedFundTestの末尾に、申込と解約のテストを3つ足します。

    function test_SubscribeHoldsYen() public {
        vm.prank(alice);
        (uint256 day, uint256 index) = fund.subscribe(300_000);
        assertEq(day, THU);
        assertEq(index, 0);
        // 申込の円はファンドのコントラクトが預かる
        assertEq(jpy.balanceOf(address(fund)), 300_000 * YEN);
        assertEq(jpy.balanceOf(alice), 4_700_000 * YEN);
        assertEq(fund.pendingYen(), 300_000);
        TokenizedFund.Order[] memory orders = fund.ordersOf(THU);
        assertEq(orders.length, 1);
        assertEq(orders[0].investor, alice);
        assertEq(uint8(orders[0].kind), uint8(TokenizedFund.Kind.Subscribe));
        assertEq(orders[0].amount, 300_000);
        assertEq(fund.orderDays().length, 1);
    }

    function test_RedeemHoldsUnits() public {
        fund.mintForTest(alice, 500_000);
        vm.prank(alice);
        (uint256 day,) = fund.redeem(200_000);
        assertEq(day, THU);
        // 解約の口数はファンドのコントラクトが預かる
        assertEq(fund.balanceOf(alice), 300_000);
        assertEq(fund.balanceOf(address(fund)), 200_000);
        assertEq(fund.heldUnits(), 200_000);
        assertEq(uint8(fund.ordersOf(THU)[0].kind), uint8(TokenizedFund.Kind.Redeem));
    }

    function test_RevertWhen_SubscribeNotAllowed() public {
        vm.prank(carol);
        vm.expectRevert(abi.encodeWithSelector(TokenizedFund.NotAllowed.selector, carol));
        fund.subscribe(100_000);
        assertEq(fund.ordersOf(THU).length, 0);
        assertEq(fund.pendingYen(), 0);
    }
テスト 確かめること
test_SubscribeHoldsYen 300,000円の申込が約定日THUの列の番号0に入る。
ファンドのコントラクトが300,000円を預かり、aliceの円は4,700,000円に減る
test_RedeemHoldsUnits 500,000口を持つaliceが200,000口を解約すると、aliceの口数は300,000口になる。
ファンドのコントラクトが200,000口を預かる
test_RevertWhen_SubscribeNotAllowed 許可リストにいないcarolの申込はNotAllowedで拒まれ、注文の列も預かった円も0のまま

setUpは時計を2026-03-05(木)の日本時間の10時に合わせ、aliceとbobに5,000,000円ずつを渡して、ファンドへのapproveも済ませています。
THUの20517は、1970-01-01から数えた2026-03-05の日の番号で、10時の注文にdayOfが返す値です。
mintForTestは、テストの準備のために約定を通さず口数を渡す関数で、テストの中のファンドだけが持ちます。

assertEqはenumの値をそのまま比べられないので、uint8に直して比べます。
Subscribeは0、Redeemは1です。

確かめる

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

forge test

次の行が出れば、申込と解約の注文は列に溜まっています。

[PASS] test_RedeemHoldsUnits()
[PASS] test_RevertWhen_SubscribeNotAllowed()
[PASS] test_SubscribeHoldsYen()
Suite result: ok. 8 passed; 0 failed; 0 skipped

許可リストを確かめる行が効いていることも試しておきます。
subscribeの_checkInvestor(msg.sender);の行を消して実行すると、test_RevertWhen_SubscribeNotAllowedが失敗します。

[FAIL: Error != expected error: ERC20InsufficientAllowance(0x2e234DAe75C793f67A35089C9d99245E1C58470b, 0, 100000000000000000000000 [1e23]) != NotAllowed(0xA4d4c1f8a763Ef6a0140D04291eCEef913Ffc272)] test_RevertWhen_SubscribeNotAllowed()

0x2e23で始まるのがファンドのコントラクトで、0xA4d4で始まるのがcarolです。
1e23は、100,000円に円トークンの18桁を掛けた数です。
carolは円を任せていないので、円トークンがERC20InsufficientAllowanceで引き取りを止めます。
申込は止まりますが、拒んだ理由のエラーが許可リストのものではなくなります。

確かめたら、消した行を戻しておきます。
次のレッスンで、15時の締め切りと土日を休む営業日から約定日を決めます。