HandsOnChain

本人確認済みの人だけに送れるようにする

作るもの

このレッスンを終えると、許可リストにあるアカウントだけが円トークンを受け取ったり送ったりできるようになります。
許可リストにないアカウントへの発行と送金は、コントラクトがNotAllowedのエラーで拒みます。

背景

電子決済手段を扱う事業者は、犯罪収益移転防止法に従って、取引する人の本人確認をします。
誰のものか分からないアカウントへ自由に送れると、詐欺で得たお金や制裁の対象になっている人のお金を移すのに使われてしまうためです。

チェーン上のアカウントはアドレスで表されるだけで、持ち主の名前を持ちません。
そこで発行体は、本人確認が済んだ人のアドレスを許可リストに載せ、許可リストにあるアドレスの間でだけ円トークンが動くようにします。
本人確認の書類そのものはチェーンに置かず、発行体が自社で保管します。
チェーンに置くのは、確認が済んだかどうかの1ビットだけです。

送金を受け付けるか
ないない始まり終わり送金を頼む送り手は許可リストにある?受け手は許可リストにある?残高を動かすNotAllowedで拒む11223344あるあるあるある

実装

JpyToken.solに許可リストを足し、それを書き換える関数と拒む時のエラーも足します。

    /// @notice 本人確認が済み、送金と受け取りを許したアカウント
    mapping(address account => bool) public isAllowed;

    /// @notice 許可リストを変えた時に残す
    event AllowedSet(address indexed account, bool allowed);

    /// @notice 許可リストにないアカウントが送るか受け取ろうとした
    error NotAllowed(address account);

    /// @notice 本人確認の結果を許可リストに書く
    function setAllowed(address account, bool allowed) external onlyRole(COMPLIANCE_ROLE) {
        isAllowed[account] = allowed;
        emit AllowedSet(account, allowed);
    }

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

    /// @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);
    }

    function _checkAccount(address account) private view {
        if (!isAllowed[account]) revert NotAllowed(account);
    }
行 意味
from != address(0) 発行の時はfromがゼロアドレスになる。
発行体は持ち主ではないため、送り手の確認を飛ばす
to != address(0) burnの時はtoがゼロアドレスになるため、受け手の確認を飛ばす
super._update(...) 確認を通った後に、ERC-20の本来の処理で残高を動かす

テストのsetUpで利用者Aと利用者Bを許可リストに足し、許可リストにない利用者Cも用意します。
前のレッスンのtest_IssueToHolderは許可リストにある人への発行を確かめるテストになるため、名前をtest_IssueToAllowedHolderに変えます。

    address internal bob = makeAddr("bob");
    address internal carol = makeAddr("carol");

    function setUp() public {
        token = new JpyToken(issuer);
        vm.startPrank(issuer);
        token.setAllowed(alice, true);
        token.setAllowed(bob, true);
        vm.stopPrank();
    }

    function test_TransferBetweenAllowedHolders() public {
        _issue(alice, 10_000 ether);
        vm.prank(alice);
        assertTrue(token.transfer(bob, 2_500 ether));

        assertEq(token.balanceOf(alice), 7_500 ether);
        assertEq(token.balanceOf(bob), 2_500 ether);
    }

    function test_RevertWhen_IssueToNotAllowed() public {
        vm.expectRevert(abi.encodeWithSelector(JpyToken.NotAllowed.selector, carol));
        _issue(carol, 10_000 ether);
    }

    function test_RevertWhen_TransferToNotAllowed() public {
        _issue(alice, 10_000 ether);
        vm.expectRevert(abi.encodeWithSelector(JpyToken.NotAllowed.selector, carol));
        vm.prank(alice);
        token.transfer(carol, 1_000 ether);
        assertEq(token.balanceOf(alice), 10_000 ether);
    }

拒まれた後にaliceの残高が変わっていないことも確かめています。
拒まれる場合のテストでは、拒まれたことと状態が変わっていないことの両方を確かめます。

確かめる

forge test

test_TransferBetweenAllowedHoldersと2つのtest_RevertWhen_のテストが[PASS]になれば通っています。
setUpのtoken.setAllowed(bob, true);を消して実行すると、test_TransferBetweenAllowedHoldersがNotAllowedで失敗します。

ここからは、許可リストにないアカウントへは発行もできなくなります。
節2で作った画面から発行しようとしても、まだ誰も許可リストにいないため拒まれます。
許可リストを画面から書き換える欄は、この節の最後のレッスンで足します。