@smartledger/bsv 3.4.3 → 3.4.4

package/examples/legacy/test_shamir.js

@@ -1,221 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * BSV Shamir Secret Sharing Test
- * Comprehensive test of the Shamir Secret Sharing implementation
- */
-
-'use strict'
-
-console.log('=== BSV Shamir Secret Sharing Test ===\n')
-
-// Load the BSV library with Shamir support
-var bsv
-try {
-  bsv = require('./index.js')
-  console.log('✓ Loaded BSV library with Shamir support')
-} catch (e) {
-  console.error('✗ Failed to load BSV library:', e.message)
-  process.exit(1)
-}
-
-// Test 1: Basic functionality test
-console.log('\n--- Test 1: Basic Secret Sharing ---')
-try {
-  var secret = 'Hello, Bitcoin SV!'
-  var threshold = 3
-  var shares = 5
-  
-  console.log('Original secret:', secret)
-  console.log('Threshold:', threshold, '/ Total shares:', shares)
-  
-  // Split the secret
-  var splitShares = bsv.Shamir.split(secret, threshold, shares)
-  console.log('✓ Successfully split secret into', splitShares.length, 'shares')
-  
-  // Reconstruct with minimum shares
-  var reconstructed = bsv.Shamir.combine(splitShares.slice(0, threshold))
-  var reconstructedSecret = reconstructed.toString('utf8')
-  
-  console.log('Reconstructed:', reconstructedSecret)
-  
-  if (reconstructedSecret === secret) {
-    console.log('✓ Test 1 PASSED: Secret correctly reconstructed')
-  } else {
-    console.log('✗ Test 1 FAILED: Secret reconstruction failed')
-  }
-} catch (e) {
-  console.log('✗ Test 1 ERROR:', e.message)
-}
-
-// Test 2: Larger secret test
-console.log('\n--- Test 2: Large Secret Test ---')
-try {
-  var largeSecret = 'This is a much longer secret that will test the chunking functionality of the Shamir Secret Sharing implementation. It should handle secrets of arbitrary length by breaking them into manageable chunks and processing each chunk separately.'
-  var threshold2 = 4
-  var shares2 = 7
-  
-  console.log('Large secret length:', largeSecret.length, 'characters')
-  
-  var splitShares2 = bsv.Shamir.split(largeSecret, threshold2, shares2)
-  console.log('✓ Successfully split large secret')
-  
-  var reconstructed2 = bsv.Shamir.combine(splitShares2.slice(0, threshold2))
-  var reconstructedSecret2 = reconstructed2.toString('utf8')
-  
-  if (reconstructedSecret2 === largeSecret) {
-    console.log('✓ Test 2 PASSED: Large secret correctly reconstructed')
-  } else {
-    console.log('✗ Test 2 FAILED: Large secret reconstruction failed')
-    console.log('Expected length:', largeSecret.length)
-    console.log('Actual length:', reconstructedSecret2.length)
-    console.log('First 50 chars expected:', largeSecret.substring(0, 50))
-    console.log('First 50 chars actual  :', reconstructedSecret2.substring(0, 50))
-    console.log('Match:', largeSecret === reconstructedSecret2)
-  }
-} catch (e) {
-  console.log('✗ Test 2 ERROR:', e.message)
-}
-
-// Test 3: Different share combinations
-console.log('\n--- Test 3: Share Combination Test ---')
-try {
-  var secret3 = 'Testing different combinations'
-  var splitShares3 = bsv.Shamir.split(secret3, 3, 6)
-  
-  // Test different combinations of 3 shares
-  var combinations = [
-    [0, 1, 2], // First three
-    [1, 3, 5], // Every other
-    [2, 4, 5]  // Last three + one
-  ]
-  
-  var allPassed = true
-  for (var i = 0; i < combinations.length; i++) {
-    var combo = combinations[i]
-    var testShares = combo.map(function(idx) { return splitShares3[idx] })
-    var reconstructed3 = bsv.Shamir.combine(testShares)
-    var result = reconstructed3.toString('utf8')
-    
-    if (result === secret3) {
-      console.log('✓ Combination', combo, 'successful')
-    } else {
-      console.log('✗ Combination', combo, 'failed')
-      allPassed = false
-    }
-  }
-  
-  if (allPassed) {
-    console.log('✓ Test 3 PASSED: All share combinations work')
-  } else {
-    console.log('✗ Test 3 FAILED: Some combinations failed')
-  }
-} catch (e) {
-  console.log('✗ Test 3 ERROR:', e.message)
-}
-
-// Test 4: Share verification
-console.log('\n--- Test 4: Share Verification Test ---')
-try {
-  var secret4 = 'Verification test'
-  var splitShares4 = bsv.Shamir.split(secret4, 2, 4)
-  
-  var validCount = 0
-  for (var j = 0; j < splitShares4.length; j++) {
-    if (bsv.Shamir.verifyShare(splitShares4[j])) {
-      validCount++
-    }
-  }
-  
-  if (validCount === splitShares4.length) {
-    console.log('✓ Test 4 PASSED: All shares verified as valid')
-  } else {
-    console.log('✗ Test 4 FAILED: Only', validCount, 'of', splitShares4.length, 'shares valid')
-  }
-  
-  // Test invalid share
-  var invalidShare = { invalid: 'data' }
-  if (!bsv.Shamir.verifyShare(invalidShare)) {
-    console.log('✓ Invalid share correctly rejected')
-  } else {
-    console.log('✗ Invalid share incorrectly accepted')
-  }
-} catch (e) {
-  console.log('✗ Test 4 ERROR:', e.message)
-}
-
-// Test 5: Error handling
-console.log('\n--- Test 5: Error Handling Test ---')
-try {
-  var errorTests = [
-    function() { bsv.Shamir.split('', 2, 3) }, // Empty secret
-    function() { bsv.Shamir.split('secret', 1, 3) }, // Threshold too low
-    function() { bsv.Shamir.split('secret', 3, 2) }, // More threshold than shares
-    function() { bsv.Shamir.combine([]) }, // Empty shares array
-    function() { bsv.Shamir.combine([{id: 1, threshold: 2, shares: 3, length: 1, bytes: []}]) } // Insufficient shares
-  ]
-  
-  var errorsPassed = 0
-  for (var k = 0; k < errorTests.length; k++) {
-    try {
-      errorTests[k]()
-      console.log('✗ Error test', k + 1, 'should have thrown an error')
-    } catch (e) {
-      console.log('✓ Error test', k + 1, 'correctly threw:', e.message)
-      errorsPassed++
-    }
-  }
-  
-  if (errorsPassed === errorTests.length) {
-    console.log('✓ Test 5 PASSED: All error conditions handled correctly')
-  } else {
-    console.log('✗ Test 5 FAILED: Some error conditions not handled')
-  }
-} catch (e) {
-  console.log('✗ Test 5 ERROR:', e.message)
-}
-
-// Test 6: Binary data test
-console.log('\n--- Test 6: Binary Data Test ---')
-try {
-  var binaryData = Buffer.from([0x00, 0x01, 0x02, 0xFF, 0xFE, 0xFD, 0x80, 0x7F])
-  var splitBinary = bsv.Shamir.split(binaryData, 2, 3)
-  var reconstructedBinary = bsv.Shamir.combine(splitBinary.slice(0, 2))
-  
-  if (Buffer.compare(binaryData, reconstructedBinary) === 0) {
-    console.log('✓ Test 6 PASSED: Binary data correctly handled')
-  } else {
-    console.log('✗ Test 6 FAILED: Binary data reconstruction failed')
-    console.log('Original:', Array.from(binaryData))
-    console.log('Reconstructed:', Array.from(reconstructedBinary))
-  }
-} catch (e) {
-  console.log('✗ Test 6 ERROR:', e.message)
-}
-
-// Test 7: Generate test vectors
-console.log('\n--- Test 7: Test Vectors Generation ---')
-try {
-  var testVectors = bsv.Shamir.generateTestVectors()
-  
-  console.log('Test vectors generated:')
-  console.log('- Secret:', testVectors.secret)
-  console.log('- Threshold:', testVectors.threshold)
-  console.log('- Total shares:', testVectors.totalShares)
-  console.log('- Shares generated:', testVectors.shares.length)
-  console.log('- Reconstruction successful:', testVectors.valid)
-  
-  if (testVectors.valid) {
-    console.log('✓ Test 7 PASSED: Test vectors generated and validated')
-  } else {
-    console.log('✗ Test 7 FAILED: Test vectors validation failed')
-  }
-} catch (e) {
-  console.log('✗ Test 7 ERROR:', e.message)
-}
-
-console.log('\n=== Shamir Secret Sharing Tests Complete ===')
-console.log('💡 Integration successful! Shamir Secret Sharing is now available in:')
-console.log('   • Main library: bsv.Shamir or bsv.crypto.Shamir')
-console.log('   • Standalone: bsv-shamir.min.js (after build)')
-console.log('   • CDN ready: Use npm run build-shamir to generate minified version')

package/examples/legacy/test_smartverify_der.js

@@ -1,110 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Test SmartVerify DER Buffer Handling
- * 
- * Tests SmartVerify with different input types to isolate the DER parsing issue
- */
-
-const bsv = require('./index.js');
-
-console.log('🔍 Test SmartVerify DER Buffer Handling');
-console.log('=======================================\n');
-
-// Simple signature test like minimal reproduction
-const privateKey = new bsv.PrivateKey('L1aW4aubDFB7yfras2S1mN3bqg9nwySY8nkoLmJebSLD5BWv3ENZ');
-const publicKey = privateKey.publicKey;
-const message = Buffer.from('hello world', 'utf8');
-const hash = bsv.crypto.Hash.sha256(message);
-
-console.log('Creating signature...');
-const signature = bsv.crypto.ECDSA.sign(hash, privateKey);
-const derSig = signature.toDER();
-
-console.log(`Original signature r: ${signature.r.toString('hex')}`);
-console.log(`Original signature s: ${signature.s.toString('hex')}`);
-console.log(`DER buffer: ${derSig.toString('hex')}`);
-console.log(`DER length: ${derSig.length}`);
-
-console.log('\n🧪 SmartVerify Test Matrix:');
-console.log('===========================');
-
-// Test 1: Signature object
-const smartVerifyObj = bsv.SmartVerify.smartVerify(hash, signature, publicKey);
-console.log(`SmartVerify(hash, sigObject, pubkey): ${smartVerifyObj ? '✅ VALID' : '❌ INVALID'}`);
-
-// Test 2: DER buffer
-const smartVerifyBuffer = bsv.SmartVerify.smartVerify(hash, derSig, publicKey);
-console.log(`SmartVerify(hash, derBuffer, pubkey): ${smartVerifyBuffer ? '✅ VALID' : '❌ INVALID'}`);
-
-// Test 3: Manually parsed DER
-try {
-  const parsedFromDER = bsv.crypto.Signature.fromDER(derSig);
-  console.log(`Parsed from DER r: ${parsedFromDER.r.toString('hex')}`);
-  console.log(`Parsed from DER s: ${parsedFromDER.s.toString('hex')}`);
-  
-  const smartVerifyParsed = bsv.SmartVerify.smartVerify(hash, parsedFromDER, publicKey);
-  console.log(`SmartVerify(hash, parsedSig, pubkey): ${smartVerifyParsed ? '✅ VALID' : '❌ INVALID'}`);
-  
-  console.log('\n🔍 Compare r,s values:');
-  console.log('======================');
-  console.log(`Original r: ${signature.r.toString('hex')}`);
-  console.log(`Parsed r  : ${parsedFromDER.r.toString('hex')}`);
-  console.log(`r matches : ${signature.r.eq(parsedFromDER.r) ? '✅ YES' : '❌ NO'}`);
-  
-  console.log(`Original s: ${signature.s.toString('hex')}`);
-  console.log(`Parsed s  : ${parsedFromDER.s.toString('hex')}`);  
-  console.log(`s matches : ${signature.s.eq(parsedFromDER.s) ? '✅ YES' : '❌ NO'}`);
-  
-} catch (error) {
-  console.log(`❌ DER parsing failed: ${error.message}`);
-}
-
-console.log('\n🔧 Debug SmartVerify DER Parsing:');
-console.log('==================================');
-
-// Let's manually step through what SmartVerify does with DER buffers
-try {
-  console.log('Step 1: Input validation...');
-  console.log(`  Hash is Buffer: ${Buffer.isBuffer(hash)}`);
-  console.log(`  Hash length: ${hash.length}`);
-  console.log(`  DER is Buffer: ${Buffer.isBuffer(derSig)}`);
-  
-  console.log('Step 2: DER parsing in SmartVerify...');
-  
-  // This replicates what SmartVerify does internally
-  const Signature = bsv.crypto.Signature;
-  const testParsed = Signature.fromDER(derSig);
-  console.log(`  Parsed successfully: ✅`);
-  console.log(`  Parsed r: ${testParsed.r.toString('hex')}`);
-  console.log(`  Parsed s: ${testParsed.s.toString('hex')}`);
-  
-  const BN = bsv.crypto.BN;
-  const r = BN.isBN(testParsed.r) ? testParsed.r : new BN(testParsed.r);
-  const s = BN.isBN(testParsed.s) ? testParsed.s : new BN(testParsed.s);
-  console.log(`  r as BN: ${r.toString('hex')}`);
-  console.log(`  s as BN: ${s.toString('hex')}`);
-  
-  // Check canonicalization  
-  const Point = bsv.crypto.Point;
-  const n = Point.getN();
-  const nh = n.shrn(1);
-  console.log(`  s > n/2: ${s.gt(nh)}`);
-  
-  const canonicalS = s.gt(nh) ? n.sub(s) : s;
-  console.log(`  canonical s: ${canonicalS.toString('hex')}`);
-  
-  // Test final ECDSA call
-  const canonicalSig = new Signature({
-    r: r,
-    s: canonicalS
-  });
-  
-  const ECDSA = bsv.crypto.ECDSA;
-  const finalResult = ECDSA.verify(hash, canonicalSig, publicKey, 'little');
-  console.log(`  Final ECDSA result: ${finalResult ? '✅ VALID' : '❌ INVALID'}`);
-  
-} catch (error) {
-  console.log(`❌ Debug failed: ${error.message}`);
-  console.log(`Stack: ${error.stack}`);
-}

package/examples/preimage/README.md

@@ -1,178 +0,0 @@
-# BIP-143 Preimage Tools
-
-This directory contains tools and examples for working with Bitcoin BIP-143 transaction preimages.
-
-## Files
-
-### `extract_preimage_bidirectional.js`
-**Advanced bidirectional preimage field extractor with optimal ASM generation**
-
-Intelligently extracts any BIP-143 preimage field using the most efficient strategy:
-- **LEFT extraction** for early fields (nVersion, hashPrevouts, etc.)
-- **RIGHT extraction** for late fields (value, nLocktime, sighashType, etc.)  
-- **DYNAMIC extraction** for variable-length scriptCode
-
-#### Features
-- ✅ Complete BIP-143 specification compliance
-- ✅ Optimal operation count for each field
-- ✅ Generates production-ready Bitcoin Script ASM
-- ✅ Handles variable scriptCode dynamically
-- ✅ Robust error handling and validation
-- ✅ Field interpretation (satoshis, version numbers, etc.)
-
-#### Usage
-```bash
-# Extract any preimage field
-node extract_preimage_bidirectional.js <preimage_hex> <field_name>
-
-# Examples
-node extract_preimage_bidirectional.js 01000000ab12cd... scriptCode
-node extract_preimage_bidirectional.js 01000000ab12cd... value
-node extract_preimage_bidirectional.js 01000000ab12cd... sighashType
-```
-
-#### Available Fields
-
-**LEFT Fields (fixed offsets from start):**
-- `nVersion` (4 bytes) - Transaction version
-- `hashPrevouts` (32 bytes) - Hash of all input outpoints  
-- `hashSequence` (32 bytes) - Hash of all input sequences
-- `outpoint_txid` (32 bytes) - Current input's previous transaction ID
-- `outpoint_vout` (4 bytes) - Current input's previous output index
-- `scriptLen` (1 byte) - Length of the scriptCode
-
-**DYNAMIC Field (uses internal length):**
-- `scriptCode` (variable) - The script being executed
-
-**RIGHT Fields (fixed offsets from end):**
-- `value` (8 bytes) - Input amount in satoshis
-- `nSequence` (4 bytes) - Current input's sequence number
-- `hashOutputs` (32 bytes) - Hash of all outputs
-- `nLocktime` (4 bytes) - Transaction lock time
-- `sighashType` (4 bytes) - Signature hash type
-
-#### Integration with Covenant Framework
-
-The generated ASM can be used directly in covenant locking scripts:
-
-```javascript
-const { CovenantInterface } = require('../../lib/covenant-interface');
-
-// Use bidirectional extraction in covenant
-const covenant = new CovenantInterface();
-const script = covenant.createAdvancedCovenant({
-  type: 'custom',
-  rules: {
-    // Insert generated ASM for preimage field extraction
-    extractValue: `
-      # Generated by extract_preimage_bidirectional.js
-      OP_SIZE
-      52 OP_SUB
-      OP_SPLIT
-      OP_DROP
-      8 OP_SPLIT
-      OP_DROP
-    `
-  }
-});
-```
-
-#### BIP-143 Structure Reference
-
-```
-Total: LEFT(105) + scriptCode(variable) + RIGHT(52) bytes
-
-LEFT ZONE (105 bytes):           DYNAMIC:              RIGHT ZONE (52 bytes):
-├─ nVersion (4)                  ├─ scriptCode         ├─ value (8) 
-├─ hashPrevouts (32)             └─ (scriptLen bytes)  ├─ nSequence (4)
-├─ hashSequence (32)                                   ├─ hashOutputs (32)
-├─ outpoint_txid (32)                                  ├─ nLocktime (4)
-├─ outpoint_vout (4)                                   └─ sighashType (4)
-└─ scriptLen (1)
-```
-
-## See Also
-- `../../docs/preimage.md` - BIP-143 technical specification
-- `../../docs/ADVANCED_COVENANT_DEVELOPMENT.md` - Covenant implementation guide
-- `../covenants/` - Complete covenant examples using preimage extraction
-- `../../lib/covenant-interface.js` - CovenantPreimage class implementation
-
-### `generate_sighash_examples.js`
-**SIGHASH flag preimage generator demonstrating "zero hash" behavior**
-
-Explains why multi-input transactions appear to have "extra zeros" - they're not bugs but required by BIP-143 SIGHASH rules:
-
-#### Features
-- ✅ Complete SIGHASH flag support (ALL, NONE, SINGLE, ANYONECANPAY)
-- ✅ Demonstrates zero hash field behavior  
-- ✅ Educational tool for multi-input transaction analysis
-- ✅ Integration with bidirectional extractor
-
-#### Usage
-```bash
-# Generate SIGHASH examples
-node generate_sighash_examples.js [sighash_type]
-
-# Examples showing zero hash behavior
-node generate_sighash_examples.js ALL_ANYONECANPAY_FORKID   # Zero hashPrevouts + hashSequence
-node generate_sighash_examples.js NONE_FORKID              # Zero hashOutputs
-node generate_sighash_examples.js NONE_ANYONECANPAY_FORKID # Zero all hash fields
-```
-
-#### SIGHASH Flag Behavior
-| SIGHASH Type | hashPrevouts | hashSequence | hashOutputs | Use Case |
-|--------------|-------------|-------------|-------------|-----------|
-| ALL_FORKID | Normal | Normal | Normal | Standard signing |
-| NONE_FORKID | Normal | Normal | **Zero** | Blank check |
-| SINGLE_FORKID | Normal | Normal | **Zero** | One-to-one |
-| ALL_ANYONECANPAY_FORKID | **Zero** | **Zero** | Normal | Crowdfunding |
-| NONE_ANYONECANPAY_FORKID | **Zero** | **Zero** | **Zero** | Maximum flexibility |
-
-### `test_varint_extraction.js`
-**Comprehensive CompactSize varint test suite**
-
-Validates proper parsing of 1-3 byte CompactSize varints in real-world scenarios:
-- 1-byte encoding: 0-252 bytes (most common)
-- 3-byte encoding: 253-65535 bytes (large scripts)
-- 5-byte encoding: 65536+ bytes (huge scripts)
-
-## 🧠 **Understanding the "Extra Zero" Mystery**
-
-### The Problem
-Developers often see patterns like this in BSV preimages and think it's a bug:
-```
-...1976a914000000000000...
-```
-
-### The Reality 
-These zeros are **intentional** and required by Bitcoin's BIP-143 specification:
-
-1. **CompactSize Varint Encoding**
-   - Scripts ≥253 bytes use 3-byte encoding: `0xFD + 2-byte length`
-   - This adds "extra bytes" that look like zeros to developers expecting 1-byte
-
-2. **SIGHASH Flag Behavior**  
-   - `ANYONECANPAY`: Zeros out `hashPrevouts` and `hashSequence` (64 zero bytes)
-   - `NONE`: Zeros out `hashOutputs` (32 zero bytes)
-   - `SINGLE`: Zeros out `hashOutputs` for unmatched outputs
-
-3. **Multi-Input Concatenation Issues**
-   - Wrong byte boundary slicing between inputs
-   - Reusing preimage buffers without proper re-serialization
-
-### The Solution
-Our bidirectional extractor handles all these cases:
-- ✅ **Auto-detects** CompactSize varint size (1-3 bytes)
-- ✅ **Warns about** zero hashes with SIGHASH flag context
-- ✅ **Validates** preimage structure against BIP-143
-- ✅ **Generates** optimal ASM regardless of complexity
-
-## Performance Notes
-
-The enhanced bidirectional strategy minimizes script operations:
-- **LEFT fields**: Direct offset splitting (2-3 operations)
-- **RIGHT fields**: Size-based splitting (3-4 operations)  
-- **scriptCode**: Dynamic extraction using CompactSize varint (3-4 operations)
-- **Zero hash detection**: Automatic with contextual warnings
-
-This is significantly more efficient than linear parsing and handles all BIP-143 edge cases that break traditional parsers.