Кран testnet
Кран — це онлайн-точка входу для розробки на TensorCash. Він надсилає невелику суму монет testnet на будь-яку дійсну адресу testnet, щоб ви могли поповнити гаманець, випробувати JSON-RPC і протестувати сценарії з моделями чи активами на реальному спільному ланцюзі. Ці монети нічого не варті. Для повністю офлайнової пісочниці з миттєвими й необмеженими монетами скористайтеся regtest (див. Посібник regtest).
Отримати монети
Надішліть свою адресу testnet у JSON методом POST. Без API-ключа й без облікового запису. У разі успіху відповідь містить ідентифікатор транзакції, яку розіслано в мережу; відстежуйте її в оглядачі блоків 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"}Ще немає адреси? Її видасть будь-який гаманець TensorCash у testnet: getnewaddress через JSON-RPC або екран отримання в десктопному чи мобільному гаманці.
Обмеження частоти запитів
Кран навмисно скромний: він видає достатньо, щоб розробка не стояла, але замало, щоб його можна було спустошити. Якщо вам потрібно більше, ніж дозволяє період очікування, запустіть regtest (див. Посібник regtest) і майніть власні монети без обмежень.
| Обмеження | Значення | Подробиці |
|---|---|---|
| Порція | 0,05 TSC | Фіксована сума, яку надсилають за кожен успішний запит. |
| Період очікування | 24 години | Окремо для адреси й для IP-джерела — рахується від того, що використовувалося пізніше. Відповідь 429 містить заголовок Retry-After. |
| Денний ліміт | 5 TSC | Загальна сума, яку кран видає за добу UTC. Коли її вичерпано, запити отримують 429 до наступної доби. |
| Мережа | Лише testnet | Адресу перевіряють за параметрами ланцюга testnet, тож адресу mainnet буде відхилено. Крана для mainnet немає. |
Відповіді
Кожна відповідь — у форматі JSON. Період очікування фіксується лише після підтвердженого надсилання, тож тимчасовий збій ніколи не забирає вашу спробу.
| HTTP | Тіло | Коли |
|---|---|---|
200 | { "txid": "…", "address": "…", "amount": "0.05" } | Монети надіслано в мережу. Період очікування починається зараз. |
400 | { "error": "Provide a valid TensorCash testnet address." } | Адресу не вказано або вона має неправильний формат. |
400 | { "error": "That is not a valid TensorCash testnet address." } | Формат правильний, але адреса недійсна в testnet (наприклад, адреса mainnet). |
403 | { "error": "The faucet is available on testnet only." } | Запит стосується mainnet. |
429 | { "error": "You've already used the faucet recently.", "retry_after_secs": N } | Для цієї адреси або IP ще триває 24-годинний період очікування. |
429 | { "error": "The faucet has hit its daily limit. Try again tomorrow." } | Денний ліміт 5 TSC вичерпано. |
503 | { "error": "The faucet is temporarily empty. Please try again later." } | На гаманці крана менше, ніж одна порція плюс комісія. Його поповнюють вручну. |
Стан
Кран працює всередині seed API testnet. Якщо цей сервіс працює з перебоями, кран повертатиме відповіді 503.
Куди далі
- Посібник regtestОфлайновий шлях: власний локальний ланцюг, миттєві монети, жодних обмежень і мережа не потрібна.
- Довідник JSON-RPCПовний покажчик методів, зокрема
getnewaddress, щоб створити адресу, яку ви тут поповнюєте.