Bitcoin, Ethereum, BNB Smart Chain, Polygon, Avalanche, Arbitrum, Optimism, Base, Solana, TRON, TON и другие. Вызовите GET /blockchains для получения актуального списка.
Зарегистрируйтесь на app.vilna.io, создайте рабочее пространство и проект, затем сгенерируйте API-ключ. Платформа бесплатна на этапе раннего доступа. Если нужна помощь - пишите на support@vilna.io.
Все запросы требуют API-ключ, передаваемый в заголовке X-Api-Key. Подробнее см. в руководстве по аутентификации.
Внешние адреса импортируются напрямую - вы указываете полную строку адреса. 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://api.vilna.io/v1/channels/{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 предоставляет удобные методы и полную типобезопасность TypeScript, но вы можете вызывать REST API напрямую из любого языка через стандартный HTTP.
@vilna-io/storage-client - это отдельный npm-пакет для веб-приложений, которым нужно взаимодействовать с браузерным расширением Vilna Storage (кошельком). Он обеспечивает обнаружение расширения, подключение и подписание транзакций.
Chain Agnostic Improvement Proposals - набор стандартов для идентификации блокчейнов, аккаунтов и активов в различных сетях:
| Стандарт | Назначение | Пример |
|---|---|---|
| CAIP-2 | Идентификатор сети | eip155:1 (основная сеть Ethereum) |
| CAIP-10 | Идентификатор аккаунта | eip155:1:0x742d... |
| CAIP-19 | Идентификатор актива | eip155:1/erc20:0xa0b8... |
Полную справку см. в разделе Стандарты CAIP.
Все ошибки соответствуют формату RFC 7807 Problem Details. Полный справочник по ошибкам и советы по устранению неполадок см. в разделе Ошибки и устранение неполадок.