HandsOnChain
補助

開発環境を起動する

作るもの

この補助を終えると、Node.jsとpnpmとFoundryが入った開発環境を1つのコマンドで起動できます。
起動の方法は2つあり、Visual Studio CodeのDev ContainerとDocker Composeのどちらを使っても同じ環境になります。
自分のPCに道具を直接入れたい人は、「自分のPCに直接入れる」の手順でも進められます。
どのコースも、この環境で始めます。

背景

銀行や証券会社は、本番と同じ構成の検証環境でシステムを確かめてから本番へ出します。
開発者ごとに道具のバージョンが違うと、ある人の環境では動くのに別の人の環境では動かないことが起き、検証の結果を信用できなくなるためです。

HandsOnChainも同じ考え方で、全員が同じDockerfileから作った環境で進めます。
DockerfileはNode.js 24、pnpm 10.33.2、Foundry 1.5.1を入れます。
コントラクトを動かすチェーンも、最初はローカルノードのanvilにします。
anvilは外のネットワークにつながずに動き、残高の入ったアカウントを最初から10個持つため、本物のお金を使わずに何度でもやり直せます。

道具 役割
Foundry Solidityでコントラクトのテストを書いて実行する。
anvilとcastも入っている
Hardhat コントラクトをデプロイするコマンドと、デプロイの結果を確かめるTypeScriptのテスト
Next.js 利用者と発行体が操作するコースの画面

実装

リポジトリをクローンしてルートのディレクトリへ移り、起動の方法を1つ選びます。

git clone https://github.com/cardene777/HandsOnChain.git
cd HandsOnChain

Dev Containerで起動する

Visual Studio CodeにDev Containersの拡張機能を入れ、リポジトリのディレクトリを開きます。
左下の><を押し、「コンテナーで再度開く」を選びます。
.devcontainer/devcontainer.jsonは、リポジトリのルートのDockerfileで環境を作り、最後にpnpm installを実行する設定です。
forwardPortsには、各コースの画面とanvilと教材サイトのポートが並び、コンテナの中で開いたポートをPCのブラウザから開けます。

Docker Composeで起動する

Dockerが動いているPCなら、リポジトリのルートで次のコマンドを1つ実行します。

docker compose up

compose.yamlは、同じDockerfileで環境を作り、pnpm installの後にコースの完成版の画面と教材サイトを起動する設定です。
先に完成版を一度動かし、最後に何ができあがるかを見ておくと、各レッスンの位置づけが分かりやすくなります。
止める時はCtrl+Cを押します。

自分のPCに直接入れる

コンテナを使わない時は、Node.js 24とpnpmとFoundryを入れてから、リポジトリのルートで依存パッケージを入れます。

pnpm install

確かめる

開いた環境のターミナルで、3つの道具のバージョンを表示します。

node --version
pnpm --version
anvil --version

Node.jsはv24で始まるバージョン、pnpmは10.33.2が出ます。
anvilはanvil Version: 1.5.1が出れば、環境は整っています。

この補助を使うレッスン