Overview#

The Ava Protocol AVS (Actively Validated Service) can be compiled directly using Go version 1.22+. Ensure you have the appropriate version of Go installed in your development environment.

How It Works#

User Wallet#

For each owner, an ERC6900 wallet is deployed to schedule tasks and approve spending. Each task type has its corresponding modular code to represent its condition and actual execution.

Aggregator#

The aggregator accepts RPC requests from clients to submit task payloads. Currently, the Ava Protocol team manages and runs the aggregator. Periodically, the aggregator combines task submissions, updates internal storage, and writes a zkSNARK proof back to our TaskManager contract.

The aggregator also accepts task condition check results from the operator, performs quorum and consensus checks, and flags tasks as ready to run.

Aggregator Address#

The Ava Protocol team currently manages the aggregator. Depending on whether you are on the testnet or mainnet, point your operator to the appropriate address in the operator configuration file.

Holesky Testnet#

• AVS node: aggregator-holesky.avaprotocol.org:2206
• API Explorer: https://api-explorer-holesky.avaprotocol.org/

Mainnet#

• AVS node: aggregator.avaprotocol.org:2206
• API Explorer: https://api-explorer.avaprotocol.org/

Operators#

Operators communicate with aggregators via RPC. They request task data from the aggregator, execute condition checks, and send results back to the aggregator. For tasks deemed ready to run, operators execute them. Detailed information on task execution through our ERC6900 modular wallet will be available soon.

Setting Up#

Check Go Version#

Verify the installed Go version:

go version

Compile Ava Protocol AVS#

Compile the AVS using the following command:

go build -o ap-avs

You can then run the ap-avs binary. We strive to use pure Go, allowing cross-compilation for any architecture supported by the Go compiler.

Running the Operator#

Refer to the operator documentation for detailed instructions.

Running the Aggregator#

To run the aggregator, use the following command:

ap-avs aggregator

Note: The Ava Protocol team currently manages the aggregator, and the IP address for communication between the operator and the aggregator is hardcoded in the operator.

Telemetry Dashboard#

Operators connected to the Ava Protocol aggregator can monitor their operations on the telemetry dashboard.

Testnet#

https://aggregator-holesky.avaprotocol.org/telemetry

Mainnet#

https://aggregator.avaprotocol.org/telemetry

Development Guide#

Refer to the development documentation.

Dependencies#

EigenLayer CLI#

Install the EigenLayer CLI with the following command:

curl -sSfL https://raw.githubusercontent.com/layr-labs/eigenlayer-cli/master/scripts/install.sh | sh -s

Golang#

Install Go with the following command:

brew install go

Foundry Toolchain#

Install the Foundry toolchain with the following commands:

curl -L https://foundry.paradigm.xyz | bash
foundryup

Protobuf Compiler#

Install the Protobuf compiler with the following command:

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest

Contract address

Holesky Testnet#

Ethereum Mainnet#