新しいブロックチェーン プロジェクトにアクセスするためにカスタム RPC ネットワークを OKX ウォレットに追加する方法

カスタム RPC ネットワーク統合について

1. OKX ウォレットは、標準化された JSON-RPC エンドポイントを介したカスタム ブロックチェーン ネットワークの手動追加をサポートしており、事前承認されたリストに依存せずに、新興のレイヤー 1 およびレイヤー 2 エコシステムとの直接対話を可能にします。

2. 各カスタム ネットワークには、一意のチェーン ID、安定した HTTP または HTTPS RPC URL、トランザクション検証用のブロック エクスプローラー URL、および 10 進精度のネイティブ通貨記号が必要です。

3. ウォレットは入力中にネットワークパラメータを検証しますが、リアルタイムの接続チェックは実行しません。ユーザーは構成を最終決定する前にエンドポイントの応答性を確認する必要があります。

4. 追加すると、ネットワークが「ネットワーク」タブに表示され、トランザクションの送信、コントラクトの展開、またはそのチェーン上でホストされている dApp との対話を選択できるようになります。

5. アイコン、名前、エクスプローラーリンクを含むネットワークメタデータは、ウォレットの安全なストレージ内にローカルに保存され、外部サーバーに送信されることはありません。

段階的な構成プロセス

1. OKX ウォレットを開き、[設定] → [ネットワーク] → [ネットワークを手動で追加] に移動します。

2. ターゲット ブロックチェーンの仕様に一致する 10 進数または 16 進数の整数としてチェーン ID を入力します。たとえば、XLayer の場合は 195、zkSync Era の場合は 324 です。

3. プロトコルを含む完全な RPC URL (例: https://rpc.xlayer.tech ) を入力し、CORS リクエストが許可され、eth_chainId および eth_blockNumber 呼び出しに対して有効な JSON-RPC 応答が返されることを確認します。

4. https://www.okx.com/explorer/xlayer/tx/{txHash}など、トランザクション ハッシュのプレースホルダーを使用してブロック エクスプローラー URL を指定します。ここで、 {txHash} は動的に置き換えられます。

5. ネイティブ トークン記号 (OKT など) と小数点 (通常は 18) を設定し、構成を保存してウォレット インターフェイスでネットワークをアクティブにします。

検証とトラブルシューティング

1. 保存後、新しく追加したネットワークに切り替え、表示された残高を確認します。ゼロであるが予想どおりの場合は、外部ブロック エクスプローラーを使用してアカウントにオンチェーンで資金が入金されていることを確認します。

2. 最小値でテスト トランザクションを試みます。停止または失敗した場合は、タイムアウト、CORS 拒否、または無効な応答形式を示す、失敗した RPC リクエストがないかブラウザ開発者ツールを検査します。

3. 一般的なエラー「無効な JSON-RPC 応答」は、コンテンツ タイプ ヘッダーの不一致、またはノード プロバイダーから返された 200 以外の HTTP ステータス コードを示します。

4. ガスの推定が失敗した場合は、RPC エンドポイントが eth_estimateGas メソッドと eth_gasPrice メソッドを公開していることを確認します。一部のパブリック ノードでは、レート制限の理由からこれらが無効になっています。

5. 継続的な「ネットワークに到達できません」メッセージは、RPC ドメインでの DNS 解決の失敗または TLS 証明書の構成ミスを示唆します。

サードパーティのエンドポイントのセキュリティに関する考慮事項

1. 未検証のソーシャル メディア投稿や非公式ドキュメントからの RPC URL は決して入力しないでください。悪意のあるエンドポイントが署名リクエストを傍受したり、偽造残高を返したりする可能性があります。

2. TLS 1.3、証明書の固定、文書化された稼働時間 SLA を提供するプロバイダーを優先します。例には、Blast API、Chainstack、OKX 独自の XLayer RPC インフラストラクチャが含まれます。

3. OKX ウォレットは動的なキー インジェクションをサポートしておらず、プレーンテキスト ログで資格情報が公開される可能性があるため、ウォレット設定に直接埋め込まれた API キーを必要とする RPC は避けてください。

4. チェーン ID を公式プロジェクト リポジトリと照合します。137 (ポリゴン) や 1 (イーサリアム メインネット) などのスプーフィング ID は、新規ユーザーをターゲットとしたフィッシング攻撃で頻繁に再利用されます。

5. 攻撃対象領域を減らすために、未使用のカスタム ネットワークを定期的に無効にします。アクティブなネットワークごとに、dApp 接続中に発生する可能性のある RPC インジェクション ベクトルの数が増加します。

よくある質問

Q: 別のブロックチェーンで既に使用されているチェーン ID を持つネットワークを追加できますか? A: はい。ただし、両方のチェーンが同一の ID を共有し、ウォレットがエンドポイントだけでそれらを区別できない場合、トランザクションが誤ってルーティングされる危険性があります。チェーン ID の一意性を常に公式ソースを通じて確認してください。

Q: カスタム ネットワークを追加すると、現在のブロック番号として「0x0」が表示されるのはなぜですか? A: これは、RPC エンドポイントが eth_blockNumber に対して null または空のデータを返したことを示します。ノードが完全に同期されており、認証されていない JSON-RPC GET/POST リクエストを受け入れることを確認します。

Q: カスタム ネットワーク構成ファイル (.json など) を OKX ウォレットにインポートすることはできますか? A: いいえ。OKX ウォレットはネットワーク定義の一括インポートをサポートしていません。すべてのエントリは、個別のフィールド検証を使用して UI を通じて手動で追加する必要があります。

Q: カスタム ネットワークは EIP-1559 料金市場をサポートしていますか? A: サポートは基盤となる RPC プロバイダーに完全に依存します。ノードが eth_maxPriorityFeePerGas および関連メソッドを実装している場合、OKX ウォレットには動的な料金オプションが表示されます。それ以外の場合は、従来のガス料金が適用されます。