web3 FE

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

文档： crates.io

使用方法

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

[dependencies]
fathom_web3 = "1.0.0"

示例

#[tokio::main]
async fn main() -> fathom_web3::Result<()> {
    let transport = fathom_web3::transports::Http::new("https://127.0.0.1:8545")?;
    let web3 = fathom_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 编译器正在生成智能合约的二进制和 ABI 代码，并输出到名为 contracts 的目录中，输出到名为 build 的目录。

更多信息请参阅 示例文件夹。

未来迁移

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

通用

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

传输

• HTTP 传输
• IPC 传输
• WebSockets 传输

类型

• 类型为 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 功能

fathom_web3 = { version = "1.0.0", default-features = false, features = ["http"] }

避免 OpenSSL 依赖

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

fathom_web3 = { version = "1.0.0", default-features = false, features = ["http-rustls-tls"] }

Cargo 功能

库支持以下功能

• http - 启用 HTTP 传输（因为 hyper，需要 tokio 运行时）。
• 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。