HandsOnChain

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

作るもの

このレッスンを終えると、開発環境を起動し、1作目の円トークンと2作目の社債トークンをワークスペースの依存として読み込めます。
本人確認済みの借り手3人が社債を10口ずつ持つ状態も、コマンド1つで作れます。
このコースでは、この社債トークンを担保に預けて円トークンを借りる証券担保ローンを作ります。

背景

証券担保ローンは、持っている株や社債を売らずに担保として預け、お金を借りる仕組みです。
借り手は社債を持ち続けたまま円を用意でき、利金も受け取り続けられます。
貸し手は、返してもらえない時に担保を売って、貸したお金に充てられます。

貸せる額は、担保の評価額に掛け目を掛けた額までです。
担保の価格は、評価会社が決めて知らせます。
価格が下がって担保維持率が決めた水準を下回ると、貸し手は借り手へ追加担保を求めます。
借り手が応じない時は、貸し手の側が担保を売って回収します。
この売却を強制売却と呼び、このコースでは担保の処分と呼びます。

役 このコースでの役目
借り手 2作目の社債を担保に預けて円を借り、利息を付けて返す
貸し手 銀行。
借り手へ貸す円をローンのコントラクトへ入れる
評価会社 社債1口の価格を入れる。
ローンのコントラクトはこの価格で担保の評価額を出す

担保の社債と貸した円が別々の仕組みにあると、担保を売って回収する時に、社債の受け渡しと円の支払いを突き合わせる手間が残ります。
片方だけが済んで相手が払わない危険もあります。
このコースでは、担保の社債も借りる円もチェーンの上のトークンにします。
担保の預け入れも貸し出しも担保の処分も、それぞれ1つの取引の中で行えます。
そのため、担保と円の記録がずれません。

担保に使う社債は、2作目で作った社債と同じ条件です。
ローンの返済の期限は、社債の満期より前の2026-12-15に置きます。
満期を過ぎると担保の社債が償還されて消えるため、その前に返してもらいます。

担保の社債とローンの日程
0〜11か月0〜11か月借りられる期間11〜12か月11〜12か月返済の期限から満期まで0か月5か月10か月12か月払込日1回目の利払い日返済の期限満期112233

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

実装

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

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

実装

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

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

このコースの画面はポート3403、ローカルノードのanvilはポート8602で開きます。
1作目の3400と8600、2作目の3402と8601、教材サイトの3401とは重ならないポートです。
そのため、どのコースの画面も同時に開けます。
雛形のcontracts/には、まだコントラクトもテストもありません。
次のレッスンからcontracts/contracts/とcontracts/test/に書き足していきます。

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

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

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

リポジトリのルートのpnpm-workspace.yamlは、courses/*/complete/*とcourses/*/starter/*をワークスペースに並べています。
pnpm installを実行すると、pnpmはstarter/contracts/node_modules/@handsonchain/の下に、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/",
  "@handsonchain/digital-bond-contracts/=node_modules/@handsonchain/digital-bond-contracts/",
]
行 意味
@openzeppelin/contracts/=... OpenZeppelin Contractsの役割の仕組みと、安全に型を縮める道具を読む
forge-std/=... Foundryのテストの道具を読む
@handsonchain/jpy-stablecoin-contracts/=... 1作目の完成版を読む。
@handsonchain/jpy-stablecoin-contracts/contracts/JpyToken.solと書くと、リンクを通って1作目のJpyToken.solを開く
@handsonchain/digital-bond-contracts/=... 2作目の完成版を読む。
社債トークンのBondToken.solと、決済のBondSettlement.solを開ける

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

    npmFilesToBuild: [
      "@handsonchain/jpy-stablecoin-contracts/contracts/JpyToken.sol",
      "@handsonchain/digital-bond-contracts/contracts/BondToken.sol",
      "@handsonchain/digital-bond-contracts/contracts/BondSettlement.sol",
    ],
行 意味
JpyToken.sol 1作目の円トークン。
借りる円と返す円に使う
BondToken.sol 2作目の社債トークン。
借り手が担保に預ける
BondSettlement.sol 2作目の決済のコントラクト。
社債を発行し、利金を払う。
担保の社債の利金を受け取るレッスンで使う

この3行で、pnpm run buildは1作目と2作目のコントラクトもコンパイルし、artifacts/に成果物を書き出します。
scripts/export-abi.tsは、その中のABIを画面が読むgenerated/abi.tsへ写します。
export-abi.tsは、このコースで作る価格とローンのコントラクトの名前も並べていて、成果物があるものだけを写します。

アカウントを確かめる

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

名前 アドレス このコースでの役
借り手A 0x7099…79C8 社債を担保に預けて円を借り、返す
借り手B 0x3C44…93BC 借り手Aと同じ
借り手C 0x90F7…b906 借り手Aと同じ
銀行 0x15d3…6A65 貸し手。
借り手へ貸す円を入れる
評価会社 0x9965…A4dc 社債1口の価格を入れる

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

円トークンと社債トークンを用意する

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

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

実装

リポジトリのルートで次のコマンドを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桁の単位で入っています。

社債トークンを用意する手順は、円トークンも一緒にデプロイし、借り手3人へ社債を10口ずつ渡します。
このコマンドは2作目のHardhatの設定を使うため、2作目のポート8601のanvilへデプロイします。
社債の申込の締め切りが2026-01-14なので、anvilは--timestamp 1767193200を付けて2026-01-01から起動しておきます。

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

実装

ローカルノードのanvilを、2作目のポートで2026-01-01から立ち上げておきます。

anvil --port 8601 --timestamp 1767193200

別のターミナルで、リポジトリのルートから次のコマンドを1つ実行します。

pnpm bond-token:local

このコマンドは、2作目の完成版のscripts/bond-token-ready.tsをHardhatで実行し、次の4つを順に行います。

順 行うこと
1 ignition/modules/BondTokenReady.tsをIgnitionで実行し、円トークンと社債トークンと決済のコントラクトをデプロイする
2 contracts/local.jsonの投資家3人が、10口ずつ申し込む。
3人で発行額の30口に届く
3 scripts/open-bond.tsがチェーンの時刻を払込日の2026-01-15へ進め、発行体が募集を締めて社債を渡す
4 発行体が、2回の利金の総額を決済のコントラクトへ入れる

デプロイの記録はignition/deployments/bond-token-ready/に残します。
コマンドは毎回この記録を消してからデプロイするため、anvilを立ち上げ直した後もそのまま実行し直せます。
後のコースのpnpm devが社債トークンを一緒にデプロイする時は、このコマンドを別に実行しなくても済みます。

確かめる

コマンドの最後に、次の行が出ます。

投資家3人へ社債を10口ずつ渡し、2回の利金を入れました

その上の行に出た社債トークンのアドレスを使い、castで投資家Aの社債の口数を読みます。

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

10と出れば、投資家Aが社債を10口持っています。

pnpm bond-token:local が借り手へ社債を渡す
チェーンに残る値借り手の円3,000,000円2,000,000円借り手の社債0口10口コマンドpnpm bond-token:local円トークンJpyToken決済のコントラクトBondSettlement社債トークンBondToken借り手A・B・C本人確認済みの3人11223344setAllowed と issuesetAllowed と issue3,000,000 HJPY3,000,000 HJPYsubscribe(10) を3回subscribe(10) を3回close()close()mint(借り手, 10) を3回mint(借り手, 10) を3回10口ずつ10口ずつfundCoupon(0) と fundCoupon(1)

このコースのポート8602のanvilには、ローカルノードへデプロイするレッスンで、ローンと一緒に同じ手順で円トークンと社債トークンを用意します。

確かめる

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

cd courses/securities-loan/starter/contracts
forge build
forge remappings

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

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

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

ls -l node_modules/@handsonchain/
pnpm run build

ls -lの出力に次の2つのリンクが出れば、依存のディレクトリは前のコースの完成版を指しています。

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

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

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

コンパイルした3つのファイルは、npmFilesToBuildに並べた円トークンと社債トークンと決済のコントラクトです。
2回目からはコンパイルが済んでいるため、1行目はNo contracts to compileに変わります。

最後に、社債トークンを用意する手順の後で、借り手Aの社債の残高を読みます。
<社債トークンのアドレス>には、pnpm bond-token:localが社債トークン 0x…の行に出したアドレスを入れます。

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

10と出れば、借り手Aは社債を10口持っています。
次のレッスンで、この社債1口の価格を入れるコントラクトを作ります。