web3

Ethereum JSON-RPC多传输客户端。Web3.js库的Rust实现。

文档： crates.io

状态

请注意，这个包几乎没有人维护，我正在寻找一个活跃的维护者（见#664）。如果你正在启动一个新项目，我建议选择 https://github.com/gakonst/ethers-rs。

用法

首先，将以下内容添加到你的 Cargo.toml

[dependencies]
web3 = "0.18.0"

示例

#[tokio::main]
async fn main() -> web3::Result<()> {
    let transport = web3::transports::Http::new("https://127.0.0.1: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(())
}

如果你想部署你编写的智能合约，你可以这样做（确保你已经安装了solidity编译器）

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

solidity编译器正在为名为contracts的目录中的智能合约生成二进制和abi代码，并将其输出到名为build的目录。

更多请参阅 示例文件夹.

未来迁移

• 去除parking_lot（如果确实需要，请替换为支持异步的锁）。
• 考虑去除 Unpin 要求。 (#361)
• WebSockets：TLS支持 (#360)
• WebSockets：重连 & Pings
• 考虑使用 tokio 替代 async-std 用于 ws.rs 传输（测试问题）。
• 恢复IPC传输

通用

• 更灵活的API（接受 Into<X>）
• 合约调用（ABI编码；debris/ethabi）
• 批量请求

传输方式

• HTTP传输
• IPC传输
• WebSocket传输

类型

• 类型定义 U256,H256,Address(H160)
• 索引类型（数字，编码为十六进制）
• 交易类型（来自Parity的Transaction）
• 交易收据类型（来自Parity的TransactionReceipt）
• 区块类型（来自Parity的RichBlock）
• 工作类型（来自Parity的Work）
• 同步类型（来自Parity的SyncStats）

API

• Eth: eth_*
• Eth过滤器: eth_*
• Eth pubsub: eth_*
• net_*
• web3_*
• personal_*
• traces_*

Parity特定API

• Parity只读: parity_*

• Parity账户: parity_*（部分实现）

• Parity集: parity_*

• signer_*

• 自定义API（可扩展）

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

Windows上的安装

目前，Windows不支持IPC，该库默认启用。要编译，需要禁用IPC功能

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

避免OpenSSL依赖

在Linux上，native-tls使用OpenSSL实现。为了避免HTTPS使用的依赖性，请使用相应的功能。

web3 = { version = "0.18.0", default-features = false, features = ["http-rustls-tls"] }

Cargo功能

该库支持以下功能

• http - 启用HTTP传输（需要tokio运行时，因为hyper）。
• http-tls - 通过reqwest/default-tls启用HTTP传输的TLS支持（暗示http；默认）。
• http-native-tls - 通过reqwest/native-tls启用HTTP传输的TLS支持（暗示http）。
• http-rustls-tls - 通过reqwest/rustls-tls启用HTTP传输的TLS支持（暗示http）。
• ws-tokio - 使用tokio运行时启用WS传输。
• ws-tls-tokio - 启用WS传输的TLS支持（暗示ws-tokio；默认）。
• ws-async-std - 使用async-std运行时启用WS传输。
• ws-tls-async-std - 启用WS传输的TLS支持（暗示ws-async-std）。
• ipc-tokio - 使用tokio运行时启用IPC传输（默认）。
• signing - 启用账户命名空间和本地签名支持（默认）。
• eip-1193 - 启用EIP-1193支持。
• wasm - 为WASM编译（确保禁用默认功能）。
• arbitrary_precision - 在serde_json中启用arbitrary_precision。
• allow-missing-fields - 在以太坊中，某些响应字段是必填的，但在与EVM兼容的链（如Celo和Fantom）中则不存在。此功能通过为这些字段设置默认值来启用兼容性。