Nimiq Rust Client

Rust implementation of the Nimiq RPC client specs.

This repository is archived: Nimiq PoS has been launched and this RPC client only supports the old PoW RPC specification. Please refer to the nimiq-rpc-client crate implementation at the Nimiq PoS repository.

About

A Nimiq RPC client library in Rust. This client library implements the Nimiq RPC specification. The client uses the jsonrpsee library to handle JSON-RPC 2.0 requests and responses. For more information about this library see the jsonrpsee HTTP client documentation.

Usage

use nimiq_rpc::Client;

#[tokio::main]
async fn main() {
	let client = Client::new("http://seed-host.com:8648/".to_string());
	// If your node uses credentials
	let client = Client::new_with_credentials("http://seed-host.com:8648/".to_string(), "user".to_string(), "password".to_string());
	
	println!("{:?}", client.accounts().await.unwrap());
	println!("{:?}", client.block_number().await.unwrap());
	println!("{:?}", client.hashrate().await.unwrap());
	println!("{:?}", client.log("*", "log").await.unwrap());
}

Documentation

Docs.rs link to the official crate documentation. And check out the Nimiq RPC specs for details.

Installation

Add the crate to your Cargo.toml file.

Contributions

This implementation was originally contributed by Eligioo.

Please send your contributions as pull requests. Refer to the issue tracker for ideas.

License

Apache 2.0