HandsOnChain

償還と不履行の画面を作る

作るもの

このレッスンを終えると、発行体がブラウザから償還の額を入れ、投資家が満期の後に「償還を受ける」で額面を受け取れます。
満期を過ぎても償還の額が入っていない時は、投資家が「不履行にする」を押して社債を不履行にできます。
不履行になると投資家のページの上に不履行の帯が出て、売買の欄は押せなくなります。

背景

満期の前後は、発行体と投資家が同じ状態を見ている必要があります。
発行体は返す額と入れた額を見て、足りない分を入れます。
投資家は受け取れる額を見て、受け取れない時はその理由を見ます。

画面の操作 ページ 呼ぶ関数 呼べる人
償還の額を入れる 発行体 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されたので「償還済み」になります。

満期に投資家Aが30口の償還を受けたところ
満期に投資家Aが30口の償還を受けたところ

次に、不履行にする流れを試します。
pnpm devを止めて実行し直し、同じ手順で投資家Aの30口の申込と募集の締めまで進めます。
今度は償還の額を入れずに投資家のページへ戻り、「投資家A」に切り替えて「満期へ進める」を押します。
満期を過ぎても額が入っていないので、「償還を受ける」の枠に「不履行にする」のボタンが出ます。

「不履行にする」を押すと「社債を不履行にしました」と出て、ページの上に不履行の帯が出ます。
社債の状態は「不履行」に変わり、売買の欄は押せなくなります。
「不履行にする」のボタンは消え、代わりに「発行体の入金を待っています」の札が出ます。

償還の額が入らないまま満期を過ぎ、投資家Aが不履行にしたところ
償還の額が入らないまま満期を過ぎ、投資家Aが不履行にしたところ

この後に発行体のページで「償還の額を入れる」を押すと、遅れた入金になります。
投資家のページへ戻ると札が消えて「償還を受ける」が押せるようになり、不履行の帯を残したまま額面を受け取れます。

次のレッスンで、今日から数えた日程の社債をFujiへデプロイします。