ローカルノードへデプロイする
作るもの
このレッスンを終えると、Hardhat Ignitionで円トークンと社債トークンを一緒にローカルノードのanvilへデプロイできます。
社債トークンが円トークンのアドレスを持つことは、Hardhatのテストで確かめられます。
starter/appのディレクトリでpnpm devを実行すれば、anvilの起動から画面の起動までをコマンド1つで行えます。
背景
社債トークンは、円トークンの名簿を読みます。
そのため、社債トークンをデプロイする前に円トークンがチェーンの上にあり、投資家が本人確認済みになっている必要があります。
円トークンの用意の仕方を2つのコースで別々に書くと、手順が食い違うおそれがあります。
このレッスンでは、1作目の完成版のデプロイの手順をそのまま呼び出し、その後に社債トークンをデプロイします。
実装
starter/contracts/ignition/modules/DigitalBond.tsを新しく作ります。
import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";
import JpyTokenReadyModule from "@handsonchain/jpy-stablecoin-contracts/ignition/modules/JpyTokenReady.js";
// ローカルノードで使う社債の条件。日付は日本時間の0時で、anvilは2026-01-01から始める。
// Fujiへは scripts/fuji-parameters.ts が今日から数えた日付を ignition/parameters/fuji.json に書いて渡す
export const LOCAL_BOND = {
faceValue: 100_000n,
rateBps: 80n,
issueDate: 1768402800n, // 2026-01-15
paymentDates: [1784041200n, 1799938800n], // 2026-07-15、2027-01-15
recordDates: [1783609200n, 1799506800n], // 2026-07-10、2027-01-10
};
// 1作目の手順で円トークンをデプロイして投資家を本人確認済みにし、社債を一緒にデプロイする
export default buildModule("DigitalBondModule", (m) => {
const { token: jpy } = m.useModule(JpyTokenReadyModule);
const issuer = m.getAccount(0);
const bond = m.contract("BondToken", [
jpy,
issuer,
m.getParameter("faceValue", LOCAL_BOND.faceValue),
m.getParameter("rateBps", LOCAL_BOND.rateBps),
m.getParameter("issueDate", LOCAL_BOND.issueDate),
m.getParameter("paymentDates", LOCAL_BOND.paymentDates),
m.getParameter("recordDates", LOCAL_BOND.recordDates),
]);
return { jpy, bond };
});
| 行 | 意味 |
|---|---|
import JpyTokenReadyModule from "@handsonchain/..." |
1作目の完成版のignition/modules/JpyTokenReady.tsを、ワークスペースの依存から読み込む |
LOCAL_BOND |
ローカルノードで使う社債の条件。 前のレッスンのテストと同じ日付にする。 nの付いた数はTypeScriptのbigintで、Solidityのuint256とuint64に渡せる |
m.useModule(JpyTokenReadyModule) |
1作目の手順を、このモジュールの一部として実行する。 戻り値の tokenをjpyという名前で受け取る |
m.getAccount(0) |
anvilの最初のアカウント0xf39F…2266。円トークンをデプロイしたのと同じ発行体のアカウント |
m.contract("BondToken", [jpy, issuer, ...]) |
円トークンと発行体と社債の条件をconstructorに渡す。jpyを渡したので、Ignitionは円トークンのデプロイを待ってから社債トークンをデプロイする |
m.getParameter("faceValue", ...) |
値を外から差し替えられるようにする。 何も渡さない時は LOCAL_BONDの値を使う |
return { jpy, bond } |
テストと画面が使えるよう、2つのコントラクトを返す |
JpyTokenReadyModuleの中では、1作目のJpyTokenModuleがm.contract("JpyToken", [issuer])で円トークンをデプロイします。
このとき使う円トークンの成果物は、雛形のnpmFilesToBuildが書き出したものです。
JpyTokenReadyModuleは1作目のlocal.jsonの利用者を本人確認済みにし、100万円ずつ発行します。
このアドレスはこのコースの投資家と同じなので、デプロイが済むと投資家3人が本人確認済みで100万円ずつ持つ状態になります。
m.getParameterで条件を差し替えられるようにしたのは、Fujiのような外のネットワークでは今日から数えた日付を使うためです。
その日付を作るscripts/fuji-parameters.tsは、テストネットへデプロイするレッスンで書きます。
デプロイの結果を確かめるHardhatのテストをstarter/contracts/test/deploy.test.tsに作ります。
import assert from "node:assert/strict";
import { describe, it } from "node:test";
import { network } from "hardhat";
import DigitalBondModule from "../ignition/modules/DigitalBond.js";
import local from "../local.json" with { type: "json" };
describe("DigitalBondModule", async function () {
const { ignition } = await network.create();
it("ignition-deploys-bond-with-jpy", async function () {
const { jpy, bond } = await ignition.deploy(DigitalBondModule);
// 円トークンは1作目の完成版の手順でデプロイし、投資家は本人確認済みになっている
assert.equal(await jpy.read.symbol(), "HJPY");
const investors = local.accounts.filter((account) => account.role === "investor").map((account) => account.address as `0x${string}`);
assert.ok(investors.length > 0);
for (const investor of investors) assert.equal(await jpy.read.isAllowed([investor]), true);
// 社債は円トークンの名簿を読む
assert.equal((await bond.read.jpy()).toLowerCase(), jpy.address.toLowerCase());
});
});
| 行 | 意味 |
|---|---|
network.create() |
テストのたびに、Hardhatの中で空のチェーンを作る |
ignition.deploy(DigitalBondModule) |
pnpm devと同じIgnitionの手順で、円トークンと社債トークンをデプロイする |
local.accounts.filter(...) |
このコースのlocal.jsonから、役割がinvestorのアドレスを読む |
jpy.read.isAllowed([investor]) |
投資家が円トークンの名簿で本人確認済みになったかを確かめる |
bond.read.jpy() |
社債トークンが持つ円トークンのアドレスを読む。 アドレスの大文字と小文字の違いを除いて比べる |
雛形のcontracts/package.jsonのdeploy:localは、最初からこのモジュールを名指しています。
"deploy:local": "hardhat ignition deploy ignition/modules/DigitalBond.ts --network localhost --reset",
雛形のapp/scripts/dev.tsは、anvilの最初のブロックの時刻を2026-01-01の0時 (日本時間) にして起動します。
社債の日程を2026年に置いたので、チェーンの時刻を払込日より前から始めるためです。
書いたデプロイの手順をローカルノードへ出す流れは、補助にまとめてあります。
このコースでは、補助の<chainPort>が8601、<appPort>が3402になります。
リポジトリのルートのpnpm dev:digital-bondは完成版の画面を開くコマンドで、同じポートを使います。
雛形を動かす間は、完成版を止めておきます。
確かめる
starter/contractsのディレクトリで、Hardhatのテストを実行します。
pnpm run build
pnpm run test:hardhat
pnpm run buildはexport-abi: generated/abi.ts に2つのABIを書いたの行を出し、円トークンと社債トークンのABIを書き出します。
次の行が出れば、デプロイの手順は正しく動いています。
DigitalBondModule
✔ ignition-deploys-bond-with-jpy
補助の確かめ方でstarter/appのpnpm devを起動すると、次の2行とhttp://localhost:3402の行が出ます。
JpyTokenModule#JpyToken - 0x5FbDB2315678afecb367f032d93F642f64180aa3
DigitalBondModule#BondToken - 0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512
画面の中身は次のレッスンで作ります。
ここでは別のターミナルからcastで、社債トークンが持つ円トークンのアドレスと、投資家Aの円の残高を読みます。
cast call 0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512 "jpy()(address)" --rpc-url http://127.0.0.1:8601
cast call 0x5FbDB2315678afecb367f032d93F642f64180aa3 "balanceOf(address)(uint256)" 0x70997970C51812dc3A010C7d01b50e0d17dc79C8 --rpc-url http://127.0.0.1:8601
1行目に0x5FbDB2315678afecb367f032d93F642f64180aa3と出れば、社債トークンは円トークンの名簿を読む先を持っています。
2行目に1000000000000000000000000 [1e24]と出れば、投資家Aに100万円分が18桁の単位で入っています。