> ## Documentation Index
> Fetch the complete documentation index at: https://docs.darkpool.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> The three TS packages that run off-chain: @darkpool/server, @darkpool/resolver, @darkpool/shared.

DarkPool's backend is split into three workspaces:

| Package              | Processes                        | Job                                                            |
| -------------------- | -------------------------------- | -------------------------------------------------------------- |
| `@darkpool/server`   | `api`, `indexer`, `quote-worker` | REST + WebSocket, Sui event indexing, hot-strike quote polling |
| `@darkpool/resolver` | `resolver`                       | OO settlement endpoint + auto-settle keeper                    |
| `@darkpool/shared`   | (library)                        | zod env schema, constants, byte helpers shared everywhere      |

All three run as `tsx` processes off one Docker image. See [Docker Compose](/deployment/docker).

## Service map

<Frame caption="Five services share one Postgres and one Redis. The api fronts REST + WS for the browser. The indexer streams Sui events into Postgres. The quote-worker keeps hot-strike quotes fresh. The resolver settles. The agent (optional) trades.">
  ```mermaid theme={"system"}
  flowchart LR
  Browser["Browser<br/>(React + Vite)"]

  subgraph Compose["docker compose"]
    API["api :8081<br/>Fastify"]
    IDX["indexer"]
    QW["quote-worker"]
    RES["resolver :8082"]
    AG["agent-service :8083<br/>(opt-in profile)"]
    PG[("Postgres")]
    RD[("Redis")]
  end

  Sui["Sui RPC + Pyth Hermes"]

  Browser -- "REST /v1/*" --> API
  Browser -- "WS /ws" --> API
  IDX --> PG
  IDX -- "queryEvents" --> Sui
  QW -- "devInspect" --> Sui
  QW --> RD
  RD -- "pubsub" --> API
  API --> PG
  RES -- "sign PTBs" --> Sui
  AG -- "sign PTBs" --> Sui
  AG -- "GET /status" -.-> Browser
  ```
</Frame>

## Ports

| Process                  | Port     |
| ------------------------ | -------- |
| api (REST + WS)          | `:8081`  |
| resolver                 | `:8082`  |
| agent runtime (optional) | `:8083`+ |

The agent ports start at 8083 because the resolver owns 8082.

## Data stores

* **Postgres** (5433 in dev, 5432 in compose). Indexer destination. Drizzle ORM. Migrations in `packages/server/src/db/migrations/`.
* **Redis.** Quote cache + pubsub for WS fanout, plus self-sponsorship daily caps.

Both shared services come up via `docker compose up -d redis postgres`.

## Bootstrap order

```bash theme={"system"}
# 1. Infrastructure
docker compose up -d redis postgres
pnpm --filter @darkpool/server db:migrate

# 2. One-command backend
docker compose up -d --build
# api : 8081
# indexer
# quote-worker
# resolver : 8082
```

Verify with `curl http://localhost:8081/health` and check for `[resolver] RESOLVER_KEY loaded. Signing as 0x…` in the resolver logs.

## What each process owns

* **api.** Every `/v1/*` REST route and the `/ws` WebSocket hub. Writes nothing to chain. Reads Postgres and devInspect for live quotes. Signs the sponsor leg of `POST /v1/sponsor`.
* **indexer.** Sui event poller. Persists cursors. Writes to Postgres via Drizzle. Streams: `predict::PositionMinted`, `predict::PositionRedeemed`, `predict::oracle::*`, `darkpool::oo_resolution::*`, `darkpool::agent::*`, `darkpool::dark_pool::*`, plus one `binary::<slug>` stream per registry entry.
* **quote-worker.** Hot-strike `predict::get_trade_amounts` poller (`QUOTE_POLL_MS`, default 2000). Caches in Redis. Publishes updates over pubsub for WS fanout.
* **resolver.** Two jobs in one process. HTTP settlement endpoint for OO and atomic Pyth-update PTBs. Auto-settle keeper that scans `predict::PositionMinted` events and submits per-position redeems for expired oracles.

## Tighter dev loop

Skip Docker and run the four processes in separate terminals with `tsx watch`:

```bash theme={"system"}
# Terminal A: REST + WS api
pnpm --filter @darkpool/server dev:api

# Terminal B: Sui event indexer
pnpm --filter @darkpool/server dev:indexer

# Terminal C: Redis quote poller
pnpm --filter @darkpool/server dev:quote-worker

# Terminal D: Auto-settle keeper + OO settlement endpoint
pnpm --filter @darkpool/resolver dev
```

Don't mix with the Docker services. They bind the same ports.