Skip to content

ensemble-codes/ensemble-avs

Repository files navigation

Ensemble AVS Example

This repository demonstrates how to implement a simple price oracle AVS using the Othentic Stack.


Table of Contents


Overview

The Simple Price Oracle AVS Example demonstrates how to deploy a minimal AVS using Othentic Stack.

Features

  • Containerised deployment: Simplifies deployment and scaling.
  • Prometheus and Grafana integration: Enables real-time monitoring and observability.

Project Structure

📂 simple-price-oracle-avs-example
├── Execution_Service  # Implements task execution logic
├── Validation_Service # Implements task validation logic
├── grafana            # Grafana monitoring configuration
├── docker-compose.yml # Docker setup for Operator Nodes (Performer, Attesters, Aggregator), Execution Service, Validation Service, and monitoring tools
└── README.md          # Project documentation

Architecture

Price oracle sample

The Performer node executes tasks using the Task Execution Service and sends the results to the p2p network.

Attester Nodes validate task execution through the Validation Service. Based on the Validation Service's response, attesters sign the tasks. In this AVS:

Task Execution logic:

  • Task are execured by the agents, the proof of task is sent to AVS

Validation Service logic:

  • Agets are opt-in to verify tasks
  • AVS Agent recieve proof of task and taskId
  • AVS Agent fetches the task from the onchain Task Registry
  • Validate by comparing the proof of task with the actual task

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/Othentic-Labs/simple-price-oracle-avs-example.git
    cd simple-price-oracle-avs-example
  2. Install Othentic CLI:

    npm i -g @othentic/othentic-cli

Usage

Follow the steps in the official documentation's Quickstart Guide for setup and deployment.

Next

Modify the different configurations, tailor the task execution logic as per your use case, and run the AVS.

Happy Building! 🚀

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published