Основные концепции

Platform API Vilna отслеживает адреса, кошельки и входящие платежи и возвращает нормализованные данные через REST API и уведомления о событиях. Он использует публичные данные блокчейна. Поддерживаемые основные и тестовые сети перечислены в разделе Сети; Solana поддерживает только регистрацию адресов и каталог токенов.

Некастодиальность в основе Один API, 9 сетей Открытые стандарты Без процента с ваших средств

Как работает Vilna

Platform API предоставляет приложению нормализованные данные публичных блокчейнов. В зависимости от сети он регистрирует адреса, читает балансы и транзакции, отслеживает подтверждения и отправляет уведомления по выбранному условию подписки. Доступные возможности приведены в таблице сетей.

В сетиПоддерживаемые сетиТранзакции проходят во всех поддерживаемых сетях.

читает

PlatformНаблюдает и нормализуетОтслеживает подтверждения и реорганизации, выводит адреса из xPub и приводит данные сети к общему формату.только чтение · без хранения средств

отдаёт

Ваше приложениеОдин API + вебхукиДанные в общем формате и подписанные уведомления о событиях.

Мониторинг Platform читает данные сети и передаёт их вашему приложению. Он не подписывает и не отправляет транзакции. Подпись в VKS - отдельный процесс.

Поскольку Platform API читает данные блокчейна, он работает исключительно с публичной информацией: адресами блокчейна и расширенными публичными ключами. Он никогда не запрашивает и не хранит приватные ключи или seed-фразы и не может подписать или транслировать транзакцию. Ваши ключи и средства остаются ровно там, где они есть.

Эти принципы мониторинга относятся к Platform API. VKS - отдельный сценарий подписи; см. API для разных задач.

Построено безопасно и открыто

Базовые гарантии

Некастодиальность

Мониторинг Platform использует публичные данные блокчейна: адреса и публичные ключи, никогда приватные ключи или seed-фразы. Он не может двигать ваши средства.

Без процента с ваших средств

Поскольку мониторинг Platform не касается ваших денег, она не берёт процент ни с одного платежа или транзакции, за которыми наблюдает.

Стандарты в основе

Открытые спецификации повсюду: идентификаторы CAIP для сетей и активов, деривация BIP-32/44, ошибки RFC 7807. Никаких закрытых форматов.

Вне зависимости от сети

Один REST API и единый формат ответа для каждой сети. Добавление сети не меняет вашу интеграцию.

API для разных задач

У каждого сервиса свои ключи и область доступа. Создайте рабочее пространство и ключи в кабинете, затем используйте документированные публичные операции:

Platform API

Следите за адресами и кошельками, читайте балансы и транзакции, сверяйте входящие платежи и получайте уведомления об активности.

АдресаБалансыТранзакцииСчетаВебхуки

Blockchain RPC

Обращайтесь к узлам блокчейна напрямую во всех поддерживаемых сетях через единый эндпоинт и один ключ, без своей инфраструктуры.

JSON-RPCgRPCЛюбая сеть

Management API

Используйте публичные операции пространств, проектов и участников; начальная настройка и часть действий с ключами требуют кабинета.

ПространстваПроектыУчастникиКлючи

VKS API

VKS координирует настройку блокчейн-аккаунтов, согласование и совместную подпись через узлы подписи (signer). Готовую подписанную транзакцию можно отправить узлу блокчейна через VKS. Принятие узлом не означает подтверждения в блокчейне.

SignerVaultБлокчейн-аккаунтыПодпись

Впервые столкнулись с базовыми идеями - адреса, ключи и HD-деривация? Начните с Основ блокчейна.

Данные, на которые можно положиться

Для событий Platform API, из какой бы сети ни пришло событие, формат ответа один и тот же, поэтому код пишется один раз, а не отдельно под каждую сеть.

Суммы. Многие поля транзакций и балансов содержат base (строку целого числа в наименьших единицах токена) и formatted (текст для отображения). В аутентифицированном счёте amount, received_amount и confirmed_amount - строки базовых единиц; публичное представление содержит base и необязательный formatted. Следуйте схеме конкретного поля. Для вычислений используйте BigInt или библиотеку точной десятичной арифметики, для отображения - decimals из метаданных точного токена. См. форматирование суммы счёта.
Связанные данные. Ответы содержат объект references со связанными токенами, сетями и адресами, так что результат можно отрисовать без дополнительных запросов.
Стабильные идентификаторы. Сети, адреса в конкретных сетях и активы названы идентификаторами CAIP, единая форма идентификатора везде.

Полный справочник ресурсов смотрите в Platform API, а форматы идентификаторов - в Стандартах.