# DarkPool

> Prediction markets on DeepBook V3. Privacy vault, AI agents, optimistic oracle.

## Docs

- [Heuristic Strategies](https://docs.darkpool.fun/agents/heuristic.md): alternate, yes-only, and no-only. Probe $50 strike rungs outward from spot.
- [LLM Strategy](https://docs.darkpool.fun/agents/llm.md): Native AI mode: research tools, structured decision, guarded execution.
- [Agent Mandates](https://docs.darkpool.fun/agents/mandates.md): Per-agent personality briefs injected into the LLM system prompt below hard rules.
- [Runtime Overview](https://docs.darkpool.fun/agents/overview.md): How the agent runtime ticks, what it requires, and how to scale to a fleet.
- [Owner Controls](https://docs.darkpool.fun/agents/owner-controls.md): Reclaim DUSDC and on-chain Pause/Resume. Owner-gated by Move.
- [Architecture](https://docs.darkpool.fun/architecture.md): How DarkPool layers on top of DeepBook Predict.
- [Indexer](https://docs.darkpool.fun/backend/indexer.md): Sui event poller to Postgres via Drizzle, with persisted cursors.
- [Overview](https://docs.darkpool.fun/backend/overview.md): The three TS packages that run off-chain: @darkpool/server, @darkpool/resolver, @darkpool/shared.
- [Quote Worker](https://docs.darkpool.fun/backend/quote-worker.md): Hot-strike predict::get_trade_amounts poller to Redis cache + pubsub.
- [Resolver](https://docs.darkpool.fun/backend/resolver.md): OO settlement endpoint + auto-settle keeper (Express on :8082).
- [REST API](https://docs.darkpool.fun/backend/rest-api.md): Every /v1/* endpoint served by @darkpool/server.
- [shared package](https://docs.darkpool.fun/backend/shared.md): @darkpool/shared. zod env schema, byte helpers, mirrored constants.
- [Self-Sponsorship](https://docs.darkpool.fun/backend/sponsor.md): Pure Sui-native sponsored-tx protocol. Our backend signs as gas owner.
- [WebSocket API](https://docs.darkpool.fun/backend/websocket.md): Realtime quotes channel for live strike prices.
- [AI Agents](https://docs.darkpool.fun/concepts/ai-agents.md): TradeCap-delegated agents with research tools and runtime-owned guardrails.
- [Binary Event Markets](https://docs.darkpool.fun/concepts/binary-event-markets.md): Per-market YES/NO Move packages trading on DeepBook V3 pools.
- [Dark-Pool Vault](https://docs.darkpool.fun/concepts/dark-pool-vault.md): Pooled DeepBook V3 BalanceManager for k-anonymous position privacy.
- [DeepBook Predict](https://docs.darkpool.fun/concepts/deepbook-predict.md): How DarkPool builds on top of the Predict primitive without forking it.
- [PredictManager & BalanceManager](https://docs.darkpool.fun/concepts/managers.md): The two account objects users hold: PredictManager for Predict, BalanceManager for V3.
- [Optimistic Oracle](https://docs.darkpool.fun/concepts/optimistic-oracle.md): Move-native propose, dispute, vote, and settle for non-price markets.
- [Docker Compose](https://docs.darkpool.fun/deployment/docker.md): One image, multiple services. Bring the whole backend up in one command.
- [Environment Variables](https://docs.darkpool.fun/deployment/environment.md): Every var in .env.example, what it does, where it lands.
- [Live Testnet IDs](https://docs.darkpool.fun/deployment/live-ids.md): Every shared object id on the v0.3 testnet deployment.
- [Republishing](https://docs.darkpool.fun/deployment/republishing.md): How to safely upgrade the Move package and re-bootstrap downstream state.
- [Components](https://docs.darkpool.fun/frontend/components.md): The shared UI kit and feature components.
- [Hooks & Libraries](https://docs.darkpool.fun/frontend/hooks.md): REST hooks, quote hooks, account hooks, realtime, motion.
- [Overview](https://docs.darkpool.fun/frontend/overview.md): React + Vite + dApp Kit + Enoki + TanStack + Tailwind. The @darkpool/frontend stack.
- [Pages](https://docs.darkpool.fun/frontend/pages.md): What each of the 10 routes does.
- [PTB Builders](https://docs.darkpool.fun/frontend/ptb-builders.md): Every Move-call builder the UI signs lives in lib/ptb.ts.
- [Create a Binary Market](https://docs.darkpool.fun/guides/create-event-market.md): Publish a full YES + NO + Settlement Move package for any binary question.
- [End-to-end Walkthrough](https://docs.darkpool.fun/guides/end-to-end.md): Run every flow once: Predict price, scaffolded event, vault, agent fleet, OO.
- [Optimistic Oracle Walkthrough](https://docs.darkpool.fun/guides/oo-flow.md): Propose, dispute (optional), finalize.
- [Running an Agent](https://docs.darkpool.fun/guides/running-agent.md): Spin up a fleet, register on chain, swap to LLM mode.
- [Settling Markets](https://docs.darkpool.fun/guides/settling.md): Atomic Pyth settle for price markets, ResolverCap settle for binary markets.
- [Vault Deposit Flow](https://docs.darkpool.fun/guides/vault-flow.md): Deposit DUSDC privately, run a keeper tick, redeem post-settlement.
- [DarkPool](https://docs.darkpool.fun/index.md): Prediction markets on DeepBook V3. Privacy vault, AI agents, and a Move-native Optimistic Oracle. Built for Sui Overflow 2026.
- [agent](https://docs.darkpool.fun/move/agent.md): TradeAgent identity + signed-PnL + AgentOwnerCap pause/resume.
- [Binary Market Template](https://docs.darkpool.fun/move/binary-market-template.md): The per-market YES + NO + Settlement Move template that scripts/create-binary-market.ts publishes.
- [dark_pool](https://docs.darkpool.fun/move/dark-pool.md): DarkPoolVault<T>. Pooled V3 BalanceManager for position privacy.
- [market](https://docs.darkpool.fun/move/market.md): MarketLink registry distinguishing price-oracle vs optimistic-oracle markets.
- [oo_resolution](https://docs.darkpool.fun/move/oo-resolution.md): Optimistic oracle: propose, dispute, vote, finalize.
- [Overview](https://docs.darkpool.fun/move/overview.md): The 7 modules in packages/move and the per-market binary template.
- [predict_facade](https://docs.darkpool.fun/move/predict-facade.md): Attribution events alongside cross-package predict::* calls.
- [seal_policy](https://docs.darkpool.fun/move/seal-policy.md): On-chain AccessPolicy objects (used as an opaque arg by dark_pool::deposit).
- [settlement](https://docs.darkpool.fun/move/settlement.md): AutoRedeemQueue + fee distribution (1% / 0.5% / 0.5%) on top of Predict's own fees.
- [Quickstart](https://docs.darkpool.fun/quickstart.md): Clone the repo, publish the Move package, and run the full local stack.
- [Decision Log](https://docs.darkpool.fun/reference/decision-log.md): Why each major architectural choice landed where it did.
- [Invariants & Conventions](https://docs.darkpool.fun/reference/invariants.md): The rules the project enforces and assumes.
- [License & Credits](https://docs.darkpool.fun/reference/license.md): Apache-2.0. Credits to the ecosystems we build on.
- [Phase Tracker](https://docs.darkpool.fun/reference/phases.md): P0-P6 build plan, all shipped.
- [Troubleshooting](https://docs.darkpool.fun/reference/troubleshooting.md): Symptoms, likely causes, fixes.
- [Agent Scripts](https://docs.darkpool.fun/scripts/agent-scripts.md): register-trade-agent.
- [Binary Market Scripts](https://docs.darkpool.fun/scripts/binary-market.md): create-binary-market, finish-create-market, resolve-binary-market.
- [Market & Seal Scripts](https://docs.darkpool.fun/scripts/market-scripts.md): register-market, create-seal-policy.
- [OO Scripts](https://docs.darkpool.fun/scripts/oo.md): oo-propose, oo-finalize.
- [Overview](https://docs.darkpool.fun/scripts/overview.md): All 19 operational scripts and their conventions.
- [parse-publish](https://docs.darkpool.fun/scripts/parse-publish.md): Detailed reference for parse-publish-output.ts.
- [Predict Scripts](https://docs.darkpool.fun/scripts/predict.md): create-predict-manager, fund-manager, supply-plp, predict-mint-smoke.
- [Utility Scripts](https://docs.darkpool.fun/scripts/utility.md): parse-publish-output, return-testnet-dusdc.
- [V3 Scripts](https://docs.darkpool.fun/scripts/v3.md): create-v3-pools, seed-v3-liquidity.
- [Vault Scripts](https://docs.darkpool.fun/scripts/vault.md): create-darkpool-vault, vault-deposit, keeper-tick.

## Optional

- [Documentation](https://mintlify.com/docs)
- [Blog](https://mintlify.com/blog)