Основная платформа — это операционное ядро Vilna, обеспечивающее мониторинг блокчейна в реальном времени, генерацию кошельков и комплексную аналитику данных. Она служит фундаментом для создания любого крипто-приложения — от простых платежных процессоров до сложных DeFi платформ.
Основная платформа решает фундаментальные задачи интеграции с блокчейном:
- Управление кошельками: Генерация и организация миллионов адресов из одного xPub ключа
- Мониторинг в реальном времени: Отслеживание активности блокчейна в нескольких сетях одновременно
- Доступ к данным: Мгновенный запрос исторических транзакций и текущих балансов
- Уведомления о событиях: Получение оповещений при возникновении определенных событий в блокчейне
Биржи должны управлять миллионами депозитных адресов пользователей, отслеживая все входящие транзакции:
Подход к реализации:
- Импорт xPub ключа биржи через
POST /xpubs - Генерация уникальных адресов для каждого пользователя с
POST /addresses/generate/xpub/next - Настройка webhook уведомлений для входящих транзакций
- Автоматическая обработка депозитов при достижении порога подтверждений
Платежные процессоры должны создавать уникальные адреса для каждого счета и проверять платежи:
Ключевые требования:
- Генерация платежных адресов по требованию
- Мониторинг точных сумм платежей
- Обработка частичных платежей и переплат
- Поддержка множества криптовалют
Решение с Vilna:
- Использование API генерации адресов для создания уникальных платежных адресов
- Настройка вебхуков для получения уведомлений о платежах
- Запрос API балансов для проверки сумм платежей
- Отслеживание истории транзакций для сверки
DeFi платформам необходимо агрегировать позиции пользователей в различных протоколах:
Требования к мониторингу:
- Отслеживание балансов кошельков пользователей в разных сетях
- Мониторинг позиций в пулах ликвидности
- Расчет общей стоимости портфеля
- Обнаружение взаимодействий с DeFi протоколами
Vilna обеспечивает:
- Массовый импорт пользовательских адресов для мониторинга
- Отслеживание балансов в реальном времени по всем поддерживаемым токенам
- Исторические данные для анализа производительности портфеля
- Уведомления о событиях при изменении позиций
Генерация HD wallet адресов по стандартам BIP32/44/84. Система поддерживает:
- Последовательную генерацию адресов с обработкой лимита пропусков
- Маркировку адресов и хранение метаданных
- Автоматический мониторинг всех сгенерированных адресов
- Поддержку множественных путей деривации
Соответствующие API эндпоинты:
POST /xpubs- Импорт xPub ключейPOST /addresses/generate/xpub/next- Генерация следующего адресаGET /addresses- Список всех адресов
Движок мониторинга непрерывно сканирует множество блокчейнов на предмет активности отслеживаемых адресов:
Поддерживаемые сети:
- EVM сети (Ethereum, BSC, Polygon, Arbitrum, Optimism)
- Bitcoin и Bitcoin-совместимые сети
- Решения второго уровня
- Альтернативные сети (Solana, TON и др.)
Возможности мониторинга:
- Обнаружение транзакций (ожидающие и подтвержденные)
- Переводы токенов (ERC-20, BEP-20, SPL)
- Перемещения NFT
- Взаимодействия со смарт-контрактами
- Внутренние транзакции
Настройка оповещений в реальном времени о событиях блокчейна:
Webhook уведомления:
- HTTP POST запросы на ваши эндпоинты
- HMAC подпись для безопасности
- Автоматические повторные попытки с экспоненциальной задержкой
- Отслеживание статуса доставки
Email оповещения:
- Настраиваемые шаблоны
- Триггеры на основе порогов
- Ежедневные сводные отчеты
- Уведомления о критических событиях
Типы событий:
transaction.pending- Обнаружена неподтвержденная транзакцияtransaction.confirmed- Транзакция достигла порога подтвержденийbalance.changed- Обновлен баланс адресаtoken.received- Обнаружен перевод токенов ERC-20/BEP-20
Доступ к комплексным данным блокчейна через API:
Запросы балансов:
- Текущий баланс по адресу
- Агрегация балансов множества токенов
- Расчет стоимости в USD
- Снимки истории балансов
История транзакций:
- Полные записи транзакций
- Расширенные опции фильтрации
- Детали переводов токенов
- Аналитика использования газа
Соответствующие API эндпоинты:
GET /addresses/{address}/balances- Получение текущих балансовGET /transactions- Запрос истории транзакций
Для приложений, обрабатывающих тысячи адресов:
- Используйте массовый импорт для существующих адресов
- Реализуйте очередь вебхуков для уведомлений большого объема
- Кэшируйте данные балансов локально с периодическим обновлением
- Используйте пагинацию для больших запросов данных
- Без приватных ключей: Основная платформа работает только в режиме просмотра
- HMAC верификация: Проверяйте все подписи вебхуков
- Ограничение скорости: Реализуйте соответствующее ограничение запросов
- Идемпотентность: Корректно обрабатывайте дублированные уведомления
- Пакетные операции: Группируйте множественные запросы когда возможно
- Фильтрация вебхуков: Подписывайтесь только на нужные события
- Локальное кэширование: Храните часто используемые данные
- Эффективные запросы: Используйте соответствующие фильтры и пагинацию
Преимущества:
- Не требуется обслуживание инфраструктуры
- Поддержка множества сетей без множественных нод
- Встроенная система уведомлений
- Автоматическое обнаружение токенов
Когда использовать Vilna:
- Требуется поддержка множества сетей
- Хотите сосредоточиться на бизнес-логике
- Нужна надежная работоспособность без DevOps накладных расходов
Уникальные возможности:
- Генерация адресов на основе xPub
- Единый API для всех блокчейнов
- Настраиваемые правила уведомлений
- Надежность корпоративного уровня
- Определите требования: Определите, какие блокчейны и события вам нужно отслеживать
- Импортируйте адреса: Используйте xPub ключи для новых адресов или массовый импорт существующих
- Настройте уведомления: Настройте вебхуки или email оповещения для соответствующих событий
- Интегрируйте API: Используйте REST API для запросов балансов и транзакций
Для деталей реализации обратитесь к:
- Быстрый старт - Пошаговые инструкции по настройке
- Справочник API - Полная документация API
- Каналы уведомлений - Настройка вебхуков и email
- Обзор архитектуры - Понимание полной платформы
- Обработка транзакций - Узнайте о создании и подписании транзакций
- MPC управление ключами - Изучите продвинутые опции безопасности