Benutzerdefiniertes RPC-Setup für MetaMask und Rabby: URL und Chain-ID

Fügen Sie die RPC-URL, Chain-ID und das native Symbol in MetaMask oder Rabby hinzu und verwenden Sie einen dedizierten Wallet-Schlüssel, wenn eine Authentifizierung erforderlich ist.

• Erster Schritt: Lesen Sie die Tabelle der Netzwerkparameter für Wallets und geben Sie deren Felder in Ihrer Wallet ein, wobei Sie /v1/{chain}/{api_key} für authentifizierten RPC verwenden.
• Abgeschlossen, wenn: Das Speichern das Netzwerk hinzufügt und in MetaMask dorthin wechselt; die konfigurierte Chain-ID stimmt mit der vom Endpunkt zurückgegebenen ID überein.

Chain-Parameter und Zugriffsoptionen.

1. Warum ein benutzerdefinierter RPC sinnvoll ist

Blockchain-Ökosysteme stellen im Allgemeinen standardmäßige öffentliche RPC-Endpunkte für die grundlegende Nutzung in der Community und das Onboarding von Entwicklern bereit. Die offizielle Netzwerkdokumentation definiert jedoch ausdrückliche Ratenbegrenzungen und Nutzungsumfänge für diese Endpunkte:

• Robinhood Chain: Die offizielle Dokumentationsseite Connecting to Robinhood Chain weist darauf hin, dass der öffentliche Endpunkt https://rpc.mainnet.chain.robinhood.com ratenbegrenzt ist und nicht für Produktions-Workloads empfohlen wird (The following public endpoints are available but are rate-limited and not recommended for production use. For production, use a provider).
• HyperEVM: Die offizielle Dokumentationsseite Rate limits and user limits gibt ein IP-basiertes Limit für den öffentlichen Endpunkt rpc.hyperliquid.xyz/evm von maximal 100 EVM-JSON-RPC-Anfragen pro Minute an (Maximum of 100 EVM JSON-RPC requests per minute for rpc.hyperliquid.xyz/evm).

2. Erforderliche Wallet-Felder und Netzwerkparameter

EVM-Wallets erfordern beim Hinzufügen oder Bearbeiten eines Netzwerks mehrere spezifische Felder:

1. Netzwerkname: Die lesbare Bezeichnung, die in der Benutzeroberfläche der Wallet angezeigt wird.
2. RPC-URL: Der Kommunikationsendpunkt. Der API-Schlüssel muss im URL-Pfad platziert werden, unter Verwendung des Pfads /v1/{chain}/{api_key} auf api.blockvectra.com:

   Text kopieren

   /v1/{chain}/{api_key}

   Wichtig: Wallets wie MetaMask und Rabby akzeptieren im Feld RPC-URL nur standardmäßige HTTP(S)-URLs und unterstützen keine benutzerdefinierten Anfrage-Header (wie x-api-key: {api_key}). Folglich müssen Wallet-Verbindungen den API-Schlüssel direkt im URL-Pfad übergeben. Fügen Sie nach {api_key} keinen abschließenden Schrägstrich ein und beachten Sie, dass Anfragen an eine unbekannte {chain} HTTP 404 zurückgeben.

3. Chain-ID: Die ganzzahlige Chain-Kennung nach EIP-155.
4. Währungssymbol: Das Symbol des nativen Gas-Assets der Chain (z. B. ETH, HYPE).
5. Block-Explorer-URL: Die primäre Webadresse des Block-Explorers des Netzwerks.

Tabelle der Netzwerkparameter für unterstützte Chains

HyperEVM-Nur-Lese-Einschränkung: Der HyperEVM-Endpunkt von BlockVectra unterstützt Leseoperationen, überträgt jedoch keine Transaktionen. Verwenden Sie einen RPC, der eth_sendRawTransaction unterstützt, wenn Sie Transaktionen von Ihrer Wallet aus senden. Siehe Deploy mit Foundry oder Hardhat im HyperEVM-Leitfaden für Details zur Übertragung.

Ein API-Schlüssel funktioniert über alle unterstützten Chains hinweg, indem {chain} im Pfad durch den gewünschten Chain-Slug ersetzt wird. Details zu geteilten Kontingenten und URL-Routing finden Sie im Leitfaden Ein Key, viele Chains.

3. Schritt-für-Schritt-Anleitung für Wallets

Konfigurationsschritte für MetaMask

Basierend auf dem offiziellen MetaMask-Hilfeleitfaden How to add a custom network RPC:

1. Öffnen Sie die MetaMask-Browsererweiterung oder die mobile App.
2. Klicken Sie oben auf das Dropdown-Menü zur Netzwerkauswahl (oder navigieren Sie zu Einstellungen > Netzwerke).
3. Wählen Sie Netzwerk hinzufügen und anschließend unten Netzwerk manuell hinzufügen.
4. Füllen Sie die Netzwerkdetails anhand der obigen Tabelle aus:
   • Netzwerkname: Geben Sie den Chain-Namen aus der obigen Tabelle ein.
   • Neue RPC-URL: Geben Sie Ihren pfad-authentifizierten Endpunkt ein, z. B. https://api.blockvectra.com/v1/robinhood_mainnet/{api_key} (ersetzen Sie {api_key} durch Ihren tatsächlichen API-Schlüssel).
   • Chain-ID: Geben Sie die ganzzahlige Chain-ID aus der obigen Tabelle ein.
   • Währungssymbol: Geben Sie das native Asset-Symbol aus der obigen Tabelle ein.
   • Block-Explorer-URL: Geben Sie die offizielle Block-Explorer-Adresse aus der obigen Tabelle ein (optional).
5. Klicken Sie auf Speichern, um das Netzwerk hinzuzufügen und dorthin zu wechseln.

Transaktionen auf HyperEVM senden: Der HyperEVM-Endpunkt von BlockVectra unterstützt Leseoperationen, überträgt jedoch keine Transaktionen. Verwenden Sie einen RPC, der eth_sendRawTransaction unterstützt, wenn Sie Transaktionen von Ihrer Wallet aus senden (siehe die Erläuterung zum Senden auf HyperEVM).

Bestehendes Netzwerk bearbeiten: Um den RPC-Endpunkt für ein Netzwerk zu aktualisieren, das sich bereits in Ihrer Liste befindet, gehen Sie zu Einstellungen > Netzwerke, wählen Sie das Zielnetzwerk aus, bearbeiten oder ergänzen Sie Ihre BlockVectra-URL im Feld RPC-URL und speichern Sie Ihre Änderungen.

Konfigurationsschritte für Rabby Wallet

Geben Sie in den Einstellungen für benutzerdefinierte Netzwerke oder benutzerdefinierte RPCs von Rabby die Parameter aus der obigen Tabelle ein: Netzwerkname, RPC-URL (mit dem Pfad-Schlüssel https://api.blockvectra.com/v1/{chain}/{api_key}), Chain-ID, Währungssymbol und Block-Explorer-URL.

Hinweis: Stellen Sie beim Hinzufügen eines benutzerdefinierten Netzwerks oder Testnets sicher, dass die Chain-ID mit der vom Endpunkt zurückgegebenen ID übereinstimmt, um Netzwerk-ID-Diskrepanzfehler zu vermeiden.

4. Sicherheitstipps und Nutzungsverwaltung

Beachten Sie beim Betrieb eines benutzerdefinierten RPC die folgenden Sicherheits- und Abrechnungsprinzipien:

[!WARNING] Risiko der Offenlegung des API-Schlüssels: Der RPC-URL-Pfad enthält Ihren API-Schlüssel im Klartext. Teilen Sie niemals Screenshots Ihrer Wallet-Netzwerkkonfiguration in öffentlichen Chaträumen oder Foren und committen Sie keine URLs, die Ihren aktiven Schlüssel enthalten, in öffentliche Code-Repositories oder Dokumentationen.

1. Wallet-Anfragen zählen zur Kontonutzung: Das Öffnen der Wallet, das Wechseln von Konten oder das Aktualisieren von Asset-Listen löst direkte JSON-RPC-Aufrufe aus (wie eth_blockNumber, eth_getBalance und eth_call). Diese Anfragen verbrauchen Kapazität gemäß dem CU-Gewicht der aufgerufenen Methode (siehe die Preisseite) im Rahmen Ihrer Kontolimits.
2. Erstellen Sie einen dedizierten API-Schlüssel für jede Wallet: Erstellen Sie in der Konsole einen dedizierten API-Schlüssel, der speziell für Ihre Wallet gekennzeichnet ist (z. B. metamask-desktop oder rabby-extension). Dadurch bleibt der Datenverkehr Ihrer persönlichen Wallet von Ihren Serveranwendungen, automatisierten Skripten und KI-Agenten isoliert.
3. Unabhängiger Widerruf bei Kompromittierung: Wenn Sie vermuten, dass ein in einer Wallet konfigurierter API-Schlüssel offengelegt wurde, widerrufen Sie diesen einzelnen Schlüssel sofort in der Konsole, ohne andere aktive Schlüssel oder Dienste zu beeinträchtigen. Falls Ihre Sitzung abläuft oder ein Schlüssel verloren geht, lesen Sie Session oder API key verloren? im Leitfaden zur programmatischen Registrierung, um die Kontrolle über Ihre Ethereum-Wallet-Signatur wiederzuerlangen.

5. Zugehörige Ressourcen

• Limits für historischen State: Prüfen Sie authentifizierte State-Fenster und schlüssellosen Verlauf vor der Abfrage früherer Guthaben oder Contract-Werte; Abfragespannen für Logs unterliegen einem separaten Limit.
• Leitfaden Ein Key, viele Chains: Detaillierte URL-Routing-Regeln, programmatische Ermittlung mit GET /v1/chains und Mechanismen für chain-übergreifende Kontingente.
• Preise und Tariflimits: Informationen zu CU-Gewichten, Durchsatz-Auffüllraten und Upgrades per Zahlungseinzahlung.

Nächste Schritte

• Datensatzverzeichnis durchsuchen, um alle von BlockVectra indexierten Datensätze zu sehen.
• Kostenlosen Tarif und Preise ansehen, um zu prüfen, was Ihr Konto beinhaltet.
• In der Konsole anmelden, um einen API-Schlüssel zu erstellen.