HandsOnChain

開発環境を起動する

作るもの

このレッスンを終えると、Node.jsとpnpmとFoundryが入った開発環境で、円トークンの雛形のコントラクトをコンパイルできます。

背景

このコースでは、円トークンのコントラクトをSolidityで書いてFoundryでテストします。
できたコントラクトはHardhatでデプロイし、Next.jsの画面から操作します。
道具のバージョンを全員で揃えるため、どのコースも同じDockerfileから作った環境で進めます。
環境を起動する手順は、どのコースでも同じなのでコースの補助にまとめてあります。

実装

補助の手順で開発環境を起動します。

補助開発環境を起動する補助のページ

実装

リポジトリをクローンしてルートのディレクトリへ移り、起動の方法を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が出れば、環境は整っています。

雛形のディレクトリへ移る

このコースで書き足すのはcourses/jpy-stablecoin/starter/の下のファイルです。
完成版はcourses/jpy-stablecoin/complete/にあり、迷った時に見比べられます。

courses/jpy-stablecoin/starter/
├── contracts/   コントラクト、テスト、デプロイのコマンド (Hardhat と Foundry)
└── app/         画面 (Next.js)

このコースの画面はポート3400、ローカルノードのanvilはポート8600で開きます。

確かめる

雛形のコントラクトのディレクトリで、Foundryのコンパイルを実行します。

cd courses/jpy-stablecoin/starter/contracts
forge build

次の行が出れば、このコースを始める準備は整っています。

Compiler run successful!