Base RPC URL: schlüsselloser Zugriff, curl- und viem-Beispiele

Verbinden Sie sich mit dem Base Mainnet über eine öffentliche RPC-URL oder einen API key. Nutzen Sie curl- und viem-Beispiele, prüfen Sie unterstützte Methoden und Limits und untersuchen Sie den Data-API-Status.

Beginnen Sie mit der unten stehenden öffentlichen RPC-URL für das Base Mainnet, um die Chain ID ohne API key abzufragen. Prüfen Sie die unterstützten Methoden und Limits pro IP auf der Base-Chain-Seite; verwenden Sie für Methoden außerhalb von public.methods, die von der Chain zugelassen sind, einen Key.

curl -sS "https://api.blockvectra.com/v1/base_mainnet/public" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Netzwerkinformationen und Endpunkte

Jede Anfrage an Base identifiziert ihr Zielnetzwerk explizit im URL-Pfad über den Slug base_mainnet. JSON-RPC unterstützt sowohl die pfadbasierte Key-Authentifizierung als auch die Authentifizierung über den Request-Header (x-api-key).

Parameter / EndpunktWert / VorlageAuthentifizierung
Chain-ID (EIP-155)8453—
JSON-RPC (Schlüssel im Pfad)POST https://api.blockvectra.com/v1/base_mainnet/{api_key}API-Key im URL-Pfad
JSON-RPC (Schlüssel im Header)POST https://api.blockvectra.com/v1/base_mainnetHeader x-api-key: {api_key}
Data-API-BasisGET https://api.blockvectra.com/v1/data/base_mainnet/…Header x-api-key: {api_key}
Öffentlicher StatusGET https://api.blockvectra.com/v1/statusNicht authentifiziert (öffentlich)

Direkte curl- und viem-Beispiele

Sie können JSON-RPC-Aufrufe direkt mit curl oder Web3-Client-Bibliotheken wie viem durchführen. Setzen Sie Ihren API key in der Umgebungsvariable BLOCKVECTRA_API_KEY:

Fragen Sie die EIP-155 Chain ID über den x-api-key-Request-Header ab:

curl -s "https://api.blockvectra.com/v1/base_mainnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Antwortstruktur

Antworten entsprechen der JSON-RPC 2.0-Spezifikation:

  • Erfolg: Gibt ein Objekt zurück, das jsonrpc: "2.0", die passende Integer-id und ein hexadezimal kodiertes result enthält (eth_chainId gibt die hex-kodierte Chain ID zurück; eth_blockNumber gibt die aktuelle Blockhöhe zurück).
  • Nicht zulässige Methoden: Das Anfordern einer Methode außerhalb der für das Netzwerk zulässigen Methoden gibt den JSON-RPC-Fehlercode -32601 zurück (method not available, nicht abgerechnet).
  • Abfragen außerhalb des Statusfensters: Historische Statusabfragen, die vor dem Aufbewahrungsfenster für den Status liegen, geben den JSON-RPC-Fehlercode -32011 zurück (nicht abgerechnet).
  • Fehlender API key: Das Weglassen des Keys gibt HTTP 401 mit dem JSON-RPC-Fehlercode -32024 zurück (missing_api_key, nicht abgerechnet).
  • Ungültige Parameter: Fehlerhafte Anfrageparameter geben den JSON-RPC-Fehlercode -32602 zurück (nicht abgerechnet).

Funktions- und Methodenrichtlinie

Live-Werte: GET /v1/chains (methods, max_logs_block_range, state_window_blocks).

Netzwerkparameter und Limits

  • eth_getLogs-Blockbereich: Max. 1000 Blöcke pro Anfrage
  • Historisches Statusfenster: Letzte 10000 Blöcke (Abfragen darüber hinaus geben -32011 zurück)
  • Ausführungstracing (debug_trace*): Nicht verfügbar

Zulässige Methoden pro Chain: Unterstützte Chains

Blockchain-Data-API

Live-Werte: GET /v1/chains (data).

Status der Blockchain Data API

Verfügbar — Die Blockchain Data API ist auf Base verfügbar. Durchsuchen Sie die unterstützten Datensätze im Datensatz-Verzeichnis. Datensatz-Verzeichnis durchsuchen →

Erste Schritte und API keys

Neue Konten erhalten 30,000,000 CU bei der Registrierung — keine Kreditkarte erforderlich.
  • Web-Konsole: Registrieren Sie sich über die Signatur eines Ethereum-Wallets und erstellen Sie einen API key in der Konsole. Details zur Einrichtung finden Sie im Schnellstart-Leitfaden.
  • Programmatische Registrierung: Autonome AI Agents, automatisierte Skripte und CI-Pipelines können sich ohne Browser über Ethereum-Wallet-Signaturen (EIP-191) anmelden und API keys bereitstellen. Folgen Sie dem Leitfaden zur programmatischen Registrierung.
  • AI Agents: Autonome AI Agents können Base-Funktionen über den offiziellen Model Context Protocol (MCP)-Server ermitteln. Siehe AI Agents mit BlockVectra verbinden.
  • Limits erhöhen: Nach dem Aufladen wird das kontoweite Limit für Aufrufe pro Sekunde aufgehoben; jeder Key unterliegt weiterhin den Compute Unit (CU)-Rate- und Burst-Limits. Aktuelle Tarife und Abrechnungseinheiten finden Sie auf der Preisseite.
  • Base-Entwicklerdokumentation: Netzwerkspezifikationen, Gas-Mechanik und Verträge auf Base finden Sie in der offiziellen Base-Dokumentation.
  • Benutzerdefinierter Wallet-RPC: Konfigurieren Sie benutzerdefinierte RPC-Endpunkte für Base in MetaMask und Rabby anhand des Leitfadens für benutzerdefinierten Wallet-RPC.
  • Transaktionssimulation: Testen Sie die Ausführung von Transaktionen und evaluieren Sie Statusänderungen vor dem Broadcasting mit eth_simulateV1 im Leitfaden zur Transaktionssimulation.

Nächste Schritte

Zuletzt aktualisiert:

Auf dieser Seite