HandsOnChain

入金に応じて発行する

作るもの

このレッスンを終えると、発行の役割を持つアカウントだけが、銀行の入金と照らし合わせる番号を添えて円トークンを発行できます。
発行するとIssuedのイベントが残り、どの入金に対して誰にいくら発行したかを後から辿れます。
発行の役割を持たないアカウントが発行しようとすると、コントラクトが拒みます。

背景

電子決済手段の発行体は、利用者から受け取った円と同じ額だけを発行します。
発行した額より多くの円を持っていないと、全員が払い戻しを求めた時に払えなくなるためです。
そのため発行体は、銀行口座への入金を確かめてから発行し、入金と発行を1件ずつ照らし合わせる記録を残します。

入金を確かめてから発行する
利用者円トークンが欲しい銀行口座発行体の銀行口座発行体発行の役割を持つ円トークンJpyToken11223310,000円を振り込む10,000円を振り込む入金の明細 DEP-0001入金の明細 DEP-0001issue(利用者, 10,000, DEP-0001)10,000 HJPY額と照合番号を照らし合わせる額と照合番号を照らし合わせる

照合番号をイベントに残すと、銀行の明細とチェーンの記録を後から突き合わせられます。
監査の時に、発行した全ての額に入金の裏付けがあることを示す材料になります。

実装

JpyToken.solに、発行のイベントとissueの関数を足します。

    /// @notice 入金を確かめて発行した時に残す。depositRef は銀行の入金を照らし合わせる番号
    event Issued(address indexed to, uint256 amount, bytes32 indexed depositRef);

    /// @notice 入金を確かめた額だけ発行する
    function issue(address to, uint256 amount, bytes32 depositRef) external onlyRole(ISSUER_ROLE) {
        _mint(to, amount);
        emit Issued(to, amount, depositRef);
    }
行 意味
indexed イベントを、この値で絞り込んで探せるようにする
onlyRole(ISSUER_ROLE) 発行の役割を持たないアカウントの呼び出しを拒む
_mint(to, amount) ERC-20の残高と供給量を同じ額だけ増やす
emit Issued(...) 発行の記録をイベントとして残す

テストには、発行のテストと、役割を持たないアカウントの発行を拒むテストを足します。

    bytes32 internal constant DEPOSIT_REF = keccak256("bank-deposit-0001");

    function _issue(address to, uint256 amount) internal {
        vm.prank(issuer);
        token.issue(to, amount, DEPOSIT_REF);
    }

    function test_IssueToHolder() public {
        vm.expectEmit(address(token));
        emit JpyToken.Issued(alice, 10_000 ether, DEPOSIT_REF);
        _issue(alice, 10_000 ether);

        assertEq(token.balanceOf(alice), 10_000 ether);
        assertEq(token.totalSupply(), 10_000 ether);
    }

    function test_RevertWhen_IssueWithoutRole() public {
        bytes32 role = token.ISSUER_ROLE();
        vm.expectRevert(abi.encodeWithSelector(IAccessControl.AccessControlUnauthorizedAccount.selector, alice, role));
        vm.prank(alice);
        token.issue(alice, 10_000 ether, DEPOSIT_REF);
    }
行 意味
10_000 ether 10000 × 10^18のこと。
Solidityのetherは18桁の単位で、円トークンの1円にも同じ桁を使う
vm.expectEmit(address(token)) 次に書いたイベントと同じものが、このコントラクトから出ることを求める

確かめる

forge test

test_IssueToHolderとtest_RevertWhen_IssueWithoutRoleが[PASS]になれば通っています。
issueのonlyRole(ISSUER_ROLE)を消してテストを実行すると、test_RevertWhen_IssueWithoutRoleが[FAIL]に変わります。
役割の確認を消すと誰でも円トークンを発行できてしまうことを、このテストで見つけられます。