如何為 OKX 錢包添加自訂網絡

網路配置要求

1. 手動網路設定時必須提供有效的 Chain ID。 OKX 錢包在允許網路註冊之前嚴格驗證該值。

2. RPC URL 必須啟用 HTTPS 並且可公開存取。無效或無法存取的端點將導致連線失敗和錢包被拒絕。

3. 區塊瀏覽器 URL 必須指向功能性的、特定於鏈的瀏覽器介面。缺少或配置錯誤的瀏覽器會阻止交易驗證和資產追蹤。

4. 貨幣符號欄位僅接受最多六個字元的大寫字母數字字串。超過長度或包含特殊字元的符號會觸發輸入拒絕。

5. 網路名稱支援Unicode，但不得包含控製字元或空位元組。具有不可見 Unicode 修飾符的名稱可能會導致跨裝置類型的顯示不一致。

逐步手動新增流程

1. 啟動 OKX 錢包擴充並導覽至設定 → 網路 → 新增網路。

2. 選擇「自訂網路」並輸入所需參數：網路名稱、新 RPC URL、鏈 ID、貨幣符號和區塊瀏覽器 URL。

3. 點選「儲存」開始驗證。錢包對 RPC 端點執行即時連線檢查。

4. 如果驗證通過，網路將顯示在活動清單中，並且可以從頂部導覽列中選擇。

5. 如果驗證失敗，錯誤訊息會指定確切的失敗點，例如逾時、無效的鏈 ID 或 CORS 區塊，而沒有通用的後備措施。

鏈 ID 驗證邏輯

1. Chain ID 解析為以 10 為基數的整數。十六進位或浮點輸入將立即被拒絕。

2. 1–2147483647 範圍之外的值會產生溢位錯誤。不允許使用負數或零。

3. 設定網路中重複的 Chain ID 會觸發衝突警告。錢包禁止保存重疊的識別符。

4.像以太坊（1）、BSC（56）和XLayer（196）這樣的預定義鏈強制執行嚴格的不變性。自訂條目無法覆蓋這些預設值。

5. 測試網鏈 ID 遵循不同的範圍：XLayer 測試網使用 195，而 XLayer 測試網 v2 使用 1952。版本不符會導致靜默交易失敗。

RPC 端點行為規則

1. 錢包在儲存時發送輕量級 eth_chainId 請求。初始驗證期間不會發生餘額或帳戶查詢。

2. 超時預設為 8 秒。在此視窗內未能回應的網路將被標記為「無法存取」。

3. CORS 標頭必須包含 * 或明確的 OKX 錢包源域。缺席會在瀏覽器層級阻止跨來源請求。

4. 回應必須傳回符合 JSON-RPC 2.0 標準的格式，其中包含「id」、「jsonrpc」和「result」欄位。格式錯誤的有效負載會立即導致拒絕。

5. 傳回 HTTP 429 的速率限制端點將快取 120 秒。該視窗內的後續嘗試完全繞過網路呼叫。

常見問題解答

Q1.我可以新增 Chain 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。自訂網路是否使用相同的種子短語在裝置之間同步？不會。網路配置在每次安裝時都儲存在本地，並且不是助記詞復原的一部分。每個設備都需要獨立的手動設定。