ローカルノードへデプロイする
作るもの
このレッスンを終えると、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時の締め切りの前の注文と後の注文を、同じ日のうちに試せます。
次の日の金曜を過ぎると土日が来るため、約定日が次の営業日へ移る様子も数日の時計の進みで確かめられます。
デプロイが済むと、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の時計を進めるスクリプトを実行する |
書いたデプロイの手順をローカルノードへ出す流れは、補助にまとめてあります。
このコースでは、補助の<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円です。
画面の中身は次のレッスンで作ります。