Rust Solana代币管理库solana-tokens的使用，高效处理Solana区块链上的代币转账与交易

solana-tokens是一个用于批量管理Solana代币的命令行工具，它可以高效地处理Solana区块链上的代币转账与交易。

分发代币

将代币发送到<RECIPIENTS_CSV>文件中列出的接收者。

示例recipients.csv文件内容：

recipient,amount,lockup_date
3ihfUy1n9gaqihM5bJCiTAGLgWc5zo3DqVUS6T736NLM,42.0,
CYRJWqiSjLitBAcRxPvWpgX3s5TvmN2SuRY3eEYypFvT,43.0,

执行分发命令：

solana-tokens distribute-tokens --from <KEYPAIR> --input-csv <RECIPIENTS_CSV> --fee-payer <KEYPAIR>

分发相同数量的代币

可以简单地使用--transfer-amount参数指定要发送给每个接收者的相同代币数量。

示例recipients.csv文件内容：

recipient
6Vo87BaDhp4v4GHwVDhw5huhxVF8CyxSXYtkUwVHbbPv
7aHDubg5FBYj1SgmyBgU3ZJdtfuqYCQsJQK2pTR5JUqr
CYRJWqiSjLitBAcRxPvWpgX3s5TvmN2SuRY3eEYypFvT

执行分发命令：

solana-tokens distribute-tokens --transfer-amount 10 --from <KEYPAIR> --input-csv <RECIPIENTS_CSV> --fee-payer <KEYPAIR>

分发SPL代币

分发SPL代币与分发SOL类似，但需要--owner参数来签署交易。每个接收者账户必须是系统账户，将拥有SPL代币铸币的关联代币账户。

示例recipients.csv文件内容：

recipient,amount
CYRJWqiSjLitBAcRxPvWpgX3s5TvmN2SuRY3eEYypFvT,75400
C56nwrDVFpPrqwGYsTgQxv1ZraTh81H14PV4RHvZe36s,10000
7aHDubg5FBYj1SgmyBgU3ZJdtfuqYCQsJQK2pTR5JUqr,42100
7qQPmVAQxEQ5djPDCtiEUrxaPf8wKtLG1m6SB1brejJ1,20000

执行分发命令：

solana-tokens distribute-spl-tokens --from <ADDRESS> --owner <KEYPAIR> \
    --input-csv <RECIPIENTS_CSV> --fee-payer <KEYPAIR>

完整示例代码

以下是一个完整的Rust示例，展示如何使用solana-tokens库进行代币分发：

use solana_tokens::commands::{distribute_tokens, DistributeTokensConfig};
use solana_sdk::signer::keypair::Keypair;
use std::path::PathBuf;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 配置分发参数
    let config = DistributeTokensConfig {
        from: Keypair::new(), // 发送方密钥对
        input_csv: PathBuf::from("recipients.csv"), // 接收者CSV文件路径
        fee_payer: Keypair::new(), // 支付交易费用的密钥对
        dry_run: false, // 是否仅模拟运行
        transfer_amount: None, // 固定转账金额(可选)
        spl_token: None, // SPL代币铸币地址(可选)
        owner: None, // SPL代币所有者(可选)
        ..Default::default()
    };

    // 执行代币分发
    distribute_tokens(config)?;

    Ok(())
}

对于SPL代币分发，可以这样配置：

use solana_tokens::commands::{distribute_spl_tokens, DistributeSplTokensConfig};
use solana_sdk::{pubkey::Pubkey, signer::keypair::Keypair};
use std::path::PathBuf;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 配置SPL代币分发参数
    let config = DistributeSplTokensConfig {
        from: Pubkey::new_unique(), // 发送方地址
        input_csv: PathBuf::from("spl_recipients.csv"), // 接收者CSV文件路径
        fee_payer: Keypair::new(), // 支付交易费用的密钥对
        owner: Keypair::new(), // SPL代币所有者密钥对
        mint: Pubkey::new_unique(), // SPL代币铸币地址
        dry_run: false, // 是否仅模拟运行
        ..Default::default()
    };

    // 执行SPL代币分发
    distribute_spl_tokens(config)?;

    Ok(())
}

安装

可以通过Cargo安装solana-tokens：

cargo install solana-tokens

或作为库添加到项目中：

cargo add solana-tokens

或者在Cargo.toml中添加：

solana-tokens = "2.3.6"

完整示例Demo

以下是一个更完整的Rust示例，展示如何使用solana-tokens库进行代币分发，包括从文件读取密钥对和错误处理：

use solana_tokens::commands::{distribute_tokens, DistributeTokensConfig};
use solana_sdk::{
    signer::keypair::{read_keypair_file, Keypair},
    signature::Signer,
};
use std::{
    path::PathBuf,
    error::Error,
};

fn main() -> Result<(), Box<dyn Error>> {
    // 从文件读取发送方密钥对
    let sender_keypair = read_keypair_file("sender_keypair.json")?;
    let fee_payer_keypair = read_keypair_file("fee_payer_keypair.json")?;

    // 配置分发参数
    let config = DistributeTokensConfig {
        from: sender_keypair, // 发送方密钥对
        input_csv: PathBuf::from("recipients.csv"), // 接收者CSV文件路径
        fee_payer: fee_payer_keypair, // 支付交易费用的密钥对
        dry_run: false, // 是否仅模拟运行
        transfer_amount: Some(10), // 固定转账金额10 SOL
        spl_token: None, // 不使用SPL代币
        owner: None, // 不使用SPL代币所有者
        ..Default::default()
    };

    // 执行代币分发
    distribute_tokens(config)?;

    println!("代币分发成功完成!");
    Ok(())
}

对于SPL代币分发的完整示例：

use solana_tokens::commands::{distribute_spl_tokens, DistributeSplTokensConfig};
use solana_sdk::{
    pubkey::Pubkey,
    signer::keypair::{read_keypair_file, Keypair},
};
use std::{
    path::PathBuf,
    error::Error,
    str::FromStr,
};

fn main() -> Result<(), Box<dyn Error>> {
    // 从文件读取密钥对
    let owner_keypair = read_keypair_file("owner_keypair.json")?;
    let fee_payer_keypair = read_keypair_file("fee_payer_keypair.json")?;

    // 配置SPL代币分发参数
    let config = DistributeSplTokensConfig {
        from: Pubkey::from_str("TokenAccountAddressHere")?, // 发送方代币账户地址
        input_csv: PathBuf::from("spl_recipients.csv"), // 接收者CSV文件路径
        fee_payer: fee_payer_keypair, // 支付交易费用的密钥对
        owner: owner_keypair, // SPL代币所有者密钥对
        mint: Pubkey::from_str("TokenMintAddressHere")?, // SPL代币铸币地址
        dry_run: false, // 是否仅模拟运行
        ..Default::default()
    };

    // 执行SPL代币分发
    distribute_spl_tokens(config)?;

    println!("SPL代币分发成功完成!");
    Ok(())
}