in3
cargo install in3

in3

The IN3 client (written in C).

by blockchainsllc

0.1.7 (see all)License:non-standard
cargo install in3
Readme

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).

[dependencies]
in3 = "0.0.2"

Links:

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

[dependencies]
async-std = "1.5.0"
in3 = "0.2.0"

main.rs

use std::convert::TryInto;
use async_std::task;

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

fn main() -> In3Result<()> {
    let mut eth_api = Api::new(Client::new(chain::MAINNET));
    eth_api.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.

GitHub Stars

59

LAST COMMIT

7mos ago

MAINTAINERS

1

CONTRIBUTORS

28

OPEN ISSUES

9

OPEN PRs

12
VersionTagPublished
0.1.7
2yrs ago
0.1.6
2yrs ago
0.0.2
2yrs ago
0.0.1
2yrs ago
No alternatives found
No tutorials found
Add a tutorial