Faucet de la testnet
El faucet és la porta d'entrada en línia per desenvolupar sobre TensorCash. Envia una petita quantitat de monedes de testnet a qualsevol adreça de testnet vàlida, perquè puguis finançar un moneder, provar el JSON-RPC i assajar fluxos de models o d'actius en una cadena real i compartida. Les monedes no tenen cap valor. Per a un entorn de proves totalment fora de línia, amb monedes instantànies i il·limitades, consulta la Guia de regtest.
Aconsegueix monedes
Envia la teva adreça de testnet en JSON amb un POST. Sense clau d'API ni compte. Si tot va bé, la resposta és l'identificador de la transacció difosa; en pots seguir l'estat a l'explorador de la 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"}Encara no tens adreça? Qualsevol moneder de TensorCash a la testnet te'n dona una: getnewaddress pel JSON-RPC, o la pantalla de recepció del moneder d'escriptori o mòbil.
Límits de freqüència
El faucet és petit a propòsit: n'hi ha prou per desencallar el desenvolupament, però no per buidar-lo. Si necessites més del que permet el temps d'espera, segueix la Guia de regtest i mina les teves pròpies monedes sense límits.
| Límit | Valor | Detall |
|---|---|---|
| Quantitat per sol·licitud | 0,05 TSC | L'import fix que s'envia per cada sol·licitud reeixida. |
| Temps d'espera | 24 hores | Per adreça i per IP d'origen, la que s'hagi fet servir més recentment. Un 429 inclou una capçalera Retry-After. |
| Límit diari | 5 TSC | El total que reparteix el faucet per dia UTC. Quan s'arriba a aquesta xifra, les sol·licituds reben un 429 fins al dia següent. |
| Xarxa | Només testnet | L'adreça es comprova amb els paràmetres de la cadena testnet, de manera que una adreça de mainnet es rebutja. No hi ha cap faucet a la mainnet. |
Respostes
Totes les respostes són JSON. El temps d'espera només es registra quan l'enviament s'ha confirmat, de manera que una fallada transitòria no et fa perdre mai el torn.
| HTTP | Cos | Quan |
|---|---|---|
200 | { "txid": "…", "address": "…", "amount": "0.05" } | Monedes difoses. El temps d'espera comença ara. |
400 | { "error": "Provide a valid TensorCash testnet address." } | Falta l'adreça o està mal formada. |
400 | { "error": "That is not a valid TensorCash testnet address." } | Ben formada, però no vàlida a la testnet (per exemple, una adreça de mainnet). |
403 | { "error": "The faucet is available on testnet only." } | La sol·licitud correspon a la mainnet. |
429 | { "error": "You've already used the faucet recently.", "retry_after_secs": N } | Dins del temps d'espera de 24 h per a aquesta adreça o IP. |
429 | { "error": "The faucet has hit its daily limit. Try again tomorrow." } | S'ha esgotat el límit diari de 5 TSC. |
503 | { "error": "The faucet is temporarily empty. Please try again later." } | El moneder del faucet té menys d'una quantitat per sol·licitud més la comissió. Es recarrega a mà. |
Estat
El faucet funciona dins de l'API de llavors de la testnet. Si aquest servei està degradat, espera respostes 503 del faucet.
Següents passos
- Guia de regtestLa via fora de línia: la teva pròpia cadena local, monedes instantànies, sense límits i sense necessitat de xarxa.
- Referència JSON-RPCL'índex complet de mètodes, inclòs
getnewaddressper crear l'adreça que finançaràs aquí.