HandsOnChain

円トークンの名簿で移転を絞る

作るもの

このレッスンを終えると、社債トークンが円トークンの名簿を読み、本人確認の済んでいない人への移転を拒めます。
凍結した人からの移転も拒みます。
社債トークンは自分の名簿を持たず、円トークンの名簿をそのまま使います。

背景

証券会社は、犯罪収益移転防止法に従って、取引する人の本人確認をします。
チェーンの上の社債トークンは、何もしなければ誰のアドレスへも送れてしまいます。
そこで、社債が動くたびに、送り手と受け手が本人確認済みかをコントラクトが確かめます。

実務では、本人確認の済んだ人だけが持てるトークンの規格としてERC-3643があります。
ERC-3643のトークンは、移転のたびに身元の登録簿と移転の決まりを読み、通る時だけ残高を動かします。
このコースでは身元の登録簿を別に作らず、1作目の円トークンの名簿を読みます。

円トークンは、本人確認の済んだアカウントの許可リストと、凍結したアカウントの一覧を持ちます。
このコースでは、この2つをまとめて円トークンの名簿と呼びます。
社債の払い込みも利金の受け取りも円トークンで行うため、社債を持てる人と円トークンを受け取れる人は同じでなければなりません。
同じ人を2つの名簿に載せると、片方だけ凍結し忘れる事故が起きやすくなります。

円トークンの名簿 社債トークンでの扱い
isFrozenがtrue 送ることも受け取ることもできない。
AccountFrozenで拒む
isAllowedがfalse 送ることも受け取ることもできない。
NotAllowedで拒む
社債の移転を受け付けるか
通らない通る始まり終わり移転を頼む送り手は名簿を通る?受け手は名簿を通る?AccountFrozenかNotAllowedで拒む口数を動かす11223344通る通る通る通らない

実装

BondToken.solのerror BadSchedule();の下に、名簿で拒む時のエラーを2つ足します。

    /// @notice 円トークンの名簿で本人確認が済んでいないアカウント
    error NotAllowed(address account);
    /// @notice 円トークンの名簿で凍結されたアカウント
    error AccountFrozen(address account);

次に、burnの関数の下で、残高が動く時に必ず呼ばれる_updateをオーバーライドします。
OpenZeppelin ContractsのERC-20は、発行と移転とburnの全てを_updateの1か所で処理します。
ここで確かめれば、社債の発行と投資家どうしの移転と償還のburnのどれにも同じ決まりが適用されます。

    /// @dev 発行と移転と償還は全てここを通るため、名簿の確かめと残高の記録を1か所に置く
    function _update(address from, address to, uint256 value) internal override {
        if (from != address(0)) _checkAccount(from);
        if (to != address(0)) _checkAccount(to);
        super._update(from, to, value);
    }

    /// @dev 名簿は円トークンが持つ。社債は同じ人を2つの名簿に載せない
    function _checkAccount(address account) private view {
        if (jpy.isFrozen(account)) revert AccountFrozen(account);
        if (!jpy.isAllowed(account)) revert NotAllowed(account);
    }
行 意味
from != address(0) 発行の時はfromがゼロアドレスになるため、送り手の確認を飛ばし、受け取る投資家だけを確かめる
to != address(0) 償還のburnの時はtoがゼロアドレスになるため、受け手の確認を飛ばし、持ち主だけを確かめる
jpy.isFrozen(account) 前のレッスンで持たせた円トークンのアドレスから、凍結の一覧を読む
jpy.isAllowed(account) 同じく円トークンの許可リストを読む。
凍結を先に見るので、凍結した人はAccountFrozenで拒む
super._update(...) 確認を通った後に、ERC-20の本来の処理で口数を動かす

コメントにある残高の記録は、記録日と利払いの節で、ここに口数の履歴を足すことを指します。
名簿を書き換えるのは円トークンの本人確認の役割を持つ発行体だけで、社債トークンの側には名簿を書き換える関数を置きません。

テストのDigitalBondTestの続きに、拒む場合のテストを2つ足します。
前のレッスンのsetUpで投資家を名簿に載せてあるので、_mintで社債を発行する所はそのまま通ります。

    function test_RevertWhen_TransferToNotAllowed() public {
        _mint(alice, 10);
        vm.prank(alice);
        vm.expectRevert(abi.encodeWithSelector(BondToken.NotAllowed.selector, stranger));
        bond.transfer(stranger, 1);
        assertEq(bond.balanceOf(alice), 10);
    }

    function test_RevertWhen_TransferFromFrozen() public {
        _mint(alice, 10);
        vm.prank(issuer);
        jpy.setFrozen(alice, true);
        vm.prank(alice);
        vm.expectRevert(abi.encodeWithSelector(BondToken.AccountFrozen.selector, alice));
        bond.transfer(bob, 1);
        assertEq(bond.balanceOf(bob), 0);
    }
コード 意味
bond.transfer(stranger, 1) 名簿に載っていないstrangerへ1口送る。
受け手の確認でNotAllowedになる
jpy.setFrozen(alice, true) 発行体が円トークンの側でaliceを凍結する。
社債トークンには何もしない
bond.transfer(bob, 1) 凍結されたaliceから、本人確認済みのbobへ送る。
送り手の確認でAccountFrozenになる
assertEq(...) 拒まれた後に、口数が動いていないことを確かめる

2つ目のテストは、円トークンで凍結しただけで社債も動かせなくなることを確かめています。
名簿を1か所に置いたので、発行体は凍結の操作を1回で済ませられます。

確かめる

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

forge test --match-contract DigitalBondTest

次の行が出れば、テストは通っています。

[PASS] test_RevertWhen_MintWithoutRole()
[PASS] test_RevertWhen_TransferFromFrozen()
[PASS] test_RevertWhen_TransferToNotAllowed()
[PASS] test_TermsAndDecimals()
Suite result: ok. 4 passed; 0 failed; 0 skipped

_updateのif (to != address(0)) _checkAccount(to);の行を消して実行すると、test_RevertWhen_TransferToNotAllowedが[FAIL: next call did not revert as expected]になります。
受け手を確かめないと、本人確認の済んでいない人へも社債が届いてしまうことを示します。
試した後は消した行を戻しておきます。