HandsOnChain

Fujiへデプロイする

作るもの

このレッスンを終えると、今日から数えた日程の社債を、円トークンと一緒にAvalancheのテストネットのFujiへデプロイできます。
画面の右上には、ローカルノードとFujiの切り替えが付きます。
Fujiを選ぶとブラウザのウォレットをつなぎ、ローカルノードと同じ画面から申し込めます。

背景

ローカルノードで確かめた社債を、本番と同じ仕組みで動くテストネットに出し、誰でも読める場所で動かします。
ローカルノードのanvilは時刻を進められるので、2026年の日程のまま記録日や満期を試せました。
Fujiの時刻は実際の時刻のとおりに進むだけで、先へ進めることはできません。
2026-01-14の締め切りのままデプロイすると、締め切りを過ぎた後では誰も申し込めません。
そこで、デプロイする時に今日から数えた日程を作り、社債の条件として渡します。

日程 ローカルノード Fuji
締め切り 2026-01-14 デプロイした日の7日後
払込日 2026-01-15 締め切りの翌日
利払い日 2026-07-15と2027-01-15 払込日の6か月後と12か月後
記録日 2026-07-10と2027-01-10 各利払い日の5日前
満期 2027-01-15 2回目の利払い日

額面と利率と30口の発行額は、ローカルノードと同じです。
テストネットへデプロイする手順と鍵の扱いは、どのコースでも同じなのでコースの補助にまとめてあります。

実装

今日から数えた日程を書く

starter/contracts/scripts/fuji-parameters.tsを新しく作ります。
実行した日から数えた日程を、Ignitionに渡す引数のファイルに書き出します。

// Fujiは時刻を進められないため、今日から数えた日程の社債をデプロイする。
// 締め切りを7日後、払込日をその翌日とし、半年ごとに2回の利払いを置いて1年後を満期にする。
// 記録日は各利払い日の5日前にする。日付は全て日本時間の0時。
//
// 使い方
//   node scripts/fuji-parameters.ts   (`pnpm run deploy:fuji` がデプロイの前に実行する)
import { mkdirSync, writeFileSync } from "node:fs";

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

// 日本時間の y年m月d日 0時のUnix時刻
function jstMidnight(year: number, month: number, day: number): number {
  return Date.UTC(year, month, day) / 1000 - JST;
}

const now = new Date(Date.now() + JST * 1000);
const today = jstMidnight(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
const deadline = today + 7 * DAY;
const issue = new Date((deadline + DAY + JST) * 1000);
const issueDate = deadline + DAY;
const paymentDates = [6, 12].map((months) => jstMidnight(issue.getUTCFullYear(), issue.getUTCMonth() + months, issue.getUTCDate()));
const recordDates = paymentDates.map((date) => date - 5 * DAY);

const parameters = {
  DigitalBondModule: {
    issueDate: `${issueDate}n`,
    paymentDates: paymentDates.map((date) => `${date}n`),
    recordDates: recordDates.map((date) => `${date}n`),
    deadline: `${deadline}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((deadline + JST) * 1000).toISOString().slice(0, 10)} の日程を書いた\n`);
コード 意味
jstMidnight 日本時間の0時のUnix時刻を返す。
Date.UTCで作った時刻から9時間を引く
now 今の時刻に9時間を足し、日本時間の年と月と日をgetUTCの関数で読めるようにする
paymentDates 払込日の月に6と12を足した月の、同じ日の0時。
Date.UTCは12を超えた月を次の年へ繰り上げる
recordDates 各利払い日の5日前
${issueDate}n Ignitionの引数のファイルでは、大きな整数をnで終わる文字で書く
DigitalBondModule デプロイの手順のモジュールの名前。
中の名前はm.getParameterの名前と同じにする

デプロイの手順のstarter/contracts/ignition/modules/DigitalBond.tsは、社債の条件をm.getParameterで受け取ります。
引数のファイルにない額面と利率と発行額は、LOCAL_BONDのローカルノードの値のままデプロイされます。

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

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

このレッスンでスクリプトを作るまでは、deploy:fujiはスクリプトが見つからずに止まります。

社債をFujiへデプロイする

補助の手順でFujiのためのアカウントと鍵を用意し、starter/contractsのディレクトリで社債をデプロイします。

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

実装

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: 締め切りで始まる行が出て、7日後の日付で日程を書いたことが分かります。
Ignitionは円トークンと社債トークンと決済のコントラクトを一緒にデプロイし、ignition/deployments/chain-43113/deployed_addresses.jsonにアドレスを記録します。

記録の名前 コントラクト
JpyTokenModule#JpyToken 円トークン
DigitalBondModule#BondToken 社債トークン
DigitalBondModule#BondSettlement 決済のコントラクト

画面に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/investor-view.tsxでは、これまで何も出さなかったところを、ウォレットをつなぐ案内に書き換えます。

  if (!session.contracts.bond) return <NotDeployed />;
  if (!me) {
    return (
      <section className="card empty">
        <h2>アカウントがつながっていません</h2>
        <p>右上のボタンでウォレットをつなぐと、持っている社債と申込の欄が出ます。</p>
      </section>
    );
  }

発行体のページは、操作するアカウントがなくても社債の条件と募集の進み具合を出せるので、書き換えません。
時刻の帯と「締め切りの後へ進める」は、ローカルノードの時だけ出す作りなので、Fujiでは出ません。

確かめる

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

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

デプロイした後は「アカウントがつながっていません」の案内に変わるので、「ウォレットをつなぐ」を押します。
デプロイしたアカウントは発行体で、円トークンの名簿に載って100万円を持つため、投資家のページから10口まで申し込めます。
取引ごとにウォレットが署名を求め、取引がブロックに入ると画面が読み直されます。
締め切りの7日後を過ぎたら、発行体のページで募集を締めます。
申込が30口に届いていなければ、締めた時に預けた円が返ります。
「ローカルノード」を押すと、anvilのアカウントでの操作に戻ります。

これでコースは終わりです。
コントラクトから画面まで作った社債は、円トークンと1つの取引で交換して発行されます。
記録日の口数で日割りの利金を払い、経過利息を足して投資家どうしで売り買いできます。
満期には額面を払って社債をburnし、払えない時は不履行を記録して売買を止めます。