Портал разработчика

Faucet

Бесплатный тестовый газ в testnet: лимиты, использование и ограничения.

Что это#

Faucet выдаёт нативный KSC в testnet, чтобы вы могли деплоить контракты и тестировать вызовы без затрат. Газ начисляется на ваш кастодиальный кошелёк. Запросить можно в разделе «Wallet & Faucet» портала или по API.

Только testnet

Faucet работает исключительно в testnet. Запрос с network: "mainnet" вернёт ошибку 400.

Лимиты#

Параметр	Значение по умолчанию
Сумма за начисление	10 KSC
Максимум начислений в сутки	5 на разработчика
Сеть	только testnet

Лимиты считаются по успешным начислениям за последние 24 часа. Превышение возвращает 429 Too Many Requests.

API#

POST/api/devportal/faucet/dripBearer (dev)

developerId берётся из JWT; в теле можно указать network (по умолчанию testnet).

Запрос

curl -X POST https://kazsmartchain.org/api/devportal/faucet/drip \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{ "network": "testnet" }'

Ответ

{
  "txHash": "0x21d1...3f8f",
  "amountEth": "10"
}

Ошибки#

400 — запрос faucet вне testnet.
429 — превышен суточный лимит начислений.
503 — faucet временно недоступен (не сконфигурирован ключ выдачи).