defi-bindings

Contains various ethers-rs rust bindings of defi projects generated with foundry-binder.

Use the bindings

Import directly from this repo

uniswap-v3-periphery-bindings = { git = "https://github.com/mattsse/defi-bindings" }

Generate your own

You can the ./template crate as base.

which has following deps in its Cargo.toml

[dependencies]
ethers = { git = "https://github.com/gakonst/ethers-rs", features = ["abigen"] }

[build-dependencies]
foundry-binder = { git = "https://github.com/gakonst/foundry" }

In the build.rs file, you must configure which project you want to check out, build, and generate bindings for.

use foundry_binder::{Binder, RepositoryBuilder, Url};

// github repository url
const REPO_URL: &str = "<the-url-of-the-project>";

// the release tag for which to generate bindings for
const RELEASE_TAG: &str = "v3.0.0";

/// This clones the project, builds the project and generates rust bindings
fn generate() {
    let binder =
        Binder::new(RepositoryBuilder::new(Url::parse(REPO_URL).unwrap())
            // generate bindings for this release tag
            // if not set, then the default branch will be used
            .tag(RELEASE_TAG))
            // keep build artifacts in `artifacts` folder
            .keep_artifacts("artifacts");

    binder.generate().expect("Failed to generate bindings")
}

fn main() {
    // only generate if `FRESH_BINDINGS` env var is set
    if std::env::var("FRESH_BINDINGS").is_ok() {
        generate()
    }
}

To build the project, simply run cargo build which executes the build.rs. Afterwards, if everything succeeded, the bindings are written to src/contracts. The FRESH_BINDINGS ensures that these steps are not executed on each new cargo build.