HandsOnChain

Fujiへデプロイする

作るもの

このレッスンを終えると、価格とローンのコントラクトをAvalancheのテストネットのFujiへデプロイできます。
担保にするのは、2作目の完成版をFujiへデプロイした社債トークンで、貸し借りには同じ時にデプロイした円トークンを使います。
画面の右上には、ローカルノードとFujiの切り替えが付きます。
Fujiを選ぶとブラウザのウォレットをつなぎ、ローカルノードと同じ画面から担保を預けて借りられます。

背景

ローカルノードでは、pnpm devのたびに円トークンと社債をデプロイし直し、社債の募集を締めてから価格とローンをデプロイしました。
Fujiでは、社債をコースごとに作り直しません。
2作目でFujiへデプロイした社債と円トークンと決済のコントラクトをそのまま使い、価格とローンのコントラクトだけを足します。
銀行が担保に取るのは、もう世の中に出ている社債だからです。

Fujiの時刻は実際の時刻のとおりに進むだけで、先へ進めることはできません。
2作目のFujiの社債は、デプロイした日から数えた日程で発行されています。
ローンの返済の期限も、その社債の満期から数えて決めます。

値 ローカルノード Fuji
円トークンと社債と決済のコントラクト pnpm devのたびにデプロイする 2作目の完成版をFujiへデプロイした時のものを使う
返済の期限 2026-12-15 2作目のFujiの社債の満期の31日前
貸し手と評価会社 銀行と評価会社の2つのアカウント デプロイしたアカウントが両方を兼ねる
社債1口の価格 デプロイの後に1口100,000円を入れる デプロイした後に、貸し手のページから入れる
年の金利 2.00% 2.00%

ローカルノードの返済の期限の2026-12-15も、満期の2027-01-15の31日前です。
期限を満期より前に置くので、期限を過ぎても返さない借り手の担保を、満期の前に処分できます。

Fujiへデプロイするには、2作目の完成版をFujiへデプロイした記録が要ります。
まだの時は、2作目の完成版のcourses/digital-bond/complete/contractsのディレクトリでpnpm run deploy:fujiを実行しておきます。
テストネットへデプロイする手順と鍵の扱いは、どのコースでも同じなのでコースの補助にまとめてあります。

実装

2作目のFujiの記録から引数を書く

starter/contracts/scripts/fuji-parameters.tsを新しく作ります。
2作目をFujiへデプロイした記録を読み、Ignitionに渡す引数のファイルに書き出します。

// 2作目をFujiへデプロイした記録から、円トークンと社債と決済のアドレスと社債の満期を読み、
// 満期の31日前を返済の期限にして ignition/parameters/fuji.json に書く。
//
// 使い方
//   node scripts/fuji-parameters.ts   (`pnpm run deploy:fuji` がデプロイの前に実行する)
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";

const DAY = 86_400;
const JST = 9 * 3600;
const FUJI_CHAIN_ID = 43113;

const bondDir = new URL("../node_modules/@handsonchain/digital-bond-contracts/ignition/", import.meta.url);
const addressesFile = new URL(`deployments/chain-${FUJI_CHAIN_ID}/deployed_addresses.json`, bondDir);
const bondParametersFile = new URL("parameters/fuji.json", bondDir);
if (!existsSync(addressesFile) || !existsSync(bondParametersFile)) {
  process.stderr.write("fuji-parameters: 2作目をFujiへデプロイした記録がない。先に2作目の完成版で pnpm run deploy:fuji を実行する\n");
  process.exit(1);
}

const addresses = JSON.parse(readFileSync(addressesFile, "utf8")) as Record<string, string>;
const bondParameters = JSON.parse(readFileSync(bondParametersFile, "utf8")) as {
  DigitalBondModule: { paymentDates: string[] };
};
// 満期は最後の利払い日。値は "1799938800n" の形で書かれている
const maturity = Number(bondParameters.DigitalBondModule.paymentDates.at(-1)?.replace(/n$/, ""));
const dueDate = maturity - 31 * DAY;

const parameters = {
  SecuritiesLoanFujiModule: {
    jpy: addresses["JpyTokenModule#JpyToken"],
    bond: addresses["DigitalBondModule#BondToken"],
    settlement: addresses["DigitalBondModule#BondSettlement"],
    dueDate: `${dueDate}n`,
  },
};
const out = new URL("../ignition/parameters/", import.meta.url);
mkdirSync(out, { recursive: true });
writeFileSync(new URL("fuji.json", out), `${JSON.stringify(parameters, null, 2)}\n`);
process.stdout.write(`fuji-parameters: 返済の期限 ${new Date((dueDate + JST) * 1000).toISOString().slice(0, 10)} のローンを書いた\n`);
コード 意味
bondDir pnpmのワークスペースがnode_modulesに置く、2作目の完成版のignitionのディレクトリ
deployed_addresses.json 2作目をFujiへデプロイした時に、Ignitionがコントラクトのアドレスを記録したファイル
parameters/fuji.json 2作目をFujiへデプロイした時に、2作目のfuji-parameters.tsが書いた社債の日程
paymentDates.at(-1) 最後の利払い日。
2作目の社債は、最後の利払い日を満期にしている
maturity - 31 * DAY 満期の31日前を返済の期限にする
SecuritiesLoanFujiModule このレッスンで作るデプロイの手順のモジュールの名前。
中の名前はm.getParameterの名前と同じにする

Fujiのデプロイの手順を書く

starter/contracts/ignition/modules/SecuritiesLoanFuji.tsを新しく作ります。
ローカルノードのSecuritiesLoan.tsは2作目の社債を一緒にデプロイしますが、Fujiの手順はデプロイ済みの社債を指すだけにします。

import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";

import { LOCAL_LOAN } from "./SecuritiesLoan.js";

// Fujiでは、2作目のFujiへデプロイした円トークンと社債と決済をそのまま使い、価格とローンだけをデプロイする。
// アドレスと返済の期限は scripts/fuji-parameters.ts が ignition/parameters/fuji.json に書いて渡す。
// Fujiでは鍵が1つなので、デプロイしたアカウントが貸し手と評価会社を兼ねる
export default buildModule("SecuritiesLoanFujiModule", (m) => {
  const jpy = m.contractAt("JpyToken", m.getParameter<string>("jpy"));
  const bond = m.contractAt("BondToken", m.getParameter<string>("bond"));
  const settlement = m.contractAt("BondSettlement", m.getParameter<string>("settlement"));
  const deployer = m.getAccount(0);
  const price = m.contract("CollateralPrice", [deployer, deployer]);
  const loan = m.contract("SecuritiesLoan", [
    jpy,
    bond,
    settlement,
    price,
    deployer,
    m.getParameter("rateBps", LOCAL_LOAN.rateBps),
    m.getParameter<bigint>("dueDate"),
  ]);
  // 2作目をデプロイしたアカウントが円トークンの許可リストを持つので、ローンのコントラクトを載せる
  m.call(jpy, "setAllowed", [loan, true], { id: "allow_loan" });
  return { jpy, bond, settlement, price, loan };
});
コード 意味
m.contractAt("JpyToken", ...) 新しくデプロイせず、渡したアドレスにあるコントラクトを指す。
Ignitionはこのアドレスも記録に残す
m.getAccount(0) デプロイに使うアカウント。
補助の手順でkeystoreに入れた鍵のアカウント
m.contract("CollateralPrice", [deployer, deployer]) 価格のコントラクトの管理者と評価会社を、デプロイしたアカウントにする
deployer (ローンの5つ目の引数) 円を入れる貸し手も、デプロイしたアカウントにする
LOCAL_LOAN.rateBps 年の金利はローカルノードと同じ2.00%にする
m.call(jpy, "setAllowed", [loan, true]) ローンのコントラクトを円トークンの許可リストに載せる。
許可リストを変えられるのは2作目をデプロイしたアカウントなので、2作目と同じ鍵でデプロイする

ローンのコンストラクタは、返済の期限が担保の社債の満期より前かを確かめます。
fuji-parameters.tsが満期の31日前を渡すので、DueDateAfterMaturityで拒まれることはありません。

starter/contracts/package.jsonのdeploy:fujiは、雛形に最初から入っています。
デプロイの前にfuji-parameters.tsを実行し、書き出したファイルを--parametersでIgnitionへ渡します。

    "deploy:fuji": "node scripts/fuji-parameters.ts && hardhat ignition deploy ignition/modules/SecuritiesLoanFuji.ts --network fuji --parameters ignition/parameters/fuji.json"

このレッスンで2つのファイルを作るまでは、deploy:fujiはファイルが見つからずに止まります。

価格とローンをFujiへデプロイする

補助の手順でFujiのためのアカウントと鍵を用意し、starter/contractsのディレクトリで価格とローンをデプロイします。
2作目をFujiへデプロイした鍵がkeystoreに入っていれば、入れ直さずに使えます。

補助テストネットへデプロイする補助のページ

実装

Fujiのためのアカウントを作る

ブラウザのウォレット (MetaMaskやCore) で、Fujiのためだけの新しいアカウントを作ります。
ウォレットのネットワークの一覧にAvalanche Fuji C-Chainを足し、AvalancheのFujiのfaucetでそのアカウントにテスト用のAVAXを受け取ります。

鍵をkeystoreに入れる

ウォレットからそのアカウントの秘密鍵を書き出し、コースの雛形のcontractsのディレクトリで次のコマンドを実行します。

pnpm exec hardhat keystore set FUJI_PRIVATE_KEY

keystoreのパスワードを決めてから、秘密鍵を貼り付けます。
鍵は暗号化されてPCの中に保存され、リポジトリのファイルには入りません。
hardhat.config.tsのconfigVariable("FUJI_PRIVATE_KEY")が、デプロイする時にこの鍵を読みます。
keystoreはPCに1つなので、2つ目のコースからは鍵を入れ直さずにデプロイできます。

デプロイする

コースのcontracts/package.jsonのdeploy:fujiが、Ignitionで--network fujiへデプロイします。
デプロイを始める前にIgnitionがデプロイ先のチェーンの確認を求めるので、yを押します。
デプロイが終わると、ignition/deployments/chain-43113/deployed_addresses.jsonにコントラクトのアドレスが記録されます。
ローカルノードの記録と違い、この記録はgitで残しておけます。
コースの画面は開くたびにこの記録を読むため、デプロイした後に画面をビルドし直す必要はありません。

確かめる

デプロイした時に出たアドレスをFujiのエクスプローラ (Snowtrace) で検索し、コントラクトを作成した取引があることを確かめます。

このコースでデプロイするコマンドは次の2つです。

pnpm run build
pnpm run deploy:fuji

初めにfuji-parameters: 返済の期限で始まる行が出て、2作目の社債の満期の31日前の日付が分かります。
Ignitionは価格とローンのコントラクトをデプロイし、ignition/deployments/chain-43113/deployed_addresses.jsonにアドレスを記録します。

記録の名前 コントラクト
SecuritiesLoanFujiModule#JpyToken 2作目と同じ円トークン
SecuritiesLoanFujiModule#BondToken 2作目と同じ社債トークン
SecuritiesLoanFujiModule#BondSettlement 2作目と同じ決済のコントラクト
SecuritiesLoanFujiModule#CollateralPrice 価格のコントラクト
SecuritiesLoanFujiModule#SecuritiesLoan ローンのコントラクト

画面のlib/deployments.tsは、記録の名前を#の後のコントラクトの名前で探します。
モジュールの名前がローカルノードと違っても、同じ画面で5つのコントラクトを読めます。

画面にFujiの切り替えを足す

雛形のstarter/app/src/components/session.tsxには、ローカルノードとFujiの2つのネットワークと、ウォレットをつなぐ操作が最初から入っています。
このレッスンでは、そのネットワークを画面の右上から選べるようにします。

同じsession.tsxに、前に選んだネットワークをブラウザに残した値から戻す処理を足します。
Fujiを選んだままページを開き直しても、Fujiのままで始まります。

  const connect = useConnect();

  // 前に選んだネットワークを、この閲覧者のブラウザから戻す
  useEffect(() => {
    try {
      const saved = window.localStorage.getItem(NETWORK_KEY);
      if (saved === "fuji") setNetworkState("fuji");
    } catch {
      // 保存できないブラウザでは、毎回ローカルノードから始める
    }
  }, []);

starter/app/src/components/header.tsxでは、Networkの型を読み込み、切り替えの2つの候補を書きます。

import { useSession, type Network } from "./session";
const networks: { value: Network; label: string }[] = [
  { value: "local", label: "ローカルノード" },
  { value: "fuji", label: "Fuji" },
];

Fujiの時だけ、右上のアカウントの欄につないだウォレットのアカウントを出します。
まだつないでいない時は、つなぐボタンを出します。

function AccountControl() {
  const session = useSession();
  // Fujiでは、つないだウォレットのアカウントを出す。まだつないでいない時は、つなぐボタンを出す
  if (session.network === "fuji") {
    return session.address ? (
      <span className="wallet-chip">{shortAddress(session.address)}</span>
    ) : (
      <button type="button" className="button button-primary" onClick={session.connectWallet}>
        ウォレットをつなぐ
      </button>
    );
  }

Headerに切り替えのボタンを置き、ウォレットにつなげなかった時の文を下に出します。

export function Header() {
  const pathname = usePathname();
  const session = useSession();
        <div className="header-controls">
          <div className="segmented" role="group" aria-label="ネットワーク">
            {networks.map((network) => (
              <button
                key={network.value}
                type="button"
                aria-pressed={session.network === network.value}
                onClick={() => session.setNetwork(network.value)}
              >
                {network.label}
              </button>
            ))}
          </div>
          <ThemeControl />
          <AccountControl />
        </div>
      </div>
      {session.walletError ? <p className="header-error">{session.walletError}</p> : null}
    </header>
コード 意味
session.setNetwork(network.value) 読むチェーンとコントラクトのアドレスを切り替え、選んだネットワークをブラウザに残す
aria-pressed 今選んでいるほうのボタンを押された状態で出す
session.connectWallet wagmiのinjectedコネクタで、ブラウザのウォレットにFujiでつなぐ

Fujiでウォレットをまだつないでいない時は、操作するアカウントがありません。
starter/app/src/components/borrower-view.tsxでは、これまで何も出さなかったところを、ウォレットをつなぐ案内に書き換えます。

  if (!contracts.loan) return <NotDeployed />;
  if (!me || !position) {
    return (
      <section className="card empty">
        <h2>アカウントがつながっていません</h2>
        <p>右上のボタンでウォレットをつなぐと、担保と借入の欄が出ます。</p>
      </section>
    );
  }

貸し手のページは、操作するアカウントがなくても貸し手の円と借り手ごとの担保を出せるので、書き換えません。
価格と時刻の帯はローカルノードの時だけ出す作りなので、Fujiでは出ません。
Fujiでは、貸し手のページの「担保の価格」の欄から価格を入れます。

確かめる

補助の確かめ方でエクスプローラにローンのコントラクトが出たら、starter/appのディレクトリでpnpm devを実行し、画面の右上の切り替えで「Fuji」を選びます。
Fujiへまだデプロイしていない時は、デプロイするコマンドの案内が出ます。

画面の右上でFujiに切り替えたところ
画面の右上でFujiに切り替えたところ

デプロイした後は「アカウントがつながっていません」の案内に変わるので、「ウォレットをつなぐ」を押します。
デプロイしたアカウントは貸し手と評価会社を兼ねます。
初めに貸し手のページの「担保の価格」の欄で社債1口の価格を入れ、「円を入れる」の欄で貸す円を入れます。
価格は3日を過ぎると使えなくなるので、借りる前と請求や処分の前に入れ直します。
2作目のFujiの社債を持つアカウントは、借り手のページで社債を預け、借入枠まで借りられます。
2作目の社債は、締め切りまでに30口の申込が集まった時だけ発行されます。
取引ごとにウォレットが署名を求め、取引がブロックに入ると画面が読み直されます。
「ローカルノード」を押すと、anvilのアカウントでの操作に戻ります。

これでコースは終わりです。
2作目の社債トークンを担保に預け、掛け目80%の枠まで1作目の円トークンを借り、日割りの利息を付けて返せます。
評価会社の価格で担保維持率を計算し、110%を下回った借り手には追加担保を求めます。
猶予を過ぎても戻らない借り手や返済の期限を過ぎた借り手の担保は、強制売却で割り引いて売り、利息と元本の順に充てます。
担保に預けている間の利金は、ローンのコントラクトが受け取って借り手へ渡します。