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

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

## Архитектура платформы


```mermaid
graph TB
    subgraph "Модуль 1: MPC управление ключами (Опционально)"
        KG[Генерация ключей CGGMP]
        SHARD[Распределение шардов]
        MPC[MPC инфраструктура]
        XPUB_MPC[Экспорт публичного ключа]
    end
    
    subgraph "Внешние источники"
        XPUB_EXT[Существующие xPub ключи<br/>Аппаратные кошельки<br/>Программные кошельки<br/>Сторонние сервисы]
    end
    
    subgraph "Модуль 2: Ядро Vilna"
        MON[Мониторинг адресов]
        GEN[Генерация кошельков]
        NOT[Уведомления в реальном времени]
        HIST[История транзакций]
        BAL[Отслеживание балансов]
    end
    
    subgraph "Модуль 3: Обработка транзакций"
        INIT[Инициация транзакции]
        SIM[Симуляция транзакции]
        SIGN[Безопасное подписание]
        BROAD[Отправка в блокчейн]
    end
    
    KG --> SHARD
    SHARD --> MPC
    MPC --> XPUB_MPC
    XPUB_MPC --> GEN
    XPUB_EXT --> GEN
    GEN --> MON
    MON --> NOT
    MON --> HIST
    MON --> BAL
    BAL --> INIT
    INIT --> SIM
    SIM --> SIGN
    SIGN --> BROAD
```

**Гибкость интеграции ключей**: Vilna поддерживает несколько подходов к управлению ключами. Хотя Модуль 1 обеспечивает генерацию и управление ключами корпоративного уровня с помощью MPC, вы также можете импортировать существующие xPub ключи из любого источника - аппаратных кошельков (Ledger, Trezor), программных кошельков или сторонних кастодиальных сервисов. Эта гибкость позволяет организациям интегрировать Vilna с существующей инфраструктурой, сохраняя возможность перехода на MPC-безопасность при необходимости.

## Модуль 1: MPC управление ключами

### Безопасная генерация ключей с шардированием

Vilna реализует алгоритм CGGMP (Canetti-Gennaro-Goldfeder-Makriyannis-Peled) для генерации пороговых подписей, обеспечивая институциональный уровень безопасности управления приватными ключами.


```mermaid
graph LR
    subgraph "Процесс генерации ключей"
        A[Инициализация CGGMP] --> B[Генерация шардов]
        B --> C[Распределение между участниками]
        C --> D[Получение xPub ключа]
        D --> E[Импорт в Vilna]
    end
```

**Ключевые возможности:**

- **Распределенная генерация ключей**: Приватные ключи никогда не собираются в одном месте
- **Пороговые подписи**: Требуется m-из-n участников для подписи транзакций
- **Отсутствие единой точки отказа**: Шарды ключей хранятся в нескольких защищенных местах
- **MPC инфраструктура**: Vilna предоставляет безопасные каналы связи между шардами


**Сценарии использования:**

- Институциональные кастодиальные решения
- Управление мультипартийными кошельками
- Высокозащищенные операции инкассации
- Соответствие регуляторным требованиям


## Модуль 2: Основная платформа Vilna

### Комплексный мониторинг и управление активами

Основная платформа Vilna обеспечивает мониторинг блокчейна в реальном времени, генерацию кошельков и комплексную аналитику данных.


```mermaid
graph LR
    subgraph "Ваши данные"
        XPUB[Расширенные публичные ключи]
        ADDR[Отдельные адреса]
    end
    
    subgraph "Сервисы Vilna"
        MON[Мониторинг 24/7]
        GEN[Генерация адресов]
        ALERT[Система оповещений]
        DATA[Аналитика данных]
    end
    
    subgraph "Ваш доступ"
        API[REST API]
        WEB[Веб-панель]
        WH[Вебхуки]
        EMAIL[Email уведомления]
    end
    
    XPUB --> GEN
    ADDR --> MON
    GEN --> MON
    MON --> ALERT
    MON --> DATA
    ALERT --> WH
    ALERT --> EMAIL
    DATA --> API
    DATA --> WEB
```

**Основные возможности:**

### Генерация кошельков

- Генерация неограниченного количества адресов из xPub ключей
- Поддержка множества блокчейн-сетей
- Соответствие стандартам HD кошельков (BIP32/44/84)
- Автоматическая индексация и отслеживание адресов


### Мониторинг в реальном времени

- Круглосуточный мониторинг блокчейна
- Мгновенное обнаружение входящих/исходящих транзакций
- Поддержка множества сетей
- Настраиваемые пороги оповещений


### Уведомления и оповещения

- Webhook уведомления для системной интеграции
- Email оповещения для критических событий
- Настраиваемые правила уведомлений
- Push-уведомления в реальном времени


### Данные и аналитика

- Полная история транзакций
- Отслеживание балансов в реальном времени
- Расширенная фильтрация и поиск
- Возможности экспорта для отчетности


## Модуль 3: Обработка и подписание транзакций

### Безопасное управление транзакциями

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


```mermaid
sequenceDiagram
    participant Пользователь
    participant Vilna
    participant Устройство
    participant Блокчейн
    
    Пользователь->>Vilna: Инициировать транзакцию
    Vilna->>Vilna: Построить транзакцию
    Vilna->>Пользователь: Симуляция транзакции
    Пользователь->>Пользователь: Проверка симуляции
    Пользователь->>Vilna: Подтвердить намерение
    Vilna->>Устройство: Отправить сырую транзакцию
    Устройство->>Устройство: Подписать шардом ключа
    Устройство->>Vilna: Вернуть подпись
    Vilna->>Блокчейн: Отправить транзакцию
    Блокчейн->>Vilna: Подтверждение
    Vilna->>Пользователь: Транзакция завершена
```

**Типы транзакций:**

- **Простые переводы**: Отправка активов на адреса
- **Обменные операции (Swap)**: Обмен между токенами
- **Взаимодействие со смарт-контрактами**: DeFi операции
- **Пакетные транзакции**: Несколько операций в одной транзакции


**Функции безопасности:**

- **Симуляция транзакций**: Предварительный просмотр результатов перед подписанием
- **Безопасный транспорт**: Зашифрованные каналы связи
- **Безопасность уровня аппаратных кошельков**: Подход похожий на Ledger/Trezor
- **Поддержка мультиподписи**: Требование нескольких подтверждений для ценных транзакций


**Детали симуляции:**
Перед подписанием любой транзакции Vilna предоставляет:

- Точные расчеты газа/комиссий
- Предварительный просмотр изменений баланса
- Визуализация эффектов смарт-контрактов
- Оценка рисков и предупреждения
- Отображение требований к подтверждению


## Сценарии интеграции

### Сценарий 1: Биржевая платформа


```
1. Генерация депозитных адресов для пользователей (Модуль 2)
2. Мониторинг всех адресов на предмет депозитов (Модуль 2)
3. Агрегация средств в горячий кошелек (Модуль 3)
4. Обработка выводов с MPC подписанием (Модули 1 и 3)
```

### Сценарий 2: Корпоративная инкассация


```
1. Создание мультисиг-системы инкассации с CGGMP (Модуль 1)
2. Отслеживание всех корпоративных кошельков (Модуль 2)
3. Выполнение утвержденных транзакций (Модуль 3)
4. Генерация отчетов для комплаенса (Модуль 2)
```

### Сценарий 3: Платежный процессор


```
1. Генерация уникальных адресов для счетов (Модуль 2)
2. Мониторинг платежей клиентов (Модуль 2)
3. Автоматическая обработка расчетов (Модуль 3)
4. Уведомления о платежах в реальном времени (Модуль 2)
```

## Начало работы

### Шаг 1: Настройка управления ключами

Выберите подход к управлению ключами:

- **MPC настройка**: Инициализируйте протокол CGGMP для максимальной безопасности (Модуль 1)
- **Импорт существующих xPub**: Используйте расширенные публичные ключи из аппаратных кошельков, программных кошельков или любого другого источника
- **Добавление отдельных адресов**: Мониторинг существующих блокчейн-адресов без xPub


### Шаг 2: Настройка мониторинга

- Настройте каналы уведомлений (вебхуки, email)
- Настройте пороги оповещений
- Определите правила мониторинга


### Шаг 3: Обработка транзакций

- Настройте устройства/сервисы подписания
- Настройте политики транзакций
- Протестируйте в режиме симуляции


## Архитектура безопасности


```mermaid
graph TD
    subgraph "Уровни безопасности"
        L1[MPC шардирование ключей - Полный приватный ключ никогда не раскрывается]
        L2[Шифрованная связь - Все данные в передаче зашифрованы]
        L3[Симуляция транзакций - Предпросмотр перед подписанием]
        L4[Поддержка мультиподписи - Требуются множественные подтверждения]
        L5[Журналирование аудита - Полная история транзакций]
    end
    
    L1 --> L2
    L2 --> L3
    L3 --> L4
    L4 --> L5
```

## Интеграция API

Все три модуля доступны через наш унифицированный REST API:


```http
# Модуль 1: MPC операции
POST /api/v1/mpc/initialize
GET  /api/v1/mpc/status

# Модуль 2: Основная платформа
POST /api/v1/wallets/generate
GET  /api/v1/addresses/{address}/balance
GET  /api/v1/addresses/{address}/transactions
POST /api/v1/webhooks/configure

# Модуль 3: Обработка транзакций
POST /api/v1/transactions/create
POST /api/v1/transactions/simulate
POST /api/v1/transactions/sign
POST /api/v1/transactions/broadcast
```

## Следующие шаги

- [Быстрый старт](/ru/guides/quickstart) - Начните работу за несколько минут
- [Справочник API](/apis/spec) - Полная документация API
- [Каналы уведомлений](/ru/guides/channels) - Настройте оповещения и вебхуки