HandsOnChain

社債の条件の画面を作る

作るもの

このレッスンを終えると、ブラウザでヘッダーのタブを押して投資家と発行体のページを切り替えられます。
発行体のページでは、1口の額面と利率と払込日と満期を見られます。
投資家のページでは、持っている口数と円トークンの残高と本人確認の結果を見られます。
ローカルノードでは画面の右上でanvilのアカウントを選ぶだけで、ウォレットを入れずに試せます。

背景

社債を持つ人は、証券会社から届く報告や画面で、持っている額と社債の条件を確かめます。
その数字は、証券会社が持つ帳簿から作られます。

社債トークンの画面は、証券会社のサーバーを通さず、チェーンの上の社債トークンと円トークンから直接読みます。
社債の条件はコントラクトのimmutableの値なので、誰が作った画面から読んでも同じ値が出ます。
画面はページを分けるだけで、誰が何をできるかはコントラクトの役割と名簿が決めます。

ページ パス 見るもの
投資家 / 持っている口数、円トークンの残高、本人確認の結果
発行体 /issuer 発行した口数と、社債の条件
投資家のページが読むもの
投資家のページinvestor-view.tsxuseBonduse-bond.ts社債トークンBondToken円トークンJpyToken112233useBond()useBond()faceValue、rateBps、balanceOffaceValue、rateBps、balanceOf100000、80、0100000、80、0balanceOf、isAllowedbalanceOf、isAllowed1,000,000円、true1,000,000円、true0口、1,000,000円、本人確認済み

実装

雛形のstarter/app/src/には、次のファイルが最初から入っています。
このレッスンでは、これらを土台に、社債を読むフックと取引を送るフックと2つのページを足します。

ファイル 役割
lib/chains.ts ローカルノードのanvilとFujiのチェーンの定義と、local.jsonのアカウントの名前
lib/wagmi.ts wagmiの設定。
ローカルノードはmock、Fujiはブラウザのウォレットでつなぐ
lib/deployments.ts Ignitionの記録から、円トークンと社債トークンのアドレスを読む
lib/format.ts 円と口数と日付と利率の表示を作る。
コントラクトが拒んだ理由も日本語の文にする
lib/theme.ts 画面の色味の名前と、選んだ色味をブラウザに残す時の鍵
components/session.tsx 今のネットワーク、操作しているアカウント、デプロイしたコントラクトのアドレスを持つ
components/header.tsx 右上に、色味を切り替えるボタンと、操作するアカウントを選ぶ欄を持つ
components/ui.tsx カードと入力欄と数を表示し、状態のバッジと通知の行も出すコンポーネント
components/not-deployed.tsx 社債トークンをまだデプロイしていない時に、デプロイのコマンドを示す

ローカルノードでは、wagmiのmockコネクタが署名の依頼をそのままanvilへ渡します。
anvilが最初から持つアカウントの鍵で署名するため、鍵を画面やブラウザに置かずに済みます。

社債を読むフック

まず、社債の条件と口数を読むstarter/app/src/components/use-bond.tsを作ります。
読む値に名前を付けてまとめて読み、名前ごとの値にして返します。

"use client";

import { bondTokenAbi, jpyTokenAbi } from "@contracts/generated/abi";
import type { Abi } from "viem";
import { zeroAddress } from "viem";
import { useBlock, useReadContracts } from "wagmi";

import { useSession } from "./session";

type Read = { address: `0x${string}` | undefined; abi: Abi; functionName: string; args?: readonly unknown[] };

// 名前を付けた読み取りをまとめて読み、名前ごとの値にする。4秒ごとに読み直す
function useNamedReads(reads: Record<string, Read>, enabled: boolean) {
  const { chainId } = useSession();
  const names = Object.keys(reads);
  const result = useReadContracts({
    allowFailure: true,
    contracts: names.map((name) => ({ ...reads[name], chainId })),
    query: { enabled, refetchInterval: 4_000 },
  });
  const values: Record<string, unknown> = {};
  names.forEach((name, index) => {
    values[name] = result.data?.[index]?.result;
  });
  return values;
}
コード 意味
useReadContracts 複数の読み取り用の関数をまとめて呼び、結果を呼んだ順の配列で返す
Readのabi: Abi 社債トークンと円トークンの読み取りを1つの配列に並べるため、ABIの型を広げておく。
値の型は使う所で決める
names.forEach(...) 配列の順の結果を、faceValueのような名前で引けるようにする。
後の節で読む値を足しても、順番を数え直さずに済む
refetchInterval: 4_000 4秒ごとに読み直す。
別のアカウントの操作も、待てば画面に出る

同じファイルの続きに、社債の条件と口数を読むuseBondを書きます。

export type Coupon = {
  n: number;
  recordDate: bigint | undefined;
  paymentDate: bigint | undefined;
};

// 社債の条件と、今のアカウントの残高と、決済のコントラクトの状態を読む
export function useBond() {
  const { contracts, address } = useSession();
  const me = address ?? zeroAddress;
  const bond = { address: contracts.bond, abi: bondTokenAbi as Abi };
  const jpy = { address: contracts.jpy, abi: jpyTokenAbi as Abi };
  const block = useBlock({ watch: true, query: { enabled: Boolean(contracts.bond) } });

  const base = useNamedReads(
    {
      faceValue: { ...bond, functionName: "faceValue" },
      rateBps: { ...bond, functionName: "rateBps" },
      issueDate: { ...bond, functionName: "issueDate" },
      maturity: { ...bond, functionName: "maturity" },
      couponCount: { ...bond, functionName: "couponCount" },
      totalSupply: { ...bond, functionName: "totalSupply" },
      units: { ...bond, functionName: "balanceOf", args: [me] },
      yen: { ...jpy, functionName: "balanceOf", args: [me] },
      allowed: { ...jpy, functionName: "isAllowed", args: [me] },
    },
    Boolean(contracts.bond),
  );

  const count = Number((base.couponCount as bigint | undefined) ?? 0n);
  const indexes = Array.from({ length: count }, (_, n) => n);
  const perCoupon = useNamedReads(
    Object.fromEntries(
      indexes.flatMap((n) => [
        [`record:${n}`, { ...bond, functionName: "recordDate", args: [BigInt(n)] }],
        [`payment:${n}`, { ...bond, functionName: "paymentDate", args: [BigInt(n)] }],
      ]),
    ),
    count > 0,
  );

  const coupons: Coupon[] = indexes.map((n) => {
    const paymentDate = perCoupon[`payment:${n}`] as bigint | undefined;
    return {
      n,
      recordDate: perCoupon[`record:${n}`] as bigint | undefined,
      paymentDate,
    };
  });

  return {
    now: block.data?.timestamp,
    faceValue: base.faceValue as bigint | undefined,
    rateBps: base.rateBps as bigint | undefined,
    issueDate: base.issueDate as bigint | undefined,
    maturity: base.maturity as bigint | undefined,
    totalSupply: base.totalSupply as bigint | undefined,
    units: base.units as bigint | undefined,
    yen: base.yen as bigint | undefined,
    allowed: base.allowed as boolean | undefined,
    coupons,
  };
}

export type BondState = ReturnType<typeof useBond>;
コード 意味
contracts.bondとcontracts.jpy session.tsxが持つ、Ignitionの記録から読んだ社債トークンと円トークンのアドレス
address ?? zeroAddress アカウントが決まる前はゼロアドレスで読む。
読み取りの数を変えずに済む
useBlock({ watch: true, ... }) 新しいブロックを見張り、チェーンの今の時刻をnowとして返す。
利払いの節で、記録日や利払い日を過ぎたかを見るのに使う
unitsとyenとallowed 操作しているアカウントの社債の口数、円トークンの残高、名簿の本人確認の結果
perCoupon 利払いの回数が読めてから、回ごとの記録日と利払い日を読む。
count > 0になるまでは読まない
coupons 回ごとの日付の並び。
利払いの画面で使う

コメントにある決済のコントラクトの状態は、次の節で決済のコントラクトを足した時に、ここへ読む値を足します。

取引を送るフック

次に、取引を送るstarter/app/src/components/use-send.tsを作ります。
この節の画面は読むだけですが、次の節の申込から、どのページもこのフックで取引を送ります。

"use client";

import { bondTokenAbi, jpyTokenAbi } from "@contracts/generated/abi";
import { useQueryClient } from "@tanstack/react-query";
import { useState } from "react";
import type { Abi } from "viem";
import { useConfig } from "wagmi";
import { simulateContract, waitForTransactionReceipt, writeContract } from "wagmi/actions";

import { explainError } from "@/lib/format";

import { useSession } from "./session";
import type { Notice } from "./ui";

// 1つの取引の中身。申込のように円を任せてから申し込む操作は、2つの取引を順に送る
export type Call = {
  abi: Abi;
  address: `0x${string}` | undefined;
  functionName: string;
  args: readonly unknown[];
};

// 決済のコントラクトの中で円トークンや社債が断った時も理由を読めるよう、両方のエラーの定義を足して試す
const tokenErrors = [...jpyTokenAbi, ...bondTokenAbi].filter((item) => item.type === "error") as Abi;

// 送る前に同じ取引を試し、コントラクトが拒む時は送らずに理由を出す。
// 通る時だけ送り、ブロックに入るまで待ってから、画面の読み取りを全て読み直す
export function useSend() {
  const config = useConfig();
  const queryClient = useQueryClient();
  const { chainId, address } = useSession();
  const [pending, setPending] = useState<string>();
  const [notice, setNotice] = useState<Notice>();

  async function send(key: string, done: string, calls: Call[]) {
    if (!address || calls.some((call) => !call.address)) return false;
    setPending(key);
    setNotice(undefined);
    try {
      for (const call of calls) {
        const { request } = await simulateContract(config, { ...call, abi: [...call.abi, ...tokenErrors], account: address, chainId } as Parameters<typeof simulateContract>[1]);
        const hash = await writeContract(config, request);
        const receipt = await waitForTransactionReceipt(config, { hash, chainId });
        if (receipt.status !== "success") throw new Error("reverted");
      }
      setNotice({ kind: "ok", text: done });
      await queryClient.invalidateQueries();
      return true;
    } catch (error) {
      setNotice({ kind: "error", text: explainError(error) });
      return false;
    } finally {
      setPending(undefined);
    }
  }

  return { send, pending, notice };
}
コード 意味
Call 送る取引の中身。
送り先のアドレスと関数の名前と引数を持つ
send(key, done, calls) callsを書いた順に1つずつ送る。
円を任せてから申し込むような、2つの取引が要る操作もまとめて頼める
tokenErrors 円トークンと社債トークンのエラーの定義。
決済のコントラクトの中で円トークンが拒んだ時も、エラーの名前を読める
simulateContract(...) 取引を送らずに試す。
拒まれる時はここでエラーになり、取引は送られない
writeContractとwaitForTransactionReceipt 試して通った取引を送り、ブロックに入るまで待つ
queryClient.invalidateQueries() 画面の読み取りを全てやり直し、送った結果を出す
explainError(error) 拒んだ理由をlib/format.tsの文に変える。
名簿で拒まれた時は「円トークンの名簿で本人確認が済んでいないアカウントです」になる

試さずに送ると、anvilは拒まれる取引もブロックに入れます。
結果は「失敗した」だけになり、拒んだ理由を画面に出せません。

投資家のページ

投資家のページの中身を、starter/app/src/components/investor-view.tsxに作ります。

"use client";

import { formatUnitsCount, formatYen, shortAddress } from "@/lib/format";

import { NotDeployed } from "./not-deployed";
import { useSession } from "./session";
import { Amount, Badge } from "./ui";
import { useBond } from "./use-bond";

export function InvestorView() {
  const session = useSession();
  const bond = useBond();
  const me = session.address;
  const stopped = false;

  if (!session.contracts.bond) return <NotDeployed />;
  if (!me) return null;

  return (
    <div className="stack">
      <div className="hero">
        <div>
          <p className="hero-label">持っている社債</p>
          <p className="hero-value">
            <Amount text={formatUnitsCount(bond.units)} />
          </p>
          <p className="hero-sub">
            {session.label ?? "このアカウント"} {shortAddress(me)}
          </p>
        </div>
        <ul className="status-list" aria-label="アカウントの状態">
          <li>
            <span>円トークン</span>
            <span className="mono">{formatYen(bond.yen)}</span>
          </li>
          <li>
            <span>本人確認</span>
            {bond.allowed ? <Badge tone="good">本人確認済み</Badge> : <Badge tone="warn">未確認</Badge>}
          </li>
        </ul>
      </div>
    </div>
  );
}
コード 意味
if (!session.contracts.bond) return <NotDeployed />; 社債トークンをまだデプロイしていない時は、デプロイのコマンドを示す
formatUnitsCount(bond.units) 口数を0口の形にする。
社債は桁を持たないので、読んだ数をそのまま出す
<Amount text={...} /> 雛形のui.tsxが持つ、数を大きく出すコンポーネント。
数字の後の口の字を一回り小さく添える
formatYen(bond.yen) 円トークンの18桁の単位の残高を、1,000,000円の形にする
<Badge tone="good"> 本人確認済みなら緑のバッジ、まだなら琥珀のバッジを出す
stopped 売買の欄を止めるかを持つ値。
今はfalseのままにし、売買の画面と不履行の画面で使う

発行体のページ

発行体のページの中身を、starter/app/src/components/issuer-view.tsxに作ります。

"use client";

import { formatDate, formatRate, formatUnitsCount, formatWholeYen } from "@/lib/format";

import { NotDeployed } from "./not-deployed";
import { useSession } from "./session";
import { Amount } from "./ui";
import { useBond } from "./use-bond";

export function IssuerView() {
  const session = useSession();
  const bond = useBond();

  if (!session.contracts.bond) return <NotDeployed />;

  return (
    <div className="stack">
      <div className="hero">
        <div>
          <p className="hero-label">発行した社債</p>
          <p className="hero-value">
            <Amount text={formatUnitsCount(bond.totalSupply)} />
          </p>
        </div>
        <ul className="status-list" aria-label="社債の条件">
          <li>
            <span>1口の額面</span>
            <span className="mono">{formatWholeYen(bond.faceValue)}</span>
          </li>
          <li>
            <span>利率</span>
            <span className="mono">{formatRate(bond.rateBps)}</span>
          </li>
          <li>
            <span>払込日</span>
            <span className="mono">{formatDate(bond.issueDate)}</span>
          </li>
          <li>
            <span>満期</span>
            <span className="mono">{formatDate(bond.maturity)}</span>
          </li>
        </ul>
      </div>
    </div>
  );
}
コード 意味
formatUnitsCount(bond.totalSupply) 発行した社債の総数。
払い込みがまだないので、この節では0口のまま
formatWholeYen(bond.faceValue) 額面は円の整数で持つので、18桁の単位に直さずに100,000円の形にする
formatRate(bond.rateBps) 1万分の1の単位の80を、年0.80%の形にする
formatDate(bond.issueDate) Unix時刻を、日本時間の2026-01-15の形にする

ページとタブ

starter/app/src/app/page.tsxを、投資家のページを出す形に書き換えます。

import { InvestorView } from "@/components/investor-view";

export default function InvestorPage() {
  return <InvestorView />;
}

starter/app/src/app/issuer/page.tsxを新しく作り、発行体のページを/issuerに置きます。

import { IssuerView } from "@/components/issuer-view";

export default function IssuerPage() {
  return <IssuerView />;
}

最後に、starter/app/src/components/header.tsxに2つのページのタブを足します。
まず、今のパスを読むusePathnameを読み込み、タブの並びを書きます。

import Link from "next/link";
import { usePathname } from "next/navigation";
import { useEffect, useState } from "react";
const pages = [
  { href: "/", label: "投資家" },
  { href: "/issuer", label: "発行体" },
];

Headerの中で今のパスを読み、名前の右にタブを出します。

export function Header() {
  const pathname = usePathname();
  return (
    <header className="site-header">
      <div className="site-header-inner">
        <Link href="/" className="brand">
          <span className="brand-mark" aria-hidden="true">
            債
          </span>
          <span>HandsOn Bond</span>
        </Link>

        <nav className="tabs" aria-label="ページ">
          {pages.map((page) => (
            <Link key={page.href} href={page.href} className="tab" aria-current={pathname === page.href ? "page" : undefined}>
              {page.label}
            </Link>
          ))}
        </nav>

        <div className="header-controls">
          <ThemeControl />
          <AccountControl />
        </div>
      </div>
    </header>
  );
}
コード 意味
usePathname() 今開いているページのパスを読む
aria-current={... ? "page" : undefined} 今のページのタブにaria-current="page"を付ける。
読み上げの道具にも今のページが伝わる
<Link ...> Next.jsのリンク。
ページを読み直さずに切り替えるので、右上で選んだアカウントもそのまま残る

タブの見た目は、雛形のstarter/app/src/app/globals.cssに最初から入っています。

.tab[aria-current="page"] {
  background: var(--surface-sub);
  color: var(--ink);
  font-weight: 700;
}

aria-current="page"を持つタブだけを地の色と太い字にして、今のページを見分けられるようにしています。

確かめる

starter/appのディレクトリでpnpm devを実行し、ブラウザでhttp://localhost:3402を開きます。
右上のアカウントは最初「発行体」です。
発行体は円トークンの名簿に載っていないため、投資家のページでは0口と0円と「未確認」が出ます。
右上で「投資家A」に切り替えると、円トークンの残高が1,000,000円になり、「本人確認済み」のバッジが出ます。

投資家Aに切り替えると、100万円の円トークンと本人確認済みのバッジが出る
投資家Aに切り替えると、100万円の円トークンと本人確認済みのバッジが出る

ヘッダーの「発行体」のタブを押すと、/issuerのページに移ります。
発行した社債は、払い込みがまだないので0口です。
右側には、社債の条件が次の値で出ます。

欄 値
1口の額面 100,000円
利率 年0.80%
払込日 2026-01-15
満期 2027-01-15

どの値も、ローカルノードへデプロイするレッスンで社債トークンに渡した条件をチェーンから読んだものです。

発行体のページに社債の条件が出る
発行体のページに社債の条件が出る

これで節1は終わりです。
社債トークンを円トークンと一緒にデプロイし、ブラウザから社債の条件を見られるところまで進みました。
次の節では、投資家が円トークンで申し込み、円と社債を1つの取引で交換する決済のコントラクトを作ります。