@smartledger/bsv 3.3.3 → 3.3.5

package/CHANGELOG.md

@@ -1,47 +1,65 @@
-# Changelog# Changelog
+# Changelog
 
+All notable changes to SmartLedger-BSV will be documented in this file.
 
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-All notable changes to SmartLedger-BSV will be documented in this file.All notable changes to SmartLedger-BSV will be documented in this file.
+## [3.3.4] - 2025-10-31
 
+### Fixed
+- **Critical Browser Compatibility Fix**: Resolved `createHmac is not a function` error affecting CDN users
+- **PBKDF2 Implementation**: Added browser-compatible PBKDF2 using BSV crypto instead of Node.js crypto
+- **Mnemonic Generation**: Fixed mnemonic generation and HD wallet derivation in browser environments
+- **Bundle Updates**: Rebuilt all bundles with browser-compatible crypto implementations
 
+### Added
+- Browser-specific PBKDF2 implementation (`lib/mnemonic/pbkdf2.browser.js`)
+- Node.js-specific PBKDF2 implementation (`lib/mnemonic/pbkdf2.node.js`)
+- Automatic browser/Node.js detection for crypto modules
+- Comprehensive browser compatibility test suite
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+### Technical Details
+- Uses BSV's `Hash.sha512hmac()` instead of Node.js `crypto.createHmac()`
+- Maintains full cryptographic security and API compatibility
+- Zero breaking changes for existing users
+- All 12 bundle variants updated with the fix
 
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [3.3.3] - 2025-10-28
 
+### 🎉 Major Improvements
 
+#### 📁 Project Organization & Structure
 
-## [3.3.3] - 2025-10-28## [3.3.0] - 2025-10-22
+- **Complete repository reorganization**: Moved legacy files to `/archive/` for better project structure
+- **New `/demos/` directory**: Interactive HTML demonstrations for all SmartLedger-BSV modules  
+- **Enhanced `/docs/` structure**: Comprehensive documentation with getting started guides, API references, and technical details  
+- **Dedicated `/tests/` directory**: All test files properly organized and categorized  
+- **New `/tools/` directory**: Development utilities and helper scripts  
 
+#### 🚀 Interactive Demos  
 
+- **Smart Contract Demo**: Full-featured HTML demo showcasing covenant creation, preimage parsing, script building, and UTXO generation
+- **Web3Keys Demo**: Interactive key generation and cryptographic operations demonstration
+- **Local development server**: Easy setup for testing demos locally
 
-### 🎉 Major Improvements### 🚀 MAJOR RELEASE: Legal Token Protocol (LTP) & Global Digital Attestation Framework (GDAF)
-
-
-
-#### 📁 Project Organization & Structure#### Revolutionary Legal Token Protocol Framework
-
-- **Complete repository reorganization**: Moved legacy files to `/archive/` for better project structure- **Complete Legal Token Protocol (LTP)**: 6-module comprehensive legal framework
-
-- **New `/demos/` directory**: Interactive HTML demonstrations for all SmartLedger-BSV modules  - **lib/ltp/anchor.js**: Blockchain anchoring preparation primitives
-
-- **Enhanced `/docs/` structure**: Comprehensive documentation with getting started guides, API references, and technical details  - **lib/ltp/registry.js**: Token registry management primitives  
+## [3.3.0] - 2025-10-22
 
-- **Dedicated `/tests/` directory**: All test files properly organized and categorized  - **lib/ltp/claim.js**: Legal claim validation and attestation primitives
+### 🚀 MAJOR RELEASE: Legal Token Protocol (LTP) & Global Digital Attestation Framework (GDAF)
 
-- **New `/tools/` directory**: Development utilities and helper scripts  - **lib/ltp/proof.js**: Cryptographic proof generation primitives
+#### Revolutionary Legal Token Protocol Framework
 
+- **Complete Legal Token Protocol (LTP)**: 6-module comprehensive legal framework
+  - **lib/ltp/anchor.js**: Blockchain anchoring preparation primitives
+  - **lib/ltp/registry.js**: Token registry management primitives  
+  - **lib/ltp/claim.js**: Legal claim validation and attestation primitives
+  - **lib/ltp/proof.js**: Cryptographic proof generation primitives
   - **lib/ltp/right.js**: Legal rights token creation and validation primitives
+  - **lib/ltp/obligation.js**: Legal obligation token management primitives
 
-#### 🚀 Interactive Demos  - **lib/ltp/obligation.js**: Legal obligation token management primitives
-
-- **Smart Contract Demo**: Full-featured HTML demo showcasing covenant creation, preimage parsing, script building, and UTXO generation
-
-- **Web3Keys Demo**: Interactive key generation and cryptographic operations demonstration#### Primitives-Only Architecture Philosophy
-
-- **Local development server**: Easy setup for testing demos locally- **No Blockchain Publishing**: Library provides preparation functions only
+#### Primitives-Only Architecture Philosophy
 
+- **No Blockchain Publishing**: Library provides preparation functions only
 - **External System Integration**: Perfect for enterprise and custom implementations
 
 #### 📚 Documentation Enhancements- **Maximum Flexibility**: Choose your own blockchain, storage, and UI frameworks
@@ -206,13 +224,17 @@ Previous version history is available in the git commit log. This changelog form
 
 
 
-To get started with SmartLedger-BSV v3.3.3:### 📦 Enhanced Build System
+To get started with SmartLedger-BSV v3.3.4:
 
+### 📦 Enhanced Build System
 
+```bash
+npm install @smartledger/bsv@3.3.4
+```
 
-```bash#### New Standalone Modules
+#### New Standalone Modules
 
-npm install @smartledger/bsv@3.3.3- **bsv-ltp.min.js**: Complete Legal Token Protocol standalone module
+- **bsv-ltp.min.js**: Complete Legal Token Protocol standalone module
 
 ```- **bsv-shamir.min.js**: Standalone Shamir Secret Sharing module
 

package/README.md

@@ -2,7 +2,7 @@
 
 **🚀 Complete Bitcoin SV Development Framework with Legal Compliance, Digital Identity, and 12 Flexible Loading Options**
 
-[![Version](https://img.shields.io/badge/version-3.3.3-blue.svg)](https://www.npmjs.com/package/@smartledger/bsv)
+[![Version](https://img.shields.io/badge/version-3.3.4-blue.svg)](https://www.npmjs.com/package/@smartledger/bsv)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![BSV](https://img.shields.io/badge/BSV-Compatible-orange.svg)](https://bitcoinsv.com/)
 [![Modular](https://img.shields.io/badge/Loading-Modular-purple.svg)](#loading-options)
@@ -14,34 +14,34 @@ The most comprehensive and flexible Bitcoin SV library available. Choose from 12
 ### **Core Modules**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js` |
-| **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.3.3/bsv.bundle.js` |
+| **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js` |
+| **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js` |
 
 ### **Smart Contract & Development**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-smartcontract.min.js** | 451KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@3.3.3/bsv-smartcontract.min.js` |
-| **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.3.3/bsv-covenant.min.js` |
-| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.3.3/bsv-script-helper.min.js` |
-| **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.3.3/bsv-security.min.js` |
+| **bsv-smartcontract.min.js** | 451KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js` |
+| **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js` |
+| **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js` |
 
 ### **🆕 Legal & Compliance**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **🟢 bsv-ltp.min.js** | 817KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@3.3.3/bsv-ltp.min.js` |
-| **🟢 bsv-gdaf.min.js** | 604KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@3.3.3/bsv-gdaf.min.js` |
+| **🟢 bsv-ltp.min.js** | 817KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js` |
+| **🟢 bsv-gdaf.min.js** | 604KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js` |
 
 ### **🆕 Advanced Cryptography**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **🟢 bsv-shamir.min.js** | 433KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@3.3.3/bsv-shamir.min.js` |
+| **🟢 bsv-shamir.min.js** | 433KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js` |
 
 ### **Utilities**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.3.3/bsv-ecies.min.js` |
-| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.3.3/bsv-message.min.js` |
-| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.3.3/bsv-mnemonic.min.js` |
+| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ecies.min.js` |
+| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.3.4/bsv-message.min.js` |
+| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.3.4/bsv-mnemonic.min.js` |
 
 ## ⚡ **2-Minute Quick Start**
 
@@ -52,9 +52,11 @@ Get started with Bitcoin SV development in under 2 minutes:
 npm install @smartledger/bsv
 
 # Or include in HTML
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
 ```
 
+> **🔧 v3.3.4 Update:** Fixed critical browser compatibility issue with mnemonic generation. CDN users can now use HD wallet and mnemonic functionality without `createHmac` errors!
+
 **Basic Transaction (30 seconds):**
 ```javascript
 const bsv = require('@smartledger/bsv'); // Node.js
@@ -145,8 +147,8 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
 
 ### 🔧 **Basic Development** (476KB total)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-script-helper.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js"></script>
 <script>
   const privateKey = new bsv.PrivateKey();
   const utxos = new bsv.SmartContract.UTXOGenerator().createRealUTXOs(2, 100000);
@@ -155,9 +157,9 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
 
 ### 🔒 **Smart Contract Development** (932KB total)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-covenant.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js"></script>
 <script>
   const covenant = bsv.SmartContract.createCovenantBuilder()
     .extractField('amount').push(50000).greaterThanOrEqual().verify().build();
@@ -167,9 +169,9 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
 
 ### 🆕 **Legal & Identity Development** (1.87MB total)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-ltp.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js"></script>
 <script>
   // Legal Token Protocol
   const propertyToken = bsv.createPropertyToken({
@@ -183,9 +185,9 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
 
 ### 🆕 **Security & Cryptography** (1.17MB total)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-security.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-shamir.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js"></script>
 <script>
   // Threshold Cryptography
   const shares = bsv.splitSecret('my_secret_key', 5, 3); // 5 shares, 3 needed
@@ -197,7 +199,7 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
 
 ### 🎯 **Everything Bundle** (885KB)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
 <script>
   // Everything available immediately
   const shares = bsv.splitSecret('secret', 5, 3);           // Shamir Secret Sharing
@@ -277,8 +279,8 @@ const contractTx = covenant.createCovenantTransaction({
 
 #### 1. **Minimal Setup** - Core + Script Helper (476KB)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-script-helper.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js"></script>
 <script>
   const tx = new bsv.Transaction();
   const sig = bsvScriptHelper.createSignature(tx, privateKey, 0, script, satoshis);
@@ -287,9 +289,9 @@ const contractTx = covenant.createCovenantTransaction({
 
 #### 2. **DeFi Development** - Core + Covenants + Debug (932KB)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-covenant.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js"></script>
 <script>
   const covenant = new bsvCovenant.CovenantInterface();
   const debugInfo = SmartContract.interpretScript(script);
@@ -299,8 +301,8 @@ const contractTx = covenant.createCovenantTransaction({
 
 #### 3. **Security First** - Core + Enhanced Security (739KB)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-security.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js"></script>
 <script>
   const verified = bsvSecurity.SmartVerify.verify(signature, hash, publicKey);
   const enhanced = bsvSecurity.EllipticFixed.createSignature(privateKey, hash);
@@ -309,7 +311,7 @@ const contractTx = covenant.createCovenantTransaction({
 
 #### 4. **Everything Bundle** - One File Solution (764KB)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
 <script>
   // Everything available under bsv namespace
   const keys = bsv.SmartLedgerBundle.generateKeys();
@@ -682,11 +684,28 @@ const timelockScript = helper.createTimelockScript(
 - [🔧 **Integration Guide**](SMARTCONTRACT_INTEGRATION.md) - Smart contract integration
 
 ### 📋 **Examples & Demos**
-- [📁 **Examples Directory**](examples/) - Working code examples
+- [� **Interactive Demos**](demos/) - **NEW!** HTML & Node.js smart contract demos
+- [�📁 **Examples Directory**](examples/) - Working code examples
 - [🎯 **Basic Examples**](examples/basic/) - Simple transactions & addresses
 - [🔒 **Covenant Examples**](examples/covenants/) - Smart contract patterns  
 - [📊 **Advanced Examples**](examples/covenants2/) - Production patterns
 
+**🎮 Try the Interactive Demos:**
+```bash
+# Terminal-based interactive demo
+npm run demo
+
+# Or run specific features
+npm run demo:basics     # Library basics & tests
+npm run demo:covenant   # Covenant builder
+npm run demo:preimage   # BIP-143 preimage parser
+npm run demo:utxo      # UTXO generator
+npm run demo:scripts   # Script tools
+
+# Web-based demo (open in browser)
+npm run demo:web
+```
+
 ### 🔍 **Troubleshooting & Support**
 - [📚 **Complete Documentation**](docs/README.md) - Organized documentation hub
 - [❓ **Issues & Solutions**](https://github.com/codenlighten/smartledger-bsv/issues) - Community support
@@ -713,6 +732,6 @@ We welcome contributions to SmartLedger-BSV! Please see our [Contributing Guide]
 
 ---
 
-**SmartLedger-BSV v3.3.3** - *Complete Bitcoin SV Development Framework*
+**SmartLedger-BSV v3.3.4** - *Complete Bitcoin SV Development Framework*
 
 Built with ❤️ for the Bitcoin SV ecosystem • 9 Loading Options • Enterprise Ready