HandsOnChain

社債の条件を持つトークンを作る

作るもの

このレッスンを終えると、1口の額面と年の利率、払込日と利払い日と記録日を持つ社債トークンができます。
社債を発行してburnできるのは、決済の役割を持つアカウントだけです。
社債の条件と役割の決まりは、Foundryのテストで確かめられます。

背景

社債を出す時、発行体は社債の条件を決めて投資家に示します。
このコースでは、社債の条件を次の値にします。

条件 値 意味
1口の額面 100,000円 満期に1口につき返す額
利率 年0.80% 額面に対する1年分の利息の割合
払込日 2026-01-15 投資家が代金を払い、社債を受け取る日。
最初の利息はこの日から数える
記録日 2026-07-10と2027-01-10 この日に社債を持っていた人が、その回の利金を受け取る
利払い日 2026-07-15と2027-01-15 利金を払う日。
最後の利払い日を満期にする

日本の普通社債の利息は、年2回払いが多くなっています。
日割りの計算は、実際の日数を365で割る形が多く使われます。
このコースも年2回の利払いにし、1回目は181日分、2回目は184日分の利金を払います。

回 数える期間 1口の利金
1回目 2026-01-15から2026-07-15までの181日 100,000円 × 0.80% × 181 ÷ 365 = 396.7…円で、396円
2回目 2026-07-15から2027-01-15までの184日 100,000円 × 0.80% × 184 ÷ 365 = 403.2…円で、403円

1円未満は切り捨てます。
利金を計算するコードは、利払いの節で書きます。

記録日は、利金を受け取る人を決める日です。
利払い日の直前まで持ち主が変わり続けると、発行体は誰にいくら払うかを決められません。
このコースでは利払い日の5日前を記録日にし、その日に持っていた人へ払います。

社債の日程
0〜6か月0〜6か月1回目の利息の期間6〜12か月6〜12か月2回目の利息の期間0か月5か月10か月12か月払込日1回目の利払い日満期112233

チェーンの上では、社債の条件をコントラクトの中に書き込みます。
誰でも同じ条件を読めて、デプロイした後は発行体も書き換えられません。
1口を1トークンとして数え、小数の桁は持たせません。

社債を発行するのは、払い込みを受けた時だけにします。
発行体が自由に社債を作れると、代金を受け取っていない社債が出回ってしまいます。
そこで発行とburnを決済の役割に限り、その役割は次の節で作る決済のコントラクトだけに渡します。

実装

starter/contracts/contracts/BondToken.solを新しく作ります。
まず、ERC-20とAccessControlを継承し、社債の条件を持つ値を並べます。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;

import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import {AccessControl} from "@openzeppelin/contracts/access/AccessControl.sol";

import {JpyToken} from "@handsonchain/jpy-stablecoin-contracts/contracts/JpyToken.sol";

/// @title デジタル社債のトークン
/// @notice 1口を1トークンとし、額面と利率と利払いの日程を持つ。
/// 発行と償還のburnは決済のコントラクトだけが行う
contract BondToken is ERC20, AccessControl {
    /// @notice 社債を発行し、償還でburnできる役割。決済のコントラクトだけに渡す
    bytes32 public constant SETTLEMENT_ROLE = keccak256("SETTLEMENT_ROLE");

    /// @notice 本人確認と凍結の名簿を持つ1作目の円トークン
    JpyToken public immutable jpy;
    /// @notice 1口の額面 (円)
    uint256 public immutable faceValue;
    /// @notice 年の利率。1万分の1を単位にし、80は年0.80%
    uint256 public immutable rateBps;
    /// @notice 払込日。最初の利息はこの日から数える
    uint64 public immutable issueDate;
    /// @notice 満期。最後の利払い日と同じ日
    uint64 public immutable maturity;

    uint64[] private _paymentDates;
    uint64[] private _recordDates;

    /// @notice 利払い日と記録日の並びが、払込日の後に記録日、利払い日の順で進んでいない
    error BadSchedule();
行 意味
import {JpyToken} from "@handsonchain/..." 前のレッスンで確かめたremappingsで、1作目の円トークンを読み込む。
次のレッスンで名簿を読むのに使う
SETTLEMENT_ROLE 社債を発行し、償還でburnできる役割の名前
immutable constructorで1度だけ書き、後から変えられない値。
発行体も書き換えられない
faceValue 1口の額面。
円トークンの18桁の単位ではなく、円の整数 (100,000) で持つ
rateBps 1万分の1を単位にした年の利率。
小数を持たないSolidityで、年0.80%を80という整数で表す
uint64 日付は、1970-01-01から数えた秒数 (Unix時刻) で持つ
_paymentDatesと_recordDates 回ごとの利払い日と記録日。
配列はimmutableにできないためprivateの状態に置き、読む関数を別に足す

続けてconstructorを書きます。
利払いの日程が正しい順に並んでいない時は、デプロイそのものを拒みます。

    /// @param jpy_ 本人確認と凍結の名簿を読む円トークン
    /// @param admin 役割を渡せる発行体のアカウント
    /// @param paymentDates_ 利払い日の並び。最後の日を満期にする
    /// @param recordDates_ 記録日の並び。n回目の記録日はn回目の利払い日より前にする
    constructor(
        JpyToken jpy_,
        address admin,
        uint256 faceValue_,
        uint256 rateBps_,
        uint64 issueDate_,
        uint64[] memory paymentDates_,
        uint64[] memory recordDates_
    ) ERC20("HandsOn Bond", "HBOND") {
        if (paymentDates_.length == 0 || paymentDates_.length != recordDates_.length) revert BadSchedule();
        uint64 previous = issueDate_;
        for (uint256 n = 0; n < paymentDates_.length; n++) {
            if (recordDates_[n] <= previous || paymentDates_[n] < recordDates_[n]) revert BadSchedule();
            previous = paymentDates_[n];
        }
        jpy = jpy_;
        faceValue = faceValue_;
        rateBps = rateBps_;
        issueDate = issueDate_;
        maturity = paymentDates_[paymentDates_.length - 1];
        _paymentDates = paymentDates_;
        _recordDates = recordDates_;
        _grantRole(DEFAULT_ADMIN_ROLE, admin);
    }
行 意味
ERC20("HandsOn Bond", "HBOND") 社債トークンの名前と記号を決める
paymentDates_.length == 0 利払いが1回もない時に拒む。
利払い日と記録日の数が合わない時も拒む
recordDates_[n] <= previous 記録日が、前の利払い日より後でない時に拒む。
1回目は払込日と比べる
paymentDates_[n] < recordDates_[n] 利払い日が、その回の記録日より前の時に拒む
maturity = paymentDates_[...] 最後の利払い日を満期にする
_grantRole(DEFAULT_ADMIN_ROLE, admin) 発行体に、役割を渡す管理の役割だけを持たせる。
決済の役割は渡さない

最後に、桁と日程を読む関数と、発行とburnの関数を足します。

    /// @notice 1口を1トークンで数えるので、小数の桁を持たない
    function decimals() public pure override returns (uint8) {
        return 0;
    }

    /// @notice 利払いの回数
    function couponCount() external view returns (uint256) {
        return _paymentDates.length;
    }

    /// @notice n回目 (0から数える) の利払い日
    function paymentDate(uint256 n) external view returns (uint64) {
        return _paymentDates[n];
    }

    /// @notice n回目 (0から数える) の記録日
    function recordDate(uint256 n) external view returns (uint64) {
        return _recordDates[n];
    }

    /// @notice 払い込みが済んだ投資家へ社債を発行する
    function mint(address to, uint256 units) external onlyRole(SETTLEMENT_ROLE) {
        _mint(to, units);
    }

    /// @notice 償還した社債をburnする
    function burn(address from, uint256 units) external onlyRole(SETTLEMENT_ROLE) {
        _burn(from, units);
    }
}
行 意味
decimals()が0を返す ERC-20の多くは18桁を持つが、社債は1口より細かく分けないので桁を持たない
couponCount()とpaymentDate(n)とrecordDate(n) 利払いの回数と、回ごとの日付を読む。
画面と決済のコントラクトが使う
onlyRole(SETTLEMENT_ROLE) 決済の役割を持たないアカウントが呼ぶと、AccessControlがAccessControlUnauthorizedAccountのエラーで拒む
units 発行やburnをする口数。
桁を持たないので、10が10口になる

次にstarter/contracts/test/DigitalBond.t.solを新しく作り、テストの土台を書きます。
DigitalBondBaseは、この後のレッスンのテストも使う共通の準備です。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;

import {Test} from "forge-std/Test.sol";
import {IAccessControl} from "@openzeppelin/contracts/access/IAccessControl.sol";

import {JpyToken} from "@handsonchain/jpy-stablecoin-contracts/contracts/JpyToken.sol";
import {BondToken} from "../contracts/BondToken.sol";

// 社債の条件は全てのテストで同じにする。日付は日本時間の0時
contract DigitalBondBase is Test {
    uint256 internal constant YEN = 1e18;
    uint256 internal constant FACE = 100_000;
    uint256 internal constant RATE_BPS = 80;
    uint64 internal constant START = 1767193200; // 2026-01-01
    uint64 internal constant ISSUE_DATE = 1768402800; // 2026-01-15
    uint64 internal constant RECORD_1 = 1783609200; // 2026-07-10
    uint64 internal constant PAY_1 = 1784041200; // 2026-07-15
    uint64 internal constant RECORD_2 = 1799506800; // 2027-01-10
    uint64 internal constant MATURITY = 1799938800; // 2027-01-15

    JpyToken internal jpy;
    BondToken internal bond;

    address internal issuer = makeAddr("issuer");
    // テストの中だけで、決済のコントラクトの代わりに社債を発行するアカウント
    address internal minter = makeAddr("minter");
    address internal alice = makeAddr("alice");
    address internal bob = makeAddr("bob");
    address internal carol = makeAddr("carol");
    address internal stranger = makeAddr("stranger");

    function setUp() public virtual {
        vm.warp(START);
        uint64[] memory payments = new uint64[](2);
        payments[0] = PAY_1;
        payments[1] = MATURITY;
        uint64[] memory records = new uint64[](2);
        records[0] = RECORD_1;
        records[1] = RECORD_2;

        jpy = new JpyToken(issuer);
        bond = new BondToken(jpy, issuer, FACE, RATE_BPS, ISSUE_DATE, payments, records);

        vm.startPrank(issuer);
        bond.grantRole(bond.SETTLEMENT_ROLE(), minter);
        jpy.setAllowed(issuer, true);
        jpy.setAllowed(alice, true);
        jpy.setAllowed(bob, true);
        jpy.setAllowed(carol, true);
        jpy.issue(issuer, 1_000_000 * YEN, keccak256("issuer"));
        jpy.issue(alice, 2_000_000 * YEN, keccak256("alice"));
        jpy.issue(bob, 2_000_000 * YEN, keccak256("bob"));
        jpy.issue(carol, 2_000_000 * YEN, keccak256("carol"));
        vm.stopPrank();
    }

    function _mint(address to, uint256 units) internal {
        vm.prank(minter);
        bond.mint(to, units);
    }
}
コード 意味
STARTからMATURITY 日本時間の0時のUnix時刻。
背景の段の日程と同じ日付にする
vm.warp(START) テストのチェーンの時刻を2026-01-01にする。
払込日より前から始める
new JpyToken(issuer) 1作目の円トークンを、テストの中でデプロイする。
issuerが円トークンの全ての役割を持つ
bond.grantRole(bond.SETTLEMENT_ROLE(), minter) 決済のコントラクトはまだないため、テストのアカウントminterに決済の役割を渡す
jpy.setAllowed(...)とjpy.issue(...) 発行体と投資家を円トークンの名簿に載せ、円を発行する。
円は次の節の払い込みから使う
stranger 名簿に載せないアカウント。
次のレッスンで、本人確認の済んでいない人として使う
_mint(to, units) minterのアカウントで社債を発行する、テストの中だけの手助けの関数

同じファイルの続きに、テストの本体を書きます。

contract DigitalBondTest is DigitalBondBase {
    // 節1 社債トークンの型

    function test_TermsAndDecimals() public view {
        assertEq(bond.decimals(), 0);
        assertEq(bond.faceValue(), FACE);
        assertEq(bond.rateBps(), RATE_BPS);
        assertEq(bond.issueDate(), ISSUE_DATE);
        assertEq(bond.maturity(), MATURITY);
        assertEq(bond.couponCount(), 2);
        assertEq(bond.recordDate(0), RECORD_1);
        assertEq(bond.paymentDate(0), PAY_1);
    }

    function test_RevertWhen_MintWithoutRole() public {
        bytes32 role = bond.SETTLEMENT_ROLE();
        vm.prank(issuer);
        vm.expectRevert(abi.encodeWithSelector(IAccessControl.AccessControlUnauthorizedAccount.selector, issuer, role));
        bond.mint(alice, 1);
        assertEq(bond.totalSupply(), 0);
    }
}

test_TermsAndDecimalsは、constructorに渡した条件がそのまま読めることと、満期が最後の利払い日になったことを確かめます。
test_RevertWhen_MintWithoutRoleは、管理の役割を持つ発行体でも、決済の役割がなければ社債を発行できないことを確かめます。
拒まれた後にtotalSupplyが0のままであることも見ています。

確かめる

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

forge test --match-contract DigitalBondTest

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

[PASS] test_RevertWhen_MintWithoutRole()
[PASS] test_TermsAndDecimals()
Suite result: ok. 2 passed; 0 failed; 0 skipped

setUpのrecords[0] = RECORD_1;をrecords[0] = ISSUE_DATE;に変えて実行すると、[FAIL: BadSchedule()] setUp()の行が出ます。
1回目の記録日が払込日より後にないため、constructorが社債トークンのデプロイを拒んだことを示します。
試した後はRECORD_1に戻しておきます。