HandsOnChain

償還で円に戻す

作るもの

このレッスンを終えると、円トークンの持ち主が自分の円トークンをburnし、払い戻しの依頼をRedemptionRequestedのイベントで残せます。
発行体はこのイベントを読み、同じ額の円を持ち主の銀行口座へ振り込みます。

背景

電子決済手段の発行体は、持ち主から求められた時に、発行した時と同じ額で払い戻す義務を負います。
この払い戻しを償還と呼びます。
円トークンが1円の価値を保つのは、償還できるという約束があるためです。

償還して円に戻す
円トークン持ち主の残高7,000供給量7,000持ち主円に戻したい円トークンJpyToken発行体イベントを読む銀行口座持ち主の銀行口座112233redeem(3,000)redeem(3,000)RedemptionRequestedRedemptionRequested3,000円を振り込む3,000をburnする3,000をburnする

先に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

次のレッスンで、発行と償還をブラウザから行う画面を作ります。