如何向 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。自定义网络是否使用相同的种子短语在设备之间同步？不会。网络配置在每次安装时都存储在本地，并且不是助记词恢复的一部分。每个设备都需要独立的手动设置。