Faucet testnet

Le faucet est le point d’entrée en ligne pour développer sur TensorCash. Il envoie une petite quantité de coins testnet à toute adresse testnet valide : de quoi alimenter un wallet, tester le JSON-RPC et éprouver vos flux de modèles ou d’actifs sur une chaîne réelle et partagée. Ces coins n’ont aucune valeur. Pour un bac à sable entièrement hors ligne, avec des coins instantanés et illimités, utilisez plutôt le Guide regtest.

Testnet uniquement · 0,05 TSC par requête · délai d’attente de 24 h

Obtenir des coins

Envoyez votre adresse testnet en JSON par POST. Ni clé API, ni compte. En cas de succès, la réponse contient l’identifiant de la transaction diffusée ; suivez-la sur l’explorateur testnet.

curl -sS -X POST https://mempool-testnet.tensorcash.org/api/v1/faucet \
  -H 'Content-Type: application/json' \
  -d '{"address": "<your-testnet-address>"}'
# {"txid":"…","address":"<your-testnet-address>","amount":"0.05"}

Pas encore d’adresse ? N’importe quel wallet TensorCash sur testnet vous en fournit une : getnewaddress via le JSON-RPC, ou l’écran de réception du wallet desktop ou mobile.

Limites de débit

Le faucet est volontairement modeste : assez pour débloquer le développement, pas assez pour être vidé. Si vous avez besoin de plus que ce que permet le délai d’attente, passez au Guide regtest et minez vos propres coins, sans limite.

Limite	Valeur	Détail
Montant par envoi	0,05 TSC	Le montant fixe envoyé à chaque requête réussie.
Délai d’attente	24 heures	Par adresse et par IP source, selon celle utilisée le plus récemment. Une réponse 429 inclut un en-tête Retry-After.
Plafond quotidien	5 TSC	Le total distribué par le faucet par jour UTC. Une fois atteint, les requêtes reçoivent une erreur 429 jusqu’au lendemain.
Réseau	Testnet uniquement	L’adresse est vérifiée selon les paramètres de la chaîne testnet : une adresse mainnet est donc rejetée. Il n’existe pas de faucet mainnet.

Réponses

Chaque réponse est au format JSON. Le délai d’attente n’est enregistré qu’après un envoi confirmé : un échec passager ne vous fait jamais perdre votre tour.

HTTP	Corps	Quand
`200`	`{ "txid": "…", "address": "…", "amount": "0.05" }`	Coins diffusés. Le délai d’attente commence maintenant.
`400`	`{ "error": "Provide a valid TensorCash testnet address." }`	Adresse manquante ou mal formée.
`400`	`{ "error": "That is not a valid TensorCash testnet address." }`	Bien formée, mais non valide sur testnet (par exemple une adresse mainnet).
`403`	`{ "error": "The faucet is available on testnet only." }`	La requête a été résolue vers le mainnet.
`429`	`{ "error": "You've already used the faucet recently.", "retry_after_secs": N }`	Délai d’attente de 24 h en cours pour cette adresse ou cette IP.
`429`	`{ "error": "The faucet has hit its daily limit. Try again tomorrow." }`	Le plafond quotidien de 5 TSC est épuisé.
`503`	`{ "error": "The faucet is temporarily empty. Please try again later." }`	Le wallet du faucet contient moins d’un envoi plus les frais. Il est réapprovisionné à la main.

État

Le faucet tourne au sein de l’API seed du testnet. Si ce service est dégradé, attendez-vous à des réponses 503 du faucet.

Et ensuite

Guide regtestLa voie hors ligne : votre propre chaîne locale, des coins instantanés, aucune limite, aucun réseau nécessaire.
Référence JSON-RPCL’index complet des méthodes, dont getnewaddress pour créer l’adresse à alimenter ici.