Skip to main content

​
DarkPool

DarkPool is the canonical reference application on top of DeepBook Predict — Mysten Labs’ prediction-market primitive that shipped on Sui testnet six weeks before this project began. Predict solved the cold-start liquidity problem with a shared vault, oracle-driven pricing, and composable binary + range positions. But Predict’s positions are public, its oracle is price-only, and it has no native interface for AI agents. DarkPool closes those three gaps.

Event Markets on V3

Any YES/NO question becomes its own published Move package. Both legs are real Coin types — mint a pair from DUSDC, trade either leg on DeepBook V3 pools, redeem the winner for $1 at resolution.

Dark-Pool Privacy Vault

A pooled DeepBook V3 BalanceManager held by the vault gives traders position privacy via k-anonymity. Deposit DUSDC for receipt shares; the keeper mints + quotes through the vault’s BalanceManager via TradeCap.

Native AI Agents

Connect GPT, Claude, or Llama through one OpenAI-compatible client. The model researches live markets with tools, forms a thesis, and trades under runtime-owned guardrails — delegated via V3 TradeCap. Key-less, fully revocable.
Plus a Move-native Optimistic Oracle: propose / dispute / DAO-vote / settle in 30 minutes for sports, politics, geopolitics. Polymarket’s UMA window is 7 days.

​
What you get

  • 7 production Move modules deployed to Sui testnet (package 0x21c96c85…) with 17/17 unit tests passing.
  • Per-market binary scaffolder that publishes a full YES + NO + Settlement Move package per event in one command.
  • Backend stack — REST + WebSocket API, Sui event indexer, quote worker, auto-settle keeper, and self-sponsorship endpoint. All in one Docker compose.
  • React + Vite frontend with dApp Kit, Enoki zkLogin, TanStack Query, Tailwind. 10 routes covering markets, events, vault, positions, agents, profile.
  • AI agent runtime with heuristic and LLM strategies, swappable providers (Groq, Anthropic, OpenAI, Ollama), and per-agent markdown mandates.

​
How the pieces fit

                              ┌────────────────────────────────────┐
                              │   Sui testnet (DeepBook Predict)   │
                              │  predict_facade · market · agent   │
                              │  seal_policy · oo_resolution       │
                              │  settlement · dark_pool            │
                              └──┬──────────────────────────────┬──┘
                                 │ Move calls                   │ events
              signed PTBs        │                              │
       ┌─────────────────────────┴──────────┐    ┌──────────────▼────────────────┐
       │  packages/frontend (React + Vite)  │    │  packages/server               │
       │   markets, events, positions,      │    │   ├ entrypoints/api  (Fastify) │
       │   agents, profile                  │    │   ├ entrypoints/indexer        │
       │   WS subscribe to quotes:v1        │    │   ├ entrypoints/quote-worker   │
       │   REST hits /v1/*                  │    │   ├ db: drizzle + postgres     │
       └────────────────┬───────────────────┘    │   └ redis: quote cache + pubsub│
                        │ /v1/*  + /ws           └─────────▲──────────────┬───────┘
                        │                                  │              │ pubsub
                        └──────────────────────────────────┘              │
                                                          ▲               │
                                                          │ devInspect    │
                                                  ┌───────┴───────────────▼──────┐
                                                  │     Sui RPC + Pyth Hermes     │
                                                  └───────────────────────────────┘

​
Start here

Quickstart

Clone the repo, publish the Move package, and run the full local stack in under 30 minutes.

Architecture

The three augmentations on top of Predict, the component diagram, and why we picked each tradeoff.

Move Modules

Module-by-module spec for the 7 on-chain modules + the per-market binary template.

API Reference

Every REST endpoint and WebSocket channel served by @darkpool/server.

​
Track context

  • Event: Sui Overflow 2026 — DeepBook Track (single submission).
  • Build window: 6–8 weeks.
  • Status: v0.3 (DeepBook V3 pivot) — phases P0–P6 shipped. Live on testnet with vault deposits, keeper minting through TradeCap, and YES/NO order books seeded.
  • Spec: darkpool_spec.md — 2,600-line architectural rationale.
  • Living context: CLAUDE.md — week-over-week decision log.
DarkPool does not fork Predict. Every mint/redeem/supply goes through Predict’s modules unchanged. Our predict_facade emits attribution events alongside, keeping DarkPool inside the DeepBook ecosystem rather than splintering it.