Rust区块链开发工具fuels的使用：Fuel SDK为去中心化应用提供模块化智能合约支持

fuels-rs是Fuel区块链的Rust SDK，可用于多种用途，包括但不限于：

• 编译、部署和测试Sway合约
• 启动本地Fuel网络
• 手工制作脚本或合约调用并签名交易
• 生成合约方法的类型安全Rust绑定
• 更多功能仍在积极开发中

特性

• [x] 启动Fuel节点
• [x] 部署合约
• [x] 与已部署合约交互
• [x] 类型安全的Sway合约绑定代码生成
• [x] 运行Sway脚本
• [x] 常见操作的CLI
• [x] 本地测试钱包
• [ ] 钱包集成
• [ ] 事件查询/监控

依赖需求

• 最新的stable Rust工具链
• forc和fuel-core二进制文件

使用示例

以下是使用fuels-rs SDK的完整示例demo：

use fuels::prelude::*;

// 示例合约ABI
abigen!(
    MyContract,
    r#"
        {
            "types": [],
            "functions": [
                {
                    "inputs": [],
                    "name": "counter",
                    "output": {
                        "name": "",
                        "type": "u64",
                        "components": null
                    }
                },
                {
                    "inputs": [
                        {
                            "name": "value",
                            "type": "u64",
                            "components": null
                        }
                    ],
                    "name": "increment_counter",
                    "output": {
                        "name": "",
                        "type": "()",
                        "components": null
                    }
                }
            ]
        }
    "#
);

#[tokio::test]
async fn test_contract() -> Result<()> {
    // 启动本地Fuel节点
    let wallet = launch_provider_and_get_wallet().await?;

    // 部署合约
    let contract_id = Contract::deploy(
        "./tests/contracts/counter/out/debug/counter.bin",
        &wallet,
        TxParameters::default(),
        StorageConfiguration::default(),
    )
    .await?;

    // 创建合约实例
    let instance = MyContract::new(contract_id, wallet.clone());

    // 调用合约方法
    let result = instance.methods().counter().call().await?;
    assert_eq!(result.value, 0);

    // 调用合约方法改变状态
    instance.methods().increment_counter(1).call().await?;

    // 验证状态变化
    let result = instance.methods().counter().call().await?;
    assert_eq!(result.value, 1);

    Ok(())
}

完整示例代码

use fuels::{prelude::*, tx::ContractId};

// 定义合约ABI并生成类型安全的Rust绑定
abigen!(
    CounterContract,
    r#"
        {
            "types": [],
            "functions": [
                {
                    "inputs": [],
                    "name": "get_count",
                    "output": {
                        "name": "",
                        "type": "u64",
                        "components": null
                    }
                },
                {
                    "inputs": [
                        {
                            "name": "amount",
                            "type": "u64",
                            "components": null
                        }
                    ],
                    "name": "increment_count",
                    "output": {
                        "name": "",
                        "type": "()",
                        "components": null
                    }
                }
            ]
        }
    "#
);

#[tokio::main]
async fn main() -> Result<()> {
    // 1. 设置测试环境
    let wallet = launch_provider_and_get_wallet().await?;

    // 2. 部署合约
    let contract_id = Contract::deploy(
        "./contracts/counter/out/debug/counter.bin",
        &wallet,
        TxParameters::default(),
        StorageConfiguration::default(),
    )
    .await?;

    println!("合约部署成功，ID: {:?}", contract_id);

    // 3. 创建合约实例
    let contract = CounterContract::new(contract_id, wallet.clone());

    // 4. 调用合约方法
    // 获取初始计数器值
    let initial_count = contract.methods().get_count().call().await?.value;
    println!("初始计数器值: {}", initial_count);

    // 增加计数器
    let increment_amount = 5u64;
    contract
        .methods()
        .increment_count(increment_amount)
        .call()
        .await?;

    // 验证新值
    let new_count = contract.methods().get_count().call().await?.value;
    println!("增加后的计数器值: {}", new_count);
    assert_eq!(new_count, initial_count + increment_amount);

    Ok(())
}

安装

在项目目录中运行以下Cargo命令：

cargo add fuels

或在Cargo.toml中添加以下行：

fuels = "0.74.0"

测试

首先使用forc构建测试项目：

forc build --release --path e2e

然后可以运行SDK测试：

cargo test

为什么前缀是fuels而不是fuel?

为了与来自ethers.js生态系统的开发者感觉熟悉，本项目选择在末尾加s。fuels-*系列SDK受到The Ethers Project的启发。