社債の条件を持つトークンを作る
作るもの
このレッスンを終えると、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日前を記録日にし、その日に持っていた人へ払います。
チェーンの上では、社債の条件をコントラクトの中に書き込みます。
誰でも同じ条件を読めて、デプロイした後は発行体も書き換えられません。
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に戻しておきます。