Faucet du testnet Robinhood Chain

Obtenez de l'ETH de test avec votre propre API key : prérequis de compte, limites de réclamation, transactions acceptées et gestion des erreurs.

Utilisez le faucet pour obtenir de l'ETH de test pour vos transactions sur le testnet Robinhood Chain (robinhood_testnet, chain ID 46630). La réclamation est gratuite et ne consomme aucun CU ; les appels RPC ultérieurs sur le testnet utilisent la facturation normale en CU.

Première étape : Envoyer une demande avec votre propre API key et votre adresse de destinataire à l'aide de l'exemple curl ci-dessous.
Terminé quand : le code HTTP 202 et un tx_hash confirment l'acceptation ; utilisez la requête de reçu de transaction ci-dessous pour vérifier l'inclusion on-chain avant de considérer la demande comme confirmée.

Paramètres du testnet et options d'accès.

Avant de faire une demande

Créez un compte BlockVectra et utilisez l'une de vos propres API keys. Créez une clé dans la console ou suivez le guide d'inscription programmatique.

Utilisez 0x suivi de 40 caractères hexadécimaux, en minuscules ou en casse mixte avec une somme de contrôle EIP-55 valide. Les réponses utilisent des adresses en minuscules ; les différentes variantes de casse d'une même adresse partagent la même limite de réclamation.

Envoyer une demande

Appelez POST https://api.blockvectra.com/v1/faucet/robinhood_testnet avec Content-Type: application/json et votre clé dans x-api-key. Ce point de terminaison ne lit pas de clé depuis le chemin de l'URL ou l'en-tête Authorization.

Remplacez {api_key} par votre clé et l'adresse d'exemple par votre adresse de destinataire :

curl -i "https://api.blockvectra.com/v1/faucet/robinhood_testnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: {api_key}" \
  -d '{"address":"0x1111111111111111111111111111111111111111"}'

Le corps JSON contient uniquement address et ne doit pas dépasser 64 KiB. Des champs inconnus ou un JSON invalide renvoient 400 invalid_request. Utilisez le point de terminaison exact sans paramètres de requête.

Fenêtre de réclamation et limites

Chaque demande acceptée envoie 0,001 test ETH (1000000000000000 wei).
Chaque compte et chaque adresse destinataire ont droit à une nouvelle demande par période glissante de 24 heures. Utiliser une autre clé du même compte n'augmente pas la limite.
Le faucet accepte au maximum 1 000 nouvelles demandes par jour UTC pour l'ensemble des utilisateurs.
Les requêtes partagent une limite de 5 requêtes par seconde et par clé avec /v1/account.

next_eligible_at correspond à l'heure d'acceptation plus 24 heures, exprimée sous forme d'horodatage UTC RFC 3339. Les fenêtres pour les comptes et les adresses ne se réinitialisent pas à minuit UTC. Une erreur 429 liée à la limite de réclamation inclut error.data.scope (account, address ou global) et error.data.next_eligible_at ; pour global, l'horodatage correspond au début du jour UTC suivant. Une erreur 429 de fréquence de requêtes ne contient aucun champ scope.

Accepté ne signifie pas confirmé

Le statut HTTP 202 signifie accepté, et non inclus avec succès on-chain. La réponse JSON contient :

Champ	Signification
`chain` / `chain_id`	`robinhood_testnet` / `46630`
`address`	Adresse du destinataire en minuscules
`amount_wei`	Montant de la demande sous forme de chaîne d'entier décimal
`tx_hash`	Hash stable de la transaction acceptée
`next_eligible_at`	Prochaine heure d'éligibilité pour la fenêtre glissante

Réessayer avec la même adresse normalisée depuis le même compte dans un délai de 24 heures renvoie la réponse 202 initiale et le même tx_hash, y compris en utilisant une autre clé valide du même compte. Aucun paiement supplémentaire n'est envoyé. Si une réponse est perdue, réessayez avec la même adresse depuis le même compte.

Vérifiez la transaction à l'aide du point de terminaison RPC testnet existant. Remplacez {tx_hash} par le hash de la réponse acceptée ; cette requête RPC utilise la facturation normale en CU :

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

Erreurs et nouvelles tentatives

L'enveloppe d'erreur contient error.code, error.message et error.data. error.data.reason est identique à error.code ; docs_url, retryable et request_id fournissent la référence d'erreur, la politique de nouvelle tentative et l'identifiant de requête. Pour toute erreur 429 ou 503, attendez le nombre de secondes indiqué dans l'en-tête de réponse Retry-After avant de réessayer. En l'absence de réponse acceptée, ne supposez pas que l'ETH de test a été envoyé.

HTTP	Code d'erreur	Que faire
400	`invalid_address`	Corrigez le format de l'adresse ou la somme de contrôle EIP-55 ; `error.data.field` est `/address`.
400	`invalid_request`	Envoyez un JSON valide contenant uniquement `address`.
401	`missing_api_key` / `invalid_api_key`	Fournissez une clé valide dans `x-api-key`.
403	`key_expired`	Créez une nouvelle API key.
404	`not_found`	Vérifiez le chemin, la chaîne, la méthode POST et l'absence de paramètres de requête ; le faucet peut être indisponible.
413	`request_too_large`	Réduisez la taille du corps pour qu'il ne dépasse pas 64 KiB.
429	`rate_limited`	Attendez le délai `Retry-After` ; inspectez `scope` et `next_eligible_at` lorsqu'ils sont présents.
503	`faucet_empty`	Le faucet ne dispose pas de fonds suffisants pour la demande et les frais. Attendez le délai `Retry-After`.
503	`service_unavailable`	Le traitement des demandes est temporairement indisponible, ou une demande précédente n'a pas encore de reçu. Attendez le délai `Retry-After`.
503	`auth_unavailable` / `upstream_unavailable`	Attendez le délai `Retry-After`, puis réessayez.

Consultez la référence des erreurs ou /errors.json pour des instructions lisibles par machine, ainsi que le guide Robinhood Chain pour l'accès RPC.

Poursuivez avec le guide de démarrage RPC sur le Testnet Robinhood Chain pour les lectures sans clé et les logs WebSocket. Retrouvez l'URL RPC publique et les méthodes prises en charge sur la page de la chaîne testnet.