Faucet testnet
Il faucet è il punto d'accesso online per sviluppare su TensorCash. Invia una piccola quantità di monete testnet a qualsiasi indirizzo testnet valido, così puoi caricare un wallet, provare il JSON-RPC e testare i flussi di modelli e asset su una blockchain attiva e condivisa. Le monete non hanno valore. Per un ambiente di prova completamente offline, con monete immediate e illimitate, segui invece la Guida regtest.
Come ottenere le monete
Invia con una POST il tuo indirizzo testnet in formato JSON. Nessuna chiave API, nessun account. Se la richiesta va a buon fine, la risposta contiene l'id della transazione trasmessa: puoi seguirla sull'explorer della 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"}Non hai ancora un indirizzo? Te lo fornisce qualsiasi wallet TensorCash su testnet: getnewaddress tramite JSON-RPC, oppure la schermata di ricezione del wallet desktop o mobile.
Limiti di utilizzo
Il faucet è volutamente modesto: dà abbastanza monete per andare avanti con lo sviluppo, ma non tante da prosciugare il faucet. Se ti servono più monete di quante ne consenta il periodo di attesa, segui la Guida regtest e mina le tue monete senza limiti.
| Limite | Valore | Dettaglio |
|---|---|---|
| Erogazione | 0,05 TSC | L'importo fisso inviato per ogni richiesta andata a buon fine. |
| Periodo di attesa | 24 ore | Per indirizzo e per IP di origine, a seconda di quale sia stato usato più di recente. Una risposta 429 include l'header Retry-After. |
| Tetto giornaliero | 5 TSC | Il totale che il faucet eroga per giorno UTC. Una volta raggiunto, le richieste ricevono un 429 fino al giorno successivo. |
| Rete | Solo testnet | L'indirizzo viene verificato rispetto ai parametri della testnet, quindi un indirizzo mainnet viene rifiutato. Non esiste un faucet per la mainnet. |
Risposte
Ogni risposta è in JSON. Il periodo di attesa viene registrato solo dopo un invio confermato, quindi un errore temporaneo non ti fa mai perdere il turno.
| HTTP | Corpo | Quando |
|---|---|---|
200 | { "txid": "…", "address": "…", "amount": "0.05" } | Monete trasmesse. Il periodo di attesa parte da ora. |
400 | { "error": "Provide a valid TensorCash testnet address." } | Indirizzo mancante o malformato. |
400 | { "error": "That is not a valid TensorCash testnet address." } | Formato corretto, ma non valido sulla testnet (ad esempio un indirizzo mainnet). |
403 | { "error": "The faucet is available on testnet only." } | La richiesta risulta diretta alla mainnet. |
429 | { "error": "You've already used the faucet recently.", "retry_after_secs": N } | Il periodo di attesa di 24 h per questo indirizzo o IP non è ancora scaduto. |
429 | { "error": "The faucet has hit its daily limit. Try again tomorrow." } | Il tetto giornaliero di 5 TSC è esaurito. |
503 | { "error": "The faucet is temporarily empty. Please try again later." } | Il wallet del faucet contiene meno di un'erogazione più la commissione. Viene ricaricato a mano. |
Stato
Il faucet gira all'interno della seed API della testnet. Se quel servizio ha problemi, aspettati risposte 503 dal faucet.
Prossimi passi
- Guida regtestLa strada offline: una blockchain locale tutta tua, monete immediate, nessun limite, nessuna rete necessaria.
- Riferimento JSON-RPCL'indice completo dei metodi, incluso
getnewaddressper creare l'indirizzo da caricare qui.