Skip to content
BranchesTags

Repository files navigation

SuiPredict-AI

World Cup 2026 prediction markets on Sui — DeepBook V3 CLOB for trading, Move contracts for vault/prizes/streaks/parlays, and a fleet of 14 autonomous agents (3 of them specialized for the World Cup) that runs the exchange end-to-end. Built for Sui Overflow 2026 (DeepBook + Agentic Web tracks).

Sui Overflow 2026

MVP vertical: FIFA World Cup 2026 (June 11 – July 19, 2026, USA/Canada/Mexico). 48 teams, 12 groups, 72 group matches, all of which are scraped from Wikipedia and priced by an Elo-based market maker — zero human in the loop.

Quality status (post-UAT 2026-06-17, post-deploy 2026-06-18, post-v3-success 2026-06-19)

  • 130 / 130 Move contracts tests pass
  • 38 / 38 agents tests pass
  • 28 / 28 SDK tests pass (23 pre + 5 new for ensureMarketCreated / findExistingYesPool)
  • 14 routes (/, /markets, /markets/[id], /worldcup, /worldcup/group/[letter], /leaderboard, /portfolio, /parlay, /vault, /agents, /friends, /agent-policy, /auth, /admin) all return HTTP 200
  • All 19 UAT findings resolved (FN-01 through FN-19, see UAT-REPORT-FIXES.md)
  • R-UAT-FN-19.1 follow-up: the "Top forecasters" widget on the home page now seeds 5 demo forecasters automatically at agent-service boot (R-UAT-FN-19 fixed the empty-state, R-UAT-FN-19.1 ships the data). The seed is idempotent and never touches any real user's rows.
  • Production deploys live (post-R-WC-1.7): web on https://suipredict-web.vercel.app, agents on https://agents-production-11fd.up.railway.app, 1 on-chain WC market created, MM correctly skips stale-pool markets
  • v3 SharedTreasuryHolder live (post-R-WC-3.3, 2026-06-19): package 0xe98b0c9c…, shared holder 0x90a788b2…. world-cup-creator verified end-to-end on the 11:00 cron tick — see docs/R-WC-3.3-v3-deployment-complete.md + docs/R-WC-3.3-v3-wc-creator-success.md
  • Per-WC-match on-chain markets — the world-cup-creator mints a real on-chain PredictionMarket for every upcoming match (per-market BalanceManager + TreasuryCap<YES<DUSDC>>, shared DeepBook pool) instead of falling back to SQLite-only ghost rows
  • Wallet-funding gate — underfunded agent wallets surface as a single noop decision with a clear "fund with X SUI + Y DEEP" message instead of N stack-tracey warnings per tick
  • Offline-shell SW — public/sw.js registered on first mount; offline navigation serves /offline.html instead of a blank chrome-error://chromewebdata/ page
  • Agents-down banner — every page that talks to the agents service shows a single uniform error UI when the upstream is unreachable (no more 21-byte Internal Server Error bodies)
  • Reservation-race resilient SDK — executeTransaction rebuilds the PTB on Invalid withdraw reservation / is less than requested errors with a freshly-pinned gas coin (the Sui coin-accumulator reservation was racing sibling agents on the shared gas coin)

What it does

  1. World Cup Market Creator scrapes the Wikipedia 2026 FIFA WC articles → drops binary "Will Mexico 🇲🇽 beat South Korea 🇰🇷?" markets for every group match kickoffing in the next 7 days
  2. World Cup Market Maker quotes bid/ask using Elo ratings (FIFA Nov 2025) with a time-decaying spread (6% T-7d → 0.75% T-0m) so late bettors always have liquidity
  3. World Cup Resolver scrapes per-group Wikipedia pages at the 2-hour post-kickoff mark → calls resolve_market on-chain with 85%+ confidence
  4. Users split DBUSDC into YES + NO tokens, trade YES on the DeepBook V3 CLOB, redeem winners after resolution
  5. Friends / Social — follow Sui addresses, see what they're betting, one-tap "copy their bet", friends-only leaderboard, share to X
  6. Streak Sweeper + Prize Distributor + Leaderboard Worker run the weekly prediction game: 7/14/30/100-day streaks give 1.1×–3.0× winnings multipliers, top-N forecasters split the PrizePool
  7. Parlay Worker builds multi-leg parlays with a 5× payout cap and a risk-aware market selection
  8. Referral Keeper sweeps DeepBook trading-fee rebates to the protocol treasury
  9. Risk Monitor pauses creator/maker actions if MM exposure exceeds the configured utilization cap

Repository layout

.
├── packages/
│   ├── contracts/   Move 2024 — all on-chain modules
│   │   └── sources/
│   │       ├── agent_policy.move     agent permissions, pause/revoke
│   │       ├── badge_nft.move        tier-based achievement NFTs
│   │       ├── parlay.move           multi-leg parlay pool + claims
│   │       ├── prediction_market.move CLOB market lifecycle (1200 LoC)
│   │       ├── prize_pool.move       weekly prize distribution
│   │       ├── registry.move         market registry
│   │       ├── streak_system.move    daily streak + multipliers
│   │       ├── user_profile.move     country/forecaster-kind registry
│   │       ├── vault.move            ProtocolVault<DBUSDC> (TVL)
│   │       ├── vlp.move              VLP share token
│   │       └── types.move            shared structs / events
│   └── sdk/         TypeScript SDK (PTB builders + read helpers)
│       └── src/
│           ├── prediction-market-client.ts   CLOB market PTBs
│           ├── parlay-client.ts              parlay PTBs
│           ├── prize-client.ts               prize pool PTBs
│           ├── streak-client.ts              streak PTBs
│           ├── badge-nft-client.ts           badge PTBs
│           ├── user-profile-client.ts        profile PTBs
│           ├── vault-client.ts               vault PTBs
│           ├── deepbook/                     DeepBook V3 wrappers
│           └── protocol-reads.ts             on-chain state readers
└── apps/
    ├── agents/      Node 20 + better-sqlite3 — 14 autonomous workers + REST
    │   └── src/
    │       ├── agents/    14 workers (creator, maker, resolver, parlay, …,
    │       │              plus world-cup-creator/-resolver/-maker for WC 2026)
    │       ├── markets/   SQLite store + REST routes (incl. /wc/* endpoints)
    │       ├── gamification/  prize/streak/leaderboard state
    │       └── index.ts   HTTP server (default :3001)
    └── web/         Next.js 15 + React 19 + dApp Kit (mobile-first, installable)
        └── app/
            ├── markets/         CLOB markets list + detail
            ├── worldcup/        World Cup 2026 dashboard (groups, fixtures, live ticker)
            │   └── group/[letter]   per-group fixture list
            ├── friends/         follow Sui addresses, see their open positions
            ├── parlay/          parlay builder
            ├── vault/           VLP deposit/withdraw
            ├── portfolio/       user positions
            ├── leaderboard/     weekly top-N (with friends-only filter)
            ├── dispute/[id]/    dispute flow
            ├── admin/           admin panel
            ├── agent-policy/    on-chain agent policy (operator: budget cap, pause/revoke, profile)
            └── agents/          agent decision feed

Architecture

┌──────────────────────────────────────────────────────────────┐
│     Frontend (Next.js 15, installable, mobile-first)        │
│   /worldcup  /markets  /friends  /parlay  /leaderboard  …    │
└───────────┬───────────────────────┬───────────────────┬────────────┘
           │ gRPC + REST         │ zkLogin         │
           ▼                     ▼                 ▼
┌──────────────────────────────────────────────────────────────┐
│             Agents Service (:3001) — 14 workers              │
│  Generic: Creator │ Maker │ Resolver │ Parlay │ RiskMonitor  │
│ WC 2026:  WCCreator │ WCMaker │ WCResolver                   │
│ Gamif:    StreakSweeper │ PrizeDistributor │ PrizeAdmin      │
│            │ LeaderboardWorker │ ReferralKeeper │ PosIndexer │
│                 SQLite (markets.db, gamification.db)          │
└───────────┬───────────────────────┬───────────────────┬────────────┘
           │ gRPC (Mysten)       │ REST (Sui)     │
           ▼                     ▼                 ▼
┌──────────────────────────────────────────────────────────────┐
│                     Move Contracts (Sui)                     │
│ prediction_market  vault  vlp  parlay  prize_pool             │
│ streak_system  user_profile  badge_nft  agent_policy          │
│ DeepBook V3 (self-hosted — testnet, configured via env)      │
└──────────────────────────────────────────────────────────────┘

Agent fleet

Agent Cadence Role
market-creator 0 0 * * * LLM proposes market → on-chain create_market
market-maker */1 * * * * Generic spread quoting on DeepBook
market-resolver 58 23 * * * LLM + BTC oracle → resolve expired markets
parlay-worker */1 * * * * Build + submit multi-leg parlays within budget
risk-monitor */5 * * * * Pause creators/makers when exposure > RISK_PAUSE_UTILIZATION
referral-keeper */15 * * * * Sweep DeepBook referral rebates to treasury
streak-sweeper 2 0 * * * Mirror on-chain streak events into SQLite
prize-distributor 15 0 * * 1 Sanity-check + sign claim payloads for top-N
prize-admin 10 0 * * 1 settle_week + rotate_week on the PrizePool
leaderboard-worker 5 0 * * 1 Archive prior week's daily scores
position-indexer */1 * * * * Tail Sui events into positions / markets tables
world-cup-creator */15 * * * * Scrapes Wikipedia → mints per-match on-chain PredictionMarket (shared DeepBook pool, per-market BalanceManager + TreasuryCap<YES<DUSDC>>); wallet-funding gate pre-checks SUI + DEEP
world-cup-maker */2 * * * * Elo-based mid-price + time-decaying spread on up to 8 upcoming matches
world-cup-resolver */5 * * * * Scrapes per-group Wikipedia page → resolve_market at 85%+ confidence
auto-funder */10 * * * * R-WC-1.8: tops up the agent wallet with DUSDC via the self-hosted TreasuryCap; surfaces a NEEDS FUNDING noop when DEEP is short (no in-agent mint path for Sui system DEEP)
pool-provisioner */15 * * * * R-WC-1.8: scans active markets with no DeepBook pool, calls ensureMarketCreated, writes the new pool + on-chain ids back to SQLite. Honours the R-WC-1.2 CoinRegistry circuit-breaker (no point retrying ghost rows after the first ECurrencyAlreadyExists trip).

The three world-cup-* agents form an end-to-end autonomous loop for the World Cup vertical: they create markets, quote them, and resolve them — all without human intervention. The Elo model uses the FIFA World Ranking of November 2025 (the basis for the December 5, 2025 draw) and applies the standard logistic with a draw adjustment. See docs/worldcup-2026.md for the full architecture.

Production note (CoinRegistry limit, R-WC-1.2, resolved in v3, R-WC-3.3): Sui v1.73's coin_registry::new_currency<T> allows only ONE Currency<T> per type T per package. The v1+v2 contracts used YES<DUSDC> for all WC markets, so only one market could be on-chain at a time. v3 fixes this with a SharedTreasuryHolder<DUSDC> (created once per package via init_yes_no_currencies<DUSDC>) that lends the Currency<YES<DUSDC>>

  • Currency<NO<DUSDC>> caps to every create_market call, so the CoinRegistry init runs exactly once and every subsequent market reuses the same caps. The v3 package (0xe98b0c9c…, shared holder 0x90a788b2…) is live on testnet — see docs/R-WC-3.3-v3-deployment-complete.md for the full deploy story. The v1 CoinRegistry limit SOP remains in docs/SOP-DEPLOYMENT.md#coinregistry-limit as a historical reference.

Quick start

Prerequisites

  • Node.js 20+, pnpm 9.x, Sui CLI (sui on PATH)
  • Testnet SUI (faucet) + DBUSDC (Mysten Labs testnet dusdc package)

Install

git clone https://github.com/choguun/SuiPredict-AI.git
cd SuiPredict-AI
pnpm install
cp .env.example .env
pnpm build           # builds contracts (Move), sdk, agents, web in dep order

Demo mode (no deploy)

The agents service ships with demo markets so the indexer returns data without any on-chain state. The web /markets page renders the demo book.

pnpm dev:agents      # http://localhost:3001  — /markets, /decisions, /stats
pnpm dev:web         # http://localhost:3000  — UI

Note: as of the R-WC-1 refactor (2026-06-17), the demo mode is the only way to run the agents with no on-chain state. The world-cup-creator no longer falls back to writing a SQLite-only "demo" row when the DeepBook register_pool aborts — it now always calls ensureMarketCreated (which routes through create_market_with_pool on EPoolAlreadyExists) so every WC match gets a real on-chain PredictionMarket. The wallet-funding gate (a single SUI + DEEP check before the create loop) returns a noop decision with a clear "fund with X SUI + Y DEEP" message on underfunded wallets.

pnpm dev (and pnpm dev:web / pnpm dev:agents) run a predev hook that auto-cleans zombie next-server / tsx watch processes from ports 3000-3010 (see scripts/dev-kill-zombies.sh). Manual cleanup is available via pnpm uat:clean and the dev:clean variants.

If AGENT_POLICY_PACKAGE_ID and the shared-object IDs are blank, the workers run in dry-run mode: they log every decision to /decisions but never sign or submit a transaction. This is the recommended mode for UI development.

On-chain mode (testnet)

See docs/SOP-DEPLOYMENT.md for the full procedure (publish → bootstrap → bootstrap-parlay → verify-config → launch). The short version:

# 1. Publish the Move package (one-time, costs ~5 SUI of gas)
cd packages/contracts
sui client publish --gas-budget 500_000_000 --json \
  | jq -r '.objectChanges[] | select(.type=="published").packageId' \
    > ../../.AGENT_POLICY_PACKAGE_ID
echo "AGENT_POLICY_PACKAGE_ID=$(cat ../../.AGENT_POLICY_PACKAGE_ID)" >> ../../.env

# 2. Bootstrap the shared objects (FeeVault, PrizePool, StreakRegistry, …)
cd ../..
pnpm --filter @suipredict/agents bootstrap
pnpm --filter @suipredict/agents bootstrap-parlay

# 3. Verify everything is on-chain
pnpm --filter @suipredict/agents verify-config

# 4. Run the agents service
pnpm dev:agents

The full SOP covers mainnet preparation, gas budgeting, agent key custody, secrets handling, and rollback.

Frontend routes

Route Description
/ Home — WC banner, featured markets, vault TVL, streak + Daily WC card, agent feed
/worldcup World Cup 2026 dashboard — 12 groups, live ticker, next-match teaser, MD1 schedule
/worldcup/group/[letter] Per-group page — 4 teams, 6 group-stage matches, tap to predict
/markets CLOB market list (category, status, expiry) with WC / crypto / AI filter pills
/markets/[id] Order book, YES/NO tabs, friends' positions widget, split/merge, redeem, X share
/friends Follow Sui addresses, see their open positions, manage follow list
/parlay Multi-leg parlay builder (5× payout cap)
/vault Deposit/withdraw DBUSDC ↔ VLP
/portfolio YES/NO balances per market
/leaderboard Weekly top-N forecasters (with friends-only filter)
/dispute/[marketId] Submit dispute evidence for a market
/agent-policy On-chain agent policy: create/revoke agent wallet, set DUSDC budget, pause, profile (the old /settings route 307-redirects here)
/offline.html Static fallback served by the registered service worker when the user is offline
/admin Operator panel (FeeVault withdraw, distribution, resolution)
/agents Live decision feed for all 14 workers
/auth Enoki zkLogin OAuth callback

Mobile-first gamified touches

  • LivePulse (components/LivePulse.tsx) — animated 1.5s pulse on the home page ticker so the user always sees "something happening"
  • Celebration (components/Celebration.tsx) — 2.2s confetti animation + navigator.vibrate(40) when the streak crosses 3 / 7 / 14 / 30 / 100 days
  • FriendPositionsWidget (components/FriendPositionsWidget.tsx) — on every market detail page, see which friends have positions and one-tap "copy" their side
  • Bottom nav with ⚽ World Cup + 👥 Friends as primary tabs on mobile
  • DailyWcCard (components/DailyWcCard.tsx) on the home page — next 5 group matches with full-width 48px-tall YES/NO buttons
  • Elo-driven quotes on every WC market, so the order book always has bid/ask liquidity near the true probability
  • Settled banner on resolved market detail pages — a friendly "Market settled" panel with a checkered flag icon, winner pill, redeem/dispute CTAs, and links to the user's portfolio (replaces the previous behaviour where the trade form stayed enabled on settled markets and a single visit could crash the dev server's React Client Manifest)
  • Distinct empty states — every wallet-gated page (/portfolio, /parlay, /vault) renders a per-surface empty state with a 3-row "What you'll see here" preview list and a per-surface icon (wallet / lightning / vault) so the user knows what to expect after connecting
  • AgentsDownBanner (components/AgentsDownBanner.tsx) — shared "agents service is unreachable" banner with a clickable link to the /health endpoint, rendered on every page that talks to the agents service when the upstream fails (no more 21-byte Internal Server Error bodies on /leaderboard, /portfolio, etc.)
  • Offline shell (public/sw.js) — service worker registered on first mount; offline navigation serves /offline.html (a static page with a "Retry" button) instead of the browser's raw chrome-error://chromewebdata/ page

Agent REST API (:3001)

Endpoint Description
GET /health Liveness + last-tick timestamp per agent
GET /markets All markets from SQLite
GET /markets/:id Market metadata + DeepBook pool info
GET /markets/:id/book L2 bids/asks, spread, mid price
GET /markets/:id/orders On-chain chain_orders for the market
GET /markets/:id/trades Recent trades
GET /decisions Decision log (last N, paginated)
GET /stats Per-agent action counts + success rate
GET /parlay/user/:addr User's parlay history
GET /parlay/:id Single-parlay detail with legs
GET /leaderboard/week Live / archived weekly top-N
GET /leaderboard/country Country-filtered weekly top-N
GET /leaderboard/user/:addr Single-user weekly rank
GET /streak/:addr User's streak info
GET /prize/pool On-chain PrizePool snapshot
GET /prize/signature Sign a weekly claim payload (prize-admin only)
GET /portfolio/:addr User's open positions across all markets
GET /wc/groups 12 groups / 48 teams for World Cup 2026
GET /wc/schedule?since=&until= 72 group-stage matches with kickoff UTC + flags
GET /wc/upcoming?windowMs= Next-N markets with kickoffIn ms countdown

The full route map is in apps/agents/src/markets/routes.ts and apps/agents/src/gamification/routes.ts.

Environment variables

See .env.example for the full list. Key groups:

Group Required for Notes
SUI_NETWORK / SUI_RPC_URL / SUI_GRPC_URL everything Defaults to public Mysten endpoints
AGENT_POLICY_PACKAGE_ID on-chain mode From sui client publish
FEE_VAULT_ID, STREAK_*_ID, PRIZE_*_ID, PARLAY_POOL_ID on-chain mode Written by bootstrap / bootstrap-parlay
DUSDC_PACKAGE_ID / DUSDC_TREASURY_CAP_ID on-chain mode For self-hosted DUSDC. Defaults to Mysten Labs testnet DUSDC.
DEEPBOOK_PACKAGE_ID / DEEPBOOK_REGISTRY_ID on-chain mode Testnet defaults baked in (0xdee9 / 0xe0ce)
AGENT_PRIVATE_KEY on-chain mode Base58 ed25519 secret — server-side only
PRIZE_ADMIN_PRIVATE_KEY prize distribution Base64 ed25519; signs weekly claim payloads
MINIMAX_API_KEY LLM agents market-creator / market-resolver; blank → deterministic mock
PORT agents service Defaults to 3001
LOG_LEVEL agents service debug / info / warn / error
RISK_PAUSE_UTILIZATION risk monitor Pause threshold (0-1, default 0.80)
RESOLVER_CONFIDENCE market-resolver LLM confidence gate (0-100, default 85)
WC_MM_QUOTE_SIZE WC maker 5_000_000 = 5 YES shares per side
MAX_ACTIVE_WC_MARKETS WC creator Cap on simultaneous WC markets (default 4; reduced from 20 to fit the 2.7 SUI + 11.5 DEEP agent wallet after the R-WC-1 wallet-funding gate was added)
WC_FALLBACK_POOL_ID WC creator R-WC-1.6: pool id to use when the registry doesn't expose a YES<Q> dynamic field. Set to the literal sentinel __DISABLED__ to skip the fallback entirely and pay 500 DEEP for the first market's pool-creation fee. Railway's CLI rejects empty env values, so __DISABLED__ is the operator-friendly opt-out.
AUTO_FUNDER_MIN_DUSDC_ATOMS auto-funder R-WC-1.8: DUSDC floor below which the auto-funder mints (default 100_000_000_000 = 100 USDC)
AUTO_FUNDER_TOPUP_DUSDC_ATOMS auto-funder R-WC-1.8: DUSDC mint amount per topup (default 10_000_000_000 = 10,000 USDC)
AUTO_FUNDER_MIN_DEEP_ATOMS auto-funder R-WC-1.8: DEEP floor below which the auto-funder surfaces a NEEDS FUNDING noop (default 500_000_000 = 500 DEEP)
AGENT_CRON_AUTO_FUNDER auto-funder Override the auto-funder cron (default */10 * * * *)
AGENT_CRON_POOL_PROVISIONER pool-provisioner Override the pool-provisioner cron (default */15 * * * *)
AGENT_CRON_<NAME> all Override any agent's cron schedule (e.g. AGENT_CRON_WC_CREATOR=*/1 * * * * for faster iteration)
MARKET_CREATOR_INITIAL_MINT_ATOMS WC creator Initial YES+NO mint per new market (default 10_000_000 = 10 shares)

Development

pnpm build                # Build all packages (Move + SDK + agents + web)
pnpm dev                  # Turbo dev (web + agents, parallel); auto-cleans zombie processes
pnpm dev:web              # Frontend only
pnpm dev:agents           # Agents service only
pnpm dev:clean            # Kill zombie processes, then `pnpm dev`
pnpm dev:web:clean        # Kill zombie processes, then `pnpm dev:web`
pnpm dev:agents:clean     # Kill zombie processes, then `pnpm dev:agents`
pnpm uat:clean            # Kill zombie processes (use before any UAT pass)
pnpm contracts:build      # Move compile only (no publish)
pnpm contracts:test       # Move unit tests (130/130 pass)
pnpm --filter @suipredict/agents test       # Agent unit tests (38/38 pass)
pnpm --filter @suipredict/sdk test          # SDK unit tests (28/28 pass; tsx --test)
pnpm --filter @suipredict/agents smoke-test  # End-to-end: mint → place order

Service worker (public/sw.js)

A hand-rolled SW (replacing the legacy @ducanh2912/next-pwa wrapper that was disabled in the R48 audit) handles navigation requests only: it tries the network first, falls back to a pre-cached /offline.html on network failure. API responses are never cached (the agents service is the source of truth for live data). The SW is registered from components/providers-inner.tsx on first mount and unregisters the legacy Workbox SW + clears its caches defensively. Cache name: suipredict-shell-${SW_VERSION} (bump SW_VERSION in sw.js to evict on a deploy).

Build outputs

Package Output
contracts Move bytecode (no on-disk artifact; deploys via sui client publish)
sdk packages/sdk/dist/ (TypeScript → JS; gitignored — rebuilt by pnpm --filter @suipredict/sdk build and by the prepare: tsc hook on pnpm install); exports ensureMarketCreated, findExistingYesPool, buildCreateMarketTx, buildCreateMarketWithPoolTx, buildMintSharesTx, buildResolveMarketTx, buildRedeemTx, etc.
agents apps/agents/dist/ (run via node dist/index.js)
web apps/web/.next/ (Next.js standalone); ships public/sw.js (offline shell) + public/offline.html (static fallback)

Deployment

See docs/SOP-DEPLOYMENT.md for the full procedure — fresh install, redeploy, key rotation, rollback, and mainnet hardening. Highlights:

  • pnpm build must pass clean (0 errors) before any deploy
  • Publish via sui client publish --json and capture the package ID with jq
  • bootstrap is idempotent — re-runs are safe; use resume-bootstrap --only <step> to recover from partial runs
  • verify-config re-reads every shared-object ID on-chain and exits non-zero on any mismatch
  • Web deploys to Vercel (see apps/web/vercel.json); agents to any Node 20 host with persistent disk for the SQLite DBs
  • AGENT_PRIVATE_KEY and PRIZE_ADMIN_PRIVATE_KEY are the two secrets that grant on-chain write authority — never commit, never log, rotate via rotate-prize-pubkey.ts / rotate-prize-admin-address.ts

Production stack (post-R-WC-1.7)

The deployment script in docs/SOP-DEPLOYMENT.md walks through the canonical single-package flow, but the current production deployment uses five distinct Move package ids across the shared objects (see "Multi-package deployment reality" in AGENTS.md). The deployed services:

Component URL Stack
Web (Vercel) https://suipredict-web.vercel.app Next.js 15 + React 19, 52 production env vars mirrored from local .env (skipping the three secrets: AGENT_PRIVATE_KEY, PRIZE_ADMIN_PRIVATE_KEY, MINIMAX_API_KEY)
Agents (Railway) https://agents-production-11fd.up.railway.app Node 20 + pnpm start via Railpack (the railpack.json at repo root rebuilds SDK + agents at container start so dist/ is always fresh). 5 GB persistent volume at /data mounted as DATA_DIR so the SQLite mirror survives redeploys.
Vercel → agents wire NEXT_PUBLIC_AGENTS_URL=https://agents-production-11fd.up.railway.app on Vercel CORS locked to https://suipredict-web.vercel.app via ALLOWED_ORIGIN on Railway (apps/agents/src/http-cors.ts:90-97 hard-fails the boot in NODE_ENV=production if unset)

To redeploy after a code change:

# 1. Build locally to make sure nothing is broken
pnpm build

# 2. Push the changes to Railway (auto-deploys the latest git tree).
#    IMPORTANT: use `railway up --detach` for code changes — the plain
#    `railway redeploy` form redeploys the CACHED IMAGE of the last
#    deployment (not the latest commit). See
#    docs/R-WC-3.3-v3-deployment-complete.md#railway-snapshot-cache-gotcha.
railway up --detach -m "<short message>"

# 3. Vercel auto-deploys the web on git push. Manual redeploy:
cd apps/web && vercel --prod

Operator scripts (post-R-WC-1.6)

These four one-shot operators are the on-call toolkit. Run them from apps/agents with the standard env load order (set -a; source ../../.env; set +a):

Script Symptom it solves
npx tsx scripts/create-fresh-policy.ts RiskMonitor shows Policy spent $X / $Y with Y reached; maker starts aborting with EBudgetExceeded (code 5). The agent_policy.move module has no rotate_budget — only create_policy. Output: prints new policy id + writes to apps/agents/data/agent-policy-id.txt. Update AGENT_POLICY_ID + NEXT_PUBLIC_AGENT_POLICY_ID on Railway + Vercel.
npx tsx scripts/topup-bm-dusdc.ts MarketMaker's per-tick quote_failed pattern repeats with EBalanceManagerBalanceTooLow (code 3) at balance_manager::withdraw_with_proof. The maker's self-mint path is silently failing. Mints 10k USDC → deposit to BM directly.
npx tsx scripts/test-create-market.ts wc-creator's create_market aborts at Sui gRPC simulation time. Runs the SDK call locally and prints the uncut SimulationError (Railway logs truncate at the apostrophe in the error string, hiding the abort code + Move location).
npx tsx scripts/diag-mm-setup.ts MarketMaker's setup PTB (deposit + authorize_spend) aborts with arg_idx: 0, TypeMismatch etc. Same approach as above for the maker's path — uncut gRPC error.

R-WC-1.6 + R-WC-1.7 fixes

The production deploy relied on these two stops-gap fixes to recover from a multi-package deployment that the original AGENTS.md claim of "single canonical package" no longer matched. See AGENTS.md for the full audit-table entries and the "Multi-package deployment reality" section above for the long-term resolution plan.

Hackathon submission

Judge narrative: A multi-market prediction exchange on Sui. DeepBook V3 is the CLOB backend; 14 autonomous agents handle the full lifecycle (creation, market-making, resolution, parlays, streaks, prizes, referrals, risk). The flagship vertical is FIFA World Cup 2026 — 48 teams, 12 groups, 72 group matches, all driven by a Wikipedia-scraping fetcher, an Elo-based market maker with time-decaying spread, and a multi-source resolver. Three agents (world-cup-creator, world-cup-maker, world-cup-resolver) form the end-to-end autonomous loop with zero humans in the loop. A single Move package composes the market, vault, parlay, and prize-pool modules so a deployer can spin up the full exchange with one PTB.

License

Apache 2.0 — see LICENSE.

About

SuiPredict-AI

suipredict-web.vercel.app

Resources

Readme
Apache-2.0 license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages