@smartledger/bsv 1.5.6-fix1 → 3.1.0

package/lib/smartutxo.js

@@ -0,0 +1,200 @@
+'use strict'
+
+/**
+ * SmartLedger UTXO Management System
+ * Provides blockchain state management and UTXO tracking for testing and development
+ */
+
+// Browser-compatible imports
+let fs, path, crypto, blockchainState
+
+// Only require Node.js modules in Node.js environment
+if (typeof window === 'undefined' && typeof require === 'function') {
+  try {
+    fs = require('fs')
+    path = require('path')
+    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')
+  }
+}
+
+/**
+ * Comprehensive UTXO Management System for BSV development
+ */
+class SmartUTXOManager {
+  constructor(options = {}) {
+    this.options = options || {}
+    
+    // Initialize blockchain state - this creates the file if needed
+    this.loadState()
+  }
+
+  /**
+   * Load blockchain state from file (initializes if needed)
+   */
+  loadState() {
+    try {
+      const state = blockchainState.loadBlockchainState()
+      return state
+    } catch (error) {
+      console.log('⚠️ Could not load blockchain state:', error.message)
+      return null
+    }
+  }
+
+  /**
+   * Save blockchain state to file  
+   */
+  saveState() {
+    try {
+      const state = blockchainState.loadBlockchainState()
+      blockchainState.saveBlockchainState(state)
+      const utxoCount = Object.keys(state.globalUTXOSet || {}).length
+      console.log(`💾 Saved blockchain state with ${utxoCount} UTXOs`)
+    } catch (error) {
+      console.log('⚠️ Could not save blockchain state:', error.message)
+    }
+  }
+
+  /**
+   * Get all UTXOs for a given address
+   * @param {string} address - Bitcoin address
+   * @returns {Array} Array of UTXO objects
+   */
+  getUTXOsForAddress(address) {
+    try {
+      const state = blockchainState.loadBlockchainState()
+      
+      // Check if wallet exists
+      if (!state.wallets || !state.wallets[address]) {
+        return []
+      }
+      
+      // Return the wallet's UTXOs
+      return state.wallets[address].utxos || []
+    } catch (error) {
+      console.log('⚠️ Error getting UTXOs:', error.message)
+      return []
+    }
+  }
+
+  /**
+   * Add a new UTXO to the system
+   * @param {Object} utxo - UTXO object {txid, vout, address, satoshis, script}
+   */
+  addUTXO(utxo) {
+    try {
+      // Use the correct API: addUTXO(utxo, ownerAddress)
+      blockchainState.addUTXO(utxo, utxo.address)
+    } catch (error) {
+      console.log('⚠️ Error adding UTXO:', error.message)
+    }
+  }
+
+  /**
+   * Spend UTXOs (remove from available set)
+   * @param {Array} inputs - Array of input objects {txid, vout}
+   * @param {string} spentInTx - Optional transaction ID where UTXO was spent
+   */
+  spendUTXOs(inputs, spentInTx = 'manual-spend') {
+    try {
+      for (const input of inputs) {
+        // Use the correct API: spendUTXO(txid, vout, spentInTx)
+        blockchainState.spendUTXO(input.txid, input.vout, spentInTx)
+      }
+    } catch (error) {
+      console.log('⚠️ Error spending UTXOs:', error.message)
+    }
+  }
+
+  /**
+   * Create mock UTXOs for testing
+   * @param {string} address - Target address
+   * @param {number} count - Number of UTXOs to create
+   * @param {number} satoshis - Satoshis per UTXO
+   * @returns {Array} Array of created UTXOs
+   */
+  createMockUTXOs(address, count = 5, satoshis = 100000) {
+    const mockUTXOs = []
+    
+    for (let i = 0; i < count; i++) {
+      const txid = crypto.randomBytes(32).toString('hex')
+      const vout = i
+      const script = `76a914${crypto.randomBytes(20).toString('hex')}88ac` // Mock P2PKH script
+      
+      const utxo = {
+        txid,
+        vout,
+        address,
+        satoshis,
+        script
+      }
+      
+      mockUTXOs.push(utxo)
+    }
+    
+    return mockUTXOs
+  }
+
+  /**
+   * Get total balance for an address
+   * @param {string} address - Bitcoin address
+   * @returns {number} Total satoshis
+   */
+  getBalance(address) {
+    try {
+      const state = blockchainState.loadBlockchainState()
+      
+      // Check if wallet exists
+      if (!state.wallets || !state.wallets[address]) {
+        return 0
+      }
+      
+      // Return the wallet's total value
+      return state.wallets[address].totalValue || 0
+    } catch (error) {
+      console.log('⚠️ Error getting balance:', error.message)
+      return 0
+    }
+  }
+
+  /**
+   * Get blockchain statistics
+   * @returns {Object} Stats object
+   */
+  getStats() {
+    try {
+      const state = blockchainState.getBlockchainStats() // This returns the full state
+      return {
+        totalUTXOs: state.metadata.totalUTXOs,
+        totalValue: state.metadata.totalValue,
+        totalWallets: state.metadata.totalWallets,
+        blockHeight: state.metadata.blockHeight,
+        lastUpdated: state.metadata.lastUpdated
+      }
+    } catch (error) {
+      console.log('⚠️ Error getting stats:', error.message)
+      return { totalUTXOs: 0, totalValue: 0, totalWallets: 0, blockHeight: 0 }
+    }
+  }
+
+  /**
+   * Reset blockchain state
+   */
+  reset() {
+    try {
+      const statePath = path.join(__dirname, '../utilities/blockchain-state.json')
+      if (fs.existsSync(statePath)) {
+        fs.unlinkSync(statePath)
+        console.log('🔄 Blockchain state reset')
+      }
+    } catch (error) {
+      console.log('⚠️ Could not reset blockchain state:', error.message)
+    }
+  }
+}
+
+module.exports = SmartUTXOManager

package/lib/transaction/transaction.js

@@ -24,6 +24,10 @@ var Output = require('./output')
 var Script = require('../script')
 var PrivateKey = require('../privatekey')
 var BN = require('../crypto/bn')
+var Interpreter = require('../script/interpreter')
+
+// By default, we sign with sighash_forkid
+var DEFAULT_SIGN_FLAGS = Interpreter.SCRIPT_ENABLE_SIGHASH_FORKID
 
 /**
  * Represents a transaction, a set of inputs and outputs to change ownership of tokens
@@ -1205,4 +1209,39 @@ Transaction.prototype.isCoinbase = function () {
   return (this.inputs.length === 1 && this.inputs[0].isNull())
 }
 
+/**
+ * Calculate the signature hash for an input
+ * 
+ * @param {number} inputIndex - The index of the input to sign
+ * @param {number} sighashType - The signature hash type (optional, defaults to ALL|FORKID)
+ * @param {Script} subscript - The subscript to use (optional, derived from input)
+ * @param {BN} satoshisBN - The amount in satoshis for this input (optional, derived from input)
+ * @param {number} flags - Script verification flags (optional)
+ * @return {Buffer} The signature hash for this input
+ */
+Transaction.prototype.sighash = function (inputIndex, sighashType, subscript, satoshisBN, flags) {
+  sighashType = sighashType || (Signature.SIGHASH_ALL | Signature.SIGHASH_FORKID)
+  
+  // Get the input we're signing for
+  var input = this.inputs[inputIndex]
+  if (!input) {
+    throw new Error('Input index ' + inputIndex + ' does not exist')
+  }
+  
+  // If subscript not provided, derive it from the input
+  if (!subscript && input.output) {
+    subscript = input.output.script
+  }
+  
+  // If satoshisBN not provided, derive it from the input
+  if (!satoshisBN && input.output) {
+    satoshisBN = new BN(input.output.satoshis)
+  }
+  
+  // Use default flags if not provided
+  flags = flags || DEFAULT_SIGN_FLAGS
+  
+  return Sighash.sighash(this, sighashType, inputIndex, subscript, satoshisBN, flags)
+}
+
 module.exports = Transaction

package/package.json

@@ -1,10 +1,7 @@
 {
   "name": "@smartledger/bsv",
-  "version": "1.5.6-fix1",
-  "publishConfig": {
-    "access": "public"
-  },
-  "description": "Security-hardened Bitcoin SV library - Complete drop-in replacement for bsv@1.5.6 with zero vulnerabilities",
+  "version": "3.1.0",
+  "description": "Security-hardened Bitcoin SV library with custom script framework - Complete drop-in replacement for bsv@1.5.6 with zero vulnerabilities",
   "author": "SmartLedger Technology <hello@smartledger.technology> (https://smartledger.technology)",
   "homepage": "https://github.com/codenlighten/smartledger-bsv#readme",
   "bugs": {
@@ -14,15 +11,38 @@
   "scripts": {
     "lint": "standard",
     "test": "standard && mocha",
+    "test:signatures": "node validation_test.js",
     "coverage": "nyc --reporter=text npm run test",
     "build-bsv": "webpack index.js --config webpack.config.js",
     "build-ecies": "webpack ecies/index.js --config webpack.subproject.config.js --output-library bsvEcies -o bsv-ecies.min.js",
     "build-message": "webpack message/index.js --config webpack.subproject.config.js --output-library bsvMessage -o bsv-message.min.js",
     "build-mnemonic": "webpack mnemonic/index.js --config webpack.subproject.config.js --output-library bsvMnemonic -o bsv-mnemonic.min.js",
+    "build-bundle": "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",
     "prepublishOnly": "NODE_OPTIONS=\"--openssl-legacy-provider\" npm run build"
   },
   "unpkg": "bsv.min.js",
+  "jsdelivr": "bsv.min.js",
+  "cdn": "bsv.min.js",
+  "files": [
+    "index.js",
+    "lib/",
+    "utilities/",
+    "ecies/",
+    "message/",
+    "mnemonic/",
+    "bsv.min.js",
+    "bsv-ecies.min.js",
+    "bsv-message.min.js",
+    "bsv-mnemonic.min.js",
+    "bsv.d.ts",
+    "validation_test.js",
+    "LICENSE",
+    "README.md",
+    "SECURITY.md",
+    "CHANGELOG.md"
+  ],
   "keywords": [
     "bitcoin",
     "bitcoin-sv",
@@ -35,6 +55,11 @@
     "hardened",
     "vulnerability-free",
     "drop-in-replacement",
+    "utxo-management",
+    "blockchain-simulator",
+    "miner-simulator",
+    "testing-tools",
+    "development-framework",
     "ecies",
     "p2p",
     "payment",

package/utilities/README.md

@@ -0,0 +1,132 @@
+# BSV Development Utilities
+
+This folder contains utilities for BSV blockchain development and testing, including a complete blockchain miner simulation system for validating transactions and managing UTXO sets.
+
+## Files Overview
+
+### Core Utilities
+
+- **`mock-utxo-generator.js`** - Generates mock UTXOs for testing and development
+  - Creates realistic mock transaction IDs
+  - Builds P2PKH script hex for addresses
+  - Generates properly formatted UTXO objects
+
+- **`wallet-setup.js`** - Sets up consistent test wallet environments
+  - Creates deterministic test wallets with private keys and addresses
+  - Generates initial mock UTXOs
+  - Saves configuration to `wallet.json`
+
+- **`utxo-manager.js`** - Manages UTXO state and transaction tracking
+  - Tracks spent and available UTXOs
+  - Updates wallet state after transactions
+  - Calculates available balance
+  - Maintains transaction history
+
+### Blockchain Simulation
+
+- **`blockchain-state.js`** - Global blockchain state manager
+  - Manages multiple wallet UTXO sets
+  - Tracks spent and available UTXOs globally
+  - Maintains blockchain metadata (block height, total value)
+  - Supports wallet registration and UTXO validation
+
+- **`miner-simulator.js`** - Complete miner simulation system
+  - Accepts broadcast transactions
+  - Validates inputs against global UTXO set
+  - Verifies transaction signatures
+  - Checks transaction balance (inputs ≥ outputs + fees)
+  - Processes valid transactions and rejects invalid ones
+  - Updates blockchain state after successful transactions
+
+- **`transaction-examples.js`** - Complete transaction flow demonstrations
+  - Simple P2PKH payments
+  - Transaction chaining
+  - Multi-output transactions
+  - Full broadcast → validate → process workflow
+
+### Configuration
+
+- **`wallet.json`** - Persistent wallet state and UTXO tracking
+  - Wallet credentials (private key, address)
+  - Current UTXO set
+  - Spent UTXO history
+  - Transaction metadata
+
+- **`blockchain-state.json`** - Global blockchain database
+  - All wallet addresses and UTXO sets
+  - Global UTXO set (keyed by "txid:vout")
+  - Spent UTXO history
+  - Transaction processing history
+  - Blockchain metadata (block height, etc.)
+
+## Usage
+
+### Quick Start
+
+1. **Initialize a test wallet:**
+   ```bash
+   node wallet-setup.js
+   ```
+
+2. **Import wallet into blockchain state:**
+   ```bash
+   node blockchain-state.js import
+   ```
+
+3. **Run transaction examples:**
+   ```bash
+   node transaction-examples.js        # Run all examples
+   node transaction-examples.js 1      # Run single payment example
+   ```
+
+4. **Check blockchain state:**
+   ```bash
+   node blockchain-state.js           # Show blockchain stats
+   node miner-simulator.js            # Show miner/mempool status
+   node utxo-manager.js               # Show wallet UTXOs
+   ```
+
+### Transaction Flow
+
+The complete transaction flow demonstrates real blockchain behavior:
+
+```javascript
+// 1. Create transaction
+const tx = new bsv.Transaction()
+  .from(utxo)
+  .to(recipientAddress, amount)
+  .change(senderAddress)
+  .fee(1000)
+  .sign(privateKey);
+
+// 2. Broadcast to miner
+const result = acceptTransaction(tx);
+
+// 3. Miner validates:
+// - UTXOs exist and unspent
+// - Signatures are valid  
+// - Transaction balance is correct
+// - No double spending
+
+// 4. If valid: Update global UTXO set
+// 5. If invalid: Reject with error details
+```
+
+### Advanced Usage
+
+- **Multiple wallets:** Each wallet can be registered independently
+- **Transaction validation:** Full BSV-compatible signature and balance checking
+- **Double-spend prevention:** UTXOs tracked globally to prevent reuse
+- **Block simulation:** Each processed transaction increments block height
+
+## Dependencies
+
+These utilities require the BSV library from the parent directory (`../index.js`).
+
+## Purpose
+
+These utilities provide a consistent testing environment for BSV development, particularly useful for:
+- Transaction creation and verification testing
+- UTXO management in multi-transaction scenarios
+- Consistent test wallet environments
+- Mock blockchain data generation