smartledger-bsv 3.0.0 → 3.0.2

package/utilities/transaction-examples.js

@@ -0,0 +1,328 @@
+#!/usr/bin/env node
+
+/**
+ * 🔄 BSV Transaction Examples
+ * 
+ * Demonstrates the complete transaction flow:
+ * 1. Create transaction
+ * 2. Broadcast to miner
+ * 3. Miner validates and processes
+ * 4. UTXO set updates
+ */
+
+const bsv = require('../index.js');
+const fs = require('fs');
+const path = require('path');
+
+// Import our utilities
+const { 
+  loadBlockchainState, 
+  importWalletFromFile,
+  getBlockchainStats 
+} = require('./blockchain-state');
+const { 
+  acceptTransaction, 
+  getMempoolStatus 
+} = require('./miner-simulator');
+const {
+  loadConfig,
+  updateUTXOFromTransaction
+} = require('./utxo-manager');
+
+/**
+ * Initialize the blockchain with our test wallet
+ */
+async function initializeBlockchain() {
+  console.log('🚀 Initializing blockchain with test wallet...\n');
+  
+  // Import wallet from wallet.json into blockchain state
+  const imported = importWalletFromFile();
+  
+  if (!imported) {
+    console.log('❌ Failed to import wallet. Run wallet-setup.js first!');
+    return false;
+  }
+  
+  console.log('');
+  getBlockchainStats();
+  return true;
+}
+
+/**
+ * Create a simple P2PKH transaction
+ */
+function createSimpleTransaction(fromAddress, toAddress, amount, privateKey, utxo) {
+  console.log(`\n💸 Creating P2PKH transaction:`);
+  console.log(`From: ${fromAddress}`);
+  console.log(`To: ${toAddress}`);
+  console.log(`Amount: ${amount} satoshis\n`);
+  
+  try {
+    // Create transaction with proper SIGHASH_FORKID
+    const tx = new bsv.Transaction()
+      .from(utxo)
+      .to(toAddress, amount)
+      .change(fromAddress)
+      .fee(1000) // 1000 sat fee
+      .sign(privateKey, bsv.crypto.Signature.SIGHASH_ALL | bsv.crypto.Signature.SIGHASH_FORKID);
+    
+    console.log(`✅ Transaction created: ${tx.id}`);
+    console.log(`Inputs: ${tx.inputs.length}`);
+    console.log(`Outputs: ${tx.outputs.length}`);
+    console.log(`Fee: ${tx.getFee()} satoshis\n`);
+    
+    return tx;
+  } catch (error) {
+    console.error('❌ Error creating transaction:', error.message);
+    return null;
+  }
+}
+
+/**
+ * Example 1: Simple P2PKH payment
+ */
+async function exampleSimplePayment() {
+  console.log('\n' + '='.repeat(80));
+  console.log('📝 EXAMPLE 1: Simple P2PKH Payment');
+  console.log('='.repeat(80));
+  
+  // Load wallet config
+  const config = loadConfig();
+  const wallet = config.wallet;
+  
+  // Create recipient address (just generate a new one for demo)
+  const recipientKey = new bsv.PrivateKey();
+  const recipientAddress = recipientKey.toAddress().toString();
+  
+  console.log(`👛 Sender: ${wallet.address}`);
+  console.log(`🎯 Recipient: ${recipientAddress}`);
+  
+  // Use the primary UTXO
+  const utxo = config.utxo;
+  console.log(`💰 Using UTXO: ${utxo.txid}:${utxo.vout} (${utxo.satoshis} sats)`);
+  
+  // Create transaction (send 15,000 sats)
+  const amount = 15000;
+  const tx = createSimpleTransaction(
+    wallet.address,
+    recipientAddress,
+    amount,
+    bsv.PrivateKey.fromWIF(wallet.privateKeyWIF),
+    utxo
+  );
+  
+  if (!tx) {
+    console.log('❌ Failed to create transaction');
+    return;
+  }
+  
+  // Broadcast to miner
+  console.log('📡 Broadcasting transaction to miner...');
+  const result = acceptTransaction(tx);
+  
+  if (result.accepted) {
+    console.log('\n🎉 Transaction accepted and processed!');
+    
+    // Update local wallet
+    updateUTXOFromTransaction(tx, utxo);
+    
+    console.log('\n📊 Updated blockchain state:');
+    getBlockchainStats();
+  } else {
+    console.log('\n❌ Transaction rejected by miner');
+    console.log('Errors:', result.errors);
+  }
+}
+
+/**
+ * Example 2: Chain multiple transactions
+ */
+async function exampleTransactionChain() {
+  console.log('\n' + '='.repeat(80));
+  console.log('🔗 EXAMPLE 2: Transaction Chain');
+  console.log('='.repeat(80));
+  
+  const config = loadConfig();
+  const wallet = config.wallet;
+  
+  // Find an available UTXO for the second transaction
+  const availableUTXOs = config.availableUTXOs || [];
+  
+  if (availableUTXOs.length === 0) {
+    console.log('❌ No available UTXOs for chaining. Run example 1 first.');
+    return;
+  }
+  
+  // Use the first available UTXO
+  const utxo = availableUTXOs[0];
+  console.log(`💰 Using UTXO: ${utxo.txid}:${utxo.vout} (${utxo.satoshis} sats)`);
+  
+  // Create another recipient
+  const recipientKey = new bsv.PrivateKey();
+  const recipientAddress = recipientKey.toAddress().toString();
+  
+  console.log(`👛 Sender: ${wallet.address}`);
+  console.log(`🎯 Recipient: ${recipientAddress}`);
+  
+  // Create second transaction
+  const amount = Math.min(5000, utxo.satoshis - 1000); // Leave room for fee
+  const tx = createSimpleTransaction(
+    wallet.address,
+    recipientAddress,
+    amount,
+    bsv.PrivateKey.fromWIF(wallet.privateKeyWIF),
+    utxo
+  );
+  
+  if (!tx) {
+    console.log('❌ Failed to create transaction');
+    return;
+  }
+  
+  // Broadcast to miner
+  console.log('📡 Broadcasting transaction to miner...');
+  const result = acceptTransaction(tx);
+  
+  if (result.accepted) {
+    console.log('\n🎉 Transaction accepted and processed!');
+    
+    // Update local wallet
+    updateUTXOFromTransaction(tx, utxo);
+    
+    console.log('\n📊 Updated blockchain state:');
+    getBlockchainStats();
+  } else {
+    console.log('\n❌ Transaction rejected by miner');
+    console.log('Errors:', result.errors);
+  }
+}
+
+/**
+ * Example 3: Multi-output transaction
+ */
+async function exampleMultiOutput() {
+  console.log('\n' + '='.repeat(80));
+  console.log('🎭 EXAMPLE 3: Multi-Output Transaction');
+  console.log('='.repeat(80));
+  
+  const config = loadConfig();
+  const wallet = config.wallet;
+  
+  // Find an available UTXO
+  const availableUTXOs = config.availableUTXOs || [];
+  
+  if (availableUTXOs.length === 0) {
+    console.log('❌ No available UTXOs. Run example 1 first.');
+    return;
+  }
+  
+  // Use the largest available UTXO
+  const utxo = availableUTXOs.reduce((max, current) => 
+    current.satoshis > max.satoshis ? current : max
+  );
+  
+  console.log(`💰 Using UTXO: ${utxo.txid}:${utxo.vout} (${utxo.satoshis} sats)`);
+  
+  // Create multiple recipients
+  const recipient1 = new bsv.PrivateKey().toAddress().toString();
+  const recipient2 = new bsv.PrivateKey().toAddress().toString();
+  const recipient3 = new bsv.PrivateKey().toAddress().toString();
+  
+  console.log(`👛 Sender: ${wallet.address}`);
+  console.log(`🎯 Recipients: ${recipient1.slice(0, 10)}... ${recipient2.slice(0, 10)}... ${recipient3.slice(0, 10)}...`);
+  
+  try {
+    // Create multi-output transaction with proper SIGHASH_FORKID
+    const tx = new bsv.Transaction()
+      .from(utxo)
+      .to(recipient1, 3000)
+      .to(recipient2, 4000)
+      .to(recipient3, 5000)
+      .change(wallet.address)
+      .fee(1000)
+      .sign(bsv.PrivateKey.fromWIF(wallet.privateKeyWIF), bsv.crypto.Signature.SIGHASH_ALL | bsv.crypto.Signature.SIGHASH_FORKID);
+    
+    console.log(`\n✅ Multi-output transaction created: ${tx.id}`);
+    console.log(`Inputs: ${tx.inputs.length}`);
+    console.log(`Outputs: ${tx.outputs.length}`);
+    console.log(`Total sent: 12,000 satoshis to 3 recipients`);
+    
+    // Broadcast to miner
+    console.log('\n📡 Broadcasting transaction to miner...');
+    const result = acceptTransaction(tx);
+    
+    if (result.accepted) {
+      console.log('\n🎉 Transaction accepted and processed!');
+      
+      // Update local wallet
+      updateUTXOFromTransaction(tx, utxo);
+      
+      console.log('\n📊 Updated blockchain state:');
+      getBlockchainStats();
+    } else {
+      console.log('\n❌ Transaction rejected by miner');
+      console.log('Errors:', result.errors);
+    }
+  } catch (error) {
+    console.error('❌ Error creating multi-output transaction:', error.message);
+  }
+}
+
+/**
+ * Run all examples
+ */
+async function runAllExamples() {
+  console.log('🚀 BSV Transaction Examples');
+  console.log('🌟 Demonstrating complete transaction flow with miner simulation\n');
+  
+  // Initialize blockchain state
+  const initialized = await initializeBlockchain();
+  if (!initialized) {
+    return;
+  }
+  
+  // Show initial miner status
+  console.log('\n📊 Initial miner status:');
+  getMempoolStatus();
+  
+  // Run examples
+  await exampleSimplePayment();
+  await new Promise(resolve => setTimeout(resolve, 1000)); // Small delay
+  
+  await exampleTransactionChain();
+  await new Promise(resolve => setTimeout(resolve, 1000)); // Small delay
+  
+  await exampleMultiOutput();
+  
+  // Final status
+  console.log('\n📊 Final miner status:');
+  getMempoolStatus();
+  
+  console.log('\n🎯 Examples completed!');
+  console.log('Check blockchain-state.json to see the global UTXO set');
+  console.log('Check wallet.json to see your local wallet state');
+}
+
+// If called directly, run examples
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  
+  if (args[0] === '1') {
+    initializeBlockchain().then(() => exampleSimplePayment());
+  } else if (args[0] === '2') {
+    exampleTransactionChain();
+  } else if (args[0] === '3') {
+    exampleMultiOutput();
+  } else {
+    runAllExamples();
+  }
+}
+
+module.exports = {
+  initializeBlockchain,
+  createSimpleTransaction,
+  exampleSimplePayment,
+  exampleTransactionChain,
+  exampleMultiOutput,
+  runAllExamples
+};

package/utilities/utxo-manager.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+
+/**
+ * 🔄 BSV UTXO Manager
+ * 
+ * Updates the wallet.json file with new UTXOs after transactions.
+ * Tracks which UTXOs are spent and which are available for BSV development.
+ */
+
+const bsv = require('../index.js');
+const fs = require('fs');
+const path = require('path');
+
+function loadConfig() {
+  const configPath = path.join(__dirname, 'wallet.json');
+  return JSON.parse(fs.readFileSync(configPath, 'utf8'));
+}
+
+function saveConfig(config) {
+  const configPath = path.join(__dirname, 'wallet.json');
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  console.log('💾 Updated wallet.json');
+}
+
+function updateUTXOFromTransaction(tx, spentUTXO = null) {
+  console.log('🔄 Updating UTXO set from transaction...\n');
+  
+  const config = loadConfig();
+  
+  console.log('📋 Transaction Analysis:');
+  console.log(`Transaction ID: ${tx.id}`);
+  console.log(`Inputs: ${tx.inputs.length}`);
+  console.log(`Outputs: ${tx.outputs.length}\n`);
+  
+  // Mark spent UTXO
+  if (spentUTXO) {
+    console.log('❌ Spent UTXO:');
+    console.log(`  TXID: ${spentUTXO.txid}`);
+    console.log(`  Vout: ${spentUTXO.vout}`);
+    console.log(`  Amount: ${spentUTXO.satoshis} satoshis\n`);
+    
+    // Add to spent UTXOs list
+    if (!config.spentUTXOs) config.spentUTXOs = [];
+    config.spentUTXOs.push({
+      txid: spentUTXO.txid,
+      vout: spentUTXO.vout,
+      satoshis: spentUTXO.satoshis,
+      spentInTx: tx.id,
+      spentAt: new Date().toISOString()
+    });
+  }
+  
+  // Add new UTXOs from outputs
+  const newUTXOs = [];
+  
+  for (let i = 0; i < tx.outputs.length; i++) {
+    const output = tx.outputs[i];
+    const outputAddress = output.script.toAddress();
+    
+    // Only track UTXOs that go to our wallet address
+    if (outputAddress.toString() === config.wallet.address) {
+      const newUTXO = {
+        txid: tx.id,
+        vout: i,
+        outputIndex: i,
+        script: output.script.toHex(),
+        scriptPubKey: output.script.toHex(),
+        satoshis: output.satoshis,
+        address: outputAddress.toString(),
+        createdAt: new Date().toISOString()
+      };
+      
+      newUTXOs.push(newUTXO);
+      
+      console.log(`✅ New UTXO ${i}:`);
+      console.log(`  TXID: ${newUTXO.txid}`);
+      console.log(`  Vout: ${newUTXO.vout}`);
+      console.log(`  Amount: ${newUTXO.satoshis} satoshis`);
+      console.log(`  Address: ${newUTXO.address}`);
+    }
+  }
+  
+  // Update config with new UTXOs
+  if (!config.availableUTXOs) config.availableUTXOs = [];
+  config.availableUTXOs = config.availableUTXOs.concat(newUTXOs);
+  
+  // Update the main UTXO to the largest available UTXO
+  if (newUTXOs.length > 0) {
+    const largestUTXO = newUTXOs.reduce((max, utxo) => 
+      utxo.satoshis > max.satoshis ? utxo : max
+    );
+    
+    config.utxo = largestUTXO;
+    console.log(`\n🎯 Primary UTXO updated to: ${largestUTXO.satoshis} satoshis`);
+  }
+  
+  // Update metadata
+  config.metadata.lastUpdated = new Date().toISOString();
+  config.metadata.transactionCount = (config.metadata.transactionCount || 0) + 1;
+  
+  saveConfig(config);
+  
+  return {
+    newUTXOs,
+    totalValue: newUTXOs.reduce((sum, utxo) => sum + utxo.satoshis, 0),
+    config
+  };
+}
+
+function getAvailableBalance() {
+  const config = loadConfig();
+  
+  const balance = config.availableUTXOs 
+    ? config.availableUTXOs.reduce((sum, utxo) => sum + utxo.satoshis, 0)
+    : config.utxo.satoshis;
+    
+  return balance;
+}
+
+function listUTXOs() {
+  const config = loadConfig();
+  
+  console.log('💰 Current UTXO Set:');
+  console.log('═══════════════════════════════════════════\n');
+  
+  console.log('🎯 Primary UTXO:');
+  console.log(`  TXID: ${config.utxo.txid}`);
+  console.log(`  Vout: ${config.utxo.vout}`);
+  console.log(`  Amount: ${config.utxo.satoshis} satoshis\n`);
+  
+  if (config.availableUTXOs && config.availableUTXOs.length > 0) {
+    console.log('📝 All Available UTXOs:');
+    config.availableUTXOs.forEach((utxo, index) => {
+      console.log(`  ${index + 1}. ${utxo.txid}:${utxo.vout} - ${utxo.satoshis} sats`);
+    });
+  }
+  
+  if (config.spentUTXOs && config.spentUTXOs.length > 0) {
+    console.log('\n❌ Spent UTXOs:');
+    config.spentUTXOs.forEach((utxo, index) => {
+      console.log(`  ${index + 1}. ${utxo.txid}:${utxo.vout} - ${utxo.satoshis} sats (spent in ${utxo.spentInTx})`);
+    });
+  }
+  
+  const totalBalance = getAvailableBalance();
+  console.log(`\n💰 Total Available Balance: ${totalBalance} satoshis`);
+  
+  return config;
+}
+
+// If called directly, list current UTXOs
+if (require.main === module) {
+  listUTXOs();
+}
+
+module.exports = {
+  updateUTXOFromTransaction,
+  getAvailableBalance,
+  listUTXOs,
+  loadConfig,
+  saveConfig
+};

package/utilities/wallet-setup.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+
+/**
+ * 🎯 BSV Wallet Setup Utility
+ * 
+ * Creates a test wallet with mock UTXO for BSV development and testing.
+ * Generates a consistent environment with private keys, addresses, and UTXOs.
+ */
+
+const bsv = require('../index.js');
+const fs = require('fs');
+const path = require('path');
+
+// Import the mock UTXO functionality from mock-utxo-generator.js
+function randomHex(len) {
+  const crypto = require('crypto');
+  return crypto.randomBytes(len).toString('hex');
+}
+
+function createMockTxId() {
+  return randomHex(32);
+}
+
+function buildP2pkhScriptHex(address) {
+  return bsv.Script.buildPublicKeyHashOut(address).toHex();
+}
+
+function mkUtxo(privateKey, sats = 100000) {
+  const address = privateKey.toAddress().toString();
+  const txid = createMockTxId();
+  const vout = 0;
+  const scriptHex = buildP2pkhScriptHex(address);
+
+  return {
+    txId: txid,
+    txid: txid,
+    vout: vout,
+    outputIndex: vout,
+    satoshis: sats,
+    value: sats,
+    script: scriptHex,
+    scriptPubKey: scriptHex,
+    address,
+  };
+}
+
+function createTestWallet() {
+  console.log('🔧 Creating test wallet...\n');
+
+  // Generate a new private key for testing
+  const privateKey = new bsv.PrivateKey();
+  const publicKey = privateKey.toPublicKey();
+  const address = privateKey.toAddress();
+
+  console.log('📋 Test Wallet Details:');
+  console.log(`Private Key (WIF): ${privateKey.toWIF()}`);
+  console.log(`Private Key (Hex): ${privateKey.toString('hex')}`);
+  console.log(`Public Key: ${publicKey.toString()}`);
+  console.log(`Address: ${address.toString()}`);
+  console.log(`Pubkey Hash160: ${bsv.crypto.Hash.sha256ripemd160(publicKey.toBuffer()).toString('hex')}\n`);
+
+  // Create a mock UTXO with sufficient funds for testing
+  const utxo = mkUtxo(privateKey, 50000); // 50,000 satoshis
+
+  console.log('💰 Mock UTXO Created:');
+  console.log(`TXID: ${utxo.txid}`);
+  console.log(`Vout: ${utxo.vout}`);
+  console.log(`Satoshis: ${utxo.satoshis}`);
+  console.log(`Script: ${utxo.script}\n`);
+
+  // Create test environment config
+  const testConfig = {
+    wallet: {
+      privateKeyWIF: privateKey.toWIF(),
+      privateKeyHex: privateKey.toString('hex'),
+      publicKey: publicKey.toString(),
+      address: address.toString(),
+      pubkeyHash160: bsv.crypto.Hash.sha256ripemd160(publicKey.toBuffer()).toString('hex')
+    },
+    utxo: {
+      txid: utxo.txid,
+      vout: utxo.vout,
+      outputIndex: utxo.outputIndex,
+      script: utxo.script,
+      scriptPubKey: utxo.scriptPubKey,
+      satoshis: utxo.satoshis,
+      address: utxo.address
+    },
+    testParams: {
+      nLockTimeTarget: 1000,
+      sighashType: bsv.crypto.Signature.SIGHASH_ALL | bsv.crypto.Signature.SIGHASH_FORKID,
+      covenantAmount: 40000,  // Amount for covenant output
+      fee: 1000,              // Transaction fee
+      changeAmount: 9000      // Remaining change
+    },
+    metadata: {
+      created: new Date().toISOString(),
+      description: 'Test wallet and UTXO for BSV preimage covenant testing',
+      version: '1.0'
+    }
+  };
+
+  return testConfig;
+}
+
+function saveTestConfig(config) {
+  const configPath = path.join(__dirname, 'wallet.json');
+  
+  console.log('💾 Saving wallet configuration...');
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  
+  console.log(`✅ Wallet configuration saved to: ${configPath}\n`);
+  
+  return configPath;
+}
+
+function displaySetupSummary(config) {
+  console.log('📊 Test Environment Summary:');
+  console.log('═══════════════════════════════════════════');
+  console.log(`Address: ${config.wallet.address}`);
+  console.log(`Balance: ${config.utxo.satoshis} satoshis`);
+  console.log(`Mock TXID: ${config.utxo.txid.substring(0, 16)}...`);
+  console.log(`nLockTime Target: ${config.testParams.nLockTimeTarget}`);
+  console.log(`Covenant Amount: ${config.testParams.covenantAmount} satoshis`);
+  console.log(`Fee: ${config.testParams.fee} satoshis`);
+  console.log('═══════════════════════════════════════════\n');
+  
+  console.log('\n🎯 Next Steps:');
+  console.log('1. Use the wallet credentials in your tests');
+  console.log('2. Import wallet.json in your test files');
+  console.log('3. Call updateUTXOFromTransaction() after each transaction\n');
+}
+
+// Main execution
+function main() {
+  console.log('🚀 BSV Preimage Covenant - Test Wallet Setup\n');
+  
+  try {
+    // Create test wallet and configuration
+    const testConfig = createTestWallet();
+    
+    // Save configuration to file
+    const configPath = saveTestConfig(testConfig);
+    
+    // Display summary
+    displaySetupSummary(testConfig);
+    
+    console.log('✅ Test wallet setup complete!');
+    console.log(`📁 Configuration file: ${path.basename(configPath)}`);
+    
+  } catch (error) {
+    console.error('❌ Error setting up test wallet:', error.message);
+    process.exit(1);
+  }
+}
+
+// Run if called directly
+if (require.main === module) {
+  main();
+}
+
+// Export functions for use in other files
+module.exports = {
+  createTestWallet,
+  mkUtxo,
+  saveTestConfig
+};

package/utilities/wallet.json

@@ -0,0 +1,30 @@
+{
+  "wallet": {
+    "privateKeyWIF": "KwbaQqFUpt9MYQRrkVWk7QC799nAfcqYRYKj4ZNeZBkut3YP45rJ",
+    "privateKeyHex": "KwbaQqFUpt9MYQRrkVWk7QC799nAfcqYRYKj4ZNeZBkut3YP45rJ",
+    "publicKey": "02330726b97010d7bb1f88b1213330e644916cedfd5fee9c57153592c6b5a44fe9",
+    "address": "15XJXD7CSMqHL2ivFCu8PZTACQQ8MPbWY9",
+    "pubkeyHash160": "319b9b8eef10d00cf84b5d4772dca69b5f5a7b5c"
+  },
+  "utxo": {
+    "txid": "d6625d13f3130360dea7ebe8ccf8ccdb5e40b3cd5ea51b2094983a3789354c3e",
+    "vout": 0,
+    "outputIndex": 0,
+    "script": "76a914319b9b8eef10d00cf84b5d4772dca69b5f5a7b5c88ac",
+    "scriptPubKey": "76a914319b9b8eef10d00cf84b5d4772dca69b5f5a7b5c88ac",
+    "satoshis": 50000,
+    "address": "15XJXD7CSMqHL2ivFCu8PZTACQQ8MPbWY9"
+  },
+  "testParams": {
+    "nLockTimeTarget": 1000,
+    "sighashType": 65,
+    "covenantAmount": 40000,
+    "fee": 1000,
+    "changeAmount": 9000
+  },
+  "metadata": {
+    "created": "2025-10-19T14:33:10.987Z",
+    "description": "Test wallet and UTXO for BSV preimage covenant testing",
+    "version": "1.0"
+  }
+}