Faucet da testnet

O faucet é a porta de entrada online para desenvolver na TensorCash. Ele envia uma pequena quantia de moedas de testnet para qualquer endereço de testnet válido, para que você possa abastecer uma carteira, testar o JSON-RPC e experimentar fluxos de modelos ou ativos em uma cadeia compartilhada e ativa. As moedas não têm valor. Para um sandbox totalmente offline, com moedas instantâneas e ilimitadas, siga o Guia de regtest.

Somente testnet · 0,05 TSC por requisição · intervalo de espera de 24 h

Obter moedas

Envie seu endereço de testnet em JSON via POST. Sem chave de API, sem conta. Em caso de sucesso, a resposta traz o id da transação transmitida; acompanhe-a no explorer 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 tem um endereço? Qualquer carteira TensorCash na testnet gera um: getnewaddress pelo JSON-RPC, ou a tela de recebimento da carteira desktop ou móvel.

Limites de requisição

O faucet é pequeno de propósito: o suficiente para destravar o desenvolvimento, não o suficiente para ser esvaziado. Se você precisar de mais do que o intervalo de espera permite, siga o Guia de regtest e minere suas próprias moedas, sem limites.

Limite	Valor	Detalhes
Quantia por envio	0,05 TSC	A quantia fixa enviada a cada requisição bem-sucedida.
Intervalo de espera	24 horas	Por endereço e por IP de origem, contando o que foi usado mais recentemente. Um 429 traz um cabeçalho Retry-After.
Limite diário	5 TSC	O total que o faucet distribui por dia UTC. Quando ele é atingido, as requisições recebem 429 até o dia seguinte.
Rede	Somente testnet	O endereço é validado contra os parâmetros da cadeia de testnet, então um endereço de mainnet é rejeitado. Não existe faucet de mainnet.

Respostas

Toda resposta é em JSON. O intervalo de espera só é registrado após um envio confirmado, então uma falha temporária nunca consome a sua vez.

HTTP	Corpo	Quando
`200`	`{ "txid": "…", "address": "…", "amount": "0.05" }`	Moedas transmitidas. O intervalo de espera começa agora.
`400`	`{ "error": "Provide a valid TensorCash testnet address." }`	Endereço ausente ou malformado.
`400`	`{ "error": "That is not a valid TensorCash testnet address." }`	Bem formado, mas inválido na testnet (por exemplo, um endereço de mainnet).
`403`	`{ "error": "The faucet is available on testnet only." }`	A requisição apontou 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 já foi atingido.
`503`	`{ "error": "The faucet is temporarily empty. Please try again later." }`	A carteira do faucet tem menos do que um envio mais a taxa. Ela é reabastecida manualmente.

Status

O faucet roda dentro da API de seed da testnet. Se esse serviço estiver degradado, espere respostas 503 do faucet.

Próximos passos

Guia de regtestO caminho offline: sua própria cadeia 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 você abastece aqui.