Кран testnet

Кран — это онлайн-точка входа для разработки на TensorCash. Он отправляет небольшое количество testnet-монет на любой валидный testnet-адрес: так можно пополнить кошелёк, опробовать JSON-RPC и протестировать сценарии с моделями или активами на живой общей цепочке. Монеты ничего не стоят. Если нужна полностью офлайн-песочница с мгновенными и неограниченными монетами, загляните в Руководство по regtest.

Только testnet · 0,05 TSC за запрос · ожидание 24 ч

Получить монеты

Отправьте POST-запрос с вашим testnet-адресом в формате JSON. Без API-ключа и без аккаунта. При успехе в ответе придёт id транзакции, отправленной в сеть; отследить её можно в обозревателе 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 для создания адреса, который вы пополняете здесь.