Crusaderbot Blueprint — WalkerMind OS

● WALKERMIND OS · CRUSADERBOT · SYNCING...

Syncing blueprint from source truth...

⚠ Blueprint source file not found at docs/blueprint/crusaderbot.md — showing static architecture summary. Create the file to enable live rendering.

System Overview

// PROJECT

CrusaderBot

Autonomous prediction market trading on Polymarket

// STATUS

R1–R11 ✓

All foundation lanes merged. SENTINEL PASS 84/100.

// PLATFORM

Polymarket

CLOB, Polygon, USDC, EIP-712 auth

// NEXT LANE

R12a

CI/CD Pipeline — GitHub Actions

Architecture

// STACK

Runtime

Python 3.11, FastAPI, async

Database

PostgreSQL + Redis (cache + job queue)

python-telegram-bot — notification + command surface

Chain

Polygon — USDC, EIP-712, Alchemy WebSocket

Deploy target

Fly.io (R12 final)

CI/CD

GitHub Actions (R12a — next priority)

// RISK CONSTANTS (frozen)

KELLY_FRACTION

0.25

MAX_POSITION_PCT

0.10 (max 10% per position)

MAX_CONCURRENT

5 trades

DAILY_LOSS_LIMIT

-$2,000 USD

MAX_DRAWDOWN

MIN_LIQUIDITY

$10,000 USD

MIN_ARB_EDGE

2% net edge required

// SENTINEL FINDINGS (resolved)

C1 — Idempotency

✓ RESOLVED — Idempotency-Key header added to order placement (execution/order.py)

C2 — Risk constants

✓ RESOLVED — Constants frozen, no live mutation path

C3 — Deposit handler

✓ RESOLVED — Async concurrency hardened, replay protection added

// AGENT GOVERNANCE

Branch format

WARP/{FEATURE} — uppercase, hyphen-separated

Validation tiers

MINOR / STANDARD / MAJOR — MAJOR requires SENTINEL

SENTINEL gate

Required for order placement, execution logic, risk engine changes

State files

PROJECT_STATE.md · ROADMAP.md · WORKTODO.md · CHANGELOG.md

To enable live blueprint rendering, create docs/blueprint/crusaderbot.md in the repo. This page will auto-render it as formatted prose. Open repo →