ローカルノードへデプロイする
作るもの
このレッスンを終えると、Hardhat Ignitionで円トークンと社債トークンと価格とローンを一緒にローカルノードのanvilへデプロイできます。
デプロイの後には社債の募集を締めて借り手3人へ社債を10口ずつ渡し、評価会社が最初の価格を入れます。
ローンが2つのトークンと価格のアドレスを持つことは、Hardhatのテストで確かめられます。
starter/appのディレクトリでpnpm devを実行すれば、anvilの起動から画面の起動までをコマンド1つで行えます。
背景
証券担保ローンを画面で試すには、借り手が担保の社債を持ち、貸し手の銀行が円を持つ状態が要ります。
評価会社が社債の価格を入れていなければ、担保の評価額も決まりません。
借り手が社債を持つまでには、2作目の申込と締めと払込の手順を踏みます。
この手順を3作目に書き写すと、2作目の決まりと食い違うおそれがあります。
このレッスンでは、2作目の完成版が持つ社債トークンを用意する手順をそのまま呼び出し、その後に価格とローンをデプロイします。
Ignitionは決めた順に取引を送る道具で、チェーンの時計を進める操作は持ちません。
社債の募集は締め切りの2026-01-14を過ぎるまで締められないため、時計を進めて締める所はhardhat runで実行するスクリプトに分けます。
デプロイが済むと、local.jsonの5つのアカウントは次の状態になります。
| アカウント | デプロイの後に持つもの |
|---|---|
anvilの最初のアカウント0xf39F…2266 |
円トークンと社債の発行体の役割と、価格のコントラクトの管理者の役割 |
| 借り手A・B・C | 社債10口と、円トークン2,000,000円ずつ |
| 銀行 | 円トークン10,000,000円。 ローンの貸し手として名指される |
| 評価会社 | 価格のコントラクトに社債1口の価格を入れる役割 |
実装
starter/contracts/ignition/modules/SecuritiesLoan.tsを新しく作ります。
import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";
import { keccak256, toHex } from "viem";
import BondTokenReadyModule from "@handsonchain/digital-bond-contracts/ignition/modules/BondTokenReady.js";
import local from "../../local.json" with { type: "json" };
// ローカルノードで使うローンの条件。返済の期限は担保の社債の満期 (2027-01-15) より前の2026-12-15 (日本時間の0時)
export const LOCAL_LOAN = {
rateBps: 200n,
dueDate: 1797260400n,
};
function accountOf(role: string): `0x${string}` {
const account = local.accounts.find((entry) => entry.role === role);
if (!account) throw new Error(`local.json に ${role} のアカウントがない`);
return account.address as `0x${string}`;
}
// 2作目の手順で円トークンと社債と決済をデプロイして借り手に申し込ませ、価格とローンを一緒にデプロイする
export default buildModule("SecuritiesLoanModule", (m) => {
const { jpy, bond, settlement } = m.useModule(BondTokenReadyModule);
const admin = m.getAccount(0);
const lender = accountOf("lender");
const price = m.contract("CollateralPrice", [admin, accountOf("valuer")]);
const loan = m.contract("SecuritiesLoan", [
jpy,
bond,
settlement,
price,
lender,
m.getParameter("rateBps", LOCAL_LOAN.rateBps),
m.getParameter("dueDate", LOCAL_LOAN.dueDate),
]);
// ローンのコントラクトは円と社債を預かるので、円トークンの許可リストに載せる
m.call(jpy, "setAllowed", [loan, true], { id: "allow_loan" });
// 貸し手の銀行を許可リストに載せ、借り手へ貸す1,000万円を渡す
const allowLender = m.call(jpy, "setAllowed", [lender, true], { id: "allow_lender" });
m.call(jpy, "issue", [lender, 10_000_000n * 10n ** 18n, keccak256(toHex("loan-lender"))], { id: "issue_lender", after: [allowLender] });
return { jpy, bond, settlement, price, loan };
});
| 行 | 意味 |
|---|---|
import BondTokenReadyModule from "@handsonchain/..." |
2作目の完成版のignition/modules/BondTokenReady.tsを、ワークスペースの依存から読み込む |
LOCAL_LOAN |
ローカルノードで使うローンの条件。 年の金利の 200nは1万分の200で2.00%にあたる |
dueDate: 1797260400n |
返済の期限の2026-12-15。 担保の社債が満期で消える前に返してもらう |
accountOf(role) |
local.jsonから役のアカウントを探す。見つからない時はデプロイを止める |
m.useModule(BondTokenReadyModule) |
2作目の手順を、このモジュールの一部として実行する。 戻り値から円トークンと社債と決済を受け取る |
m.getAccount(0) |
anvilの最初のアカウント0xf39F…2266。円トークンと社債をデプロイした発行体で、価格のコントラクトの管理者にもする |
m.contract("CollateralPrice", [...]) |
価格のコントラクトをデプロイする。 価格を入れる役割は local.jsonの評価会社だけが受け取る |
m.contract("SecuritiesLoan", [...]) |
2つのトークンと決済と価格に、貸し手と金利と返済の期限を添えてローンをデプロイする |
{ id: "allow_loan" } |
同じ関数を2回以上呼ぶ時は、Ignitionの記録で見分ける名前を付ける |
after: [allowLender] |
銀行を許可リストに載せた後に、銀行へ1,000万円を発行する。 許可リストに載る前の発行は円トークンが拒む |
keccak256(toHex("loan-lender")) |
発行の元になった入金を見分ける参照の値。 1作目の issueが3つ目の引数で受け取る |
返済の期限が社債の満期より後なら、前のレッスンで書いたconstructorがDueDateAfterMaturityで拒み、デプロイは止まります。
m.getParameterで条件を差し替えられるようにしたのは、Fujiでは今日から数えた日付を使うためです。
BondTokenReadyModuleの中では、2作目のDigitalBondModuleが円トークンと社債と決済のコントラクトをデプロイします。
その後にlocal.jsonの投資家3人の名義で、10口分の円を決済のコントラクトに任せてから10口を申し込みます。
2作目の投資家のアドレスはこのコースの借り手A・B・Cと同じなので、借り手3人が申し込んだ状態になります。
借り手は1作目と2作目の手順で円を300万円ずつ受け取り、申込に100万円を払うので、デプロイの後は200万円ずつ持ちます。
次に、デプロイの後に募集を締めて最初の価格を入れるstarter/contracts/scripts/open-local.tsを作ります。
// ローカルノードへデプロイした後に、社債の募集を締めて借り手へ10口ずつ渡し、評価会社が最初の価格を入れる。
// 2026-01-01から立ち上げたanvilの時計を、社債の払込日の2026-01-15へ進める。
//
// 使い方
// pnpm run deploy:local (Ignitionのデプロイの後に hardhat run が実行する)
import { readFileSync } from "node:fs";
import { network } from "hardhat";
import { openBond } from "@handsonchain/digital-bond-contracts/scripts/open-bond.js";
import local from "../local.json" with { type: "json" };
// 評価会社が最初に入れる社債1口の価格 (円)
const FIRST_PRICE = 100_000n;
const addresses = JSON.parse(
readFileSync(new URL(`../ignition/deployments/chain-${local.chainId}/deployed_addresses.json`, import.meta.url), "utf8"),
) as Record<string, `0x${string}`>;
const valuer = local.accounts.find((account) => account.role === "valuer")?.address as `0x${string}`;
const { viem } = await network.create();
const publicClient = await viem.getPublicClient();
const [walletClient] = await viem.getWalletClients();
await openBond({ publicClient, testClient: await viem.getTestClient(), walletClient }, addresses["DigitalBondModule#BondSettlement"]);
const price = await viem.getContractAt("CollateralPrice", addresses["SecuritiesLoanModule#CollateralPrice"]);
const hash = await price.write.setPrice([FIRST_PRICE], { account: valuer });
await publicClient.waitForTransactionReceipt({ hash });
process.stdout.write(`借り手3人へ社債を10口ずつ渡し、評価会社が1口${FIRST_PRICE.toLocaleString("ja-JP")}円の価格を入れました\n`);
| 行 | 意味 |
|---|---|
deployed_addresses.json |
Ignitionがデプロイしたアドレスを残す記録。モジュール#コントラクトの名前でアドレスを引く |
network.create() |
--network localhostで渡したanvilへつなぐ道具を作る |
openBond(...) |
2作目の完成版のscripts/open-bond.tsの関数。時計を払込日へ進めて募集を締め、全ての回の利金を入れておく |
viem.getTestClient() |
anvilの時計を進める道具。openBondが次のブロックの時刻を払込日にするのに使う |
price.write.setPrice([FIRST_PRICE], { account: valuer }) |
評価会社の名義で、社債1口の価格を100,000円にする |
waitForTransactionReceipt({ hash }) |
価格を入れた取引がブロックに入るまで待つ |
anvilはlocal.jsonのアカウントの鍵を最初から持つため、スクリプトは鍵を持たずに評価会社の名義で送れます。
openBondは締めの取引を発行体の名義で送り、決済のコントラクトが借り手3人へ社債を10口ずつ発行します。
利金を先に入れておくのは、最後の節で担保の社債の利金を借り手へ渡すためです。
デプロイの結果を確かめるHardhatのテストをstarter/contracts/test/deploy.test.tsに作ります。
import assert from "node:assert/strict";
import { describe, it } from "node:test";
import { network } from "hardhat";
import SecuritiesLoanModule, { LOCAL_LOAN } from "../ignition/modules/SecuritiesLoan.js";
import local from "../local.json" with { type: "json" };
describe("SecuritiesLoanModule", async function () {
// 社債の申込の締め切り (2026-01-14) より前から始めるため、チェーンの最初の日を2026-01-01 (日本時間) にする
const { ignition } = await network.create({ override: { initialDate: new Date(1767193200 * 1000) } });
it("ignition-deploys-loan-with-tokens", async function () {
const { jpy, bond, settlement, price, loan } = await ignition.deploy(SecuritiesLoanModule);
// ローンは2作目の円トークンと社債と決済、価格のアドレスを持つ
assert.equal((await loan.read.jpy()).toLowerCase(), jpy.address.toLowerCase());
assert.equal((await loan.read.bond()).toLowerCase(), bond.address.toLowerCase());
assert.equal((await loan.read.settlement()).toLowerCase(), settlement.address.toLowerCase());
assert.equal((await loan.read.priceFeed()).toLowerCase(), price.address.toLowerCase());
assert.equal(await loan.read.dueDate(), LOCAL_LOAN.dueDate);
// 貸し手は local.json の銀行で、ローンと銀行は円トークンの許可リストに載っている
const lender = local.accounts.find((account) => account.role === "lender")?.address as `0x${string}`;
assert.equal((await loan.read.lender()).toLowerCase(), lender.toLowerCase());
assert.equal(await jpy.read.isAllowed([loan.address]), true);
assert.equal(await jpy.read.balanceOf([lender]), 10_000_000n * 10n ** 18n);
// 価格を入れられるのは local.json の評価会社
const valuer = local.accounts.find((account) => account.role === "valuer")?.address as `0x${string}`;
assert.equal(await price.read.hasRole([await price.read.VALUER_ROLE(), valuer]), true);
});
});
| 行 | 意味 |
|---|---|
override: { initialDate: ... } |
テストのチェーンの最初の日を2026-01-01にする。 締め切りの後から始めると、 BondTokenReadyModuleの申込が拒まれる |
ignition.deploy(SecuritiesLoanModule) |
pnpm devと同じIgnitionの手順で、5つのコントラクトをデプロイする |
loan.read.jpy()からloan.read.priceFeed()まで |
ローンが持つアドレスを読み、デプロイしたアドレスと比べる。 大文字と小文字の違いは除く |
loan.read.lender() |
ローンの貸し手がlocal.jsonの銀行かを確かめる |
jpy.read.balanceOf([lender]) |
銀行に1,000万円が18桁の単位で入ったかを確かめる |
price.read.hasRole([...]) |
local.jsonの評価会社が、価格を入れるVALUER_ROLEを持つかを確かめる |
このテストはignition.deployだけを実行し、open-local.tsは実行しません。
募集の締めは2作目のテストが確かめているので、ここではローンが正しい相手を指しているかに絞ります。
雛形のcontracts/package.jsonのdeploy:localは、最初からこのモジュールとスクリプトを名指しています。
"deploy:local": "hardhat ignition deploy ignition/modules/SecuritiesLoan.ts --network localhost --reset && hardhat run scripts/open-local.ts --network localhost",
| 部分 | 意味 |
|---|---|
hardhat ignition deploy ... --reset |
前のデプロイの記録を消してから、5つのコントラクトをデプロイする |
&& hardhat run scripts/open-local.ts |
デプロイが通った時だけ、募集を締めて価格を入れるスクリプトを実行する |
雛形のapp/scripts/dev.tsは、anvilの最初のブロックの時刻を2026-01-01の0時 (日本時間) にして起動します。
社債の申込は締め切りの2026-01-14までに済ませる決まりなので、チェーンの時刻を締め切りより前から始めるためです。
書いたデプロイの手順をローカルノードへ出す流れは、補助にまとめてあります。
このコースでは、補助の<chainPort>が8602、<appPort>が3403になります。
リポジトリのルートのpnpm dev:securities-loanは完成版の画面を開くコマンドで、同じポートを使います。
雛形を動かす間は、完成版を止めておきます。
確かめる
starter/contractsのディレクトリで、Hardhatのテストを実行します。
pnpm run build
pnpm run test:hardhat
pnpm run buildはexport-abi: generated/abi.ts に5つのABIを書いたの行を出し、画面が読む5つのコントラクトのABIを書き出します。
次の行が出れば、デプロイの手順は正しく動いています。
SecuritiesLoanModule
✔ ignition-deploys-loan-with-tokens
補助の確かめ方でstarter/appのpnpm devを起動すると、デプロイしたアドレスの一覧の後に次の行が出ます。
最後にhttp://localhost:3403の行が出れば、画面も起動しています。
SecuritiesLoanModule#CollateralPrice - 0x…
SecuritiesLoanModule#SecuritiesLoan - 0x…
借り手3人へ社債を10口ずつ渡し、評価会社が1口100,000円の価格を入れました
画面の中身は次のレッスンで作ります。
ここでは別のターミナルからcastで、借り手Aの社債の口数と、ローンが読む価格を読みます。
アドレスは、一覧のDigitalBondModule#BondTokenとSecuritiesLoanModule#CollateralPriceの行から写します。
cast call <社債トークンのアドレス> "balanceOf(address)(uint256)" 0x70997970C51812dc3A010C7d01b50e0d17dc79C8 --rpc-url http://127.0.0.1:8602
cast call <価格のコントラクトのアドレス> "currentPrice()(uint256)" --rpc-url http://127.0.0.1:8602
1行目に10と出れば、募集が締まって借り手Aに社債が10口渡っています。
2行目に100000 [1e5]と出れば、評価会社が入れた1口100,000円の価格を読めています。