HandsOnChain

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

作るもの

このレッスンを終えると、Hardhat Ignitionで円トークンをローカルノードのanvilへデプロイし、デプロイしたアカウントが100万円分を持つことをHardhatのテストで確かめられます。
画面のディレクトリでpnpm devを実行すると、anvilの起動からコンパイルとデプロイ、画面の起動までが1つのコマンドで済みます。

背景

円トークンを画面から操作するには、まずチェーンの上に円トークンのコントラクトを置きます。
このレッスンでは、本番と同じ手順で何度でも出せるよう、デプロイの手順をHardhat Ignitionのコードにして残します。
Ignitionの考え方とHardhatの設定は、どのコースでも同じなのでコースの補助にまとめてあります。

pnpm devが1つのコマンドで行うこと
pnpm devapp/scripts/dev.tsanvilポート8600のローカルノードHardhatコンパイルとデプロイ画面ポート3400のNext.js112233anvil --port 8600anvil --port 8600pnpm run build、deploy:localpnpm run build、deploy:localJpyTokenをデプロイするJpyTokenをデプロイするアドレス0x5FbD…アドレス0x5FbD…next dev --port 3400

実装

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

import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";

// デプロイする人のアカウントから円トークンをデプロイする。最初の100万円分はデプロイしたアカウントが持つ
export default buildModule("JpyTokenModule", (m) => {
  const token = m.contract("JpyToken");
  return { token };
});
行 意味
buildModule("JpyTokenModule", ...) 円トークンをデプロイする手順のまとまり。
記録にはJpyTokenModule#JpyTokenという名前でアドレスが残る
m.contract("JpyToken") JpyTokenをデプロイする。
デプロイに使うのはanvilの最初のアカウント0xf39F…2266になる

デプロイの結果を確かめるHardhatのテストをstarter/contracts/test/deploy.test.tsに作ります。
FoundryのテストはSolidityで書き、HardhatのテストはTypeScriptで書きます。
画面と同じTypeScriptで、デプロイの手順そのものを確かめられます。

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

import { network } from "hardhat";

import JpyTokenModule from "../ignition/modules/JpyToken.js";

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

  it("ignition-deploys-token", async function () {
    const { token } = await ignition.deploy(JpyTokenModule);
    assert.equal(await token.read.symbol(), "HJPY");

    const [deployer] = await viem.getWalletClients();
    assert.equal(await token.read.balanceOf([deployer.account.address]), 1_000_000n * 10n ** 18n);
  });
});
行 意味
network.create() テストのたびに、Hardhatの中で空のチェーンを作る
ignition.deploy(JpyTokenModule) 本番と同じIgnitionの手順で、そのチェーンへデプロイする
token.read.symbol() viemで、コントラクトの読み取り用の関数を呼ぶ
1_000_000n * 10n ** 18n 100万円を18桁の単位にした値。
TypeScriptでは大きな整数をnの付いたbigintで書く

書いたデプロイの手順をローカルノードへ出す流れは、補助にまとめてあります。
Hardhatの設定とpnpm devの中身は、雛形に最初から入っています。

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

実装

各コースの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進の文字列が出れば、そのアドレスにコントラクトのコードがあります。

確かめる

starter/contractsのディレクトリで、Hardhatのテストを実行します。

pnpm run build
pnpm run test:hardhat

次の行が出れば、デプロイの手順は正しく動いています。

  JpyTokenModule
    ✔ ignition-deploys-token

補助の確かめ方でstarter/appのpnpm devを起動すると、JpyTokenModule#JpyToken - 0x5FbDB2315678afecb367f032d93F642f64180aa3の行とhttp://localhost:3400の行が出ます。
画面の中身は次のレッスンで作ります。
ここでは別のターミナルからcastで残高を読み、デプロイしたアカウントが100万円分を持つことを確かめます。

cast call 0x5FbDB2315678afecb367f032d93F642f64180aa3 "balanceOf(address)(uint256)" 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --rpc-url http://127.0.0.1:8600

1000000000000000000000000 [1e24]と出れば、100万円分が18桁の単位で入っています。