Aztec CCA Bid Bot

Bot for automating submissions into Aztec’s Uniswap Continuous Clearing Auction (CCA). Describe one or many bids in bids.toml, point it at any Ethereum endpoint (HTTP, WS, or IPC), and it streams blocks continuously—only submitting once the public track of the auction is live.

• Each bid is validated, aligned to the auction tick size, then submitted sequentially with automatic retries so you can stage multiple price points safely.
• When the auction finishes—or if the bot stops for any reason—it emits a human-readable log plus a cca-summary-<timestamp>.json file so you can audit which bids landed and why any failed.

Configure

• Environment variables in .env. Example here.
• Bids in bids.toml. Example here

Running the Bot

Local

cargo run --release

Docker

Local

docker build -t aztec-cca:local .

docker run --rm --name aztec-cca \
  --env-file .env \
  -v "$PWD/bids.toml:/app/bids.toml:ro" \
  aztec-cca:local

Prebuilt Image

Latest image:

docker run --rm --name aztec-cca \
  --env-file .env \
  -v "$PWD/bids.toml:/app/bids.toml:ro" \
  ghcr.io/lumoswiz/aztec-cca:latest

Specific tagged release:

docker run --rm --name aztec-cca \
  --env-file .env \
  -v "$PWD/bids.toml:/app/bids.toml:ro" \
  ghcr.io/lumoswiz/aztec-cca:v0.1.0

How it Works

1. Configuration loading – src/config.rs
   Reads environment variables, builds the provider with a signer, and turns bids.toml into structured bid specs.

2. Bid validation & planning – src/validate.rs, src/bids.rs
   Checks every bid amount, aligns prices into ticks (if not already), and buckets them into PlannedBids.

3. Auction snapshot – src/auction.rs
   Fetches the auction snapshot, tick list, and eligibility data once so all bids share the same context.

4. Execution pipeline – src/blocks.rs, src/registry.rs, src/transaction.rs
   Streams headers, feeds pending bids through prepare → simulate → send, and retries up to three times per failure.

5. Logging & summary – src/logging.rs
   Prints a final summary once every bid has succeeded/failed or the auction window closes.

Safety

This software is provided on an “as is” and “as available” basis. We make no warranties and accept no liability for losses arising from its use.