HandsOnChain

担保の処分の画面を作る

作るもの

このレッスンを終えると、貸し手のページに処分できる借り手ごとの「担保の処分」の枠が出ます。
枠には、買い手が払う額と、その額の利息と元本と借り手への返金への分かれ方が並びます。
借り手に残る借金も並びます。
「担保を買って処分する」を押すと、そのアカウントが担保の社債を全部買います。
借り手の表の状態の札には「処分できる」と「借金が残る」が加わり、借金だけが残った借り手のページには知らせが出ます。

背景

担保の処分は、買う人と貸し手と借り手の3者に関わります。
買う人は、いくら払うと何口の社債が手に入るかを知りたいはずです。
貸し手は、払われた円で利息と元本がいくら戻るかを知りたいはずです。
借り手は、余りが返ってくるのか、借金が残るのかを知りたいはずです。

そこで、押す前に払う額の分かれ方を枠に並べます。
画面はコントラクトのliquidateと同じ順で、払う額を利息と元本と借り手への返金に充てて数えます。
ただし、押した時に実際に充てる額を決めるのはコントラクトです。
画面を開いてから押すまでの間に日付をまたぐと、1日分の利息が増えて分かれ方も少し変わります。

画面の操作 ページ 呼ぶ関数 呼べる人
担保を買って処分する 貸し手 approveとliquidate 円トークンの許可リストに載った誰でも
1口の価格を入れる 貸し手 setPrice 評価会社だけ
返す 借り手 approveとrepay 借金が残る借り手

このコースの画面では、貸し手のページに処分の枠を置き、銀行のアカウントで買う流れを試します。
コントラクトは誰でも買えるので、右上で借り手Bを選んでも同じボタンで買えます。

画面の状態の札は、コントラクトのliquidatableと同じ順で決めます。
画面とコントラクトで順が違うと、「処分できる」と出ているのに押すと断られる、といった食い違いが起きます。

借り手の状態の札を決める
残らない残らない100%未満いいえ始まり終わり担保と借金を読む元本か利息が残る?担保が残る?担保維持率は100%未満?猶予を過ぎて110%未満?処分できる借りる前か借入なし借金が残る請求中か請求できるか正常112233445566残る残る残る残る残る残る100%以上100%以上100%以上はい

実装

まず、starter/app/src/components/use-loan.tsで、処分の割引の率をローンのコントラクトから読みます。
useNamedReadsに渡す読み取りのborrowersの下に、1行を足します。

      borrowers: { ...loan, functionName: "borrowers" },
      discountBps: { ...loan, functionName: "DISCOUNT_BPS" },
      units: { ...bond, functionName: "balanceOf", args: [me] },

返す値のcashの下にも、1行を足します。

    cash: base.cash as bigint | undefined,
    discountBps: (base.discountBps as bigint | undefined) ?? 500n,
    units: base.units as bigint | undefined,
コード 意味
functionName: "DISCOUNT_BPS" コントラクトの割引の定数を読む。
画面に5%を書き写さない
?? 500n 読めるまでの間は、コントラクトと同じ5%として数える

次に、starter/app/src/components/loan-status.tsの状態の札に、処分の2つの札を足します。
札と一緒に、今処分できるかも返すようにします。
前のレッスンで置いた「猶予を過ぎた」の札の行は消し、「処分できる」の判定に替えます。
猶予を過ぎても、担保維持率が110%に戻っていれば処分できないためです。
ファイルの2つのコメントも、処分の境目とコントラクトのliquidatableを指す文に書き換えます。
2つのimportの行の後は、次のようになります。

// 担保維持率の境目 (1万分率)。コントラクトの CALL_BPS と LIQUIDATE_BPS と同じ値
const CALL_BPS = 11_000n;
const LIQUIDATE_BPS = 10_000n;

export type LoanStatus = {
  label: string;
  tone: Tone;
  // 今、誰でも担保を買って処分できるか
  liquidatable: boolean;
};

// 借り手の担保と借入から、画面に出す状態を決める。コントラクトの liquidatable と同じ順で調べる
export function statusOf(position: LoanPosition, now: bigint): LoanStatus {
  const ratio = position.ratioBps;
  if (position.debt === 0n) return { label: position.units > 0n ? "借りる前" : "借入なし", tone: "plain", liquidatable: false };
  // 処分の後に足りない分が残った借り手は、担保がないので借金だけが残る
  if (position.units === 0n) return { label: "借金が残る", tone: "bad", liquidatable: false };
  if (ratio !== undefined && ratio < LIQUIDATE_BPS) return { label: "処分できる", tone: "bad", liquidatable: true };
  const pastGrace = position.calledAt > 0n && now > position.graceEnd;
  if (pastGrace && ratio !== undefined && ratio < CALL_BPS) return { label: "処分できる", tone: "bad", liquidatable: true };
  if (position.calledAt > 0n) return { label: "追加担保の請求中", tone: "warn", liquidatable: false };
  if (ratio !== undefined && ratio < CALL_BPS) return { label: "請求できる", tone: "warn", liquidatable: false };
  return { label: "正常", tone: "good", liquidatable: false };
}
コード 意味
liquidatable 札と一緒に返す、今処分できるかの印。
貸し手のページが処分の枠を出すかを決めるのに使う
position.units === 0n 担保がないのに元本か利息が残る借り手は、処分の後に借金だけが残った借り手
ratio < LIQUIDATE_BPS 担保維持率が100%を下回ると、請求がなくても「処分できる」
now > position.graceEnd 猶予の終わりちょうどはまだ処分できない。
コントラクトのblock.timestamp > p.calledAt + GRACEと同じ
pastGrace && ... ratio < CALL_BPS 猶予を過ぎても110%に戻らない時は「処分できる」。
戻っていれば、請求の解消を待つ「追加担保の請求中」のまま

処分の札は、請求中かどうかを調べる前に調べます。
請求中の借り手が猶予を過ぎた時に、「追加担保の請求中」ではなく「処分できる」と出すためです。

starter/app/src/lib/format.tsのreasonsの末尾に、処分を断られた時の理由の文を足します。

  StillBelowCallLevel: "担保維持率が110%に戻っていないので、まだ解消できません",
  NotLiquidatable: "猶予の終わりの前で、担保維持率も100%以上なので、まだ処分できません",
};

続けて、貸し手のページのstarter/app/src/components/lender-view.tsxを書き換えます。
statusesの下に、処分できる借り手ごとの内訳を数える行を足します。

  const statuses = loanState.positions.map((position) => ({ position, status: statusOf(position, now) }));
  // 処分できる借り手ごとに、買い手が払う額と、その額を利息と元本と借り手への返金に分けた内訳を出す。コントラクトの liquidate と同じ順で充てる
  const breakdowns = statuses
    .filter(({ status }) => status.liquidatable)
    .map(({ position }) => {
      const paid = (position.units * (loanState.price ?? 0n) * (10_000n - loanState.discountBps)) / 10_000n;
      const toInterest = paid < position.interest ? paid : position.interest;
      const toPrincipal = paid - toInterest < position.principal ? paid - toInterest : position.principal;
      return { position, paid, toInterest, toPrincipal, refund: paid - toInterest - toPrincipal, left: position.debt - toInterest - toPrincipal };
    });
コード 意味
.filter(({ status }) => status.liquidatable) 状態の札が「処分できる」の借り手だけを残す
paid 預けた口数 × 最新の価格 × 95% を1円未満で切り捨てる。
コントラクトのliquidationPriceと同じ式
toInterest 払う額のうち、先に利息に充てる額
toPrincipal 利息に充てた残りのうち、元本に充てる額。
元本より多ければ元本の分だけ
refund 利息と元本に充てた後の余り。
借り手へ返す
left 元本と利息の合計から充てた額を引いた、借り手に残る借金

refundとleftは、どちらか一方が0になります。
払う額が借金より多ければ余りを返し、少なければ足りない分が残ります。

借り手の枠の後に、処分の枠を置きます。

      </Card>

      {breakdowns.length > 0 ? (
        <div className="grid-2">
          {breakdowns.map((item) => (
            <Card
              key={item.position.address}
              title={`${labelOf(item.position.address) ?? "借り手"}の担保の処分`}
              description={`担保の社債${formatUnitsCount(item.position.units)}を、最新の価格から${formatPercent(loanState.discountBps, 0)}割り引いて買います。払った円は利息、元本の順に充て、余りを借り手へ返します。`}
            >
              <dl className="facts">
                <div>
                  <dt>買い手が払う額</dt>
                  <dd>{formatWholeYen(item.paid)}</dd>
                </div>
                <div>
                  <dt>利息に充てる</dt>
                  <dd>{formatWholeYen(item.toInterest)}</dd>
                </div>
                <div>
                  <dt>元本に充てる</dt>
                  <dd>{formatWholeYen(item.toPrincipal)}</dd>
                </div>
                <div>
                  <dt>借り手へ返す</dt>
                  <dd>{formatWholeYen(item.refund)}</dd>
                </div>
                <div>
                  <dt>借り手に残る借金</dt>
                  <dd className={item.left > 0n ? "bad" : undefined}>{formatWholeYen(item.left)}</dd>
                </div>
              </dl>
              <button
                type="button"
                className="button button-danger"
                disabled={pending !== undefined}
                onClick={() =>
                  send(`liquidate-${item.position.address}`, `担保の社債を${formatWholeYen(item.paid)}で買いました`, [
                    { ...jpy, functionName: "approve", args: [contracts.loan, item.paid * YEN] },
                    { ...loan, functionName: "liquidate", args: [item.position.address] },
                  ])
                }
              >
                {pending === `liquidate-${item.position.address}` ? "処分しています" : "担保を買って処分する"}
              </button>
            </Card>
          ))}
        </div>
      ) : null}

      <NoticeLine notice={notice} />
コード 意味
breakdowns.length > 0 ? ... : null 処分できる借り手がいない時は、枠を1つも出さない
title={...} 「借り手Aの担保の処分」のように、誰の担保かを題に出す
formatPercent(loanState.discountBps, 0) 割引の率を、小数を付けずに5%と出す
className={item.left > 0n ? "bad" : undefined} 借金が残る時は、残る額を赤で出す
item.paid * YEN 払う額を円トークンの18桁の単位に直し、ローンのコントラクトに任せる
button-danger 処分は取り消せないので、赤いボタンにする

「担保を買って処分する」を押したアカウントが、円を払って社債を受け取ります。
処分の取引の中でローンのコントラクトがtransferFromで円を受け取るので、先にapproveで払う額を任せます。

最後に、借り手のページのstarter/app/src/components/borrower-view.tsxを書き換えます。
追加担保の知らせの後に、借金が残った時の知らせを置きます。

        </div>
      ) : null}
      {position.borrowed && position.units === 0n && position.debt > 0n ? (
        <p className="banner-bad">担保の社債が処分され、{formatWholeYen(position.debt)}の借金が残っています。返す欄から返してください。</p>
      ) : null}
      <div className="hero">
コード 意味
position.borrowed 借りたことのある借り手だけに出す
position.units === 0n && position.debt > 0n 担保がないのに元本か利息が残る時に出す。
全て返した借り手と、処分の余りを受け取った借り手には出さない

借金が残った借り手は、「返す」の欄から円で返せます。
担保はもうないので、全て返しても戻る社債はありません。

確かめる

starter/appのディレクトリで動いているpnpm devを止め、もう一度実行します。
anvilが空の状態から立ち上がり、デプロイの後にチェーンの日付は2026-01-15になります。
ブラウザでポート3403の画面を開きます。

まず、猶予を過ぎた担保を処分して、余りが借り手へ戻る流れを試します。
貸し手のページで右上のアカウントを「銀行」に切り替え、「円を入れる」の枠に1000000を入れて「入れる」を押します。
借り手のページへ移って「借り手A」に切り替え、10口を預けてから790000円を借ります。

貸し手のページへ戻り、右上で「評価会社」を選びます。
「担保の価格」の枠の1口の価格に85000を入れて「入れる」を押すと、担保維持率が107.5%に下がります。
借り手の表の「請求する」を押して請求を記録し、帯の「猶予の終わりへ進める」を押します。
チェーンの日付が2026-01-18へ進み、帯には「3日を過ぎた価格」の札が出ます。

この時点でも「借り手Aの担保の処分」の枠は出ます。
ただし、銀行のアカウントで押すと「最後の価格から3日を過ぎています」で始まる理由で断られます。
評価会社のまま、もう一度1口の価格に85000を入れて「入れる」を押し、価格を入れ直します。
枠には、買い手が払う額807,500円のうち利息に129円と元本に790,000円を充て、借り手へ17,371円を返すと出ます。

猶予を過ぎた借り手Aの担保の処分の内訳。払う額807,500円から利息と元本を充て、17,371円を借り手へ返す
猶予を過ぎた借り手Aの担保の処分の内訳。払う額807,500円から利息と元本を充て、17,371円を借り手へ返す

右上で「銀行」に切り替えて「担保を買って処分する」を押すと、「担保の社債を807,500円で買いました」と出ます。
枠は消え、借り手の表の借り手Aは「借入なし」になります。
右上で「借り手A」を選ぶと、「円を入れる」の枠の「このアカウントの円」は2,807,371円です。
借りる前の2,000,000円に、借りた790,000円と処分の余りの17,371円が足されています。

次に、担保を売っても借金に届かない流れを試します。
pnpm devを止めて実行し直し、同じ手順で銀行が円を入れ、借り手Aが10口を預けて790000円を借ります。
貸し手のページで「評価会社」を選び、1口の価格に70000を入れて「入れる」を押します。
担保維持率が88.6%になり、請求を待たずに「借り手Aの担保の処分」の枠が出ます。

右上で「銀行」に切り替えて「担保を買って処分する」を押すと、「担保の社債を665,000円で買いました」と出ます。
665,000円は全て元本に充たり、790,000円の元本のうち125,000円が残ります。
借り手のページで「借り手A」を選ぶと、ページの上に借金が残った知らせが出て、状態の札は「借金が残る」になります。

1口70,000円に下がった担保を銀行が665,000円で買い、借り手Aに125,000円の借金が残ったところ
1口70,000円に下がった担保を銀行が665,000円で買い、借り手Aに125,000円の借金が残ったところ

借り手Aが「返す」の欄から125000円を返すと、知らせが消えて状態の札は「借入なし」になります。
次のレッスンで、担保の社債に払われる利金を借り手へ渡す仕組みを作ります。