HandsOnChain

満期に償還する

作るもの

このレッスンを終えると、発行体が額面の合計を決済のコントラクトへ入れ、投資家が満期の後に償還を受けられます。
投資家は持っている口数の分だけ1口100,000円の額面を円トークンで受け取り、受け取った社債はburnされます。
円の支払いと社債のburnは、1つの取引の中で一緒に行います。

背景

社債は、満期の日に発行体が額面を投資家へ返して終わります。
この払い戻しを、社債の償還と呼びます。
日本の社債の多くは振替制度の帳簿の記録として受け渡すため、償還が済んだ社債はその帳簿から記録が消されます。

このコースの社債は30口を1口100,000円で発行したので、満期の2027-01-15に返す額面の合計は3,000,000円です。
最後の利払い日は満期と同じ日なので、投資家は満期に第2回の利金の1口403円と、額面を一緒に受け取ります。

オンチェーンでは、利払いと同じく発行体が先に額を決済のコントラクトへ入れ、投資家が満期の後に自分で受け取りに来ます。
投資家が受け取る時、決済のコントラクトは投資家の社債をburnし、同じ取引で額面の円を送ります。
払い込みと売買のDvPと同じく、社債を返したのに円が届かない状態も、円を受け取ったのに社債が残る状態も起きません。

入れた額が総額に届くまでは、どの投資家も受け取れないようにします。
足りないまま受け取れると、先に来た投資家だけが額面を受け取り、後から来た投資家の分が足りなくなるためです。

満期に額面を払って社債をburnする
決済のコントラクト入金済み3,000,000円払った額1,000,000円発行体額面の合計を入れる決済のコントラクトBondSettlement社債トークンBondToken投資家A10口を持つ112233fundRedemption(3,000,000円)fundRedemption(3,000,000円)redeem()redeem()burn(投資家A, 10)1,000,000円

実装

starter/contracts/contracts/BondSettlement.solの_ordersの下に、入れてもらった償還の額と払った償還の額を足します。

    Order[] private _orders;
    /// @notice 発行体が入れた償還の額
    uint256 public redemptionFunded;
    /// @notice 投資家へ払った償還の額
    uint256 public redemptionPaid;

redemptionFundedからredemptionPaidを引いた額が、決済のコントラクトがまだ払っていない償還の円です。
利払いのイベントとエラーの下に、償還のイベントとエラーを足します。

    event RedemptionFunded(uint256 amount);
    event Redeemed(address indexed investor, uint256 units, uint256 amount);
    error BeforeMaturity(uint64 maturity);
    error RedemptionUnfunded(uint256 funded, uint256 due);
    error NothingToRedeem();
エラー 拒む時
BeforeMaturity 満期の前に償還を受けようとした
RedemptionUnfunded 発行体の入れた額が、償還の総額に届いていない
NothingToRedeem 償還を受けるアカウントが社債を持っていない

ファイルの末尾のorderAtの下に、償還の総額と、発行体が償還の額を入れる関数を足します。

    // 満期

    /// @notice 満期に払う償還の総額 (円トークンの最小単位)。発行した口数に額面を掛ける
    function redemptionDue() public view returns (uint256) {
        return issued() ? issueAmount * bond.faceValue() * YEN : 0;
    }

    /// @notice 発行体が償還の額を入れる。総額を超えた分は発行体へ返す
    function fundRedemption(uint256 amount) external onlyIssuer {
        if (!issued()) revert NotIssued();
        jpy.transferFrom(msg.sender, address(this), amount);
        uint256 due = redemptionDue();
        uint256 room = due > redemptionFunded ? due - redemptionFunded : 0;
        uint256 kept = amount < room ? amount : room;
        redemptionFunded += kept;
        if (amount > kept) jpy.transfer(msg.sender, amount - kept);
        emit RedemptionFunded(kept);
    }
行 意味
issued() ? ... : 0 募集が不成立で社債を発行していない時は、返す額面もないので0にする
issueAmount * bond.faceValue() * YEN 30口に額面の100,000円を掛け、円トークンの18桁の単位にする
onlyIssuer 発行体のアカウントだけが入れられる
room 総額のうち、まだ入っていない額
kept 入れた額とroomの小さいほう。
総額を超えた分は、同じ取引で発行体へ返す

利金のfundCouponと同じく、足りない分は後から何度でも足せます。
続けて、投資家が償還を受ける関数を足します。

    /// @notice 満期の後に、持っている社債をburnして額面の円を受け取る
    function redeem() external {
        uint64 maturity = bond.maturity();
        if (block.timestamp < maturity) revert BeforeMaturity(maturity);
        uint256 due = redemptionDue();
        if (redemptionFunded < due) revert RedemptionUnfunded(redemptionFunded, due);
        uint256 units = bond.balanceOf(msg.sender);
        if (units == 0) revert NothingToRedeem();
        bond.burn(msg.sender, units);
        uint256 amount = units * bond.faceValue() * YEN;
        redemptionPaid += amount;
        jpy.transfer(msg.sender, amount);
        emit Redeemed(msg.sender, units, amount);
    }
行 意味
block.timestamp < maturity 満期の前は拒む。
満期は社債トークンが持つ最後の利払い日
redemptionFunded < due 総額が入るまでは、誰の償還も拒む
bond.balanceOf(msg.sender) 呼んだ投資家が今持っている口数の全てを償還する
bond.burn(msg.sender, units) 決済の役割で社債をburnする。
社債の総数も同じ口数だけ減る
units * bond.faceValue() * YEN 1口ごとに額面の円を払う
redemptionPaid += amount 払った額を残す。
後のレッスンのテストで、まだ払っていない額を数えるのに使う

burnは、節1で社債トークンに置いた、決済の役割を持つアカウントだけが呼べる関数です。
円の支払いと社債のburnは同じ取引の中にあるため、どちらかで拒まれると取引の全てが取り消されます。

テストを足します。
starter/contracts/test/DigitalBond.t.solのDigitalBondBaseの_fundCouponの下に、発行体が償還の額を入れる_fundRedemptionを足します。

    function _fundRedemption(uint256 amount) internal {
        vm.startPrank(issuer);
        jpy.approve(address(settlement), amount);
        settlement.fundRedemption(amount);
        vm.stopPrank();
    }

DigitalBondTestの末尾に、節5のテストを足します。

    // 節5 満期の償還と不履行

    function test_RedeemAtMaturityPaysFaceAndBurns() public {
        _issueBond();
        _fundCoupon(1, settlement.couponDue(1));
        _fundRedemption(ISSUE_AMOUNT * FACE * YEN);
        vm.warp(MATURITY);
        uint256 before = jpy.balanceOf(alice);
        vm.startPrank(alice);
        settlement.claimCoupon(1);
        settlement.redeem();
        vm.stopPrank();
        assertEq(jpy.balanceOf(alice), before + 403 * 10 * YEN + 10 * FACE * YEN);
        assertEq(bond.balanceOf(alice), 0);
        assertEq(bond.totalSupply(), ISSUE_AMOUNT - 10);
    }

_issueBondはaliceに10口、bobに12口、carolに8口を発行します。
発行体が第2回の利金と償還の額を入れた後に、時刻を満期へ進めます。
第2回は0から数えて1の回です。
aliceが利金と償還を続けて受け取ると、円は利金の403円×10口と額面の100,000円×10口だけ増えます。
aliceの社債は0口になり、社債の総数は残りの2人が持つ20口になります。

確かめる

starter/contractsのディレクトリでテストを実行します。

forge test --match-contract DigitalBondTest

次の行が出れば、償還は正しく動いています。

[PASS] test_RedeemAtMaturityPaysFaceAndBurns()
Suite result: ok. 22 passed; 0 failed; 0 skipped

redeemのbond.burn(msg.sender, units);の行を消して実行すると、[FAIL: assertion failed: 10 != 0]と出ます。
額面を払ったのに社債が残っていて、残った社債でもう一度償還を受けられてしまう誤りを、テストが見つけます。
試したら行を戻しておきます。

次のレッスンで、満期を過ぎても償還の額が足りない時に、不履行を記録できるようにします。