OKX ウォレットにカスタム ネットワークを追加する方法

ネットワーク構成要件

1. 手動ネットワーク設定中に有効なチェーン ID を指定する必要があります。 OKX ウォレットは、ネットワーク登録を許可する前に、この値を厳密に検証します。

2. RPC URL は HTTPS 対応であり、パブリックにアクセスできる必要があります。エンドポイントが無効または到達不能であると、接続が失敗し、ウォレットが拒否されます。

3. ブロック エクスプローラー URL は、機能的なチェーン固有のエクスプローラー インターフェイスを指している必要があります。エクスプローラーが見つからないか構成が間違っていると、トランザクションの検証と資産の追跡ができなくなります。

4. 通貨記号フィールドには、最大 6 文字の大文字の英数字文字列のみを受け入れます。長さを超えるシンボル、または特殊文字が含まれるシンボルは、入力拒否をトリガーします。

5. ネットワーク名は Unicode をサポートしますが、制御文字やヌルバイトを含めることはできません。非表示の Unicode 修飾子を含む名前は、デバイス タイプ間で表示に一貫性がなくなる可能性があります。

段階的な手動追加プロセス

1. OKX ウォレット拡張機能を起動し、[設定] → [ネットワーク] → [ネットワークの追加] に移動します。

2. [カスタム ネットワーク] を選択し、必要なパラメータ (ネットワーク名、新しい RPC URL、チェーン ID、通貨記号、およびブロック エクスプローラー URL) を入力します。

3. 「保存」をタップして検証を開始します。ウォレットは、RPC エンドポイントに対してリアルタイムの接続チェックを実行します。

4. 検証に合格すると、ネットワークがアクティブ リストに表示され、上部のナビゲーション バーから選択できるようになります。

5. 検証が失敗した場合、エラー メッセージは、一般的なフォールバックを行わずに、タイムアウト、無効なチェーン ID、CORS ブロックなどの正確な失敗ポイントを示します。

チェーン ID 検証ロジック

1. チェーン ID は基数 10 の整数として解析されます。 16 進数または浮動小数点の入力は直ちに拒否されます。

2. 1 ～ 2147483647 の範囲外の値を指定すると、オーバーフロー エラーが発生します。負の数値またはゼロは許可されません。

3. 構成されたネットワーク全体でチェーン ID が重複すると、競合警告がトリガーされます。ウォレットでは重複する識別子の保存を禁止しています。

4. Ethereum (1)、BSC (56)、XLayer (196) などの事前定義されたチェーンは、厳密な不変性を強制します。カスタム エントリはこれらのデフォルトをオーバーライドできません。

5. テストネット チェーン ID は明確な範囲に従います。XLayer テストネットは 195 を使用しますが、XLayer テストネット v2 は 1952 を使用します。バージョンが一致しないと、サイレント トランザクションのエラーが発生します。

RPC エンドポイントの動作ルール

1. ウォレットは保存時に軽量の eth_chainId リクエストを送信します。初期検証中に残高や口座のクエリは発生しません。

2. タイムアウトのデフォルトは 8 秒です。このウィンドウ内で応答しないネットワークは、「到達不能」としてマークされます。

3. CORS ヘッダーには * または明示的な OKX ウォレットのオリジン ドメインが含まれている必要があります。不在はブラウザレベルでクロスオリジンリクエストをブロックします。

4. 応答は、「id」、「jsonrpc」、および「result」フィールドを含む JSON-RPC 2.0 準拠の形式を返す必要があります。不正な形式のペイロードは即座に拒否されます。

5. HTTP 429 を返すレート制限されたエンドポイントは 120 秒間キャッシュされます。そのウィンドウ内のその後の試行は、ネットワーク呼び出しを完全にバイパスします。

よくある質問

Q1.チェーン ID 0 のネットワークを追加できますか?チェーン ID 0 は明示的に禁止されています。ウォレットはパラメータの解析中にエラー コード NW-ERR-003 で拒否します。

Q2. OKX ウォレットは EIP-3085 Wallet_addEthereumChain リクエストをサポートしていますか?いいえ、OKX ウォレットは EIP-3085 を実装していません。これは内部ネットワーク構成 UI のみに依存し、dapp によって開始されるネットワーク追加プロンプトを受け入れません。

Q3.カスタム RPC に「接続済み」と表示されるのに、負荷分散に失敗するのはなぜですか?これは、eth_chainId 応答は成功したが、後続の eth_getBalance 呼び出しで null または不正な形式のデータが返されたことを示します。ノードが完全な状態応答を提供し、正しい API バージョンをサポートしていることを確認してください。

Q4.カスタム ネットワークは、同じシード フレーズを使用してデバイス間で同期されますか?いいえ。ネットワーク構成はインストールごとにローカルに保存され、シード フレーズの回復には含まれません。各デバイスには個別の手動セットアップが必要です。