HandsOnChain

Fujiへデプロイする

作るもの

このレッスンを終えると、ファンドのコントラクトをAvalancheのテストネットのFujiへデプロイできます。
申込の円と解約の代金には、1作目の完成版をFujiへデプロイした円トークンを使います。
画面の右上にはローカルノードとFujiの切り替えが付き、Fujiを選ぶとブラウザのウォレットをつないで申し込めます。
Fujiでも締め切りは15時のままで、解約の代金は3営業日後の受渡日から受け取ります。

背景

ローカルノードでは、pnpm devのたびに円トークンとファンドをデプロイし直し、投資家3人と運用会社に円を発行しました。
Fujiでは、円トークンをコースごとに作り直しません。
1作目でFujiへデプロイした円トークンをそのまま使い、ファンドのコントラクトだけを足します。
投資信託の申込と解約に使う円は、ファンドごとに新しく作るお金ではないからです。

Fujiの時刻は実際の時刻のとおりに進むだけで、先へ進めることはできません。
それでも、Fujiのために締め切りや受渡日を短くはしません。
短くするとコントラクトに締め切りを変える値が増え、本番で使う15時の締め切りと3営業日の受渡しから離れるためです。
ファンドの締め切りと受渡日の日数はコントラクトの定数なので、ローカルノードと同じ決まりのままデプロイされます。

値 ローカルノード Fuji
円トークン pnpm devのたびにファンドと一緒にデプロイする 1作目の完成版をFujiへデプロイした時のものを使う
運用会社 contracts/local.jsonの運用会社のアカウント デプロイしたアカウントが兼ねる
投資家 投資家A、投資家B、投資家Cの3つのアカウント 許可リストに載ったウォレットのアカウント
円 デプロイの後に投資家へ100万円ずつ、運用会社へ1,000万円を発行する 1作目の発行体が、1作目の画面から発行する
時刻 帯のボタンで締め切りの後と次の営業日へ進める 実際の時刻のとおりに進む
締め切りと受渡日 15時と3営業日後 15時と3営業日後

締め切りを過ぎるのも受渡日が来るのも実際に待つため、このレッスンはデプロイと申込の注文までにします。
申込の取引は、Fujiのエクスプローラで確かめます。
テストネットへデプロイする手順と鍵の扱いは、どのコースでも同じなのでコースの補助にまとめてあります。

Fujiへデプロイするには、1作目の完成版をFujiへデプロイした記録が要ります。
まだの時は、1作目の完成版のcourses/jpy-stablecoin/complete/contractsのディレクトリでpnpm run deploy:fujiを実行しておきます。
円トークンの許可リストを変えられるのは1作目をデプロイしたアカウントなので、このコースも同じ鍵でデプロイします。

実装

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

starter/contracts/scripts/fuji-parameters.tsを新しく作ります。
1作目をFujiへデプロイした記録から円トークンのアドレスを読み、Ignitionに渡す引数のファイルに書き出します。

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

const FUJI_CHAIN_ID = 43113;

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

const addresses = JSON.parse(readFileSync(addressesFile, "utf8")) as Record<string, string>;
const parameters = { TokenizedFundFujiModule: { jpy: addresses["JpyTokenModule#JpyToken"] } };
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: 円トークン ${parameters.TokenizedFundFujiModule.jpy} を使うファンドを書いた\n`);
コード 意味
@handsonchain/jpy-stablecoin-contracts pnpmのワークスペースがnode_modulesに置く、1作目の完成版のcontractsのディレクトリ
chain-${FUJI_CHAIN_ID}/deployed_addresses.json 1作目をFujiへデプロイした時に、Ignitionがコントラクトのアドレスを記録したファイル。
43113はFujiのチェーンの番号
existsSync(addressesFile) 1作目をまだFujiへデプロイしていない時は、案内の文を出して止まる
addresses["JpyTokenModule#JpyToken"] 1作目のJpyTokenModuleがデプロイした円トークンのアドレス
TokenizedFundFujiModule このレッスンで作るデプロイの手順のモジュールの名前。
中のjpyはm.getParameterの名前と同じにする

3作目と違い、引数に日付はありません。
ファンドの締め切りと受渡日はデプロイした日によらず、毎営業日の15時と3営業日後に決まるためです。

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

starter/contracts/ignition/modules/TokenizedFundFuji.tsを新しく作ります。
ローカルノードのTokenizedFund.tsは円トークンを一緒にデプロイしますが、Fujiの手順はデプロイ済みの円トークンを指すだけにします。

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

// Fujiでは、1作目のFujiへデプロイした円トークンをそのまま使い、ファンドだけをデプロイする。
// 円トークンのアドレスは scripts/fuji-parameters.ts が ignition/parameters/fuji.json に書いて渡す。
// Fujiでは鍵が1つなので、デプロイしたアカウントが運用会社を兼ねる
export default buildModule("TokenizedFundFujiModule", (m) => {
  const jpy = m.contractAt("JpyToken", m.getParameter<string>("jpy"));
  const deployer = m.getAccount(0);
  const fund = m.contract("TokenizedFund", [jpy, deployer]);
  // 1作目をデプロイしたアカウントが円トークンの許可リストを持つので、ファンドのコントラクトと運用会社を載せる
  m.call(jpy, "setAllowed", [fund, true], { id: "allow_fund" });
  m.call(jpy, "setAllowed", [deployer, true], { id: "allow_manager" });
  return { jpy, fund };
});
コード 意味
m.contractAt("JpyToken", ...) 新しくデプロイせず、渡したアドレスにある円トークンを指す。
Ignitionはこのアドレスも記録に残す
m.getAccount(0) デプロイに使うアカウント。
補助の手順でkeystoreに入れた鍵のアカウント
m.contract("TokenizedFund", [jpy, deployer]) 円トークンと運用会社を渡してファンドをデプロイする。
運用会社の役もデプロイしたアカウントが持つ
m.call(jpy, "setAllowed", [fund, true], ...) ファンドのコントラクトを許可リストに載せる。
申込の円と解約の代金を預かるため
m.call(jpy, "setAllowed", [deployer, true], ...) 運用会社を許可リストに載せる。
約定で申込の円を受け取り、解約の代金を入れるため

TokenizedFundのコンストラクタは、デプロイしたアカウントに管理者の役を渡し、2つ目の引数のアカウントに運用会社の役を渡します。
Fujiでは、どちらもデプロイしたアカウントになります。
ローカルノードの手順と違い、Fujiの手順は運用会社へ円を発行しません。
円を発行できるのは1作目の発行体の役を持つアカウントで、Fujiでは1作目の画面から発行します。

デプロイの手順は、次の順に動きます。

Fujiへファンドをデプロイする
引数のファイル円トークンのアドレス1作目のJpyToken引数を書くスクリプトfuji-parameters.tsIgnitionTokenizedFundFujiModuleファンドのコントラクトTokenizedFund円トークン1作目のFujiのJpyToken112233fuji.jsonを渡すfuji.jsonを渡すTokenizedFund(円トークン, デプロイしたアカウント)TokenizedFund(円トークン, デプロイしたアカウント)setAllowed(ファンド, true)setAllowed(運用会社, true)1作目の記録を読む1作目の記録を読む

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

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

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

ファンドをFujiへデプロイする

補助の手順でFujiのためのアカウントと鍵を用意し、starter/contractsのディレクトリでファンドをデプロイします。
1作目を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: 円トークンで始まる行が出て、使う円トークンのアドレスが分かります。
Ignitionはファンドのコントラクトをデプロイして許可リストに載せ、ignition/deployments/chain-43113/deployed_addresses.jsonにアドレスを記録します。

記録の名前 コントラクト
TokenizedFundFujiModule#JpyToken 1作目と同じ円トークン
TokenizedFundFujiModule#TokenizedFund ファンドのコントラクト

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

画面に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.fund) return <NotDeployed />;
  if (!me) {
    return (
      <section className="card empty">
        <h2>アカウントがつながっていません</h2>
        <p>右上のボタンでウォレットをつなぐと、持分と注文の欄が出ます。</p>
      </section>
    );
  }

運用会社のページは、操作するアカウントがなくても純資産の総額と注文の表を出せるので、書き換えません。
時刻の帯はローカルノードの時だけ出す作りなので、Fujiでは出ません。

確かめる

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

画面の右上でFujiに切り替え、まだデプロイしていない案内とウォレットをつなぐボタンが出たところ
画面の右上でFujiに切り替え、まだデプロイしていない案内とウォレットをつなぐボタンが出たところ

デプロイした後は「アカウントがつながっていません」の案内に変わるので、「ウォレットをつなぐ」を押します。
デプロイしたアカウントは許可リストに載っているので、そのまま投資家として申し込めます。

申し込む円は、1作目の画面で発行します。
リポジトリのルートでpnpm dev:jpy-stablecoinを実行し、1作目の画面をFujiに切り替えます。
「発行体の画面」の「入金に応じて発行する」の欄から、自分のアカウントへ円を発行します。

このコースの画面に戻り、投資家のページの「申し込む」の欄で申し込みます。
ウォレットは、円をファンドに任せるapproveと申込のsubscribeの2つの取引に署名を求めます。
注文の表に申込の行が出て、状態は「締め切りの前」になります。
15時を過ぎた後と土日に申し込んだ時は、次の営業日の約定日に入り、行に理由が添えられます。

申込の取引は、エクスプローラでファンドのコントラクトのアドレスを検索して確かめます。
取引の一覧に申込の取引が出て、取引を開くと円トークンが自分のアカウントからファンドのコントラクトへ動いた記録が分かります。
申込の約定日の15時を過ぎた後は、同じアカウントで運用会社のページから純資産を入れて約定できます。
「ローカルノード」を押すと、anvilのアカウントでの操作に戻ります。

これでコースは終わりです。
トークン化ファンドの持分は1口を最小単位の口数で数え、1作目の円トークンの許可リストにいる人だけが持てます。
15時の締め切りまでに溜めた申込と解約は、ブラインド方式の決まりで、締め切りの後に出る基準価額でまとめて約定します。
基準価額は信託報酬を日割りで差し引いてから出し、解約の代金は信託財産留保額を引いた解約価額で決まります。

同じ投資家の同じ約定日の解約は100万口までで、代金は3営業日後の受渡日から受け取れます。