HandsOnChain

アカウントを凍結する

作るもの

このレッスンを終えると、本人確認の役割を持つアカウントが特定のアカウントを凍結できるようになります。
凍結したアカウントからの送金も凍結したアカウントへの送金も、コントラクトがAccountFrozenのエラーで拒みます。
凍結は解くこともでき、解いた後は元どおり送れます。

背景

銀行は、詐欺に使われたり裁判所や警察から求めがあったりした銀行口座の取引を止めます。
円建てステーブルコインの発行体の多くも、同じように特定のアカウントの取引を止める仕組みを持っています。
止める仕組みがないと、盗まれた円トークンが次々に送られて取り戻せなくなるためです。

許可リストから外す操作と凍結は似ていますが、意味が違います。

操作 意味 使う場面
許可リストから外す 本人確認が済んでいない状態に戻す 確認の期限が切れた時、持ち主が解約した時
凍結する 本人確認は済んだまま、一時的に取引を止める 不正の疑いを調べる間、裁判所や警察の求めに応じる間

2つを分けておけば、調べ終えて凍結を解いた時に本人確認をやり直さずに済みます。

実装

JpyToken.solに凍結の状態を足し、それを書き換える関数と拒む時のエラーも足します。

    /// @notice 凍結したアカウント
    mapping(address account => bool) public isFrozen;

    /// @notice 凍結を変えた時に残す
    event FrozenSet(address indexed account, bool frozen);

    /// @notice 凍結したアカウントが送るか受け取ろうとした
    error AccountFrozen(address account);

    /// @notice アカウントを凍結するか、凍結を解く
    function setFrozen(address account, bool frozen) external onlyRole(COMPLIANCE_ROLE) {
        isFrozen[account] = frozen;
        emit FrozenSet(account, frozen);
    }

_checkAccountで、許可リストより先に凍結を確かめます。

    function _checkAccount(address account) private view {
        if (isFrozen[account]) revert AccountFrozen(account);
        if (!isAllowed[account]) revert NotAllowed(account);
    }

凍結を先に確かめるのは、凍結したアカウントが許可リストからも外れていた時にAccountFrozenを返すためです。
この節の最後に作る画面で、止まった理由を正しく表示できます。

テストを2つ足します。

    function test_RevertWhen_TransferFromFrozen() public {
        _issue(alice, 10_000 ether);
        vm.prank(issuer);
        token.setFrozen(alice, true);

        vm.expectRevert(abi.encodeWithSelector(JpyToken.AccountFrozen.selector, alice));
        vm.prank(alice);
        token.transfer(bob, 1_000 ether);
        assertEq(token.balanceOf(bob), 0);
    }

    function test_RevertWhen_TransferToFrozen() public {
        _issue(alice, 10_000 ether);
        vm.prank(issuer);
        token.setFrozen(bob, true);

        vm.expectRevert(abi.encodeWithSelector(JpyToken.AccountFrozen.selector, bob));
        vm.prank(alice);
        token.transfer(bob, 1_000 ether);
    }

確かめる

forge test

2つのtest_RevertWhen_Transfer...Frozenが[PASS]になれば通っています。
凍結したアカウントは償還もできません。
redeemも_updateを呼び、送り手の確認で拒まれるためです。