Gadget: A Powerful distributed AVS Framework

Gadget SDK | CLI | Tangle Operator Docs | Tangle Developer Docs

Gadget is a comprehensive framework for building AVS services on Tangle and Eigenlayer. It provides a standardized framework for building task based systems and enables developers to clearly specify jobs, slashing reports, benchmarks, and tests for offchain and onchain service interactions. We plan to integrate with other restaking infrastructures over time, if you are a project that is interested please reach out!

Features

• Modular and extensible architecture
• Integration with Tangle and Eigenlayer
• Standardized job execution and submission mechanisms
• Protocol-specific blockchain connections, networking layers, and application logic
• Comprehensive testing framework

Getting Started

Deploying a Blueprint to Tangle is made easy with commands provided by our CLI crate cargo-tangle. Let's get started!

Installing the CLI

To install the Tangle CLI, run the following command:

cargo install --bin cargo-tangle --git https://github.com/webb-tools/gadget --force

Creating a Blueprint

To create a new blueprint/gadget using the Tangle CLI::

cargo tangle gadget create --name <blueprint_name>

Deploying a Blueprint

Finally, the blueprint can be deployed to a local Tangle node using the following command:

export SIGNER="//Alice" # Substrate Signer account
export EVM_SIGNER="0xcb6df9de1efca7a3998a8ead4e02159d5fa99c3e0d4fd6432667390bb4726854" # EVM signer account
cargo tangle gadget deploy --rpc-url <rpc_url> --package <package_name>

More information on this process can be found in the CLI documentation

Testing a blueprint (alpha)

In order to test a blueprint, you must first have a local Tangle node running. When setting up a local testnet for integration testing, we recommend running this script for testing: run-standalone-local.sh, passing --clean as an argument to reset the chain and any keys.

Then, you can run:

cargo test --package blueprint-test-utils tests_standard::test_externalities_gadget_starts -- --nocapture

Since this is an alpha feature with very near-term plans for stabilization in this PR, we recommend you use rev a01ba2bcbc37d444a044866b961d716f45d0e6f3 until the PR is merged. Additionally, each time the blueprint is run, you must cancel the testnet and restart it to ensure storage is reset. All these nuances and manual requirement of setting up a testnet will be resolved in the near future and will be testable via cargo tangle gadget test

License

Gadget is licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your discretion.

Contributing

We welcome contributions to Gadget! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Contact

If you have any questions or need further information, please contact the developers here