rust-web3

Ethereum JSON-RPC multi-transport client.
Rust implementation of Web3.js library.

Documentation

Usage

First, add this to your Cargo.toml:

[dependencies]
web3 = { git = "https://github.com/tomusdrw/rust-web3" }

Example

#[tokio::main]
async fn main() -> web3::Result<()> {
    let transport = web3::transports::Http::new("http://localhost:8545")?;
    let web3 = web3::Web3::new(transport);

    println!("Calling accounts.");
    let mut accounts = web3.eth().accounts().await?;
    println!("Accounts: {:?}", accounts);
    accounts.push("00a329c0648769a73afac7f9381e08fb43dbea72".parse().unwrap());

    println!("Calling balance.");
    for account in accounts {
        let balance = web3.eth().balance(account, None).await?;
        println!("Balance of {:?}: {}", account, balance);
    }

    Ok(())
}

If you want to deploy smart contracts you have written you can do something like this (make sure you have the solidity compiler installed):

solc -o build --bin --abi contracts/*.sol

The solidity compiler is generating the binary and abi code for the smart contracts in a directory called contracts and is being output to a directory called build.

For more see examples folder.

Futures migration

• Get rid of parking_lot (replace with async-aware locks if really needed).
• Consider getting rid of Unpin Consider getting rid of `Unpin` requirements. (#361)
• WebSockets: TLS support (#360)
• WebSockets: Reconnecting & Pings
• Consider using tokio instead of async-std for ws.rs Consider using `tokio` instead of `async-std` for `ws.rs` transport (issue with test).
• Restore IPC Transport

General

• More flexible API (accept Into<X> More flexible API (accept `Into`)
• Contract calls (ABI encoding; debris/ethabi Contract calls (ABI encoding; `debris/ethabi`)
• Batch Requests

Transports

• HTTP transport
• IPC transport
• WebSockets transport

Types

• Types for Types for `U256,H256,Address(H160)`
• Index type (numeric, encoded to hex)
• Transaction type (Transaction Transaction type (`Transaction` from Parity)
• Transaction receipt type (TransactionReceipt Transaction receipt type (`TransactionReceipt` from Parity)
• Block type (RichBlock Block type (`RichBlock` from Parity)
• Work type (Work Work type (`Work` from Parity)
• Syncing type (SyncStats Syncing type (`SyncStats` from Parity)

APIs

• Eth: Eth: `eth_*`
• Eth filters: Eth filters: `eth_*`
• Eth pubsub: Eth pubsub: `eth_*`
• `net_*`
• `web3_*`
• `personal_*`
• `traces_*`

Parity-specific APIs

• Parity read-only: Parity read-only: `parity_*`

• Parity accounts: parity_* Parity accounts: `parity_*` (partially implemented)

• Parity set: Parity set: `parity_*`

• `signer_*`

• Own APIs (Extendable)

let web3 = Web3::new(transport);
web3.api::<CustomNamespace>().custom_method().wait().unwrap()

Installation on Windows

Currently, Windows does not support IPC, which is enabled in the library by default.
To complile, you need to disable the IPC feature:

web3 = { version = "0.11.0", default-features = false, features = ["http"] }