満期に償還する
作るもの
このレッスンを終えると、発行体が額面の合計を決済のコントラクトへ入れ、投資家が満期の後に償還を受けられます。
投資家は持っている口数の分だけ1口100,000円の額面を円トークンで受け取り、受け取った社債はburnされます。
円の支払いと社債のburnは、1つの取引の中で一緒に行います。
背景
社債は、満期の日に発行体が額面を投資家へ返して終わります。
この払い戻しを、社債の償還と呼びます。
日本の社債の多くは振替制度の帳簿の記録として受け渡すため、償還が済んだ社債はその帳簿から記録が消されます。
このコースの社債は30口を1口100,000円で発行したので、満期の2027-01-15に返す額面の合計は3,000,000円です。
最後の利払い日は満期と同じ日なので、投資家は満期に第2回の利金の1口403円と、額面を一緒に受け取ります。
オンチェーンでは、利払いと同じく発行体が先に額を決済のコントラクトへ入れ、投資家が満期の後に自分で受け取りに来ます。
投資家が受け取る時、決済のコントラクトは投資家の社債をburnし、同じ取引で額面の円を送ります。
払い込みと売買のDvPと同じく、社債を返したのに円が届かない状態も、円を受け取ったのに社債が残る状態も起きません。
入れた額が総額に届くまでは、どの投資家も受け取れないようにします。
足りないまま受け取れると、先に来た投資家だけが額面を受け取り、後から来た投資家の分が足りなくなるためです。
実装
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]と出ます。
額面を払ったのに社債が残っていて、残った社債でもう一度償還を受けられてしまう誤りを、テストが見つけます。
試したら行を戻しておきます。
次のレッスンで、満期を過ぎても償還の額が足りない時に、不履行を記録できるようにします。