HandsOnChain

払えない時に不履行を記録する

作るもの

このレッスンを終えると、満期を過ぎても償還の額が足りない時に、誰でも社債を不履行の状態にできます。
不履行を記録した社債は、決済のコントラクトで売りに出すことも買うこともできなくなります。
記録した後でも、発行体が足りない分を遅れて入れれば、投資家は前のレッスンのredeemで額面を受け取れます。

背景

発行体が利息か元本を約束の日に払えないことを、債務不履行(デフォルト)と呼びます。
満期に額面を返せない時、社債を持つ人は返ってくるはずの元本を受け取れません。

満期を過ぎても償還の額が足りないかどうかは、チェーンの上の値だけで決まります。
満期の日付は社債トークンが持ち、入れてもらった額と払う総額は決済のコントラクトが持つためです。
コントラクトが条件を自分で確かめるので、記録する人が誰かを確かめる必要はありません。

不履行を記録できる人を発行体だけにすると、払えない発行体が記録しないまま黙っていられます。
困るのは額面を受け取れない投資家なので、記録するdeclareDefaultは誰でも呼べるようにします。
条件を満たさない時はコントラクトが拒むため、誰でも呼べても払いの済んだ社債は不履行にできません。

このコースでは、不履行を記録した社債の売買を決済のコントラクトで止めます。
売買の値段に足す経過利息は、約束どおりに利金と額面が払われる社債のための計算だからです。

不履行を記録しても、発行体が額面を返す約束は消えません。
発行体が遅れて足りない分を入れると、投資家はふだんと同じredeemで額面を受け取れます。
不履行の記録は、払いが遅れたことの記録としてそのまま残ります。

満期の後に償還か不履行に分かれる
届いた入れていない始まり終わり満期を迎える償還の額は総額に届いた?誰かが不履行を記録する発行体が足りない分を入れた?投資家が償還を受ける売買を止めたまま入金を待つ1122334455足りない足りない足りない入れた

実装

不履行かどうかは社債そのものの状態なので、社債トークンに持たせます。
画面もほかのコントラクトも、社債トークンを読めば不履行かどうかが分かります。
starter/contracts/contracts/BondToken.solの_supplyHistoryの下に、不履行の印とイベントを足します。

    /// @notice 満期に償還できず、不履行になったか
    bool public defaulted;

    /// @notice 社債が不履行になった
    event Defaulted();

burnの下に、不履行にする関数を足します。

    /// @notice 満期に償還の額が足りない社債を不履行にする
    function markDefaulted() external onlyRole(SETTLEMENT_ROLE) {
        defaulted = true;
        emit Defaulted();
    }
行 意味
onlyRole(SETTLEMENT_ROLE) 決済のコントラクトだけが呼べる。
不履行にしてよいかの条件は、決済のコントラクトが確かめる
defaulted = true 一度立てた印は戻さない。
遅れて払われた後も、不履行になったことが残る

starter/contracts/contracts/BondSettlement.solには、まず償還のエラーの下にエラーを2つ足します。

    error BondDefaulted();
    error RedemptionFullyFunded();
エラー 拒む時
BondDefaulted 不履行の社債を売りに出すか、買おうとした。
不履行を2回記録しようとした時も拒む
RedemptionFullyFunded 償還の額が全て入っているのに、不履行にしようとした

listとbuyの最初の行で、社債が不履行なら拒みます。

    function list(uint256 units, uint256 price) external returns (uint256 id) {
        if (bond.defaulted()) revert BondDefaulted();
        if (units == 0) revert ZeroUnits();
    function buy(uint256 id) external {
        if (bond.defaulted()) revert BondDefaulted();
        Order storage order = _orders[id];

buyでも確かめるので、不履行になる前に出した売りの注文も買えなくなります。
最後に、ファイルの末尾のredeemの下にdeclareDefaultを足します。

    /// @notice 満期の後に償還の額が足りない時、誰でも社債を不履行にできる。不履行の社債は売買できない
    function declareDefault() external {
        uint64 maturity = bond.maturity();
        if (block.timestamp < maturity) revert BeforeMaturity(maturity);
        if (!issued()) revert NotIssued();
        if (bond.defaulted()) revert BondDefaulted();
        if (redemptionFunded >= redemptionDue()) revert RedemptionFullyFunded();
        bond.markDefaulted();
    }
行 意味
block.timestamp < maturity 満期の前は、まだ返す日が来ていないので拒む
!issued() 募集が不成立で社債を発行していない時は、返す額面もないので拒む
bond.defaulted() もう不履行を記録した時は拒む
redemptionFunded >= redemptionDue() 総額が入っている時は不履行ではないので拒む
bond.markDefaulted() 社債トークンに不履行の印を立てる

不履行は1回だけ記録します。
誰でも呼べる関数なので、拒まないと2回目からの呼び出しのたびにDefaultedのイベントが残り、いつ不履行になったかを読み違えるためです。
declareDefaultにはonlyIssuerを付けず、呼んだ人が誰かを確かめません。
fundRedemptionとredeemはdefaultedを読まないため、不履行の後に発行体が足りない分を入れれば、投資家は償還を受けられます。

starter/contracts/test/DigitalBond.t.solのDigitalBondTestの末尾に、2つのテストを足します。

    function test_DefaultWhenMaturityUnpaid() public {
        _issueBond();
        _fundRedemption(ISSUE_AMOUNT * FACE * YEN / 2);
        vm.warp(MATURITY);
        vm.prank(alice);
        vm.expectRevert(abi.encodeWithSelector(BondSettlement.RedemptionUnfunded.selector, ISSUE_AMOUNT * FACE * YEN / 2, ISSUE_AMOUNT * FACE * YEN));
        settlement.redeem();
        settlement.declareDefault();
        assertTrue(bond.defaulted());
        assertEq(bond.balanceOf(alice), 10);
        // 不履行は1回だけ記録する
        vm.expectRevert(BondSettlement.BondDefaulted.selector);
        settlement.declareDefault();
    }

    function test_RevertWhen_TradeAfterDefault() public {
        _issueBond();
        vm.startPrank(bob);
        bond.approve(address(settlement), 3);
        uint256 id = settlement.list(3, 99_900);
        vm.stopPrank();
        vm.warp(MATURITY);
        settlement.declareDefault();
        vm.startPrank(alice);
        jpy.approve(address(settlement), type(uint256).max);
        vm.expectRevert(BondSettlement.BondDefaulted.selector);
        settlement.buy(id);
        vm.stopPrank();
        assertEq(bond.balanceOf(bob), 12);
    }

test_DefaultWhenMaturityUnpaidでは、発行体が総額の半分の1,500,000円だけを入れて満期を迎えます。
aliceの償還はRedemptionUnfundedで拒まれ、エラーには入れた額と総額が入ります。
続くsettlement.declareDefault()はvm.prankを付けずに呼ぶので、発行体でも投資家でもないテストのコントラクトが記録します。
不履行になっても、aliceの10口はそのまま残ります。
最後にもう一度declareDefaultを呼び、2回目がBondDefaultedで拒まれることを確かめます。

test_RevertWhen_TradeAfterDefaultでは、bobが満期の前に3口を1口99,900円で売りに出します。
満期の後に不履行を記録すると、aliceの買いはBondDefaultedで拒まれ、bobの12口は動きません。

確かめる

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

forge test --match-contract DigitalBondTest

次の行が出れば、不履行の記録と売買の停止は正しく動いています。

[PASS] test_DefaultWhenMaturityUnpaid()
[PASS] test_RevertWhen_TradeAfterDefault()
Suite result: ok. 24 passed; 0 failed; 0 skipped

buyのif (bond.defaulted()) revert BondDefaulted();の行を消して実行すると、test_RevertWhen_TradeAfterDefaultが[FAIL: next call did not revert as expected]で失敗します。
listだけで止めても、不履行の前に出した注文は買えてしまうと分かります。
試したら行を戻しておきます。

次のレッスンで、ここまでの操作をどの順で行っても崩れない性質を、invariantテストで確かめます。