Testnet-Faucet
Die Faucet ist der Online-Einstieg, um auf TensorCash zu entwickeln. Sie schickt eine kleine Menge Testnet-Coins an jede gültige Testnet-Adresse, damit du eine Wallet aufladen, die JSON-RPC-Schnittstelle ausprobieren und Modell- oder Asset-Abläufe gegen eine echte, gemeinsam genutzte Chain testen kannst. Die Coins haben keinen Wert. Für eine vollständig offline laufende Sandbox mit sofort verfügbaren, unbegrenzten Coins nutze stattdessen den Regtest-Guide.
Coins erhalten
Schick deine Testnet-Adresse als JSON per POST. Kein API-Schlüssel, kein Konto. Bei Erfolg enthält die Antwort die ID der gesendeten Transaktion; verfolge sie im 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"}Noch keine Adresse? Jede TensorCash-Wallet im Testnet gibt dir eine: getnewaddress über die JSON-RPC-Schnittstelle oder der Empfangen-Bildschirm der Desktop- oder Mobile-Wallet.
Rate-Limits
Die Faucet ist absichtlich klein: genug, um bei der Entwicklung weiterzukommen, aber zu wenig, um sie leerzuräumen. Brauchst du mehr, als die Sperrzeit erlaubt, nutze den Regtest-Guide und mine deine eigenen Coins ohne Limits.
| Limit | Wert | Erläuterung |
|---|---|---|
| Ausgabemenge | 0,05 TSC | Der feste Betrag, der pro erfolgreicher Anfrage gesendet wird. |
| Sperrzeit | 24 Stunden | Pro Adresse und pro Quell-IP, je nachdem, was zuletzt verwendet wurde. Ein 429 enthält einen Retry-After-Header. |
| Tageslimit | 5 TSC | Die Gesamtmenge, die die Faucet pro UTC-Tag ausgibt. Ist sie erreicht, erhalten Anfragen bis zum nächsten Tag einen 429. |
| Netzwerk | Nur Testnet | Die Adresse wird gegen die Chain-Parameter des Testnets geprüft, eine Mainnet-Adresse wird also abgelehnt. Eine Mainnet-Faucet gibt es nicht. |
Antworten
Jede Antwort ist JSON. Die Sperrzeit wird nur bei einem bestätigten Versand erfasst, ein vorübergehender Fehler kostet dich also keinen Versuch.
| HTTP | Body | Wann |
|---|---|---|
200 | { "txid": "…", "address": "…", "amount": "0.05" } | Coins gesendet. Die Sperrzeit beginnt jetzt. |
400 | { "error": "Provide a valid TensorCash testnet address." } | Adresse fehlt oder ist fehlerhaft. |
400 | { "error": "That is not a valid TensorCash testnet address." } | Formal korrekt, aber im Testnet ungültig (zum Beispiel eine Mainnet-Adresse). |
403 | { "error": "The faucet is available on testnet only." } | Die Anfrage wurde dem Mainnet zugeordnet. |
429 | { "error": "You've already used the faucet recently.", "retry_after_secs": N } | Innerhalb der 24-h-Sperrzeit für diese Adresse oder IP. |
429 | { "error": "The faucet has hit its daily limit. Try again tomorrow." } | Das Tageslimit von 5 TSC ist ausgeschöpft. |
503 | { "error": "The faucet is temporarily empty. Please try again later." } | Die Faucet-Wallet enthält weniger als eine Ausgabemenge plus Gebühr. Sie wird von Hand aufgefüllt. |
Status
Die Faucet läuft innerhalb der Testnet-Seed-API. Ist dieser Dienst beeinträchtigt, rechne mit 503-Antworten der Faucet.
Wie geht’s weiter
- Regtest-GuideDer Offline-Weg: deine eigene lokale Chain, Coins sofort, keine Limits, kein Netzwerk nötig.
- JSON-RPC-ReferenzDer vollständige Methodenindex, einschließlich
getnewaddress, um die Adresse zu erzeugen, die du hier auflädst.