feat(campaign): add campaign meta-scenarios with stages, reporting an…

.github/workflows/lint.yml

@@ -23,7 +23,8 @@ jobs:
         with:
           cache-on-failure: true
       - name: Install deps
-        run: sudo apt-get install -y fontconfig libfontconfig1-dev libfontconfig
+        run: |
+          sudo apt-get update && sudo apt-get install -y libsqlite3-dev fontconfig libfontconfig1-dev libfontconfig uuid-dev
       - run: cargo clippy --workspace --lib --examples --tests --benches --all-features --locked
         env:
           RUSTFLAGS: -D warnings
@@ -51,6 +52,7 @@ jobs:
         with:
           cache-on-failure: true
       - name: Install deps
-        run: sudo apt-get install -y fontconfig libfontconfig1-dev libfontconfig
+        run: |
+          sudo apt-get update && sudo apt-get install -y libsqlite3-dev fontconfig libfontconfig1-dev libfontconfig uuid-dev
       - uses: taiki-e/install-action@cargo-udeps
       - run: cargo udeps --workspace --lib --examples --tests --benches --all-features --locked

.github/workflows/test.yml

@@ -26,7 +26,7 @@ jobs:
       with:
         cache-on-failure: true
     - name: Install deps
-      run: sudo apt-get update && sudo apt-get install -y libsqlite3-dev fontconfig libfontconfig1-dev libfontconfig
+      run: sudo apt-get update && sudo apt-get install -y libsqlite3-dev fontconfig libfontconfig1-dev libfontconfig uuid-dev
     - name: Build
       run: cargo build --verbose --workspace
 
@@ -50,6 +50,6 @@ jobs:
       with:
         cache-on-failure: true
     - name: Install deps
-      run: sudo apt-get update && sudo apt-get install -y libsqlite3-dev fontconfig libfontconfig1-dev libfontconfig
+      run: sudo apt-get update && sudo apt-get install -y libsqlite3-dev fontconfig libfontconfig1-dev libfontconfig uuid-dev
     - name: Run tests
       run: cargo test --verbose --workspace

CHANGELOG.md

@@ -16,7 +16,10 @@ Features:
 - scenarios: add groth16Verify scenario to test onchain proof verification ([#379](https://github.com/flashbots/contender/pull/379))
 - spammer: support batching json-rpc eth_sendRawTransaction reqs ([#381](https://github.com/flashbots/contender/pull/381))
 - minor UX improvements ([#382](https://github.com/flashbots/contender/pull/382))
+- campaign meta-scenarios: new `contender campaign` command and campaign TOML schema for staged parallel mixes
 
 Internal changes:
 
-- revamp error handling ([#378](https://github.com/flashbots/contender/pull/378))
+- revamp error handling ([#378](https://github.com/flashbots/contender/pull/378))
+- DB schema bumped to `user_version = 6` to record campaign/stage metadata in runs.
+  - If you see a DB version mismatch, export/reset your DB: `contender db export` (optional backup) then `contender db reset` (or `drop`) to recreate with the new schema.

Cargo.toml

@@ -47,6 +47,7 @@ clap = { version = "4.5.16" }
 csv = "1.3.0"
 miette = { version = "7.6.0" }
 url = "2.5.7"
+uuid = "1.19.0"
 
 ## core
 futures = "0.3.30"

Dockerfile

@@ -3,7 +3,8 @@ FROM rust:slim AS builder
 
 # Install build dependencies
 RUN apt-get update && \
-    apt-get install -y make curl git libsqlite3-dev fontconfig libfontconfig1-dev libfontconfig libssl-dev libclang-dev
+    apt-get install -y make curl git libsqlite3-dev fontconfig libfontconfig1-dev libfontconfig libssl-dev libclang-dev uuid-dev && \
+    rm -rf /var/lib/apt/lists/*
 
 # Copy in project files
 COPY . /app

README.md

@@ -80,6 +80,7 @@ It supports both **per-second** (TPS) and **per-block** (TPB) timing, seeded fuz
 - [Engine API Spamming](docs/engine-api.md)
 - [Reports, Database, and Admin Tools](docs/reports-db-admin.md)
 - [Using Contender as a Library](docs/library-usage.md)
+- [Composite Campaigns](docs/campaigns.md)
 
 ### 5. Internals
 - [Architecture](docs/architecture.md)

campaigns/composite.toml

@@ -0,0 +1,19 @@
+name = "devnet-steady"
+description = "Steady devnet load with a mix of erc20, uni_v2 and stress"
+
+[spam]
+mode     = "tps"
+rate     = 100
+duration = 60
+
+[[spam.mix]]
+scenario  = "builtin:erc20"
+share_pct = 40.0
+
+[[spam.mix]]
+scenario  = "builtin:uni_v2"
+share_pct = 40.0
+
+[[spam.mix]]
+scenario  = "builtin:stress"
+share_pct = 20.0

campaigns/staged-example.toml

@@ -0,0 +1,41 @@
+name = "staged-example"
+description = "Warmup then steady-state blend across two stages"
+
+[spam]
+mode     = "tps"
+rate     = 150   # default rate if a stage omits one
+duration = 60   # default duration per stage (seconds)
+seed     = 1337
+
+[[spam.stage]]
+name          = "warmup"
+rate          = 100
+# duration = 60
+  [[spam.stage.mix]]
+  scenario  = "builtin:erc20"
+  share_pct = 90.0
+  [[spam.stage.mix]]
+  scenario  = "scenarios/groth16Verify.toml"
+  share_pct = 10.0
+
+[[spam.stage]]
+name          = "steady"
+rate          = 500
+duration = 120
+  [[spam.stage.mix]]
+  scenario  = "builtin:erc20"
+  share_pct = 10.0
+  [[spam.stage.mix]]
+  scenario  = "scenarios/groth16Verify.toml"
+  share_pct = 90.0
+
+[[spam.stage]]
+name          = "cooldown"
+rate          = 20
+# duration = 60
+  [[spam.stage.mix]]
+  scenario  = "builtin:erc20"
+  share_pct = 90.0
+  [[spam.stage.mix]]
+  scenario  = "scenarios/groth16Verify.toml"
+  share_pct = 10.0

crates/cli/Cargo.toml

@@ -47,6 +47,7 @@ regex = { workspace = true }
 thiserror = { workspace = true }
 miette = { workspace = true, features = ["fancy"] }
 url = { workspace = true }
+uuid = { workspace = true }
 
 [dev-dependencies]
 tempfile = "3.15.0"