Перейти к основному содержимому

25 · ТЕХНИЧЕСКИЕ ТРЕБОВАНИЯ

Версия: 5.0 Дата: 05.03.2026 Статус: Canonical Ключевые обновления v5.0:

  • AI Yield Engine: 800+ стратегий, 8 потоков, 1M+ параметрических комбинаций
  • WellexVault: единый ERC-4626, Multi-EVM 7 сетей + Tron + Solana
  • Ранги v5.0: Explorer → Builder → Achiever → Manager → Director → Leader → Ambassador → Master → Champion → Legend
  • Iron Rules: no provider names, один тариф $19/мес, no tokens
  • Card On-Ramp: провайдеры скрыты от пользователя, auto-routing за сценой

⚠️ Technical specs describe infrastructure for yield distribution. Target Yield is not a guarantee — actual yield depends on DeFi market conditions.

Содержание​

  1. Регистрация и аутентификация
  2. Авторизация и управление сессиями
  3. Кошелёк и платежи
  4. AI Yield Engine & WellexVault
  5. Стейкинг (только WEB)
  6. Сеть MLM (только WEB)
  7. Браслет и Health Data Pipeline
  8. Подписка
  9. KYC/AML
  10. Дашборд: APP vs WEB
  11. Безопасность и конфиденциальность
  12. Community (только APP)
  13. Уведомления
  14. Локализация
  15. API Architecture
  16. Webhooks & Developer API

1. Регистрация и аутентификация​

1.1 Двойная модель входа​

Платформа поддерживает два независимых пути регистрации: Email-first (основной для APP) и Web3-first (для крипто-пользователей).

Путь 1: Email-first (основной для APP)​

#Требование
1.1.1Регистрация через Email + пароль
1.1.2Social login: Apple ID (Sign in with Apple), Google (OAuth 2.0)
1.1.3При регистрации автоматически создаётся Web3-кошелёк (ERC-4337 Account Abstraction)
1.1.4Blockchain полностью скрыт от пользователя
1.1.5Web3-кошелёк используется для транзакций на WEB-платформе
1.1.6Gasless-транзакции через paymaster (Polygon)

Путь 2: Web3 Wallet-first (для крипто-пользователей)​

#Требование
1.2.1Кнопка «Подключить кошелёк» на WEB-платформе
1.2.2Интеграция WalletConnect v2: MetaMask, Trust Wallet, Coinbase Wallet и др.
1.2.3Верификация через подпись сообщения EIP-4361 (Sign-In with Ethereum)
1.2.4После подключения кошелька — обязательный ввод email для создания аккаунта
1.2.5Email используется для восстановления доступа, уведомлений и привязки к APP
1.2.6Если email уже зарегистрирован — предложение привязать кошелёк к существующему аккаунту

Единый аккаунт​

#Требование
1.3.1Оба пути регистрации ведут к единому аккаунту в системе
1.3.2Один аккаунт = один email + один или несколько Web3-кошельков
1.3.3Пользователь может использовать APP, WEB или обе платформы одновременно
1.3.4Максимум 3 внешних Web3-кошелька на аккаунт

1.2 Обязательные поля при регистрации​

#ПолеEmail-firstWeb3-first
1Email✅✅ (после подключения wallet)
2Пароль✅❌ (вход через wallet signature)
3Имя✅✅
4Фамилия✅✅
5Дата рождения✅✅
6Страна/регион✅✅
7Wallet address❌ (создаётся автоматически)✅ (из подключённого кошелька)
8Реферальный кодОпциональноОпционально
9Terms of Service✅✅
10GDPR consent✅✅

1.3 Подтверждение Email​

OTP: 6 цифр · Действителен 15 минут · Максимум 3 попытки

1.4 Двухфакторная аутентификация (2FA)​

Поддерживаемые методы: TOTP, SMS, резервные коды

1.5 Социальный вход​

#Требование
1.5.1Провайдеры: Google (OAuth 2.0), Apple ID (Sign in with Apple)
1.5.2Доступен только в APP (не в WEB)
1.5.3При первом входе — автоматическое создание аккаунта + Web3-кошелька
1.5.4Дополнительный запрос: дата рождения и страна

1.6 Ограничение запросов​

Стандартные ограничения на количество запросов для защиты от брутфорса

Критерии приёмки — Регистрация​

  • AC-1.1: Email-регистрация создаёт аккаунт + Web3-кошелёк автоматически
  • AC-1.2: Web3 Wallet подключается через WalletConnect; EIP-4361 подпись верифицирует владение
  • AC-1.3: После Web3-подключения обязателен ввод email
  • AC-1.4: Единый аккаунт работает и в APP, и в WEB
  • AC-1.5: Social login через Apple/Google в APP создаёт полный аккаунт

2. Авторизация и управление сессиями​

2.1 Способы входа​

СпособПлатформаПроцесс
Email + парольAPP + WEBСтандартная форма + 2FA
Social loginAPPApple ID / Google → автовход
Web3 walletWEBПодключение кошелька → EIP-4361 подпись → автовход

2.2 Управление сессиями​

  • JWT: Access Token — 15 минут, Refresh Token — 30 дней
  • Ротация токенов при обновлении
  • Автоматическое обнаружение компрометации сессии

2.3 Управление устройствами​

Список авторизованных устройств, отзыв сессий удалённо

2.4 Биометрический вход (APP)​

Face ID / Touch ID / Fingerprint

3. Кошелёк и платежи​

3.1 Двойная модель кошелька​

ТипСозданиеУправление
Auto-created (MPC)При Email-регистрацииСкрыт от пользователя; gasless-транзакции
External (connected)При Web3-входеПользователь управляет самостоятельно
#Требование
3.1.1Auto-created: MPC wallet (Fireblocks/Dfns), схема 2-of-3 key shares
3.1.2External: WalletConnect v2, верификация EIP-4361
3.1.3Максимум 3 external wallet на аккаунт
3.1.4Все операции gasless для auto-created (ERC-2771 + Relayer)
3.1.5External wallet: gas оплачивает пользователь (либо Wellex субсидирует)

3.2 Card On-Ramp (Multi-provider, скрытый от пользователя)​

⛔ Iron Rule 5: в UI и любых публичных материалах запрещено упоминать названия on-ramp провайдеров. Пользователь видит только: «банковская карта», «локальные методы», «on-ramp». Провайдеры — внутренняя реализация.

#Требование
3.2.1Интеграция нескольких on-ramp провайдеров через агрегатор (Primary, Secondary, Tertiary) — внутренняя конфигурация, не отображается пользователю
3.2.2Поддерживаемые методы: банковские карты (Visa/MC), Apple Pay, Google Pay, SEPA, PIX, локальные методы по региону
3.2.3Auto-routing: агрегатор выбирает провайдера по best-rate в регионе автоматически
3.2.4KYC тиры: Tier 1 ($500/мес, минимальный KYC), Tier 2 ($5K/мес, полный KYC), Tier 3 ($5K+, EDD)
3.2.5USDC зачисляется на Safe{Wallet} пользователя автоматически
3.2.6Опциональный auto-deposit в WellexVault после on-ramp
3.2.7Fallback между провайдерами — автоматический, без участия пользователя
3.2.8В UI: только «Пополнить картой» / «Локальные методы» — без брендинга провайдера

3.3 Поддержка Multi-EVM​

#Требование
3.3.1Поддерживаемые сети: ETH, Polygon, BSC, Arbitrum, Optimism, Base, Avalanche
3.3.2Кросс-чейн bridge: LayerZero (primary), Across (secondary)
3.3.3DEX swap: 1inch Fusion API (primary), 0x Swap API (fallback), ParaSwap (tertiary)
3.3.4Единый агрегированный баланс по всем сетям в UI

3.4–3.7​

Recovery Flow, история транзакций — согласно стандартной спецификации

4. AI Yield Engine и WellexVault​

SSOT: 06_YIELD_PROTOCOL.md · 07_AI_SYSTEM.md ⚠️ Target Yield (0–20%/мес) — не гарантия. Фактическая доходность зависит от условий DeFi-рынка.

4.1 WellexVault — единый vault (ERC-4626)​

#Требование
4.1.1Единый vault WellexVault (ERC-4626 + UUPS Proxy) на каждой EVM-сети
4.1.2Никаких Risk Tranches (Conservative/Balanced/Aggressive) — один vault для всех
4.1.3Lock-up по сумме: $0–999 → 0д, $1K–9999 → 30д, $10K+ → 90д
4.1.4100% страховое покрытие (единый уровень, без тиров)
4.1.5Поддерживаемые активы: USDC / USDT
4.1.6Multi-EVM: ETH, Polygon, BSC, Arbitrum, Optimism, Base, Avalanche
4.1.7Минимальный депозит: $100
4.1.8Auto-compound ($129 единовременная активация)

4.2 AI Yield Engine — 800+ стратегий​

#Требование
4.2.1AI Yield Engine обрабатывает 800+ атомарных стратегий из 8 категорий DeFi
4.2.2ML-оптимизация на 1M+ параметрических комбинациях (gradient boosting + backtesting 36 мес)
4.2.3Пересчёт оптимального портфеля каждые 15 минут
4.2.4Decision latency: < 500ms
4.2.5Источники данных: 50+ on-chain протоколов + 12 off-chain сигналов
4.2.6Встроен в каждый ERC-4337 Smart Wallet пользователя
4.2.7Аварийный вывод (emergency exit): < 60 секунд

4.3 8 категорий DeFi-источников​

#КатегорияПротоколы (примеры)Аллокация
1DeFi LendingAave v3, Compound III, Morpho Blue30%
2RWA / Real World AssetsOndo USDY, Maple Finance, Superstate25%
3Prediction Markets + StructuredPolymarket LP, Ribbon, Stryke25%
4ArbitrageFunding rate arb, CEX/DEX spread, cross-chain20%
5AMM feesUniswap v3, Curvedynamic
6Liquidity incentivesCRV/CVX incentives, LM programsdynamic
7Rate / basis arbitrageFunding/basis, cross-protocol spreadsdynamic
8Structured strategiesDelta-neutral, protected LP, covered callsdynamic

Категории 1–4 — основная аллокация (100%). Категории 5–8 — динамические надстройки в рамках тиров.

4.4 WVI-модификатор аллокации​

WVIАктивных стратегийАллокацияTarget Yield/мес
0–3914280% DeFi+RWA · 20% Arb0%
40–6934060% DeFi+RWA · 30% Arb · 10% Prediction2–5%
70–8958140% DeFi+RWA · 30% Arb · 30% Prediction8–12%
90–10030730% DeFi+RWA · 20% Arb · 50% Prediction16–20%

4.5 Архитектура смарт-контрактов​

КонтрактСтандартНазначениеДеплой
WellexVaultERC-4626 + UUPS ProxyЕдиный vaultКаждая EVM-сеть
StrategyManagerOwnable2StepУправление аллокациями, timelock 6чКаждая EVM-сеть
YieldDistributorCustomЕженедельное распределение по WVIКаждая EVM-сеть
WellnessOracleChainlink-styleWVI on-chain (месячный)Каждая EVM-сеть
InsuranceFundCustomСтраховой пулEthereum (primary)
WithdrawalQueueCustomОчередь при низкой ликвидностиКаждая EVM-сеть
BridgeRouterCustomCross-chain маршрутизацияКаждая EVM-сеть

4.6 Лимиты (Защита от bank run)​

ПериодMax вывод (% TVL)
1 час5%
24 часа15%
7 дней40%

4.7 Страховой фонд​

ПараметрЗначение
Источники10% от yield выплат + early withdrawal penalties + 5% protocol revenue + seed $500K
Целевой размер8–12% от TVL
Размещение60% Aave USDC, 30% Ondo USDY, 10% multisig
ПокрываетSmart contract exploit (100%), stablecoin depeg (80%), oracle manipulation (100%)

Критерии приёмки — AI Yield Engine​

  • AC-4.1: WellexVault (ERC-4626) задеплоен на всех 7 EVM-сетях
  • AC-4.2: AI Engine пересчитывает аллокацию каждые 15 мин, latency < 500ms
  • AC-4.3: WVI пользователя корректно определяет тир стратегий
  • AC-4.4: Emergency exit исполняется за < 60 сек
  • AC-4.5: Rate limits на вывод активны (5%/час, 15%/день, 40%/неделю)
  • AC-4.6: Insurance Fund получает 10% от yield-выплат автоматически
  • AC-4.7: Все контракты прошли внешний аудит (Trail of Bits + OpenZeppelin)

5. Стейкинг (только WEB)​

Критическое ограничение: стейкинг полностью исключён из APP. Доступен исключительно через WEB-платформу.

5.1 APP: отображение для пользователя​

#Требование
5.1.1APP отображает только Monthly Yield в процентах (для пользователей со стейкингом)
5.1.2APP отображает «—» (для пользователей без стейкинга)
5.1.3При нажатии на «—» → popup «Узнать больше» → deep link на WEB
5.1.4В APP отсутствуют: суммы в $, баланс, deposit/withdraw, калькулятор дохода

5.2 WEB: полный функционал стейкинга​

WellexVault (единый ERC-4626), Lock-up по сумме ($0–999 → 0д, $1K–9999 → 30д, $10K+ → 90д), Auto-compound ($129) — подробнее: 06_YIELD_PROTOCOL.md и секция 4 настоящего документа.

5.3 Критерии приёмки — Стейкинг​

  • AC-5.1: APP показывает только Monthly Yield % (без $ сумм)
  • AC-5.2: Кнопка «Deposit» отсутствует в APP — только в WEB
  • AC-5.3: Lock-up корректно считается по каждому депозиту отдельно
  • AC-5.4: Auto-compound активируется за $129, реинвест происходит автоматически

6. Сеть MLM (только WEB)​

Критическое ограничение: MLM-структура полностью исключена из APP. SSOT: 09_PARTNER_PROGRAM.md · 28_MLM_MARKETING_PLAN.md

6.1 Ранги v5.0 (10 рангов, каноническая цепочка)​

#РангМин. рефераловМин. PVУровней глубины
1Explorer 🧭1$1001
2Builder 🔧3$5002
3Achiever 🏅10$3,0003
4Manager 📊25$15,0004
5Director 💎50$50,0005
6Leader 🛡️100$200,0006
7Ambassador 🌐200$500,0007
8Master 👁️350$1,000,0008
9Champion 👑500$3,000,0009
10Legend 🔱1,000$10,000,00010

6.2 Требования к MLM-модулю​

#Требование
6.2.1APP не отображает MLM-дерево, партнёрские бонусы и реферальную ссылку
6.2.2Все партнёрские функции — только WEB
6.2.3WVI из APP влияет на WVI Performance Bonus в WEB (единственная точка связки)
6.2.48 потоков дохода: Прямые рефералы, Командные, Matching, Ранговый, WVI Performance, Leadership Pool, Fast Start Pool, Infinity Bonus (Champion+)
6.2.5Глубина: каждый ранг открывает следующий уровень (Explorer=1, Legend=10)
6.2.6Все выплаты on-chain в USDC, задержка < 5 минут
6.2.7Реферальный код формируется автоматически при регистрации

6.3 Критерии приёмки — MLM​

  • AC-6.1: MLM-дерево недоступно в APP (ни один элемент)
  • AC-6.2: Все 10 рангов корректно рассчитываются по PV и числу рефералов
  • AC-6.3: 8 потоков дохода начисляются по правильным формулам
  • AC-6.4: Выплаты on-chain < 5 минут после начисления
  • AC-6.5: Реферальная ссылка wellex.ai/join/{nickname} работает корректно

Остальная MLM-механика — 09_PARTNER_PROGRAM.md

7. Браслет и Health Data Pipeline​

SSOT: 08_HARDWARE.md · 03_WELLNESS_SCORE.md

#Требование
7.1Wellex Band v1: PPG (HR/HRV/SpO2), ECG, акселерометр, гироскоп, термометр, EDA
7.2Подключение через BLE 5.0+; sync каждые 15 минут
7.3Offline buffer: 48 часов без телефона
7.4OTA firmware updates
7.5Data pipeline: Sensor → BLE → APP → Wellex Oracle → On-chain WVI
7.6Anti-manipulation: ML anomaly detection, HRV fingerprint, circadian cross-validation
7.7TEE Secure Element (Wellex Band v2, Q2 2027)
7.8Калибровка: 7 дней; в период калибровки WVI = фиксированный 50, yield = 2%/мес
7.9Grace Days: 3 дня/мес (WVI = среднее за последние 7 активных дней)
7.10WVI Floor для стейкеров: минимальный WVI = 25 (не 0) при активном стейкинге

8. Подписка​

#Требование
8.1Единый тариф: $19/мес — нет других тарифов, нет годовой цены
8.2Минимальный период: 3 месяца
8.3Оплата: USDC / USDT / банковская карта / локальные методы (без брендинга провайдера)
8.4Включено: Wellex Band + WVI + Yield + AI Coach + Partner Program
8.5Биллинг рекуррентный, автоматический
8.6Grace Period при неудачном списании: 7 дней
8.7При отмене: доступ до конца оплаченного периода, браслет остаётся у пользователя
8.8Auto-compound ($129 one-time) — отдельная опция, не часть подписки

9. KYC/AML (Верификация)​

#Требование
9.1Провайдер: Sumsub SDK
9.2KYC Tier 0: Email подтверждён → лимит вывода $1,000/мес
9.3KYC Tier 1: Паспорт/ID → лимит $10,000/мес
9.4KYC Tier 2: Паспорт + Proof of Address → без лимита
9.5AML: Chainalysis KYT (primary) + Elliptic (secondary)
9.6Sanctions screening: OFAC SDN, EU, UN, HMT (daily sync)
9.7Travel Rule: Notabene для TX > $1,000
9.8Fraud Detection: Isolation Forest ML (47 фичей) + rule-based engine
9.9Fraud Score 0–100; порог блокировки ≥ 70; авто-SAR при ≥ 85

10. Дашборд: APP vs WEB​

APP — экраны​

#ЭкранСодержание
1🏠 HomeWVI (0–100), Monthly Yield %, streak, AI-рекомендация, мини-график
2📊 Metrics3 компонента WVI, графики, тренды, AI-инсайты
3👥 CommunityГруппы, челленджи, лидерборды, social feed, друзья
4🤖 AI AssistantAI Coach (видео/аудио/текст), прогнозы, отчёты
5⚙️ SettingsПрофиль, браслет, подписка, кнопка «→ WEB-версия»

В APP отсутствуют: стейкинг, кошелёк, MLM, финансы, суммы в $.

WEB — модули​

#МодульСодержание
1💰 WalletБаланс, yield, deposit/withdraw, история
2📈 StakingWellexVault (единый), Monthly Yield в $, lock-up, калькулятор
3🌐 NetworkMLM-дерево, бонусы, ранги, промоматериалы
4🤖 AI AgentsWallet Agent, Growth Agent, Analytics
5📊 AnalyticsИстория WVI + yield, прогнозы, экспорт
6🏥 WVI WidgetМини-WVI + ссылка на APP
7🛡️ AdminАдминистративная панель (только для staff)

11. Безопасность и конфиденциальность​

Шифрование, GDPR, TEE, аудиты — согласно стандартной спецификации

12. Community (только APP)​

Функционал доступен исключительно в APP.

#Требование
12.1Wellness Groups: создание, вступление, до 500 участников
12.2Team Challenges: командные соревнования по WVI
12.31v1 Duels: 7-дневные дуэли по WVI
12.4Leaderboards: Global, Regional, Friends, Group
12.5Social Feed: достижения, milestone'ы, реакции
12.6Discovery: AI-рекомендации групп по интересам и геолокации
12.7Privacy: гранулярный opt-in для каждой функции
12.8Moderation: ML spam filter + ручная модерация + кнопка «Пожаловаться»
12.9Community недоступен в WEB

Критерии приёмки — Community​

  • AC-12.1: Пользователь создаёт группу и приглашает участников
  • AC-12.2: Командный челлендж отслеживает средний WVI команды
  • AC-12.3: 1v1 дуэль длится 7 дней и определяет победителя
  • AC-12.4: Лидерборды обновляются в реальном времени
  • AC-12.5: Social feed отображает достижения друзей
  • AC-12.6: Discovery рекомендует релевантные группы

13. Уведомления​

APP Push / В приложении​

#СобытиеPushIn-app
1Обновление WVI✅✅
2Рекомендация AI✅✅
3Обновление челленджа✅✅
4Достижение друга—✅
5Напоминание о streak✅✅
6Изменение Monthly Yield (для стейкеров)✅✅
7Заряд браслета✅✅
8Оповещение безопасности✅✅

WEB Email / В приложении​

#СобытиеEmailIn-app
1Начисление стейкинг-вознаграждения—✅
2MLM-бонус—✅
3Новый реферал✅✅
4Повышение ранга✅✅
5Биллинг подписки✅✅
6Вывод средств обработан✅✅

14. Локализация & Multi-Language Support​

Поддерживаемые языки (Launch + Roadmap)​

ЯзыкКодРегионПриоритетСрок
EnglishENGlobal (default)🔴 LaunchDay 1
RussianRUCIS, MENA🔴 LaunchDay 1
SpanishESLATAM🔴 LaunchDay 1
PortuguesePTBrazil, Portugal🔴 LaunchDay 1
IndonesianIDSEA🟡 Month 2M2
ArabicARMENA🟡 Month 2M2
TurkishTRTurkey, MENA🟡 Month 3M3
VietnameseVISEA🟢 Phase 2Q3 2026
ThaiTHSEA🟢 Phase 2Q3 2026
UzbekUZCIS🟢 Phase 2Q3 2026

Архитектура локализации​

▸ i18n framework: i18next (React/WEB) + React Native i18n (APP) ▸ Строки хранятся в JSON-файлах по языкам: /locales/{lang}/translation.json ▸ Автодетект языка по IP + browser locale → fallback EN ▸ Пользователь может переключить вручную (Settings → Language) ▸ RTL поддержка: Arabic → автоматический flip layout ▸ Числа и валюта: форматируются по локали (Intl.NumberFormat) ▸ Даты: ISO 8601 на сервере → локальный формат на клиенте

Что локализуется​

▸ Весь UI (кнопки, метки, сообщения об ошибках) ▸ Push-уведомления ▸ Email-уведомления (onboarding, yield alerts, community) ▸ AI Coach рекомендации (GPT-4o с system prompt на целевом языке) ▸ Partner Academy материалы (5 языков: RU, EN, ES, PT, ID) ▸ Legal disclaimers (адаптированы к юрисдикции пользователя)

Что НЕ локализуется (остаётся EN)​

▸ Blockchain хэши и технические идентификаторы ▸ Коды ошибок (для техподдержки) ▸ Admin panel (EN only)

15. Архитектура API​

API-эндпоинты приложения​

ГруппаEndpoints
AuthPOST /auth/register · POST /auth/login · POST /auth/refresh
HealthPOST /health/sync · GET /health/metrics · GET /health/wvi · GET /health/emotions
CommunityGET /community/groups · POST /community/groups · GET /community/challenges · POST /community/duels
LeaderboardsGET /leaderboards/{type}
AIPOST /ai/chat · GET /ai/recommendations
UserGET /users/me · PATCH /users/me
NotificationsGET /notifications · PATCH /notifications/settings

API-эндпоинты веб-дашборда​

ГруппаEndpoints
AuthPOST /auth/wallet-connect · POST /auth/wallet-verify
WalletGET /wallet · GET /wallet/transactions · POST /wallet/withdraw
StakingPOST /staking/stake · POST /staking/unstake · GET /staking/positions · GET /staking/rewards
MLMGET /network/tree · GET /network/stats · GET /network/bonuses
SubscriptionPOST /subscription/create · DELETE /subscription/cancel
KYCPOST /kyc/start · GET /kyc/status

Общие эндпоинты​

ГруппаEndpoints
WVIGET /wvi/current · GET /wvi/history · GET /wvi/monthly-rate
ExportGET /export/csv?from=&to= · GET /export/pdf?from=&to= · GET /export/json

16. Вебхуки и API для разработчиков​

16.1 Webhooks — события реального времени​

Wellex отправляет webhook-уведомления на URL партнёра при ключевых событиях:

СобытиеPayloadКогда
yield.creditedamount, wvi, rate, tx_hash, timestampПри начислении yield
deposit.confirmedamount, network, tx_hash, lock_untilПосле подтверждения депозита
withdrawal.completedamount, network, tx_hash, timestampПосле вывода
partner.referredpartner_id, rank, timestampНовый партнёр в структуре
partner.rank_upgradepartner_id, old_rank, new_rankПовышение ранга партнёра
partner.inactivepartner_id, days_inactiveПартнёр неактивен >14 дней
wvi.thresholdold_wvi, new_wvi, new_rateПересечение порога WVI
bracelet.disconnecteddevice_id, last_syncБраслет не синхронизировался >24ч

16.2 Безопасность вебхуков​

▸ Подпись каждого события: X-Wellex-Signature: HMAC-SHA256(secret, payload) ▸ Retry logic: 3 попытки с exponential backoff (1m, 5m, 30m) ▸ Timeout: 10 секунд на ответ ▸ Ожидаемый ответ: HTTP 200. Иначе — retry. ▸ Webhook logs: 30 дней истории в WEB Dashboard → Settings → Webhooks

16.3 Регистрация вебхуков​

POST /webhooks
{
  "url": "https://your-app.com/wellex-hook",
  "events": ["yield.credited", "partner.rank_upgrade"],
  "secret": "your_signing_secret"
}

16.4 API разработчика — Публичные эндпоинты​

Для B2B интеграций (corporate wellness, партнёрские платформы):

EndpointМетодНазначениеAuth
/v1/wvi/{user_id}GETТекущий WVI пользователяAPI Key
/v1/yield/rate?wvi=72GETСтавка yield для WVIAPI Key
/v1/partner/tree/{partner_id}GETДерево структуры (3 уровня)API Key + OAuth
/v1/partner/stats/{partner_id}GETСтатистика партнёраAPI Key + OAuth
/v1/health/checkGETСтатус платформыPublic

16.5 Аутентификация API​

Authorization: Bearer {api_key}
X-Wellex-Version: 2026-03-01
Content-Type: application/json

API Keys создаются в WEB Dashboard → Settings → Developer → API Keys. Rate limit: 1000 req/min per API Key. Превышение → HTTP 429.

16.6 SDK​

ПлатформаПакетСтатус
JavaScript / Node.jsnpm install @wellex/sdkLaunch
Pythonpip install wellex-sdkLaunch
iOS (Swift)Swift Package ManagerLaunch
Android (Kotlin)Gradle dependencyLaunch
React Nativenpm install @wellex/react-nativeMonth 2

Документация: developers.wellex.ai (внутренняя, открывается после launch)

Приложение: Tech Stack​

СлойТехнология
Mobile (APP)SwiftUI (iOS) + Kotlin / Jetpack Compose (Android)
Web (WEB)React 18 + TypeScript + Vite
BackendFastAPI (Python 3.12)
DatabasePostgreSQL + Redis + TimescaleDB
BlockchainMulti-EVM (ETH, Polygon, BSC, Arbitrum, Optimism, Base, Avalanche), Solidity 0.8.x, ERC-4626, ERC-4337
WalletFireblocks / Dfns (MPC) + WalletConnect v2
AuthJWT + OAuth 2.0 + EIP-4361 (SIWE)
KYCSumsub SDK
PushFCM + APNs
EmailSendGrid
MonitoringGrafana + Prometheus + Sentry
CI/CDGitHub Actions + Docker + Kubernetes

© 2026 Wellex. Confidential.

v6.0 — Требования к Claim и Reinvest​

Updated to v6.0 per Alexander directives 12.03.2026

Claim (MVP — обязательно)​

  • Claim доступен с Day 1 начисления доходности
  • 2 бесплатных claim/месяц, с 3-го — комиссия 10%
  • API: POST /api/v1/yield/claim → { amount, fee_applied, net_amount }
  • Счётчик claim: GET /api/v1/yield/claim-count → { month, used, free_remaining }

Реинвест​

  • Min $100, max 1x/month
  • API: POST /api/v1/yield/reinvest → { amount, status, next_available_date }
  • Qualifying action: triggers bonus calculation

Льготный период​

  • 14 дней после подключения браслета: floor 4%/month
  • API: GET /api/v1/yield/grace-status → { active, days_remaining, floor_rate }