償還と不履行の画面を作る
作るもの
このレッスンを終えると、発行体がブラウザから償還の額を入れ、投資家が満期の後に「償還を受ける」で額面を受け取れます。
満期を過ぎても償還の額が入っていない時は、投資家が「不履行にする」を押して社債を不履行にできます。
不履行になると投資家のページの上に不履行の帯が出て、売買の欄は押せなくなります。
背景
満期の前後は、発行体と投資家が同じ状態を見ている必要があります。
発行体は返す額と入れた額を見て、足りない分を入れます。
投資家は受け取れる額を見て、受け取れない時はその理由を見ます。
| 画面の操作 | ページ | 呼ぶ関数 | 呼べる人 |
|---|---|---|---|
| 償還の額を入れる | 発行体 | approveとfundRedemption |
発行体だけ |
| 償還を受ける | 投資家 | redeem |
社債を持つ投資家 |
| 不履行にする | 投資家 | declareDefault |
誰でも |
画面はボタンを押せる時だけ押せるようにしますが、押してよいかを最後に決めるのはコントラクトです。
不履行の帯も画面が自分で決めるのではなく、社債トークンのdefaultedを読んで出します。
同じチェーンを読む画面なら、発行体が開いても投資家が開いても同じ状態が出ます。
実装
まず、starter/app/src/components/use-bond.tsで、不履行の印と償還の総額と入金済みの額を読みます。
useNamedReadsに渡す読み取りの末尾に、3つを足します。
accruedPerUnit: { ...settlement, functionName: "accruedPerUnit" },
defaulted: { ...bond, functionName: "defaulted" },
redemptionDue: { ...settlement, functionName: "redemptionDue" },
redemptionFunded: { ...settlement, functionName: "redemptionFunded" },
返す値の末尾にも、同じ3つを足します。
accruedPerUnit: base.accruedPerUnit as bigint | undefined,
defaulted: base.defaulted as boolean | undefined,
redemptionDue: base.redemptionDue as bigint | undefined,
redemptionFunded: base.redemptionFunded as bigint | undefined,
};
}
starter/app/src/components/bond-status.tsでは、社債の状態の札に「不履行」と「償還済み」を足します。
export function statusOf(bond: BondState): { label: string; tone: Tone } {
if (bond.defaulted) return { label: "不履行", tone: "bad" };
if (bond.issued && bond.totalSupply === 0n) return { label: "償還済み", tone: "plain" };
if (!bond.closed) return { label: "募集中", tone: "info" };
| コード | 意味 |
|---|---|
bond.defaulted |
不履行はほかのどの状態よりも先に出す。 遅れて償還された後も「不履行」のままにする |
bond.totalSupply === 0n |
発行した社債が全て償還されてburnされると、総数が0になる |
starter/app/src/lib/format.tsのreasonsの末尾に、コントラクトが償還と不履行を拒んだ時の理由の文を足します。
OrderClosed: "この注文はもう約定しました",
BeforeMaturity: "満期の後に押せます",
RedemptionUnfunded: "発行体の償還の入金が足りません",
NothingToRedeem: "償還する社債を持っていません",
BondDefaulted: "社債が不履行になったので、売買を止めています",
RedemptionFullyFunded: "償還の額は入っているので、不履行にはできません",
};
続けて、発行体のページのstarter/app/src/components/issuer-view.tsxを書き換えます。
filledの下に、返す額のうちまだ入っていない額を足します。
const redemptionGap = (bond.redemptionDue ?? 0n) - (bond.redemptionFunded ?? 0n);
募集の枠の後に、満期の償還の枠を置きます。
どちらもgrid-2の中に置くので、2つの枠が半分ずつの幅で並びます。
</Card>
<Card title="満期の償還" description={`満期の${formatDate(bond.maturity)}までに、額面の合計を決済のコントラクトへ入れます。`}>
<dl className="facts">
<div>
<dt>払う額</dt>
<dd>{formatYen(bond.redemptionDue)}</dd>
</div>
<div>
<dt>入金済み</dt>
<dd>{formatYen(bond.redemptionFunded)}</dd>
</div>
</dl>
<button
type="button"
className="button"
disabled={!bond.issued || redemptionGap <= 0n || pending !== undefined}
onClick={() =>
send("redemption", `償還の額${formatYen(redemptionGap)}を入れました`, [
{ ...jpy, functionName: "approve", args: [contracts.settlement, redemptionGap] },
{ ...settlement, functionName: "fundRedemption", args: [redemptionGap] },
])
}
>
{pending === "redemption" ? "入れています" : "償還の額を入れる"}
</button>
</Card>
</div>
| コード | 意味 |
|---|---|
redemptionGap |
払う額から入金済みの額を引いた、まだ入っていない額 |
redemptionGap <= 0n |
全て入った後は押せない。 社債を発行する前も押せない |
approveとfundRedemption |
足りない分を円トークンで決済のコントラクトに任せてから入れる。 2つの取引を順に送る |
満期の後に不履行になった社債でも、このボタンは足りない分がある間は押せます。
不履行の後に入れた額は、遅れた入金になります。
最後に、投資家のページのstarter/app/src/components/investor-view.tsxを書き換えます。
売買の枠を作った時にfalseのままにしていたstoppedを、社債トークンの不履行の印に変えます。
満期を過ぎたかと、償還の額が全て入ったかも、ここで決めます。
const stopped = bond.defaulted === true;
const matured = bond.maturity !== undefined && now >= bond.maturity;
const redemptionReady = (bond.redemptionFunded ?? 0n) >= (bond.redemptionDue ?? 0n) && (bond.redemptionDue ?? 0n) > 0n;
stoppedがtrueになると、売買の枠の入れる欄と「売りに出す」と「買う」のボタンが押せなくなります。
経過利息と払う総額の列も-になります。
ページの一番上に、不履行の帯を置きます。
帯の色は、雛形のglobals.cssのbanner-badが最初から持っています。
<div className="stack">
{bond.defaulted ? <p className="banner-bad">満期の支払いが足りず、この社債は不履行になりました。売買を止めています。</p> : null}
<div className="hero">
申し込むの枠の後に、償還を受けるの枠を置きます。
</Card>
<Card title="償還を受ける" description={`満期の後、発行体が償還の額を入れると受け取れます。1口${formatWholeYen(bond.faceValue)}を受け取り、社債はburnされます。`}>
<dl className="facts">
<div>
<dt>受け取る額</dt>
<dd>{formatWholeYen((bond.units ?? 0n) * (bond.faceValue ?? 0n))}</dd>
</div>
</dl>
<div className="button-row">
<button
type="button"
className="button button-primary"
disabled={!matured || !redemptionReady || (bond.units ?? 0n) === 0n || pending !== undefined}
onClick={() => send("redeem", "償還を受けました", [{ ...settlement, functionName: "redeem", args: [] }])}
>
{pending === "redeem" ? "受け取っています" : "償還を受ける"}
</button>
{!matured ? (
<span className="muted">満期の{formatDate(bond.maturity)}の後に押せます</span>
) : bond.defaulted && !redemptionReady ? (
<Badge tone="warn">発行体の入金を待っています</Badge>
) : !bond.defaulted && !redemptionReady && bond.issued ? (
<button
type="button"
className="button button-danger"
disabled={pending !== undefined}
onClick={() => send("default", "社債を不履行にしました", [{ ...settlement, functionName: "declareDefault", args: [] }])}
>
不履行にする
</button>
) : null}
</div>
</Card>
</div>
| コード | 意味 |
|---|---|
(bond.units ?? 0n) * (bond.faceValue ?? 0n) |
受け取る額。 持っている口数に額面を掛ける |
!redemptionReady |
償還の額が全て入る前は押せない。 満期の前と、社債を持たない時も押せない |
!matured ? ... |
満期の前は、押せるようになる日付を出す |
bond.defaulted && !redemptionReady ? ... |
不履行の後で額が足りない間は、発行体の入金を待っていると出す。 遅れて全て入ると札は消える |
!bond.defaulted && !redemptionReady && bond.issued ? ... |
まだ不履行でなく、満期を過ぎても額が足りない時だけ「不履行にする」のボタンを出す |
button-danger |
不履行の印は戻せないので、赤いボタンにする |
「不履行にする」は、社債を持っているかどうかに関わらず、どの投資家のアカウントにも出ます。
コントラクトのdeclareDefaultを誰でも呼べることに合わせています。
確かめる
starter/appのディレクトリで動いているpnpm devを止め、もう一度実行します。
anvilが空の状態から立ち上がり、チェーンの日付は2026-01-01に戻ります。
ブラウザでポート3402の画面を開きます。
まず、償還する流れを試します。
投資家のページで右上のアカウントを「投資家A」に切り替え、「申し込む」の枠の口数に30を入れて「申し込む」を押します。
「30口を申し込みました」と出たら、ヘッダーの「発行体」のページへ移り、右上のアカウントを「発行体」に戻します。
「募集」の枠の「締め切りの後へ進める」を押し、続けて「募集を締める」を押すと、30口が投資家Aへ発行されます。
「満期の償還」の枠の「償還の額を入れる」を押すと、「償還の額3,000,000円を入れました」と出ます。
投資家のページへ戻って「投資家A」に切り替え、時刻の帯の「満期へ進める」を押します。
「償還を受ける」が押せるようになるので押すと、「償還を受けました」と出ます。
持っている社債は0口になり、円トークンは申し込む前の3,000,000円に戻ります。
社債の状態は、全ての社債がburnされたので「償還済み」になります。

次に、不履行にする流れを試します。
pnpm devを止めて実行し直し、同じ手順で投資家Aの30口の申込と募集の締めまで進めます。
今度は償還の額を入れずに投資家のページへ戻り、「投資家A」に切り替えて「満期へ進める」を押します。
満期を過ぎても額が入っていないので、「償還を受ける」の枠に「不履行にする」のボタンが出ます。
「不履行にする」を押すと「社債を不履行にしました」と出て、ページの上に不履行の帯が出ます。
社債の状態は「不履行」に変わり、売買の欄は押せなくなります。
「不履行にする」のボタンは消え、代わりに「発行体の入金を待っています」の札が出ます。

この後に発行体のページで「償還の額を入れる」を押すと、遅れた入金になります。
投資家のページへ戻ると札が消えて「償還を受ける」が押せるようになり、不履行の帯を残したまま額面を受け取れます。
次のレッスンで、今日から数えた日程の社債をFujiへデプロイします。