入金に応じて発行する
作るもの
このレッスンを終えると、発行の役割を持つアカウントだけが、銀行の入金と照らし合わせる番号を添えて円トークンを発行できます。
発行するとIssuedのイベントが残り、どの入金に対して誰にいくら発行したかを後から辿れます。
発行の役割を持たないアカウントが発行しようとすると、コントラクトが拒みます。
背景
電子決済手段の発行体は、利用者から受け取った円と同じ額だけを発行します。
発行した額より多くの円を持っていないと、全員が払い戻しを求めた時に払えなくなるためです。
そのため発行体は、銀行口座への入金を確かめてから発行し、入金と発行を1件ずつ照らし合わせる記録を残します。
照合番号をイベントに残すと、銀行の明細とチェーンの記録を後から突き合わせられます。
監査の時に、発行した全ての額に入金の裏付けがあることを示す材料になります。
実装
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]に変わります。
役割の確認を消すと誰でも円トークンを発行できてしまうことを、このテストで見つけられます。