Configuration d'un RPC personnalisé dans MetaMask et Rabby : URL et Chain ID

Ajoutez une URL RPC BlockVectra à MetaMask ou Rabby. Trouvez les Chain ID et symboles natifs, configurez une API key dans le chemin et gérez une clé dédiée au wallet.

Ajoutez l'URL RPC, le Chain ID et le symbole natif dans MetaMask ou Rabby, et utilisez une clé de wallet dédiée lorsque l'authentification est requise.

Première étape : Consulter le tableau des paramètres réseau des portefeuilles et renseigner ses champs dans votre wallet, en utilisant /v1/{chain}/{api_key} pour le RPC authentifié.
Terminé quand : L'enregistrement ajoute le réseau et bascule vers celui-ci dans MetaMask ; le Chain ID configuré correspond à l'ID renvoyé par le point de terminaison.

Paramètres de chaîne et options d'accès.

1. Pourquoi utiliser un RPC personnalisé

Les écosystèmes blockchain fournissent généralement des points de terminaison RPC publics par défaut pour l'utilisation communautaire de base et l'accueil des développeurs. Cependant, la documentation officielle des réseaux définit des limites de débit explicites et un périmètre d'utilisation pour ces points de terminaison :

Robinhood Chain : La page de documentation officielle Connecting to Robinhood Chain indique que le point de terminaison public https://rpc.mainnet.chain.robinhood.com est soumis à une limite de débit et n'est pas recommandé pour les charges de production (The following public endpoints are available but are rate-limited and not recommended for production use. For production, use a provider).
HyperEVM : La page de documentation officielle Rate limits and user limits spécifie une limite basée sur l'adresse IP pour le point de terminaison public rpc.hyperliquid.xyz/evm d'un maximum de 100 requêtes EVM JSON-RPC par minute (Maximum of 100 EVM JSON-RPC requests per minute for rpc.hyperliquid.xyz/evm).

2. Champs requis par le wallet et paramètres réseau

Les wallets EVM exigent plusieurs champs spécifiques lors de l'ajout ou de la modification d'un réseau :

Nom du réseau : le libellé lisible affiché dans l'interface du wallet.
URL RPC : le point de terminaison de communication. L'API key doit être placée dans le chemin de l'URL, en utilisant le chemin /v1/{chain}/{api_key} sur api.blockvectra.com :
```
/v1/{chain}/{api_key}
```
Important : les wallets tels que MetaMask et Rabby n'acceptent que des URL HTTP(S) standards dans leur champ d'URL RPC et ne prennent pas en charge les en-têtes de requête personnalisés (comme x-api-key: {api_key}). Par conséquent, les connexions de wallet doivent fournir l'API key directement dans le chemin de l'URL. N'incluez pas de barre oblique finale après {api_key}, et notez que les requêtes ciblant une {chain} inconnue renvoient HTTP 404.
Chain ID : l'identifiant de chaîne entier EIP-155.
Symbole de la devise : le symbole de l'actif de gaz natif de la chaîne (par exemple ETH, HYPE).
URL de l'explorateur de blocs : l'adresse web principale de l'explorateur de blocs du réseau.

Tableau des paramètres réseau des chaînes prises en charge

Nom du réseau	URL RPC (clé dans le chemin)	Chain ID	Symbole de la devise	URL de l'explorateur de blocs
arb_mainnet	`https://api.blockvectra.com/v1/arb_mainnet/{api_key}`	42161	ETH	arbiscan.io
base_mainnet	`https://api.blockvectra.com/v1/base_mainnet/{api_key}`	8453	ETH	basescan.org
bsc_mainnet	`https://api.blockvectra.com/v1/bsc_mainnet/{api_key}`	56	BNB	bscscan.com
Ethereum	`https://api.blockvectra.com/v1/eth_mainnet/{api_key}`	1	ETH	etherscan.io
eth_sepolia	`https://api.blockvectra.com/v1/eth_sepolia/{api_key}`	11155111	SepoliaETH	sepolia.etherscan.io
HyperEVM	`https://api.blockvectra.com/v1/hyperevm_mainnet/{api_key}`	999	HYPE	hyperscan.com
polygon_mainnet	`https://api.blockvectra.com/v1/polygon_mainnet/{api_key}`	137	POL	polygonscan.com
Robinhood Chain	`https://api.blockvectra.com/v1/robinhood_mainnet/{api_key}`	4663	ETH	robinhoodchain.blockscout.com
robinhood_testnet	`https://api.blockvectra.com/v1/robinhood_testnet/{api_key}`	46630	ETH	explorer.testnet.chain.robinhood.com

Limite de lecture seule sur HyperEVM : le point de terminaison HyperEVM de BlockVectra prend en charge les lectures mais ne diffuse pas de transactions. Utilisez un RPC prenant en charge eth_sendRawTransaction pour vos envois depuis votre wallet. Consultez la section Déployer avec Foundry ou Hardhat dans le guide HyperEVM pour les détails sur la diffusion.

Une API key fonctionne sur toutes les chaînes prises en charge en remplaçant {chain} dans le chemin par le slug de la chaîne souhaitée. Pour obtenir des précisions sur les quotas mutualisés et le routage des URL, consultez le guide Une clé, plusieurs chaînes.

3. Instructions pas à pas pour le wallet

Étapes de configuration de MetaMask

D'après le guide d'aide officiel de MetaMask How to add a custom network RPC :

Ouvrez l'extension de navigateur ou l'application mobile MetaMask.
Cliquez sur le sélecteur de réseau déroulant en haut de l'interface (ou rendez-vous dans Paramètres > Réseaux).
Sélectionnez Ajouter un réseau, puis choisissez Ajouter un réseau manuellement en bas.
Remplissez les détails du réseau à l'aide du tableau ci-dessus :
- Nom du réseau : entrez le nom de la chaîne issu du tableau ci-dessus.
- Nouvelle URL RPC : entrez votre point de terminaison authentifié par le chemin, tel que https://api.blockvectra.com/v1/robinhood_mainnet/{api_key} (remplacez {api_key} par votre véritable clé API).
- Chain ID : entrez l'entier Chain ID issu du tableau ci-dessus.
- Symbole de la devise : entrez le symbole de l'actif natif issu du tableau ci-dessus.
- URL de l'explorateur de blocs : entrez l'adresse officielle de l'explorateur de blocs issue du tableau ci-dessus (facultatif).
Cliquez sur Enregistrer pour ajouter le réseau et basculer vers celui-ci.

Envoi de transactions sur HyperEVM : le point de terminaison HyperEVM de BlockVectra prend en charge les lectures mais ne diffuse pas de transactions. Utilisez un RPC prenant en charge eth_sendRawTransaction pour vos envois depuis votre wallet (consultez l'explication de la diffusion sur HyperEVM).

Modifier un réseau existant : pour mettre à jour le point de terminaison RPC d'un réseau déjà présent dans votre liste, accédez à Paramètres > Réseaux, sélectionnez le réseau cible, modifiez ou ajoutez votre URL BlockVectra dans le champ URL RPC, puis enregistrez vos modifications.

Étapes de configuration de Rabby Wallet

Dans les paramètres de réseau personnalisé ou de RPC personnalisé de Rabby, saisissez les paramètres du tableau ci-dessus : Nom du réseau, URL RPC (avec la clé dans le chemin https://api.blockvectra.com/v1/{chain}/{api_key}), Chain ID, Symbole de la devise et URL de l'explorateur de blocs.

Remarque : lors de l'ajout d'un réseau personnalisé ou d'un testnet, assurez-vous que le Chain ID correspond à l'ID renvoyé par le point de terminaison pour éviter les erreurs d'incohérence d'ID réseau.

4. Conseils de sécurité et gestion de l'utilisation

Gardez à l'esprit les principes de sécurité et de facturation suivants lors de l'utilisation d'un RPC personnalisé :

[!WARNING] Risque d'exposition de l'API key : le chemin de l'URL RPC contient votre API key en texte brut. Ne partagez jamais de captures d'écran de la configuration réseau de votre wallet dans des salons de discussion publics ou des forums, et ne validez pas d'URL contenant votre clé active dans des dépôts de code publics ou de la documentation.

Les requêtes du wallet sont comptabilisées dans l'utilisation du compte : L'ouverture du wallet, le changement de compte ou l'actualisation des listes d'actifs déclenchent des appels JSON-RPC en direct (tels que eth_blockNumber, eth_getBalance et eth_call). Ces requêtes consomment de la capacité selon le poids en CU de la méthode appelée (consultez la page Tarifs) par rapport aux limites de votre compte.
Créer une API key dédiée pour chaque wallet : Dans la Console, créez une API key dédiée explicitement étiquetée pour votre wallet (par exemple metamask-desktop ou rabby-extension). Cela permet d'isoler le trafic de votre wallet personnel de vos applications serveur, scripts automatisés et agents IA.
Révocation indépendante en cas de compromission : Si vous soupçonnez qu'une API key configurée dans un wallet a été exposée, révoquez immédiatement cette clé individuelle dans la console sans affecter les autres clés ou services en cours d'exécution. Si votre session expire ou qu'une clé est perdue, consultez Session ou API key perdue ? dans le guide d'inscription programmatique pour reprendre le contrôle à l'aide de la signature de votre portefeuille Ethereum.

5. Ressources connexes

Limites de l'état historique : vérifiez les fenêtres d'état authentifié et l'historique sans clé avant de demander un solde antérieur ou une valeur de contrat ; les plages de requêtes de logs constituent une limite distincte.
Guide Une clé, plusieurs chaînes : règles détaillées de routage d'URL, découverte programmatique avec GET /v1/chains et mécanismes de quota inter-chaînes.
Tarifs et limites des forfaits : informations sur les poids en CU, les taux de rechargement du débit et les mises à niveau par dépôt de paiement.

Prochaines étapes

Parcourir le catalogue des jeux de données pour découvrir 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.

Configuration d'un RPC personnalisé dans MetaMask et Rabby : URL et Chain ID

Sur cette page