HandsOnChain

ローカルノードへデプロイする

作るもの

このレッスンを終えると、Hardhat Ignitionで円トークンと社債トークンと価格とローンを一緒にローカルノードのanvilへデプロイできます。
デプロイの後には社債の募集を締めて借り手3人へ社債を10口ずつ渡し、評価会社が最初の価格を入れます。
ローンが2つのトークンと価格のアドレスを持つことは、Hardhatのテストで確かめられます。
starter/appのディレクトリでpnpm devを実行すれば、anvilの起動から画面の起動までをコマンド1つで行えます。

背景

証券担保ローンを画面で試すには、借り手が担保の社債を持ち、貸し手の銀行が円を持つ状態が要ります。
評価会社が社債の価格を入れていなければ、担保の評価額も決まりません。
借り手が社債を持つまでには、2作目の申込と締めと払込の手順を踏みます。
この手順を3作目に書き写すと、2作目の決まりと食い違うおそれがあります。

このレッスンでは、2作目の完成版が持つ社債トークンを用意する手順をそのまま呼び出し、その後に価格とローンをデプロイします。
Ignitionは決めた順に取引を送る道具で、チェーンの時計を進める操作は持ちません。
社債の募集は締め切りの2026-01-14を過ぎるまで締められないため、時計を進めて締める所はhardhat runで実行するスクリプトに分けます。

deploy:localが社債と円と価格を用意する順
チェーンに残る値借り手の社債0口10口ずつ社債1口の価格まだない100,000円SecuritiesLoanModuleignition/modules/SecuritiesLoan.tsBondTokenReadyModule2作目の完成版の手順価格とローンCollateralPrice、SecuritiesLoanopen-local.tshardhat runで実行する借り手A・B・C10口ずつ申し込む11223344useModuleuseModuleapproveとsubscribe(10口)approveとsubscribe(10口)円トークンと社債と決済のアドレス円トークンと社債と決済のアドレスCollateralPriceとSecuritiesLoanをデプロイするCollateralPriceとSecuritiesLoanをデプロイするopenBondで締めて社債を渡すopenBondで締めて社債を渡すsetPrice(100000)

デプロイが済むと、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までに済ませる決まりなので、チェーンの時刻を締め切りより前から始めるためです。
書いたデプロイの手順をローカルノードへ出す流れは、補助にまとめてあります。

補助ローカルノードへデプロイする補助のページ

実装

各コースのcontracts/hardhat.config.tsには、ローカルノードのanvilとFujiの2つのネットワークを定義してあります。

import hardhatToolboxViemPlugin from "@nomicfoundation/hardhat-toolbox-viem";
import { configVariable, defineConfig } from "hardhat/config";
import { avalancheFuji } from "viem/chains";

import local from "./local.json" with { type: "json" };

export default defineConfig({
  plugins: [hardhatToolboxViemPlugin],
  solidity: {
    version: "0.8.34",
    settings: {
      // AvalancheのC-Chainが対応するEVMのバージョンに揃える
      evmVersion: "cancun",
    },
  },
  paths: {
    tests: {
      // Solidityのテストは Foundry が回すため、Hardhat は TypeScript のテストだけを回す
      solidity: "test/hardhat-solidity",
    },
  },
  networks: {
    // ローカルノードの anvil
    localhost: {
      type: "http",
      chainType: "l1",
      url: `http://127.0.0.1:${local.chainPort}`,
    },
    // Avalanche の Fuji テストネット。鍵は `pnpm hardhat keystore set FUJI_PRIVATE_KEY` で暗号化して入れる
    fuji: {
      type: "http",
      chainType: "l1",
      chainId: avalancheFuji.id,
      url: avalancheFuji.rpcUrls.default.http[0],
      accounts: [configVariable("FUJI_PRIVATE_KEY")],
    },
  },
});

paths.tests.solidityを存在しないディレクトリにしているのは、Solidityのテストの実行をFoundryに任せ、Hardhatにはtest/のTypeScriptのテストだけを実行させるためです。
ローカルノードのポートとanvilのアカウントはcontracts/local.jsonに書いてあり、画面とpnpm devも同じファイルを読みます。

デプロイの手順はcontracts/ignition/modules/に、コントラクトごとにbuildModuleで書きます。

書き方 意味
buildModule("<名前>Module", (m) => ...) デプロイの手順のまとまりに名前を付ける。
記録には<名前>Module#<コントラクト>という名前でアドレスが残る
m.contract("<コントラクト>", [引数]) コントラクトをデプロイする。
デプロイに使うアカウントは、anvilの最初のアカウント0xf39F…2266になる
m.call(<コントラクト>, "<関数>", [引数]) デプロイした後に、そのコントラクトの関数を呼ぶ

contracts/package.jsonのdeploy:localが、--network localhost --resetを付けてIgnitionでデプロイします。
コースの画面のpnpm devでは、app/scripts/dev.tsがanvilを起動してからpnpm run buildとdeploy:localを実行し、最後に画面を起動します。

確かめる

コースの雛形のappのディレクトリでpnpm devを実行し、anvilから画面までを起動します。

pnpm dev

<名前>Module#<コントラクト> - 0x…の行と、http://localhost:<appPort>の行が出れば、デプロイと画面の起動が済んでいます。
別のターミナルからcastでコントラクトを呼ぶと、ローカルノードにデプロイされたことを確かめられます。

cast code <アドレス> --rpc-url http://127.0.0.1:<chainPort>

0xの後に長い16進の文字列が出れば、そのアドレスにコントラクトのコードがあります。

このコースでは、補助の<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円の価格を読めています。