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