償還で円に戻す
作るもの
このレッスンを終えると、円トークンの持ち主が自分の円トークンをburnし、払い戻しの依頼をRedemptionRequestedのイベントで残せます。
発行体はこのイベントを読み、同じ額の円を持ち主の銀行口座へ振り込みます。
背景
電子決済手段の発行体は、持ち主から求められた時に、発行した時と同じ額で払い戻す義務を負います。
この払い戻しを償還と呼びます。
円トークンが1円の価値を保つのは、償還できるという約束があるためです。
先にburnしてから払い戻すのは、払い戻した後の円トークンが残って二重に使われるのを防ぐためです。
burnすると供給量も減るため、発行体が持つ円と供給量が同じ額のまま保たれます。
実装
JpyToken.solに、償還のイベントとredeemの関数を足します。
/// @notice 持ち主が償還した時に残す。発行体はこの記録を見て銀行口座へ払い戻す
event RedemptionRequested(address indexed holder, uint256 amount);
/// @notice 持ち主が自分の円トークンをburnし、払い戻しを依頼する
function redeem(uint256 amount) external {
_burn(msg.sender, amount);
emit RedemptionRequested(msg.sender, amount);
}
| 行 | 意味 |
|---|---|
msg.sender |
この関数を呼んだアカウント。 持ち主は自分の残高だけを償還できる |
_burn(msg.sender, amount) |
残高と供給量を同じ額だけ減らす。 残高が足りない時は ERC20InsufficientBalanceで拒む |
テストを足します。
function test_RedeemBurnsAndEmits() public {
_issue(alice, 10_000 ether);
vm.expectEmit(address(token));
emit JpyToken.RedemptionRequested(alice, 3_000 ether);
vm.prank(alice);
token.redeem(3_000 ether);
assertEq(token.balanceOf(alice), 7_000 ether);
assertEq(token.totalSupply(), 7_000 ether);
}
確かめる
forge test
test_RedeemBurnsAndEmitsが[PASS]になれば、コントラクトの発行と償還が揃います。
この時点で6つのテストが全て通ります。
Suite result: ok. 6 passed; 0 failed; 0 skipped
次のレッスンで、発行と償還をブラウザから行う画面を作ります。