@smartledger/bsv 3.4.2 → 3.4.4

package/lib/smartutxo.js

@@ -5,6 +5,15 @@
  * Provides blockchain state management and UTXO tracking for testing and development
  */
 
+// Set BSV_DEBUG=1 (Node) or window.BSV_DEBUG = true (browser) to surface
+// info/warning output from this module. Matches the gating pattern used
+// by lib/browser-utxo-manager-es5.js since v3.4.1.
+const debug = function () {
+  const enabled = (typeof process !== 'undefined' && process.env && process.env.BSV_DEBUG) ||
+                  (typeof window !== 'undefined' && window.BSV_DEBUG)
+  if (enabled) console.log.apply(console, arguments)
+}
+
 // Browser-compatible imports
 let fs, path, crypto, blockchainState
 
@@ -16,8 +25,7 @@ if (typeof window === 'undefined' && typeof require === 'function') {
     crypto = require('crypto')
     blockchainState = require('../utilities/blockchain-state')
   } catch (e) {
-    // Fallback for environments where these modules aren't available
-    console.warn('SmartUTXO: Running in browser mode - some features may be limited')
+    debug('SmartUTXO: Running in browser mode - some features may be limited')
   }
 }
 
@@ -40,7 +48,7 @@ class SmartUTXOManager {
       const state = blockchainState.loadBlockchainState()
       return state
     } catch (error) {
-      console.log('⚠️ Could not load blockchain state:', error.message)
+      debug('⚠️ Could not load blockchain state:', error.message)
       return null
     }
   }
@@ -53,9 +61,9 @@ class SmartUTXOManager {
       const state = blockchainState.loadBlockchainState()
       blockchainState.saveBlockchainState(state)
       const utxoCount = Object.keys(state.globalUTXOSet || {}).length
-      console.log(`💾 Saved blockchain state with ${utxoCount} UTXOs`)
+      debug(`💾 Saved blockchain state with ${utxoCount} UTXOs`)
     } catch (error) {
-      console.log('⚠️ Could not save blockchain state:', error.message)
+      debug('⚠️ Could not save blockchain state:', error.message)
     }
   }
 
@@ -76,7 +84,7 @@ class SmartUTXOManager {
       // Return the wallet's UTXOs
       return state.wallets[address].utxos || []
     } catch (error) {
-      console.log('⚠️ Error getting UTXOs:', error.message)
+      debug('⚠️ Error getting UTXOs:', error.message)
       return []
     }
   }
@@ -90,7 +98,7 @@ class SmartUTXOManager {
       // Use the correct API: addUTXO(utxo, ownerAddress)
       blockchainState.addUTXO(utxo, utxo.address)
     } catch (error) {
-      console.log('⚠️ Error adding UTXO:', error.message)
+      debug('⚠️ Error adding UTXO:', error.message)
     }
   }
 
@@ -106,7 +114,7 @@ class SmartUTXOManager {
         blockchainState.spendUTXO(input.txid, input.vout, spentInTx)
       }
     } catch (error) {
-      console.log('⚠️ Error spending UTXOs:', error.message)
+      debug('⚠️ Error spending UTXOs:', error.message)
     }
   }
 
@@ -156,7 +164,7 @@ class SmartUTXOManager {
       // Return the wallet's total value
       return state.wallets[address].totalValue || 0
     } catch (error) {
-      console.log('⚠️ Error getting balance:', error.message)
+      debug('⚠️ Error getting balance:', error.message)
       return 0
     }
   }
@@ -176,7 +184,7 @@ class SmartUTXOManager {
         lastUpdated: state.metadata.lastUpdated
       }
     } catch (error) {
-      console.log('⚠️ Error getting stats:', error.message)
+      debug('⚠️ Error getting stats:', error.message)
       return { totalUTXOs: 0, totalValue: 0, totalWallets: 0, blockHeight: 0 }
     }
   }
@@ -189,10 +197,10 @@ class SmartUTXOManager {
       const statePath = path.join(__dirname, '../utilities/blockchain-state.json')
       if (fs.existsSync(statePath)) {
         fs.unlinkSync(statePath)
-        console.log('🔄 Blockchain state reset')
+        debug('🔄 Blockchain state reset')
       }
     } catch (error) {
-      console.log('⚠️ Could not reset blockchain state:', error.message)
+      debug('⚠️ Could not reset blockchain state:', error.message)
     }
   }
 }

package/lib/transaction/transaction.js

@@ -911,6 +911,13 @@ Transaction.prototype._getUnspentValue = function () {
 
 Transaction.prototype._clearSignatures = function () {
   _.each(this.inputs, function (input) {
+    // Custom-script inputs (bare Input base class — e.g. covenant or other
+    // non-standard locking scripts) have no library-managed signatures to
+    // clear; the caller owns input.script. Mirror the guard pattern used by
+    // Transaction.prototype.isFullySigned / isValidSignature below.
+    if (input.clearSignatures === Input.prototype.clearSignatures) {
+      return
+    }
     input.clearSignatures()
   })
 }

package/ltp-entry.js

@@ -1,2 +1 @@
-// LTP module placeholder - will be implemented in future release
-module.exports = require('./lib/smart_contract');
+module.exports = require('./lib/ltp')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartledger/bsv",
-  "version": "3.4.2",
+  "version": "3.4.4",
   "description": "🚀 Complete Bitcoin SV development framework with legally-recognizable DID:web + W3C VC-JWT toolkit, Legal Token Protocol (LTP), Global Digital Attestation Framework (GDAF), StatusList2021 revocation, and 16 flexible loading options. Standards-based credentials with ES256/ES256K support, on-chain BSV anchoring, and comprehensive Bitcoin SV API. Perfect for legal tokens, verifiable credentials, DeFi, smart contracts, and secure Bitcoin applications.",
   "author": "SmartLedger Technology <hello@smartledger.technology> (https://smartledger.technology)",
   "homepage": "https://github.com/codenlighten/smartledger-bsv#readme",
@@ -8,12 +8,14 @@
     "url": "https://github.com/codenlighten/smartledger-bsv/issues"
   },
   "main": "index.js",
+  "types": "bsv.d.ts",
   "bin": {
     "smartledger-bsv": "./bin/cli.js"
   },
   "scripts": {
     "lint": "standard",
     "test": "mocha",
+    "test:cli": "mocha test/cli/smoke.js --timeout 25000",
     "test:ltp": "node complete_ltp_demo.js",
     "test:ltp-primitives": "node simple_demo.js",
     "test:architecture": "node architecture_demo.js",
@@ -96,8 +98,6 @@
     "bsv-anchor.min.js",
     "bsv.d.ts",
     "docs/",
-    "demos/",
-    "examples/",
     "LICENSE",
     "README.md",
     "SECURITY.md",

package/utilities/blockchain-state.js

@@ -5,6 +5,15 @@
  * Acts as the "blockchain database" for our miner simulator.
  */
 
+// Set BSV_DEBUG=1 (Node) or window.BSV_DEBUG = true (browser) to surface
+// info/warning narration from this module. Matches the gating pattern
+// used by lib/browser-utxo-manager-es5.js since v3.4.1.
+const debug = function () {
+  const enabled = (typeof process !== 'undefined' && process.env && process.env.BSV_DEBUG) ||
+                  (typeof window !== 'undefined' && window.BSV_DEBUG)
+  if (enabled) console.log.apply(console, arguments)
+}
+
 // Browser-compatible imports
 let bsv, fs, path, BLOCKCHAIN_STATE_PATH
 
@@ -16,7 +25,7 @@ if (typeof window === 'undefined' && typeof require === 'function') {
     path = require('path')
     BLOCKCHAIN_STATE_PATH = path.join(__dirname, 'blockchain-state.json')
   } catch (e) {
-    console.warn('BlockchainState: Running in browser mode - persistence disabled')
+    debug('BlockchainState: Running in browser mode - persistence disabled')
   }
 } else {
   // In browser, try to get bsv from global scope or fallback
@@ -54,14 +63,14 @@ function loadBlockchainState () {
     }
 
     if (!fs.existsSync(BLOCKCHAIN_STATE_PATH)) {
-      console.log('🆕 Creating new blockchain state...')
+      debug('🆕 Creating new blockchain state...')
       const initialState = initializeBlockchainState()
       saveBlockchainState(initialState)
       return initialState
     }
 
     const state = JSON.parse(fs.readFileSync(BLOCKCHAIN_STATE_PATH, 'utf8'))
-    console.log('📖 Loaded existing blockchain state')
+    debug('📖 Loaded existing blockchain state')
     return state
   } catch (error) {
     console.error('❌ Error loading blockchain state:', error.message)
@@ -79,7 +88,7 @@ function saveBlockchainState (state) {
     // Only save to file in Node.js environment
     if (fs && BLOCKCHAIN_STATE_PATH) {
       fs.writeFileSync(BLOCKCHAIN_STATE_PATH, JSON.stringify(state, null, 2))
-      console.log('💾 Blockchain state saved')
+      debug('💾 Blockchain state saved')
     }
   } catch (error) {
     console.error('❌ Error saving blockchain state:', error.message)
@@ -90,12 +99,12 @@ function saveBlockchainState (state) {
  * Register a new wallet in the blockchain state
  */
 function registerWallet (walletAddress, walletData) {
-  console.log(`📝 Registering wallet: ${walletAddress}`)
+  debug(`📝 Registering wallet: ${walletAddress}`)
 
   const state = loadBlockchainState()
 
   if (state.wallets[walletAddress]) {
-    console.log('ℹ️  Wallet already exists, updating...')
+    debug('ℹ️  Wallet already exists, updating...')
   }
 
   state.wallets[walletAddress] = {
@@ -122,7 +131,7 @@ function registerWallet (walletAddress, walletData) {
 
   saveBlockchainState(state)
 
-  console.log(`✅ Wallet registered: ${walletAddress}`)
+  debug(`✅ Wallet registered: ${walletAddress}`)
   return state
 }
 
@@ -185,7 +194,7 @@ function spendUTXO (txid, vout, spentInTx) {
 
   updateBlockchainMetadata(state)
   saveBlockchainState(state)
-  console.log(`❌ UTXO spent: ${utxoKey} in tx ${spentInTx}`)
+  debug(`❌ UTXO spent: ${utxoKey} in tx ${spentInTx}`)
 }
 
 /**
@@ -197,7 +206,7 @@ function addUTXO (utxo, ownerAddress) {
 
   // Check if UTXO already exists
   if (state.globalUTXOSet[utxoKey]) {
-    console.log(`⚠️ UTXO ${utxoKey} already exists, skipping`)
+    debug(`⚠️ UTXO ${utxoKey} already exists, skipping`)
     return
   }
 
@@ -229,7 +238,7 @@ function addUTXO (utxo, ownerAddress) {
   updateBlockchainMetadata(state)
   saveBlockchainState(state)
 
-  console.log(`✅ UTXO added: ${utxoKey} for ${ownerAddress}`)
+  debug(`✅ UTXO added: ${utxoKey} for ${ownerAddress}`)
 }
 
 /**
@@ -255,18 +264,18 @@ function updateBlockchainMetadata (state) {
 function getBlockchainStats () {
   const state = loadBlockchainState()
 
-  console.log('🌐 Blockchain State Statistics:')
-  console.log('═══════════════════════════════════════════')
-  console.log(`📊 Total Wallets: ${state.metadata.totalWallets}`)
-  console.log(`💰 Total UTXOs: ${state.metadata.totalUTXOs}`)
-  console.log(`💎 Total Value: ${state.metadata.totalValue} satoshis`)
-  console.log(`🏗️  Block Height: ${state.metadata.blockHeight}`)
-  console.log(`🕐 Last Updated: ${state.metadata.lastUpdated}\n`)
+  debug('🌐 Blockchain State Statistics:')
+  debug('═══════════════════════════════════════════')
+  debug(`📊 Total Wallets: ${state.metadata.totalWallets}`)
+  debug(`💰 Total UTXOs: ${state.metadata.totalUTXOs}`)
+  debug(`💎 Total Value: ${state.metadata.totalValue} satoshis`)
+  debug(`🏗️  Block Height: ${state.metadata.blockHeight}`)
+  debug(`🕐 Last Updated: ${state.metadata.lastUpdated}\n`)
 
   if (Object.keys(state.wallets).length > 0) {
-    console.log('👛 Registered Wallets:')
+    debug('👛 Registered Wallets:')
     Object.entries(state.wallets).forEach(([address, wallet]) => {
-      console.log(`  ${address}: ${wallet.utxos.length} UTXOs, ${wallet.totalValue} sats`)
+      debug(`  ${address}: ${wallet.utxos.length} UTXOs, ${wallet.totalValue} sats`)
     })
   }
 
@@ -280,14 +289,14 @@ function importWalletFromFile () {
   const walletPath = path.join(__dirname, 'wallet.json')
 
   if (!fs.existsSync(walletPath)) {
-    console.log('❌ No wallet.json found to import')
+    debug('❌ No wallet.json found to import')
     return false
   }
 
   try {
     const walletData = JSON.parse(fs.readFileSync(walletPath, 'utf8'))
 
-    console.log('📥 Importing wallet from wallet.json...')
+    debug('📥 Importing wallet from wallet.json...')
 
     const walletInfo = {
       registeredAt: new Date().toISOString(),
@@ -296,7 +305,7 @@ function importWalletFromFile () {
 
     registerWallet(walletData.wallet.address, walletInfo)
 
-    console.log('✅ Wallet imported successfully')
+    debug('✅ Wallet imported successfully')
     return true
   } catch (error) {
     console.error('❌ Error importing wallet:', error.message)
@@ -313,7 +322,7 @@ if (require.main === module) {
   } else if (args[0] === 'init') {
     const state = initializeBlockchainState()
     saveBlockchainState(state)
-    console.log('🆕 Initialized new blockchain state')
+    debug('🆕 Initialized new blockchain state')
   }
 
   getBlockchainStats()

package/demos/README.md

@@ -1,188 +0,0 @@
-# 🚀 SmartLedger-BSV Demo Collection
-
-This directory contains interactive demonstrations of the SmartLedger-BSV smart contract framework capabilities.
-
-## 📋 Available Demos
-
-### 1. 🌐 **HTML Interactive Demo** (`smart_contract_demo.html`)
-**Web-based interactive demonstration with visual interface**
-
-- **Purpose:** Browser-based exploration of smart contract features
-- **Interface:** Modern web UI with tabs, buttons, and real-time output
-- **Best for:** Visual learners, presentations, and quick exploration
-
-**Features:**
-- 📚 **Basics Tab** - Library loading and feature overview
-- 🔒 **Covenant Builder** - Interactive covenant creation with multiple types
-- 🧾 **Preimage Parser** - BIP-143 transaction field extraction
-- 💎 **UTXO Generator** - Mock UTXO creation and management
-- 🛠️ **Script Tools** - Bitcoin Script building and analysis
-
-**Usage:**
-```bash
-# Serve locally (requires http-server or similar)
-npx http-server demos/
-# Then open http://localhost:8080/smart_contract_demo.html
-
-# Or open directly in browser
-open demos/smart_contract_demo.html
-```
-
----
-
-### 2. 💻 **Node.js CLI Demo** (`smart_contract_demo.js`)
-**Command-line interactive demonstration for developers**
-
-- **Purpose:** Terminal-based smart contract development workflow
-- **Interface:** Interactive CLI with colored output and structured commands
-- **Best for:** Developers, automation, CI/CD integration
-
-**Features:**
-- 🎯 **Interactive Mode** - Full CLI experience with command history
-- ⚡ **Direct Commands** - Run specific features without interaction
-- 🎨 **Colored Output** - Enhanced readability with chalk (optional)
-- 📊 **Structured Logging** - Timestamped output with status indicators
-- 🔧 **Developer-Friendly** - Perfect for scripting and automation
-
-**Usage:**
-
-```bash
-# Interactive mode
-node demos/smart_contract_demo.js
-
-# Show help
-node demos/smart_contract_demo.js --help
-
-# Run specific features
-node demos/smart_contract_demo.js --feature basics
-node demos/smart_contract_demo.js --feature covenant
-node demos/smart_contract_demo.js --feature preimage
-node demos/smart_contract_demo.js --feature utxo
-node demos/smart_contract_demo.js --feature scripts
-```
-
-**Interactive Commands:**
-```
-smartledger-bsv> basics                    # Load library and run tests
-smartledger-bsv> covenant generate simple  # Generate simple covenant
-smartledger-bsv> covenant test             # Test current covenant  
-smartledger-bsv> preimage sample           # Generate sample transaction
-smartledger-bsv> utxo generate 50000       # Generate 50k sat UTXO
-smartledger-bsv> scripts build             # Build sample script
-smartledger-bsv> examples                  # Show real-world use cases
-smartledger-bsv> help                      # Show all commands
-smartledger-bsv> exit                      # Exit demo
-```
-
----
-
-## 🎯 **Feature Comparison**
-
-| Feature | HTML Demo | Node.js Demo |
-|---------|-----------|--------------|
-| **Interface** | Visual web UI | Command-line interface |
-| **Interactivity** | Click-based | Type-based commands |
-| **Real-time Output** | Browser console + UI | Terminal with colors |
-| **Covenant Builder** | Form inputs + dropdowns | Command parameters |
-| **Script Analysis** | Visual results panel | Structured text output |
-| **UTXO Management** | Interactive forms | Command-driven |
-| **Automation** | Manual only | Scriptable commands |
-| **Dependencies** | Modern browser | Node.js (chalk optional) |
-| **Best Use Case** | Learning & exploration | Development & testing |
-
----
-
-## 🔧 **Common Features Demonstrated**
-
-Both demos showcase the complete SmartLedger-BSV functionality:
-
-### **Core Capabilities**
-- ✅ **Private Key & Address Generation** - Create BSV wallets
-- ✅ **Transaction Building** - Construct valid BSV transactions  
-- ✅ **Script Creation** - Build custom Bitcoin Scripts
-- ✅ **UTXO Management** - Generate and spend test UTXOs
-- ✅ **Preimage Parsing** - Extract BIP-143 transaction fields
-- ✅ **Covenant Logic** - Create smart contract spending conditions
-
-### **Smart Contract Types**
-1. **Simple Covenants** - Basic spending restrictions
-2. **Timelock Covenants** - Time-based spending conditions using preimage validation
-3. **Multisig Covenants** - Multi-signature requirements
-4. **Conditional Covenants** - IF/ELSE spending paths
-
-### **Advanced Features**
-- 🧾 **BIP-143 Preimage Extraction** - Parse transaction preimages
-- 📊 **SIGHASH Analysis** - Understand signature hash types
-- 🔍 **Script Debugging** - Step-through script execution
-- ⚡ **Script Optimization** - Minimize script size and cost
-- 🧪 **Local Testing** - Verify scripts without blockchain access
-
----
-
-## 🚀 **Quick Start Guide**
-
-### **For Visual Learners (HTML Demo)**
-1. Open `smart_contract_demo.html` in your browser
-2. Click "Load BSV Smart Contract Library"  
-3. Explore each tab (Basics → Covenant → Preimage → UTXO → Scripts)
-4. Try the real-world use case examples
-
-### **For Developers (Node.js Demo)**
-1. Run `node demos/smart_contract_demo.js`
-2. Type `basics` to load and test the library
-3. Try `covenant generate simple` to create your first covenant
-4. Use `help` to see all available commands
-5. Explore with `utxo generate`, `preimage sample`, etc.
-
----
-
-## 📚 **Learning Path**
-
-**Recommended progression through the demos:**
-
-1. **🎯 Start Here:** `basics` - Understand core BSV functionality
-2. **🏗️ Build:** `covenant generate` - Create your first smart contract  
-3. **🔍 Analyze:** `preimage sample` - Understand transaction structure
-4. **💎 Manage:** `utxo generate` - Handle UTXOs and spending
-5. **🛠️ Script:** `scripts build` - Custom Bitcoin Script development
-6. **🎓 Advanced:** `examples` - Real-world smart contract patterns
-
----
-
-## 🔗 **Related Documentation**
-
-- **[Usage Guide](../docs/SMARTLEDGER_BSV_USAGE_GUIDE.md)** - Complete API reference
-- **[Usage Answers](../docs/SMARTLEDGER_BSV_USAGE_ANSWERS.md)** - FAQ and troubleshooting
-- **[Smart Contract Guide](../docs/advanced/SMART_CONTRACT_GUIDE.md)** - Advanced development
-- **[Examples Directory](../examples/)** - Additional code samples
-- **[GitHub Repository](https://github.com/codenlighten/smartledger-bsv)** - Source code
-
----
-
-## 🆘 **Support & Troubleshooting**
-
-### **Common Issues**
-
-**HTML Demo:**
-- **Bundle not found:** Ensure `../bsv.bundle.js` exists (run `npm run build`)
-- **CORS issues:** Serve via HTTP server, don't open file:// directly
-- **Console errors:** Check browser developer tools for detailed errors
-
-**Node.js Demo:**
-- **Module errors:** Run `npm install` to ensure dependencies
-- **Chalk missing:** Demo works without chalk (fallback to plain text)
-- **Permission denied:** Use `chmod +x demos/smart_contract_demo.js`
-
-### **Getting Help**
-
-- **Issues:** [GitHub Issues](https://github.com/codenlighten/smartledger-bsv/issues)
-- **Documentation:** Check the `docs/` directory for detailed guides
-- **Examples:** Browse `examples/` for working code samples
-
----
-
-**Created by:** SmartLedger-BSV Development Team  
-**Version:** v3.3.4  
-**Last Updated:** October 30, 2025
-
-*Both demos provide identical functionality - choose the interface that works best for your workflow!* 🎉