smartledger-bsv 3.0.0 → 3.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smartledger-bsv",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "Security-hardened Bitcoin SV library - 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",
@@ -11,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",
@@ -32,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

package/utilities/blockchain-state.js

@@ -0,0 +1,332 @@
+/**
+ * 🌐 BSV Blockchain State Manager
+ * 
+ * Simulates a global blockchain state with multiple wallets and UTXO tracking.
+ * Acts as the "blockchain database" for our miner simulator.
+ */
+
+// Browser-compatible imports
+let bsv, fs, path, BLOCKCHAIN_STATE_PATH;
+
+// Only require Node.js modules in Node.js environment
+if (typeof window === 'undefined' && typeof require === 'function') {
+  try {
+    bsv = require('../index.js');
+    fs = require('fs');
+    path = require('path');
+    BLOCKCHAIN_STATE_PATH = path.join(__dirname, 'blockchain-state.json');
+  } catch (e) {
+    console.warn('BlockchainState: Running in browser mode - persistence disabled');
+  }
+} else {
+  // In browser, try to get bsv from global scope or fallback
+  bsv = (typeof window !== 'undefined' && window.bsv) || require('../index.js');
+}
+
+/**
+ * Initialize empty blockchain state
+ */
+function initializeBlockchainState() {
+  return {
+    metadata: {
+      createdAt: new Date().toISOString(),
+      lastUpdated: new Date().toISOString(),
+      totalWallets: 0,
+      totalUTXOs: 0,
+      totalValue: 0,
+      blockHeight: 0
+    },
+    wallets: {},  // keyed by address
+    globalUTXOSet: {},  // keyed by "txid:vout"
+    spentUTXOs: {},     // keyed by "txid:vout"
+    transactionHistory: []
+  };
+}
+
+/**
+ * Load blockchain state from file
+ */
+function loadBlockchainState() {
+  try {
+    // In browser, use localStorage or return initial state
+    if (!fs || !BLOCKCHAIN_STATE_PATH) {
+      return initializeBlockchainState();
+    }
+    
+    if (!fs.existsSync(BLOCKCHAIN_STATE_PATH)) {
+      console.log('🆕 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');
+    return state;
+  } catch (error) {
+    console.error('❌ Error loading blockchain state:', error.message);
+    return initializeBlockchainState();
+  }
+}
+
+/**
+ * Save blockchain state to file
+ */
+function saveBlockchainState(state) {
+  try {
+    state.metadata.lastUpdated = new Date().toISOString();
+    
+    // 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');
+    }
+  } catch (error) {
+    console.error('❌ Error saving blockchain state:', error.message);
+  }
+}
+
+/**
+ * Register a new wallet in the blockchain state
+ */
+function registerWallet(walletAddress, walletData) {
+  console.log(`📝 Registering wallet: ${walletAddress}`);
+  
+  const state = loadBlockchainState();
+  
+  if (state.wallets[walletAddress]) {
+    console.log('ℹ️  Wallet already exists, updating...');
+  }
+  
+  state.wallets[walletAddress] = {
+    address: walletAddress,
+    registeredAt: walletData.registeredAt || new Date().toISOString(),
+    utxos: walletData.utxos || [],
+    totalValue: 0
+  };
+  
+  // Add UTXOs to global set
+  if (walletData.utxos) {
+    walletData.utxos.forEach(utxo => {
+      const utxoKey = `${utxo.txid}:${utxo.vout}`;
+      state.globalUTXOSet[utxoKey] = {
+        ...utxo,
+        ownerAddress: walletAddress
+      };
+    });
+  }
+  
+  // Update metadata
+  state.metadata.totalWallets = Object.keys(state.wallets).length;
+  updateBlockchainMetadata(state);
+  
+  saveBlockchainState(state);
+  
+  console.log(`✅ Wallet registered: ${walletAddress}`);
+  return state;
+}
+
+/**
+ * Get UTXO by key (txid:vout)
+ */
+function getUTXO(txid, vout) {
+  const state = loadBlockchainState();
+  const utxoKey = `${txid}:${vout}`;
+  
+  if (state.spentUTXOs[utxoKey]) {
+    return { exists: false, spent: true, utxo: state.spentUTXOs[utxoKey] };
+  }
+  
+  if (state.globalUTXOSet[utxoKey]) {
+    return { exists: true, spent: false, utxo: state.globalUTXOSet[utxoKey] };
+  }
+  
+  return { exists: false, spent: false, utxo: null };
+}
+
+/**
+ * Check if UTXO exists and is unspent
+ */
+function isUTXOAvailable(txid, vout) {
+  const result = getUTXO(txid, vout);
+  return result.exists && !result.spent;
+}
+
+/**
+ * Spend a UTXO (move from available to spent)
+ */
+function spendUTXO(txid, vout, spentInTx) {
+  const state = loadBlockchainState();
+  const utxoKey = `${txid}:${vout}`;
+  
+  if (!state.globalUTXOSet[utxoKey]) {
+    throw new Error(`UTXO ${utxoKey} does not exist`);
+  }
+  
+  if (state.spentUTXOs[utxoKey]) {
+    throw new Error(`UTXO ${utxoKey} already spent`);
+  }
+  
+  // Move UTXO from available to spent
+  const utxo = state.globalUTXOSet[utxoKey];
+  state.spentUTXOs[utxoKey] = {
+    ...utxo,
+    spentInTx,
+    spentAt: new Date().toISOString()
+  };
+  
+  delete state.globalUTXOSet[utxoKey];
+  
+  // Update wallet's UTXO list
+  const wallet = state.wallets[utxo.ownerAddress];
+  if (wallet) {
+    wallet.utxos = wallet.utxos.filter(u => !(u.txid === txid && u.vout === vout));
+  }
+  
+  updateBlockchainMetadata(state);
+  saveBlockchainState(state);
+  console.log(`❌ UTXO spent: ${utxoKey} in tx ${spentInTx}`);
+}
+
+/**
+ * Add new UTXO to the global set
+ */
+function addUTXO(utxo, ownerAddress) {
+  const state = loadBlockchainState();
+  const utxoKey = `${utxo.txid}:${utxo.vout}`;
+  
+  // Check if UTXO already exists
+  if (state.globalUTXOSet[utxoKey]) {
+    console.log(`⚠️ UTXO ${utxoKey} already exists, skipping`);
+    return;
+  }
+  
+  state.globalUTXOSet[utxoKey] = {
+    ...utxo,
+    ownerAddress,
+    createdAt: new Date().toISOString()
+  };
+  
+  // Add to wallet's UTXO list
+  if (!state.wallets[ownerAddress]) {
+    state.wallets[ownerAddress] = {
+      address: ownerAddress,
+      registeredAt: new Date().toISOString(),
+      utxos: [],
+      totalValue: 0
+    };
+  }
+  
+  // Check if UTXO already exists in wallet's list
+  const exists = state.wallets[ownerAddress].utxos.some(existingUTXO => 
+    existingUTXO.txid === utxo.txid && existingUTXO.vout === utxo.vout
+  );
+  
+  if (!exists) {
+    state.wallets[ownerAddress].utxos.push(utxo);
+  }
+  
+  updateBlockchainMetadata(state);
+  saveBlockchainState(state);
+  
+  console.log(`✅ UTXO added: ${utxoKey} for ${ownerAddress}`);
+}
+
+/**
+ * Update blockchain metadata
+ */
+function updateBlockchainMetadata(state) {
+  const totalUTXOs = Object.keys(state.globalUTXOSet).length;
+  const totalValue = Object.values(state.globalUTXOSet)
+    .reduce((sum, utxo) => sum + utxo.satoshis, 0);
+  
+  state.metadata.totalUTXOs = totalUTXOs;
+  state.metadata.totalValue = totalValue;
+  
+  // Update wallet totals
+  Object.values(state.wallets).forEach(wallet => {
+    wallet.totalValue = wallet.utxos.reduce((sum, utxo) => sum + utxo.satoshis, 0);
+  });
+}
+
+/**
+ * Get blockchain statistics
+ */
+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`);
+  
+  if (Object.keys(state.wallets).length > 0) {
+    console.log('👛 Registered Wallets:');
+    Object.entries(state.wallets).forEach(([address, wallet]) => {
+      console.log(`  ${address}: ${wallet.utxos.length} UTXOs, ${wallet.totalValue} sats`);
+    });
+  }
+  
+  return state;
+}
+
+/**
+ * Import existing wallet from wallet.json
+ */
+function importWalletFromFile() {
+  const walletPath = path.join(__dirname, 'wallet.json');
+  
+  if (!fs.existsSync(walletPath)) {
+    console.log('❌ No wallet.json found to import');
+    return false;
+  }
+  
+  try {
+    const walletData = JSON.parse(fs.readFileSync(walletPath, 'utf8'));
+    
+    console.log('📥 Importing wallet from wallet.json...');
+    
+    const walletInfo = {
+      registeredAt: new Date().toISOString(),
+      utxos: walletData.availableUTXOs || [walletData.utxo]
+    };
+    
+    registerWallet(walletData.wallet.address, walletInfo);
+    
+    console.log('✅ Wallet imported successfully');
+    return true;
+  } catch (error) {
+    console.error('❌ Error importing wallet:', error.message);
+    return false;
+  }
+}
+
+// If called directly, show stats or import wallet
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  
+  if (args[0] === 'import') {
+    importWalletFromFile();
+  } else if (args[0] === 'init') {
+    const state = initializeBlockchainState();
+    saveBlockchainState(state);
+    console.log('🆕 Initialized new blockchain state');
+  }
+  
+  getBlockchainStats();
+}
+
+module.exports = {
+  loadBlockchainState,
+  saveBlockchainState,
+  registerWallet,
+  getUTXO,
+  isUTXOAvailable,
+  spendUTXO,
+  addUTXO,
+  getBlockchainStats,
+  importWalletFromFile
+};

package/utilities/blockchain-state.json

@@ -0,0 +1,41 @@
+{
+  "metadata": {
+    "createdAt": "2025-10-19T16:31:36.266Z",
+    "lastUpdated": "2025-10-19T16:31:36.893Z",
+    "totalWallets": 0,
+    "totalUTXOs": 1,
+    "totalValue": 43425,
+    "blockHeight": 0
+  },
+  "wallets": {
+    "11gECtvDapMj5ZuwpvnP6Wv9MTRGxnFRs": {
+      "address": "11gECtvDapMj5ZuwpvnP6Wv9MTRGxnFRs",
+      "registeredAt": "2025-10-19T16:31:36.893Z",
+      "utxos": [
+        {
+          "txid": "44c099bee41c7ffe853e4310e413781e1f543f554bafb9e46cad44f89ce3447e",
+          "vout": 1,
+          "address": "11gECtvDapMj5ZuwpvnP6Wv9MTRGxnFRs",
+          "satoshis": 43425,
+          "script": "76a9140020bee080cfdeb430cf723d952dc88b6bb7424188ac",
+          "height": 0
+        }
+      ],
+      "totalValue": 43425
+    }
+  },
+  "globalUTXOSet": {
+    "44c099bee41c7ffe853e4310e413781e1f543f554bafb9e46cad44f89ce3447e:1": {
+      "txid": "44c099bee41c7ffe853e4310e413781e1f543f554bafb9e46cad44f89ce3447e",
+      "vout": 1,
+      "address": "11gECtvDapMj5ZuwpvnP6Wv9MTRGxnFRs",
+      "satoshis": 43425,
+      "script": "76a9140020bee080cfdeb430cf723d952dc88b6bb7424188ac",
+      "height": 0,
+      "ownerAddress": "11gECtvDapMj5ZuwpvnP6Wv9MTRGxnFRs",
+      "createdAt": "2025-10-19T16:31:36.893Z"
+    }
+  },
+  "spentUTXOs": {},
+  "transactionHistory": []
+}