@smartledger/bsv 3.4.5 → 4.0.1

package/lib/smartutxo.js

@@ -1,8 +1,29 @@
 'use strict'
 
 /**
- * SmartLedger UTXO Management System
- * Provides blockchain state management and UTXO tracking for testing and development
+ * SmartLedger UTXO Management System — DEVELOPMENT ONLY
+ * =====================================================
+ *
+ * `SmartUTXOManager` is a file-backed wallet/UTXO simulator intended for
+ * local testing and example scripts. It persists state to
+ * `<package-root>/utilities/blockchain-state.json`, has no concurrency
+ * controls (multiple processes will race on the same file), and ships
+ * with an empty seed for npm consumers (the 3.3 MB development fixture
+ * is `.npmignore`d). Do NOT use it as a production UTXO manager —
+ * production wallets should track UTXOs themselves and never rely on a
+ * shared file inside `node_modules`.
+ *
+ * Supported import path (works in any consumer):
+ *
+ *   const SmartUTXO = require('@smartledger/bsv/lib/smartutxo')
+ *
+ * Or, from within the smartledger-bsv repo:
+ *
+ *   const SmartUTXO = require('./lib/smartutxo')
+ *
+ * The legacy `bsv.SmartUTXO` namespace export was soft-deprecated in
+ * v4.0.1 (logs a one-shot warning on access) and will be removed in
+ * v5.0.0.
  */
 
 // Set BSV_DEBUG=1 (Node) or window.BSV_DEBUG = true (browser) to surface
@@ -119,31 +140,37 @@ class SmartUTXOManager {
   }
 
   /**
-   * Create mock UTXOs for testing
-   * @param {string} address - Target address
+   * Create mock UTXOs for testing. Each mock has a fresh random txid and
+   * a P2PKH locking script that actually encodes the provided address
+   * (so any private key for `address` can sign against the resulting
+   * `script` via the high-level API).
+   *
+   * This is a pure factory — the returned UTXOs are NOT added to the
+   * simulator state. Call `.addUTXO(...)` on each one to persist them.
+   *
+   * @param {string} address - Target address (livenet or testnet)
    * @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) {
+    // Use bsv's own RNG so this works in both Node and browser builds
+    // (the Node `crypto` import above is undefined in browser context).
+    const bsv = require('../')
+    const lockingScriptHex = bsv.Script.buildPublicKeyHashOut(
+      bsv.Address.fromString(address)
+    ).toHex()
+
     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,
+      mockUTXOs.push({
+        txid: bsv.crypto.Random.getRandomBuffer(32).toString('hex'),
+        vout: i,
         address,
         satoshis,
-        script
-      }
-      
-      mockUTXOs.push(utxo)
+        script: lockingScriptHex
+      })
     }
-    
     return mockUTXOs
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartledger/bsv",
-  "version": "3.4.5",
+  "version": "4.0.1",
   "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",
@@ -74,7 +74,6 @@
     "lib/",
     "utilities/*.js",
     "utilities/README.md",
-    "utilities/wallet.json",
     "ecies/",
     "message/",
     "mnemonic/",
@@ -132,7 +131,6 @@
     "debug-tools",
     "modular-loading",
     "standalone-modules",
-    "security-hardened",
     "elliptic-curve-fix",
     "smartledger",
     "transaction",
@@ -184,7 +182,6 @@
     "webpack-ready",
     "cdn-ready",
     "typescript-definitions",
-    "vulnerability-free",
     "drop-in-replacement",
     "performance-optimized",
     "bip21",

package/utilities/wallet.json

@@ -1,30 +0,0 @@
-{
-  "wallet": {
-    "privateKeyWIF": "KwbaQqFUpt9MYQRrkVWk7QC799nAfcqYRYKj4ZNeZBkut3YP45rJ",
-    "privateKeyHex": "KwbaQqFUpt9MYQRrkVWk7QC799nAfcqYRYKj4ZNeZBkut3YP45rJ",
-    "publicKey": "02330726b97010d7bb1f88b1213330e644916cedfd5fee9c57153592c6b5a44fe9",
-    "address": "15XJXD7CSMqHL2ivFCu8PZTACQQ8MPbWY9",
-    "pubkeyHash160": "319b9b8eef10d00cf84b5d4772dca69b5f5a7b5c"
-  },
-  "utxo": {
-    "txid": "d6625d13f3130360dea7ebe8ccf8ccdb5e40b3cd5ea51b2094983a3789354c3e",
-    "vout": 0,
-    "outputIndex": 0,
-    "script": "76a914319b9b8eef10d00cf84b5d4772dca69b5f5a7b5c88ac",
-    "scriptPubKey": "76a914319b9b8eef10d00cf84b5d4772dca69b5f5a7b5c88ac",
-    "satoshis": 50000,
-    "address": "15XJXD7CSMqHL2ivFCu8PZTACQQ8MPbWY9"
-  },
-  "testParams": {
-    "nLockTimeTarget": 1000,
-    "sighashType": 65,
-    "covenantAmount": 40000,
-    "fee": 1000,
-    "changeAmount": 9000
-  },
-  "metadata": {
-    "created": "2025-10-19T14:33:10.987Z",
-    "description": "Test wallet and UTXO for BSV preimage covenant testing",
-    "version": "1.0"
-  }
-}