開発環境と円トークンと社債トークンを用意する
作るもの
このレッスンを終えると、開発環境を起動し、1作目の円トークンと2作目の社債トークンをワークスペースの依存として読み込めます。
本人確認済みの借り手3人が社債を10口ずつ持つ状態も、コマンド1つで作れます。
このコースでは、この社債トークンを担保に預けて円トークンを借りる証券担保ローンを作ります。
背景
証券担保ローンは、持っている株や社債を売らずに担保として預け、お金を借りる仕組みです。
借り手は社債を持ち続けたまま円を用意でき、利金も受け取り続けられます。
貸し手は、返してもらえない時に担保を売って、貸したお金に充てられます。
貸せる額は、担保の評価額に掛け目を掛けた額までです。
担保の価格は、評価会社が決めて知らせます。
価格が下がって担保維持率が決めた水準を下回ると、貸し手は借り手へ追加担保を求めます。
借り手が応じない時は、貸し手の側が担保を売って回収します。
この売却を強制売却と呼び、このコースでは担保の処分と呼びます。
| 役 | このコースでの役目 |
|---|---|
| 借り手 | 2作目の社債を担保に預けて円を借り、利息を付けて返す |
| 貸し手 | 銀行。 借り手へ貸す円をローンのコントラクトへ入れる |
| 評価会社 | 社債1口の価格を入れる。 ローンのコントラクトはこの価格で担保の評価額を出す |
担保の社債と貸した円が別々の仕組みにあると、担保を売って回収する時に、社債の受け渡しと円の支払いを突き合わせる手間が残ります。
片方だけが済んで相手が払わない危険もあります。
このコースでは、担保の社債も借りる円もチェーンの上のトークンにします。
担保の預け入れも貸し出しも担保の処分も、それぞれ1つの取引の中で行えます。
そのため、担保と円の記録がずれません。
担保に使う社債は、2作目で作った社債と同じ条件です。
ローンの返済の期限は、社債の満期より前の2026-12-15に置きます。
満期を過ぎると担保の社債が償還されて消えるため、その前に返してもらいます。
円トークンと社債トークンのコードは、1作目と2作目の完成版の1か所だけに置き、このコースは写しを持ちません。
写しを作ると、前のコースで直した所がこのコースに届かなくなるためです。
1作目と2作目を終えていない人も、このレッスンの手順で前のコースの完成版を使えます。
実装
補助の手順で開発環境を起動します。
雛形のディレクトリへ移る
このコースで書き足すのは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作目の完成版の手順で作ります。
円トークンの仕組みと、本人確認と発行の手順は、次の補助にまとめてあります。
社債トークンを用意する手順は、円トークンも一緒にデプロイし、借り手3人へ社債を10口ずつ渡します。
このコマンドは2作目のHardhatの設定を使うため、2作目のポート8601のanvilへデプロイします。
社債の申込の締め切りが2026-01-14なので、anvilは--timestamp 1767193200を付けて2026-01-01から起動しておきます。
このコースのポート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口の価格を入れるコントラクトを作ります。