So fügen Sie OKX Wallet ein benutzerdefiniertes Netzwerk hinzu

Anforderungen an die Netzwerkkonfiguration

1. Bei der manuellen Netzwerkeinrichtung muss eine gültige Ketten-ID angegeben werden. Das OKX Wallet überprüft diesen Wert streng, bevor es die Netzwerkregistrierung zulässt.

2. Die RPC-URL muss HTTPS-fähig und öffentlich zugänglich sein. Ungültige oder nicht erreichbare Endpunkte führen zu Verbindungsfehlern und zur Ablehnung des Wallets.

3. Die Block-Explorer-URL muss auf eine funktionale, kettenspezifische Explorer-Schnittstelle verweisen. Fehlende oder falsch konfigurierte Explorer verhindern die Transaktionsüberprüfung und Vermögensverfolgung.

4. Das Feld „Währungssymbol“ akzeptiert nur alphanumerische Zeichenfolgen in Großbuchstaben mit bis zu sechs Zeichen. Symbole, die die Länge überschreiten oder Sonderzeichen enthalten, führen zur Ablehnung der Eingabe.

5. Der Netzwerkname unterstützt Unicode, darf jedoch keine Steuerzeichen oder Nullbytes enthalten. Namen mit unsichtbaren Unicode-Modifikatoren können zu einer inkonsistenten Anzeige bei allen Gerätetypen führen.

Schritt-für-Schritt-Anleitung zum manuellen Additionsprozess

1. Starten Sie die OKX Wallet-Erweiterung und navigieren Sie zu Einstellungen → Netzwerk → Netzwerk hinzufügen.

2. Wählen Sie „Benutzerdefiniertes Netzwerk“ und geben Sie die erforderlichen Parameter ein: Netzwerkname, neue RPC-URL, Ketten-ID, Währungssymbol und Block-Explorer-URL.

3. Tippen Sie auf „Speichern“, um die Validierung zu starten. Wallet führt Echtzeit-Konnektivitätsprüfungen für den RPC-Endpunkt durch.

4. Wenn die Validierung erfolgreich ist, wird das Netzwerk in der aktiven Liste angezeigt und kann in der oberen Navigationsleiste ausgewählt werden.

5. Wenn die Validierung fehlschlägt, geben Fehlermeldungen genaue Fehlerpunkte an – z. B. Zeitüberschreitung, ungültige Ketten-ID oder CORS-Block – ohne generische Fallbacks.

Logik zur Ketten-ID-Validierung

1. Die Ketten-ID wird als Ganzzahl zur Basis 10 geparst. Hexadezimale oder Gleitkomma-Eingaben werden sofort abgelehnt.

2. Werte außerhalb des Bereichs 1–2147483647 führen zu Überlauffehlern. Negative Zahlen oder Nullen sind nicht zulässig.

3. Doppelte Ketten-IDs in konfigurierten Netzwerken lösen Konfliktwarnungen aus. Wallet verbietet das Speichern überlappender Kennungen.

4. Vordefinierte Ketten wie Ethereum (1), BSC (56) und XLayer (196) erzwingen strikte Unveränderlichkeit. Benutzerdefinierte Einträge können diese Standardeinstellungen nicht überschreiben.

5. Testnet-Ketten-IDs folgen unterschiedlichen Bereichen: XLayer Testnet verwendet 195, während XLayer Testnet v2 1952 verwendet. Nicht übereinstimmende Versionen führen zu stillen Transaktionsfehlern.

Verhaltensregeln für RPC-Endpunkte

1. Wallet sendet beim Speichern eine einfache eth_chainId-Anfrage. Bei der Erstvalidierung erfolgen keine Saldo- oder Kontoabfragen.

2. Die Zeitüberschreitungen betragen standardmäßig 8 Sekunden. Netzwerke, die innerhalb dieses Fensters nicht antworten, werden als „nicht erreichbar“ markiert.

3. CORS-Header müssen * oder explizite OKX Wallet-Ursprungsdomänen enthalten. Absence blockiert ursprungsübergreifende Anfragen auf Browserebene.

4. Antworten müssen ein JSON-RPC 2.0-kompatibles Format mit den Feldern „id“, „jsonrpc“ und „result“ zurückgeben. Falsch formatierte Nutzlasten führen zur sofortigen Ablehnung.

5. Endpunkte mit begrenzter Geschwindigkeit, die HTTP 429 zurückgeben, werden 120 Sekunden lang zwischengespeichert. Nachfolgende Versuche innerhalb dieses Fensters umgehen Netzwerkanrufe vollständig.

Häufig gestellte Fragen

Q1. Kann ich ein Netzwerk mit Chain-ID 0 hinzufügen? Die Ketten-ID 0 ist ausdrücklich verboten. Das Wallet lehnt es während der Parameteranalyse mit dem Fehlercode NW-ERR-003 ab.

Q2. Unterstützt OKX Wallet EIP-3085 wallet_addEthereumChain-Anfragen? Nein. OKX Wallet implementiert EIP-3085 nicht. Es verlässt sich ausschließlich auf die Benutzeroberfläche für die interne Netzwerkkonfiguration und akzeptiert keine von Dapp initiierten Eingabeaufforderungen zum Hinzufügen von Netzwerken.

Q3. Warum zeigt mein benutzerdefinierter RPC „Verbunden“ an, kann aber keine Lastausgleiche durchführen? Dies weist auf eine erfolgreiche eth_chainId-Antwort hin, aber nachfolgende eth_getBalance-Aufrufe geben null oder fehlerhafte Daten zurück. Stellen Sie sicher, dass Ihr Knoten vollständige Statusantworten bereitstellt und die richtige API-Version unterstützt.

Q4. Werden benutzerdefinierte Netzwerke geräteübergreifend mit derselben Startphrase synchronisiert? Nein. Netzwerkkonfigurationen werden lokal pro Installation gespeichert und sind nicht Teil der Seed-Phrase-Wiederherstellung. Jedes Gerät erfordert eine unabhängige manuelle Einrichtung.