ErebusDocs

Get started.

Erebus is private negotiation and settlement infrastructure for AI agents. Its MCP server lets two agents exchange encrypted offers, authorize one agreement, and settle through a shielded pool.

00

Choose a backend

Starknet
Settles through StarkWare's STRK20 privacy pool. Negotiation rides in the pool's note salts and settlement is one atomic transaction. Bounded mainnet runs, v0.3.0.
Continue below →
Monad
Settles through Erebus's own shielded pools for WMON and USDC on Monad testnet, with a proof generated locally. Published release 0.3.0.dev2026101307.
Monad quickstart →

The rest of this page sets up the Starknet backend. The concepts, privacy and limits pages describe Starknet unless they say otherwise; Monad has its own page.

01

Install on Starknet

install
uv tool install --python 3.12 \
  --extra-index-url https://poulavbhowmick03.github.io/Erebus/simple \
  erebus-mcp-server

The package includes the MCP server, Python binding, and Rust binary. Linux x86-64 and macOS arm64 have prebuilt packages. Other platforms require a source build.

Keep --python 3.12 in the install command to select a supported Python version. This avoids dependency errors from an older system interpreter. uv can download Python if needed.

For a local trial without funds or keys, create a separate mock configuration:

mock setup
erebus-init --network mock --config ~/.erebus-mock.env

Configure your MCP client to launch erebus-mcp-server with --config ~/.erebus-mock.env. Use an absolute path if your client does not expand ~.

02

Set up an identity

In Erebus, an identity is a Starknet account plus two key files, registered with the pool and holding shielded notes. Run the initializer to create or select an account:

init
erebus-init

Select an existing account, or type new to create one. The command prints the account address and the funding shortfall; send STRK to that address and confirm to continue. From there, setup deploys a new account when required, approves the allowance, waits for proving depth, shields the chosen deposit, and finishes by running doctor. If the process times out or you close it before completion, use the printed erebus-init --config ... --resume command; the selected address, keys, and operation IDs persist across the restart. For agents, --list-accounts --json, --account <id>, --new, and --resume make the choice explicit, and --yes authorizes the setup transactions without a prompt.

Registration cannot be undone. It writes your identity’s pool private key, encrypted, to the pool’s auditor on-chain, granting the auditor visibility to decrypt all transactions linked to that identity. For any mainnet canary, use a disposable identity rather than your primary account.

Two keys belong to your identity. A third belongs to the pool auditor. Their roles differ:

Starknet account key
Signs transactions. Transaction signing
Never leaves the Rust process
Pool private key
Identifies and decrypts pool records
Sent in compile_actions calldata to your prover and preflight RPC, both of which must be operator-controlled
Pool auditor key
Pool-wide, set once at registration
Receives the encrypted pool key at registration

Python never sees key material, only file paths.

03

Configure an identity

mcpServers
{
  "mcpServers": {
    "erebus-buyer": {
      "command": "erebus-mcp-server",
      "env": {
        "EREBUS_BACKEND": "seam",
        "EREBUS_NETWORK": "sepolia",
        "EREBUS_SETTLEMENT_ROLE": "payer",
        "AGENT_ADDRESS": "0x...",
        "STARKNET_RPC_URL": "https://...",
        "PROVING_SERVICE_URL": "https://...",
        "TOKEN_ADDRESS": "0x...",
        "POOL_KEY_FILE": "/home/you/.erebus-a/agent.pool.key",
        "ACCOUNT_KEY_FILE": "/home/you/.erebus-a/agent.account.key",
        "EREBUS_STATE_DIR": "/home/you/.erebus-a/state"
      }
    }
  }
}

A negotiation has two sides. Register the counterparty as a second entry with its own identity, state directory, and EREBUS_SETTLEMENT_ROLE=payee.

EREBUS_BACKEND
mock · seam
mock runs the tools in memory without a chain
EREBUS_NETWORK
sepolia · mainnet
EREBUS_SETTLEMENT_ROLE
payer · payee · both
a payee server rejects accept_and_settle
AGENT_ADDRESS
0x…
the calling account
STARKNET_RPC_URL
https://…
PROVING_SERVICE_URL
https://…
hosted prover
TOKEN_ADDRESS
0x…
the shielded token
POOL_KEY_FILE
path
the Python binding passes paths, not key values
ACCOUNT_KEY_FILE
path
EREBUS_STATE_DIR
path
locked, mode-0600 state
EREBUS_SPENDING_LIMITS
JSON, optional
per-token cap on what accept_and_settle can spend
POOL_ADDRESS
0x…, optional
overrides the default pool for the seam backend
STARKNET_CHAIN_ID
optional
overrides the default chain id for the seam backend

doctor checks whether the identity is ready to submit transactions. It inspects local key files and permissions, state directory setup, RPC endpoint connectivity, prover availability, chain ID, registration status, token allowance, and account balance. Any failed check returns a specific repair step. Run this command first whenever setup or execution errors occur.

Erebus

Private settlement and negotiation infrastructure for AI agents. Settles through StarkWare’s STRK20 pool on Starknet and Erebus’s own shielded pools on Monad. Apache-2.0.

Read

Built by

  • Poulav Bhowmick, protocol and Cairo
  • Ishita, agents and orchestration
Apache-2.0. Unaudited and experimental.Settles on Starknet (STRK20) and Monad