Faucet de testnet

El faucet es la vía de entrada en línea para desarrollar sobre TensorCash. Envía una pequeña cantidad de monedas de testnet a cualquier dirección de testnet válida, para que puedas financiar una wallet, probar el JSON-RPC y ensayar flujos de modelos o activos contra una cadena real y compartida. Las monedas no tienen valor. Para un entorno de pruebas totalmente offline, con monedas instantáneas e ilimitadas, usa en su lugar la Guía de regtest.

Solo testnet · 0,05 TSC por solicitud · 24 h de espera

Obtener monedas

Envía por POST tu dirección de testnet en JSON. Sin clave de API ni cuenta. Si todo va bien, la respuesta es el id de la transacción difundida; puedes seguirla en el explorador de 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"}

¿Aún no tienes dirección? Cualquier wallet de TensorCash en testnet te da una: getnewaddress por JSON-RPC, o la pantalla de recepción de la wallet de escritorio o móvil.

Límites de uso

El faucet es pequeño a propósito: lo justo para desbloquear el desarrollo, no lo bastante para vaciarlo. Si necesitas más de lo que permite el periodo de espera, recurre a la Guía de regtest y mina tus propias monedas sin límites.

Límite	Valor	Detalle
Envío	0,05 TSC	La cantidad fija que se envía por cada solicitud correcta.
Periodo de espera	24 horas	Por dirección y por IP de origen, según cuál se haya usado más recientemente. Un 429 incluye una cabecera Retry-After.
Tope diario	5 TSC	El total que el faucet reparte por día UTC. Cuando se alcanza, las solicitudes reciben un 429 hasta el día siguiente.
Red	Solo testnet	La dirección se comprueba con los parámetros de la cadena de testnet, así que una dirección de mainnet se rechaza. No hay faucet de mainnet.

Respuestas

Todas las respuestas son JSON. El periodo de espera solo se registra cuando el envío se confirma, así que un fallo transitorio nunca te hace perder el turno.

HTTP	Cuerpo	Cuándo
`200`	`{ "txid": "…", "address": "…", "amount": "0.05" }`	Monedas difundidas. El periodo de espera empieza ahora.
`400`	`{ "error": "Provide a valid TensorCash testnet address." }`	Dirección ausente o mal formada.
`400`	`{ "error": "That is not a valid TensorCash testnet address." }`	Bien formada, pero no válida en testnet (por ejemplo, una dirección de mainnet).
`403`	`{ "error": "The faucet is available on testnet only." }`	La solicitud apuntaba a mainnet.
`429`	`{ "error": "You've already used the faucet recently.", "retry_after_secs": N }`	Dentro del periodo de espera de 24 h para esta dirección o IP.
`429`	`{ "error": "The faucet has hit its daily limit. Try again tomorrow." }`	Se ha agotado el tope diario de 5 TSC.
`503`	`{ "error": "The faucet is temporarily empty. Please try again later." }`	La wallet del faucet tiene menos de un envío más la comisión. Se recarga a mano.

Estado

El faucet funciona dentro de la API semilla de testnet. Si ese servicio está degradado, es de esperar que el faucet devuelva respuestas 503.

Siguientes pasos

Guía de regtestLa vía offline: tu propia cadena local, monedas al instante, sin límites y sin necesidad de red.
Referencia JSON-RPCEl índice completo de métodos, incluido getnewaddress para crear la dirección que financias aquí.