HandsOnChain

開発環境と円トークンを用意する

作るもの

このレッスンを終えると、開発環境を起動し、1作目の円トークンをワークスペースの依存として読み込めます。
雛形のコントラクトのディレクトリで、FoundryとHardhatのコンパイルが通ります。
このコースでは、円トークンで申し込み、解約の代金も円トークンで受け取るトークン化ファンドを作ります。

背景

投資信託は、多くの投資家から集めたお金を1つにまとめ、運用の専門家が株や債券に投資する金融商品です。
運用で増えた分も減った分も、投資家が持つ持分の大きさに応じて分け合います。
日本の投資信託は、投資信託及び投資法人に関する法律 (投信法) が仕組みを定めています。
よく使われる形では、次の4つの役が分かれて受け持ちます。

役 今の投資信託で行うこと
委託会社 運用会社とも呼ぶ。
運用の方針を決めて、受託会社へ株や債券の売り買いを指図する。
毎営業日に基準価額を計算する
受託会社 信託銀行。
ファンドの資産を自分の財産と分けて保管し、委託会社の指図で売り買いする。
基準価額を別に計算し、委託会社の値と突き合わせる
販売会社 証券会社や銀行。
投資家の本人確認をし、申込と解約を受け付けて委託会社へ取り次ぐ
投資家 円で申し込んで持分を受け取り、解約して代金を受け取る。
受益者とも呼ぶ

投資家は、販売会社を通して申込と解約の注文を出します。
締め切りまでの注文は、その日の基準価額で約定します。
その日の基準価額は締め切りの後に計算するため、投資家は値段を知らずに注文します。
この決まりをブラインド方式と呼びます。

解約の代金は、約定日から数営業日後の受渡日に受け取ります。
このコースでは、15時を締め切りにし、土日を除いた3営業日後を受渡日にします。
2026-03-05 (木) の15時までに出した解約は、次の日程で代金を受け取れます。

約定日から受渡日まで
0日0日注文を受け付ける1〜4日1〜4日営業日を数える5日5日代金を受け取る0日1日2日3日4日5日約定日受渡日112233

今の仕組みでは、販売会社と委託会社と受託会社がそれぞれ帳簿を持ち、毎日の注文と口数と代金を突き合わせています。
このコースでは、持分も代金の円もチェーンの上のトークンにします。
注文を預かる記録と口数の記録と円の動きが1つのチェーンに残るため、別々の帳簿を突き合わせる手間がなくなります。
持分を持てる人は、1作目の円トークンの許可リストに載った本人確認済みの人に限ります。

このコースでは受託会社の役を置かず、申込の円は約定の時に運用会社へ渡ります。
運用会社は、受け取った円をチェーンの外で運用するものとして扱います。
解約の代金は、運用会社がファンドのコントラクトへ円を入れて払います。

円トークンのコードは、1作目の完成版の1か所だけに置き、このコースは写しを持ちません。
写しを作ると、前のコースで直した所がこのコースに届かなくなるためです。
1作目を終えていない人も、このレッスンの手順で1作目の完成版を使えます。

実装

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

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

実装

リポジトリをクローンしてルートのディレクトリへ移り、起動の方法を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/tokenized-fund/starter/の下のファイルです。
完成版はcourses/tokenized-fund/complete/にあり、迷った時に見比べられます。

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

このコースの画面はポート3404、ローカルノードのanvilはポート8603で開きます。
前の3つのコースの画面は3400と3402と3403、anvilは8600から8602までを使い、教材サイトは3401を使います。
どれとも重ならないので、どのコースの画面も同時に開けます。

雛形のcontracts/には、まだコントラクトもテストもありません。
次のレッスンからcontracts/contracts/とcontracts/test/に書き足していきます。

円トークンを依存として読み込む

雛形のcontracts/package.jsonは、1作目の完成版のコントラクトのパッケージを依存に持ちます。

  "dependencies": {
    "@handsonchain/jpy-stablecoin-contracts": "workspace:*"
  },
行 意味
@handsonchain/jpy-stablecoin-contracts 1作目の完成版のcourses/jpy-stablecoin/complete/contracts/package.jsonが名乗るパッケージの名前。
円トークンを持つ
workspace:* npmから取らずに、同じリポジトリのワークスペースにあるパッケージを使う。
版は問わない

リポジトリのルートのpnpm-workspace.yamlは、courses/*/complete/*とcourses/*/starter/*をワークスペースに並べています。
pnpm installを実行すると、pnpmはstarter/contracts/node_modules/@handsonchain/の下に、1作目の完成版のディレクトリへのリンクを作ります。
コードを写さずにリンクで読むので、1作目を直せば、このコースもすぐに同じコードを読みます。

Foundryには、foundry.tomlのremappingsで読み込む名前と置き場の対応を教えます。

remappings = [
  "@openzeppelin/contracts/=node_modules/@openzeppelin/contracts/",
  "forge-std/=node_modules/forge-std/src/",
  "@handsonchain/jpy-stablecoin-contracts/=node_modules/@handsonchain/jpy-stablecoin-contracts/",
]
行 意味
@openzeppelin/contracts/=... OpenZeppelin Contractsのトークンの型と役割の仕組みを読む
forge-std/=... Foundryのテストの道具を読む
@handsonchain/jpy-stablecoin-contracts/=... 1作目の完成版を読む。
@handsonchain/jpy-stablecoin-contracts/contracts/JpyToken.solと書くと、リンクを通って1作目のJpyToken.solを開く

Hardhatは、自分のディレクトリにあるコントラクトの成果物 (ABIとバイトコード) だけを書き出します。
依存のパッケージのコントラクトをデプロイするには、hardhat.config.tsのnpmFilesToBuildに並べて成果物を書き出させます。

    // 1作目の円トークンは写さず、ワークスペースの依存からビルドしてIgnitionで一緒にデプロイする
    npmFilesToBuild: ["@handsonchain/jpy-stablecoin-contracts/contracts/JpyToken.sol"],
行 意味
JpyToken.sol 1作目の円トークン。
申込に払う円と、解約の代金に受け取る円に使う

この1行で、pnpm run buildは1作目の円トークンもコンパイルし、artifacts/に成果物を書き出します。
scripts/export-abi.tsは、その中のABIを画面が読むgenerated/abi.tsへ写します。

const names = {
  jpyTokenAbi: "JpyToken",
  tokenizedFundAbi: "TokenizedFund",
};
行 意味
jpyTokenAbi: "JpyToken" 円トークンのABIをjpyTokenAbiの名前で書き出す
tokenizedFundAbi: "TokenizedFund" 次のレッスンから作るファンドのABIをtokenizedFundAbiの名前で書き出す

export-abi.tsは、成果物があるコントラクトだけを写します。
ファンドのコントラクトはまだないため、このレッスンで書き出すABIは円トークンの1つです。

アカウントを確かめる

contracts/local.jsonは、画面とanvilのポートと、画面で選べるanvilのアカウントを持ちます。

名前 アドレス このコースでの役
投資家A 0x7099…79C8 円で申し込んで持分を受け取り、口数で解約する
投資家B 0x3C44…93BC 投資家Aと同じ
投資家C 0x90F7…b906 投資家Aと同じ
運用会社 0x15d3…6A65 約定日の純資産の総額を入れ、注文を約定する。
解約の代金を入れる

3人の投資家のアドレスは、1作目の3人の利用者と同じです。
1作目の手順で本人確認済みになって円を受け取った利用者が、そのままこのコースの投資家になります。
local.jsonに載っていないanvilの最初のアカウント (0xf39F…2266) は、デプロイに使うアカウントです。
円トークンの発行体を兼ね、ファンドの役割を渡し直せる管理の役割も持ちます。

円トークンを用意する

投資家が円トークンを持つ状態は、1作目の完成版の手順で作ります。
円トークンの仕組みと、本人確認と発行の手順は、次の補助にまとめてあります。

補助円トークンを用意する補助のページ

実装

リポジトリのルートで次のコマンドを1つ実行します。
ローカルノードのanvilが動いていない時は、先に別のターミナルで起動しておきます。

pnpm jpy-token:local

このコマンドは、1作目の完成版のignition/modules/JpyTokenReady.tsをIgnitionで実行し、次の3つを順に行います。

順 行うこと
1 円トークンをデプロイする。
デプロイしたanvilの最初のアカウントが発行体の全ての役割を持つ
2 contracts/local.jsonの利用者のアカウントを、setAllowedで本人確認済みにする
3 利用者のアカウントへ、issueで100万円ずつ発行する

後のコースのpnpm devが円トークンを一緒にデプロイする時は、このコマンドを別に実行しなくても済みます。

確かめる

JpyTokenModule#JpyToken - 0x…の行が出た後に、castで利用者Aの残高を読みます。

cast call <円トークンのアドレス> "balanceOf(address)(uint256)" 0x70997970C51812dc3A010C7d01b50e0d17dc79C8 --rpc-url http://127.0.0.1:8600

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

補助の手順は、local.jsonの利用者3人を本人確認済みにして、100万円ずつ発行します。
利用者3人のアドレスはこのコースの投資家A・B・Cと同じなので、投資家3人が100万円ずつ持つ状態になります。
補助のコマンドは1作目のHardhatの設定を使うため、1作目のポート8600のanvilへデプロイします。
このコースのポート8603のanvilには、ローカルノードへデプロイするレッスンで、ファンドと一緒に同じ手順で円トークンを用意します。

確かめる

雛形のコントラクトのディレクトリで、Foundryのコンパイルと読み込む先の対応を表示します。

cd courses/tokenized-fund/starter/contracts
forge build
forge remappings

contracts/にまだコントラクトがないので、forge buildはNothing to compileの1行だけを出します。
エラーが出なければ、foundry.tomlの設定は読めています。
forge remappingsの出力に次の行があれば、Solidityから1作目の円トークンを読み込めます。

@handsonchain/jpy-stablecoin-contracts/=node_modules/@handsonchain/jpy-stablecoin-contracts/

続けて、ワークスペースの依存のリンクとHardhatのコンパイルを確かめます。

ls -l node_modules/@handsonchain/
pnpm run build

ls -lの出力に次のリンクが出れば、依存のディレクトリは1作目の完成版を指しています。

jpy-stablecoin-contracts -> ../../../../../jpy-stablecoin/complete/contracts

pnpm run buildは次の2行を出します。

Compiled 1 Solidity file with solc 0.8.34 (evm target: cancun)
export-abi: generated/abi.ts に1つのABIを書いた

コンパイルした1つのファイルは、npmFilesToBuildに並べた円トークンです。
2回目からはコンパイルが済んでいるため、1行目はNo contracts to compileに変わります。
次のレッスンで、このディレクトリにファンドの持分のコントラクトを作ります。