Какие блокчейны поддерживает Vilna?
Более 30 сетей, включая Bitcoin, Ethereum, BNB Smart Chain, Polygon, Avalanche, Arbitrum, Optimism, Base, Solana, TRON, TON и другие. Вызовите GET /blockchains для получения актуального списка.
Как получить доступ?
Свяжитесь с support@vilna.io для запроса корпоративного доступа. Вы получите пространство имён и API-ключ.
Что такое пространство имён (namespace)?
Каждое рабочее пространство получает выделенное пространство имён, которое изолирует её данные. Базовый URL вашего API: https://{namespace}.vilna.app. Все ресурсы (адреса, балансы, каналы уведомлений) привязаны к вашему пространству имён.
Какой метод аутентификации использует API?
Все запросы требуют API-ключ, передаваемый в заголовке X-Api-Key. Подробнее см. в руководстве по аутентификации.
В чем разница между внешними и HD-адресами?
Внешние адреса импортируются напрямую — вы указываете полную строку адреса. HD-адреса деривируются из расширенного публичного ключа (xPub) по стандартам BIP-32/44, что позволяет программно генерировать новые адреса без раскрытия приватных ключей.
Можно ли отслеживать один адрес в нескольких сетях?
Да. Для EVM-совместимых сетей достаточно указать chainFamily: "evm" при создании адреса, и он автоматически будет отслеживаться во всех активных EVM-сетях.
Как представлены суммы?
Все суммы имеют два поля:
base— необработанное целочисленное значение в виде строки (например,"1000000")formatted— человекочитаемое значение с применёнными десятичными знаками (например,"1.0"для USDT с 6 десятичными знаками)
Всегда используйте base для вычислений, а formatted — для отображения.
Какие методы уведомлений поддерживаются?
Два типа: вебхуки (HTTP POST на ваш эндпоинт) и Telegram (сообщения бота в чат). Инструкции по настройке см. в руководстве по каналам уведомлений.
Как проверить подлинность вебхука?
Проверьте заголовок X-Webhook-Signature, который содержит HMAC-SHA256 дайджест тела запроса. Также валидируйте X-Webhook-Timestamp для предотвращения атак воспроизведения и используйте X-Webhook-Idempotency-Key для дедупликации. Примеры кода см. в разделе Аутентификация.
Примечание: Верификация подписи вебхуков — планируемая функция. Описанные выше заголовки пока недоступны в продакшене.
Можно ли тестировать вебхуки без реальных транзакций?
Да. Используйте тестовое действие для отправки примера payload на ваш канал:
curl -X POST "https://${VILNA_NAMESPACE}.vilna.app/notification_channels/{notification_channel_id}/actions/test" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{ "message_type": "transaction_alert" }'Какие языки программирования поддерживаются?
Официальный TypeScript SDK (@vilna/sdk) доступен в npm. Для других языков вы можете сгенерировать клиент из OpenAPI-спецификации с помощью инструментов, таких как openapi-generator или oapi-codegen.
Нужен ли SDK для использования API?
Нет. SDK предоставляет удобные методы и полную типобезопасность TypeScript, но вы можете вызывать REST API напрямую из любого языка через стандартный HTTP.
Что такое Storage Client?
@vilna-io/storage-client — это отдельный npm-пакет для веб-приложений, которым нужно взаимодействовать с браузерным расширением Vilna Storage (кошельком). Он обеспечивает обнаружение расширения, подключение и подписание транзакций.
Что такое CAIP?
Chain Agnostic Improvement Proposals — набор стандартов для идентификации блокчейнов, аккаунтов и активов в различных сетях:
| Стандарт | Назначение | Пример |
|---|---|---|
| CAIP-2 | Идентификатор сети | eip155:1 (основная сеть Ethereum) |
| CAIP-10 | Идентификатор аккаунта | eip155:1:0x742d... |
| CAIP-19 | Идентификатор актива | eip155:1/erc20:0xa0b8... |
Полную справку см. в разделе Стандарты CAIP.
Какой формат ошибок использует API?
Все ошибки соответствуют формату RFC 7807 Problem Details. Полный справочник по ошибкам и советы по устранению неполадок см. в разделе Ошибки и устранение неполадок.
- Быстрый старт — начните работу за 10 минут
- TypeScript SDK — установка и использование SDK
- Platform API — полная документация эндпоинтов
- Management API — управление рабочими пространствами, проектами и ключами