README.md

eigensdk-rs

eigensdk-rs is an initiative for rust developers to build AVSs on eigenlayer.

Installation

cargo install eigensdk --features full

Overview

List of crates in the repository :-

• eigen-client-avsregistry - Read, Write and subscribe methods for AvsRegistry
• eigen-client-elcontracts - Convenience methods to call Eigenlayer contracts
• eigen-contracts-bindings - Generate ethers bindings for Eigen Layer.
• eigen-crypto-bls - New bls key pair, sign message, conversion utilites between alloy and arkworks bn254.
• eigen-crypto-bn254 - verify message on G2, map to curve.
• eigen-metrics - performance, rpc and economic metrics
• eigen-services - Spawn tokio services for operators info, bls aggregation
• eigen-types - Common types
• eigen-utils - Publicly exportable m2-mainnet compatible alloy bindings.
• eigen-testing-utils - Contains publicly exportable anvil, holesky, mainnet addresses for eigen contracts.
• eigen-chainio-txmanager - Simple transaction manager.
• eigen-cli - ECDSA, BLS keystore cli
• eigen-nodeapi - NodeApi implementation for EigenLayer.
• eigen-logging - Logging utilities

Examples

You can run any example using the command cargo run --example <example-name>

Example :

cargo run --example get_quorum_count

Contributor Guidelines

We are actively looking for contributors. Thank you for your interest. We have strict ci checks in place. In case of any questions and support, feel free to raise an issue.

PR

To test locally :-

You need foundryto successfully to run it.

cargo test

At least 1 approving review is required to merge the PR.

lint

make lint

To run fireblocks tests

Add the following variables to your env

• FIREBLOCKS_API_KEY
• FIREBLOCKS_PRIVATE_KEY_PATH
• FIREBLOCKS_API_URL

and then run the following command

make fireblocks-tests

Test Coverage

Test coverage should aim to be around 80%.

Here's how to generate test coverage reports:

Install llvm tools:

make deps

Run the tests with coverage instrumentations:

make coverage

Open the coverage html report in a web browser:

open target/llvm-cov/html/index.html

Supported Rust Version

Rolling MSRV policy of 6 months. The current MSRV is 1.79

Disclaimer

🚧 Eigensdk-rs is under active development and has not been audited. Eigensdk-rs is rapidly being upgraded, features may be added, removed or otherwise improved or modified and interfaces will have breaking changes. Eigensdk-rs should be used only for testing purposes and not in production. Eigensdk-rs is provided "as is" and Eigen Labs, Inc. does not guarantee its functionality or provide support for its use in production. 🚧

Credits

• eigensdk-go

Security Bugs

Please report security vulnerabilities to [email protected]. Do NOT report security bugs via Github Issues.

Support

Join our telegram channel .