Wallexx — Документация

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

Разделы документации

Ключевые характеристики

ХарактеристикаЗначение
НазначениеСкоринг кошельков игроков гемблинг-платформ
Выход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, идемпотентность