Лимиты и метрики
Как считается использование, какие действуют лимиты и как получить аналитику по аккаунту.
Подход: сначала измеряем, не блокируем#
Метеринг заложен с первого дня, но на старте он не ограничивает разработчиков жёсткими квотами на вызовы. Цель — собирать прозрачные метрики использования, чтобы в дальнейшем ввести справедливые тарифы и при росте нагрузки гибко настраивать лимиты.
Что метрируется#
Каждая значимая операция записывается в журнал использования с типом, сетью, методом, расходом газа и хэшом транзакции:
| Тип | Когда фиксируется |
|---|---|
| read | Каждый query через API-ключ |
| write | Каждый invoke через API-ключ |
| deploy | Успешный деплой контракта |
| faucet | Успешное начисление газа |
Эти же записи питают историю кошелька и аналитику.
Действующие лимиты#
| Лимит | Значение | Область |
|---|---|---|
| HTTP rate limit | 600 запросов / минуту на IP | Все эндпоинты API |
| Faucet | 5 начислений / сутки, 10 KSC | Только testnet |
| Квоты на query/invoke/deploy | нет (на текущем этапе) | Метрируется, не блокируется |
Лимиты могут меняться
По мере развития платформы лимиты и тарифы будут уточняться. Метрики использования — основа для их справедливой настройки.
Аналитика#
GET
/api/devportal/developers/:id/analyticsBearer (dev)Возвращает агрегаты по журналу использования: суммарные read/write/deploy/faucet/вызовы, дневные ряды, топ методов, разбивку по контрактам, суммарный газ и счётчики ключей. Параметр days (1–90, по умолчанию 14) задаёт окно.
bash
curl "https://kazsmartchain.org/api/devportal/developers/<DEV_ID>/analytics?days=30" \
-H "Authorization: Bearer <JWT>"- Те же данные визуализируются в разделе «Analytics» портала.
- Краткая сводка выводится на главной странице кабинета.