Faucet testnetu
Faucet to internetowy punkt startowy do budowania na TensorCash. Wysyła niewielką ilość monet testnetowych na dowolny prawidłowy adres testnetowy, dzięki czemu możesz zasilić portfel, przećwiczyć JSON-RPC i przetestować przepływy modeli lub aktywów na żywym, współdzielonym łańcuchu. Monety nie mają wartości. Jeśli potrzebujesz w pełni offline’owego środowiska z natychmiastowymi, nieograniczonymi monetami, sięgnij zamiast tego po Przewodnik regtest.
Pobierz monety
Wyślij POST z adresem testnetowym w formacie JSON. Bez klucza API, bez konta. Po sukcesie odpowiedź zawiera identyfikator rozgłoszonej transakcji; możesz ją śledzić w eksploratorze testnetu.
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"}Nie masz jeszcze adresu? Poda ci go każdy portfel TensorCash w testnecie: getnewaddress przez JSON-RPC albo ekran odbioru w portfelu desktopowym lub mobilnym.
Limity żądań
Faucet jest celowo skromny: wystarcza, by odblokować prace deweloperskie, ale jest za mały, by opłacało się go drenować. Jeśli potrzebujesz więcej, niż pozwala okres oczekiwania, uruchom regtest (zob. Przewodnik regtest) i wydobywaj własne monety bez limitów.
| Limit | Wartość | Szczegóły |
|---|---|---|
| Porcja | 0,05 TSC | Stała kwota wysyłana przy każdym udanym żądaniu. |
| Okres oczekiwania | 24 godziny | Liczony osobno dla adresu i dla źródłowego IP — obowiązuje ten, który był użyty później. Odpowiedź 429 zawiera nagłówek Retry-After. |
| Limit dzienny | 5 TSC | Łączna kwota, jaką faucet wydaje w ciągu doby UTC. Po jej osiągnięciu żądania otrzymują 429 aż do następnego dnia. |
| Sieć | Tylko testnet | Adres jest sprawdzany względem parametrów łańcucha testnetu, więc adres mainnetowy zostaje odrzucony. Faucet dla mainnetu nie istnieje. |
Odpowiedzi
Każda odpowiedź jest w formacie JSON. Okres oczekiwania jest naliczany dopiero po potwierdzonej wysyłce, więc chwilowa awaria nigdy nie odbiera ci tury.
| HTTP | Treść | Kiedy |
|---|---|---|
200 | { "txid": "…", "address": "…", "amount": "0.05" } | Monety rozgłoszone. Okres oczekiwania właśnie się zaczął. |
400 | { "error": "Provide a valid TensorCash testnet address." } | Brak adresu lub adres w złym formacie. |
400 | { "error": "That is not a valid TensorCash testnet address." } | Poprawny składniowo, ale nieprawidłowy w testnecie (na przykład adres mainnetowy). |
403 | { "error": "The faucet is available on testnet only." } | Żądanie zostało rozpoznane jako dotyczące mainnetu. |
429 | { "error": "You've already used the faucet recently.", "retry_after_secs": N } | Trwa 24-godzinny okres oczekiwania dla tego adresu lub IP. |
429 | { "error": "The faucet has hit its daily limit. Try again tomorrow." } | Dzienny limit 5 TSC został wyczerpany. |
503 | { "error": "The faucet is temporarily empty. Please try again later." } | Portfel faucetu ma mniej niż jedną porcję plus opłatę. Jest uzupełniany ręcznie. |
Status
Faucet działa w ramach seed API testnetu. Jeśli ta usługa działa w ograniczonym zakresie, spodziewaj się odpowiedzi 503 z faucetu.
Dokąd dalej
- Przewodnik regtestŚcieżka offline: własny lokalny łańcuch, monety od ręki, bez limitów i bez dostępu do sieci.
- Dokumentacja JSON-RPCPełny indeks metod, w tym
getnewaddress, za pomocą której utworzysz adres do zasilenia tutaj.