smartledger-bsv 3.2.0 → 3.2.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "smartledger-bsv",
-  "version": "3.2.0",
-  "description": "Advanced Bitcoin SV library with JavaScript-to-Bitcoin Script framework - Complete BSV API + BIP143 preimage parsing + 121 opcode mapping + covenant builder + nChain PUSHTX techniques + custom script development",
+  "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.",
   "author": "SmartLedger Technology <hello@smartledger.technology> (https://smartledger.technology)",
   "homepage": "https://github.com/codenlighten/smartledger-bsv#readme",
   "bugs": {
@@ -19,13 +19,20 @@
     "test:basic": "node examples/basic/transaction-creation.js",
     "test:all": "npm test && npm run test:covenants && npm run test:scripts",
     "coverage": "nyc --reporter=text npm run test",
-    "build-bsv": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack index.js --config webpack.config.js",
-    "build-ecies": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack ecies/index.js --config webpack.subproject.config.js --output-library bsvEcies -o bsv-ecies.min.js",
-    "build-message": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack message/index.js --config webpack.subproject.config.js --output-library bsvMessage -o bsv-message.min.js",
-    "build-mnemonic": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack mnemonic/index.js --config webpack.subproject.config.js --output-library bsvMnemonic -o bsv-mnemonic.min.js",
-    "build-bundle": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack bundle-entry.js --config webpack.bundle.config.js",
-    "build": "npm run build-bsv && npm run build-ecies && npm run build-message && npm run build-mnemonic",
-    "build-all": "npm run build && npm run build-bundle",
+    "build-bsv": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack index.js --config build/webpack.config.js",
+    "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-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-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'",
+    "test:bundle": "echo 'Open tests/bundle-completeness-test.html in browser to verify bundle completeness'",
     "demo": "npm run test:covenants",
     "demo:basic": "npm run test:basic",
     "demo:scripts": "npm run test:scripts",
@@ -43,11 +50,18 @@
     "ecies/",
     "message/",
     "mnemonic/",
+    "build/",
+    "tests/",
+    "*-entry.js",
     "bsv.min.js",
     "bsv.bundle.js",
     "bsv-ecies.min.js",
     "bsv-message.min.js", 
     "bsv-mnemonic.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",
     "docs/",
@@ -59,18 +73,30 @@
   ],
   "keywords": [
     "bitcoin",
-    "bitcoin-sv",
+    "bitcoin-sv", 
     "bsv",
-    "transaction",
-    "address",
     "cryptocurrency",
     "blockchain",
-    "security",
-    "hardened",
-    "vulnerability-free",
-    "drop-in-replacement",
+    "smart-contracts",
+    "defi",
     "covenant",
     "covenants",
+    "script-debugger",
+    "debug-tools",
+    "modular-loading",
+    "standalone-modules",
+    "security-hardened",
+    "elliptic-curve-fix",
+    "smartledger",
+    "transaction",
+    "address",
+    "signature",
+    "wallet",
+    "hd-wallet",
+    "mnemonic",
+    "ecies",
+    "encryption",
+    "message-signing",
     "pushtx",
     "pels",
     "bip143",
@@ -94,9 +120,14 @@
     "miner-simulator",
     "testing-tools",
     "development-framework",
-    "ecies",
-    "p2p",
-    "payment",
+    "browser-compatible",
+    "nodejs-compatible",
+    "webpack-ready",
+    "cdn-ready",
+    "typescript-definitions",
+    "vulnerability-free",
+    "drop-in-replacement",
+    "performance-optimized",
     "bip21",
     "bip32",
     "bip37",

package/script-helper-entry.js

@@ -0,0 +1,49 @@
+/**
+ * SmartLedger BSV Custom Script Helper - Standalone Module
+ * 
+ * Simplified API for custom script development and signing
+ * Requires main BSV library to be loaded first.
+ * 
+ * Usage:
+ *   <script src="bsv.min.js"></script>
+ *   <script src="bsv-script-helper.min.js"></script>
+ *   <script>
+ *     const sig = bsvScriptHelper.createSignature(tx, key, 0, script, sats);
+ *   </script>
+ */
+
+'use strict'
+
+// Verify BSV library is available
+if (typeof bsv === 'undefined') {
+  throw new Error('CustomScriptHelper requires BSV library. Load bsv.min.js first.');
+}
+
+// Load CustomScriptHelper
+const CustomScriptHelper = require('./lib/custom-script-helper.js');
+
+// Browser compatibility
+if (typeof window !== 'undefined') {
+  window.bsvScriptHelper = {
+    CustomScriptHelper: CustomScriptHelper,
+    createSignature: CustomScriptHelper.createSignature,
+    verifySignature: CustomScriptHelper.verifySignature,
+    createMultisigSignature: CustomScriptHelper.createMultisigSignature,
+    version: bsv.version || 'unknown'
+  };
+  
+  // Also attach to main bsv object if available
+  if (typeof bsv !== 'undefined') {
+    bsv.CustomScriptHelper = CustomScriptHelper;
+  }
+  
+  console.log('CustomScriptHelper standalone module loaded');
+}
+
+module.exports = {
+  CustomScriptHelper: CustomScriptHelper,
+  createSignature: CustomScriptHelper.createSignature,
+  verifySignature: CustomScriptHelper.verifySignature,
+  createMultisigSignature: CustomScriptHelper.createMultisigSignature,
+  version: bsv.version || 'unknown'
+};

package/security-entry.js

@@ -0,0 +1,70 @@
+/**
+ * SmartLedger BSV Security Module - Standalone Module
+ * 
+ * SmartLedger security enhancements and elliptic curve fixes
+ * Can be used standalone or with main BSV library.
+ * 
+ * Usage:
+ *   <script src="bsv-security.min.js"></script>
+ *   <script>
+ *     const verified = bsvSecurity.SmartVerify.verify(sig, hash, pubkey);
+ *   </script>
+ */
+
+'use strict'
+
+// Load security modules
+const SmartVerify = require('./lib/crypto/smartledger_verify');
+const EllipticFixed = require('./lib/crypto/elliptic-fixed');
+
+// Browser compatibility
+if (typeof window !== 'undefined') {
+  window.bsvSecurity = {
+    SmartVerify: SmartVerify,
+    EllipticFixed: EllipticFixed,
+    SmartLedger: {
+      version: 'v3.2.1',
+      hardenedBy: 'SmartLedger',
+      baseVersion: 'v1.5.6',
+      securityFeatures: [
+        'canonical-signatures',
+        'malleability-protection', 
+        'enhanced-validation',
+        'elliptic-patches'
+      ],
+      SmartVerify: SmartVerify,
+      EllipticFixed: EllipticFixed
+    },
+    version: 'v3.2.1'
+  };
+  
+  // Also attach to main bsv object if available
+  if (typeof bsv !== 'undefined') {
+    bsv.SmartVerify = SmartVerify;
+    bsv.EllipticFixed = EllipticFixed;
+    if (!bsv.SmartLedger) {
+      bsv.SmartLedger = window.bsvSecurity.SmartLedger;
+    }
+  }
+  
+  console.log('SmartLedger Security standalone module loaded');
+}
+
+module.exports = {
+  SmartVerify: SmartVerify,
+  EllipticFixed: EllipticFixed,
+  SmartLedger: {
+    version: 'v3.2.1',
+    hardenedBy: 'SmartLedger',
+    baseVersion: 'v1.5.6',
+    securityFeatures: [
+      'canonical-signatures',
+      'malleability-protection',
+      'enhanced-validation', 
+      'elliptic-patches'
+    ],
+    SmartVerify: SmartVerify,
+    EllipticFixed: EllipticFixed
+  },
+  version: 'v3.2.1'
+};

package/smartcontract-entry.js

@@ -0,0 +1,133 @@
+/**
+ * SmartLedger BSV - SmartContract Interface
+ * 
+ * Standalone SmartContract interface with debug tools for browser use.
+ * This module provides the complete SmartContract development framework
+ * including covenant builders, script debuggers, and testing tools.
+ * 
+ * Usage:
+ *   <script src="bsv.min.js"></script>
+ *   <script src="bsv-smartcontract.min.js"></script>
+ *   <script>
+ *     // SmartContract interface available under bsv.SmartContract
+ *     const script = bsv.Script.fromASM('OP_1 OP_2 OP_ADD');
+ *     const result = bsv.SmartContract.examineStack(script);
+ *     const metrics = bsv.SmartContract.getScriptMetrics(script);
+ *   </script>
+ */
+
+'use strict'
+
+// Check if BSV library is available
+if (typeof window !== 'undefined' && typeof window.bsv === 'undefined') {
+  throw new Error('SmartContract interface requires BSV library. Load bsv.min.js first.')
+}
+
+// Get BSV reference (works in both Node.js and browser)
+var bsv = (typeof window !== 'undefined') ? window.bsv : require('./index.js')
+
+if (!bsv) {
+  throw new Error('BSV library not found. Ensure bsv.min.js is loaded before bsv-smartcontract.min.js')
+}
+
+// Load SmartContract interface
+var SmartContract
+try {
+  SmartContract = require('./lib/smart_contract')
+} catch (e) {
+  throw new Error('SmartContract module not found: ' + e.message)
+}
+
+// Attach to BSV library
+bsv.SmartContract = SmartContract
+
+// Make available globally for browser usage
+if (typeof window !== 'undefined') {
+  window.bsvSmartContract = SmartContract
+  
+  // Also ensure it's on the global bsv object
+  if (window.bsv) {
+    window.bsv.SmartContract = SmartContract
+  }
+}
+
+// Add debug tools information
+if (SmartContract) {
+  SmartContract.version = bsv.version || '3.2.1'
+  SmartContract.standalone = true
+  SmartContract.debugToolsAvailable = {
+    examineStack: !!SmartContract.examineStack,
+    interpretScript: !!SmartContract.interpretScript,
+    getScriptMetrics: !!SmartContract.getScriptMetrics,
+    optimizeScript: !!SmartContract.optimizeScript
+  }
+  
+  // Convenience method to check if debug tools are working
+  SmartContract.testDebugTools = function() {
+    try {
+      if (!bsv.Script) {
+        return { success: false, error: 'BSV Script class not available' }
+      }
+      
+      const testScript = bsv.Script.fromASM('OP_1 OP_2 OP_ADD')
+      const results = {}
+      
+      if (SmartContract.examineStack) {
+        try {
+          results.examineStack = SmartContract.examineStack(testScript)
+          results.examineStackWorking = true
+        } catch (e) {
+          results.examineStackWorking = false
+          results.examineStackError = e.message
+        }
+      }
+      
+      if (SmartContract.interpretScript) {
+        try {
+          results.interpretScript = SmartContract.interpretScript(testScript)
+          results.interpretScriptWorking = true
+        } catch (e) {
+          results.interpretScriptWorking = false
+          results.interpretScriptError = e.message
+        }
+      }
+      
+      if (SmartContract.getScriptMetrics) {
+        try {
+          results.scriptMetrics = SmartContract.getScriptMetrics(testScript)
+          results.scriptMetricsWorking = true
+        } catch (e) {
+          results.scriptMetricsWorking = false
+          results.scriptMetricsError = e.message
+        }
+      }
+      
+      if (SmartContract.optimizeScript) {
+        try {
+          results.optimizeScript = SmartContract.optimizeScript(testScript)
+          results.optimizeScriptWorking = true
+        } catch (e) {
+          results.optimizeScriptWorking = false
+          results.optimizeScriptError = e.message
+        }
+      }
+      
+      return {
+        success: true,
+        testScript: 'OP_1 OP_2 OP_ADD',
+        results: results,
+        methodCount: Object.keys(SmartContract).length
+      }
+    } catch (e) {
+      return { success: false, error: e.message }
+    }
+  }
+}
+
+console.log('SmartContract interface loaded:', !!SmartContract)
+if (SmartContract) {
+  console.log('SmartContract methods available:', Object.keys(SmartContract).length)
+  console.log('Debug tools available:', SmartContract.debugToolsAvailable)
+}
+
+module.exports = SmartContract

package/tests/bundle-completeness-test.html

@@ -0,0 +1,131 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>BSV Bundle Completeness Test</title>
+  <style>
+    body { font-family: Arial; margin: 20px; }
+    .success { color: green; }
+    .error { color: red; }
+    .warning { color: orange; }
+    .module-test { margin: 10px 0; padding: 10px; border: 1px solid #ccc; }
+  </style>
+</head>
+<body>
+  <h1>🔬 BSV Bundle Completeness Test</h1>
+  <p>Testing that our bundle includes all modules from the main library...</p>
+  
+  <div id="results"></div>
+  
+  <script src="bsv.bundle.js"></script>
+  <script>
+    const results = document.getElementById('results');
+    
+    function log(message, className = '') {
+      const div = document.createElement('div');
+      div.className = className;
+      div.innerHTML = message;
+      results.appendChild(div);
+      console.log(message);
+    }
+    
+    function testModule(name, accessor, required = true) {
+      const div = document.createElement('div');
+      div.className = 'module-test';
+      
+      try {
+        const module = accessor();
+        if (module) {
+          div.innerHTML = `<span class="success">✅ ${name}: Available</span>`;
+          if (typeof module === 'function') {
+            div.innerHTML += ` (Constructor)`;
+          } else if (typeof module === 'object') {
+            const keys = Object.keys(module);
+            div.innerHTML += ` (${keys.length} properties: ${keys.slice(0, 3).join(', ')}${keys.length > 3 ? '...' : ''})`;
+          }
+        } else {
+          div.innerHTML = `<span class="${required ? 'error' : 'warning'}">${required ? '❌' : '⚠️'} ${name}: Not available</span>`;
+        }
+      } catch (e) {
+        div.innerHTML = `<span class="${required ? 'error' : 'warning'}">${required ? '❌' : '⚠️'} ${name}: Error - ${e.message}</span>`;
+      }
+      
+      results.appendChild(div);
+    }
+    
+    // Test all modules that should be in the bundle
+    log('<h2>Core BSV Library</h2>');
+    testModule('bsv', () => bsv);
+    testModule('bsv.version', () => bsv.version);
+    testModule('bsv.PrivateKey', () => bsv.PrivateKey);
+    testModule('bsv.PublicKey', () => bsv.PublicKey);
+    testModule('bsv.Address', () => bsv.Address);
+    testModule('bsv.Transaction', () => bsv.Transaction);
+    testModule('bsv.Script', () => bsv.Script);
+    
+    log('<h2>Crypto Modules</h2>');
+    testModule('bsv.crypto.Hash', () => bsv.crypto.Hash);
+    testModule('bsv.crypto.ECDSA', () => bsv.crypto.ECDSA);
+    testModule('bsv.crypto.Signature', () => bsv.crypto.Signature);
+    testModule('bsv.crypto.SmartVerify', () => bsv.crypto.SmartVerify);
+    testModule('bsv.crypto.EllipticFixed', () => bsv.crypto.EllipticFixed);
+    
+    log('<h2>SmartLedger Security</h2>');
+    testModule('bsv.SmartLedger', () => bsv.SmartLedger);
+    testModule('bsv.SmartVerify', () => bsv.SmartVerify);
+    testModule('bsv.EllipticFixed', () => bsv.EllipticFixed);
+    
+    log('<h2>Additional Modules</h2>');
+    testModule('bsv.Message', () => bsv.Message);
+    testModule('bsv.Mnemonic', () => bsv.Mnemonic, false); // May not work in browser
+    testModule('bsv.ECIES', () => bsv.ECIES);
+    
+    log('<h2>SmartContract Framework</h2>');
+    testModule('bsv.SmartContract', () => bsv.SmartContract);
+    if (bsv.SmartContract) {
+      testModule('SmartContract.interpretScript', () => bsv.SmartContract.interpretScript);
+      testModule('SmartContract.getScriptMetrics', () => bsv.SmartContract.getScriptMetrics);
+      testModule('SmartContract.examineStack', () => bsv.SmartContract.examineStack);
+      testModule('SmartContract.optimizeScript', () => bsv.SmartContract.optimizeScript);
+    }
+    
+    log('<h2>NEW: Advanced Development Tools</h2>');
+    testModule('bsv.CovenantInterface', () => bsv.CovenantInterface);
+    testModule('bsv.CustomScriptHelper', () => bsv.CustomScriptHelper);
+    testModule('bsv.Transaction.sighash', () => bsv.Transaction.sighash);
+    
+    log('<h2>Bundle Information</h2>');
+    testModule('bsv.bundle', () => bsv.bundle);
+    testModule('bsv.SmartLedgerBundle', () => bsv.SmartLedgerBundle);
+    
+    // Test bundle convenience methods
+    log('<h2>Bundle Convenience Methods</h2>');
+    if (bsv.SmartLedgerBundle) {
+      testModule('generateKeys()', () => bsv.SmartLedgerBundle.generateKeys);
+      testModule('createMessage()', () => bsv.SmartLedgerBundle.createMessage);
+      testModule('encrypt()', () => bsv.SmartLedgerBundle.encrypt);
+      testModule('examineScript()', () => bsv.SmartLedgerBundle.examineScript);
+      testModule('createCovenant()', () => bsv.SmartLedgerBundle.createCovenant);
+      testModule('createCustomSignature()', () => bsv.SmartLedgerBundle.createCustomSignature);
+      testModule('calculateSighash()', () => bsv.SmartLedgerBundle.calculateSighash);
+    }
+    
+    // Show bundle info
+    if (bsv.bundle) {
+      log('<h2>Bundle Contents</h2>');
+      log(`<div>Version: ${bsv.bundle.version}</div>`);
+      log(`<div>Type: ${bsv.bundle.type}</div>`);
+      log(`<div>Includes: ${bsv.bundle.includes.join(', ')}</div>`);
+    }
+    
+    // Final summary
+    log('<h2>Summary</h2>');
+    const successCount = document.querySelectorAll('.success').length;
+    const errorCount = document.querySelectorAll('.error').length;
+    const warningCount = document.querySelectorAll('.warning').length;
+    
+    log(`<div><strong>✅ Successful: ${successCount}</strong></div>`);
+    if (errorCount > 0) log(`<div><strong>❌ Errors: ${errorCount}</strong></div>`);
+    if (warningCount > 0) log(`<div><strong>⚠️ Warnings: ${warningCount}</strong></div>`);
+  </script>
+</body>
+</html>