ローカルノードへデプロイする
作るもの
この補助を終えると、ローカルノードのanvilへHardhat Ignitionでコースのコントラクトをデプロイし、デプロイしたアドレスを記録から読めます。
コースの画面のディレクトリでpnpm devを実行すると、anvilの起動からコンパイルとデプロイ、画面の起動までが1つのコマンドで済みます。
背景
銀行は、システムを本番へ出す前に、本番と同じ手順で検証環境へ出して確かめます。
出す時のコマンドを毎回人が手で入力すると、手順の抜けや取り違えが起きるため、手順そのものをコードにして残します。
Hardhat Ignitionは、コントラクトをデプロイする手順を宣言的に書く道具です。
何をどの引数でデプロイするかを書くと、Ignitionがそれを順に実行し、デプロイしたコントラクトのアドレスをignition/deployments/chain-<チェーンID>/に記録します。
コースの画面はこの記録からコントラクトのアドレスを読みます。
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進の文字列が出れば、そのアドレスにコントラクトのコードがあります。