Monorepo for the Commonware AVS reference implementation on EigenLayer. It contains:

• core: Core protocol types, validators, wire formats, and utility code
• bindings: Standalone crate for on-chain contract bindings
• router: Generic service library for running an aggregation/orchestrator service
• node: Generic service library for running a contributor/operator node
• usecases: Examples and reference AVS usecases demonstrating integration with the core, router, and node libraries
• usecases/counter: Implementation of the example "counter" AVS usecase
• config: Configuration files for local network, contract deployments, and test keys
• scripts: Helper scripts for end-to-end validation and local integration testing
• docker-compose.yml: One-command stack runner (Ethereum, EigenLayer, router, operator nodes, signer)

Counter demonstrates a simple end‑to‑end AVS flow:

• BLS quorum signing (n‑of‑m) by node operators
• Aggregation and on‑chain execution by router (increments a counter contract)
• Message validation and payload hashing via core wire + validator utilities

• Docker and Docker Compose
• Git

1. Configure environment:

cp example.env .env

For LOCAL mode (default), the example.env is pre-configured. You'll need to set a private key:

# Use Anvil's default test key for local development
echo "PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80" >> .env
echo "FUNDED_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80" >> .env

2. Start all services:

docker compose up -d

This will automatically build or pull the latest pre-built images (from ghcr.io) and start:

• Ethereum node (Anvil fork)
• EigenLayer contract deployment
• Signer service
• 3 operator nodes
• Router/orchestrator

3. Monitor services:

# View logs
docker compose logs -f router

# Check service status
docker compose ps

# Stop all services
docker compose down

# Stop and remove volumes (clean state)
docker compose down -v

This repository is dual-licensed under both the Apache 2.0 and MIT licenses. You may choose either license when employing this code.