Solana钱包 ◎

面向AI代理的Solana钱包管理与代币操作。

设置

pip install -r requirements.txt

初始化钱包

首先，创建一个新钱包并将私钥保存到您的.env文件中：

python3 {baseDir}/scripts/initialize.py

这将：

• 生成一个新的Solana密钥对
• 显示公钥（钱包地址）
• 以base58格式将私钥保存到.env文件中，作为SOLANA_PRIVATE_KEY

重要提示：运行initialize.py后，将私钥导出到您的环境变量中：

export SOLANA_PRIVATE_KEY=$(grep SOLANA_PRIVATE_KEY .env | cut -d '=' -f2)

或者通过source命令加载.env文件：

source .env

钱包操作

检查SOL余额

python3 {baseDir}/scripts/wallet.py balance
python3 {baseDir}/scripts/wallet.py balance <wallet_address>

检查代币余额

python3 {baseDir}/scripts/wallet.py token-balance <token_mint_address>
python3 {baseDir}/scripts/wallet.py token-balance <token_mint_address> --owner <wallet_address>

发送SOL

python3 {baseDir}/scripts/wallet.py send <recipient_address> <amount_in_sol>

发送SPL代币

python3 {baseDir}/scripts/wallet.py send-token <token_mint_address> <recipient_address> <amount>

获取钱包地址

python3 {baseDir}/scripts/wallet.py address

木星交易所

获取兑换报价

python3 {baseDir}/scripts/jup_swap.py quote <input_token> <output_token> <amount>
python3 {baseDir}/scripts/jup_swap.py quote SOL USDC 1

执行兑换

python3 {baseDir}/scripts/jup_swap.py swap <input_token> <output_token> <amount>
python3 {baseDir}/scripts/jup_swap.py swap SOL USDC 0.1

列出已知代币

python3 {baseDir}/scripts/jup_swap.py tokens

代币符号：SOL、USDC、USDT、BONK、JUP、RAY、PYTH（或使用完整的铸币地址）

Pump.fun 代币发行

发行代币

python3 {baseDir}/scripts/pumpfun.py launch --name "Token Name" --symbol "TKN" --image ./logo.png

开发者购买发行

python3 {baseDir}/scripts/pumpfun.py launch --name "Token Name" --symbol "TKN" --image ./logo.png --buy 0.5

自定义铸币地址发行（个性化地址）

python3 {baseDir}/scripts/pumpfun.py launch --name "Token Name" --symbol "TKN" --image ./logo.png --mint-key <base58_key>

使用以“pump”结尾的个性化地址，可使代币看起来更可信。生成方式：

solana-keygen grind --ends-with pump:1

选项

• --name- 代币名称（必需）
• --symbol- 代币符号（必需）
• --image- 代币图片路径（必需）
• --description或-d- 代币描述
• --buy或-b- 开发者购买金额（以SOL计）
• --mint-key或-m- 自定义铸造私钥（base58编码）

网络配置

默认情况下，钱包操作运行在主网上。使用--network进行切换：

python3 {baseDir}/scripts/wallet.py balance --network devnet
python3 {baseDir}/scripts/wallet.py balance --network testnet

环境变量

示例

# Initialize new wallet
python3 {baseDir}/scripts/initialize.py

# Check your SOL balance
python3 {baseDir}/scripts/wallet.py balance

# Send 0.1 SOL to another wallet
python3 {baseDir}/scripts/wallet.py send 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU 0.1

# Check USDC balance (mainnet USDC mint)
python3 {baseDir}/scripts/wallet.py token-balance EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

# Send 10 USDC to another wallet
python3 {baseDir}/scripts/wallet.py send-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU 10

# Quote swap: 1 SOL to USDC
python3 {baseDir}/scripts/jup_swap.py quote SOL USDC 1

# Swap 0.5 SOL to USDC
python3 {baseDir}/scripts/jup_swap.py swap SOL USDC 0.5

# Launch token on Pump.fun
python3 {baseDir}/scripts/pumpfun.py launch --name "My Token" --symbol "MTK" --image ./logo.png

# Launch with dev buy
python3 {baseDir}/scripts/pumpfun.py launch --name "My Token" --symbol "MTK" --image ./logo.png --buy 1

常见代币铸造地址（主网）

使用时机

• 创建钱包为新的Solana账户
• 检查余额对于SOL或任何SPL代币
• 发送SOL用于支付或转账
• 发送代币用于SPL代币转账
• 兑换代币通过Jupiter聚合器
• 发行代币在Pump.fun上，可自定义图片并进行开发者购买
• 开发网测试使用--network devnet