URL RPC Base : accès sans clé et exemples en curl et viem

Commencez avec l'URL RPC publique de Base mainnet ci-dessous pour lire le Chain ID sans API key. Consultez les méthodes prises en charge et les limites par IP sur la page de la chaîne Base ; utilisez une clé pour les méthodes hors de public.methods autorisées par la chaîne.

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":[]}'

Informations sur le réseau et points de terminaison

Chaque requête vers Base identifie explicitement son réseau cible dans le chemin d'URL à l'aide du slug base_mainnet. Le JSON-RPC prend en charge l'authentification par clé dans le chemin ainsi que par l'en-tête de requête (x-api-key).

Exemples directs en curl et viem

Vous pouvez effectuer des appels JSON-RPC directement à l'aide de curl ou de bibliothèques clientes web3 telles que viem. Définissez votre API key dans la variable d'environnement BLOCKVECTRA_API_KEY :

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":[]}'

Structure de la réponse

Les réponses respectent la spécification JSON-RPC 2.0 :

• Succès : renvoie un objet contenant jsonrpc: "2.0", l'id entier correspondant, et un result encodé en hexadécimal (eth_chainId renvoie le Chain ID encodé en hexadécimal ; eth_blockNumber renvoie la hauteur du dernier bloc).
• Méthodes non autorisées : demander une méthode en dehors des méthodes autorisées du réseau renvoie le code d'erreur JSON-RPC -32601 (method not available, non facturé).
• Requêtes hors fenêtre : les requêtes d'état historique antérieures à la fenêtre de rétention d'état renvoient le code d'erreur JSON-RPC -32011 (non facturé).
• API key manquante : omettre la clé renvoie HTTP 401 avec le code d'erreur JSON-RPC -32024 (missing_api_key, non facturé).
• Paramètres invalides : des paramètres de requête malformés renvoient le code d'erreur JSON-RPC -32602 (non facturé).

Fonctionnalités et politique des méthodes

Valeurs en direct : GET /v1/chains (methods, max_logs_block_range, state_window_blocks).

Blockchain Data API

Valeurs en direct : GET /v1/chains (data).

Démarrage et API keys

• Console web : inscrivez-vous via signature de portefeuille Ethereum et générez une clé API dans la Console. Consultez le guide de Démarrage rapide pour les détails de configuration.
• Inscription programmatique : les agents IA autonomes, scripts automatisés et pipelines CI peuvent se connecter et provisionner des clés API à l'aide de signatures de portefeuille Ethereum (EIP-191) sans navigateur. Suivez le guide d'inscription programmatique.
• Agents IA : les agents IA autonomes peuvent découvrir les fonctionnalités de Base à l'aide du serveur officiel Model Context Protocol (MCP). Consultez Connecter des agents IA à BlockVectra.
• Augmentation des limites : après une recharge, la limite d'appels par seconde à l'échelle du compte est levée ; chaque clé reste soumise aux limites de débit et de burst en Compute Units (CU). Pour les tarifs actuels et les unités de facturation, consultez la page Tarifs.

Guides et ressources associés

• Documentation développeur Base : pour les spécifications du réseau, la mécanique du gas et les contrats sur Base, consultez la documentation officielle de Base.
• RPC personnalisé pour portefeuille : configurez des points de terminaison RPC personnalisés pour Base dans MetaMask et Rabby à l'aide du guide RPC personnalisé pour portefeuille.
• Simulation de transaction : testez l'exécution des transactions et évaluez les changements d'état avant leur diffusion avec eth_simulateV1 dans le guide de simulation de transactions.

Prochaines étapes

• Parcourir le répertoire des jeux de données pour voir chaque jeu de données indexé par BlockVectra.
• Consulter le forfait gratuit et les tarifs pour vérifier ce que comprend votre compte.
• Se connecter à la console pour créer une API key.