Rust区块链开发库starknet-signers的使用

安装

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

cargo add starknet-signers

或者在Cargo.toml中添加：

starknet-signers = "0.13.0"

基本使用示例

use starknet_signers::{LocalWallet, Signer};
use starknet_core::types::FieldElement;

#[tokio::main]
async fn main() {
    // 创建本地钱包
    let private_key = FieldElement::from_hex_be("YOUR_PRIVATE_KEY_HEX").unwrap();
    let wallet = LocalWallet::from(private_key);
    
    // 准备要签名的消息
    let message = FieldElement::from_hex_be("MESSAGE_HEX").unwrap();
    
    // 签名
    let signature = wallet.sign(&message).await.unwrap();
    
    println!("Signature: {:?}", signature);
}

完整示例

use starknet_signers::{LocalWallet, Signer};
use starknet_core::types::{FieldElement, transaction::DeclareTransaction};
use starknet_providers::Provider;

#[tokio::main]
async fn main() {
    // 1. 设置私钥和钱包
    let private_key = FieldElement::from_hex_be("0x123...").unwrap();
    let wallet = LocalWallet::from(private_key);
    
    // 2. 创建交易
    let declare_transaction = DeclareTransaction {
        class_hash: FieldElement::from_hex_be("0x456...").unwrap(),
        sender_address: FieldElement::from_hex_be("0x789...").unwrap(),
        nonce: FieldElement::ZERO,
        max_fee: FieldElement::from_hex_be("0xDEADBEEF").unwrap(),
        signature: vec![], // 签名将在后面添加
        compiled_class_hash: None,
        contract_class: None,
    };
    
    // 3. 计算交易哈希
    let chain_id = FieldElement::from_hex_be("SN_MAIN").unwrap();
    let transaction_hash = declare_transaction.calculate_hash(&chain_id);
    
    // 4. 签名交易
    let signature = wallet.sign(&transaction_hash).await.unwrap();
    
    // 5. 添加签名到交易
    let signed_transaction = DeclareTransaction {
        signature: signature.to_vec(),
        ..declare_transaction
    };
    
    // 6. 发送交易到StarkNet网络
    // let provider = /* 初始化Provider */;
    // let result = provider.add_declare_transaction(&signed_transaction).await.unwrap();
    
    println!("Signed transaction with hash: 0x{:x}", transaction_hash);
}

完整示例demo

下面是一个更完善的示例，展示如何完整使用starknet-signers进行交易签名和发送：

use starknet_signers::{LocalWallet, Signer};
use starknet_core::types::{
    FieldElement, 
    transaction::{DeclareTransaction, BroadcastedDeclareTransaction}
};
use starknet_providers::{
    Provider, 
    jsonrpc::{HttpTransport, JsonRpcClient}
};
use url::Url;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 1. 初始化钱包
    let private_key = FieldElement::from_hex_be("0x123...")?;
    let wallet = LocalWallet::from(private_key);
    
    // 2. 准备交易参数
    let class_hash = FieldElement::from_hex_be("0x456...")?;
    let sender_address = FieldElement::from_hex_be("0x789...")?;
    let max_fee = FieldElement::from_hex_be("0x100000")?;
    
    // 3. 创建声明交易
    let declare_transaction = DeclareTransaction {
        class_hash,
        sender_address,
        nonce: FieldElement::ZERO,
        max_fee,
        signature: vec![],
        compiled_class_hash: None,
        contract_class: None,
    };
    
    // 4. 计算交易哈希并签名
    let chain_id = FieldElement::from_hex_be("SN_MAIN")?;
    let transaction_hash = declare_transaction.calculate_hash(&chain_id);
    let signature = wallet.sign(&transaction_hash).await?;
    
    // 5. 构建已签名的交易
    let signed_transaction = DeclareTransaction {
        signature: signature.to_vec(),
        ..declare_transaction
    };
    
    // 6. 准备广播交易
    let broadcasted_tx = BroadcastedDeclareTransaction {
        sender_address: signed_transaction.sender_address,
        max_fee: signed_transaction.max_fee,
        signature: signed_transaction.signature,
        nonce: signed_transaction.nonce,
        contract_class: None, // 实际使用时需要提供
        compiled_class_hash: None, // 实际使用时需要提供
    };
    
    // 7. 初始化Provider并发送交易
    let rpc_url = Url::parse("https://starknet-mainnet.infura.io/v3/YOUR_API_KEY")?;
    let provider = JsonRpcClient::new(HttpTransport::new(rpc_url));
    
    // 8. 发送交易 (实际使用时取消注释)
    // let result = provider.add_declare_transaction(&broadcasted_tx).await?;
    // println!("Transaction result: {:?}", result);
    
    println!("Successfully signed transaction with hash: 0x{:x}", transaction_hash);
    Ok(())
}

特性

• 支持本地钱包签名
• 与starknet-rs生态系统无缝集成
• 提供安全的以太坊账户签名功能
• 支持交易哈希计算和签名

许可证

starknet-signers采用双许可证：

• MIT许可证
• Apache-2.0许可证

您可以根据需要选择其中一种许可证。