コアウォレットをAvalanche DeFiアプリケーションに接続する方法

コアウォレット統合アーキテクチャ

1. Core Wallet は EIP-1193 準拠の挿入プロバイダーとして動作し、Avalanche C-Chain を含む EVM 互換チェーン全体での dApp インタラクションのための標準化されたインターフェイスを公開します。

2. ウォレットは、イーサリアムオブジェクトをグローバル ウィンドウ スコープに挿入し、外部 SDK を必要とせずにrequest 、 on 、 removeListenerなどのメソッドに直接アクセスできるようにします。

3. Avalanche 固有のチェーン構成は、Core Wallet のネットワーク リストに事前に登録されている必要があります。エントリが欠落していると、最初の接続時にユーザーによる手動 RPC エンドポイント入力がトリガーされます。

4. 署名リクエストはデフォルトで EIP-1559 トランザクション形式に従い、https://api.avax.network/ext/bc/C/rpc などの Avalanche のパブリック RPC エンドポイントからの動的ガス推定を使用します。

5. マルチチェーンのサポートはswitchEthereumChainメソッドを介して処理され、dApp UI をリロードすることなく、Avalanche Fuji テストネットとメインネット間のシームレスな移行が可能になります。

フロントエンド接続フロー

1. window.ethereum?.isCoreまたはwindow.ethereum?.providers?.find(p => p.isCore)を使用してコア ウォレットの存在を検出し、MetaMask または他の挿入されたウォレットと区別します。

2. ethereum.request({ method: 'eth_requestAccounts' })を使用して接続を初期化します。これにより、ユーザーの承認が求められ、承認されたアドレスの配列が返されます。

3. ethereum.request({ method: 'eth_getBalance', params: [address, 'latest'] })でアカウント残高を取得し、 BigInt変換を介して結果を 16 進文字列から 10 進数に解析します。

4. ethereum.on('chainChanged', handleChainChange)を介してネットワーク変更イベントをリッスンし、dApp の状態が現在の Avalanche チェーン ID (メインネットの場合は 43114、Fuji の場合は 43113) を反映していることを確認します。

5. ethereum.on('accountsChanged', handleAccountsChanged)を通じて切断処理を実装し、アドレス失効またはウォレットのロックアウトを検出します。

Avalanche DeFi 契約の相互作用

1. Avalanche C-Chain にデプロイされたスマート コントラクトには、読み取り/書き込み操作のために Viem または ethers.jsコントラクトオブジェクトをインスタンス化するための ABI とコントラクト アドレスが必要です。

2. Pangolin または Trader Joe でのトークン スワップの場合、Uniswap V2 フォーク標準に​​従ってエンコードされた正確な入力金額、スリッページ許容値、期限を含むencodeFunctionDataを使用してトランザクション パラメーターを構築します。

3. Avalanche のガス価格モデルに対して検証されたto 、 data 、 value 、 GasLimit 、およびmaxFeePerGasフィールドを含む署名付きペイロードを使用してeth_sendTransactionを呼び出します。

4. eth_getTransactionReceiptポーリングを使用するか、 ethereum.request({ method: 'eth_subscribe', params: ['newHeads'] })を介してイベント サブスクリプションを使用してトランザクション ステータスを監視します。

5. トランザクション受領書に埋め込まれた戻し理由文字列を解析することで、不十分な流動性、期限切れ、価格影響チェックの失敗などの一般的な戻し原因を処理します。

セキュリティ検証チェックリスト

1. DNS ハイジャックや応答の改ざんを防ぐために、すべての RPC 呼び出しがサードパーティのプロキシではなく、Avalanche の公式エンドポイントから発信されていることを確認します。

2. 資金移動や承認を伴うやり取りを開始する前に、Snowtrace.io 上の検証済みソースに対して契約アドレスを検証します。

3. document.location.origin がCore Wallet の内部権限データベースに登録されているホワイトリストに登録された dApp ドメインと一致することを確認して、厳密なドメイン バインドを強制します。

4.personal_signまたはeth_signTypedData_v4応答に、EIP-191 および EIP-712 仕様で定義されている一致するプレフィックス パターンがない場合、未署名のメッセージ署名を拒否します。

5. 既知の dApp ID キー ペアによって暗号署名されていない限り、URL パラメーターまたはクエリ文字列によってトリガーされるコントラクト呼び出しの自動実行を無効にします。

よくある質問

Q: Core Wallet はカスタム Avalanche サブネットをサポートしていますか? Core Wallet は、そのままの状態でプライマリ C-Chain と X-Chain の相互作用のみをサポートします。サブネット統合には手動の RPC 構成が必要で、デフォルトでは有効になっていません。

Q: Core Wallet を AvaxCanary や NFTPort などの Avalanche の EVM 互換 L2 で使用できますか?はい、これらの L2 が標準の EVM JSON-RPC エンドポイントを公開し、接続前にコア ウォレットのネットワーク レジストリにチェーン ID を登録する場合に限ります。

Q: MetaMask もインストールされていると、dApp が Core Wallet を検出できないのはなぜですか?これは、両方のウォレットがwindow.ethereumを挿入するために発生します。検出ロジックは、トップレベルのプロパティの存在だけに依存するのではなく、 window.ethereum.providersを反復処理してisCoreフラグを検証する必要があります。

Q: Avalanche トランザクションのコア ウォレット内でハードウェア ウォレットのサポートは利用できますか? Core Wallet は、Ledger または Trezor デバイスをネイティブに統合しません。ユーザーは、ブラウザベースの署名、または互換性のあるブリッジを介してルーティングされる外部の WalletConnect セッションに依存する必要があります。