minimal-xec-wallet 1.0.1

package/examples/advanced/get-xec-price.js

@@ -0,0 +1,149 @@
+/*
+  Get the current XEC to USD exchange rate.
+  This example shows how to fetch pricing information for XEC.
+*/
+
+const MinimalXECWallet = require('../../index')
+const WalletHelper = require('../utils/wallet-helper')
+
+async function getXecPrice () {
+  try {
+    console.log('💱 Getting XEC price information...\n')
+
+    // Load wallet from file (optional - just for consistency)
+    const walletData = WalletHelper.loadWallet()
+
+    // Create wallet instance (we don't need wallet data for price queries)
+    const wallet = new MinimalXECWallet()
+    await wallet.walletInfoPromise
+
+    console.log('🔍 Fetching XEC price from exchange APIs...')
+
+    try {
+      // Get XEC/USD price
+      const xecUsdPrice = await wallet.getXecUsd()
+
+      console.log('\n💰 XEC Price Information:')
+      console.log('═'.repeat(50))
+      console.log(`XEC/USD: $${xecUsdPrice.toFixed(8)}`)
+      console.log(`1 USD: ${(1 / xecUsdPrice).toLocaleString()} XEC`)
+      console.log('═'.repeat(50))
+
+      // Calculate various amounts in USD
+      const commonAmounts = [100, 1000, 10000, 100000, 1000000]
+
+      console.log('\n📊 XEC to USD Conversion Table:')
+      console.log('─'.repeat(50))
+      console.log('XEC Amount          USD Value')
+      console.log('─'.repeat(50))
+
+      commonAmounts.forEach(xecAmount => {
+        const usdValue = xecAmount * xecUsdPrice
+        const xecFormatted = xecAmount.toLocaleString().padEnd(15)
+        const usdFormatted = `$${usdValue.toFixed(6)}`
+        console.log(`${xecFormatted}   ${usdFormatted}`)
+      })
+
+      // Show wallet value if wallet exists
+      if (walletData) {
+        console.log('\n🏦 Your Wallet Value:')
+        console.log('─'.repeat(50))
+
+        try {
+          const walletForPrice = new MinimalXECWallet(walletData.mnemonic || walletData.privateKey)
+          await walletForPrice.walletInfoPromise
+
+          const balance = await walletForPrice.getXecBalance()
+          const walletUsdValue = balance * xecUsdPrice
+
+          console.log(`XEC Balance: ${balance.toLocaleString()} XEC`)
+          console.log(`USD Value: $${walletUsdValue.toFixed(6)} USD`)
+
+          if (walletUsdValue > 0) {
+            console.log('\n💡 Value Breakdown:')
+            console.log(`• Your ${balance.toLocaleString()} XEC is worth $${walletUsdValue.toFixed(6)}`)
+            console.log(`• At current rate of $${xecUsdPrice.toFixed(8)} per XEC`)
+          }
+        } catch (err) {
+          console.log('(Unable to fetch wallet balance for price calculation)')
+        }
+      }
+
+      // Market insights
+      console.log('\n📈 Market Insights:')
+      console.log('─'.repeat(50))
+
+      // Calculate market cap implications (approximate)
+      const totalSupply = 21000000000000 // 21 trillion XEC (approximate)
+      const marketCap = totalSupply * xecUsdPrice
+
+      console.log(`Estimated Market Cap: $${(marketCap / 1000000).toFixed(2)}M USD`)
+      console.log(`Price per Million XEC: $${(xecUsdPrice * 1000000).toFixed(2)}`)
+      console.log(`Price per Billion XEC: $${(xecUsdPrice * 1000000000).toFixed(2)}`)
+
+      // Historical context note
+      console.log('\n📝 Price Notes:')
+      console.log('• XEC prices are highly volatile')
+      console.log('• This is real-time data from available APIs')
+      console.log('• Prices may vary between exchanges')
+      console.log('• Use for informational purposes only')
+      console.log('• Not financial advice')
+
+      // Exchange information
+      console.log('\n🏪 Where to Trade XEC:')
+      console.log('• Binance (XEC/USDT, XEC/BTC)')
+      console.log('• KuCoin (XEC/USDT)')
+      console.log('• Gate.io (XEC/USDT)')
+      console.log('• OKX (XEC/USDT)')
+      console.log('• Bitfinex (XEC/USD)')
+      console.log('• Check CoinGecko/CoinMarketCap for full list')
+    } catch (priceErr) {
+      console.log('\n❌ Price API Error:', priceErr.message)
+      console.log('\n💡 Price API Issues:')
+      console.log('   • Price APIs may be temporarily unavailable')
+      console.log('   • Network connectivity issues')
+      console.log('   • API rate limiting')
+      console.log('')
+      console.log('   Alternative price sources:')
+      console.log('   • CoinGecko: https://coingecko.com/en/coins/ecash')
+      console.log('   • CoinMarketCap: https://coinmarketcap.com/currencies/ecash/')
+      console.log('   • Exchange websites directly')
+    }
+
+    // Additional resources
+    console.log('\n🔗 Useful Resources:')
+    console.log('• eCash Website: https://e.cash')
+    console.log('• Price Charts: https://coinmarketcap.com/currencies/ecash/')
+    console.log('• Market Data: https://coingecko.com/en/coins/ecash')
+    console.log('• Exchange List: https://coinmarketcap.com/currencies/ecash/markets/')
+
+    console.log('\n📱 Mobile Apps:')
+    console.log('• CoinMarketCap app')
+    console.log('• CoinGecko app')
+    console.log('• Exchange apps (Binance, KuCoin, etc.)')
+  } catch (err) {
+    console.error('❌ Failed to get XEC price:', err.message)
+
+    // Provide helpful error context
+    if (err.message.includes('network') || err.message.includes('connection')) {
+      console.log('\n🌐 Network Error:')
+      console.log('   • Check your internet connection')
+      console.log('   • Price APIs might be temporarily unavailable')
+      console.log('   • Try again in a few moments')
+      console.log('')
+      console.log('   Manual price check:')
+      console.log('   • Visit https://coinmarketcap.com/currencies/ecash/')
+      console.log('   • Or https://coingecko.com/en/coins/ecash')
+    } else if (err.message.includes('api') || err.message.includes('rate')) {
+      console.log('\n🚫 API Error:')
+      console.log('   • Price API might be rate-limited')
+      console.log('   • API service might be down')
+      console.log('   • Try alternative price sources')
+    }
+
+    process.exit(1)
+  }
+}
+
+// Run the example
+getXecPrice()

package/examples/advanced/optimize-utxos.js

@@ -0,0 +1,255 @@
+/*
+  Optimize wallet UTXOs by consolidating them.
+  This example shows how to reduce the number of UTXOs to lower future transaction fees.
+*/
+
+const MinimalXECWallet = require('../../index')
+const WalletHelper = require('../utils/wallet-helper')
+
+// Get command line arguments
+const args = process.argv.slice(2)
+const dryRun = args.includes('--dry-run') || args.includes('-n')
+
+function showUsage () {
+  console.log('Usage: node optimize-utxos.js [--dry-run]')
+  console.log('')
+  console.log('Options:')
+  console.log('  --dry-run, -n    Show optimization plan without executing')
+  console.log('')
+  console.log('Examples:')
+  console.log('  node optimize-utxos.js --dry-run    # Preview optimization')
+  console.log('  node optimize-utxos.js              # Execute optimization')
+  console.log('')
+  console.log('Purpose:')
+  console.log('  • Consolidates multiple small UTXOs into fewer larger ones')
+  console.log('  • Reduces future transaction fees')
+  console.log('  • Improves wallet performance')
+  console.log('  • Cleans up "dust" outputs')
+}
+
+async function analyzeUtxos (wallet) {
+  console.log('🔍 Analyzing wallet UTXOs...')
+
+  const utxoData = await wallet.getUtxos()
+  const utxos = utxoData.utxos || []
+  const spendableUtxos = utxos.filter(utxo => utxo.blockHeight !== -1)
+
+  if (spendableUtxos.length === 0) {
+    console.log('\n💸 No spendable UTXOs found!')
+    console.log('   Your wallet has no confirmed UTXOs to optimize.')
+    return null
+  }
+
+  // Calculate statistics
+  const totalValue = spendableUtxos.reduce((sum, utxo) => sum + utxo.value, 0)
+  const averageValue = totalValue / spendableUtxos.length
+  const values = spendableUtxos.map(utxo => utxo.value).sort((a, b) => a - b)
+  const medianValue = values[Math.floor(values.length / 2)]
+
+  // Categorize UTXOs
+  const dustUtxos = spendableUtxos.filter(utxo => utxo.value < 546) // < 5.46 XEC
+  const smallUtxos = spendableUtxos.filter(utxo => utxo.value >= 546 && utxo.value < 10000) // 5.46 - 100 XEC
+  const mediumUtxos = spendableUtxos.filter(utxo => utxo.value >= 10000 && utxo.value < 100000) // 100 - 1000 XEC
+  const largeUtxos = spendableUtxos.filter(utxo => utxo.value >= 100000) // > 1000 XEC
+
+  console.log('\n📊 UTXO Analysis:')
+  console.log('═'.repeat(60))
+  console.log(`Total UTXOs: ${spendableUtxos.length}`)
+  console.log(`Total Value: ${(totalValue / 100).toLocaleString()} XEC`)
+  console.log(`Average Size: ${(averageValue / 100).toLocaleString()} XEC`)
+  console.log(`Median Size: ${(medianValue / 100).toLocaleString()} XEC`)
+  console.log('═'.repeat(60))
+
+  console.log('\n🏷️  UTXO Categories:')
+  console.log(`Dust (< 5.46 XEC): ${dustUtxos.length} UTXOs`)
+  console.log(`Small (5.46 - 100 XEC): ${smallUtxos.length} UTXOs`)
+  console.log(`Medium (100 - 1000 XEC): ${mediumUtxos.length} UTXOs`)
+  console.log(`Large (> 1000 XEC): ${largeUtxos.length} UTXOs`)
+
+  // Calculate potential fee savings
+  const currentTxCost = spendableUtxos.length * 150 * 1.2 / 100 // 150 bytes per input * 1.2 sat/byte
+  const optimizedTxCost = Math.min(spendableUtxos.length, 5) * 150 * 1.2 / 100 // Assume max 5 UTXOs after optimization
+  const potentialSavings = currentTxCost - optimizedTxCost
+
+  console.log('\n💰 Fee Impact Analysis:')
+  console.log(`Current TX cost estimate: ${currentTxCost.toFixed(4)} XEC`)
+  console.log(`Optimized TX cost estimate: ${optimizedTxCost.toFixed(4)} XEC`)
+  console.log(`Potential savings per TX: ${potentialSavings.toFixed(4)} XEC`)
+
+  return {
+    total: spendableUtxos.length,
+    dust: dustUtxos.length,
+    small: smallUtxos.length,
+    medium: mediumUtxos.length,
+    large: largeUtxos.length,
+    totalValue,
+    needsOptimization: spendableUtxos.length > 10 || dustUtxos.length > 0
+  }
+}
+
+async function optimizeUtxos () {
+  try {
+    console.log('⚡ UTXO Optimization Tool\n')
+
+    if (dryRun) {
+      console.log('🔍 DRY RUN MODE - No transactions will be sent\n')
+    }
+
+    // Load wallet from file
+    const walletData = WalletHelper.loadWallet()
+    if (!walletData) {
+      console.log('   Run: node examples/wallet-creation/create-new-wallet.js')
+      return
+    }
+
+    // Create wallet instance from saved data
+    const wallet = new MinimalXECWallet(walletData.mnemonic || walletData.privateKey)
+    await wallet.walletInfoPromise
+
+    // Initialize wallet
+    await wallet.initialize()
+
+    console.log('💰 Checking wallet balance...')
+    const balance = await wallet.getXecBalance()
+
+    console.log('\n📋 Wallet Information:')
+    console.log('═'.repeat(60))
+    console.log(`Address: ${walletData.xecAddress}`)
+    console.log(`Balance: ${balance.toLocaleString()} XEC`)
+    console.log('═'.repeat(60))
+
+    // Analyze current UTXO state
+    const analysis = await analyzeUtxos(wallet)
+    if (!analysis) {
+      return
+    }
+
+    // Check if optimization is needed
+    if (!analysis.needsOptimization) {
+      console.log('\n✅ Your wallet is already optimized!')
+      console.log('   • You have a reasonable number of UTXOs')
+      console.log('   • No dust UTXOs detected')
+      console.log('   • Transaction fees should be minimal')
+      return
+    }
+
+    console.log('\n💡 Optimization Recommendations:')
+
+    if (analysis.dust > 0) {
+      console.log(`   • Consolidate ${analysis.dust} dust UTXOs (< 5.46 XEC)`)
+    }
+
+    if (analysis.total > 20) {
+      console.log(`   • Reduce UTXO count from ${analysis.total} to ~5-10`)
+    }
+
+    if (analysis.small > 10) {
+      console.log(`   • Combine ${analysis.small} small UTXOs`)
+    }
+
+    // In dry run mode, just show the plan
+    if (dryRun) {
+      console.log('\n📋 DRY RUN COMPLETE')
+      console.log('   Run without --dry-run to execute optimization')
+      console.log('   Estimated optimization fee: ~0.01-0.05 XEC')
+      return
+    }
+
+    // Confirm optimization
+    console.log('\n⚠️  UTXO Optimization Confirmation')
+    console.log('   This will consolidate your UTXOs to improve efficiency.')
+    console.log('   Benefits:')
+    console.log('   • Lower future transaction fees')
+    console.log('   • Faster transaction creation')
+    console.log('   • Cleaner wallet state')
+    console.log('')
+    console.log('   Cost:')
+    console.log('   • One-time consolidation fee (~0.01-0.05 XEC)')
+    console.log('   • UTXOs will be temporarily locked during confirmation')
+
+    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 optimize your UTXOs? (yes/no): ', (answer) => {
+        rl.close()
+        resolve(answer.toLowerCase() === 'yes' || answer.toLowerCase() === 'y')
+      })
+    })
+
+    if (!confirmed) {
+      console.log('❌ UTXO optimization cancelled by user')
+      return
+    }
+
+    console.log('\n🚀 Starting UTXO optimization...')
+
+    // Run the optimization
+    const result = await wallet.optimize(false) // false = not dry run
+
+    if (result && result.txid) {
+      console.log('\n✅ UTXO optimization completed successfully!')
+      console.log('═'.repeat(60))
+      console.log(`Transaction ID: ${result.txid}`)
+      console.log(`UTXOs consolidated: ${result.utxosConsolidated || 'Multiple'}`)
+      console.log(`Fee paid: ${result.fee ? (result.fee / 100).toLocaleString() + ' XEC' : 'Calculated automatically'}`)
+      console.log('═'.repeat(60))
+
+      // Show updated state
+      console.log('\n💰 Getting updated balance...')
+      await new Promise(resolve => setTimeout(resolve, 2000)) // Wait 2 seconds
+
+      const newBalance = await wallet.getXecBalance()
+      console.log(`New Balance: ${newBalance.toLocaleString()} XEC`)
+
+      console.log('\n🔗 View Transaction:')
+      console.log(`   Explorer: https://explorer.e.cash/tx/${result.txid}`)
+
+      console.log('\n📝 What happened:')
+      console.log('   • Multiple small UTXOs were combined into fewer larger ones')
+      console.log('   • Future transactions will require lower fees')
+      console.log('   • Your wallet is now more efficient')
+      console.log('   • Wait for confirmation before making new transactions')
+
+      console.log('\n⏱️  Next Steps:')
+      console.log('   • Wait 1-10 minutes for transaction confirmation')
+      console.log('   • Check new UTXO state: node examples/wallet-info/get-utxos.js')
+      console.log('   • Your wallet is now optimized for efficient transactions')
+    } else {
+      console.log('\n❌ UTXO optimization failed or was not needed')
+      console.log('   Possible reasons:')
+      console.log('   • UTXOs are already optimal')
+      console.log('   • Insufficient balance for optimization fee')
+      console.log('   • Network error during optimization')
+    }
+  } catch (err) {
+    console.error('❌ Failed to optimize UTXOs:', err.message)
+
+    // Provide helpful error context
+    if (err.message.includes('insufficient')) {
+      console.log('\n💸 Insufficient Funds:')
+      console.log('   • Your wallet needs enough XEC to pay consolidation fees')
+      console.log('   • Try optimizing when you have a larger balance')
+      console.log('   • Each consolidation transaction requires a small fee')
+    } else if (err.message.includes('network')) {
+      console.log('\n🌐 Network Error:')
+      console.log('   • Check your internet connection')
+      console.log('   • The network might be temporarily unavailable')
+      console.log('   • Try again in a few moments')
+    }
+
+    process.exit(1)
+  }
+}
+
+// Show usage if requested
+if (args.includes('--help') || args.includes('-h')) {
+  showUsage()
+  process.exit(0)
+}
+
+// Run the example
+optimizeUtxos()

package/examples/advanced/send-op-return.js

@@ -0,0 +1,216 @@
+/*
+  Send an OP_RETURN transaction with custom data.
+  This example shows how to embed data on the XEC blockchain.
+*/
+
+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-op-return.js <message> [xec_amount]')
+  console.log('')
+  console.log('Examples:')
+  console.log('  node send-op-return.js "Hello XEC blockchain!"')
+  console.log('  node send-op-return.js "Document hash: abc123..." 5.46')
+  console.log('  node send-op-return.js "Timestamp: 2024-01-01" 0')
+  console.log('')
+  console.log('Parameters:')
+  console.log('  message: Text to embed in the blockchain (max 220 bytes)')
+  console.log('  xec_amount: Optional XEC to send to yourself (default: 0)')
+  console.log('')
+  console.log('Note: OP_RETURN data is permanent and publicly visible!')
+}
+
+async function sendOpReturn () {
+  try {
+    console.log('📝 Sending OP_RETURN transaction...\n')
+
+    // Check arguments
+    if (args.length < 1) {
+      console.log('❌ No message provided')
+      showUsage()
+      return
+    }
+
+    const message = args[0]
+    const xecAmount = args.length > 1 ? parseFloat(args[1]) : 0
+
+    // Validate message
+    if (!message || message.length === 0) {
+      console.log('❌ Message cannot be empty')
+      showUsage()
+      return
+    }
+
+    if (message.length > 220) {
+      console.log('❌ Message too long. Maximum 220 characters allowed.')
+      console.log(`   Your message: ${message.length} characters`)
+      return
+    }
+
+    // Validate amount
+    if (isNaN(xecAmount) || xecAmount < 0) {
+      console.log('❌ Invalid XEC amount. Must be 0 or positive number')
+      showUsage()
+      return
+    }
+
+    // Load wallet from file
+    const walletData = WalletHelper.loadWallet()
+    if (!walletData) {
+      console.log('   Run: node examples/wallet-creation/create-new-wallet.js')
+      return
+    }
+
+    // Create wallet instance from saved data
+    const wallet = new MinimalXECWallet(walletData.mnemonic || walletData.privateKey)
+    await wallet.walletInfoPromise
+
+    // Initialize wallet
+    await wallet.initialize()
+
+    console.log('💰 Checking wallet balance...')
+    const balance = await wallet.getXecBalance()
+
+    console.log('\n📋 OP_RETURN Transaction Details:')
+    console.log('═'.repeat(60))
+    console.log(`From: ${walletData.xecAddress}`)
+    console.log(`Message: "${message}"`)
+    console.log(`Message Length: ${message.length} bytes`)
+    console.log(`XEC Amount: ${xecAmount.toLocaleString()} XEC`)
+    console.log(`Current Balance: ${balance.toLocaleString()} XEC`)
+    console.log('═'.repeat(60))
+
+    // Check balance
+    const estimatedFee = 0.01 // Rough estimate
+    const totalCost = xecAmount + estimatedFee
+
+    if (balance < totalCost) {
+      console.log('\n❌ Insufficient balance!')
+      console.log(`   Required: ~${totalCost.toLocaleString()} XEC (including estimated fee)`)
+      console.log(`   Available: ${balance.toLocaleString()} XEC`)
+      console.log('   Fund your wallet or reduce the XEC amount')
+      return
+    }
+
+    // Show what OP_RETURN means
+    console.log('\n📚 About OP_RETURN:')
+    console.log('   • OP_RETURN allows embedding data in blockchain transactions')
+    console.log('   • Data is permanent and publicly visible')
+    console.log('   • Useful for timestamps, document hashes, certificates')
+    console.log('   • Data cannot be spent (provably unspendable)')
+
+    // Encode message to hex
+    const messageHex = Buffer.from(message, 'utf8').toString('hex')
+    console.log(`\n🔗 Encoded Message: ${messageHex}`)
+
+    // Confirm transaction
+    console.log('\n⚠️  OP_RETURN Transaction Confirmation')
+    console.log('   This data will be permanently stored on the blockchain!')
+    console.log('   Make sure you want to make this information public.')
+
+    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? (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 OP_RETURN transaction...')
+
+    // Prepare XEC outputs (optional)
+    let xecOutputs = []
+    if (xecAmount > 0) {
+      xecOutputs = [{
+        address: walletData.xecAddress,
+        amountSat: Math.round(xecAmount * 100)
+      }]
+    }
+
+    // Send OP_RETURN transaction
+    const txid = await wallet.sendOpReturn(
+      message, // message
+      '6d02', // prefix (memo protocol)
+      xecOutputs, // optional XEC outputs
+      1.2 // sats per byte fee rate
+    )
+
+    console.log('\n✅ OP_RETURN transaction sent successfully!')
+    console.log('═'.repeat(60))
+    console.log(`Transaction ID: ${txid}`)
+    console.log(`Message: "${message}"`)
+    console.log(`Message Hex: ${messageHex}`)
+    console.log(`XEC Amount: ${xecAmount.toLocaleString()} XEC`)
+    console.log('═'.repeat(60))
+
+    // Get updated balance
+    console.log('\n💰 Getting updated balance...')
+    const newBalance = await wallet.getXecBalance()
+    const feePaid = balance - newBalance - xecAmount
+
+    console.log('\n📊 Transaction Summary:')
+    console.log(`Previous Balance: ${balance.toLocaleString()} XEC`)
+    console.log(`XEC Sent: ${xecAmount.toLocaleString()} XEC`)
+    console.log(`Fee Paid: ${feePaid.toLocaleString()} XEC`)
+    console.log(`New Balance: ${newBalance.toLocaleString()} XEC`)
+
+    console.log('\n🔗 View Transaction:')
+    console.log(`   Explorer: https://explorer.e.cash/tx/${txid}`)
+    console.log('   Note: Look for the OP_RETURN output in the transaction details')
+
+    console.log('\n📝 OP_RETURN Data Location:')
+    console.log('   • Your message is now permanently stored on the XEC blockchain')
+    console.log('   • Anyone can view it by examining the transaction')
+    console.log('   • The data is in the OP_RETURN output of the transaction')
+    console.log('   • Blockchain explorers will show the hex data')
+
+    console.log('\n💡 Use Cases for OP_RETURN:')
+    console.log('   • Document timestamping')
+    console.log('   • Certificate verification')
+    console.log('   • Digital signatures')
+    console.log('   • Public announcements')
+    console.log('   • Hash commitments')
+
+    // Ensure process exits cleanly
+    process.exit(0)
+  } catch (err) {
+    console.error('❌ Failed to send OP_RETURN:', err.message)
+
+    // Provide helpful error context
+    if (err.message.includes('insufficient')) {
+      console.log('\n💸 Insufficient Funds:')
+      console.log('   • Your wallet does not have enough XEC for this transaction')
+      console.log('   • OP_RETURN transactions still require fees')
+      console.log('   • Try reducing the XEC amount or fund your wallet')
+    } else if (err.message.includes('size') || err.message.includes('large')) {
+      console.log('\n📏 Size Error:')
+      console.log('   • Your message might be too large')
+      console.log('   • Try a shorter message')
+      console.log('   • Maximum recommended: 220 bytes')
+    } else if (err.message.includes('network')) {
+      console.log('\n🌐 Network Error:')
+      console.log('   • Check your internet connection')
+      console.log('   • The network might be temporarily unavailable')
+      console.log('   • Try again in a few moments')
+    }
+
+    process.exit(1)
+  }
+}
+
+// Run the example
+sendOpReturn()