開発環境と円トークンを用意する
作るもの
このレッスンを終えると、開発環境を起動し、1作目の円トークンをワークスペースの依存として読み込めます。
本人確認済みの投資家3人が100万円ずつ持つ状態も、コマンド1つで作れます。
この円トークンは、このコースで社債の払い込みと利金と償還の支払いに使います。
背景
社債は、会社法が定める会社の借入れです。
会社は社債を投資家へ出して円を受け取り、決めた日に利金を払い、満期に額面を返します。
日本の社債の多くは、社債、株式等の振替に関する法律による振替制度で受け渡します。
持ち主が移る時は、証券保管振替機構(ほふり)の帳簿の記録を書き換えます。
代金の円は、銀行の預金として別の仕組みで動きます。
社債の記録と代金の支払いが別々に動くため、そのままでは片方だけが済んで相手が払わない危険があります。
この危険をなくすため、証券の受け渡しと代金の支払いを同時に行うDvPという決済の仕方を使います。
このコースでは、社債の帳簿をチェーンの上の社債トークンにし、代金には1作目の円トークンを使います。
社債と円が同じチェーンの上にあるため、1つの取引の中で両方を入れ替えられます。
円トークンのコードは1作目の完成版の1か所だけに置き、このコースは写しを持ちません。
写しを作ると、1作目で直した所が2作目に届かなくなるためです。
1作目を終えていない人も、このレッスンの手順で1作目の完成版の円トークンを使えます。
実装
補助の手順で開発環境を起動します。
雛形のディレクトリへ移る
このコースで書き足すのはcourses/digital-bond/starter/の下のファイルです。
完成版はcourses/digital-bond/complete/にあり、迷った時に見比べられます。
courses/digital-bond/starter/
├── contracts/ コントラクト、テスト、デプロイのコマンド (Hardhat と Foundry)
└── app/ 画面 (Next.js)
このコースの画面はポート3402、ローカルノードのanvilはポート8601で開きます。
1作目の3400と8600からずらしてあるため、2つのコースの画面を同時に開けます。
雛形の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/jpy-stablecoin-contractsに1作目の完成版のディレクトリへのリンクを作ります。
コードを写さずにリンクで読むので、1作目を直せば2作目もすぐに同じコードを読みます。
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のERC-20と役割の仕組みを読む |
forge-std/=... |
Foundryのテストの道具を読む |
@handsonchain/jpy-stablecoin-contracts/=... |
1作目の完成版を読む。@handsonchain/jpy-stablecoin-contracts/contracts/JpyToken.solと書くと、リンクを通って1作目のJpyToken.solを開く |
Hardhatは、自分のディレクトリにあるコントラクトの成果物 (ABIとバイトコード) だけを書き出します。
依存のパッケージのコントラクトをデプロイするには、hardhat.config.tsのnpmFilesToBuildに並べて成果物を書き出させます。
npmFilesToBuild: ["@handsonchain/jpy-stablecoin-contracts/contracts/JpyToken.sol"],
この1行で、pnpm run buildは1作目のJpyToken.solもコンパイルし、artifacts/に円トークンの成果物を書き出します。
scripts/export-abi.tsは、その中のABIを画面が読むgenerated/abi.tsへ写します。
ローカルノードへデプロイするレッスンでは、この成果物を使って円トークンをデプロイします。
アカウントを確かめる
contracts/local.jsonは、画面とanvilのポートと、画面で選べるanvilのアカウントを持ちます。
| 名前 | アドレス | このコースでの役 |
|---|---|---|
| 発行体 | 0xf39F…2266 |
社債を出し、払い込まれた円を受け取り、利金と額面を払う |
| 投資家A | 0x7099…79C8 |
円トークンで社債に申し込み、利金と額面を受け取る。 ほかの投資家と社債を売り買いもする |
| 投資家B | 0x3C44…93BC |
投資家Aと同じ |
| 投資家C | 0x90F7…b906 |
投資家Aと同じ |
3人の投資家のアドレスは、1作目のlocal.jsonの3人の利用者と同じです。
そのため、1作目の完成版の手順で本人確認済みになった利用者が、そのままこのコースの投資家になります。
円トークンを用意する
本人確認済みの投資家が円を持つ状態は、1作目の完成版の手順で作ります。
このコマンドは1作目のHardhatの設定を使うため、1作目のポート8600のanvilへデプロイします。
先に別のターミナルでanvil --port 8600を起動してから、補助の手順を進めます。
このコースのポート8601のanvilには、ローカルノードへデプロイするレッスンで、社債トークンと一緒に同じ手順で円トークンを用意します。
確かめる
雛形のコントラクトのディレクトリで、Foundryのコンパイルと読み込む先の対応を表示します。
cd courses/digital-bond/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の行の終わりにjpy-stablecoin-contracts -> ../../../../../jpy-stablecoin/complete/contractsが出れば、依存のディレクトリは1作目の完成版へのリンクです。
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に並べた1作目のJpyToken.solです。
2回目からはコンパイルが済んでいるため、1行目はNo contracts to compileに変わります。