smartledger-bsv 3.2.2 → 3.3.1

package/simple_demo.js

@@ -0,0 +1,204 @@
+/**
+ * SmartLedger-BSV Legal Token Protocol (LTP) - Primitives-Only Architecture Demo
+ * 
+ * This demonstrates the architectural transformation from application framework
+ * to foundation library with primitives-only approach.
+ */
+
+const bsv = require('./index.js')
+
+console.log('🚀 SmartLedger-BSV LTP: Primitives-Only Architecture')
+console.log('==================================================\n')
+
+console.log('🔄 ARCHITECTURAL TRANSFORMATION COMPARISON')
+console.log('------------------------------------------\n')
+
+/**
+ * BEFORE vs AFTER: Key Differences
+ */
+console.log('📋 BEFORE (Application Framework Approach):')
+console.log('--------------------------------------------')
+console.log('❌ bsv.createRightToken()     → Created AND published to blockchain')
+console.log('❌ bsv.validateLegalClaim()   → Validated AND stored in database')
+console.log('❌ bsv.anchorTokenBatch()     → Created batch AND sent transaction')
+console.log('❌ bsv.createLegalRegistry()  → Created registry AND managed storage')
+console.log('❌ bsv.transferRight()        → Prepared transfer AND published')
+console.log('')
+console.log('   Problems with this approach:')
+console.log('   • Library had too many responsibilities')
+console.log('   • Developers locked into specific platforms')
+console.log('   • Hard to integrate with existing systems')
+console.log('   • Mixed crypto logic with application logic')
+console.log('')
+
+console.log('📋 AFTER (Primitives-Only Approach):')
+console.log('-------------------------------------')
+console.log('✅ bsv.prepareRightToken()           → Prepares token structure only')
+console.log('✅ bsv.prepareClaimValidation()      → Validates structure only')
+console.log('✅ bsv.prepareBatchCommitment()      → Prepares commitment only')
+console.log('✅ bsv.prepareRegistry()             → Prepares registry data only')
+console.log('✅ bsv.prepareRightTokenTransfer()   → Prepares transfer data only')
+console.log('')
+console.log('   Benefits of this approach:')
+console.log('   • Clear separation of concerns')
+console.log('   • Maximum developer flexibility')
+console.log('   • Easy integration with any system')
+console.log('   • Focus on cryptographic correctness')
+console.log('')
+
+/**
+ * DEMONSTRATE THE NEW INTERFACE
+ */
+console.log('🛠️ NEW PRIMITIVES INTERFACE AVAILABLE:')
+console.log('======================================\n')
+
+console.log('🏛️ RIGHT TOKEN PRIMITIVES:')
+console.log('   • bsv.prepareRightToken()')
+console.log('   • bsv.prepareRightTokenVerification()')
+console.log('   • bsv.prepareRightTokenTransfer()')
+console.log('   • bsv.prepareRightTypeValidation()')
+console.log('')
+
+console.log('⚖️ OBLIGATION TOKEN PRIMITIVES:')
+console.log('   • bsv.prepareObligationToken()')
+console.log('   • bsv.prepareObligationVerification()')
+console.log('   • bsv.prepareObligationFulfillment()')
+console.log('   • bsv.prepareObligationBreachAssessment()')
+console.log('   • bsv.prepareObligationMonitoringReport()')
+console.log('')
+
+console.log('📝 CLAIM VALIDATION PRIMITIVES:')
+console.log('   • bsv.prepareClaimValidation()')
+console.log('   • bsv.prepareClaimAttestation()')
+console.log('   • bsv.prepareClaimDispute()')
+console.log('   • bsv.prepareBulkClaimValidation()')
+console.log('   • bsv.prepareClaimTemplate()')
+console.log('')
+
+console.log('🔐 PROOF GENERATION PRIMITIVES:')
+console.log('   • bsv.prepareSignatureProof()')
+console.log('   • bsv.prepareSelectiveDisclosure()')
+console.log('   • bsv.prepareLegalValidityProof()')
+console.log('   • bsv.prepareZeroKnowledgeProof()')
+console.log('')
+
+console.log('📚 REGISTRY MANAGEMENT PRIMITIVES:')
+console.log('   • bsv.prepareRegistry()')
+console.log('   • bsv.prepareTokenRegistration()')
+console.log('   • bsv.prepareTokenApproval()')
+console.log('   • bsv.prepareTokenRevocation()')
+console.log('   • bsv.prepareTokenStatusQuery()')
+console.log('   • bsv.prepareTokenSearch()')
+console.log('')
+
+console.log('⛓️ BLOCKCHAIN ANCHORING PRIMITIVES:')
+console.log('   • bsv.prepareTokenCommitment()')
+console.log('   • bsv.prepareBatchCommitment()')
+console.log('   • bsv.verifyTokenAnchor()')
+console.log('   • bsv.formatRevocation()')
+console.log('')
+
+/**
+ * SHOW UTILITY FUNCTIONS (UNCHANGED)
+ */
+console.log('🔧 UTILITY FUNCTIONS (Unchanged):')
+console.log('   • bsv.getRightTypes()           → Static data access')
+console.log('   • bsv.getObligationTypes()      → Static data access')
+console.log('   • bsv.getClaimSchemas()         → Static data access')
+console.log('   • bsv.canonicalizeClaim()       → Data transformation')
+console.log('   • bsv.hashClaim()               → Hash generation')
+console.log('')
+
+/**
+ * EXAMPLE USAGE PATTERN
+ */
+console.log('💡 EXAMPLE: How Applications Use The New Primitives')
+console.log('===================================================\n')
+
+console.log('// STEP 1: Use SmartLedger-BSV to prepare legal structures')
+console.log('const rightTokenPrep = bsv.prepareRightToken(')
+console.log('  "PROPERTY_OWNERSHIP", issuerDID, ownerDID, claimData, privateKey')
+console.log(')')
+console.log('')
+
+console.log('// STEP 2: Use external system to publish to blockchain')
+console.log('const blockchainResult = await MyBlockchain.publish({')
+console.log('  commitment: rightTokenPrep.commitment,')
+console.log('  signature: rightTokenPrep.signature')
+console.log('})')
+console.log('')
+
+console.log('// STEP 3: Use external system to store in registry')
+console.log('const registryResult = await MyRegistry.store({')
+console.log('  token: rightTokenPrep.token,')
+console.log('  metadata: rightTokenPrep.metadata')
+console.log('})')
+console.log('')
+
+console.log('// STEP 4: Use SmartLedger-BSV to verify the results')
+console.log('const verification = bsv.verifyTokenAnchor(')
+console.log('  rightTokenPrep.token, blockchainResult.txid')
+console.log(')')
+console.log('')
+
+/**
+ * BENEFITS SUMMARY
+ */
+console.log('🎯 PRIMITIVES-ONLY ARCHITECTURE BENEFITS')
+console.log('========================================\n')
+
+console.log('👨‍💻 FOR DEVELOPERS:')
+console.log('   ✅ Choose your own blockchain (BSV, Bitcoin, Ethereum, etc.)')
+console.log('   ✅ Choose your own storage (SQL, NoSQL, IPFS, etc.)')
+console.log('   ✅ Choose your own UI framework (React, Vue, Angular, etc.)')
+console.log('   ✅ Integrate with existing business systems')
+console.log('   ✅ Maintain full control over user experience')
+console.log('')
+
+console.log('🏢 FOR ENTERPRISES:')
+console.log('   ✅ No vendor lock-in to specific platforms')
+console.log('   ✅ Compliance with existing IT policies')
+console.log('   ✅ Integration with legacy systems')
+console.log('   ✅ Scalable architecture patterns')
+console.log('   ✅ Audit-friendly separation of concerns')
+console.log('')
+
+console.log('🔒 FOR SECURITY:')
+console.log('   ✅ Cryptographic operations isolated and testable')
+console.log('   ✅ No network dependencies in core library')
+console.log('   ✅ Predictable, deterministic behavior')
+console.log('   ✅ Smaller attack surface')
+console.log('   ✅ Clear boundaries for security reviews')
+console.log('')
+
+console.log('⚖️ FOR LEGAL COMPLIANCE:')
+console.log('   ✅ Standardized legal token structures')
+console.log('   ✅ Cryptographic proof generation')
+console.log('   ✅ Audit trail preparation')
+console.log('   ✅ Jurisdiction-specific adaptability')
+console.log('   ✅ Regulatory compliance primitives')
+console.log('')
+
+console.log('🚀 CONCLUSION')
+console.log('=============')
+console.log('')
+console.log('SmartLedger-BSV is now a pure foundation library that provides')
+console.log('everything needed to build Legal Token Protocol applications')
+console.log('while giving developers complete architectural freedom.')
+console.log('')
+console.log('The library focuses on what it does best:')
+console.log('• Cryptographic correctness')
+console.log('• Legal structure validation') 
+console.log('• Standardized data formats')
+console.log('• Compliance primitives')
+console.log('')
+console.log('External systems handle:')
+console.log('• Blockchain publishing')
+console.log('• Data storage')
+console.log('• User interfaces')
+console.log('• Business workflows')
+console.log('')
+console.log('This creates the perfect foundation for any Legal Token')
+console.log('Protocol application while maintaining maximum flexibility!')
+console.log('')
+console.log('🎉 Primitives-only transformation: COMPLETE! 🎉')

package/test_shamir.js

@@ -0,0 +1,221 @@
+#!/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/test_standalone_shamir.html

@@ -0,0 +1,83 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <title>BSV Shamir Secret Sharing - Standalone Test</title>
+    <meta charset="utf-8">
+</head>
+<body>
+    <h1>BSV Shamir Secret Sharing - Standalone Module Test</h1>
+    <div id="output"></div>
+
+    <script src="bsv-shamir.min.js"></script>
+    <script>
+        function log(message) {
+            document.getElementById('output').innerHTML += message + '<br>';
+            console.log(message);
+        }
+
+        log('=== BSV Shamir Standalone Module Test ===');
+        log('');
+
+        try {
+            if (typeof bsvShamir === 'undefined') {
+                log('❌ bsvShamir not available');
+            } else {
+                log('✅ bsvShamir loaded successfully');
+                log('Version: ' + bsvShamir.version);
+                log('Algorithm: ' + bsvShamir.algorithm);
+                log('');
+
+                // Test basic functionality
+                var secret = 'Hello from Browser!';
+                var threshold = 2;
+                var shares = 4;
+
+                log('🔐 Testing secret splitting...');
+                log('Secret: ' + secret);
+                log('Threshold: ' + threshold + ', Total shares: ' + shares);
+
+                var splitShares = bsvShamir.split(secret, threshold, shares);
+                log('✅ Split into ' + splitShares.length + ' shares');
+
+                // Test reconstruction
+                log('');
+                log('🔓 Testing secret reconstruction...');
+                var reconstructed = bsvShamir.combine(splitShares.slice(0, threshold));
+                var reconstructedSecret = reconstructed.toString();
+
+                log('Reconstructed: ' + reconstructedSecret);
+                
+                if (reconstructedSecret === secret) {
+                    log('✅ Reconstruction successful!');
+                } else {
+                    log('❌ Reconstruction failed');
+                }
+
+                // Test share verification
+                log('');
+                log('🔍 Testing share verification...');
+                var validShares = 0;
+                for (var i = 0; i < splitShares.length; i++) {
+                    if (bsvShamir.verifyShare(splitShares[i])) {
+                        validShares++;
+                    }
+                }
+                log('Valid shares: ' + validShares + '/' + splitShares.length);
+
+                // Run demo
+                log('');
+                log('🚀 Running demo...');
+                var demoResult = bsvShamir.demo();
+                log('Demo completed: ' + (demoResult.success ? 'SUCCESS' : 'FAILED'));
+                
+                log('');
+                log('🎉 All tests completed successfully!');
+                log('📦 BSV Shamir Secret Sharing standalone module is working correctly.');
+            }
+        } catch (error) {
+            log('❌ Error: ' + error.message);
+            console.error('Full error:', error);
+        }
+    </script>
+</body>
+</html>