Comment ajouter un réseau personnalisé à OKX Wallet

Exigences de configuration réseau

1. Un ID de chaîne valide doit être fourni lors de la configuration manuelle du réseau. Le portefeuille OKX valide strictement cette valeur avant d'autoriser l'enregistrement sur le réseau.

2. L'URL RPC doit être compatible HTTPS et accessible publiquement. Des points de terminaison invalides ou inaccessibles entraîneront un échec de connexion et le rejet du portefeuille.

3. L'URL de l'explorateur de blocs doit pointer vers une interface d'explorateur fonctionnelle et spécifique à la chaîne. Les explorateurs manquants ou mal configurés empêchent la vérification des transactions et le suivi des actifs.

4. Le champ Symbole monétaire accepte uniquement les chaînes alphanumériques majuscules comportant jusqu'à six caractères. Les symboles dépassant la longueur ou contenant des caractères spéciaux déclenchent le rejet de la saisie.

5. Le nom du réseau prend en charge Unicode mais ne doit pas contenir de caractères de contrôle ni d'octets nuls. Les noms comportant des modificateurs Unicode invisibles peuvent entraîner un affichage incohérent sur tous les types d'appareils.

Processus d'ajout manuel étape par étape

1. Lancez l'extension OKX Wallet et accédez à Paramètres → Réseau → Ajouter un réseau.

2. Sélectionnez « Réseau personnalisé » et entrez les paramètres requis : nom du réseau, nouvelle URL RPC, ID de chaîne, symbole monétaire et URL de l'explorateur de blocs.

3. Appuyez sur « Enregistrer » pour lancer la validation. Wallet effectue des vérifications de connectivité en temps réel par rapport au point de terminaison RPC.

4. Si la validation réussit, le réseau apparaît dans la liste active et devient sélectionnable dans la barre de navigation supérieure.

5. Si la validation échoue, les messages d'erreur spécifient les points d'échec exacts, tels qu'un délai d'attente, un ID de chaîne non valide ou un bloc CORS, sans solutions de secours génériques.

Logique de validation de l'ID de chaîne

1. L’ID de chaîne est analysé comme un entier en base 10. Les entrées hexadécimales ou à virgule flottante sont immédiatement rejetées.

2. Les valeurs en dehors de la plage 1–2147483647 produisent des erreurs de débordement. Les nombres négatifs ou zéro sont interdits.

3. Les ID de chaîne en double sur les réseaux configurés déclenchent des avertissements de conflit. Wallet interdit l'enregistrement d'identifiants qui se chevauchent.

4. Les chaînes prédéfinies comme Ethereum (1), BSC (56) et XLayer (196) appliquent une immuabilité stricte. Les entrées personnalisées ne peuvent pas remplacer ces valeurs par défaut.

5. Les ID de chaîne Testnet suivent des plages distinctes : XLayer Testnet utilise 195, tandis que XLayer Testnet v2 utilise 1952. Les versions incompatibles entraînent des échecs de transaction silencieux.

Règles de comportement des points de terminaison RPC

1. Wallet envoie une requête eth_chainId légère lors de l'enregistrement. Aucune requête de solde ou de compte n’a lieu lors de la validation initiale.

2. Les délais d'attente sont par défaut de 8 secondes. Les réseaux qui ne répondent pas dans cette fenêtre sont marqués comme « inaccessibles ».

3. Les en-têtes CORS doivent inclure * ou des domaines d'origine OKX Wallet explicites. L'absence bloque les requêtes cross-origin au niveau du navigateur.

4. Les réponses doivent renvoyer un format compatible JSON-RPC 2.0 avec les champs « id », « jsonrpc » et « result ». Les charges utiles mal formées provoquent un rejet immédiat.

5. Les points de terminaison à débit limité renvoyant HTTP 429 sont mis en cache pendant 120 secondes. Les tentatives ultérieures au sein de cette fenêtre contournent entièrement les appels réseau.

Foire aux questions

T1. Puis-je ajouter un réseau avec l'ID de chaîne 0 ? L’ID de chaîne 0 est explicitement interdit. Le portefeuille le rejette avec le code d'erreur NW-ERR-003 lors de l'analyse des paramètres.

Q2. OKX Wallet prend-il en charge les requêtes EIP-3085 wallet_addEthereumChain ? Non. OKX Wallet n'implémente pas EIP-3085. Il s'appuie uniquement sur son interface utilisateur de configuration réseau interne et n'accepte pas les invites d'ajout de réseau lancées par dapp.

Q3. Pourquoi mon RPC personnalisé affiche-t-il « Connecté » mais ne parvient-il pas à charger les soldes ? Cela indique une réponse eth_chainId réussie, mais les appels eth_getBalance ultérieurs renvoyant des données nulles ou mal formées. Vérifiez que votre nœud fournit des réponses d'état complètes et prend en charge la version d'API correcte.

Q4. Les réseaux personnalisés sont-ils synchronisés sur tous les appareils en utilisant la même phrase de départ ? Non. Les configurations réseau sont stockées localement par installation et ne font pas partie de la récupération des phrases de départ. Chaque appareil nécessite une configuration manuelle indépendante.