開発環境と円トークンを用意する
作るもの
このレッスンを終えると、開発環境を起動し、1作目の円トークンをワークスペースの依存として読み込めます。
雛形のコントラクトのディレクトリで、FoundryとHardhatのコンパイルが通ります。
このコースでは、円トークンで申し込み、解約の代金も円トークンで受け取るトークン化ファンドを作ります。
背景
投資信託は、多くの投資家から集めたお金を1つにまとめ、運用の専門家が株や債券に投資する金融商品です。
運用で増えた分も減った分も、投資家が持つ持分の大きさに応じて分け合います。
日本の投資信託は、投資信託及び投資法人に関する法律 (投信法) が仕組みを定めています。
よく使われる形では、次の4つの役が分かれて受け持ちます。
| 役 | 今の投資信託で行うこと |
|---|---|
| 委託会社 | 運用会社とも呼ぶ。 運用の方針を決めて、受託会社へ株や債券の売り買いを指図する。 毎営業日に基準価額を計算する |
| 受託会社 | 信託銀行。 ファンドの資産を自分の財産と分けて保管し、委託会社の指図で売り買いする。 基準価額を別に計算し、委託会社の値と突き合わせる |
| 販売会社 | 証券会社や銀行。 投資家の本人確認をし、申込と解約を受け付けて委託会社へ取り次ぐ |
| 投資家 | 円で申し込んで持分を受け取り、解約して代金を受け取る。 受益者とも呼ぶ |
投資家は、販売会社を通して申込と解約の注文を出します。
締め切りまでの注文は、その日の基準価額で約定します。
その日の基準価額は締め切りの後に計算するため、投資家は値段を知らずに注文します。
この決まりをブラインド方式と呼びます。
解約の代金は、約定日から数営業日後の受渡日に受け取ります。
このコースでは、15時を締め切りにし、土日を除いた3営業日後を受渡日にします。
2026-03-05 (木) の15時までに出した解約は、次の日程で代金を受け取れます。
今の仕組みでは、販売会社と委託会社と受託会社がそれぞれ帳簿を持ち、毎日の注文と口数と代金を突き合わせています。
このコースでは、持分も代金の円もチェーンの上のトークンにします。
注文を預かる記録と口数の記録と円の動きが1つのチェーンに残るため、別々の帳簿を突き合わせる手間がなくなります。
持分を持てる人は、1作目の円トークンの許可リストに載った本人確認済みの人に限ります。
このコースでは受託会社の役を置かず、申込の円は約定の時に運用会社へ渡ります。
運用会社は、受け取った円をチェーンの外で運用するものとして扱います。
解約の代金は、運用会社がファンドのコントラクトへ円を入れて払います。
円トークンのコードは、1作目の完成版の1か所だけに置き、このコースは写しを持ちません。
写しを作ると、前のコースで直した所がこのコースに届かなくなるためです。
1作目を終えていない人も、このレッスンの手順で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作目の完成版の手順で作ります。
円トークンの仕組みと、本人確認と発行の手順は、次の補助にまとめてあります。
補助の手順は、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に変わります。
次のレッスンで、このディレクトリにファンドの持分のコントラクトを作ります。