Faucet da testnet

A faucet é a porta de entrada online para construir sobre a TensorCash. Envia uma pequena quantidade de moedas de testnet para qualquer endereço de testnet válido, para que possas financiar uma carteira, experimentar o JSON-RPC e testar fluxos de modelos ou de ativos numa chain real e partilhada. As moedas não têm valor. Para um ambiente totalmente offline, com moedas instantâneas e ilimitadas, usa antes o Guia regtest.

Apenas testnet · 0,05 TSC por pedido · 24 h de intervalo

Obter moedas

Envia o teu endereço da testnet por POST, em JSON. Sem chave de API, sem conta. Em caso de sucesso, a resposta é o id da transação difundida; acompanha-a no explorador da 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"}

Ainda não tens endereço? Qualquer carteira TensorCash na testnet te dá um: getnewaddress através do JSON-RPC, ou o ecrã de receção da carteira de secretária ou móvel.

Limites de pedidos

A faucet é pequena de propósito: o suficiente para desbloquear o desenvolvimento, não o suficiente para ser esvaziada. Se precisares de mais do que o intervalo de espera permite, corre o Guia regtest e minera as tuas próprias moedas sem limites.

Limite	Valor	Detalhe
Quantia por pedido	0,05 TSC	O montante fixo enviado por cada pedido bem-sucedido.
Intervalo de espera	24 horas	Por endereço e por IP de origem, conforme o que tiver sido usado mais recentemente. Um 429 inclui um cabeçalho Retry-After.
Limite diário	5 TSC	O total que a faucet distribui por dia UTC. Quando é atingido, os pedidos recebem um 429 até ao dia seguinte.
Rede	Apenas testnet	O endereço é verificado com os parâmetros da chain de testnet, por isso um endereço de mainnet é rejeitado. Não existe faucet para a mainnet.

Respostas

Todas as respostas são JSON. O intervalo de espera só é registado após um envio confirmado, por isso uma falha temporária nunca te faz perder a vez.

HTTP	Corpo	Quando
`200`	`{ "txid": "…", "address": "…", "amount": "0.05" }`	Moedas difundidas. O intervalo de espera começa agora.
`400`	`{ "error": "Provide a valid TensorCash testnet address." }`	Endereço em falta ou mal formado.
`400`	`{ "error": "That is not a valid TensorCash testnet address." }`	Bem formado, mas não é válido na testnet (por exemplo, um endereço de mainnet).
`403`	`{ "error": "The faucet is available on testnet only." }`	O pedido foi identificado como sendo para a mainnet.
`429`	`{ "error": "You've already used the faucet recently.", "retry_after_secs": N }`	Dentro do intervalo de espera de 24 h para este endereço ou IP.
`429`	`{ "error": "The faucet has hit its daily limit. Try again tomorrow." }`	O limite diário de 5 TSC está esgotado.
`503`	`{ "error": "The faucet is temporarily empty. Please try again later." }`	A carteira da faucet tem menos do que um envio mais a taxa. É reabastecida manualmente.

Estado

A faucet corre dentro da API de seed da testnet. Se esse serviço estiver degradado, conta com respostas 503 da faucet.

E agora

Guia regtestO caminho offline: a tua própria chain local, moedas instantâneas, sem limites e sem precisar de rede.
Referência JSON-RPCO índice completo de métodos, incluindo getnewaddress para criar o endereço que financias aqui.