HandsOnChain
補助

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

作るもの

この補助を終えると、ローカルノードのanvilへHardhat Ignitionでコースのコントラクトをデプロイし、デプロイしたアドレスを記録から読めます。
コースの画面のディレクトリでpnpm devを実行すると、anvilの起動からコンパイルとデプロイ、画面の起動までが1つのコマンドで済みます。

背景

銀行は、システムを本番へ出す前に、本番と同じ手順で検証環境へ出して確かめます。
出す時のコマンドを毎回人が手で入力すると、手順の抜けや取り違えが起きるため、手順そのものをコードにして残します。

Hardhat Ignitionは、コントラクトをデプロイする手順を宣言的に書く道具です。
何をどの引数でデプロイするかを書くと、Ignitionがそれを順に実行し、デプロイしたコントラクトのアドレスをignition/deployments/chain-<チェーンID>/に記録します。
コースの画面はこの記録からコントラクトのアドレスを読みます。

pnpm devが1つのコマンドで行うこと
pnpm devapp/scripts/dev.tsanvilローカルノードHardhatコンパイルとデプロイ画面コースの画面のNext.js112233anvil --port <chainPort>anvil --port <chainPort>pnpm run build、deploy:localpnpm run build、deploy:localコントラクトをデプロイするコントラクトをデプロイするデプロイしたアドレスデプロイしたアドレスnext dev --port <appPort>

anvilは起動するたびに空のチェーンから始まるため、deploy:localは--resetを付けて前の記録を消してからデプロイします。

実装

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

この補助を使うレッスン