@smartledger/bsv 3.4.3 → 3.4.4

package/examples/preimage/generate_sighash_examples.js

@@ -1,152 +0,0 @@
-#!/usr/bin/env node
-/**
- * generate_sighash_examples.js  
- * Generate preimages demonstrating SIGHASH flag behavior that causes "zero hashes"
- * This explains the "extra zeros" that confuse developers in multi-input scenarios
- */
-
-const { Buffer } = require("buffer");
-
-function createSighashPreimage(sighashType = 'ALL_FORKID') {
-  // SIGHASH type mappings
-  const sighashTypes = {
-    'ALL': 0x01,
-    'ALL_FORKID': 0x41,
-    'NONE_FORKID': 0x42, 
-    'SINGLE_FORKID': 0x43,
-    'ALL_ANYONECANPAY_FORKID': 0xc1,
-    'NONE_ANYONECANPAY_FORKID': 0xc2,
-    'SINGLE_ANYONECANPAY_FORKID': 0xc3
-  };
-  
-  const sigType = sighashTypes[sighashType];
-  if (!sigType) {
-    throw new Error(`Unknown sighash type: ${sighashType}`);
-  }
-  
-  // Base preimage components
-  const nVersion = Buffer.from([0x01, 0x00, 0x00, 0x00]);
-  const outpoint_txid = Buffer.alloc(32, 0xaa);
-  const outpoint_vout = Buffer.from([0x00, 0x00, 0x00, 0x00]);
-  const scriptCode = Buffer.from([
-    0x76, 0xa9, 0x14,  // OP_DUP OP_HASH160 OP_PUSHDATA(20)
-    ...Buffer.alloc(20, 0x88),  // 20-byte pubkey hash
-    0x88, 0xac  // OP_EQUALVERIFY OP_CHECKSIG
-  ]);
-  const scriptLen = Buffer.from([scriptCode.length]);
-  const value = Buffer.from([0x00, 0xe1, 0xf5, 0x05, 0x00, 0x00, 0x00, 0x00]);
-  const nSequence = Buffer.from([0xff, 0xff, 0xff, 0xff]);
-  const nLocktime = Buffer.from([0x00, 0x00, 0x00, 0x00]);
-  const sighashTypeBuffer = Buffer.from([sigType, 0x00, 0x00, 0x00]);
-  
-  // Apply SIGHASH rules for hash fields
-  let hashPrevouts, hashSequence, hashOutputs;
-  
-  if (sigType & 0x80) { // ANYONECANPAY flag
-    hashPrevouts = Buffer.alloc(32, 0x00); // Zero hash
-    hashSequence = Buffer.alloc(32, 0x00); // Zero hash
-  } else {
-    hashPrevouts = Buffer.alloc(32, 0xab); // Normal hash
-    hashSequence = Buffer.alloc(32, 0xcd); // Normal hash
-  }
-  
-  if ((sigType & 0x1f) === 0x02) { // SIGHASH_NONE
-    hashOutputs = Buffer.alloc(32, 0x00); // Zero hash
-  } else if ((sigType & 0x1f) === 0x03) { // SIGHASH_SINGLE  
-    hashOutputs = Buffer.alloc(32, 0x00); // Zero hash (simplified)
-  } else {
-    hashOutputs = Buffer.alloc(32, 0xef); // Normal hash
-  }
-  
-  // Construct preimage
-  const preimage = Buffer.concat([
-    nVersion,
-    hashPrevouts,
-    hashSequence,
-    outpoint_txid,
-    outpoint_vout,
-    scriptLen,
-    scriptCode,
-    value,
-    nSequence,
-    hashOutputs,
-    nLocktime,
-    sighashTypeBuffer
-  ]);
-  
-  return {
-    hex: preimage.toString('hex'),
-    analysis: {
-      sighashType: sighashType,
-      sighashValue: `0x${sigType.toString(16).padStart(2, '0')}`,
-      hashPrevouts: hashPrevouts.equals(Buffer.alloc(32, 0x00)) ? 'ZERO (ANYONECANPAY)' : 'NORMAL',
-      hashSequence: hashSequence.equals(Buffer.alloc(32, 0x00)) ? 'ZERO (ANYONECANPAY)' : 'NORMAL',  
-      hashOutputs: hashOutputs.equals(Buffer.alloc(32, 0x00)) ? 'ZERO (NONE/SINGLE)' : 'NORMAL'
-    }
-  };
-}
-
-// CLI Interface
-if (require.main === module) {
-  const sighashType = process.argv[2] || 'ALL_FORKID';
-  
-  if (sighashType === '--help' || sighashType === '-h') {
-    console.log("🔏 SIGHASH Flag Preimage Generator");
-    console.log("=================================");
-    console.log("Demonstrates how SIGHASH flags create 'zero hashes' in BIP-143 preimages");
-    console.log("");
-    console.log("Usage: node generate_sighash_examples.js [sighash_type]");
-    console.log("");
-    console.log("Available SIGHASH types:");
-    console.log("  ALL_FORKID                - Standard: all inputs/outputs (0x41) - DEFAULT");
-    console.log("  NONE_FORKID               - Zero hashOutputs (0x42)");
-    console.log("  SINGLE_FORKID             - Zero hashOutputs for single mode (0x43)");
-    console.log("  ALL_ANYONECANPAY_FORKID   - Zero hashPrevouts + hashSequence (0xC1)");
-    console.log("  NONE_ANYONECANPAY_FORKID  - Zero all hash fields (0xC2)");
-    console.log("");
-    console.log("Examples:");
-    console.log("  node generate_sighash_examples.js ALL_FORKID");
-    console.log("  node generate_sighash_examples.js ALL_ANYONECANPAY_FORKID");
-    console.log("  node generate_sighash_examples.js NONE_FORKID");
-    process.exit(0);
-  }
-  
-  try {
-    console.log("🔏 SIGHASH Flag Preimage Analysis");
-    console.log("=================================");
-    console.log(`📋 SIGHASH Type: ${sighashType}`);
-    
-    const result = createSighashPreimage(sighashType);
-    
-    console.log(`📊 Generated: ${result.hex.length / 2} bytes`);
-    console.log(`🔍 SIGHASH Value: ${result.analysis.sighashValue}`);
-    console.log("");
-    console.log("🧬 Hash Field Analysis:");
-    console.log(`   hashPrevouts: ${result.analysis.hashPrevouts}`);
-    console.log(`   hashSequence: ${result.analysis.hashSequence}`);  
-    console.log(`   hashOutputs:  ${result.analysis.hashOutputs}`);
-    console.log("");
-    
-    if (result.analysis.hashPrevouts === 'ZERO' || 
-        result.analysis.hashSequence === 'ZERO' || 
-        result.analysis.hashOutputs === 'ZERO') {
-      console.log("⚠️  ZERO HASH DETECTED!");
-      console.log("   This explains 'extra zeros' developers see in multi-input preimages.");
-      console.log("   These are NOT bugs - they're required by BIP-143 SIGHASH rules.");
-    }
-    
-    console.log(`📦 Preimage: ${result.hex}`);
-    console.log("");
-    console.log("🧪 Test Commands:");
-    console.log(`   node extract_preimage_bidirectional.js ${result.hex} hashPrevouts`);
-    console.log(`   node extract_preimage_bidirectional.js ${result.hex} hashOutputs`);
-    console.log(`   node extract_preimage_bidirectional.js ${result.hex} sighashType`);
-    
-  } catch (error) {
-    console.error("❌ Error:", error.message);
-    console.log("💡 Use --help to see available SIGHASH types");
-    process.exit(1);
-  }
-}
-
-module.exports = { createSighashPreimage };

package/examples/preimage/parse_preimage.js

@@ -1,117 +0,0 @@
-#!/usr/bin/env node
-/**
- * parse_preimage.js
- *
- * Extracts all parts of a Bitcoin (BSV/BTC-style) preimage from a raw hex string.
- * Works for preimages that follow the standard structure:
- *
- *  1. nVersion (4 bytes)
- *  2. hashPrevouts (32 bytes)
- *  3. hashSequence (32 bytes)
- *  4. outpoint (32 bytes + 4 bytes)
- *  5. scriptCode (variable length)
- *  6. value (8 bytes)
- *  7. nSequence (4 bytes)
- *  8. hashOutputs (32 bytes)
- *  9. nLocktime (4 bytes)
- * 10. sighashType (4 bytes)
- */
-
-const Buffer = require('buffer').Buffer;
-// =============================
-// Helper Functions
-// =============================
-function readLE(buffer, offset, length) {
-  return buffer.slice(offset, offset + length).reverse().toString('hex');
-}
-
-function readBE(buffer, offset, length) {
-  return buffer.slice(offset, offset + length).toString('hex');
-}
-
-function readUInt32LE(buffer, offset) {
-  return buffer.readUInt32LE(offset);
-}
-
-function readUInt64LE(buffer, offset) {
-  // Node.js Buffer has no readUInt64LE natively
-  const lo = buffer.readUInt32LE(offset);
-  const hi = buffer.readUInt32LE(offset + 4);
-  return hi * 0x100000000 + lo;
-}
-
-// =============================
-// Main Parse Function
-// =============================
-function parsePreimage(hex) {
-  const buf = Buffer.from(hex, 'hex');
-  let offset = 0;
-  const result = {};
-
-  result.nVersion = buf.readUInt32LE(offset);
-  offset += 4;
-
-  result.hashPrevouts = readBE(buf, offset, 32);
-  offset += 32;
-
-  result.hashSequence = readBE(buf, offset, 32);
-  offset += 32;
-
-  result.outpoint = {
-    txid: readBE(buf, offset, 32),
-    vout: buf.readUInt32LE(offset + 32),
-  };
-  offset += 36;
-
-  // NOTE: scriptCode is variable length; next byte(s) determine its length
-  const scriptLen = buf[offset];
-  offset += 1;
-  result.scriptCode = readBE(buf, offset, scriptLen);
-  offset += scriptLen;
-
-  result.value = readUInt64LE(buf, offset);
-  offset += 8;
-
-  result.nSequence = buf.readUInt32LE(offset);
-  offset += 4;
-
-  result.hashOutputs = readBE(buf, offset, 32);
-  offset += 32;
-
-  result.nLocktime = buf.readUInt32LE(offset);
-  offset += 4;
-
-  result.sighashType = buf.readUInt32LE(offset);
-  offset += 4;
-
-  return result;
-}
-
-// =============================
-// Example Usage
-// =============================
-
-if (process.argv.length < 3) {
-  console.log("Usage: node parse_preimage.js <raw_preimage_hex>");
-  process.exit(1);
-}
-
-// CLI usage
-if (require.main === module) {
-  const hex = process.argv[2];
-  const parsed = parsePreimage(hex);
-
-  console.log("🔍 Parsed Transaction Preimage:\n");
-  for (const [key, value] of Object.entries(parsed)) {
-    console.log(`${key}:`, value);
-  }
-}
-
-// Module exports for programmatic use
-module.exports = {
-  parsePreimage,
-  readLE,
-  readBE,
-  readUInt32LE,
-  readUInt64LE
-};

package/examples/preimage/test_preimage_extractor.js

@@ -1,53 +0,0 @@
-#!/usr/bin/env node
-/**
- * test_preimage_extractor.js
- * Test the bidirectional preimage extractor with sample data
- */
-
-const { execSync } = require('child_process');
-const path = require('path');
-
-// Sample BIP-143 preimage (properly structured) 
-const samplePreimage = '01000000' + // nVersion (4 bytes)
-  'aa'.repeat(32) + // hashPrevouts (32 bytes)
-  'bb'.repeat(32) + // hashSequence (32 bytes) 
-  'cc'.repeat(32) + // outpoint_txid (32 bytes)
-  '00000000' + // outpoint_vout (4 bytes)
-  '19' + // scriptLen (1 byte = 25 decimal)
-  '76a914' + 'dd'.repeat(20) + '88ac' + // scriptCode (25 bytes - standard P2PKH)
-  '0010a5d4e8000000' + // value (8 bytes = 1000000000000 satoshis)
-  'ffffffff' + // nSequence (4 bytes)
-  'ee'.repeat(32) + // hashOutputs (32 bytes)
-  '00000000' + // nLocktime (4 bytes)
-  '41000000'; // sighashType (4 bytes = SIGHASH_ALL | FORKID)
-
-const extractorPath = path.join(__dirname, 'extract_preimage_bidirectional.js');
-
-console.log('🧪 Testing Bidirectional Preimage Extractor');
-console.log('=' .repeat(60));
-console.log(`📊 Sample preimage: ${samplePreimage.length/2} bytes`);
-
-// Test different field types
-const testFields = [
-  'nVersion',    // LEFT field
-  'scriptCode',  // DYNAMIC field
-  'value',       // RIGHT field
-  'sighashType'  // RIGHT field
-];
-
-testFields.forEach(field => {
-  console.log(`\n🔍 Testing extraction of "${field}":`);
-  try {
-    const result = execSync(
-      `node "${extractorPath}" "${samplePreimage}" "${field}"`,
-      { encoding: 'utf8', cwd: path.dirname(extractorPath) }
-    );
-    console.log('✅ SUCCESS');
-  } catch (error) {
-    console.log('❌ ERROR:', error.message.split('\n')[0]);
-  }
-});
-
-console.log('\n' + '='.repeat(60));
-console.log('🎯 All tests completed! The extractor is working correctly.');
-console.log('💡 Try manual tests with: npm run preimage:extract <hex> <field>');

package/examples/preimage/test_varint_extraction.js

@@ -1,95 +0,0 @@
-#!/usr/bin/env node
-/**
- * test_varint_extraction.js
- * Test CompactSize varint extraction with various sizes
- */
-
-const { execSync } = require('child_process');
-const path = require('path');
-
-// Create test preimages with different varint sizes
-const createTestPreimage = (scriptSize) => {
-  let scriptLen;
-  
-  if (scriptSize < 253) {
-    // 1-byte encoding
-    scriptLen = Buffer.from([scriptSize]);
-  } else if (scriptSize <= 65535) {
-    // 3-byte encoding: 0xFD + 2-byte little-endian
-    scriptLen = Buffer.from([0xfd, scriptSize & 0xff, (scriptSize >> 8) & 0xff]);
-  } else {
-    // 5-byte encoding: 0xFE + 4-byte little-endian
-    scriptLen = Buffer.from([
-      0xfe, 
-      scriptSize & 0xff, 
-      (scriptSize >> 8) & 0xff, 
-      (scriptSize >> 16) & 0xff, 
-      (scriptSize >> 24) & 0xff
-    ]);
-  }
-  
-  // Fixed components
-  const leftFixed = Buffer.concat([
-    Buffer.from([0x01, 0x00, 0x00, 0x00]), // nVersion
-    Buffer.alloc(32, 0xaa), // hashPrevouts
-    Buffer.alloc(32, 0xbb), // hashSequence
-    Buffer.alloc(32, 0xcc), // outpoint_txid
-    Buffer.from([0x00, 0x00, 0x00, 0x00]) // outpoint_vout
-  ]);
-  
-  const scriptCode = Buffer.alloc(scriptSize, 0x6a); // Fill with OP_RETURN
-  
-  const rightFixed = Buffer.concat([
-    Buffer.from([0x00, 0xe1, 0xf5, 0x05, 0x00, 0x00, 0x00, 0x00]), // value
-    Buffer.from([0xff, 0xff, 0xff, 0xff]), // nSequence
-    Buffer.alloc(32, 0xee), // hashOutputs
-    Buffer.from([0x00, 0x00, 0x00, 0x00]), // nLocktime
-    Buffer.from([0x41, 0x00, 0x00, 0x00]) // sighashType
-  ]);
-  
-  const preimage = Buffer.concat([leftFixed, scriptLen, scriptCode, rightFixed]);
-  return preimage.toString('hex');
-};
-
-const testCases = [
-  { name: "1-byte varint", size: 25 },
-  { name: "1-byte varint (max)", size: 252 },
-  { name: "3-byte varint (min)", size: 253 },
-  { name: "3-byte varint", size: 300 },
-  { name: "3-byte varint (large)", size: 1000 },
-  { name: "3-byte varint (max)", size: 65535 }
-];
-
-console.log('🧪 CompactSize Varint Extraction Test Suite');
-console.log('=' .repeat(60));
-
-testCases.forEach(test => {
-  console.log(`\n🔍 Testing ${test.name} (${test.size} bytes):`);
-  
-  const preimageHex = createTestPreimage(test.size);
-  const totalSize = preimageHex.length / 2;
-  
-  console.log(`   📏 Total preimage: ${totalSize} bytes`);
-  
-  try {
-    const extractorPath = path.join(__dirname, 'extract_preimage_bidirectional.js');
-    const result = execSync(
-      `node "${extractorPath}" "${preimageHex}" "scriptLen"`,
-      { encoding: 'utf8', cwd: __dirname }
-    );
-    
-    // Extract the decoded value from output
-    const match = result.match(/Decoded value: (\d+)/);
-    if (match && parseInt(match[1]) === test.size) {
-      console.log(`   ✅ SUCCESS: Correctly decoded ${test.size} bytes`);
-    } else {
-      console.log(`   ❌ FAILED: Expected ${test.size}, got ${match ? match[1] : 'unknown'}`);
-    }
-  } catch (error) {
-    console.log(`   ❌ ERROR: ${error.message.split('\n')[0]}`);
-  }
-});
-
-console.log('\n' + '='.repeat(60));
-console.log('🎯 Varint extraction test completed!');
-console.log('💡 This validates BIP-143 CompactSize compliance for multi-input transactions.');

package/examples/scripts/custom_script_helper_example.js

@@ -1,273 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Custom Script Helper Example - Simplified API for Custom BSV Scripts
- * 
- * Shows how to use the CustomScriptHelper for easy custom script development
- */
-
-const bsv = require('./index.js');
-const CustomScriptHelper = require('./lib/custom-script-helper.js');
-
-console.log('🛠️  Custom Script Helper API Demo');
-console.log('==================================');
-console.log('Simplified API for custom BSV script development\n');
-
-// Test keys
-const privateKey1 = new bsv.PrivateKey('5KYZdUEo39z3FPrtuX2QbbwGnNP5zTd7yyr2SC1j299sBCnWjss');
-const publicKey1 = privateKey1.publicKey;
-const privateKey2 = new bsv.PrivateKey('5Hx15HFGyep2CfPxsJKe2fXJsCVn5DEiyoeGGF6JZjGbTRnqfiD');
-const publicKey2 = privateKey2.publicKey;
-
-/**
- * Example 1: Simple Multi-Signature using Helper API
- */
-async function exampleMultisig() {
-  console.log('📝 EXAMPLE 1: Multi-Signature with Helper API');
-  console.log('=============================================');
-  
-  // Create 2-of-2 multisig script using helper
-  const lockingScript = CustomScriptHelper.createMultisigScript(2, [publicKey1, publicKey2]);
-  console.log(`Multisig script: ${lockingScript.toString()}`);
-  
-  // Create UTXO
-  const utxo = {
-    txid: 'a'.repeat(64),
-    vout: 0,
-    satoshis: 100000,
-    script: lockingScript.toHex()
-  };
-  
-  // Create transaction with ultra-low fees
-  const tx = CustomScriptHelper.createLowFeeTransaction(
-    [utxo],
-    [{ address: '1BitcoinEaterAddressDontSendf59kuE', satoshis: 99000 }]
-  );
-  
-  // Create signatures using helper
-  const sig1 = CustomScriptHelper.createSignature(tx, privateKey1, 0, lockingScript, utxo.satoshis);
-  const sig2 = CustomScriptHelper.createSignature(tx, privateKey2, 0, lockingScript, utxo.satoshis);
-  
-  // Create unlocking script using helper
-  const unlockingScript = CustomScriptHelper.createMultisigUnlocking([sig1, sig2]);
-  tx.inputs[0].setScript(unlockingScript);
-  
-  // Validate using helper
-  const isValid = CustomScriptHelper.validateTransaction(tx);
-  console.log(`✅ Multisig transaction valid: ${isValid}`);
-  console.log(`💰 Transaction fee: ${tx.getFee()} satoshis (ultra-low!)\n`);
-}
-
-/**
- * Example 2: Time-Locked Payment using Helper API
- */
-async function exampleTimelock() {
-  console.log('📝 EXAMPLE 2: Time-Locked Payment with Helper API');
-  console.log('=================================================');
-  
-  const lockHeight = 700000;
-  
-  // Create P2PKH base script
-  const baseScript = CustomScriptHelper.createP2PKHScript(publicKey1);
-  
-  // Create time-locked script using helper
-  const lockingScript = CustomScriptHelper.createTimelockScript(lockHeight, baseScript);
-  console.log(`Timelock script: ${lockingScript.toString()}`);
-  
-  const utxo = {
-    txid: 'b'.repeat(64),
-    vout: 0,
-    satoshis: 150000,
-    script: lockingScript.toHex()
-  };
-  
-  // Create transaction with time lock
-  const tx = CustomScriptHelper.createLowFeeTransaction(
-    [utxo],
-    [{ address: '1BitcoinEaterAddressDontSendf59kuE', satoshis: 149000 }]
-  );
-  tx.lockUntilBlockHeight(lockHeight);
-  
-  // Create signature using helper
-  const signature = CustomScriptHelper.createSignature(tx, privateKey1, 0, lockingScript, utxo.satoshis);
-  
-  // Create unlocking script using helper
-  const unlockingScript = CustomScriptHelper.createP2PKHUnlocking(signature, publicKey1);
-  tx.inputs[0].setScript(unlockingScript);
-  
-  const isValid = CustomScriptHelper.validateTransaction(tx);
-  console.log(`✅ Timelock transaction valid: ${isValid}`);
-  console.log(`⏰ Lock height: ${tx.nLockTime}\n`);
-}
-
-/**
- * Example 3: Conditional Payment using Helper API
- */
-async function exampleConditional() {
-  console.log('📝 EXAMPLE 3: Conditional Payment with Helper API');
-  console.log('=================================================');
-  
-  // Create IF and ELSE branch scripts
-  const ifScript = CustomScriptHelper.createP2PKHScript(publicKey1);
-  const elseScript = CustomScriptHelper.createP2PKHScript(publicKey2);
-  
-  // Create conditional script using helper
-  const lockingScript = CustomScriptHelper.createConditionalScript(ifScript, elseScript);
-  console.log(`Conditional script: ${lockingScript.toString()}`);
-  
-  const utxo = {
-    txid: 'c'.repeat(64),
-    vout: 0,
-    satoshis: 200000,
-    script: lockingScript.toHex()
-  };
-  
-  // Test IF branch
-  const tx1 = CustomScriptHelper.createLowFeeTransaction(
-    [utxo],
-    [{ address: '1BitcoinEaterAddressDontSendf59kuE', satoshis: 199000 }]
-  );
-  
-  const sig1 = CustomScriptHelper.createSignature(tx1, privateKey1, 0, lockingScript, utxo.satoshis);
-  const unlocking1 = new bsv.Script()
-    .add(sig1)
-    .add(publicKey1.toBuffer())
-    .add(bsv.Opcode.OP_1); // Choose IF branch
-  
-  tx1.inputs[0].setScript(unlocking1);
-  const valid1 = CustomScriptHelper.validateTransaction(tx1);
-  console.log(`✅ IF branch valid: ${valid1}`);
-  
-  // Test ELSE branch
-  const tx2 = CustomScriptHelper.createLowFeeTransaction(
-    [utxo],
-    [{ address: '1BitcoinEaterAddressDontSendf59kuE', satoshis: 199000 }]
-  );
-  
-  const sig2 = CustomScriptHelper.createSignature(tx2, privateKey2, 0, lockingScript, utxo.satoshis);
-  const unlocking2 = new bsv.Script()
-    .add(sig2)
-    .add(publicKey2.toBuffer())
-    .add(bsv.Opcode.OP_0); // Choose ELSE branch
-  
-  tx2.inputs[0].setScript(unlocking2);
-  const valid2 = CustomScriptHelper.validateTransaction(tx2);
-  console.log(`✅ ELSE branch valid: ${valid2}\n`);
-}
-
-/**
- * Example 4: Covenant with Preimage using Helper API
- */
-async function exampleCovenant() {
-  console.log('📝 EXAMPLE 4: Covenant with Preimage using Helper API');
-  console.log('=====================================================');
-  
-  // Simple covenant script
-  const lockingScript = CustomScriptHelper.createP2PKHScript(publicKey1);
-  
-  const utxo = {
-    txid: 'd'.repeat(64),
-    vout: 0,
-    satoshis: 300000,
-    script: lockingScript.toHex()
-  };
-  
-  const tx = CustomScriptHelper.createLowFeeTransaction(
-    [utxo],
-    [{ address: '1BitcoinEaterAddressDontSendf59kuE', satoshis: 299000 }]
-  );
-  
-  // Get preimage for covenant validation using helper
-  const preimage = CustomScriptHelper.getPreimage(tx, 0, lockingScript, utxo.satoshis);
-  console.log(`Preimage: ${preimage.toString('hex')}`);
-  console.log(`Preimage length: ${preimage.length} bytes`);
-  
-  const signature = CustomScriptHelper.createSignature(tx, privateKey1, 0, lockingScript, utxo.satoshis);
-  const unlockingScript = CustomScriptHelper.createP2PKHUnlocking(signature, publicKey1);
-  tx.inputs[0].setScript(unlockingScript);
-  
-  const isValid = CustomScriptHelper.validateTransaction(tx);
-  console.log(`✅ Covenant transaction valid: ${isValid}\n`);
-}
-
-/**
- * Example 5: OP_RETURN Data Script using Helper API
- */
-async function exampleOpReturn() {
-  console.log('📝 EXAMPLE 5: OP_RETURN Data Script using Helper API');
-  console.log('====================================================');
-  
-  // Create OP_RETURN script with data
-  const message = "Hello BSV Blockchain!";
-  const opReturnScript = CustomScriptHelper.createOpReturnScript(message);
-  console.log(`OP_RETURN script: ${opReturnScript.toString()}`);
-  
-  // Create funding UTXO
-  const utxo = {
-    txid: 'e'.repeat(64),
-    vout: 0,
-    satoshis: 50000,
-    script: CustomScriptHelper.createP2PKHScript(publicKey1).toHex()
-  };
-  
-  // Create transaction with OP_RETURN output
-  const tx = new bsv.Transaction()
-    .from(utxo)
-    .addOutput(new bsv.Transaction.Output({
-      script: opReturnScript,
-      satoshis: 0
-    }))
-    .to('1BitcoinEaterAddressDontSendf59kuE', 49000)
-    .feePerKb(10) // Ultra-low fees
-    .sign(privateKey1);
-  
-  console.log(`✅ OP_RETURN transaction valid: ${tx.verify()}`);
-  console.log(`📄 Data stored: "${message}"`);
-  console.log(`💰 Transaction fee: ${tx.getFee()} satoshis\n`);
-}
-
-/**
- * Run all examples
- */
-async function runAllExamples() {
-  try {
-    await exampleMultisig();
-    await exampleTimelock();
-    await exampleConditional();
-    await exampleCovenant();
-    await exampleOpReturn();
-    
-    console.log('🎉 CUSTOM SCRIPT HELPER API RESULTS');
-    console.log('===================================');
-    console.log('✅ Multi-Signature: WORKING');
-    console.log('✅ Time-Locked Payments: WORKING');
-    console.log('✅ Conditional Scripts: WORKING');
-    console.log('✅ Covenant Preimages: WORKING');
-    console.log('✅ OP_RETURN Data: WORKING');
-    console.log('');
-    console.log('🚀 CustomScriptHelper makes BSV script development EASY!');
-    console.log('📚 All complex operations simplified to single function calls');
-    console.log('🔧 Ready for production smart contract development');
-    
-  } catch (error) {
-    console.error('❌ Example failed:', error.message);
-    console.error(error.stack);
-  }
-}
-
-console.log('💡 USAGE EXAMPLES');
-console.log('=================');
-console.log('const CustomScriptHelper = require("./lib/custom-script-helper.js");');
-console.log('');
-console.log('// Create signatures for any custom script');
-console.log('const sig = CustomScriptHelper.createSignature(tx, privateKey, 0, lockingScript, satoshis);');
-console.log('');
-console.log('// Create multisig scripts easily');
-console.log('const multisig = CustomScriptHelper.createMultisigScript(2, [pubKey1, pubKey2]);');
-console.log('');
-console.log('// Ultra-low fee transactions');
-console.log('const tx = CustomScriptHelper.createLowFeeTransaction(utxos, outputs);');
-console.log('');
-
-// Run the examples
-runAllExamples();