minimal-xec-wallet 1.0.1

package/examples/tokens/get-token-info.js

@@ -0,0 +1,269 @@
+/*
+  Get comprehensive token information using the main wallet API
+  Demonstrates detailed metadata retrieval with automatic protocol detection
+*/
+
+const MinimalXECWallet = require('../../index')
+const WalletHelper = require('../utils/wallet-helper')
+
+// Get command line arguments
+const args = process.argv.slice(2)
+
+function showUsage () {
+  console.log('Usage: node get-token-info.js <token_ticker_or_id>')
+  console.log('')
+  console.log('Examples:')
+  console.log('  node get-token-info.js FLCT')
+  console.log('  node get-token-info.js TGR')
+  console.log('  node get-token-info.js 5e40dda12765d0b3819286f4bd50ec58a4bf8d7dbfd277152693ad9d34912135')
+  console.log('')
+  console.log('Parameters:')
+  console.log('  token_ticker_or_id: Token ticker (FLCT, TGR) or full token ID')
+  console.log('')
+  console.log('✨ Features:')
+  console.log('   • Protocol (SLP/ALP) detected automatically')
+  console.log('   • Comprehensive token metadata')
+  console.log('   • Genesis information and timestamps')
+  console.log('   • Uses main wallet API for consistency')
+  console.log('   • Works with any token (even if not held in wallet)')
+}
+
+async function getTokenInfo () {
+  try {
+    console.log('📄 Get Token Information (Main Wallet API)...\n')
+
+    // Check arguments
+    if (args.length < 1) {
+      console.log('❌ Missing required arguments')
+      showUsage()
+      return
+    }
+
+    const tokenInput = args[0]
+
+    // Load wallet (for API access, not necessarily token holding)
+    const walletData = WalletHelper.loadWallet()
+    if (!walletData) {
+      console.log('❌ No wallet found')
+      console.log('   Run: node examples/wallet-creation/create-new-wallet.js')
+      return
+    }
+
+    console.log('✅ Wallet loaded:')
+    console.log(`   Address: ${walletData.xecAddress}`)
+    console.log('')
+
+    // Initialize main wallet (Step 1 integration)
+    console.log('🔧 Initializing wallet...')
+    const wallet = new MinimalXECWallet(walletData.mnemonic)
+
+    // Wait for wallet creation and initialization
+    await wallet.walletInfoPromise
+    await wallet.initialize()
+
+    console.log('✅ Wallet initialized successfully!')
+    console.log('')
+
+    // First, try to find token by listing wallet tokens
+    console.log('📦 Searching for token...')
+    const tokens = await wallet.listETokens()
+
+    // Find the token by ticker or ID
+    let selectedToken = null
+    let tokenId = null
+
+    // Try to match by ticker first (case-insensitive)
+    selectedToken = tokens.find(t =>
+      t.ticker.toLowerCase() === tokenInput.toLowerCase()
+    )
+
+    // If not found, try to match by token ID
+    if (!selectedToken) {
+      selectedToken = tokens.find(t => t.tokenId === tokenInput)
+    }
+
+    // If found in wallet tokens, use that info
+    if (selectedToken) {
+      tokenId = selectedToken.tokenId
+      console.log(`✅ Found token in wallet: ${selectedToken.ticker} (${selectedToken.protocol})`)
+    } else {
+      // If not found in wallet, assume it's a token ID
+      tokenId = tokenInput
+      console.log(`🔍 Token not found in wallet, trying as token ID: ${tokenId.substring(0, 12)}...`)
+    }
+
+    // Get comprehensive token data using main wallet API
+    console.log('\n📄 Getting comprehensive token information...')
+    const tokenData = await wallet.getETokenData(tokenId)
+
+    console.log('')
+    console.log('🎯 COMPREHENSIVE TOKEN INFORMATION:')
+    console.log('═'.repeat(70))
+
+    // Basic Information
+    console.log('📋 Basic Information:')
+    console.log(`   Token ID: ${tokenData.tokenId}`)
+    console.log(`   Ticker: ${tokenData.ticker}`)
+    console.log(`   Name: ${tokenData.name}`)
+    console.log(`   Protocol: ${tokenData.protocol}`)
+    console.log(`   Type: ${tokenData.type}`)
+    console.log(`   Decimals: ${tokenData.decimals}`)
+
+    // Links and Resources
+    if (tokenData.url) {
+      console.log('')
+      console.log('🔗 Links and Resources:')
+      console.log(`   URL: ${tokenData.url}`)
+
+      // Provide context about URLs
+      if (tokenData.url.startsWith('ipfs://')) {
+        console.log('   Format: IPFS (decentralized storage)')
+        console.log(`   Gateway: https://ipfs.io/ipfs/${tokenData.url.substring(7)}`)
+      } else if (tokenData.url.startsWith('http')) {
+        console.log('   Format: HTTP(S) web link')
+      } else {
+        console.log('   Format: Custom URL format')
+      }
+    }
+
+    // Additional Data
+    if (tokenData.data) {
+      console.log('')
+      console.log('💾 Additional Data:')
+      console.log(`   Data: ${tokenData.data}`)
+
+      // Try to decode if it looks like hex
+      try {
+        if (tokenData.data.startsWith('0x') || tokenData.data.length % 2 === 0) {
+          const decoded = Buffer.from(tokenData.data.replace('0x', ''), 'hex').toString('utf8')
+          if (decoded.length > 0 && decoded.length < 100) {
+            console.log(`   Decoded: ${decoded}`)
+          }
+        }
+      } catch (err) {
+        // Ignore decode errors
+      }
+    }
+
+    // Authority Information
+    if (tokenData.authPubkey) {
+      console.log('')
+      console.log('🔐 Authority Information:')
+      console.log(`   Authority Pubkey: ${tokenData.authPubkey}`)
+      console.log('   Mint Authority: Present (can create more tokens)')
+    } else {
+      console.log('')
+      console.log('🔐 Authority Information:')
+      console.log('   Mint Authority: None (fixed supply token)')
+    }
+
+    // Timestamps
+    if (tokenData.timeFirstSeen) {
+      console.log('')
+      console.log('📅 Timeline:')
+      const firstSeen = new Date(tokenData.timeFirstSeen * 1000)
+      console.log(`   First Seen: ${firstSeen.toLocaleString()}`)
+      console.log(`   First Seen (UTC): ${firstSeen.toISOString()}`)
+
+      const daysSince = Math.floor((Date.now() - firstSeen.getTime()) / (1000 * 60 * 60 * 24))
+      console.log(`   Age: ${daysSince} day(s) old`)
+    }
+
+    // Protocol-Specific Details
+    console.log('')
+    console.log(`📊 ${tokenData.protocol} Protocol Details:`)
+
+    if (tokenData.protocol === 'SLP') {
+      console.log('   Standard: Simple Ledger Protocol')
+      console.log('   Version: SLP v1')
+      console.log('   Consensus: Bitcoin Cash script validation')
+      console.log('   UTXO Model: Token amount stored in UTXO')
+    } else if (tokenData.protocol === 'ALP') {
+      console.log('   Standard: A Ledger Protocol')
+      console.log('   Version: ALP v1')
+      console.log('   Consensus: Native Bitcoin Cash consensus')
+      console.log('   UTXO Model: Atom-based precision')
+      console.log('   Script Type: eMPP (enhanced Memo Push Protocol)')
+    }
+
+    // Get balance if wallet holds this token
+    if (selectedToken) {
+      console.log('')
+      console.log('💰 Your Wallet Balance:')
+      console.log(`   Balance: ${selectedToken.balance.display} ${selectedToken.ticker}`)
+      console.log(`   Raw Atoms: ${selectedToken.balance.atoms}`)
+      console.log(`   UTXOs: ${selectedToken.utxoCount}`)
+
+      if (selectedToken.balance.display > 0) {
+        console.log('')
+        console.log('💡 Available Actions:')
+        console.log(`   • Send: node examples/tokens/send-any-token.js ${selectedToken.ticker} <address> <amount>`)
+        console.log(`   • Burn: node examples/tokens/burn-tokens.js ${selectedToken.ticker} <amount>`)
+        console.log(`   • Balance: node examples/tokens/get-token-balance.js ${selectedToken.ticker}`)
+      }
+    } else {
+      console.log('')
+      console.log('💰 Your Wallet Balance:')
+      console.log('   Balance: 0 (you do not hold this token)')
+      console.log('')
+      console.log('💡 How to get this token:')
+      console.log('   • Visit eCash token faucets')
+      console.log('   • Use decentralized exchanges (DEX)')
+      console.log('   • Receive from other wallets')
+      console.log('   • Purchase on supported exchanges')
+    }
+
+    // Explorer Links
+    console.log('')
+    console.log('🔗 Blockchain Explorer:')
+    console.log(`   Token: https://explorer.e.cash/token/${tokenData.tokenId}`)
+    console.log('   View transactions, holders, and statistics')
+
+    // Additional Resources
+    console.log('')
+    console.log('📚 Additional Resources:')
+    if (tokenData.protocol === 'SLP') {
+      console.log('   • SLP Specification: https://slp.dev/')
+      console.log('   • SLP Token Registry: https://tokens.bch.sx/')
+    } else if (tokenData.protocol === 'ALP') {
+      console.log('   • ALP Specification: https://ecashbuilders.notion.site/')
+      console.log('   • eCash Documentation: https://docs.e.cash/')
+    }
+    console.log('   • eCash Explorer: https://explorer.e.cash/')
+    console.log('   • Chronik API: https://chronik.e.cash/')
+  } catch (err) {
+    console.error('\n❌ Failed to get token information:', err.message)
+
+    // Provide context-specific help based on error type
+    if (err.message.includes('Token ID is required')) {
+      console.log('\n🎯 Token ID Issue:')
+      console.log('   • Provide a valid token ticker or full token ID')
+      console.log('   • Check available tokens: node examples/tokens/list-all-tokens.js')
+    } else if (err.message.includes('not found') || err.message.includes('Invalid token ID')) {
+      console.log('\n🔍 Token Not Found:')
+      console.log('   • Verify token ticker or ID is correct')
+      console.log('   • Token may not exist on this network')
+      console.log('   • Check token ID format (64-character hex string)')
+      console.log('   • Try browsing tokens: https://explorer.e.cash/tokens')
+    } else if (err.message.includes('network') || err.message.includes('chronik')) {
+      console.log('\n🌐 Network Issue:')
+      console.log('   • Check internet connection')
+      console.log('   • Chronik API may be temporarily unavailable')
+      console.log('   • Try again in a few moments')
+    } else {
+      console.log('\n🔧 General Error:')
+      console.log('   • Check wallet is properly initialized')
+      console.log('   • Verify token exists on the network')
+      console.log('   • Try with a known token like FLCT or TGR')
+    }
+
+    console.log('\nFor debugging, try:')
+    console.log('   node examples/tokens/list-all-tokens.js')
+    console.log('   node examples/tokens/get-token-balance.js FLCT')
+
+    process.exit(1)
+  }
+}
+
+// Run the token info fetcher
+getTokenInfo()

package/examples/tokens/list-all-tokens.js

@@ -0,0 +1,162 @@
+/*
+  List all tokens (SLP and ALP) in the wallet using the main wallet API
+  Demonstrates the unified eToken interface with automatic protocol detection
+*/
+
+const MinimalXECWallet = require('../../index')
+const WalletHelper = require('../utils/wallet-helper')
+
+async function listAllTokens () {
+  try {
+    console.log('🪙 Listing All Tokens (SLP + ALP) - Main Wallet API...\n')
+
+    // Load wallet
+    const walletData = WalletHelper.loadWallet()
+    if (!walletData) {
+      console.log('❌ No wallet found')
+      console.log('   Run: node examples/wallet-creation/create-new-wallet.js')
+      return
+    }
+
+    console.log('✅ Wallet loaded:')
+    console.log(`   Address: ${walletData.xecAddress}`)
+    console.log('')
+
+    // Initialize main wallet (Step 1 integration)
+    console.log('🔧 Initializing wallet...')
+    const wallet = new MinimalXECWallet(walletData.mnemonic)
+
+    // Wait for wallet creation and initialization
+    await wallet.walletInfoPromise
+    await wallet.initialize()
+
+    console.log('✅ Wallet initialized successfully!')
+    console.log('')
+
+    // Get all tokens using main wallet API
+    console.log('📦 Scanning wallet for tokens...')
+    const tokens = await wallet.listETokens()
+
+    if (tokens.length === 0) {
+      console.log('ℹ️  No tokens found in wallet')
+
+      // Still show XEC balance
+      const xecBalance = await wallet.getXecBalance()
+      console.log('')
+      console.log('💰 Wallet Summary:')
+      console.log('═'.repeat(40))
+      console.log(`XEC Balance: ${xecBalance.toLocaleString()} XEC`)
+      console.log('Token Balance: 0 tokens')
+
+      console.log('\n💡 Get some tokens:')
+      console.log('   • Visit eCash faucets for test tokens')
+      console.log('   • Use DEX to trade for tokens')
+      console.log('   • Receive tokens from other wallets')
+      return
+    }
+
+    console.log(`🎯 Found ${tokens.length} token type(s):\n`)
+
+    // Display each token with full details
+    for (let i = 0; i < tokens.length; i++) {
+      const token = tokens[i]
+
+      console.log(`Token ${i + 1}: ${token.protocol} Protocol`)
+      console.log('═'.repeat(60))
+      console.log(`Token ID: ${token.tokenId}`)
+      console.log(`Ticker: ${token.ticker}`)
+      console.log(`Name: ${token.name}`)
+      console.log(`Protocol: ${token.protocol}`)
+      console.log(`Decimals: ${token.decimals}`)
+
+      if (token.url) {
+        console.log(`URL: ${token.url}`)
+      }
+
+      console.log('')
+      console.log('💰 Balance Information:')
+      console.log(`  Display Balance: ${token.balance.display.toLocaleString()} ${token.ticker}`)
+      console.log(`  Raw Atoms: ${token.balance.atoms}`)
+      console.log(`  UTXOs: ${token.utxoCount}`)
+      console.log('')
+
+      // Show UTXO details if available
+      if (token.utxos && token.utxos.length > 0) {
+        console.log('📦 UTXO Details:')
+        for (let j = 0; j < token.utxos.length; j++) {
+          const utxo = token.utxos[j]
+          console.log(`  UTXO ${j + 1}: ${utxo.outpoint.txid}:${utxo.outpoint.outIdx}`)
+          console.log(`    Block: ${utxo.blockHeight === -1 ? 'Mempool' : utxo.blockHeight}`)
+          console.log(`    Sats: ${utxo.sats} (dust)`)
+          console.log(`    Atoms: ${utxo.token.atoms}`)
+        }
+      }
+
+      if (i < tokens.length - 1) {
+        console.log('\n' + '─'.repeat(60) + '\n')
+      }
+    }
+
+    // Get XEC balance and show comprehensive wallet summary
+    const xecBalance = await wallet.getXecBalance()
+    const utxos = await wallet.getUtxos()
+
+    console.log('\n📊 WALLET SUMMARY:')
+    console.log('═'.repeat(50))
+    console.log(`XEC Balance: ${xecBalance.toLocaleString()} XEC`)
+    console.log(`Total UTXOs: ${utxos.utxos.length}`)
+    console.log(`Token Types: ${tokens.length}`)
+
+    // Breakdown by protocol
+    const slpTokens = tokens.filter(t => t.protocol === 'SLP')
+    const alpTokens = tokens.filter(t => t.protocol === 'ALP')
+
+    if (slpTokens.length > 0) {
+      console.log(`SLP Tokens: ${slpTokens.length} types`)
+      slpTokens.forEach(token => {
+        console.log(`  • ${token.ticker}: ${token.balance.display} ${token.ticker}`)
+      })
+    }
+
+    if (alpTokens.length > 0) {
+      console.log(`ALP Tokens: ${alpTokens.length} types`)
+      alpTokens.forEach(token => {
+        console.log(`  • ${token.ticker}: ${token.balance.display} ${token.ticker}`)
+      })
+    }
+
+    const isMultiProtocol = slpTokens.length > 0 && alpTokens.length > 0
+    console.log(`Multi-Protocol Wallet: ${isMultiProtocol ? 'Yes' : 'No'}`)
+
+    console.log('\n💡 Available Operations:')
+    console.log('   • Send tokens: node examples/tokens/send-any-token.js <ticker> <address> <amount>')
+    console.log('   • Get token balance: node examples/tokens/get-token-balance.js <ticker>')
+    console.log('   • Get token info: node examples/tokens/get-token-info.js <ticker>')
+    console.log('   • Burn tokens: node examples/tokens/burn-tokens.js <ticker> <amount>')
+  } catch (err) {
+    console.error('❌ Failed to list tokens:', err.message)
+
+    // Provide helpful debugging information
+    if (err.message.includes('wallet not initialized')) {
+      console.log('\n🔧 Wallet initialization issue:')
+      console.log('   • Check wallet.json exists')
+      console.log('   • Verify mnemonic is valid')
+      console.log('   • Try re-creating wallet')
+    } else if (err.message.includes('network') || err.message.includes('chronik')) {
+      console.log('\n🌐 Network issue:')
+      console.log('   • Check internet connection')
+      console.log('   • Chronik API may be temporarily unavailable')
+      console.log('   • Try again in a few moments')
+    } else {
+      console.log('\n📍 Error details:')
+      if (err.stack) {
+        console.error('Stack trace:', err.stack)
+      }
+    }
+
+    process.exit(1)
+  }
+}
+
+// Run the token listing
+listAllTokens()

package/examples/tokens/send-any-token.js

@@ -0,0 +1,260 @@
+/*
+  Send any token (SLP or ALP) using the main wallet API
+  Demonstrates automatic protocol detection and unified token sending interface
+*/
+
+const MinimalXECWallet = require('../../index')
+const WalletHelper = require('../utils/wallet-helper')
+
+// Get command line arguments
+const args = process.argv.slice(2)
+
+function showUsage () {
+  console.log('Usage: node send-any-token.js <token_ticker_or_id> <recipient> <amount>')
+  console.log('')
+  console.log('Examples:')
+  console.log('  node send-any-token.js FLCT ecash:qpcskwl402g5stqxy26js0j3mx5v54xqtssp0v7kkr 2')
+  console.log('  node send-any-token.js TGR etoken:qpcskwl402g5stqxy26js0j3mx5v54xqtssp0v7kkr 3')
+  console.log('  node send-any-token.js 5e40dda12765...912135 ecash:qpcskwl402g5stqxy26js0j3mx5v54xqtssp0v7kkr 1')
+  console.log('')
+  console.log('Parameters:')
+  console.log('  token_ticker_or_id: Token ticker (FLCT, TGR) or full token ID')
+  console.log('  recipient: eCash address (ecash: or etoken: format)')
+  console.log('  amount: Amount to send (in display units)')
+  console.log('')
+  console.log('✨ Features:')
+  console.log('   • Protocol (SLP/ALP) detected automatically')
+  console.log('   • Uses main wallet API for consistency')
+  console.log('   • Unified error handling and validation')
+}
+
+async function sendAnyToken () {
+  try {
+    console.log('🚀 Sending Token (Main Wallet API)...\n')
+
+    // Check arguments
+    if (args.length < 3) {
+      console.log('❌ Missing required arguments')
+      showUsage()
+      return
+    }
+
+    const tokenInput = args[0]
+    const recipient = args[1]
+    const amount = parseFloat(args[2])
+
+    // Validate amount
+    if (isNaN(amount) || amount <= 0) {
+      console.log('❌ Invalid amount. Must be a positive number')
+      showUsage()
+      return
+    }
+
+    // Load wallet
+    const walletData = WalletHelper.loadWallet()
+    if (!walletData) {
+      console.log('❌ No wallet found')
+      console.log('   Run: node examples/wallet-creation/create-new-wallet.js')
+      return
+    }
+
+    console.log('✅ Wallet loaded:')
+    console.log(`   Address: ${walletData.xecAddress}`)
+    console.log('')
+
+    // Initialize main wallet (Step 1 integration)
+    console.log('🔧 Initializing wallet...')
+    const wallet = new MinimalXECWallet(walletData.mnemonic)
+
+    // Wait for wallet creation and initialization
+    await wallet.walletInfoPromise
+    await wallet.initialize()
+
+    console.log('✅ Wallet initialized successfully!')
+    console.log('')
+
+    // Get available tokens using main wallet API
+    console.log('📦 Loading available tokens...')
+    const tokens = await wallet.listETokens()
+
+    if (tokens.length === 0) {
+      console.log('❌ No tokens found in wallet')
+      console.log('')
+      console.log('💡 Get some tokens:')
+      console.log('   • Visit eCash faucets for test tokens')
+      console.log('   • Use DEX to trade for tokens')
+      console.log('   • Receive tokens from other wallets')
+      return
+    }
+
+    console.log(`✅ Found ${tokens.length} token type(s):`)
+    for (const token of tokens) {
+      console.log(`   • ${token.ticker} (${token.protocol}): ${token.balance.display} ${token.ticker}`)
+    }
+    console.log('')
+
+    // Find the token to send
+    let selectedToken = null
+
+    // Try to match by ticker first (case-insensitive)
+    selectedToken = tokens.find(t =>
+      t.ticker.toLowerCase() === tokenInput.toLowerCase()
+    )
+
+    // If not found, try to match by token ID
+    if (!selectedToken) {
+      selectedToken = tokens.find(t => t.tokenId === tokenInput)
+    }
+
+    if (!selectedToken) {
+      console.log(`❌ Token "${tokenInput}" not found in wallet`)
+      console.log(`Available tokens: ${tokens.map(t => t.ticker).join(', ')}`)
+      return
+    }
+
+    console.log('🎯 Selected Token:')
+    console.log('═'.repeat(50))
+    console.log(`Ticker: ${selectedToken.ticker}`)
+    console.log(`Name: ${selectedToken.name}`)
+    console.log(`Protocol: ${selectedToken.protocol}`)
+    console.log(`Token ID: ${selectedToken.tokenId}`)
+    console.log(`Current Balance: ${selectedToken.balance.display} ${selectedToken.ticker}`)
+    console.log(`Decimals: ${selectedToken.decimals}`)
+    console.log('')
+
+    // Validate sufficient balance
+    if (selectedToken.balance.display < amount) {
+      console.log('❌ Insufficient token balance!')
+      console.log(`   Requested: ${amount} ${selectedToken.ticker}`)
+      console.log(`   Available: ${selectedToken.balance.display} ${selectedToken.ticker}`)
+      return
+    }
+
+    // Convert etoken: to ecash: format if needed
+    let recipientAddress = recipient
+    if (recipient.startsWith('etoken:')) {
+      recipientAddress = 'ecash:' + recipient.substring(7)
+    }
+
+    console.log(`📍 Recipient: ${recipientAddress}`)
+
+    // Get current XEC balance for fee check
+    const xecBalance = await wallet.getXecBalance()
+    console.log(`💰 XEC Available: ${xecBalance.toLocaleString()} XEC`)
+
+    if (xecBalance < 1) {
+      console.log('⚠️  Warning: Low XEC balance for transaction fees')
+    }
+
+    // Show transaction summary
+    console.log('\n📋 Transaction Summary:')
+    console.log('═'.repeat(50))
+    console.log(`Protocol: ${selectedToken.protocol}`)
+    console.log(`Token: ${selectedToken.ticker} (${selectedToken.name})`)
+    console.log(`From: ${walletData.xecAddress}`)
+    console.log(`To: ${recipientAddress}`)
+    console.log(`Amount: ${amount} ${selectedToken.ticker}`)
+    console.log(`Remaining: ${(selectedToken.balance.display - amount).toFixed(selectedToken.decimals)} ${selectedToken.ticker}`)
+    console.log('Estimated Fee: ~0.01 XEC')
+
+    // Confirm transaction
+    const readline = require('readline')
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+
+    const confirmed = await new Promise((resolve) => {
+      rl.question('\nDo you want to proceed with this token transfer? (yes/no): ', (answer) => {
+        rl.close()
+        resolve(answer.toLowerCase() === 'yes' || answer.toLowerCase() === 'y')
+      })
+    })
+
+    if (!confirmed) {
+      console.log('❌ Transaction cancelled by user')
+      return
+    }
+
+    console.log('\n🚀 Broadcasting token transaction...')
+    console.log(`   Protocol: ${selectedToken.protocol}`)
+    console.log('   Using main wallet API with automatic protocol routing')
+
+    // Prepare outputs for main wallet API
+    const outputs = [{
+      address: recipientAddress,
+      amount: amount
+    }]
+
+    // Send the tokens using main wallet API (Step 1 integration)
+    // The wallet will automatically:
+    // - Detect the protocol (SLP/ALP)
+    // - Route to appropriate handler
+    // - Handle UTXO selection
+    // - Build and broadcast transaction
+    const txid = await wallet.sendETokens(
+      selectedToken.tokenId,
+      outputs,
+      1.2 // sats per byte fee rate
+    )
+
+    console.log('\n✅ Token transaction sent successfully!')
+    console.log('═'.repeat(60))
+    console.log(`Transaction ID: ${txid}`)
+    console.log(`Protocol: ${selectedToken.protocol}`)
+    console.log(`Token: ${selectedToken.ticker}`)
+    console.log(`Amount: ${amount} ${selectedToken.ticker}`)
+    console.log(`To: ${recipientAddress}`)
+    console.log('═'.repeat(60))
+
+    console.log('\n🔗 View Transaction:')
+    console.log(`   Explorer: https://explorer.e.cash/tx/${txid}`)
+
+    console.log('\n💰 Updated Balances (estimated):')
+    console.log(`   ${selectedToken.ticker}: ${(selectedToken.balance.display - amount).toFixed(selectedToken.decimals)} ${selectedToken.ticker}`)
+    console.log(`   XEC: ~${(xecBalance - 0.01).toFixed(2)} XEC (minus fees)`)
+
+    console.log('\n💡 Next Steps:')
+    console.log('   • Check updated balance: node examples/tokens/list-all-tokens.js')
+    console.log('   • Send more tokens: node examples/tokens/send-any-token.js')
+    console.log('   • Get token info: node examples/tokens/get-token-info.js')
+  } catch (err) {
+    console.error('\n❌ Failed to send token:', err.message)
+
+    // Provide context-specific help based on error type
+    if (err.message.includes('Token ID is required')) {
+      console.log('\n🎯 Token Selection Issue:')
+      console.log('   • Verify token ticker or ID is correct')
+      console.log('   • Check available tokens: node examples/tokens/list-all-tokens.js')
+    } else if (err.message.includes('insufficient')) {
+      console.log('\n💸 Balance Issue:')
+      console.log('   • Check token balance is sufficient')
+      console.log('   • Ensure XEC available for fees')
+      console.log('   • Balance check: node examples/tokens/list-all-tokens.js')
+    } else if (err.message.includes('address') || err.message.includes('Invalid address')) {
+      console.log('\n📍 Address Issue:')
+      console.log('   • Verify recipient address format')
+      console.log('   • Use ecash: or etoken: format')
+      console.log('   • Example: ecash:qpcskwl402g5stqxy26js0j3mx5v54xqtssp0v7kkr')
+    } else if (err.message.includes('network') || err.message.includes('chronik')) {
+      console.log('\n🌐 Network Issue:')
+      console.log('   • Check internet connection')
+      console.log('   • Chronik API may be temporarily unavailable')
+      console.log('   • Try again in a few moments')
+    } else {
+      console.log('\n🔧 General Error:')
+      console.log('   • Check wallet is properly initialized')
+      console.log('   • Verify wallet has tokens and XEC for fees')
+      console.log('   • Try listing tokens first to debug')
+    }
+
+    console.log('\nFor debugging, run:')
+    console.log('   node examples/tokens/list-all-tokens.js')
+    console.log('   node examples/wallet-info/get-balance.js')
+
+    process.exit(1)
+  }
+}
+
+// Run the token sender
+sendAnyToken()