HandsOnChain

日割りの利金を計算する

作るもの

このレッスンを終えると、決済のコントラクトが前の利払い日からの日数で1口の利金を計算し、1円未満を切り捨てて返せるようになります。
記録日の発行の総数に1口の利金を掛けて、発行体が入れる総額も出せます。
第1回は1口の利金が396円になり、30口の総額は11,880円になります。

背景

日本の普通社債の利息は年2回払いが多く、日割りの計算は実際の日数を365で割る形が多くなっています。
このコースでは、毎回の利金を、前の利払い日から今回の利払い日までの実際の日数で日割りにします。
第1回だけは、前の利払い日の代わりに払込日から数えます。

1口の利金は、額面に年の利率と日数を掛けて365で割り、1円未満を切り捨てた額です。
コースの社債は、1口の額面が100,000円で、利率が年0.80%です。

回 数える期間 日数 計算 1口の利金 30口の総額
第1回 2026-01-15から2026-07-15 181日 100,000 × 0.80% × 181 / 365 = 396.71… 396円 11,880円
第2回 2026-07-15から2027-01-15 184日 100,000 × 0.80% × 184 / 365 = 403.28… 403円 12,090円

2つの期間の日数は合わせて365日ですが、半分ずつではないので、2回の利金は同じ額になりません。
1年分の利息は800円になるはずですが、2回の合計は799円です。
それぞれの回で1円未満を切り捨てるため、合わせると1円少なくなります。

総額は、1口の利金に記録日の総数を掛けて出します。
先に30口分の利息を計算すると、100,000 × 30 × 0.80% × 181 / 365 = 11,901.36…で11,901円になります。
この額は1口ずつに分けると割り切れず、投資家が受け取る額の和と合いません。
1口の利金を先に決めておけば、投資家が受け取る額は1口の利金に口数を掛けた額になり、その和は総額と1円も違いません。

Solidityでは小数の計算ができず、整数の割り算は小数点以下を捨てます。
1円未満の切り捨ては、この割り算でそのまま行えます。
ただし、割り算を先にすると、途中で捨てた分が後の掛け算で大きくなります。
額面と利率と日数を全て掛けてから、最後に1回だけ割ります。

実装

starter/contracts/contracts/BondSettlement.solを開き、issuedの関数の後に、利払いの2つの関数を足します。

    // 利払い

    /// @notice n回目の1口の利金 (円)。額面 × 利率 × 日数 / 365 を1円未満で切り捨てる。日数は前の利払い日 (1回目は払込日) から数える
    function couponPerUnit(uint256 n) public view returns (uint256) {
        uint256 start = n == 0 ? bond.issueDate() : bond.paymentDate(n - 1);
        uint256 days_ = (bond.paymentDate(n) - start) / 1 days;
        return (bond.faceValue() * bond.rateBps() * days_) / (10_000 * 365);
    }

    /// @notice n回目に発行体が入れる総額 (円トークンの最小単位)。記録日の口数の和に1口の利金を掛ける
    function couponDue(uint256 n) public view returns (uint256) {
        return couponPerUnit(n) * bond.totalSupplyAt(bond.recordDate(n)) * YEN;
    }
行 意味
n == 0 ? bond.issueDate() : bond.paymentDate(n - 1) 回は0から数える。
第1回 (nが0) は払込日から、第2回からは前の利払い日から数える
/ 1 days 秒の差を日数にする。
1 daysはSolidityで86,400秒を表す。
日付は全て日本時間の0時なので、割り切れる
bond.rateBps() 1万分の1を単位にした利率。
80は年0.80%になる
/ (10_000 * 365) 利率の単位の1万と、年の日数の365で、最後に1回だけ割る
bond.totalSupplyAt(bond.recordDate(n)) 前のレッスンで作った関数で、記録日の発行の総数を読む
* YEN 円の額を、18桁を持つ円トークンの最小単位にする

couponPerUnitは1円単位の額を返し、couponDueは円トークンの最小単位の額を返します。
1口の利金は画面で円のまま見せ、総額は発行体が円トークンを入れる時の額にそのまま使うためです。

記録日より前にcouponDueを呼ぶと、totalSupplyAtは今の総数を返します。
社債の総数は、発行してから満期に償還するまで変わりません。
記録日の前に計算しても、記録日の後に計算しても、総額は同じになります。

starter/contracts/test/DigitalBond.t.solのDigitalBondTestの末尾に、利金の計算のテストを足します。

    function test_CouponIsActualOver365RoundedDown() public {
        // 第1回は2026-01-15から2026-07-15までの181日。100,000 × 0.80% × 181 / 365 = 396.71... で396円
        assertEq(settlement.couponPerUnit(0), 396);
        // 第2回は2026-07-15から2027-01-15までの184日。403.28... で403円
        assertEq(settlement.couponPerUnit(1), 403);
        _issueBond();
        assertEq(settlement.couponDue(0), 396 * ISSUE_AMOUNT * YEN);
    }
行 意味
settlement.couponPerUnit(0) 第1回の1口の利金が、切り捨てた396円になる
_issueBond() aliceが10口とbobが12口とcarolが8口を申し込み、締め切りの後に締めて30口を発行する
396 * ISSUE_AMOUNT * YEN 第1回の総額は、396円に30口を掛けた11,880円を円トークンの最小単位にした額

確かめる

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

forge test --match-contract DigitalBondTest

次の行が出れば、テストは通っています。

[PASS] test_CouponIsActualOver365RoundedDown()
Suite result: ok. 12 passed; 0 failed; 0 skipped

割り算を先にすると何が起きるかも試しておきます。
couponPerUnitのreturnの行を次のように書き換えて実行します。

        return (bond.faceValue() * bond.rateBps() / (10_000 * 365)) * days_;

1口の1日分の利息 (2.19…円) を先に2円へ切り捨て、それに181日を掛けるため、362円になってテストが失敗します。

[FAIL: assertion failed: 362 != 396] test_CouponIsActualOver365RoundedDown()

確かめたら、元の行に戻しておきます。
次のレッスンで、発行体がこの総額を入れ、投資家が自分の分を受け取れるようにします。