HandsOnChain

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

作るもの

このレッスンを終えると、Hardhat Ignitionで円トークンと社債トークンを一緒にローカルノードのanvilへデプロイできます。
社債トークンが円トークンのアドレスを持つことは、Hardhatのテストで確かめられます。
starter/appのディレクトリでpnpm devを実行すれば、anvilの起動から画面の起動までをコマンド1つで行えます。

背景

社債トークンは、円トークンの名簿を読みます。
そのため、社債トークンをデプロイする前に円トークンがチェーンの上にあり、投資家が本人確認済みになっている必要があります。
円トークンの用意の仕方を2つのコースで別々に書くと、手順が食い違うおそれがあります。
このレッスンでは、1作目の完成版のデプロイの手順をそのまま呼び出し、その後に社債トークンをデプロイします。

DigitalBondModuleがデプロイする順
DigitalBondModuleignition/modules/DigitalBond.tsJpyTokenReadyModule1作目の完成版の手順円トークンJpyToken社債トークンBondToken112233useModuleuseModuleJpyTokenをデプロイするJpyTokenをデプロイする円トークンのアドレス円トークンのアドレスBondToken(円トークン、発行体、社債の条件)BondToken(円トークン、発行体、社債の条件)setAllowed(投資家A〜C、true)setAllowed(投資家A〜C、true)issue(投資家A〜C、100万円)

実装

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

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

実装

各コースの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>が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桁の単位で入っています。