@smartledger/bsv 3.3.2 → 3.3.4

package/utilities/mock-utxo-generator.js

@@ -21,80 +21,80 @@
  *   create a matching real TX there).
  */
 
-const bsv = require('../index.js');
-const crypto = require('crypto');
+const bsv = require('../index.js')
+const crypto = require('crypto')
 
-function usage() {
-  console.log('Usage: node mock_utxo_generator.js [WIF] [satoshis] [recipientAddress]');
-  console.log('If WIF omitted, a random private key is generated.');
+function usage () {
+  console.log('Usage: node mock_utxo_generator.js [WIF] [satoshis] [recipientAddress]')
+  console.log('If WIF omitted, a random private key is generated.')
 }
 
-function randomHex(len) {
-  return crypto.randomBytes(len).toString('hex');
+function randomHex (len) {
+  return crypto.randomBytes(len).toString('hex')
 }
 
-function createMockTxId() {
+function createMockTxId () {
   // create random 32-byte hex as fake txid (little-endian vs big-endian not important for mocks)
-  return randomHex(32);
+  return randomHex(32)
 }
 
-function buildP2pkhScriptHex(address) {
-  return bsv.Script.buildPublicKeyHashOut(address).toHex();
+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);
+function mkUtxo (privateKey, sats = 100000) {
+  const address = privateKey.toAddress().toString()
+  const txid = createMockTxId()
+  const vout = 0
+  const scriptHex = buildP2pkhScriptHex(address)
 
   // Return a utxo shape compatible with bsv.Transaction().from(...)
   return {
     txId: txid,
-    txid: txid,             // alternate naming used by some code
+    txid: txid, // alternate naming used by some code
     vout: vout,
-    outputIndex: vout,      // bsv accepts outputIndex or vout
+    outputIndex: vout, // bsv accepts outputIndex or vout
     satoshis: sats,
     value: sats,
     script: scriptHex,
     scriptPubKey: scriptHex,
-    address,
-  };
+    address
+  }
 }
 
-async function main() {
-  const argv = process.argv.slice(2);
+async function main () {
+  const argv = process.argv.slice(2)
   if (argv.includes('-h') || argv.includes('--help')) {
-    usage();
-    return;
+    usage()
+    return
   }
 
-  const maybeWif = argv[0];
-  const maybeSatoshis = argv[1];
-  const recipient = argv[2];
+  const maybeWif = argv[0]
+  const maybeSatoshis = argv[1]
+  const recipient = argv[2]
 
-  let privateKey;
+  let privateKey
   try {
     if (maybeWif) {
       // try to load from WIF
-      privateKey = bsv.PrivateKey.fromWIF(maybeWif);
+      privateKey = bsv.PrivateKey.fromWIF(maybeWif)
     } else {
-      privateKey = new bsv.PrivateKey(); // random
+      privateKey = new bsv.PrivateKey() // random
     }
   } catch (e) {
-    console.error('Invalid WIF provided. Exiting.');
-    process.exit(1);
+    console.error('Invalid WIF provided. Exiting.')
+    process.exit(1)
   }
 
-  const satoshis = maybeSatoshis ? parseInt(maybeSatoshis, 10) : 100000;
+  const satoshis = maybeSatoshis ? parseInt(maybeSatoshis, 10) : 100000
   if (Number.isNaN(satoshis) || satoshis <= 0) {
-    console.error('Invalid satoshis amount. Must be positive integer.');
-    process.exit(1);
+    console.error('Invalid satoshis amount. Must be positive integer.')
+    process.exit(1)
   }
 
-  const utxo = mkUtxo(privateKey, satoshis);
+  const utxo = mkUtxo(privateKey, satoshis)
 
-  console.log('\n=== MOCK UTXO ===');
+  console.log('\n=== MOCK UTXO ===')
   console.log(JSON.stringify({
     privateKeyWIF: privateKey.toWIF(),
     privateKeyHex: privateKey.toString('hex'),
@@ -105,17 +105,17 @@ async function main() {
       scriptPubKey: utxo.scriptPubKey,
       satoshis: utxo.satoshis
     }
-  }, null, 2));
-  console.log('=================\n');
+  }, null, 2))
+  console.log('=================\n')
 
   if (recipient) {
     // Build a small tx that spends the mock utxo and sends everything minus a tiny fee
     try {
-      const fee = 500; // tiny fee for local testing
-      const sendAmount = Math.max(0, utxo.satoshis - fee);
+      const fee = 500 // tiny fee for local testing
+      const sendAmount = Math.max(0, utxo.satoshis - fee)
       if (sendAmount <= 0) {
-        console.error('UTXO too small to cover fee. Increase satoshis or reduce fee.');
-        process.exit(1);
+        console.error('UTXO too small to cover fee. Increase satoshis or reduce fee.')
+        process.exit(1)
       }
 
       // Build transaction using bsv.Transaction.from style
@@ -128,22 +128,22 @@ async function main() {
         })
         .to(recipient, sendAmount)
         // .change(utxo.address) // not necessary here because we send everything minus fee
-        .sign(privateKey);
+        .sign(privateKey)
 
-      console.log('=== SIGNED SPEND TX ===');
-      console.log('TX HEX:', tx.toString());
-      console.log('TX ID (hash):', tx.hash);
-      console.log('fee (mock):', fee);
-      console.log('sendAmount:', sendAmount);
-      console.log('========================\n');
+      console.log('=== SIGNED SPEND TX ===')
+      console.log('TX HEX:', tx.toString())
+      console.log('TX ID (hash):', tx.hash)
+      console.log('fee (mock):', fee)
+      console.log('sendAmount:', sendAmount)
+      console.log('========================\n')
 
-      console.log('Note: This TX is signed against our mock UTXO and can be used in local tests that accept fake txids.');
+      console.log('Note: This TX is signed against our mock UTXO and can be used in local tests that accept fake txids.')
     } catch (e) {
-      console.error('Failed to build or sign tx:', e);
+      console.error('Failed to build or sign tx:', e)
     }
   } else {
-    console.log('No recipient provided. To produce a signed spending tx, run again with a recipient address as the 3rd arg.');
+    console.log('No recipient provided. To produce a signed spending tx, run again with a recipient address as the 3rd arg.')
   }
 }
 
-main();
+main()

package/utilities/raw-tx-examples.js

@@ -2,99 +2,98 @@
 
 /**
  * 🔧 BSV Raw Transaction Hex Validation Example
- * 
+ *
  * Demonstrates sending raw transaction hex to the miner for validation
  * using the BSV script interpreter for proper signature verification.
  */
 
-const bsv = require('../index.js');
-const { 
-  acceptTransaction, 
-  acceptRawTransaction 
-} = require('./miner-simulator');
-const { 
-  loadConfig 
-} = require('./utxo-manager');
+const bsv = require('../index.js')
+const {
+  acceptTransaction,
+  acceptRawTransaction
+} = require('./miner-simulator')
+const {
+  loadConfig
+} = require('./utxo-manager')
 
 /**
  * Example: Create and validate raw transaction hex
  */
-function exampleRawTransactionValidation() {
-  console.log('🔧 BSV Raw Transaction Hex Validation Example');
-  console.log('═'.repeat(80));
-  
+function exampleRawTransactionValidation () {
+  console.log('🔧 BSV Raw Transaction Hex Validation Example')
+  console.log('═'.repeat(80))
+
   try {
     // Load wallet config
-    const config = loadConfig();
-    const wallet = config.wallet;
-    
+    const config = loadConfig()
+    const wallet = config.wallet
+
     // Create recipient
-    const recipientKey = new bsv.PrivateKey();
-    const recipientAddress = recipientKey.toAddress().toString();
-    
+    const recipientKey = new bsv.PrivateKey()
+    const recipientAddress = recipientKey.toAddress().toString()
+
     // Get available UTXO
-    const utxo = config.utxo;
-    
-    console.log('📋 Transaction Details:');
-    console.log(`👛 From: ${wallet.address}`);
-    console.log(`🎯 To: ${recipientAddress}`);
-    console.log(`💰 Amount: 10,000 satoshis`);
-    console.log(`💳 Using UTXO: ${utxo.txid}:${utxo.vout} (${utxo.satoshis} sats)\n`);
-    
+    const utxo = config.utxo
+
+    console.log('📋 Transaction Details:')
+    console.log(`👛 From: ${wallet.address}`)
+    console.log(`🎯 To: ${recipientAddress}`)
+    console.log(`💰 Amount: 10,000 satoshis`)
+    console.log(`💳 Using UTXO: ${utxo.txid}:${utxo.vout} (${utxo.satoshis} sats)\n`)
+
     // Create transaction with proper SIGHASH_FORKID
     const tx = new bsv.Transaction()
       .from(utxo)
       .to(recipientAddress, 10000)
       .change(wallet.address)
       .fee(1000)
-      .sign(bsv.PrivateKey.fromWIF(wallet.privateKeyWIF), bsv.crypto.Signature.SIGHASH_ALL | bsv.crypto.Signature.SIGHASH_FORKID);
-    
-    console.log('✅ Transaction created successfully');
-    console.log(`🆔 Transaction ID: ${tx.id}`);
-    
+      .sign(bsv.PrivateKey.fromWIF(wallet.privateKeyWIF), bsv.crypto.Signature.SIGHASH_ALL | bsv.crypto.Signature.SIGHASH_FORKID)
+
+    console.log('✅ Transaction created successfully')
+    console.log(`🆔 Transaction ID: ${tx.id}`)
+
     // Get raw transaction hex
-    const rawHex = tx.toString();
-    console.log(`\n📦 Raw Transaction Hex (${rawHex.length} chars):`);
-    console.log(`${rawHex.substring(0, 80)}...`);
-    console.log(`...${rawHex.substring(rawHex.length - 80)}`);
-    
+    const rawHex = tx.toString()
+    console.log(`\n📦 Raw Transaction Hex (${rawHex.length} chars):`)
+    console.log(`${rawHex.substring(0, 80)}...`)
+    console.log(`...${rawHex.substring(rawHex.length - 80)}`)
+
     // Method 1: Send transaction object
-    console.log('\n' + '─'.repeat(60));
-    console.log('🔄 Method 1: Sending Transaction Object');
-    console.log('─'.repeat(60));
-    
-    const result1 = acceptTransaction(tx);
-    console.log(`\nResult: ${result1.accepted ? '✅ ACCEPTED' : '❌ REJECTED'}`);
+    console.log('\n' + '─'.repeat(60))
+    console.log('🔄 Method 1: Sending Transaction Object')
+    console.log('─'.repeat(60))
+
+    const result1 = acceptTransaction(tx)
+    console.log(`\nResult: ${result1.accepted ? '✅ ACCEPTED' : '❌ REJECTED'}`)
     if (result1.errors.length > 0) {
-      console.log('Errors:', result1.errors);
+      console.log('Errors:', result1.errors)
     }
-    
+
     // Method 2: Send raw transaction hex
-    console.log('\n' + '─'.repeat(60));
-    console.log('🔄 Method 2: Sending Raw Transaction Hex');
-    console.log('─'.repeat(60));
-    
-    const result2 = acceptRawTransaction(rawHex);
-    console.log(`\nResult: ${result2.accepted ? '✅ ACCEPTED' : '❌ REJECTED'}`);
+    console.log('\n' + '─'.repeat(60))
+    console.log('🔄 Method 2: Sending Raw Transaction Hex')
+    console.log('─'.repeat(60))
+
+    const result2 = acceptRawTransaction(rawHex)
+    console.log(`\nResult: ${result2.accepted ? '✅ ACCEPTED' : '❌ REJECTED'}`)
     if (result2.errors.length > 0) {
-      console.log('Errors:', result2.errors);
+      console.log('Errors:', result2.errors)
     }
-    
-    console.log('\n🎯 Both methods should produce identical validation results!');
-    
+
+    console.log('\n🎯 Both methods should produce identical validation results!')
   } catch (error) {
-    console.error('❌ Error in example:', error.message);
+    console.error('❌ Error in example:', error.message)
   }
 }
 
 /**
  * Example: Test invalid raw transaction hex
  */
-function exampleInvalidRawHex() {
-  console.log('\n' + '═'.repeat(80));
-  console.log('🚫 Testing Invalid Raw Transaction Hex');
-  console.log('═'.repeat(80));
-  
+function exampleInvalidRawHex () {
+  console.log('\n' + '═'.repeat(80))
+  console.log('🚫 Testing Invalid Raw Transaction Hex')
+  console.log('═'.repeat(80))
+
   // Test various invalid hex scenarios
   const invalidHexExamples = [
     {
@@ -112,97 +111,96 @@ function exampleInvalidRawHex() {
       hex: '01000000010000000000000000000000000000000000000000000000000000000000000000',
       description: 'Valid hex but malformed transaction structure'
     }
-  ];
-  
+  ]
+
   invalidHexExamples.forEach((example, index) => {
-    console.log(`\n${index + 1}. ${example.name}:`);
-    console.log(`   Description: ${example.description}`);
-    console.log(`   Hex: ${example.hex}`);
-    
-    const result = acceptRawTransaction(example.hex);
-    console.log(`   Result: ${result.accepted ? '✅ ACCEPTED' : '❌ REJECTED'} (Expected: REJECTED)`);
-    
+    console.log(`\n${index + 1}. ${example.name}:`)
+    console.log(`   Description: ${example.description}`)
+    console.log(`   Hex: ${example.hex}`)
+
+    const result = acceptRawTransaction(example.hex)
+    console.log(`   Result: ${result.accepted ? '✅ ACCEPTED' : '❌ REJECTED'} (Expected: REJECTED)`)
+
     if (result.errors.length > 0) {
-      console.log(`   Error: ${result.errors[0]}`);
+      console.log(`   Error: ${result.errors[0]}`)
     }
-  });
+  })
 }
 
 /**
  * Example: Parse and analyze transaction components
  */
-function exampleTransactionAnalysis() {
-  console.log('\n' + '═'.repeat(80));
-  console.log('🔍 Transaction Component Analysis');
-  console.log('═'.repeat(80));
-  
+function exampleTransactionAnalysis () {
+  console.log('\n' + '═'.repeat(80))
+  console.log('🔍 Transaction Component Analysis')
+  console.log('═'.repeat(80))
+
   try {
-    const config = loadConfig();
-    const wallet = config.wallet;
-    const utxo = config.utxo;
-    
+    const config = loadConfig()
+    const wallet = config.wallet
+    const utxo = config.utxo
+
     // Create simple transaction with proper SIGHASH_FORKID
     const tx = new bsv.Transaction()
       .from(utxo)
       .to(new bsv.PrivateKey().toAddress(), 5000)
       .change(wallet.address)
       .fee(500)
-      .sign(bsv.PrivateKey.fromWIF(wallet.privateKeyWIF), bsv.crypto.Signature.SIGHASH_ALL | bsv.crypto.Signature.SIGHASH_FORKID);
-    
-    const rawHex = tx.toString();
-    
-    console.log('📋 Transaction Analysis:');
-    console.log(`🆔 TXID: ${tx.id}`);
-    console.log(`📦 Raw Hex: ${rawHex}`);
-    console.log(`📏 Size: ${rawHex.length / 2} bytes`);
-    console.log(`💰 Fee: ${tx.getFee()} satoshis`);
-    
-    console.log('\n🔍 Input Details:');
+      .sign(bsv.PrivateKey.fromWIF(wallet.privateKeyWIF), bsv.crypto.Signature.SIGHASH_ALL | bsv.crypto.Signature.SIGHASH_FORKID)
+
+    const rawHex = tx.toString()
+
+    console.log('📋 Transaction Analysis:')
+    console.log(`🆔 TXID: ${tx.id}`)
+    console.log(`📦 Raw Hex: ${rawHex}`)
+    console.log(`📏 Size: ${rawHex.length / 2} bytes`)
+    console.log(`💰 Fee: ${tx.getFee()} satoshis`)
+
+    console.log('\n🔍 Input Details:')
     tx.inputs.forEach((input, i) => {
-      console.log(`  Input ${i}:`);
-      console.log(`    Previous TXID: ${input.prevTxId.toString('hex')}`);
-      console.log(`    Output Index: ${input.outputIndex}`);
-      console.log(`    Script: ${input.script.toHex()}`);
-      console.log(`    Script ASM: ${input.script.toASM()}`);
-    });
-    
-    console.log('\n📤 Output Details:');
+      console.log(`  Input ${i}:`)
+      console.log(`    Previous TXID: ${input.prevTxId.toString('hex')}`)
+      console.log(`    Output Index: ${input.outputIndex}`)
+      console.log(`    Script: ${input.script.toHex()}`)
+      console.log(`    Script ASM: ${input.script.toASM()}`)
+    })
+
+    console.log('\n📤 Output Details:')
     tx.outputs.forEach((output, i) => {
-      console.log(`  Output ${i}:`);
-      console.log(`    Value: ${output.satoshis} satoshis`);
-      console.log(`    Script: ${output.script.toHex()}`);
-      console.log(`    Script ASM: ${output.script.toASM()}`);
+      console.log(`  Output ${i}:`)
+      console.log(`    Value: ${output.satoshis} satoshis`)
+      console.log(`    Script: ${output.script.toHex()}`)
+      console.log(`    Script ASM: ${output.script.toASM()}`)
       try {
-        console.log(`    Address: ${output.script.toAddress()}`);
+        console.log(`    Address: ${output.script.toAddress()}`)
       } catch (e) {
-        console.log(`    Address: [Non-standard script]`);
+        console.log(`    Address: [Non-standard script]`)
       }
-    });
-    
+    })
   } catch (error) {
-    console.error('❌ Error in analysis:', error.message);
+    console.error('❌ Error in analysis:', error.message)
   }
 }
 
 /**
  * Run all raw transaction examples
  */
-function runAllExamples() {
-  exampleRawTransactionValidation();
-  exampleInvalidRawHex();
-  exampleTransactionAnalysis();
-  
-  console.log('\n🎯 Raw transaction validation examples completed!');
-  console.log('💡 The miner now validates transactions using:');
-  console.log('   - Raw hex format validation');
-  console.log('   - UTXO existence checking');
-  console.log('   - BSV script interpreter for signature verification');
-  console.log('   - Transaction balance and structure validation');
+function runAllExamples () {
+  exampleRawTransactionValidation()
+  exampleInvalidRawHex()
+  exampleTransactionAnalysis()
+
+  console.log('\n🎯 Raw transaction validation examples completed!')
+  console.log('💡 The miner now validates transactions using:')
+  console.log('   - Raw hex format validation')
+  console.log('   - UTXO existence checking')
+  console.log('   - BSV script interpreter for signature verification')
+  console.log('   - Transaction balance and structure validation')
 }
 
 // Run examples if called directly
 if (require.main === module) {
-  runAllExamples();
+  runAllExamples()
 }
 
 module.exports = {
@@ -210,4 +208,4 @@ module.exports = {
   exampleInvalidRawHex,
   exampleTransactionAnalysis,
   runAllExamples
-};
+}