Testnet-faucet

Faucet är vägen in online för den som bygger på TensorCash. Den skickar en liten mängd testnet-mynt till valfri giltig testnet-adress, så att du kan fylla på en plånbok, testa JSON-RPC och prova modell- och tillgångsflöden mot en delad kedja i drift. Mynten har inget värde. För en helt offline sandlåda med omedelbara, obegränsade mynt använder du i stället Regtest-guide.

Endast testnet · 0,05 TSC per anrop · 24 h spärrtid

Hämta mynt

Skicka din testnet-adress som JSON med POST. Ingen API-nyckel, inget konto. Vid lyckat anrop innehåller svaret id:t för den sända transaktionen; följ den i testnet-utforskaren.

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

Ingen adress än? Alla TensorCash-plånböcker på testnet ger dig en: getnewaddress via JSON-RPC, eller mottagarskärmen i skrivbords- eller mobilplånboken.

Anropsgränser

Faucet är liten med avsikt: den ger tillräckligt för att du ska komma vidare med utvecklingen, men för lite för att vara värd att länsa. Behöver du mer än spärrtiden tillåter kör du Regtest-guide och minar egna mynt helt utan gränser.

GränsVärdeDetalj
Utdelning0,05 TSCDet fasta belopp som skickas per lyckat anrop.
Spärrtid24 timmarPer adress och per käll-IP, beroende på vilken som använts senast. Ett 429-svar har en Retry-After-header.
Dagstak5 TSCDen totala mängd som faucet delar ut per UTC-dygn. När taket är nått får anrop svaret 429 fram till nästa dygn.
NätverkEndast testnetAdressen kontrolleras mot testnets kedjeparametrar, så en mainnet-adress avvisas. Det finns ingen faucet för mainnet.

Svar

Alla svar är JSON. Spärrtiden registreras bara vid ett bekräftat utskick, så ett tillfälligt fel förbrukar aldrig din tur.

HTTPInnehållNär
200{ "txid": "…", "address": "…", "amount": "0.05" }Mynten har skickats. Spärrtiden börjar nu.
400{ "error": "Provide a valid TensorCash testnet address." }Adressen saknas eller är felformaterad.
400{ "error": "That is not a valid TensorCash testnet address." }Korrekt formaterad men inte giltig på testnet (till exempel en mainnet-adress).
403{ "error": "The faucet is available on testnet only." }Anropet hamnade på mainnet.
429{ "error": "You've already used the faucet recently.", "retry_after_secs": N }Inom spärrtiden på 24 h för den här adressen eller IP-adressen.
429{ "error": "The faucet has hit its daily limit. Try again tomorrow." }Dagstaket på 5 TSC är förbrukat.
503{ "error": "The faucet is temporarily empty. Please try again later." }Faucet-plånboken innehåller mindre än en utdelning plus avgift. Den fylls på manuellt.

Status

Faucet körs inuti testnets seed-API. Om den tjänsten har driftstörningar kan du räkna med 503-svar från faucet.

Vart härnäst

  • Regtest-guideOfflinevägen: din egen lokala kedja, omedelbara mynt, inga gränser och inget nätverk behövs.
  • JSON-RPC-referensDet fullständiga metodindexet, inklusive getnewaddress för att skapa adressen som du fyller på här.