DarkPool. Prediction Markets on DeepBook V3

This guide takes you from a fresh clone to a running local DarkPool stack in roughly 30 minutes. Move package published to testnet, backend services on Docker, and the React frontend trading against your own oracle ids.

Prerequisites

Toolchain

node --version          # >= 22.13 (pnpm@9 hard-requires this)
pnpm --version          # >= 9.0.0
sui --version           # >= 1.40 (testnet client)
docker --version        # any recent

If nvm complains about ~/.npmrc globalconfig/prefix, either pin with nvm alias default 22.13 or clean those lines out of ~/.npmrc.

Sui CLI on testnet

sui client switch --env testnet
sui client active-address

Note the address. The deploy and keeper signer.

Funded testnet DUSDC

DUSDC is the only quote asset Predict accepts. Request testnet DUSDC via the DeepBook tally form. Verify your balance:

sui client gas
sui client objects --json | jq '.[] | select(.data.type | endswith("dusdc::DUSDC"))'

Bootstrap

Clone + install

git clone https://github.com/AbhimanyuAjudiya/DarkPool.git
cd DarkPool
pnpm install
cp .env.example .env

Fill .env

At minimum:

RESOLVER_KEY. Run sui keytool export --key-identity $(sui client active-address) and paste the suiprivkey1… string. The auto-settle keeper signs with this.
SPONSOR_KEY. Same shape. Pays gas for self-sponsored user trades via /v1/sponsor. Falls back to RESOLVER_KEY when blank. Fund it with 0.5 SUI or more on testnet.
AGENT_KEY. Only required if you’re running the AI Agent fleet. Fine to reuse the resolver key for dev.
PYTH_BTC_USD_PRICE_INFO_OBJECT. See Pyth Sui docs.

Full schema: see Environment Variables.

Bring up infrastructure

docker compose up -d redis postgres
pnpm --filter @darkpool/server db:migrate

Verify both are up:

docker ps --format 'table {{.Names}}\t{{.Status}}'

Build + test Move

pnpm typecheck
pnpm --filter @darkpool/shared build
cd packages/move && sui move build && sui move test
# -> 17/17 tests pass
cd ../..

Publish DarkPool to testnet

cd packages/move
sui client publish --json --gas-budget 200000000 > /tmp/dp-publish.json
cd ../..
pnpm env:from-publish /tmp/dp-publish.json

env:from-publish writes the new DARKPOOL_PACKAGE_ID plus all shared object IDs back to .env. Verify:

grep -E "^(DARKPOOL_PACKAGE_ID|MARKET_REGISTRY_ID|AGENT_REGISTRY_ID|AUTO_REDEEM_QUEUE_ID|OO_CONFIG_ID|VOTE_LEDGER_ID)=" .env
# -> all set to 0x-prefixed 64-char addresses

Start the backend stack

One command:

docker compose up -d --build

Builds one backend image and starts:

api on :8081 (REST + WebSocket)
indexer (Sui events to Postgres)
quote-worker (Redis cache + WS pubsub)
resolver on :8082 (settlement endpoint + auto-settle keeper)
redis + postgres

Verify:

curl -s http://localhost:8081/health | jq

The agent runtime is opt-in: docker compose --profile agent up -d (status on :8083).

Run the frontend

pnpm --filter @darkpool/frontend dev
# -> http://localhost:5173

You should see the landing page with the lime CTA.

First trade

Connect a wallet

Click Connect Wallet (Suiet/Slush) or Sign in with Google (Enoki zkLogin). The address chip on the right populates.

Pick a market

Go to /markets. The crypto tab opens with the Up or Down quick cards (15 Min / Hourly / Daily). Click any card or pick a BTC oracle.

Create + fund a PredictManager

Go to /profile. If you don’t have a PredictManager yet you’ll see a Create PredictManager card. Click it, then deposit DUSDC.

Place a trade

Back on the market page, type $10 in the buy panel and click Trade. Gas is sponsored. You don’t need SUI in your address.

Watch the indexer pick it up

Within about 5s, your fill lands in /profile activity. Refresh /positions to see the row marked to live fairPerToken.

Next steps

End-to-end walkthrough

Run every flow: Predict price trade, scaffolded event market, vault deposit, agent fleet, optimistic oracle.

Scaffold an event market

Publish a full YES + NO + Settlement Move package for any binary question.

Run an AI agent

Spin up an LLM-backed agent with a markdown mandate, on its own status port.

Architecture deep-dive

The component diagram, the three augmentations on top of Predict, and the tradeoffs behind each pick.

Getting Started

Core Concepts

Move Modules

Backend

Frontend

AI Agents

Guides

Scripts Reference

Deployment

Reference

Quickstart

Prerequisites

Bootstrap

First trade

Next steps

End-to-end walkthrough

Scaffold an event market

Run an AI agent

Architecture deep-dive

​Prerequisites

​Bootstrap

​First trade

​Next steps

End-to-end walkthrough

Scaffold an event market

Run an AI agent

Architecture deep-dive

Prerequisites

Bootstrap

First trade

Next steps