HandsOnChain

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

作るもの

このレッスンを終えると、Hardhat Ignitionで円トークンとファンドを一緒にローカルノードのanvilへデプロイできます。
デプロイの後には、投資家3人が円トークンを100万円ずつ持ち、運用会社は解約の代金に充てる1,000万円を持ちます。
anvilの時計は2026-03-05 (木) の10時 (日本時間) へ進み、平日の締め切りの前から試せます。
ファンドが円トークンのアドレスと運用会社の役割を持つことは、Hardhatのテストで確かめられます。

背景

ファンドを画面で試すには、本人確認済みの投資家が円を持ち、ファンドが申込の円を受け取れる状態が要ります。
投資家が円を持つまでには、1作目の円トークンをデプロイし、投資家を許可リストに載せて発行する手順を踏みます。
この手順を4作目に書き写すと、1作目の決まりと食い違うおそれがあります。
そこでこのレッスンでは、1作目の完成版が持つ円トークンを用意する手順をそのまま呼び出し、その後にファンドをデプロイします。

ファンドのコントラクトも許可リストに載せます。
後の節で、投資家から申込の円を預かるためです。
運用会社も許可リストに載せ、円トークンを1,000万円持たせます。
このコースでは、解約の代金は運用会社がファンドへ円を入れて払うためです。

Ignitionは決めた順に取引を送る道具で、チェーンの時計を進める操作は持ちません。
そこで時計を進める所は、hardhat runで実行するスクリプトに分けます。
2026-03-05 (木) の10時から始めると、15時の締め切りの前の注文と後の注文を、同じ日のうちに試せます。
次の日の金曜を過ぎると土日が来るため、約定日が次の営業日へ移る様子も数日の時計の進みで確かめられます。

deploy:localが円トークンとファンドを用意する順
チェーンに残る値投資家の円1,000,000円ずつ運用会社の円0円10,000,000円anvilの時計2026-01-012026-03-05 10:00TokenizedFundModuleignition/modules/TokenizedFund.tsJpyTokenReadyModule1作目の完成版の手順ファンドTokenizedFund運用会社解約の代金を払うopen-local.tshardhat runで実行する11223344useModuleuseModule円トークンのアドレス円トークンのアドレスTokenizedFundをデプロイするTokenizedFundをデプロイするsetAllowed と issuesetAllowed と issuesetNextBlockTimestamp と mine

デプロイが済むと、local.jsonのアカウントとファンドは次の状態になります。

アカウント デプロイの後に持つもの
anvilの最初のアカウント0xf39F…2266 円トークンの発行体の役割と、ファンドの管理者の役割DEFAULT_ADMIN_ROLE
投資家A・B・C 円トークン1,000,000円ずつ。
許可リストに載っている
運用会社 円トークン10,000,000円と、純資産を入れるMANAGER_ROLE
ファンドのコントラクト 許可リストに載っている。
まだ口数も円も持たない

実装

starter/contracts/ignition/modules/TokenizedFund.tsを新しく作ります。

import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";
import { keccak256, toHex } from "viem";

import JpyTokenReadyModule from "@handsonchain/jpy-stablecoin-contracts/ignition/modules/JpyTokenReady.js";

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

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}`;
}

// 1作目の手順で円トークンをデプロイして投資家3人に100万円ずつ発行し、ファンドを一緒にデプロイする
export default buildModule("TokenizedFundModule", (m) => {
  const { token: jpy } = m.useModule(JpyTokenReadyModule);
  const manager = accountOf("manager");
  const fund = m.contract("TokenizedFund", [jpy, manager]);
  // ファンドのコントラクトは申込の円と解約の代金を預かるので、円トークンの許可リストに載せる
  m.call(jpy, "setAllowed", [fund, true], { id: "allow_fund" });
  // 運用会社を許可リストに載せ、解約の代金に充てる1,000万円を渡す
  const allowManager = m.call(jpy, "setAllowed", [manager, true], { id: "allow_manager" });
  m.call(jpy, "issue", [manager, 10_000_000n * 10n ** 18n, keccak256(toHex("fund-manager"))], { id: "issue_manager", after: [allowManager] });
  return { jpy, fund };
});
行 意味
import JpyTokenReadyModule from "@handsonchain/..." 1作目の完成版のignition/modules/JpyTokenReady.tsを、ワークスペースの依存から読み込む
accountOf(role) local.jsonから役のアカウントを探す。
見つからない時はデプロイを止める
m.useModule(JpyTokenReadyModule) 1作目の手順を、このモジュールの一部として実行する。
戻り値のtokenをjpyの名前で受け取る
m.contract("TokenizedFund", [jpy, manager]) 円トークンと運用会社のアドレスを渡してファンドをデプロイする。
デプロイしたanvilの最初のアカウントがDEFAULT_ADMIN_ROLEを持つ
{ id: "allow_fund" } 同じ関数を2回以上呼ぶ時は、Ignitionの記録で見分ける名前を付ける
after: [allowManager] 運用会社を許可リストに載せた後に、1,000万円を発行する。
許可リストに載る前の発行は円トークンが拒む
keccak256(toHex("fund-manager")) 発行の元になった入金を見分ける参照の値。
1作目のissueが3つ目の引数で受け取る

JpyTokenReadyModuleの中では、1作目のJpyTokenModuleが円トークンをデプロイします。
その後に1作目のlocal.jsonの利用者3人を許可リストに載せ、100万円ずつ発行します。
1作目の利用者のアドレスはこのコースの投資家A・B・Cと同じなので、投資家3人が100万円ずつ持つ状態になります。

次に、デプロイの後にanvilの時計を進めるstarter/contracts/scripts/open-local.tsを作ります。

// ローカルノードへデプロイした後に、anvilの時計を2026-03-05 (木) の10時 (日本時間) へ進める。
// 2026-01-01から立ち上げたanvilのまま、締め切りと営業日を試せる平日の朝から始めるため。
//
// 使い方
//   pnpm run deploy:local   (Ignitionのデプロイの後に hardhat run が実行する)
import { network } from "hardhat";

// 2026-03-05 (木) の10時 (日本時間)
const START = 1772672400n;

const { viem } = await network.create();
const publicClient = await viem.getPublicClient();
const testClient = await viem.getTestClient();
const { timestamp } = await publicClient.getBlock();
if (timestamp < START) {
  await testClient.setNextBlockTimestamp({ timestamp: START });
  await testClient.mine({ blocks: 1 });
}
process.stdout.write("anvilの時計を2026-03-05 (木) の10時 (日本時間) へ進めました\n");
行 意味
START = 1772672400n 2026-03-05 (木) の10時 (日本時間) のUnix時刻。
協定世界時では同じ日の1時
network.create() --network localhostで渡したanvilへつなぐ道具を作る
publicClient.getBlock() 最新のブロックを読み、その時刻をtimestampで受け取る
if (timestamp < START) 時計が10時より前の時だけ進める。
anvilの時計は戻せないため、過ぎた時は何もしない
setNextBlockTimestamp({ timestamp: START }) 次に作るブロックの時刻を、2026-03-05の10時にする
mine({ blocks: 1 }) ブロックを1つ作り、チェーンの時刻を進める

setNextBlockTimestampとmineはanvilが持つテスト用の操作で、取引に署名しないため鍵は要りません。
--network localhostを付けたhardhat runは、hardhat.config.tsのlocalhostのネットワークへつなぎます。
そのため、ポート8603のanvilの時計が進みます。

デプロイの結果を確かめるHardhatのテストをstarter/contracts/test/deploy.test.tsに作ります。

import assert from "node:assert/strict";
import { describe, it } from "node:test";

import { network } from "hardhat";

import TokenizedFundModule from "../ignition/modules/TokenizedFund.js";
import local from "../local.json" with { type: "json" };

describe("TokenizedFundModule", async function () {
  const { ignition } = await network.create();

  it("ignition-deploys-fund-with-jpy", async function () {
    const { jpy, fund } = await ignition.deploy(TokenizedFundModule);
    // ファンドは1作目の円トークンのアドレスを持つ
    assert.equal((await fund.read.jpy()).toLowerCase(), jpy.address.toLowerCase());
    // 運用会社は local.json の運用会社で、純資産を入れる役を持つ
    const manager = local.accounts.find((account) => account.role === "manager")?.address as `0x${string}`;
    assert.equal((await fund.read.manager()).toLowerCase(), manager.toLowerCase());
    assert.equal(await fund.read.hasRole([await fund.read.MANAGER_ROLE(), manager]), true);
    // ファンドと運用会社は円トークンの許可リストに載り、運用会社は解約の代金に充てる1,000万円を持つ
    assert.equal(await jpy.read.isAllowed([fund.address]), true);
    assert.equal(await jpy.read.balanceOf([manager]), 10_000_000n * 10n ** 18n);
    // 投資家3人は100万円ずつ持つ
    for (const investor of local.accounts.filter((account) => account.role === "investor")) {
      assert.equal(await jpy.read.balanceOf([investor.address as `0x${string}`]), 1_000_000n * 10n ** 18n);
    }
  });
});
行 意味
network.create() Hardhatの中で動くテストのチェーンを作る。
anvilを起動しなくても回る
ignition.deploy(TokenizedFundModule) deploy:localと同じIgnitionの手順で、円トークンとファンドをデプロイする
fund.read.jpy() ファンドが持つ円トークンのアドレスを読み、デプロイしたアドレスと比べる。
大文字と小文字の違いは除く
fund.read.manager() ファンドの運用会社がlocal.jsonの運用会社かを確かめる
fund.read.hasRole([...]) 運用会社が、純資産を入れるMANAGER_ROLEを持つかを確かめる
jpy.read.isAllowed([fund.address]) ファンドのコントラクトが円トークンの許可リストに載ったかを確かめる
jpy.read.balanceOf([manager]) 運用会社に1,000万円が18桁の単位で入ったかを確かめる
for (const investor of ...) local.jsonの投資家3人が、1作目の手順で100万円ずつ受け取ったかを確かめる

このテストはignition.deployだけを実行し、open-local.tsは実行しません。
時計を進める所はファンドの決まりに関わらないので、ここではファンドが正しい相手を指しているかに絞ります。

雛形のcontracts/package.jsonのdeploy:localは、最初からこのモジュールとスクリプトを名指しています。

    "deploy:local": "hardhat ignition deploy ignition/modules/TokenizedFund.ts --network localhost --reset && hardhat run scripts/open-local.ts --network localhost",
部分 意味
hardhat ignition deploy ... --reset 前のデプロイの記録を消してから、円トークンとファンドをデプロイする
&& hardhat run scripts/open-local.ts デプロイが通った時だけ、anvilの時計を進めるスクリプトを実行する

書いたデプロイの手順をローカルノードへ出す流れは、補助にまとめてあります。

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

実装

各コースの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>が8603、<appPort>が3404になります。
補助のpnpm devは、starter/appのディレクトリで実行すると、anvilの起動からdeploy:localと画面の起動までを続けて行います。
リポジトリのルートのpnpm dev:tokenized-fundは完成版の画面を開くコマンドで、同じポートを使います。
雛形を動かす間は、完成版を止めておきます。

確かめる

starter/contractsのディレクトリで、コンパイルとHardhatのテストを実行します。

pnpm run build
pnpm exec hardhat test nodejs

pnpm run buildはexport-abi: generated/abi.ts に2つのABIを書いたの行を出し、円トークンとファンドのABIを書き出します。
次の行が出れば、デプロイの手順は正しく動いています。

  TokenizedFundModule
    ✔ ignition-deploys-fund-with-jpy

続けて、ローカルノードへデプロイします。
別のターミナルで、2026-01-01の0時 (日本時間) から始まるanvilをポート8603で起動します。

anvil --port 8603 --timestamp 1767193200

starter/contractsのディレクトリに戻って、deploy:localを実行します。

pnpm run deploy:local

Ignitionの取引の一覧の後に、次の行が出ます。

Deployed Addresses

JpyTokenModule#JpyToken - 0x5FbDB2315678afecb367f032d93F642f64180aa3
TokenizedFundModule#TokenizedFund - 0xDc64a140Aa3E981100a9becA4E685f962f0cF6C9


anvilの時計を2026-03-05 (木) の10時 (日本時間) へ進めました

起動したばかりのanvilでは、デプロイのアカウントと取引の順が毎回同じなので、アドレスも同じになります。
前に別のデプロイをしたanvilでは違うアドレスになるため、次のコマンドには一覧の行のアドレスを写します。

cast block latest --field timestamp --rpc-url http://127.0.0.1:8603
cast call <円トークンのアドレス> "balanceOf(address)(uint256)" 0x15d34AAf54267DB7D7c367839AAf71A00a2C6A65 --rpc-url http://127.0.0.1:8603
cast call <ファンドのアドレス> "navFor(uint256)(uint256)" 0 --rpc-url http://127.0.0.1:8603

次の3行が出れば、デプロイと時計の進みが済んでいます。

1772672400
10000000000000000000000000 [1e25]
10000 [1e4]

1行目は最新のブロックの時刻で、2026-03-05 (木) の10時 (日本時間) です。
2行目は運用会社の円で、1,000万円が18桁の単位で入っています。
3行目は口数が0の時の基準価額で、1万口あたり10,000円です。
画面の中身は次のレッスンで作ります。