in3-rs

Rust bindings for the Incubed C library.

The Incubed client is a * Crypto-Economic * Non-syncronizing and stateless, but fully verifying * Minimal resource consuming

blockchain client (Crypto-Economic Client, Minimal Verification Client, Ultra Light Client).

toml [dependencies] in3 = "0.0.2"

Links: * Crate * API

Requirements

• Rust compiler version >= 1.42.0 -> rustc --version
• A toolchain capable of compiling IN3 C sources
  • Ubuntu: apt-get install build-essential
  • Windows: https://visualstudio.microsoft.com/visual-cpp-build-tools/
• OpenSSL dev libs
  • Ubuntu: apt-get install libssl-dev
  • Windows: TODO
• CMake version >= 3.5.1, because we build the bundled IN3 C library with the cmake crate
  • Ubuntu: apt-get install cmake
  • Windows: https://cmake.org/install/, Make sure you add it to path for windows
• bindgen and therefore clang dev libraries
  • Ubuntu: apt-get install clang libclang-dev llvm-dev
  • Windows: TODO

in3-rs uses the in3-sys to provide low-level bindings to the IN3 C library.

Features

• blocking- Enables the blocking API which depends on async-std.

Example

Cargo.toml

toml [dependencies] async-std = "1.5.0" in3 = "0.2.0" main.rs ```rust use std::convert::TryInto; use async_std::task;

use in3::eth1::; use in3::prelude::;

fn main() -> In3Result<()> { let mut ethapi = Api::new(Client::new(chain::MAINNET)); ethapi.client().configure(r#"{"autoUpdateList":false,"nodes":{"0x1":{"needsUpdate":false}}}}"#)?;

let latest_blk_num: u64 = task::block_on(eth_api.block_number())?.try_into()?;
println!("Latest block number is {:?}", latest_blk_num);
Ok(())

} ```

Contributing

Instructions for running the tests

1. To run the tests you need to first run the build script. ./scripts/build_rust.sh.
2. Navigate to the rust binding folder. cd rust
3. Then run the test using cargo and an additional option RUST_TEST_THREADS=1. This can be done via RUST_TEST_THREADS=1 cargo test.