Kaspa钱包技能

用于Kaspa区块链的简易自托管钱包。

概述

┌─────────────────────────────────────────────────────────┐
│                     KASPA WALLET                        │
├─────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐ │
│  │   Balance   │  │    Send     │  │  Payment URIs   │ │
│  │   Check     │  │    KAS      │  │   Generator     │ │
│  └─────────────┘  └─────────────┘  └─────────────────┘ │
│           │                │                   │        │
│           └────────────────┴───────────────────┘        │
│                         │                               │
│              ┌──────────▼──────────┐                    │
│              │   Kaspa Python SDK  │                    │
│              │   (wRPC Client)     │                    │
│              └─────────────────────┘                    │
│                         │                               │
│         ┌───────────────┼───────────────┐               │
│         ▼               ▼               ▼               │
│    ┌─────────┐    ┌──────────┐    ┌──────────┐         │
│    │ Mainnet │    │ Testnet  │    │  Custom  │         │
│    │  wRPC   │    │   wRPC   │    │   RPC    │         │
│    └─────────┘    └──────────┘    └──────────┘         │
└─────────────────────────────────────────────────────────┘

功能

快速开始

安装

python3 install.py

要求：Python 3.8+ 及 pip。支持 macOS、Linux、Windows 系统。

安装故障排除：

• 如果 pip 失败：手动安装pip install kaspa，或者尝试
• KASPA_PYTHON=python3.12 python3 install.py如果缺少 venv：sudo apt install python3-venv
• （Ubuntu/Debian 系统）重新安装：

rm -rf .venv && python3 install.py

# Check balance
./kaswallet.sh balance
./kaswallet.sh balance kaspa:qrc8y...

# Send payment
./kaswallet.sh send kaspa:qrc8y... 0.5
./kaswallet.sh send kaspa:qrc8y... max

# Generate payment URI
./kaswallet.sh uri kaspa:q... 1.5 "coffee payment"

# Network info
./kaswallet.sh info

# Fee estimates
./kaswallet.sh fees

# Generate new wallet
./kaswallet.sh generate-mnemonic

CLI 使用

支付 URI 格式

kaspa-wallet/
├── SKILL.md
├── README.md
├── install.py              # Auto-installer with venv
├── kaswallet.sh            # CLI wrapper script
├── requirements.txt
└── scripts/
    └── kaswallet.py        # Main wallet logic

架构

# Environment variables (one required)
export KASPA_PRIVATE_KEY="64-character-hex-string"
# OR
export KASPA_MNEMONIC="your twelve or twenty four word seed phrase"

# Optional
export KASPA_NETWORK="mainnet"              # mainnet (default), testnet-10
export KASPA_RPC_URL="wss://..."            # Custom RPC endpoint
export KASPA_RPC_CONNECT_TIMEOUT_MS="30000" # Connection timeout (default: 15000)

配置

核心功能

./kaswallet.sh balance                    # Your wallet balance
./kaswallet.sh balance kaspa:qrc8y...     # Any address balance

检查余额

{"address": "kaspa:q...", "balance": "1.5", "sompi": "150000000", "network": "mainnet"}

输出：

./kaswallet.sh send <address> <amount>           # Send specific amount
./kaswallet.sh send <address> max                # Send entire balance
./kaswallet.sh send <address> <amount> priority  # Priority fee tier

发送 KAS

{"status": "sent", "txid": "abc123...", "from": "kaspa:q...", "to": "kaspa:q...", "amount": "0.5", "fee": "0.0002"}

输出（成功）：

{"error": "Storage mass exceeds maximum", "errorCode": "STORAGE_MASS_EXCEEDED", "hint": "...", "action": "consolidate_utxos"}

输出（错误）：

./kaswallet.sh info

网络信息

{"network": "mainnet", "url": "wss://...", "blocks": 12345678, "synced": true, "version": "1.0.0"}

输出：

./kaswallet.sh fees

费用估算

{"network": "mainnet", "low": {"feerate": 1.0, "estimatedSeconds": 60}, "economic": {...}, "priority": {...}}

输出：

./kaswallet.sh generate-mnemonic

支付URI

{"mnemonic": "word1 word2 word3 ... word24"}

错误处理

./kaswallet.sh uri                          # Your address
./kaswallet.sh uri kaspa:q... 1.5 "payment" # With amount and message

错误

支付流程

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Sender    │     │ Kaspa Wallet│     │  Recipient  │
└──────┬──────┘     └──────┬──────┘     └──────┬──────┘
       │                   │                   │
       │  1. Initiate      │                   │
       │──────────────────▶│                   │
       │                   │                   │
       │                   │  2. Execute       │
       │                   │  KAS Transfer     │
       │                   │─────────────────▶│
       │                   │                   │
       │                   │  3. Confirm       │
       │                   │◀──────────────────│
       │  4. Success       │                   │
       │◀──────────────────│                   │
       │                   │                   │

常见工作流程

合并 UTXO（修复存储质量错误）

当发送失败并出现存储质量超出限制时：

# 1. Get your address
./kaswallet.sh balance
# Returns: {"address": "kaspa:qYOUR_ADDRESS...", ...}

# 2. Send max to yourself (consolidates UTXOs)
./kaswallet.sh send kaspa:qYOUR_ADDRESS... max

# 3. Now send the original amount (will work)
./kaswallet.sh send kaspa:qRECIPIENT... 0.5

检查交易状态

发送后，使用交易ID在区块浏览器上验证：

• 主网：https://explorer.kaspa.org/txs/{交易ID}
• 测试网：https://explorer-tn10.kaspa.org/txs/{交易ID}

切换网络

# Testnet
export KASPA_NETWORK="testnet-10"
./kaswallet.sh info

# Back to mainnet
export KASPA_NETWORK="mainnet"
./kaswallet.sh info

单位

• KAS：人类可读单位（例如，1.5 KAS）
• sompi：最小单位，1 KAS = 100,000,000 sompi

所有命令输入均接受KAS。输出在相关处同时包含KAS和sompi。

安全注意事项

• 私钥：切勿在日志或错误消息中暴露
• 助记词：仅通过环境变量传递
• 无磁盘存储：钱包不存储凭据
• 新建连接：每条命令均建立新的RPC连接
• 地址格式：验证Kaspa地址（kaspa:q...格式）

与传统钱包对比

路线图

• 地址的二维码生成
• 支付链接
• 交易历史
• 多地址支持
• 批量支付
• Telegram机器人集成

资源

• Kaspa文档
• Kaspa浏览器
• kaspa-py SDK