fuels-core：Fuel区块链SDK核心组件使用指南

fuels-core是Fuel区块链的Rust SDK核心组件，提供了与Fuel区块链交互的基础功能，包括智能合约交互和链上操作。

主要功能

• 连接Fuel节点
• 管理钱包和账户
• 与智能合约交互
• 发送交易
• 查询链上数据

安装

在Cargo.toml中添加依赖：

[dependencies]
fuels-core = "0.24"

基本使用方法

1. 连接到Fuel节点

use fuels::prelude::*;

#[tokio::main]
async fn main() -> Result<()> {
    // 连接到本地测试节点
    let provider = Provider::connect("http://127.0.0.1:4000").await?;
    
    // 或者连接到测试网
    // let provider = Provider::connect("https://beta-3.fuel.network").await?;
    
    Ok(())
}

2. 创建钱包

use fuels::prelude::*;

#[tokio::main]
async fn main() -> Result<()> {
    // 生成新钱包
    let wallet = WalletUnlocked::new_random(None);
    
    println!("钱包地址: {}", wallet.address());
    println!("私钥: {}", wallet.signer().unwrap().private_key());
    
    Ok(())
}

3. 与智能合约交互

假设你有一个简单的智能合约：

contract Counter {
    value: u64 = 0;
    
    fn increment() {
        value += 1;
    }
    
    fn get() -> u64 {
        value
    }
}

使用fuels-core与之交互：

use fuels::{
    prelude::*,
    types::contract_id::ContractId,
};

#[tokio::main]
async fn main() -> Result<()> {
    // 设置provider和钱包
    let provider = Provider::connect("http://127.0.0.1:4000").await?;
    let wallet = WalletUnlocked::new_random(None);
    
    // 部署合约
    let compiled = Contract::load_sway_contract("path/to/counter/out/debug/counter.bin")?;
    let contract_id = Contract::deploy(&compiled, &wallet, TxParameters::default()).await?;
    
    println!("合约部署成功，ID: {:?}", contract_id);
    
    // 调用合约方法
    let instance = Counter::new(contract_id, wallet.clone());
    
    // 调用increment方法
    instance.increment().call().await?;
    
    // 查询当前值
    let current_value = instance.get().call().await?.value;
    println!("当前计数器值: {}", current_value);
    
    Ok(())
}

4. 发送和接收资产

use fuels::prelude::*;

#[tokio::main]
async fn main() -> Result<()> {
    // 设置provider
    let provider = Provider::connect("http://127.0.0.1:4000").await?;
    
    // 创建两个钱包
    let wallet1 = WalletUnlocked::new_random(None);
    let wallet2 = WalletUnlocked::new_random(None);
    
    // 给钱包1充值
    wallet1.fund(&provider, 100_000_000, None).await?;
    
    // 从钱包1发送资产到钱包2
    let tx = wallet1.transfer(
        wallet2.address(),
        50_000_000,
        None,
        TxParameters::default(),
    ).await?;
    
    println!("交易ID: {:?}", tx.tx_id);
    
    // 查询钱包2余额
    let balance = wallet2.get_asset_balance(&Default::default()).await?;
    println!("钱包2余额: {}", balance);
    
    Ok(())
}

高级功能

1. 批量交易

use fuels::prelude::*;

#[tokio::main]
async fn main() -> Result<()> {
    let provider = Provider::connect("http://127.0.0.1:4000").await?;
    let wallet = WalletUnlocked::new_random(None);
    wallet.fund(&provider, 100_000_000, None).await?;
    
    // 创建批量交易构建器
    let mut tb = TransactionBuilder::default();
    
    // 添加多个操作
    tb.add_transfer(
        wallet.address(),
        wallet.address(),
        10_000_000,
        None,
    );
    
    tb.add_transfer(
        wallet.address(),
        wallet.address(),
        20_000_000,
        None,
    );
    
    // 构建并发送交易
    let tx = tb.finalize(&wallet, TxParameters::default()).await?;
    provider.send_transaction(tx).await?;
    
    Ok(())
}

2. 事件监听

use fuels::prelude::*;

#[tokio::main]
async fn main() -> Result<()> {
    let provider = Provider::connect("http://127.0.0.1:4000").await?;
    
    // 订阅新区块事件
    let mut stream = provider.subscribe_blocks().await?;
    
    while let Some(block) = stream.next().await {
        println!("新区块: {:?}", block?.header.height);
    }
    
    Ok(())
}

完整示例代码

以下是一个完整的Fuel区块链交互示例，包含钱包创建、资产转移和智能合约交互：

use fuels::{
    prelude::*,
    types::contract_id::ContractId,
};

// 定义智能合约ABI
abi!(Counter, "path/to/counter/abi.json");

#[tokio::main]
async fn main() -> Result<()> {
    // 1. 连接到本地Fuel节点
    let provider = Provider::connect("http://127.0.0.1:4000").await?;
    
    // 2. 创建两个钱包
    let wallet1 = WalletUnlocked::new_random(None);
    let wallet2 = WalletUnlocked::new_random(None);
    
    // 3. 给钱包1充值
    wallet1.fund(&provider, 100_000_000, None).await?;
    println!("钱包1地址: {}", wallet1.address());
    
    // 4. 部署Counter智能合约
    let compiled = Contract::load_sway_contract("path/to/counter/out/debug/counter.bin")?;
    let contract_id = Contract::deploy(&compiled, &wallet1, TxParameters::default()).await?;
    println!("合约部署成功，ID: {:?}", contract_id);
    
    // 5. 与合约交互
    let counter = Counter::new(contract_id, wallet1.clone());
    
    // 调用increment方法
    counter.increment().call().await?;
    
    // 查询当前值
    let value = counter.get().call().await?.value;
    println!("当前计数器值: {}", value);
    
    // 6. 转账操作
    let tx = wallet1.transfer(
        wallet2.address(),
        50_000_000,
        None,
        TxParameters::default(),
    ).await?;
    
    println!("转账交易ID: {:?}", tx.tx_id);
    
    // 7. 查询余额
    let balance = wallet2.get_asset_balance(&Default::default()).await?;
    println!("钱包2余额: {}", balance);
    
    Ok(())
}

注意事项

1. 确保Fuel节点正在运行并可以访问
2. 测试时可以使用Fuel本地节点或测试网
3. 生产环境请妥善保管私钥
4. 交易需要足够的Gas费用

fuels-core提供了强大的功能来与Fuel区块链交互，更多详细用法可以参考官方文档和示例代码。