Testnet-faucet

De faucet is de online manier om te beginnen met bouwen op TensorCash. Hij stuurt een kleine hoeveelheid testnetmunten naar elk geldig testnetadres, zodat je een wallet kunt vullen, de JSON-RPC kunt uitproberen en model- of assetflows kunt testen op een draaiende, gedeelde blockchain. De munten hebben geen waarde. Wil je een volledig offline sandbox met direct en onbeperkt munten, gebruik dan de Regtest-handleiding.

Alleen testnet · 0,05 TSC per aanvraag · 24 uur wachttijd

Munten ophalen

Stuur je testnetadres als JSON in een POST-verzoek. Geen API-sleutel, geen account. Lukt het, dan bevat de respons de ID van de transactie die naar het netwerk is verzonden; die kun je volgen in de testnet-explorer.

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"}

Nog geen adres? Elke TensorCash-wallet op testnet geeft je er een: getnewaddress via de JSON-RPC, of het ontvangstscherm van de desktop- of mobiele wallet.

Aanvraaglimieten

De faucet is met opzet klein: genoeg om verder te kunnen met ontwikkelen, niet genoeg om hem leeg te trekken. Heb je meer nodig dan de wachttijd toelaat, volg dan de Regtest-handleiding en mine je eigen munten, zonder limieten.

Limiet	Waarde	Toelichting
Bedrag per aanvraag	0,05 TSC	Het vaste bedrag dat per geslaagde aanvraag wordt verstuurd.
Wachttijd	24 uur	Per adres en per bron-IP; het meest recente gebruik van een van beide telt. Een 429 bevat een Retry-After-header.
Daglimiet	5 TSC	Het totaal dat de faucet per UTC-dag uitdeelt. Is dat bereikt, dan krijgen aanvragen tot de volgende dag een 429.
Netwerk	Alleen testnet	Het adres wordt gecontroleerd aan de hand van de chainparameters van testnet, dus een mainnetadres wordt geweigerd. Er is geen faucet voor mainnet.

Responses

Elke respons is JSON. De wachttijd wordt pas vastgelegd bij een bevestigde verzending, dus een tijdelijke fout kost je nooit je beurt.

HTTP	Body	Wanneer
`200`	`{ "txid": "…", "address": "…", "amount": "0.05" }`	Munten naar het netwerk verzonden. De wachttijd gaat nu in.
`400`	`{ "error": "Provide a valid TensorCash testnet address." }`	Adres ontbreekt of is onjuist opgemaakt.
`400`	`{ "error": "That is not a valid TensorCash testnet address." }`	Correct opgebouwd, maar niet geldig op testnet (bijvoorbeeld een mainnetadres).
`403`	`{ "error": "The faucet is available on testnet only." }`	Het verzoek is als mainnet herkend.
`429`	`{ "error": "You've already used the faucet recently.", "retry_after_secs": N }`	Binnen de wachttijd van 24 uur voor dit adres of IP-adres.
`429`	`{ "error": "The faucet has hit its daily limit. Try again tomorrow." }`	De daglimiet van 5 TSC is op.
`503`	`{ "error": "The faucet is temporarily empty. Please try again later." }`	De faucetwallet bevat minder dan het bedrag van één aanvraag plus transactiekosten. Hij wordt handmatig bijgevuld.

Status

De faucet draait binnen de seed-API van testnet. Werkt die dienst niet goed, reken dan op 503-responses van de faucet.

Verder lezen

Regtest-handleidingDe offline route: je eigen lokale blockchain, direct munten, geen limieten, geen netwerk nodig.
JSON-RPC-referentieDe volledige index van methoden, inclusief getnewaddress om het adres aan te maken dat je hier vult.