Getting Started With Rust

Requirements

To use the library, you should update Rust to the latest stable version. You can update your Rust installation by running the following command:

rustup update stable

The nightly version should also be fine, but some changes might not be compatible.

no_std is not currently supported. We are working on it in Bee, and will provide it as feature once the new implementation is ready.

Using the Library

To use the iota.rs library, you will simply need to add it as dependency in your Cargo.toml:

[dependencies]
iota-client = { git = "https://github.com/iotaledger/iota.rs", branch = "production" }
# asynchronous runtime
tokio = { version = "1.12.0", features = ["full"] }

After you have added it, you can use the library in your code with use iota_client;.

Initialisation

You can use the following example to initialize the library and fetch node information.

use iota_client::Client;

#[tokio::main]
async fn main() {
    let iota = Client::builder() // Create a client instance builder
        .with_node("https://api.lb-0.h.chrysalis-devnet.iota.cafe")
        .unwrap()
        .finish()
        .await
        .unwrap();

    let info = iota.get_info().await.unwrap();
    println!("Nodeinfo: {:?}", info);
}