Rust SDK

Rust SDK 可让你连接、探索并与 Aptos 区块链交互。你可以用它请求数据、发送交易、设置测试环境等。

安装 Rust SDK

Aptos 在 aptos-rust-sdk GitHub 仓库和 crates.io 上提供官方 Rust SDK。将其添加到 Cargo.toml：

[dependencies]
aptos-sdk = "0.7"
tokio = { version = "1", features = ["full"] }
anyhow = "1"

若要使用尚未发布的最新更改：

[dependencies]
aptos-sdk = { git = "https://github.com/aptos-labs/aptos-rust-sdk", package = "aptos-sdk" }

该 SDK 需要 Rust 1.95+。与 aptos-core 中的旧版 crate 不同，此 SDK 不需要 git 补丁，也不需要 .cargo/config.toml 中的 tokio_unstable 标志。

功能标志

功能	默认	说明
`ed25519`	是	Ed25519 签名方案
`secp256k1`	是	Secp256k1 ECDSA 签名
`secp256r1`	是	Secp256r1（P-256）ECDSA 签名
`mnemonic`	是	BIP-39 助记词支持
`indexer`	是	GraphQL Indexer 客户端
`faucet`	是	测试网水龙头集成
`bls`	否	BLS12-381 签名
`macros`	否	用于类型安全合约绑定的过程宏

最小构建：

[dependencies]
aptos-sdk = { version = "0.7", default-features = false, features = ["ed25519"] }

示例

快速入门几分钟内在 Devnet 上完成一笔可运行的转账

账户生成、恢复并为账户注资

获取数据读取账本、账户和 View 函数数据

提交交易构建、模拟、签名并提交交易

示例 SDK 仓库中的可运行示例目录

测试覆盖 SDK API 的 crate 测试

来自已测试示例套件的 APT 转账

以下片段取自 SDK 仓库中的 transfer.rs。注资金额应明显高于转账金额：默认 max_gas_amount 为 2_000_000。

37 collapsed lines
//! Example: Basic APT transfer
//!
//! This example demonstrates how to:
//! 1. Create an Aptos client
//! 2. Generate or load an account
//! 3. Fund the account using the faucet
//! 4. Transfer APT to another account
//!
//! Run with: `cargo run --example transfer --features "ed25519,faucet"`

use aptos_sdk::{Aptos, AptosConfig, account::Ed25519Account};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Create client for devnet
    let aptos = Aptos::new(AptosConfig::devnet())?;
    println!("Connected to devnet");

    // Generate sender account
    let sender = Ed25519Account::generate();
    println!("Sender address: {}", sender.address());

    // Fund sender using faucet
    println!("Funding sender account...");
    aptos.fund_account(sender.address(), 100_000_000).await?;

    // Wait for funding to complete
    tokio::time::sleep(std::time::Duration::from_secs(2)).await;

    // Check sender balance
    let balance = aptos.get_balance(sender.address()).await?;
    println!("Sender balance: {} APT", balance as f64 / 100_000_000.0);

    // Generate recipient account
    let recipient = Ed25519Account::generate();
    println!("Recipient address: {}", recipient.address());

    // Transfer 0.1 APT (10_000_000 octas)
    println!("Transferring 0.1 APT...");
    let result = aptos
        .transfer_apt(&sender, recipient.address(), 10_000_000)
        .await?;
31 collapsed lines

    let success = result
        .data
        .get("success")
        .and_then(serde_json::value::Value::as_bool);
    if success == Some(true) {
        println!("Transfer successful!");

        // Check balances
        let sender_balance = aptos.get_balance(sender.address()).await?;
        let recipient_balance = aptos.get_balance(recipient.address()).await?;

        println!(
            "Sender balance: {} APT",
            sender_balance as f64 / 100_000_000.0
        );
        println!(
            "Recipient balance: {} APT",
            recipient_balance as f64 / 100_000_000.0
        );
    } else {
        let vm_status = result
            .data
            .get("vm_status")
            .and_then(|v| v.as_str())
            .unwrap_or("unknown");
        println!("Transfer failed: {vm_status}");
    }

    Ok(())
}