Magistery Bot

Production-grade prediction market bot built on Magistery protocol. Operators deploy their own instance, set their fee, and earn on every trade. Users deposit, bet, and withdraw — all through chat commands or natural language.

Repository: github.com/0xMagistery/magistery-bot

Features

• On-chain trading — Limit orders on Magistery OrderBook (Polygon, USDC settlement)
• Market discovery — Mirrors Polymarket markets automatically, operators create custom markets
• Copy trading — Follow any address, auto-mirror trades with configurable allocation
• AI assistant — Optional LLM integration for natural language trading (any OpenAI-compatible API)
• TON deposits/withdrawals — Users send USDT on TON, bot bridges to Polygon via LayerSwap
• Community resolution — Operator-created markets with proposal/dispute/poll resolution
• Automated settlement — Background keeper resolves markets, redeems winnings, returns funds
• Crash-safe — Every on-chain tx uses sign-before-persist pattern; keeper recovers from any crash point
• Operator fees — Configurable fee % on every bet, collected automatically

Quick Deploy

Railway

Docker

docker run -d --name magistery-bot \
  -e DATABASE_URL=postgresql://... \
  -e TELEGRAM_BOT_TOKEN=your-token \
  -e OPERATOR_SEED="your twelve word mnemonic" \
  -e RPC_URL=https://polygon-rpc.com \
  -e LAYERSWAP_API_KEY=your-key \
  ghcr.io/0xmagistery/magistery-bot:latest

Architecture

Modular core engine with pluggable adapters, payment rails, and market sources.

src/
  adapters/telegram/     — Grammy bot, command handlers, AI assistant
  core/
    orders/              — Place/cancel orders on OrderBook
    matcher/             — Match crossing orders, subgraph backfill
    keeper/              — 15 background jobs: resolve, settle, bridge
    fees/                — Operator fee collection and refunds
    catalog/             — Market sync from Polymarket + on-chain
    copy/                — Copy trading engine
    wallet/              — HD key derivation from operator seed
    db/                  — PostgreSQL, schema, auto-migration
  rails/ton-layerswap/   — TON deposit/withdrawal bridge
  sources/polymarket/    — Polymarket market source

New adapters (Discord, web), payment rails, and market sources can be added without touching existing code.

AI Assistant

Optional natural language trading powered by any OpenAI-compatible API.

All money-moving actions require explicit two-step confirmation. Set LLM_API_KEY and LLM_CHAT_MODE to enable.

Configuration

See the full configuration reference in the repository README.

How It Works

1. User sends /start — bot creates an HD wallet derived from operator seed
2. User deposits USDT on TON — LayerSwap bridges to Polygon, swapped to USDC
3. User browses markets, places bets via buttons or AI chat
4. Background keeper matches orders, polls for fills, resolves markets
5. After resolution: cancel stale orders, redeem winnings, swap USDC to USDT, bridge back to TON
6. /exportkey lets users extract their private key and self-custody at any time