🚧 Статус разработки: Функциональность обработки транзакций находится в активной разработке и тестировании. Эта документация описывает планируемую архитектуру и рабочий процесс. Функции будут выпускаться постепенно по мере готовности к продакшену.
Модуль обработки транзакций обеспечивает безопасное создание, симуляцию и оркестрацию подписания транзакций. Он действует как мост между намерением выполнить транзакцию и её исполнением в блокчейне, предоставляя опыт уровня аппаратных кошельков с комплексным анализом перед выполнением.
Модуль обработки транзакций разделяет логику транзакции на три отдельные фазы:
- Создание - Построение и валидация параметров транзакции
- Симуляция - Предпросмотр того, что именно произойдет перед подписанием
- Исполнение - Координация подписания и трансляции
Это разделение гарантирует, что пользователи всегда понимают последствия транзакции перед использованием средств.
Наиболее критическая функция - симуляция транзакций, показывающая пользователям точно, что произойдет перед подписанием.
Изменения балансов:
- Точные суммы, покидающие и поступающие на каждый адрес
- Движения токенов, включая все затронутые токены
- Затраты на газ в нативной валюте и USD
Эффекты контрактов:
- Изменения состояния смарт-контрактов
- Генерируемые события
- Предоставляемые или потребляемые разрешения токенов
Оценка рисков:
- Предупреждения о необычной активности
- Обнаружение потенциально вредоносных контрактов
- Расчеты проскальзывания для обменов
Для простого обмена токенов симуляция покажет:
До транзакции:
- Кошелек: 10 ETH, 0 USDC
После транзакции:
- Кошелек: 8.95 ETH, 3,500 USDC
- Стоимость газа: 0.05 ETH ($100)
- Влияние на цену: 0.3%
- Маршрут: ETH → WETH → USDC через Uniswap V3Простая отправка нативных токенов или токенов ERC-20/BEP-20 между адресами. Система будет обрабатывать:
- Оптимальный расчет газа
- Управление nonce
- Восстановление после неудачных транзакций
Интеграция с основными DEX протоколами для обмена токенов:
- Автоматическая маршрутизация для лучших цен
- Защита от проскальзывания
- Стратегии защиты от MEV
Вызовы контрактов общего назначения с:
- ABI декодированием для читаемых человеком действий
- Прогнозирование изменений состояния
- Оптимизация газа
Множественные действия в одной транзакции для эффективности:
- Массовые переводы
- Сложные DeFi стратегии
- Оптимизация затрат на газ
Каждая транзакция следует строгим протоколам безопасности:
- Валидация - Все параметры проверяются перед обработкой
- Симуляция - Обязательный предпросмотр эффектов
- Подтверждение пользователя - Требуется явное одобрение
- Изоляция подписания - Приватные ключи никогда не касаются серверов Vilna
Внешние кошельки:
- Интеграция с MetaMask, WalletConnect
- Поддержка аппаратных кошельков (Ledger, Trezor)
- Подключение мобильных кошельков
MPC подписание (Будущее):
- Пороговые подписи с использованием MPC модуля
- Отсутствие единой точки отказа
- Журнал аудита для всех операций подписания
Биржи могут использовать модуль транзакций для обработки выводов пользователей:
- Пользователь инициирует вывод в UI биржи
- Биржа создает транзакцию через Vilna API
- Симуляция показывает точные комиссии и сумму поступления
- Мультиподпись от операторов биржи
- Автоматическая трансляция и отслеживание подтверждений
DeFi платформы могут предложить безопасное взаимодействие с протоколами:
- Пользователь хочет добавить ликвидность в пул
- Платформа симулирует транзакцию, показывая:
- Депонируемые токены
- Получаемые LP токены
- Текущий APY пула
- Риски непостоянных потерь
- Пользователь одобряет с полным пониманием результатов
Платежные шлюзы могут предлагать возвраты и выплаты:
- Продавец инициирует возврат
- Система рассчитывает оптимальные настройки газа
- Симуляция подтверждает, что клиент получит точную сумму возврата
- Автоматическое выполнение с логикой повторных попыток
Все операции с транзакциями доступны через REST API:
- Создание транзакций с параметрами для конкретных типов
- Эндпоинт симуляции, возвращающий детальные предпросмотры
- Оркестрация подписания с множественными методами
- Отслеживание статуса и мониторинг подтверждений
Соответствующие эндпоинты (когда будут доступны):
POST /transactions/create- Построить новую транзакциюPOST /transactions/simulate- Получить результаты симуляцииPOST /transactions/sign- Инициировать процесс подписанияGET /transactions/{id}/status- Отслеживать выполнение
Уведомления в реальном времени о жизненном цикле транзакции:
- Подтверждение создания
- Завершение симуляции
- Прогресс сбора подписей
- Статус трансляции
- Подтверждения блокчейна
Поскольку модуль находится в разработке, некоторые функции еще недоступны:
- Прямые взаимодействия со смарт-контрактами ограничены
- Не все DEX протоколы интегрированы
- Поддержка аппаратных кошельков тестируется
- Пакетные транзакции в дорожной карте
Определение правил для предотвращения ошибок и мошенничества:
- Дневные лимиты расходов
- Белый список разрешенных получателей
- Временные ограничения
- Требования множественного одобрения
Встроенная защита без настройки:
- Обнаружение недостаточного баланса
- Предупреждения о чрезвычайно высоком газе
- Обнаружение вредоносных контрактов
- Предотвращение атак повторного входа
- Ручное построение сырой транзакции
- Оценка газа (часто неправильная)
- Подписание без знания эффектов
- Надежда на успех транзакции
- Ручная обработка сбоев
- Структурированное создание транзакций
- Точная оптимизация газа
- Предпросмотр точных результатов
- Уверенное выполнение
- Автоматические повторы и восстановление
- Базовая структура транзакций
- Фреймворк симуляции
- Простые переводы (тестирование)
- Интеграции с DEX
- Улучшенная точность симуляции
- Подключения внешних кошельков
- Полная поддержка смарт-контрактов
- Кроссчейн транзакции
- Продвинутая защита от MEV
- Группировка транзакций
Пока полный модуль в разработке, вы можете:
- Связаться с [email protected] для бета-доступа
- Тестировать симуляцию транзакций в песочнице
- Предоставить обратную связь о желаемых функциях
- Подготовить интеграцию к предстоящему релизу
- Безопасность прежде всего: Каждая транзакция симулируется перед выполнением
- Контроль пользователя: Пользователи всегда видят и одобряют эффекты транзакции
- Без приватных ключей: Vilna никогда не имеет доступа к ключам подписания
- Поэтапный релиз: Функции выпускаются по мере готовности к продакшену
- Обзор архитектуры - Понять, как транзакции вписываются в платформу
- Основная платформа - Узнать о мониторинге адресов и доступе к данным
- Справочник API - Изучить доступные эндпоинты