Wallexx — платформа скоринга криптокошельков
Внутренняя инженерная документация платформы on-chain скоринга кошельков для гемблинг-платформ.
Wallexx
Wallexx — B2B-платформа on-chain скоринга криптокошельков для гемблинг-платформ. На вход — адрес кошелька игрока, на выход — Player Score (0–100) с детализацией факторов риска и поведенческих сигналов.
Платформа анализирует полную историю транзакций адреса в четырёх сетях (Ethereum, BNB Chain, TRON, Bitcoin), строит граф взаимодействий контрагентов и вычисляет скоринг по детерминированной scorecard-модели v1. Результат доставляется через единый REST API с механикой кредитов (hold/settle/refund) и идемпотентностью.
Архитектура платформы
flowchart LR
subgraph Клиент
OP[Оператор гемблинга]
end
subgraph Внешние источники
ETH[Ethereum node]
BNB[BNB Chain node]
TRX[TronGrid API]
BTC[BTC indexer]
LL[LedgerLens]
end
subgraph Wallexx
API[HTTP API :8090<br/>POST /api/v1/score]
ENGINE[Движок скоринга<br/>оркестрация прогонов]
QUEUE[Очереди задач<br/>ретраи + DLQ]
COLLECT[Collector<br/>сбор транзакций]
FEAT[Feature extractor<br/>135 признаков]
GRAPH[Графовый анализ<br/>PageRank · HITS · кластеры]
SCORE[Scorecard v1<br/>Player Score 0–100]
DB[(БД платформы<br/>ретраи, DLQ, аудит)]
LLW[LedgerLens worker<br/>снапшоты адресов]
end
OP -->|submitRun| API --> ENGINE
ENGINE --> QUEUE --> COLLECT
COLLECT --> ETH & BNB & TRX & BTC
COLLECT --> FEAT --> GRAPH --> SCORE
ENGINE --> LLW --> LL
ENGINE --> DB
SCORE --> DB
API -. read-only .-> DB
SCORE -->|Player Score| OPРазделы документации
Методология скоринга
Требования F1–F6, конвейер обработки, 135 признаков, графовые алгоритмы, scorecard-модель v1 и биллинг.
Развёртывание
Production-деплой на systemd, Docker, процедуры upgrade и anti-spoof контролы.
Ранбук
Диагностика инцидентов, ретраи, DLQ, backfill и переинжест адресов.
API
Публичный контракт submitRun, тарификация по сетям, коды ошибок и идемпотентность.
Проверка готовности
Снапшот верификации: готовые компоненты и известные ограничения.
Ключевые характеристики
| Характеристика | Значение |
|---|---|
| Назначение | Скоринг кошельков игроков гемблинг-платформ |
| Выход | Player Score 0–100 + детализация факторов |
| Сети | Ethereum, BNB Chain, TRON, Bitcoin |
| Модель | Scorecard v1 — детерминированные правила, без ML |
| Данные | История транзакций адреса, граф контрагентов (2 hop) |
| SLA прогона | p50 < 5 c, p95 < 30 c |
| Интеграция | REST API, кредиты hold/settle/refund, идемпотентность |