LevelField

Знай, против кого ты на самом деле ставишь.

LevelField оценивает структурный риск информационной асимметрии контрактов событий на предиктивных рынках — до того, как вы сделаете ставку, только по тексту контракта, без данных о торгах и без зависимости от LLM API.

Он не предсказывает исходы, не отслеживает «умные деньги» и не выявляет аномалии постфактум. Он отвечает на один вопрос: позволяет ли структура этого события группе людей узнать ответ раньше вас — и есть ли что-то, что мешает им торговать на этом знании?

Создан для хакатона Somnia × DreamDEX Event Contracts (2026).

Оцените тремя командами (Node ≥ 20.9, без API-ключа, без кошелька):

npm install && npm test        # 70 software tests
npm run demo:agent             # an agent asks the real MCP server before acting: PROCEED at 3/100, DECLINE at 95/100
npm run validate               # 16-contract validation: category order + Spearman rho = 0.930

• ScoreRegistry в сети Somnia Shannon (проверенный исходный код): 0xb8e11dea346f2c961880879606a269db3165bbc7

• Демо-видео: demo-video/levelfield-demo.mp4 (2:55, встроенные субтитры + SRT)

• Отчёт об обратной связи по SDK (результат хакатона): docs/sdk-feedback-report.md

• В отличие от инструментов оценки риска на основе LLM, здесь никакая модель никогда не записывает число — классификация выполняется сопоставлением с якорями и проверкой дословных цитат; оценка — это детерминированный код, покрытый юнит-тестами.

Как это работает

Двухэтапный конвейер; никакая модель никогда не выдаёт число.

Этап A — классификация. Контракт сопоставляется с фиксированной, публичной библиотекой якорей по пяти измерениям:

• D1 Контроль над исходом (30%) — что определяет исход: от естественного процесса до воли одного человека

• D3 Возможность торговли для инсайдеров (25%) — могут ли те, кто узнаёт раньше, торговать на этом

• D2 Круг осведомлённых (20%) — сколько людей знает до публичного раскрытия

• D4 Синхронность раскрытия (15%) — узнают ли все об исходе одновременно

• D5 Возможность фабрикации исхода (10%) — может ли кто-то вызвать исход, чтобы выиграть ставку

Каждая классификация обязана дословно цитировать текст самого контракта (механически проверяется как подстрока), а сканер на уровне кода — независимый от суждения любой модели — обнаруживает инструкции, адресованные автоматическим оценщикам, помечает их и дисквалифицирует любую цитату-доказательство, взятую из таких предложений. Создатель рынка не может ни «уговорить» модель на низкий балл, ни выдать сам текст атаки за доказательство.

У этапа A три провайдера, ни один из которых не вызывает платный API:

Этап B — оценка (детерминированный код). Уровни → взвешенный балл 0–100 → диапазон (низкий / умеренный / повышенный / высокий), плюс два предохранителя:

• CB-1: исход определяется одним человеком, которому явно не запрещено торговать на нём → ступенчатый минимум 80/90/95 (по уровню D3 3/4/5)

• CB-2: исход может быть в одностороннем порядке сфабрикован такой стороной → ступенчатый минимум 75/85/90; также срабатывает при D2=1 с D5=5 (фабрикатору не нужна задержка раскрытия)

Два междименсионных правила применяются детерминированно в движке (а не просто запрашиваются у классификатора), и каждая корректировка отражается в оговорках результата.

Неоднозначность никогда не получает низкий балл: измерение, которое невозможно определить из текста, по умолчанию консервативно получает уровень 4 и помечается флагом.

Таксономия следует классификации создателей исходов, которую Anti-Corruption Data Collective валидировал на 435 000+ урегулированных рынках Polymarket (объём $54 млрд, 2021–2026). Прогон полного конвейера по живым тестнет-рынкам плюс курируемому набору воспроизводит этот градиент риска от начала до конца без единого вызова API: 3 (ценовые бинарные) → 19–21 (статистика, выборы) → 49 (FOMC) → 65 (увольнения) → 78 (военные) → 80–95 (воля отдельного человека, минимумы предохранителей).

Структура репозитория

packages/scoring/       two-stage pipeline: anchors, classifiers, voting, engine, DreamDEX fetcher
packages/mcp/           MCP server: assessment protocol + verification + scoring, zero LLM deps
apps/web/               Next.js UI: markets, per-market detail, methodology (reads the score cache)
data/anchors/           the anchor library (single source of truth, YAML)
data/curated/           curated contracts spanning the risk spectrum + injection test
data/classifications/   reference classifications (open protocol, quotes mechanically verified)
data/scores/            score cache written by score:all (in git for reproducible demos)
docs/design/no-api.md   architecture decision record
docs/research-dreamdex.md  verified integration reference (field mapping, gotchas, live findings)
FEEDBACK.md             SDK & docs feedback journal (hackathon deliverable, 11 evidence-backed entries)

Быстрый старт (API-ключ не нужен)

Требуется Node.js 20.9 или новее (текущий минимальный уровень для Next.js 16).

npm install
npm test                      # 70 unit/integration tests
npm run demo:agent            # agent → MCP server pre-trade check (PROCEED 3/100, DECLINE 95/100)
npm run validate              # 16-contract validation: ordering + Spearman rho (docs/validation.md)
npx tsx scripts/agreement.ts  # 3 blind runs vs reference: band agreement 16/16 (docs/agreement.md)
npm run score:all             # score live testnet markets + curated set -> data/scores/
npm run dev -w @levelfield/web    # UI at localhost:3000
rm -rf apps/web/.next && npm run build -w @levelfield/web  # production build — the rm -rf is
                               # required if a `dev` session ran in this directory first, else
                               # `next build` can report success but leave a `.next/` with no
                               # BUILD_ID, which `next start` then refuses to serve
npm run mcp                   # stdio MCP server (see packages/mcp/README.md)
npx tsx scripts/probe-dreamdex.ts          # indexer field-coverage probe
npx tsx scripts/verify-classifications.ts  # re-verify all evidence quotes
# after setting the public repo/immutable commit and republishing provenance-complete attestations:
GITHUB_REPO=OWNER/REPO GITHUB_REF="$(git rev-parse HEAD)" npm run verify:onchain

Статус

• Библиотека якорей v1 (5 измерений × 5 уровней, эталонные случаи)

• Детерминированный движок оценки + предохранители (покрыт юнит-тестами)

• Правила-классификатор для живых ценовых бинарных контрактов (только типизированные поля)

• Эталонные классификации для курируемого спектра (80 проверенных цитат)

• Пакетный скорер + кэш оценок (живые + курируемые, воспроизведён градиент ACDC)

• MCP-сервер (протокол / оценка / якоря), проверен через stdio

• Веб-интерфейс (проверяемый снимок, доказательства по рынкам, методология, локальное рабочее пространство для оценки)

• ScoreRegistry развёрнут в сети Somnia Shannon: 0xb8e11dea346f2c961880879606a269db3165bbc7 — опубликовано 28 устаревших аттестаций. Перед финальным релизом установите GITHUB_REPO=owner/repo и GITHUB_REF на неизменяемый SHA коммита, переопубликуйте текущий индекс оценок для замены устаревших URI-заглушек, затем выполните npm run verify:onchain для полного пошагового снимка чтения.

• Валидационный стенд: 16 контрактов, медианы категорий строго упорядочены, ρ Спирмена = 0,93 (docs/validation.md)

• Согласованность между прогонами: 3 независимых слепых классификатора, диапазон по мажоритарному голосованию совпадает с эталоном 16/16 (docs/agreement.md)

• Финальный отчёт об обратной связи по SDK (docs/sdk-feedback-report.md)

• Обязательное демо-видео 2–3 минуты — мастер готов (demo-video/levelfield-demo.mp4, 2:55, цепочка контроля качества в demo-video/film/README.md); загрузка на YouTube ожидается

• Необязательная презентация

Чем это не является

• Не прогноз какого-либо исхода и не инвестиционный совет.

• Не обнаружение инсайдерской активности в реальном времени: оценка отражает структурный риск типа события, а не активность на конкретном рынке прямо сейчас.

• Не обвинение какого-либо лица или аккаунта.