@smartledger/bsv 3.4.3 → 3.4.5

package/examples/covenants/advanced_covenant_demo.js

@@ -1,219 +0,0 @@
-/**
- * Advanced Covenant Interface Demonstration
- * 
- * This demo showcases the enhanced covenant interface that combines:
- * 1. Detailed BIP143 preimage parsing and validation
- * 2. nChain PUSHTX techniques for in-script signature generation
- * 3. Perpetually Enforcing Locking Scripts (PELS)
- * 4. Advanced covenant patterns for BSV development
- * 
- * Based on specifications from:
- * - BIP143 sighash preimage structure
- * - nChain white paper WP1605: PUSHTX and Its Building Blocks
- */
-
-const bsv = require('../index.js');
-const { CovenantInterface } = require('./lib/covenant-interface.js');
-
-console.log('='.repeat(80));
-console.log('ADVANCED COVENANT INTERFACE DEMONSTRATION');
-console.log('Combining BIP143 Preimage Parsing + nChain PUSHTX Techniques');
-console.log('='.repeat(80));
-
-// Initialize the enhanced covenant interface
-const covenantInterface = new CovenantInterface();
-
-// Test 1: Enhanced preimage parsing with BIP143 specifications
-console.log('\n1. ENHANCED PREIMAGE PARSING (BIP143 Compliant)');
-console.log('-'.repeat(60));
-
-try {
-  // Create a test transaction for preimage generation
-  const testTx = new bsv.Transaction()
-    .from({
-      txId: '88b9d41101a4c064b283f80ca73837d96f974bc3fbe931b35db7bca8370cca34',
-      outputIndex: 0,
-      script: '76a914751e76e8199196d454941c45d1b3a323f1433bd688ac',
-      satoshis: 4999999388
-    })
-    .to('1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa', 4999998876);
-
-  // Generate preimage using BSV library
-  const lockingScript = bsv.Script.fromHex('76a914751e76e8199196d454941c45d1b3a323f1433bd688ac');
-  const satoshis = 4999999388;
-  const sighashType = bsv.crypto.Signature.SIGHASH_ALL | bsv.crypto.Signature.SIGHASH_FORKID;
-  
-  console.log('✓ Test transaction created');
-  console.log(`  - Input TXID: ${testTx.inputs[0].prevTxId}`);
-  console.log(`  - Output value: ${testTx.outputs[0].satoshis} satoshis`);
-  console.log(`  - Sighash type: 0x${sighashType.toString(16)}`);
-  
-} catch (error) {
-  console.log('⚠ Preimage demonstration (requires transaction context)');
-  console.log('  Enhanced preimage parsing includes:');
-  console.log('  - Field-by-field BIP143 structure validation');
-  console.log('  - Proper endianness handling (little-endian fields)');
-  console.log('  - Variable-length field parsing (scriptCode)');
-  console.log('  - Comprehensive 108+ byte preimage validation');
-  console.log('  - Direct field access (nVersion, hashPrevouts, etc.)');
-}
-
-// Test 2: PUSHTX Covenant Creation
-console.log('\n2. PUSHTX COVENANT CREATION (nChain WP1605)');
-console.log('-'.repeat(60));
-
-try {
-  // Create PUSHTX covenant using nChain techniques
-  const pushtxCovenant = covenantInterface.createAdvancedCovenant('pushtx', {
-    publicKey: '0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798',
-    enforceOutputs: true,
-    sighashType: 0x41 // SIGHASH_ALL | SIGHASH_FORKID
-  });
-  
-  console.log('✓ PUSHTX covenant created successfully');
-  console.log(`  - Script length: ${pushtxCovenant.toBuffer().length} bytes`);
-  console.log(`  - Script hex: ${pushtxCovenant.toHex().substring(0, 80)}...`);
-  console.log('  - Features: In-script signature generation, message construction');
-  console.log('  - Optimization: k=a=1 (generator point as public key)');
-  console.log('  - Security: DER canonicalization prevents malleability');
-  
-} catch (error) {
-  console.error('✗ PUSHTX covenant creation failed:', error.message);
-}
-
-// Test 3: Perpetually Enforcing Locking Script (PELS)
-console.log('\n3. PERPETUALLY ENFORCING LOCKING SCRIPT (PELS)');
-console.log('-'.repeat(60));
-
-try {
-  // Create PELS that enforces same script and value minus fees
-  const pels = covenantInterface.createAdvancedCovenant('perpetual', {
-    publicKeyHash: '751e76e8199196d454941c45d1b3a323f1433bd6',
-    feeDeduction: 512, // Deduct 512 satoshis per transaction
-    enforceScript: true,
-    enforceValue: true
-  });
-  
-  console.log('✓ PELS (Perpetual Covenant) created successfully');
-  console.log(`  - Script length: ${pels.toBuffer().length} bytes`);
-  console.log('  - Enforcement: Same locking script + fee-adjusted value');
-  console.log('  - Fee model: 512 satoshi deduction per spend');
-  console.log('  - Perpetual: All future transactions must follow rules');
-  console.log('  - Use case: Certificate authority attestation chains');
-  
-} catch (error) {
-  console.error('✗ PELS creation failed:', error.message);
-}
-
-// Test 4: Transaction Introspection Covenant
-console.log('\n4. TRANSACTION INTROSPECTION COVENANT');
-console.log('-'.repeat(60));
-
-try {
-  // Create covenant that analyzes transaction structure via preimage
-  const introspectionCovenant = covenantInterface.createAdvancedCovenant('introspection', {
-    validateInputs: false,
-    validateOutputs: true,
-    validateSequence: false,
-    validateLocktime: false
-  });
-  
-  console.log('✓ Introspection covenant created successfully');
-  console.log(`  - Script length: ${introspectionCovenant.toBuffer().length} bytes`);
-  console.log('  - Analysis: Output validation via preimage parsing');
-  console.log('  - Fields: Selective validation of transaction components');
-  console.log('  - Application: Complex multi-party validation rules');
-  
-} catch (error) {
-  console.error('✗ Introspection covenant creation failed:', error.message);
-}
-
-// Test 5: Enhanced Covenant Transaction Wrapper
-console.log('\n5. ENHANCED COVENANT TRANSACTION WRAPPER');
-console.log('-'.repeat(60));
-
-try {
-  // Create covenant transaction with enhanced methods
-  const covenantTx = covenantInterface.createCovenantTransaction({
-    inputs: [],
-    outputs: [{
-      address: '1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa',
-      satoshis: 1000000
-    }]
-  });
-  
-  console.log('✓ Enhanced covenant transaction created');
-  console.log('  - Features: Preimage caching, enhanced error reporting');
-  console.log('  - Methods: getPreimage(), signInput(), verify()');
-  console.log('  - Integration: Works with existing BSV transaction API');
-  console.log('  - Dual-level: High-level abstractions + granular control');
-  
-} catch (error) {
-  console.error('✗ Covenant transaction creation failed:', error.message);
-}
-
-// Test 6: Comprehensive Technical Specifications
-console.log('\n6. TECHNICAL SPECIFICATIONS SUMMARY');
-console.log('-'.repeat(60));
-
-console.log('BIP143 Preimage Structure (Enhanced Parsing):');
-console.log('  • nVersion (4 bytes, little-endian) + value accessor');
-console.log('  • hashPrevouts (32 bytes) - double SHA256 of input outpoints');
-console.log('  • hashSequence (32 bytes) - double SHA256 of input sequences');
-console.log('  • outpoint (36 bytes) - prevTxId + outputIndex with accessors');
-console.log('  • scriptCode (variable) - proper varint length parsing');
-console.log('  • amount (8 bytes, little-endian) + BigInt value accessor');
-console.log('  • nSequence (4 bytes, little-endian) + value accessor');
-console.log('  • hashOutputs (32 bytes) - double SHA256 of all outputs');
-console.log('  • nLockTime (4 bytes, little-endian) + value accessor');
-console.log('  • sighashType (4 bytes, little-endian) + value accessor');
-console.log('  • Validation: 108+ byte structure validation');
-
-console.log('\nnChain PUSHTX Techniques (WP1605 Implementation):');
-console.log('  • In-script signature generation: s = z + Gx mod n');
-console.log('  • Generator optimization: k=a=1 for efficiency');
-console.log('  • DER canonicalization: s <= n/2 prevents malleability');
-console.log('  • Message construction: BIP143 preimage building');
-console.log('  • Security proof: Computationally infeasible to forge');
-console.log('  • Fixed parameters: public key, ephemeral key, sighash flag');
-
-console.log('\nAdvanced Covenant Patterns:');
-console.log('  • PUSHTX: Basic transaction introspection capability');
-console.log('  • PELS: Perpetually enforcing locking scripts');
-console.log('  • Introspection: Selective transaction field validation');
-console.log('  • Optimization: Alt stack usage, endianness reversal');
-console.log('  • Fee management: Configurable deduction per spend');
-console.log('  • Transaction size: ~1KB for optimized PELS implementation');
-
-// Test 7: Developer Usage Examples
-console.log('\n7. DEVELOPER USAGE EXAMPLES');
-console.log('-'.repeat(60));
-
-console.log('Basic PUSHTX Usage:');
-console.log('```javascript');
-console.log('const covenant = new CovenantInterface();');
-console.log('const pushtx = covenant.createAdvancedCovenant("pushtx", {');
-console.log('  publicKey: "02...", enforceOutputs: true');
-console.log('});');
-console.log('```');
-
-console.log('\nPerpetual Covenant Usage:');
-console.log('```javascript');
-console.log('const pels = covenant.createAdvancedCovenant("perpetual", {');
-console.log('  publicKeyHash: "751e...", feeDeduction: 512');
-console.log('});');
-console.log('```');
-
-console.log('\nEnhanced Transaction Usage:');
-console.log('```javascript');
-console.log('const tx = covenant.createCovenantTransaction(config);');
-console.log('const preimage = tx.getPreimage(0, script, satoshis);');
-console.log('const parsedPreimage = new CovenantPreimage(preimage);');
-console.log('console.log(parsedPreimage.amountValue); // BigInt accessor');
-console.log('```');
-
-console.log('\n' + '='.repeat(80));
-console.log('ADVANCED COVENANT INTERFACE READY FOR PRODUCTION');
-console.log('Features: BIP143 parsing + nChain PUSHTX + PELS + Full BSV API');
-console.log('Status: SmartLedger-BSV v3.1.1+ with comprehensive covenant support');
-console.log('='.repeat(80));

package/examples/covenants/covenant_interface_demo.js

@@ -1,270 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Covenant Interface Demo - High-Level + Granular Control
- * 
- * Shows how to use the new CovenantInterface alongside the existing BSV API
- * for maximum flexibility in covenant development.
- */
-
-const bsv = require('../index.js');
-const { CovenantInterface } = require('./lib/covenant-interface.js');
-
-console.log('🔮 SmartLedger Covenant Interface Demo');
-console.log('====================================');
-console.log(`BSV Library Version: ${bsv.version}`);
-console.log(`Date: ${new Date().toISOString()}\n`);
-
-// Initialize covenant interface (keeps full BSV access)
-const covenant = new CovenantInterface();
-
-// Test keys
-const privateKey1 = new bsv.PrivateKey('5KYZdUEo39z3FPrtuX2QbbwGnNP5zTd7yyr2SC1j299sBCnWjss');
-const publicKey1 = privateKey1.publicKey;
-const privateKey2 = new bsv.PrivateKey('5Hx15HFGyep2CfPxsJKe2fXJsCVn5DEiyoeGGF6JZjGbTRnqfiD');
-const publicKey2 = privateKey2.publicKey;
-const privateKey3 = new bsv.PrivateKey(); // Generate random key
-const publicKey3 = privateKey3.publicKey;
-
-console.log('🔧 Test Setup:');
-console.log(`Key 1: ${publicKey1.toAddress()}`);
-console.log(`Key 2: ${publicKey2.toAddress()}`);
-console.log(`Key 3: ${publicKey3.toAddress()}\n`);
-
-/**
- * Example 1: High-Level Covenant Creation with Granular Access
- */
-async function demoHighLevelCovenant() {
-  console.log('📝 EXAMPLE 1: High-Level Covenant with Granular Control');
-  console.log('======================================================');
-
-  // Create UTXO using standard BSV API
-  const utxo = {
-    txid: 'a'.repeat(64),
-    vout: 0,
-    script: bsv.Script.buildPublicKeyHashOut(publicKey1.toAddress()).toHex(),
-    satoshis: 100000
-  };
-
-  // ✨ Use high-level covenant interface
-  const covenantTx = covenant.createCovenantTransaction({
-    inputs: [utxo],
-    outputs: [
-      { address: publicKey2.toAddress().toString(), satoshis: 99000 }
-    ],
-    feePerKb: 10 // Ultra-low fees
-  });
-
-  // 🔍 Access granular BSV functionality when needed
-  console.log(`Transaction ID: ${covenantTx.tx.id}`);
-  console.log(`Fee: ${covenantTx.tx.getFee()} satoshis`);
-  
-  // Get preimage using high-level interface
-  const lockingScript = bsv.Script.fromHex(utxo.script);
-  const preimage = covenantTx.getPreimage(0, lockingScript, utxo.satoshis);
-  
-  console.log(`Preimage: ${preimage.toString().substring(0, 40)}...`);
-  console.log(`Preimage components available: ✅`);
-  console.log(`Version: ${preimage.getVersion().toString('hex')}`);
-  console.log(`Amount: ${preimage.getAmount().readBigUInt64LE(0)} satoshis`);
-  
-  // Sign using high-level interface
-  covenantTx.signInput(0, privateKey1, lockingScript, utxo.satoshis);
-  
-  console.log(`Covenant transaction valid: ${covenantTx.verify() ? '✅ YES' : '❌ NO'}`);
-  console.log(`High-level interface: ✅ WORKING\n`);
-}
-
-/**
- * Example 2: Template-Based Escrow Covenant
- */
-async function demoEscrowCovenant() {
-  console.log('📝 EXAMPLE 2: Template-Based Escrow Covenant');
-  console.log('===========================================');
-
-  // ✨ Create escrow using template (high-level)
-  const escrowScript = covenant.createEscrow(
-    publicKey1, // buyer
-    publicKey2, // seller  
-    publicKey3, // arbitrator
-    700000      // timelock for refund
-  );
-
-  console.log(`Escrow script: ${escrowScript.toString()}`);
-
-  const utxo = {
-    txid: 'b'.repeat(64),
-    vout: 0,
-    script: escrowScript.toHex(),
-    satoshis: 200000
-  };
-
-  // Create transaction with high-level interface
-  const escrowTx = covenant.createCovenantTransaction({
-    inputs: [utxo],
-    outputs: [
-      { address: publicKey2.toAddress().toString(), satoshis: 199000 }
-    ]
-  });
-
-  // 🔍 Granular control: Manual signature creation for 2-of-3 multisig
-  const sig1 = covenant.createSignature(escrowTx.tx, privateKey1, 0, escrowScript, utxo.satoshis);
-  const sig2 = covenant.createSignature(escrowTx.tx, privateKey2, 0, escrowScript, utxo.satoshis);
-
-  // Create custom unlocking script (granular BSV control)
-  const unlockingScript = new bsv.Script()
-    .add(bsv.Opcode.OP_0) // CHECKMULTISIG bug
-    .add(sig1)
-    .add(sig2)
-    .add(bsv.Opcode.OP_0); // Choose ELSE branch (multisig, not timelock)
-
-  escrowTx.tx.inputs[0].setScript(unlockingScript);
-
-  // Validate using high-level interface
-  const validation = covenant.validateCovenant(
-    escrowTx.tx, 0, unlockingScript, escrowScript
-  );
-
-  console.log(`Escrow validation: ${validation.toString()}`);
-  console.log(`Template + granular control: ✅ WORKING\n`);
-}
-
-/**
- * Example 3: State Machine Covenant
- */
-async function demoStateMachine() {
-  console.log('📝 EXAMPLE 3: State Machine Covenant');
-  console.log('===================================');
-
-  // Define states for a simple workflow
-  const states = [
-    { name: 'PENDING', nextStates: [1, 2] },    // Can go to APPROVED or REJECTED
-    { name: 'APPROVED', nextStates: [3] },      // Can go to COMPLETED
-    { name: 'REJECTED', nextStates: [0] },      // Can go back to PENDING
-    { name: 'COMPLETED', nextStates: [] }       // Terminal state
-  ];
-
-  // ✨ Create state machine using template
-  const stateMachineScript = covenant.createStateMachine(states, 0, publicKey1);
-
-  console.log(`State machine created: ${stateMachineScript.toString().length} bytes`);
-  console.log(`Current state: PENDING (0)`);
-  console.log(`Valid transitions: APPROVED (1), REJECTED (2)`);
-  console.log(`Template-based covenant: ✅ WORKING\n`);
-}
-
-/**
- * Example 4: Full BSV API Access Preserved
- */
-async function demoGranularAccess() {
-  console.log('📝 EXAMPLE 4: Full BSV API Access Preserved');
-  console.log('==========================================');
-
-  // 🔍 Full access to underlying BSV library
-  console.log(`BSV Library accessible: ${covenant.bsv === bsv ? '✅ YES' : '❌ NO'}`);
-  
-  // Create transaction using pure BSV API
-  const pureBsvTx = new bsv.Transaction()
-    .from({
-      txid: 'c'.repeat(64),
-      vout: 0,
-      script: bsv.Script.buildPublicKeyHashOut(publicKey1.toAddress()).toHex(),
-      satoshis: 50000
-    })
-    .to(publicKey2.toAddress(), 49000)
-    .sign(privateKey1);
-
-  console.log(`Pure BSV transaction: ${pureBsvTx.verify() ? '✅ VALID' : '❌ INVALID'}`);
-
-  // Mix covenant interface with BSV API
-  const mixedSignature = covenant.createSignature(
-    pureBsvTx,
-    privateKey1,
-    0,
-    bsv.Script.buildPublicKeyHashOut(publicKey1.toAddress()),
-    50000
-  );
-
-  console.log(`Mixed API signature: ${mixedSignature.length} bytes`);
-  console.log(`BSV API compatibility: ✅ PRESERVED\n`);
-}
-
-/**
- * Example 5: Performance and Flexibility Comparison
- */
-async function demoComparison() {
-  console.log('📝 EXAMPLE 5: Interface Comparison');
-  console.log('=================================');
-
-  // High-level approach
-  console.time('High-level covenant creation');
-  const highLevelTx = covenant.createCovenantTransaction({
-    inputs: [{
-      txid: 'd'.repeat(64),
-      vout: 0,
-      script: bsv.Script.buildPublicKeyHashOut(publicKey1.toAddress()).toHex(),
-      satoshis: 75000
-    }],
-    outputs: [
-      { address: publicKey2.toAddress().toString(), satoshis: 74000 }
-    ]
-  });
-  console.timeEnd('High-level covenant creation');
-
-  // Granular BSV approach
-  console.time('Granular BSV creation');
-  const granularTx = new bsv.Transaction()
-    .from({
-      txid: 'd'.repeat(64),
-      vout: 0,
-      script: bsv.Script.buildPublicKeyHashOut(publicKey1.toAddress()).toHex(),
-      satoshis: 75000
-    })
-    .to(publicKey2.toAddress(), 74000);
-  console.timeEnd('Granular BSV creation');
-
-  console.log(`Both approaches available: ✅ YES`);
-  console.log(`Developer choice preserved: ✅ YES`);
-  console.log(`No breaking changes: ✅ CONFIRMED\n`);
-}
-
-/**
- * Run all demos
- */
-async function runAllDemos() {
-  try {
-    await demoHighLevelCovenant();
-    await demoEscrowCovenant();
-    await demoStateMachine();
-    await demoGranularAccess();
-    await demoComparison();
-
-    console.log('🎉 COVENANT INTERFACE RESULTS');
-    console.log('============================');
-    console.log('✅ High-level covenant interface: WORKING');
-    console.log('✅ Template-based covenant creation: WORKING');
-    console.log('✅ Granular BSV API access: PRESERVED');
-    console.log('✅ Preimage parsing and access: WORKING');
-    console.log('✅ Mixed API usage: SUPPORTED');
-    console.log('✅ No breaking changes: CONFIRMED');
-    console.log('');
-    console.log('🚀 Best of Both Worlds:');
-    console.log('   - Simple covenant templates for rapid development');
-    console.log('   - Full BSV API access for granular control');
-    console.log('   - Backward compatibility with existing code');
-    console.log('   - Enhanced preimage parsing and validation');
-
-  } catch (error) {
-    console.error('❌ Demo failed:', error.message);
-  }
-}
-
-console.log('🎯 COVENANT INTERFACE PHILOSOPHY');
-console.log('===============================');
-console.log('✨ High-level abstractions for common patterns');
-console.log('🔍 Granular BSV API access when needed');
-console.log('🔄 Full backward compatibility');
-console.log('📈 Enhanced developer productivity\n');
-
-// Run the demos
-runAllDemos();