smartledger-bsv 3.2.2 → 3.3.1

package/lib/smart_contract/API_REFERENCE.md

@@ -19,7 +19,7 @@
 ## Quick Start
 
 ```javascript
-const SmartContract = require('bsv-elliptic-fix').SmartContract
+const SmartContract = require('smartledger-bsv').SmartContract
 
 // 🚀 Write covenant logic in JavaScript
 const builder = SmartContract.createCovenantBuilder()

package/lib/smart_contract/EXAMPLES.md

@@ -17,7 +17,7 @@
 ### Example 1: Simple Value Check
 
 ```javascript
-const SmartContract = require('bsv-elliptic-fix').SmartContract
+const SmartContract = require('smartledger-bsv').SmartContract
 
 // Ensure transaction maintains minimum value
 function createValueGuard(minimumSatoshis) {
@@ -419,7 +419,7 @@ function createSubscriptionCovenant(serviceProvider, subscriptionFee, renewalPer
 ### Example 12: Complete Covenant Deployment
 
 ```javascript
-const bsv = require('bsv-elliptic-fix')
+const bsv = require('smartledger-bsv')
 const SmartContract = bsv.SmartContract
 
 async function deployValueLockCovenant(privateKey, minimumValue, utxo) {

package/lib/smart_contract/QUICK_START.md

@@ -9,7 +9,7 @@ The JavaScript-to-Bitcoin Script framework allows you to write complex covenant
 ## 🚀 30-Second Quick Start
 
 ```javascript
-const SmartContract = require('bsv-elliptic-fix').SmartContract
+const SmartContract = require('smartledger-bsv').SmartContract
 
 // Write covenant logic in JavaScript
 const builder = SmartContract.createCovenantBuilder()
@@ -415,7 +415,7 @@ Object.keys(opcodes)
 ### With BSV Library
 
 ```javascript
-const bsv = require('bsv-elliptic-fix')
+const bsv = require('smartledger-bsv')
 const SmartContract = bsv.SmartContract
 
 // Create covenant from private key

package/lib/smart_contract/README.md

@@ -7,7 +7,7 @@ The SmartContract module provides enterprise-grade covenant functionality for Bi
 ## Installation & Usage
 
 ```javascript
-const bsv = require('bsv-elliptic-fix')
+const bsv = require('smartledger-bsv')
 
 // Access SmartContract module
 const SmartContract = bsv.SmartContract

package/ltp-entry.js

@@ -0,0 +1,92 @@
+/**
+ * SmartLedger-BSV Legal Token Protocol (LTP) - Standalone Entry Point
+ * 
+ * This entry point provides the complete Legal Token Protocol framework
+ * as a standalone module for browser and Node.js environments.
+ * 
+ * Features:
+ * - Complete LTP primitives-only architecture
+ * - Legal claim validation and attestation
+ * - Right and obligation token management
+ * - Cryptographic proof generation
+ * - Registry and blockchain anchoring preparation
+ * - Full W3C compatibility and legal compliance
+ */
+
+const bsv = require('./index.js')
+
+// Export LTP functionality as standalone module
+module.exports = {
+  // Core BSV functionality needed for LTP
+  PrivateKey: bsv.PrivateKey,
+  PublicKey: bsv.PublicKey,
+  Address: bsv.Address,
+  Transaction: bsv.Transaction,
+  Script: bsv.Script,
+  crypto: bsv.crypto,
+  
+  // Complete LTP framework
+  LTP: bsv.LTP,
+  
+  // Right Token Primitives
+  prepareRightToken: bsv.prepareRightToken,
+  prepareRightTokenVerification: bsv.prepareRightTokenVerification,
+  prepareRightTokenTransfer: bsv.prepareRightTokenTransfer,
+  prepareRightTypeValidation: bsv.prepareRightTypeValidation,
+  
+  // Obligation Token Primitives
+  prepareObligationToken: bsv.prepareObligationToken,
+  prepareObligationVerification: bsv.prepareObligationVerification,
+  prepareObligationFulfillment: bsv.prepareObligationFulfillment,
+  prepareObligationBreachAssessment: bsv.prepareObligationBreachAssessment,
+  prepareObligationMonitoringReport: bsv.prepareObligationMonitoringReport,
+  
+  // Claim Validation Primitives
+  prepareClaimValidation: bsv.prepareClaimValidation,
+  prepareClaimAttestation: bsv.prepareClaimAttestation,
+  prepareClaimDispute: bsv.prepareClaimDispute,
+  prepareBulkClaimValidation: bsv.prepareBulkClaimValidation,
+  prepareClaimTemplate: bsv.prepareClaimTemplate,
+  
+  // Proof Generation Primitives
+  prepareSignatureProof: bsv.prepareSignatureProof,
+  prepareSignatureVerification: bsv.prepareSignatureVerification,
+  prepareSelectiveDisclosure: bsv.prepareSelectiveDisclosure,
+  prepareSelectiveDisclosureVerification: bsv.prepareSelectiveDisclosureVerification,
+  prepareLegalValidityProof: bsv.prepareLegalValidityProof,
+  prepareZeroKnowledgeProof: bsv.prepareZeroKnowledgeProof,
+  
+  // Registry Management Primitives
+  prepareRegistry: bsv.prepareRegistry,
+  prepareTokenRegistration: bsv.prepareTokenRegistration,
+  prepareTokenApproval: bsv.prepareTokenApproval,
+  prepareTokenRevocation: bsv.prepareTokenRevocation,
+  prepareTokenStatusQuery: bsv.prepareTokenStatusQuery,
+  prepareTokenSearch: bsv.prepareTokenSearch,
+  prepareStatisticsQuery: bsv.prepareStatisticsQuery,
+  prepareAuditLogQuery: bsv.prepareAuditLogQuery,
+  
+  // Blockchain Anchoring Primitives
+  prepareTokenCommitment: bsv.prepareTokenCommitment,
+  prepareBatchCommitment: bsv.prepareBatchCommitment,
+  verifyTokenAnchor: bsv.verifyTokenAnchor,
+  formatRevocation: bsv.formatRevocation,
+  
+  // Utility Functions
+  getRightTypes: bsv.getRightTypes,
+  getObligationTypes: bsv.getObligationTypes,
+  getObligationPriority: bsv.getObligationPriority,
+  getObligationStatus: bsv.getObligationStatus,
+  getClaimSchemas: bsv.getClaimSchemas,
+  getClaimSchemaNames: bsv.getClaimSchemaNames,
+  getClaimSchema: bsv.getClaimSchema,
+  createClaimTemplate: bsv.createClaimTemplate,
+  canonicalizeClaim: bsv.canonicalizeClaim,
+  hashClaim: bsv.hashClaim,
+  addCustomClaimSchema: bsv.addCustomClaimSchema,
+  
+  // Version and metadata
+  version: '3.3.0',
+  framework: 'Legal Token Protocol',
+  architecture: 'primitives-only'
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "smartledger-bsv",
-  "version": "3.2.2",
-  "description": "🚀 Complete Bitcoin SV development framework with 9 flexible loading options: standalone modules (covenant, script-helper, security, debug tools), complete bundle, or modular approach. Includes SmartContract framework, covenant builder, script debugger, elliptic curve security fixes, and comprehensive Bitcoin SV API. Perfect for DeFi, smart contracts, custom scripts, and secure Bitcoin applications.",
+  "version": "3.3.1",
+  "description": "🚀 Complete Bitcoin SV development framework with Legal Token Protocol (LTP), Global Digital Attestation Framework (GDAF), Shamir Secret Sharing, and 9 flexible loading options. Includes primitives-only architecture for maximum integration flexibility, SmartContract framework, covenant builder, and comprehensive Bitcoin SV API. Perfect for legal tokens, DeFi, smart contracts, and secure Bitcoin applications.",
   "author": "SmartLedger Technology <hello@smartledger.technology> (https://smartledger.technology)",
   "homepage": "https://github.com/codenlighten/smartledger-bsv#readme",
   "bugs": {
@@ -11,7 +11,9 @@
   "scripts": {
     "lint": "standard",
     "test": "standard && mocha",
-    "test:signatures": "node validation_test.js",
+    "test:ltp": "node complete_ltp_demo.js",
+    "test:ltp-primitives": "node simple_demo.js",
+    "test:architecture": "node architecture_demo.js",
     "test:js2script": "node lib/smart_contract/opcode_map.js && node lib/smart_contract/covenant_builder.js",
     "test:opcodes": "node lib/smart_contract/opcode_list.js",
     "test:covenants": "node examples/covenants/advanced_covenant_demo.js",
@@ -23,12 +25,14 @@
     "build-ecies": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack ecies/index.js --config build/webpack.subproject.config.js --output-library bsvEcies -o bsv-ecies.min.js",
     "build-message": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack message/index.js --config build/webpack.subproject.config.js --output-library bsvMessage -o bsv-message.min.js",
     "build-mnemonic": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack mnemonic/index.js --config build/webpack.subproject.config.js --output-library bsvMnemonic -o bsv-mnemonic.min.js",
+    "build-shamir": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack shamir-entry.js --config build/webpack.subproject.config.js --output-library bsvShamir -o bsv-shamir.min.js",
+    "build-ltp": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack ltp-entry.js --config build/webpack.ltp.config.js",
     "build-smartcontract": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack smartcontract-entry.js --config build/webpack.smartcontract.config.js",
     "build-covenant": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack covenant-entry.js --config build/webpack.covenant.config.js",
     "build-script-helper": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack script-helper-entry.js --config build/webpack.script-helper.config.js",
     "build-security": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack security-entry.js --config build/webpack.security.config.js",
     "build-bundle": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack bundle-entry.js --config build/webpack.bundle.config.js",
-    "build": "npm run build-bsv && npm run build-ecies && npm run build-message && npm run build-mnemonic && npm run build-smartcontract",
+    "build": "npm run build-bsv && npm run build-ecies && npm run build-message && npm run build-mnemonic && npm run build-shamir && npm run build-smartcontract",
     "build-specialized": "npm run build-covenant && npm run build-script-helper && npm run build-security",
     "build-all": "npm run build && npm run build-bundle && npm run build-specialized",
     "test:browser": "echo 'Open tests/standalone-modules-test.html in browser for comprehensive testing'",
@@ -58,12 +62,21 @@
     "bsv-ecies.min.js",
     "bsv-message.min.js", 
     "bsv-mnemonic.min.js",
+    "bsv-shamir.min.js",
+    "bsv-gdaf.min.js",
+    "bsv-ltp.min.js",
     "bsv-smartcontract.min.js",
     "bsv-covenant.min.js",
     "bsv-script-helper.min.js",
     "bsv-security.min.js",
     "bsv.d.ts",
     "validation_test.js",
+    "test_shamir.js",
+    "shamir_demo.js",
+    "complete_ltp_demo.js",
+    "simple_demo.js",
+    "architecture_demo.js",
+    "test_standalone_shamir.html",
     "docs/",
     "examples/",
     "LICENSE",
@@ -75,6 +88,21 @@
     "bitcoin",
     "bitcoin-sv", 
     "bsv",
+    "legal-token-protocol",
+    "ltp",
+    "legal-tokens",
+    "primitives-only",
+    "legal-compliance",
+    "property-rights",
+    "obligations",
+    "attestations",
+    "gdaf",
+    "global-digital-attestation",
+    "w3c-credentials",
+    "verifiable-credentials",
+    "decentralized-identity",
+    "shamir-secret-sharing",
+    "threshold-cryptography",
     "cryptocurrency",
     "blockchain",
     "smart-contracts",
@@ -101,6 +129,18 @@
     "pels",
     "bip143",
     "preimage",
+    "shamir-secret-sharing",
+    "threshold-cryptography",
+    "secret-splitting",
+    "global-digital-attestation",
+    "gdaf",
+    "verifiable-credentials",
+    "w3c-credentials",
+    "decentralized-identity",
+    "did-resolution",
+    "zero-knowledge-proofs",
+    "blockchain-anchoring",
+    "attestation-framework",
     "nchain",
     "custom-scripts",
     "multisig",

package/shamir-entry.js

@@ -0,0 +1,173 @@
+'use strict'
+
+/**
+ * BSV Shamir Secret Sharing - Standalone Module
+ * Secure secret distribution using Shamir's Secret Sharing algorithm
+ * 
+ * Usage:
+ *   // Split a secret into shares
+ *   var shares = bsvShamir.split('my secret', 3, 5) // 3-of-5 threshold
+ *   
+ *   // Reconstruct secret from shares
+ *   var secret = bsvShamir.combine(shares.slice(0, 3))
+ * 
+ * Features:
+ * - Cryptographically secure threshold secret sharing
+ * - Support for any threshold (k) and total shares (n) where k <= n
+ * - Handles arbitrary secret sizes through chunking
+ * - Share verification and integrity checking
+ * - Compatible with BSV cryptographic ecosystem
+ */
+
+// Initialize dependencies for browser compatibility
+var deps = {}
+try {
+  deps.bnjs = require('bn.js')
+  deps.Buffer = (typeof Buffer !== 'undefined') ? Buffer : null
+} catch (e) {
+  // Browser environment - dependencies should be available globally
+  if (typeof window !== 'undefined') {
+    deps.bnjs = window.BN || (window.bsv && window.bsv.deps && window.bsv.deps.bnjs)
+    deps.Buffer = window.Buffer || (window.bsv && window.bsv.deps && window.bsv.deps.Buffer)
+  }
+}
+
+// Ensure we have required dependencies
+if (!deps.bnjs) {
+  throw new Error('BN.js dependency not found. Please include bn.js or bsv.min.js')
+}
+
+if (!deps.Buffer) {
+  // Provide minimal Buffer polyfill for basic operations
+  deps.Buffer = {
+    isBuffer: function(obj) { return obj && obj.constructor && obj.constructor.name === 'Buffer' },
+    from: function(data, encoding) {
+      if (typeof data === 'string') {
+        if (encoding === 'hex') {
+          return new Uint8Array(data.match(/.{2}/g).map(byte => parseInt(byte, 16)))
+        }
+        return new Uint8Array(Array.from(data).map(c => c.charCodeAt(0)))
+      }
+      return new Uint8Array(data)
+    },
+    concat: function(arrays) {
+      var totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0)
+      var result = new Uint8Array(totalLength)
+      var offset = 0
+      for (var i = 0; i < arrays.length; i++) {
+        result.set(arrays[i], offset)
+        offset += arrays[i].length
+      }
+      return result
+    }
+  }
+}
+
+// Import the core Shamir implementation
+var Shamir = require('./lib/crypto/shamir')
+
+// Create standalone module interface
+var bsvShamir = {
+  /**
+   * Split a secret into threshold shares
+   * @param {String|Buffer} secret - Secret to split
+   * @param {Number} threshold - Minimum shares needed to reconstruct
+   * @param {Number} shares - Total shares to generate
+   * @returns {Array} Array of share objects
+   */
+  split: function(secret, threshold, shares) {
+    return Shamir.split(secret, threshold, shares)
+  },
+
+  /**
+   * Combine shares to reconstruct secret
+   * @param {Array} shares - Array of share objects
+   * @returns {Buffer} Reconstructed secret
+   */
+  combine: function(shares) {
+    return Shamir.combine(shares)
+  },
+
+  /**
+   * Verify if a share is valid
+   * @param {Object} share - Share to verify
+   * @returns {Boolean} True if valid
+   */
+  verifyShare: function(share) {
+    return Shamir.verifyShare(share)
+  },
+
+  /**
+   * Generate test vectors for validation
+   * @returns {Object} Test data with secret, shares, and reconstruction
+   */
+  generateTestVectors: function() {
+    return Shamir.generateTestVectors()
+  },
+
+  /**
+   * Create a simple demo showing basic usage
+   * @returns {Object} Demo results
+   */
+  demo: function() {
+    console.log('=== BSV Shamir Secret Sharing Demo ===')
+    
+    var originalSecret = 'Bitcoin SV is the original Bitcoin!'
+    var threshold = 3
+    var totalShares = 5
+    
+    console.log('Original secret:', originalSecret)
+    console.log('Creating', totalShares, 'shares with threshold of', threshold)
+    
+    // Split the secret
+    var shares = bsvShamir.split(originalSecret, threshold, totalShares)
+    console.log('Generated', shares.length, 'shares')
+    
+    // Show first share structure (truncated for display)
+    var displayShare = JSON.parse(JSON.stringify(shares[0]))
+    if (displayShare.chunks && displayShare.chunks.length > 0) {
+      displayShare.chunks = displayShare.chunks.slice(0, 1) // Show only first chunk
+      displayShare.chunks[0].y = displayShare.chunks[0].y.substring(0, 20) + '...'
+    }
+    console.log('Sample share structure:', displayShare)
+    
+    // Reconstruct with minimum shares
+    var minShares = shares.slice(0, threshold)
+    var reconstructed = bsvShamir.combine(minShares)
+    var reconstructedSecret = reconstructed.toString('utf8')
+    
+    console.log('Reconstructed secret:', reconstructedSecret)
+    console.log('Reconstruction successful:', originalSecret === reconstructedSecret)
+    
+    return {
+      original: originalSecret,
+      threshold: threshold,
+      totalShares: totalShares,
+      shares: shares,
+      reconstructed: reconstructedSecret,
+      success: originalSecret === reconstructedSecret
+    }
+  },
+
+  // Expose version and metadata
+  version: '3.2.2',
+  algorithm: 'Shamir Secret Sharing',
+  description: 'Threshold cryptography for secure secret distribution'
+}
+
+// Browser compatibility
+if (typeof window !== 'undefined') {
+  window.bsvShamir = bsvShamir
+}
+
+// Node.js compatibility
+if (typeof module !== 'undefined' && module.exports) {
+  module.exports = bsvShamir
+}
+
+// AMD compatibility
+if (typeof define === 'function' && define.amd) {
+  define(function() {
+    return bsvShamir
+  })
+}

package/shamir_demo.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+
+/**
+ * BSV Shamir Secret Sharing Demo
+ * 
+ * This demonstrates how to use Shamir Secret Sharing for secure secret distribution
+ * Perfect for backup keys, passwords, or any sensitive data that needs to be distributed
+ * across multiple parties with threshold security.
+ */
+
+'use strict'
+
+var bsv = require('./index.js')
+
+console.log('🔐 BSV Shamir Secret Sharing Demo')
+console.log('=====================================\n')
+
+// Example 1: Basic secret sharing
+console.log('📝 Example 1: Basic Secret Sharing')
+console.log('----------------------------------')
+
+var secret = 'my-super-secret-bitcoin-private-key'
+var threshold = 3  // Need at least 3 shares to reconstruct
+var totalShares = 5  // Create 5 total shares
+
+console.log('Secret to protect:', secret)
+console.log('Security policy: ' + threshold + ' of ' + totalShares + ' shares required\n')
+
+// Split the secret
+var shares = bsv.Shamir.split(secret, threshold, totalShares)
+console.log('✅ Secret split into', shares.length, 'shares')
+
+// Display share information (truncated for security)
+shares.forEach(function(share, index) {
+  console.log('  Share ' + (index + 1) + ': ID=' + share.id + ', bytes=' + share.length)
+})
+
+// Reconstruct with minimum shares (3 of 5)
+console.log('\n🔓 Reconstructing with shares 1, 3, and 5...')
+var selectedShares = [shares[0], shares[2], shares[4]]  // shares 1, 3, 5
+var reconstructed = bsv.Shamir.combine(selectedShares)
+var reconstructedSecret = reconstructed.toString('utf8')
+
+console.log('Reconstructed secret:', reconstructedSecret)
+console.log('Match original:', reconstructedSecret === secret ? '✅ YES' : '❌ NO')
+
+// Example 2: Bitcoin wallet backup scenario
+console.log('\n\n💰 Example 2: Bitcoin Wallet Backup Scenario')
+console.log('---------------------------------------------')
+
+var walletMnemonic = 'abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about'
+var backupPolicy = { threshold: 2, shares: 3 }  // 2-of-3 backup
+
+console.log('Wallet mnemonic (12 words):', walletMnemonic.split(' ').slice(0, 3).join(' ') + '...')
+console.log('Backup policy: ' + backupPolicy.threshold + ' of ' + backupPolicy.shares + ' shares needed\n')
+
+var walletShares = bsv.Shamir.split(walletMnemonic, backupPolicy.threshold, backupPolicy.shares)
+
+console.log('📋 Backup shares created:')
+walletShares.forEach(function(share, index) {
+  var label = ['👤 Family Member', '🏦 Bank Safe', '☁️  Cloud Storage'][index]
+  console.log('  Share ' + (index + 1) + ': ' + label + ' (ID: ' + share.id + ')')
+})
+
+// Simulate recovery with 2 shares
+console.log('\n🔧 Simulating wallet recovery with shares from Family Member + Bank Safe...')
+var recoveryShares = [walletShares[0], walletShares[1]]  // First 2 shares
+var recoveredMnemonic = bsv.Shamir.combine(recoveryShares).toString('utf8')
+
+console.log('Recovered mnemonic:', recoveredMnemonic === walletMnemonic ? '✅ SUCCESS' : '❌ FAILED')
+
+// Example 3: Binary data (keys, certificates, etc.)
+console.log('\n\n🔑 Example 3: Binary Data Protection')
+console.log('-----------------------------------')
+
+var binarySecret = Buffer.from([0x04, 0x8f, 0xab, 0x23, 0xc1, 0x9e, 0x77, 0x44])  // Example key bytes
+console.log('Binary secret (hex):', binarySecret.toString('hex'))
+console.log('Binary secret length:', binarySecret.length, 'bytes\n')
+
+var binaryShares = bsv.Shamir.split(binarySecret, 2, 4)
+console.log('✅ Binary data split into', binaryShares.length, 'shares')
+
+var recoveredBinary = bsv.Shamir.combine(binaryShares.slice(0, 2))
+console.log('Recovered binary (hex):', recoveredBinary.toString('hex'))
+console.log('Binary match:', Buffer.compare(binarySecret, recoveredBinary) === 0 ? '✅ YES' : '❌ NO')
+
+// Example 4: Share verification
+console.log('\n\n🔍 Example 4: Share Verification')
+console.log('--------------------------------')
+
+var testShares = bsv.Shamir.split('verification-test', 2, 3)
+console.log('Testing share integrity...')
+
+testShares.forEach(function(share, index) {
+  var isValid = bsv.Shamir.verifyShare(share)
+  console.log('  Share ' + (index + 1) + ':', isValid ? '✅ Valid' : '❌ Invalid')
+})
+
+// Test with corrupted share
+var corruptedShare = JSON.parse(JSON.stringify(testShares[0]))
+corruptedShare.bytes[0].y = 'invalid-hex'  // Corrupt the data
+console.log('  Corrupted share:', bsv.Shamir.verifyShare(corruptedShare) ? '❌ Invalid test failed' : '✅ Correctly rejected')
+
+console.log('\n🎯 Use Cases for Shamir Secret Sharing:')
+console.log('--------------------------------------')
+console.log('• 🔐 Bitcoin wallet backup (split mnemonic across family/friends)')
+console.log('• 🏢 Corporate key management (distribute signing keys)')
+console.log('• 🛡️  Multi-party authentication (API keys, passwords)')
+console.log('• 💾 Secure data backup (encrypt once, distribute shares)')
+console.log('• 🤝 Trustless escrow (require multiple parties to unlock)')
+console.log('• 🏦 Bank vault security (multiple keyholders required)')
+
+console.log('\n📦 Integration Options:')
+console.log('----------------------')
+console.log('• Main library: bsv.Shamir or bsv.crypto.Shamir')
+console.log('• Standalone: bsv-shamir.min.js (433 KB)')
+console.log('• CDN ready: Use in browser with <script> tag')
+console.log('• Node.js: require("smartledger-bsv").Shamir')
+
+console.log('\n✨ Demo completed successfully!')
+console.log('Visit: https://github.com/codenlighten/smartledger-bsv for more examples')