This project was funded by the Balancer Grants subDAO. Read the press release on Medium.
DISCLAIMER: While balancer-rs is intended to be a useful tool to simplify interacting with Balancer V2 Smart Contracts, this package is an ALPHA-build and should be considered as such. Use at your own risk! This package is capable of sending Ethereum (or EVM compatible) tokens controlled by whatever private key you provide. User assumes all liability for using this software; contributors to this package are not liable for any undesirable results. Users are STRONGLY encouraged to experiment with this package on testnets before using it on mainnet with valuable assets.
There isn’t currently any Rust support in the Balancer ecosystem, so this SDK is a great way to attract Rust developers, as well as bring a popular, fast, and secure language to the growing collection of SDKs Balancer provides. Specifically, the Rust SDK will provide full Rust language support for interacting with:
balancer-rs has been tested on:
The balancer-rs sdk can be installed as a crate from https://crates.io/. Simply add the following to your [dependencies] in your Rust project's Cargo.toml file:
[dependencies]
balancer_sdk = "*"
Once installed, you will be able to use the Balancer Rust module as follows:
Example Vault usage (see in examples):
```rust fn main() { let rpcurl = "https://rpc.flashbots.net/"; let transport = ethcontract::web3::transports::Http::new(rpcurl).unwrap(); let web3 = ethcontract::Web3::new(transport);
let vaultinstance = balancersdk::vault::Vault::new(web3);
let wethaddress = vaultinstance.weth().call().await.unwrap(); } ```
Example to get the vault address via a pool (see in examples):
```rust use balancer_sdk::helpers::macros::*;
fn main() { let rpcurl = "https://rpc.flashbots.net/"; let transport = ethcontract::web3::transports::Http::new(rpcurl).unwrap(); let web3 = ethcontract::Web3::new(transport);
let pooladdress = addr!("0x01abc00e86c7e258823b9a055fd62ca6cf61a163"); let weightedpoolinstance = balancersdk::pools::WeightedPool::new(web3, addr!(pooladdress)); let vaultaddress = weightedpoolinstance.getVault().call().await.unwrap(); } ```
Integration tests go in ./tests
To run tests:
cargo test
Balancer continues to add new pool types that have new contract APIs. To add support for a new pool:
build.rs script like the otherscargo buildTo see examples of all Vault methods available, see the examples here.
To run an example:
cargo run --example [name]
#get_authorizer#set_authorizer#weth