17 · ТЕХНИЧЕСКАЯ АРХИТЕКТУРА
Multi-EVM · Микросервисы · AWS Cloud · Пополнение картой · Единый Vault · Мосты · DEX-агрегатор · Safe{Wallet} · CI/CD · Мониторинг
Масштабируемость до 10M пользователей
⚠️ Архитектура обеспечивает инфраструктуру распределения доходности. Target Yield не является гарантией — фактическая доходность зависит от условий DeFi-рынка.
1. Архитектурный обзор
┌──────────────────────────────────────────────────────────────────┐
│ CLIENT LAYER │
│ ┌────────────────┐ ┌──────────────────┐ ┌───────────────┐ │
│ │ Mobile App │ │ Web Dashboard │ │ Admin Panel │ │
│ │ (RN / Swift / │ │ (React 18 + TS) │ │ (React 18) │ │
│ │ Kotlin) │ │ │ │ │ │
│ └───────┬────────┘ └────────┬─────────┘ └───────┬───────┘ │
│ └───────────────────┬┴───────────────────┘ │
│ │ HTTPS / WSS │
├─────────────────────────────┼────────────────────────────────────┤
│ ▼ │
│ API GATEWAY (Kong) │
│ Rate limiting · Auth · Routing │
├──────────────────────────────────────────────────────────────────┤
│ MICROSERVICES LAYER │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Auth │◄─gRPC─►│ WVI │◄─gRPC─►│ Yield │◄─gRPC─►│ Partner │
│ │ Service │ │ Service │ │ Service │ │ Service │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ AI │ │ Notif. │ │Bracelet │ │ Bridge │ │
│ │ Service │ │ Service │ │ Service │ │ Service │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ ┌──────────┐ ┌──────────┐ │
│ │ On-Ramp │ │ Content │ │
│ │ Service │ │ Service │ │
│ └──────────┘ └──────────┘ │
│ *** Все inter-service вызовы — gRPC/Protobuf *** │
│ *** REST/JSON — только на уровне API Gateway *** │
├──────────────────────────────────────────────────────────────────┤
│ BLOCKCHAIN LAYER (MULTI-EVM) │
│ EVM: Ethereum · Polygon · BSC · Arbitrum · Optimism · Base · Av.│
│ + Tron (TRC-20 USDT/USDC) + Solana (SPL USDC) │
│ Safe{Wallet} + ERC-4337 · WellexVault (ERC-4626) · Chainlink │
│ LayerZero / Across (bridges) · 1inch / 0x / ParaSwap (DEX agg.) │
├──────────────────────────────────────────────────────────────────┤
│ ON-RAMP / OFF-RAMP LAYER │
│ Fiat on-ramp (bank card, local methods) → USDC/USDT │
│ Off-ramp / Payout to card (local methods by region) │
├──────────────────────────────────────────────────────────────────┤
│ AI LAYER │
│ AI Coach (on-device + cloud) · Wallet Agent · Insurance Agent │
├──────────────────────────────────────────────────────────────────┤
│ DATA LAYER │
│ PostgreSQL · Redis · S3 · IPFS · TimescaleDB │
└──────────────────────────────────────────────────────────────────┘
2. Multi-EVM блокчейн-архитектура
2.1 Поддерживаемые сети
| Сеть | Chain ID | Приоритет | Назначение |
|---|
| Ethereum | 1 | 🔴 Основной | Основной vault, максимальная ликвидность DeFi |
| Polygon PoS | 137 | 🔴 Основной | Низкие газ-комиссии, массовые транзакции |
| Arbitrum One | 42161 | 🟡 Вторичный | L2 с высокой DeFi-ликвидностью |
| Optimism | 10 | 🟡 Вторичный | L2, экосистема Superchain |
| Base | 8453 | 🟡 Вторичный | Coinbase L2, fiat on-ramp |
| BSC | 56 | 🟡 Вторичный | Азиатские рынки, низкий газ |
| Avalanche C-Chain | 43114 | 🟢 Третичный | DeFi-экосистема, институциональные инструменты |
| Tron | — | 🟡 Вторичный | TRC-20 USDT/USDC, широкое использование в Азии |
| Solana | — | 🟡 Вторичный | SPL USDC, низкие комиссии, быстрые транзакции |
2.2 Единый WellexVault на каждой сети
На каждой поддерживаемой EVM-сети разворачивается один WellexVault (ERC-4626). Никаких трёх траншей (Conservative/Balanced/Aggressive) — единый vault с WVI-based yield.
User Deposit (USDC/USDT)
│
├── [On-Ramp] → Fiat → USDC on target chain
├── [DEX Swap] → 1inch/0x/ParaSwap → USDC (if other token)
└── [Direct] → USDC/USDT transfer
│
▼
┌─────────────────────────┐
│ WellexVault (ERC-4626) │ ← один vault на каждой сети
│ Deposit → shares (wUSDC)│
│ WVI → Monthly Yield │
└───────────┬─────────────┘
│
┌─────────┴─────────┐
▼ ▼
DeFi Strategies Cross-chain
(Aave, Compound, Liquidity
Curve, Ondo) (LayerZero/Across)
2.3 Архитектура смарт-контрактов
| Контракт | Стандарт | Назначение | Деплой |
|---|
WellexVault | ERC-4626 + UUPS Proxy | Единый vault — депозит, shares, yield | Каждая сеть |
StrategyManager | Ownable2Step | Управление DeFi-аллокациями, timelock 6ч | Каждая сеть |
YieldDistributor | Custom | Еженедельное распределение yield по WVI | Каждая сеть |
WellnessOracle | Chainlink-style | WVI on-chain (месячный) | Каждая сеть |
ProtectionReserve | Custom | Страховой пул | Ethereum (основной) |
WithdrawalQueue | Custom | Очередь при низкой ликвидности | Каждая сеть |
BridgeRouter | Custom | Маршрутизация кросс-чейн | Каждая сеть |
2.4 Safe{Wallet} + ERC-4337 (Абстракция аккаунта)
Каждый пользователь получает Smart Account на базе Safe{Wallet} с поддержкой ERC-4337:
| Компонент | Технология | Назначение |
|---|
| Smart Account | Safe{Wallet} (ERC-4337) | Пользовательский кошелёк, gasless tx |
| Paymaster | Wellex Paymaster | Оплата газа за пользователя (USDC) |
| Recovery | Safe Social Recovery Module | Восстановление через email + guardian |
Преимущества:
- Пользователь не видит blockchain — gasless, без seed phrase
- Батчинг транзакций (deposit + stake = 1 UserOp)
- Social recovery (email + guardian) вместо seed phrase
- Multi-chain: один Safe на каждой сети, единый UI
3. Архитектура On-Ramp / Off-Ramp
3.1 Провайдеры (внутренняя информация — не раскрывать публично)
⚠️ Провайдеры — внутренняя информация. В публичных материалах использовать только «on-ramp», «off-ramp».
| Провайдер | Регионы | Методы | Комиссия | Приоритет |
|---|
| Провайдер A | 160+ стран | Карта, Apple Pay, SEPA, PIX | 1–3.5% | Основной |
| Провайдер B | 170+ стран | Карта, Apple Pay, SEPA, банк. перевод | 1–5% | Вторичный |
| Провайдер C | EU, UK, US | Карта, Apple Pay, Open Banking | 0.5–2.9% | Третичный |
3.2 Поток On-Ramp
1. Пользователь нажимает «Пополнить» в WEB Dashboard
2. Выбирает метод: 💳 Карта / 🍎 Apple Pay / 🏦 SEPA / 📱 PIX
3. Агрегатор выбирает лучшего провайдера (цена + доступность по региону)
4. KYC проверка (если нужна):
- Tier 1: до $500/мес — без KYC (или минимальный)
- Tier 2: до $5K/мес — полный KYC (ID + selfie)
- Tier 3: $5K+ — enhanced due diligence
5. On-ramp провайдер конвертирует fiat → USDC на выбранной сети
6. USDC поступает на Safe{Wallet} пользователя
7. Auto-deposit в WellexVault (если включен)
3.3 Логика Fallback
if (provider_A.available && provider_A.fee < threshold):
use provider_A
elif (provider_B.available):
use provider_B
else:
use provider_C
Агрегация: best-rate маршрутизация между провайдерами в зависимости от региона, валюты и суммы.
4. Интеграция DEX-агрегатора
4.1 Провайдеры
| Агрегатор | API | Назначение |
|---|
| 1inch | Fusion API v2 | Основной swap router — лучшие маршруты |
| 0x | Swap API v2 | Резервный + RFQ ликвидность |
| ParaSwap | Augustus v6 | Третичный, multi-path маршрутизация |
4.2 Поток обмена (Swap)
Если пользователь вносит токен, отличный от USDC/USDT:
Пользователь вносит ETH/WBTC/DAI/и др.
→ DEX-агрегатор (1inch → 0x → ParaSwap резервный)
→ Авто-обмен в USDC
→ Депозит в WellexVault
Защита от проскальзывания: макс. 0.5% для стейблкоинов, макс. 1% для волатильных активов.
5. Архитектура кросс-чейн мостов
5.1 Провайдеры мостов
| Мост | Модель | Скорость | Безопасность |
|---|
| LayerZero | Message passing (OApp v2) | 1–10 мин | ULN + DVN валидация |
| Across | Optimistic + Relayer | 2–15 мин | UMA optimistic oracle |
5.2 Кросс-чейн поток депозитов
У пользователя USDC на Arbitrum
→ хочет внести депозит в Ethereum WellexVault
→ BridgeRouter выбирает лучший маршрут:
- LayerZero: если сумма < $50K (быстрее)
- Across: если сумма ≥ $50K (глубже ликвидность)
→ USDC поступает на Ethereum
→ Авто-депозит в WellexVault
5.3 Кросс-чейн ребалансировка ликвидности
AI Wallet Agent может перемещать ликвидность между сетями для оптимизации yield:
Если Ethereum Aave yield > Polygon Aave yield на >2%:
→ Переместить X% TVL Polygon в Ethereum через LayerZero
→ Ребалансировка ежедневно (batch, газ-оптимизация)
6. Микросервисная архитектура
6.1 Каталог сервисов
| Сервис | Язык | Framework | Ответственность | Replicas |
|---|
| auth-service | Python 3.12 | FastAPI | Регистрация, JWT, OAuth, 2FA, Safe{Wallet} | 3 |
| wvi-service | Python 3.12 | FastAPI | Расчёт WVI, история, прогноз | 5 |
| yield-service | Python 3.12 | FastAPI | Депозит, вывод, распределение доходности | 3 |
| partner-service | Python 3.12 | FastAPI | Рефералы, дерево, заработок, уровни | 3 |
| ai-service | Python 3.12 | FastAPI + TorchServe | ML inference, рекомендации | 4 (GPU) |
| notification-service | Node.js 20 | NestJS | Push (Firebase), email, in-app | 2 |
| bracelet-service | Python 3.12 | FastAPI | BLE-синхронизация, OTA прошивки, приём данных | 3 |
| blockchain-service | TypeScript | NestJS + Ethers.js v6 | Мультичейн-операции, управление vault | 3 |
| bridge-service | TypeScript | NestJS | Операции мостов LayerZero/Across | 2 |
| onramp-service | Python 3.12 | FastAPI | Агрегация провайдеров On-ramp/Off-ramp | 2 |
| content-service | Python 3.12 | FastAPI | AI-генерация контента, промоматериалы | 2 |
| admin-service | Python 3.12 | FastAPI | Управление пользователями, статистика, фрод, конфигурация | 2 |
6.2 Принцип межсервисной коммуникации
Все внутренние вызовы — gRPC с Protocol Buffers. REST/JSON — только на уровне API Gateway для внешних клиентов.
EXTERNAL CLIENTS
Mobile App · Web Dashboard · Admin Panel
│ │ │
└────────────┼────────────┘
│ REST/JSON + WebSocket (HTTPS/WSS)
▼
┌──────────────────┐
│ API Gateway │ ← единственная точка REST
│ (Kong) │
└────────┬─────────┘
│ gRPC (Protobuf)
┌───────────┼──────────────┐
▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐
│ Auth │ │ WVI │ │ Yield │ ...
│Service │◄─gRPC──►│Service │◄─gRPC──►│Service │
└────────┘ └────────┘ └────────┘
7. Слой данных
7.1 Хранилища
| Хранилище | Назначение | Масштабирование |
|---|
| PostgreSQL 16 | Пользователи, аккаунты, подписки, партнёрское дерево | Read replicas + pgBouncer |
| TimescaleDB | Биометрия, временны́е ряды WVI, история доходности | Hypertables, сжатие |
| Redis 7 | Сессии, кэш, feature store, rate limiting | Режим кластера |
| S3 | Медиа, AI-модели, бэкапы | CDN + lifecycle |
| IPFS | Метаданные NFT, страховые полисы | Pinning-сервис |
7.2 Индексация данных блокчейна
| Сеть | Индексатор | Данные |
|---|
| Все EVM-сети | The Graph (subgraphs) | Депозиты, выводы, vault shares, события доходности |
| Все EVM-сети | Custom indexer (Rust) | TVL в реальном времени, балансы пользователей, события мостов |
8. Архитектура безопасности
8.1 Безопасность смарт-контрактов
| Уровень | Механизм |
|---|
| Аудит | Trail of Bits + OpenZeppelin (перед запуском + каждый upgrade) |
| Bug Bounty | Immunefi — $250K+ макс. выплата |
| Мониторинг | Forta Agent Network (в реальном времени) |
| Multisig | Safe 3-of-5 для upgrades + timelock 48ч |
| Circuit Breaker | Авто-пауза при падении TVL >20% за 24ч |
| Лимиты скорости | Макс. 5% TVL/ч, 15%/день, 40%/неделя выводов |
8.2 Безопасность мостов
| Механизм | Описание |
|---|
| Лимиты суммы | Макс. $100K на транзакцию моста, дневной лимит на пользователя |
| Двойная валидация | LayerZero DVN + внутренняя верификация |
| Мониторинг | Мониторинг мостов в реальном времени (Forta + custom) |
| Аварийная пауза | Пауза мостов через multisig (2-of-3, мгновенно) |
8.3 Безопасность On-Ramp
| Механизм | Описание |
|---|
| KYC провайдера | On-ramp провайдер выполняет KYC |
| Обнаружение мошенничества | Провайдеры + внутренний fraud scoring |
| Лимиты транзакций | Уровневые лимиты ($500 / $5K / custom) |
| Защита от chargebacks | 7-дневный холд для платежей картой >$1K |
9. Инфраструктура и DevOps
9.1 Облачная архитектура (AWS)
| Компонент | Сервис | Регион |
|---|
| Вычисления | EKS (Kubernetes) | eu-west-1 + me-south-1 |
| База данных | RDS PostgreSQL + ElastiCache Redis | Multi-AZ |
| Хранилище | S3 + CloudFront | Глобальный CDN |
| Мониторинг | CloudWatch + Grafana + Prometheus | Центральный |
| CI/CD | GitHub Actions → ECR → EKS | Автоматизированный |
9.2 Мультирегион
| Регион | Назначение |
|---|
| eu-west-1 (Ирландия) | Основной — пользователи ЕС, соответствие MiCA |
| me-south-1 (Бахрейн) | Вторичный — MENA, пользователи Дубая |
| ap-southeast-1 (Сингапур) | Фаза 2 — расширение в ЮВА |
10. Мониторинг и наблюдаемость
| Инструмент | Назначение |
|---|
| Grafana + Prometheus | Метрики сервисов, SLA-дашборды |
| Forta | On-chain мониторинг (vault, мосты, обнаружение эксплойтов) |
| Sentry | Отслеживание ошибок (фронтенд + бэкенд) |
| PagerDuty | Алертинг + управление инцидентами |
| Tenderly | Симуляция транзакций + отладка |
| Dune Analytics | Публичные on-chain дашборды |
11. Технологический стек — сводная
| Компонент | Технология |
|---|
| Мобильное приложение (APP) | SwiftUI (iOS) + Kotlin/Jetpack Compose (Android) |
| Веб (WEB) | React 18 + TypeScript + Vite |
| Бэкенд | FastAPI (Python 3.12) + NestJS (TypeScript) |
| База данных | PostgreSQL 16 + TimescaleDB + Redis 7 |
| Блокчейн | Solidity 0.8.x, Ethers.js v6, ERC-4626, ERC-4337 |
| Смарт-кошелёк | Safe{Wallet} + Safe Protocol Kit |
| DEX-агрегатор | 1inch Fusion API + 0x Swap API + ParaSwap Augustus |
| Мосты | LayerZero OApp v2 + Across Bridge SDK |
| On-Ramp/Off-Ramp | Provider SDK (агрегатор, внутренняя деталь) |
| Keeper | Gelato Web3 Functions (auto-compound, rebalance) |
| Оракул | Chainlink (price feeds, PoR) + custom WVI Oracle |
| Аутентификация | JWT + OAuth 2.0 + EIP-4361 (SIWE) + ERC-4337 |
| KYC | Sumsub SDK |
| Push-уведомления | FCM + APNs |
| Email | SendGrid |
| CI/CD | GitHub Actions + Docker + Kubernetes (EKS) |
| Мониторинг | Grafana + Prometheus + Forta + Sentry + Tenderly |
→ Смежные документы: 06_YIELD_PROTOCOL.md (механика vault) · 22_PLATFORM_PROTECTION.md (страхование) · 25_TECH_REQUIREMENTS.md (спецификация)
Wellex © 2026 · Confidential