HandsOnChain

売買の画面を作る

作るもの

このレッスンを終えると、投資家のページに売買の枠ができ、持っている社債の口数と1口の値段を入れて売りに出せます。
別の投資家に切り替えると、売りの注文の一覧に経過利息と払う総額が出て、「買う」のボタンで買えます。
買うと社債と円が1つの取引で入れ替わり、両方の投資家の口数と円の残高が変わります。

背景

社債の売買では、値段とは別に経過利息を払います。
買う人が払う額は値段と経過利息と口数で決まり、経過利息は売買する日によって変わります。
画面では値段と経過利息と払う総額を別の列に分けて出し、買う人が押す前に何にいくら払うのかを確かめられるようにします。

画面に出す1口の経過利息は、前のレッスンで足したaccruedPerUnitをコントラクトから読んだ値です。
画面の側で同じ式を書き直さないため、画面に出る総額とbuyが計算する総額が食い違いません。
経過利息の列の下に添える日数だけは、画面が利払い日の日程から数えます。
記録日を過ぎてから利払い日までの間は経過利息が負になり、列には引く額と利払い日までの日数が出ます。

「買う」を押すと、画面は2つの取引を順に送ります。
1つ目は総額の円を決済のコントラクトに任せるapproveで、2つ目がbuyです。
円と社債が入れ替わるのは2つ目のbuyの取引の中で、ここがDvPの決済になります。

買うを押した時に送る2つの取引
投資家B買う人画面売買の枠円トークンJpyToken決済のコントラクトBondSettlement112233accruedPerUnit()accruedPerUnit()1口の経過利息1口の経過利息買うを押す買うを押すapprove(決済のコントラクト, 総額)approve(決済のコントラクト, 総額)buy(注文の番号)口数 × (値段 + 経過利息)口数 × (値段 + 経過利息)円と社債を入れ替える

実装

まず、前のレッスンでコントラクトに足した2つのエラーの文を、starter/app/src/lib/format.tsのreasonsの最後に足します。

  NothingToClaim: "記録日に社債を持っていなかったので、この回の利金はありません",
  NotEnoughBond: "売りに出す口数を持っていません",
  OrderClosed: "この注文はもう約定しました",
};

OrderClosedの文の約定は、売りと買いが合って取引が成り立つことです。
同じ注文を別の投資家が先に買った時に、この文が出ます。

次に、starter/app/src/components/use-bond.tsで注文と経過利息を読みます。
Couponの型の後に、注文の型を足します。

export type Order = { id: number; seller: `0x${string}`; units: bigint; price: bigint; open: boolean };

baseの読み取りの最後に、注文の数と1口の経過利息を足します。

      orderCount: { ...settlement, functionName: "orderCount" },
      accruedPerUnit: { ...settlement, functionName: "accruedPerUnit" },

利金のcouponsを作った後に、注文を1つずつ読む所を足します。

  const orderCount = Number((base.orderCount as bigint | undefined) ?? 0n);
  const orderReads = useNamedReads(
    Object.fromEntries(Array.from({ length: orderCount }, (_, id) => [`order:${id}`, { ...settlement, functionName: "orderAt", args: [BigInt(id)] }])),
    orderCount > 0,
  );
  const orders: Order[] = Array.from({ length: orderCount }, (_, id) => {
    const order = orderReads[`order:${id}`] as Omit<Order, "id"> | undefined;
    return order ? { id, ...order } : undefined;
  }).filter((order): order is Order => order !== undefined);

返す値の最後に、注文の一覧と1口の経過利息を足します。

    orders,
    accruedPerUnit: base.accruedPerUnit as bigint | undefined,
コード 意味
export type Order 注文の番号と売り手と口数と値段に、まだ買われていないかを加えた型
orderCount 決済のコントラクトのorderCountで、出した注文の数を読む
accruedPerUnit 今日までの1口の経過利息を読む。
4秒ごとに読み直すので、チェーンの時刻を進めると変わる
orderReads 注文の数だけorderAtを呼ぶ。
注文がまだない時は読まない
Omit<Order, "id"> orderAtは構造体を返すので、viemはsellerとunitsとpriceとopenを持つオブジェクトにする
{ id, ...order } 読んだ注文の中身に、配列の位置の番号を足す

続けて、starter/app/src/components/investor-view.tsxに売買の枠を足します。
先頭のimportに、社債トークンのABIとアカウントの名前を引くlabelOfを足します。

import { bondSettlementAbi, jpyTokenAbi } from "@contracts/generated/abi";
import { bondTokenAbi } from "@contracts/generated/abi";
import { useState } from "react";
import type { Abi } from "viem";

import { labelOf } from "@/lib/chains";
import { formatDate, formatUnitsCount, formatWholeYen, formatYen, parseCount, shortAddress, YEN } from "@/lib/format";

const open = ...の行とconst stopped = false;の行の間に、売る口数と値段の入力と、経過利息の日数を数える所を足します。

  const bondToken = { abi: bondTokenAbi as Abi, address: contracts.bond };
  const [sellUnits, setSellUnits] = useState("");
  const [sellPrice, setSellPrice] = useState("");
  const sellCount = parseCount(sellUnits);
  const sellValue = parseCount(sellPrice);
  const accrued = bond.accruedPerUnit ?? 0n;
  // 経過利息を数え始める日。前の利払い日で、まだ1回も払っていない時は払込日
  const paidBefore = [...bond.coupons].reverse().find((coupon) => coupon.paymentDate !== undefined && coupon.paymentDate <= now);
  const accrualStart = paidBefore?.paymentDate ?? bond.issueDate;
  const accrualDays = accrualStart !== undefined && now > accrualStart ? (now - accrualStart) / 86_400n : 0n;
  // 記録日を過ぎると次の利金は売る人が受け取るため、コントラクトは利払い日までの日数の分を負の経過利息で返す
  const nextPayment = bond.coupons.find((coupon) => coupon.paymentDate !== undefined && coupon.paymentDate > now)?.paymentDate;
  const daysLeft = nextPayment !== undefined ? (nextPayment - now) / 86_400n : 0n;
コード 意味
bondToken 社債トークンのアドレスとABI。
売りに出す前のapproveに使う
parseCount(sellUnits) 入れた口数を正の整数にする。
0以下か小数の時はundefinedになり、ボタンを押せない
parseCount(sellPrice) 1口の値段も1円単位の正の整数として読む
accrued コントラクトから読んだ1口の経過利息。
読めるまでは0円として扱う
paidBefore 今の時刻までに来た利払い日のうち最後の回。
まだ1回も来ていない時はundefinedになる
accrualStart 経過利息を数え始める日。
paidBeforeがない時は払込日にする
accrualDays 数え始めた日から今日までの日数。
1日に満たない分は切り捨てる
nextPayment 今の時刻より後に来る最初の利払い日
daysLeft 今日から次の利払い日までの日数。
経過利息が負の時に、引いた日数として添える

stoppedは売買を止めるかどうかで、今はfalseのままです。
節5の画面のレッスンで、不履行を記録した後に止める形へ変えます。

最後に、利金の枠の後に売買の枠を足します。
上が売りに出す欄で、下がまだ買われていない注文の一覧です。

      <Card title="売買" description="値段は経過利息を含めずに入れます。買う人は、値段に前の利払い日からの経過利息を足した額を払います。記録日から利払い日までは、利金を売る人が受け取るので、利払い日までの日数の分を値段から引きます。">
        <form
          className="form form-row"
          onSubmit={async (event) => {
            event.preventDefault();
            if (sellCount === undefined || sellValue === undefined) return;
            const ok = await send("list", `${formatUnitsCount(sellCount)}を1口${formatWholeYen(sellValue)}で売りに出しました`, [
              { ...bondToken, functionName: "approve", args: [contracts.settlement, sellCount] },
              { ...settlement, functionName: "list", args: [sellCount, sellValue] },
            ]);
            if (ok) {
              setSellUnits("");
              setSellPrice("");
            }
          }}
        >
          <Field label="売る口数" unit="口">
            <input inputMode="numeric" value={sellUnits} onChange={(event) => setSellUnits(event.target.value)} placeholder="2" disabled={stopped} />
          </Field>
          <Field label="1口の値段 (経過利息を含めない)" unit="円">
            <input inputMode="numeric" value={sellPrice} onChange={(event) => setSellPrice(event.target.value)} placeholder="99800" disabled={stopped} />
          </Field>
          <button className="button button-primary" type="submit" disabled={stopped || sellCount === undefined || sellValue === undefined || pending !== undefined}>
            {pending === "list" ? "出しています" : "売りに出す"}
          </button>
        </form>
        <h3 className="card-sub">売りの注文</h3>
        <div className="table-wrap">
          <table className="table">
            <thead>
              <tr>
                <th>売り手</th>
                <th className="num">口数</th>
                <th className="num">1口の値段</th>
                <th className="num">経過利息</th>
                <th className="num">払う総額</th>
                <th aria-label="操作" />
              </tr>
            </thead>
            <tbody>
              {bond.orders.filter((order) => order.open).length === 0 ? (
                <tr>
                  <td colSpan={6} className="muted">
                    まだ売りの注文はありません
                  </td>
                </tr>
              ) : null}
              {bond.orders
                .filter((order) => order.open)
                .map((order) => {
                  const total = order.units * (order.price + accrued) * YEN;
                  const mine = order.seller.toLowerCase() === me.toLowerCase();
                  return (
                    <tr key={order.id}>
                      <td>
                        <span className="cell-title">{labelOf(order.seller) ?? "アカウント"}</span>
                        <span className="cell-sub">{shortAddress(order.seller)}</span>
                      </td>
                      <td className="num">{formatUnitsCount(order.units)}</td>
                      <td className="num">{formatWholeYen(order.price)}</td>
                      <td className="num">
                        {stopped ? (
                          "-"
                        ) : (
                          <>
                            <span className="cell-title">
                              {formatWholeYen(accrued)} × {formatUnitsCount(order.units)}
                            </span>
                            <span className="cell-sub">
                              {accrued < 0n ? `利払い日まで${daysLeft}日を引く` : `${paidBefore ? "前の利払い日" : "払込日"}から${accrualDays}日`}
                            </span>
                          </>
                        )}
                      </td>
                      <td className="num">{stopped ? "-" : formatYen(total)}</td>
                      <td className="num">
                        <button
                          type="button"
                          className="button button-small"
                          disabled={stopped || mine || pending !== undefined}
                          onClick={() =>
                            send(`buy-${order.id}`, `${formatUnitsCount(order.units)}を${formatYen(total)}で買いました`, [
                              { ...jpy, functionName: "approve", args: [contracts.settlement, total] },
                              { ...settlement, functionName: "buy", args: [BigInt(order.id)] },
                            ])
                          }
                        >
                          {pending === `buy-${order.id}` ? "買っています" : "買う"}
                        </button>
                      </td>
                    </tr>
                  );
                })}
            </tbody>
          </table>
        </div>
        <p className="card-foot">{lines("払う総額は、値段に経過利息を足した額です。経過利息は日割りで、1口ごとに1円未満を切り捨てます。")}</p>
      </Card>
コード 意味
{ ...bondToken, functionName: "approve", args: [contracts.settlement, sellCount] } 売る口数を決済のコントラクトに任せる。
sendはこの取引がブロックに入った後に次のlistを送る
{ ...settlement, functionName: "list", args: [sellCount, sellValue] } 口数と1口の値段で売りの注文を出す
bond.orders.filter((order) => order.open) まだ買われていない注文だけを並べる
order.units * (order.price + accrued) * YEN 払う総額。
コントラクトのbuyと同じ式で、買う時にapproveする額にも使う
mine 自分が出した注文か。
自分の注文の「買う」は押せない
labelOf(order.seller) 売り手のアドレスを、投資家Aのような名前にする
{formatWholeYen(accrued)} × {formatUnitsCount(order.units)} 経過利息の列に1口の額と口数を並べる。
記録日の後は-6円 × 2口のように負の額が出る
accrued < 0n ? ... : ... 下の行に添える日数を選ぶ。
負の時は利払い日までの引いた日数を出し、それ以外は数え始めた日からの日数を出す
{ ...jpy, functionName: "approve", args: [contracts.settlement, total] } 1つ目の取引で、払う総額の円を決済のコントラクトに任せる
{ ...settlement, functionName: "buy", args: [BigInt(order.id)] } 2つ目の取引でbuyを呼び、円と社債を入れ替える

確かめる

starter/appのディレクトリでpnpm devを実行し、ブラウザでhttp://localhost:3402を開きます。
pnpm devはコントラクトをコンパイルしてABIを書き出し直すので、前のレッスンで足したlistとbuyを画面から呼べます。

まず、前の節と同じ手順で社債を発行します。
右上で「投資家A」を選んで申し込むの欄に20を入れて「申し込む」を押し、「投資家B」に切り替えて10口を申し込みます。
発行体のページで「締め切りの後へ進める」を押してから「募集を締める」を押すと、投資家Aに20口と投資家Bに10口の社債が発行されます。

次に、投資家のページで「投資家A」に切り替え、売買の欄の売る口数に2を入れて1口の値段に99800を入れます。
「売りに出す」を押すと「2口を1口99,800円で売りに出しました」と出て、売りの注文の一覧に投資家Aの行が出ます。
右上で「投資家B」に切り替えると、同じ行の「買う」を押せるようになります。
時刻の帯のチェーンの日付は払込日の2026-01-15なので、経過利息の列は0円 × 2口と払込日から0日で、払う総額は199,600円です。

投資家Aが2口を売りに出し、投資家Bの画面に経過利息と払う総額が出たところ
投資家Aが2口を売りに出し、投資家Bの画面に経過利息と払う総額が出たところ

「買う」を押すと、画面は199,600円のapproveとbuyの2つの取引を順に送ります。
「2口を199,600円で買いました」と出て、投資家Bの社債は12口に増え、円トークンは1,800,400円に減ります。
売りの注文の一覧は空になり、投資家Aに切り替えると社債は18口で円トークンは1,199,600円です。

投資家Bが2口を買い、円と社債が入れ替わったところ
投資家Bが2口を買い、円と社債が入れ替わったところ

投資家Aに切り替えて持っている18口より多い30口を売りに出そうとすると、コントラクトが拒んで「売りに出す口数を持っていません」と出ます。

これで節4は終わりです。
投資家どうしが経過利息を足した額で社債を売り買いし、円と社債が1つの取引で入れ替わるところまで進みました。