社債の条件の画面を作る
作るもの
このレッスンを終えると、ブラウザでヘッダーのタブを押して投資家と発行体のページを切り替えられます。
発行体のページでは、1口の額面と利率と払込日と満期を見られます。
投資家のページでは、持っている口数と円トークンの残高と本人確認の結果を見られます。
ローカルノードでは画面の右上でanvilのアカウントを選ぶだけで、ウォレットを入れずに試せます。
背景
社債を持つ人は、証券会社から届く報告や画面で、持っている額と社債の条件を確かめます。
その数字は、証券会社が持つ帳簿から作られます。
社債トークンの画面は、証券会社のサーバーを通さず、チェーンの上の社債トークンと円トークンから直接読みます。
社債の条件はコントラクトのimmutableの値なので、誰が作った画面から読んでも同じ値が出ます。
画面はページを分けるだけで、誰が何をできるかはコントラクトの役割と名簿が決めます。
| ページ | パス | 見るもの |
|---|---|---|
| 投資家 | / |
持っている口数、円トークンの残高、本人確認の結果 |
| 発行体 | /issuer |
発行した口数と、社債の条件 |
実装
雛形の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円になり、「本人確認済み」のバッジが出ます。

ヘッダーの「発行体」のタブを押すと、/issuerのページに移ります。
発行した社債は、払い込みがまだないので0口です。
右側には、社債の条件が次の値で出ます。
| 欄 | 値 |
|---|---|
| 1口の額面 | 100,000円 |
| 利率 | 年0.80% |
| 払込日 | 2026-01-15 |
| 満期 | 2027-01-15 |
どの値も、ローカルノードへデプロイするレッスンで社債トークンに渡した条件をチェーンから読んだものです。

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