web3 FE

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

文档： crates.io

用法

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

[dependencies]
web3_fe = "0.1.0"

示例

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

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

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

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

更多内容请参阅 示例文件夹。

未来迁移

• 摆脱parking_lot（如果确实需要，请用async-aware锁替换）。
• 考虑去除Unpin要求。（#361）
• WebSockets：TLS支持（#360）
• WebSockets：重连与Ping
• 考虑使用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）

APIs

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

Parity特定的APIs

• Parity只读: parity_*

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

• Parity集合: parity_*

• signer_*

• 自研APIs（可扩展）

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

Windows上的安装

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

web3_fe = { version = "0.1.0", default-features = false, features = ["http"] }

避免OpenSSL依赖

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

web3_fe = { version = "0.1.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。