Back to Details

wallet-send-bsv

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Wallet Send BSV

钱包发送BSV

Send BSV transactions using @bsv/sdk with WhatsOnChain API.
使用@bsv/sdk结合WhatsOnChain API发送BSV交易。

When to Use

使用场景

  • Send BSV to a recipient address
  • Create simple payment transactions
  • Transfer funds from a WIF private key
  • 向收款地址发送BSV
  • 创建简单支付交易
  • 从WIF私钥转出资金

Usage

使用方法

bash
bun run skills/wallet-send-bsv/scripts/send.ts <from-wif> <to-address> <amount-satoshis>
bash
bun run skills/wallet-send-bsv/scripts/send.ts <from-wif> <to-address> <amount-satoshis>

Show help

查看帮助

bun run skills/wallet-send-bsv/scripts/send.ts --help
bun run skills/wallet-send-bsv/scripts/send.ts --help

Example: Send 1000 satoshis

示例：发送1000聪

bun run skills/wallet-send-bsv/scripts/send.ts L1abc... 1BvBMSEY... 1000
undefined
bun run skills/wallet-send-bsv/scripts/send.ts L1abc... 1BvBMSEY... 1000
undefined

Arguments

参数说明

ArgumentDescription
from-wif
Private key in WIF format (starts with K, L, or 5)
to-address
Recipient BSV address (starts with 1 or 3)
amount-satoshis
Amount to send (1 BSV = 100,000,000 satoshis)
参数描述
from-wif
WIF格式的私钥（以K、L或5开头）
to-address
BSV收款地址（以1或3开头）
amount-satoshis
转账金额（1 BSV = 100,000,000 聪）

Dependencies

依赖项

  • @bsv/sdk
    - BSV SDK for key/transaction operations
  • WhatsOnChain API - UTXO fetching and broadcast
  • @bsv/sdk
    - 用于密钥/交易操作的BSV SDK
  • WhatsOnChain API - 用于UTXO获取和交易广播

Transaction Flow

交易流程

  1. Parse and validate WIF private key
  2. Validate recipient address format
  3. Derive sender address from private key
  4. Fetch UTXOs from WhatsOnChain
  5. Build transaction with P2PKH inputs/outputs
  6. Calculate fee (1 sat/byte)
  7. Sign transaction
  8. Broadcast via WhatsOnChain API
  1. 解析并验证WIF私钥
  2. 验证收款地址格式
  3. 从私钥推导出发送方地址
  4. 从WhatsOnChain获取UTXO
  5. 构建包含P2PKH输入/输出的交易
  6. 计算手续费（1聪/字节）
  7. 签名交易
  8. 通过WhatsOnChain API广播交易

Error Handling

错误处理

  • Invalid WIF: Clear error with SDK message
  • Invalid address: Format validation error
  • Insufficient funds: Shows balance vs required amount
  • Network errors: Displays raw tx hex for manual broadcast
  • 无效WIF：显示SDK返回的明确错误信息
  • 无效地址：格式验证错误
  • 资金不足：显示账户余额与所需金额对比
  • 网络错误：显示原始交易十六进制，支持手动广播

Network

网络环境

Uses BSV mainnet via WhatsOnChain API:
  • UTXOs: 
    GET /v1/bsv/main/address/{address}/unspent
  • Broadcast: 
    POST /v1/bsv/main/tx/raw
通过WhatsOnChain API使用BSV主网：
  • UTXOs: 
    GET /v1/bsv/main/address/{address}/unspent
  • 交易广播: 
    POST /v1/bsv/main/tx/raw