DarkPool. Prediction Markets on DeepBook V3

`create-darkpool-vault`

One PTB: balance_manager::new to mint_trade_cap to dark_pool::create_vault<DUSDC> wired to a scaffolded binary market from registry.json. Shares the vault + BalanceManager; keeps TradeCap + VaultAdminCap with the keeper (sender).

pnpm tsx scripts/create-darkpool-vault.ts \
  --market wc26_euro_champion \
  --min-deposit 1000000 \
  --execute

Flags

Flag	Required	Description
`--market`	yes	Slug from `.binary-markets/registry.json`
`--min-deposit`	yes	Minimum deposit in micro DUSDC (1_000_000 = $1)
`--label`	no	Override the vault label (defaults to market label)
`--execute`	no	Sign + submit

Prints VAULT_OBJECT_ID. Paste into .env.

`vault-deposit`

Deposits DUSDC into a DarkPoolVault with the exact PTB shape the frontend uses (split to dark_pool::deposit to receipt to sender). Smoke test + demo TVL seeder.

pnpm tsx scripts/vault-deposit.ts --amount 2 --execute

Flags

Flag	Required	Description
`--amount`	yes	Whole DUSDC amount
`--vault`	no	Override `VAULT_OBJECT_ID`
`--execute`	no	Sign + submit

Passes attribution_hash as 32 zero bytes (Seal off). Frontend does the same.

`keeper-tick`

One vault keeper tick. Idempotent.

pnpm tsx scripts/keeper-tick.ts --execute                 # all idle balance
pnpm tsx scripts/keeper-tick.ts --amount 5 --ask 0.55 --execute

Market open path (state == OPEN):

dark_pool::pull_for_mint
  -> settlement::mint_pair
  -> balance_manager::deposit (YES + NO)
  -> dark_pool::record_mint
-> [optional] pool::place_limit_order POST_ONLY (YES + NO asks) via TradeCap

V3 ask leg is auto-gated on yesPoolId / noPoolId existing in the registry. Quotes roundLot(held × 100/105) to leave 5% input-token fee headroom. Market resolved path (after mark_resolved):

cancel V3 orders
  -> balance_manager::withdraw_all (YES + NO + idle DUSDC)
  -> settlement::redeem_{yes,no}
  -> dark_pool::receive_settlement
-> state -> SETTLED

Flags

Flag	Required	Description
`--amount`	no	Override pull amount (default: all idle balance)
`--ask`	no	Override ask price for V3 asks (default: 0.55)
`--execute`	no	Sign + submit

Getting Started

Core Concepts

Move Modules

Backend

Frontend

AI Agents

Guides

Scripts Reference

Deployment

Reference

Vault Scripts

`create-darkpool-vault`

`vault-deposit`

`keeper-tick`

​create-darkpool-vault

​vault-deposit

​keeper-tick

`create-darkpool-vault`

`vault-deposit`

`keeper-tick`