smartledger-bsv 3.3.4 → 3.3.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/CHANGELOG.md +30 -21
  2. package/README.md +37 -35
  3. package/bsv-covenant.min.js +5 -5
  4. package/bsv-gdaf.min.js +6 -6
  5. package/bsv-ltp.min.js +6 -6
  6. package/bsv-smartcontract.min.js +5 -5
  7. package/bsv.bundle.js +5 -5
  8. package/bsv.min.js +5 -5
  9. package/demos/README.md +1 -1
  10. package/demos/browser-test.html +1208 -0
  11. package/demos/smart_contract_demo.html +1 -1
  12. package/demos/smart_contract_demo.js +1 -1
  13. package/demos/web3keys.html +3 -3
  14. package/docs/DOCUMENTATION_REVIEW_REPORT.md +11 -11
  15. package/docs/FIX_CREATEHMAC_ISSUE.md +1 -1
  16. package/docs/MODULE_REFERENCE_COMPLETE.md +28 -28
  17. package/docs/SMARTLEDGER_BSV_USAGE_ANSWERS.md +4 -4
  18. package/docs/SMARTLEDGER_BSV_USAGE_EXAMPLES.js +2 -2
  19. package/docs/SMARTLEDGER_BSV_USAGE_GUIDE.md +3 -3
  20. package/docs/SMART_CONTRACT_DEVELOPMENT_GUIDE.md +1 -1
  21. package/docs/advanced/UTXO_MANAGER_GUIDE.md +2 -2
  22. package/docs/getting-started/INSTALLATION.md +25 -25
  23. package/docs/getting-started/QUICK_START.md +7 -7
  24. package/docs/migration/FROM_BSV_1_5_6.md +5 -5
  25. package/index.js +7 -0
  26. package/lib/browser-utxo-manager-es5.js +316 -0
  27. package/lib/browser-utxo-manager.js +533 -0
  28. package/package.json +3 -3
  29. package/tests/browser-compatibility/test-cdn-vs-local.html +2 -2
package/CHANGELOG.md CHANGED
@@ -25,36 +25,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
25
25
  - Zero breaking changes for existing users
26
26
  - All 12 bundle variants updated with the fix
27
27
 
28
- ## [3.3.3] - 2025-10-28## [3.3.0] - 2025-10-22
28
+ ## [3.3.3] - 2025-10-28
29
29
 
30
+ ### 🎉 Major Improvements
30
31
 
32
+ #### 📁 Project Organization & Structure
31
33
 
32
- ### 🎉 Major Improvements### 🚀 MAJOR RELEASE: Legal Token Protocol (LTP) & Global Digital Attestation Framework (GDAF)
34
+ - **Complete repository reorganization**: Moved legacy files to `/archive/` for better project structure
35
+ - **New `/demos/` directory**: Interactive HTML demonstrations for all SmartLedger-BSV modules
36
+ - **Enhanced `/docs/` structure**: Comprehensive documentation with getting started guides, API references, and technical details
37
+ - **Dedicated `/tests/` directory**: All test files properly organized and categorized
38
+ - **New `/tools/` directory**: Development utilities and helper scripts
33
39
 
40
+ #### 🚀 Interactive Demos
34
41
 
42
+ - **Smart Contract Demo**: Full-featured HTML demo showcasing covenant creation, preimage parsing, script building, and UTXO generation
43
+ - **Web3Keys Demo**: Interactive key generation and cryptographic operations demonstration
44
+ - **Local development server**: Easy setup for testing demos locally
35
45
 
36
- #### 📁 Project Organization & Structure#### Revolutionary Legal Token Protocol Framework
37
-
38
- - **Complete repository reorganization**: Moved legacy files to `/archive/` for better project structure- **Complete Legal Token Protocol (LTP)**: 6-module comprehensive legal framework
39
-
40
- - **New `/demos/` directory**: Interactive HTML demonstrations for all SmartLedger-BSV modules - **lib/ltp/anchor.js**: Blockchain anchoring preparation primitives
41
-
42
- - **Enhanced `/docs/` structure**: Comprehensive documentation with getting started guides, API references, and technical details - **lib/ltp/registry.js**: Token registry management primitives
46
+ ## [3.3.0] - 2025-10-22
43
47
 
44
- - **Dedicated `/tests/` directory**: All test files properly organized and categorized - **lib/ltp/claim.js**: Legal claim validation and attestation primitives
48
+ ### 🚀 MAJOR RELEASE: Legal Token Protocol (LTP) & Global Digital Attestation Framework (GDAF)
45
49
 
46
- - **New `/tools/` directory**: Development utilities and helper scripts - **lib/ltp/proof.js**: Cryptographic proof generation primitives
50
+ #### Revolutionary Legal Token Protocol Framework
47
51
 
52
+ - **Complete Legal Token Protocol (LTP)**: 6-module comprehensive legal framework
53
+ - **lib/ltp/anchor.js**: Blockchain anchoring preparation primitives
54
+ - **lib/ltp/registry.js**: Token registry management primitives
55
+ - **lib/ltp/claim.js**: Legal claim validation and attestation primitives
56
+ - **lib/ltp/proof.js**: Cryptographic proof generation primitives
48
57
  - **lib/ltp/right.js**: Legal rights token creation and validation primitives
58
+ - **lib/ltp/obligation.js**: Legal obligation token management primitives
49
59
 
50
- #### 🚀 Interactive Demos - **lib/ltp/obligation.js**: Legal obligation token management primitives
51
-
52
- - **Smart Contract Demo**: Full-featured HTML demo showcasing covenant creation, preimage parsing, script building, and UTXO generation
53
-
54
- - **Web3Keys Demo**: Interactive key generation and cryptographic operations demonstration#### Primitives-Only Architecture Philosophy
55
-
56
- - **Local development server**: Easy setup for testing demos locally- **No Blockchain Publishing**: Library provides preparation functions only
60
+ #### Primitives-Only Architecture Philosophy
57
61
 
62
+ - **No Blockchain Publishing**: Library provides preparation functions only
58
63
  - **External System Integration**: Perfect for enterprise and custom implementations
59
64
 
60
65
  #### 📚 Documentation Enhancements- **Maximum Flexibility**: Choose your own blockchain, storage, and UI frameworks
@@ -219,13 +224,17 @@ Previous version history is available in the git commit log. This changelog form
219
224
 
220
225
 
221
226
 
222
- To get started with SmartLedger-BSV v3.3.3:### 📦 Enhanced Build System
227
+ To get started with SmartLedger-BSV v3.3.4:
223
228
 
229
+ ### 📦 Enhanced Build System
224
230
 
231
+ ```bash
232
+ npm install @smartledger/bsv@3.3.4
233
+ ```
225
234
 
226
- ```bash#### New Standalone Modules
235
+ #### New Standalone Modules
227
236
 
228
- npm install @smartledger/bsv@3.3.3- **bsv-ltp.min.js**: Complete Legal Token Protocol standalone module
237
+ - **bsv-ltp.min.js**: Complete Legal Token Protocol standalone module
229
238
 
230
239
  ```- **bsv-shamir.min.js**: Standalone Shamir Secret Sharing module
231
240
 
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **🚀 Complete Bitcoin SV Development Framework with Legal Compliance, Digital Identity, and 12 Flexible Loading Options**
4
4
 
5
- [![Version](https://img.shields.io/badge/version-3.3.3-blue.svg)](https://www.npmjs.com/package/@smartledger/bsv)
5
+ [![Version](https://img.shields.io/badge/version-3.3.4-blue.svg)](https://www.npmjs.com/package/@smartledger/bsv)
6
6
  [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
7
7
  [![BSV](https://img.shields.io/badge/BSV-Compatible-orange.svg)](https://bitcoinsv.com/)
8
8
  [![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
14
14
  ### **Core Modules**
15
15
  | Module | Size | Use Case | CDN |
16
16
  |--------|------|----------|-----|
17
- | **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js` |
18
- | **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.3.3/bsv.bundle.js` |
17
+ | **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js` |
18
+ | **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js` |
19
19
 
20
20
  ### **Smart Contract & Development**
21
21
  | Module | Size | Use Case | CDN |
22
22
  |--------|------|----------|-----|
23
- | **bsv-smartcontract.min.js** | 451KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@3.3.3/bsv-smartcontract.min.js` |
24
- | **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.3.3/bsv-covenant.min.js` |
25
- | **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.3.3/bsv-script-helper.min.js` |
26
- | **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.3.3/bsv-security.min.js` |
23
+ | **bsv-smartcontract.min.js** | 451KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js` |
24
+ | **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js` |
25
+ | **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js` |
26
+ | **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js` |
27
27
 
28
28
  ### **🆕 Legal & Compliance**
29
29
  | Module | Size | Use Case | CDN |
30
30
  |--------|------|----------|-----|
31
- | **🟢 bsv-ltp.min.js** | 817KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@3.3.3/bsv-ltp.min.js` |
32
- | **🟢 bsv-gdaf.min.js** | 604KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@3.3.3/bsv-gdaf.min.js` |
31
+ | **🟢 bsv-ltp.min.js** | 817KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js` |
32
+ | **🟢 bsv-gdaf.min.js** | 604KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js` |
33
33
 
34
34
  ### **🆕 Advanced Cryptography**
35
35
  | Module | Size | Use Case | CDN |
36
36
  |--------|------|----------|-----|
37
- | **🟢 bsv-shamir.min.js** | 433KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@3.3.3/bsv-shamir.min.js` |
37
+ | **🟢 bsv-shamir.min.js** | 433KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js` |
38
38
 
39
39
  ### **Utilities**
40
40
  | Module | Size | Use Case | CDN |
41
41
  |--------|------|----------|-----|
42
- | **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.3.3/bsv-ecies.min.js` |
43
- | **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.3.3/bsv-message.min.js` |
44
- | **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.3.3/bsv-mnemonic.min.js` |
42
+ | **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ecies.min.js` |
43
+ | **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.3.4/bsv-message.min.js` |
44
+ | **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.3.4/bsv-mnemonic.min.js` |
45
45
 
46
46
  ## ⚡ **2-Minute Quick Start**
47
47
 
@@ -52,9 +52,11 @@ Get started with Bitcoin SV development in under 2 minutes:
52
52
  npm install @smartledger/bsv
53
53
 
54
54
  # Or include in HTML
55
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
55
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
56
56
  ```
57
57
 
58
+ > **🔧 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!
59
+
58
60
  **Basic Transaction (30 seconds):**
59
61
  ```javascript
60
62
  const bsv = require('@smartledger/bsv'); // Node.js
@@ -145,8 +147,8 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
145
147
 
146
148
  ### 🔧 **Basic Development** (476KB total)
147
149
  ```html
148
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
149
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-script-helper.min.js"></script>
150
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
151
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js"></script>
150
152
  <script>
151
153
  const privateKey = new bsv.PrivateKey();
152
154
  const utxos = new bsv.SmartContract.UTXOGenerator().createRealUTXOs(2, 100000);
@@ -155,9 +157,9 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
155
157
 
156
158
  ### 🔒 **Smart Contract Development** (932KB total)
157
159
  ```html
158
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
159
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-covenant.min.js"></script>
160
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-smartcontract.min.js"></script>
160
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
161
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js"></script>
162
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js"></script>
161
163
  <script>
162
164
  const covenant = bsv.SmartContract.createCovenantBuilder()
163
165
  .extractField('amount').push(50000).greaterThanOrEqual().verify().build();
@@ -167,9 +169,9 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
167
169
 
168
170
  ### 🆕 **Legal & Identity Development** (1.87MB total)
169
171
  ```html
170
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
171
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-ltp.min.js"></script>
172
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-gdaf.min.js"></script>
172
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
173
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js"></script>
174
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js"></script>
173
175
  <script>
174
176
  // Legal Token Protocol
175
177
  const propertyToken = bsv.createPropertyToken({
@@ -183,9 +185,9 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
183
185
 
184
186
  ### 🆕 **Security & Cryptography** (1.17MB total)
185
187
  ```html
186
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
187
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-security.min.js"></script>
188
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-shamir.min.js"></script>
188
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
189
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js"></script>
190
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js"></script>
189
191
  <script>
190
192
  // Threshold Cryptography
191
193
  const shares = bsv.splitSecret('my_secret_key', 5, 3); // 5 shares, 3 needed
@@ -197,7 +199,7 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
197
199
 
198
200
  ### 🎯 **Everything Bundle** (885KB)
199
201
  ```html
200
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.bundle.js"></script>
202
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
201
203
  <script>
202
204
  // Everything available immediately
203
205
  const shares = bsv.splitSecret('secret', 5, 3); // Shamir Secret Sharing
@@ -277,8 +279,8 @@ const contractTx = covenant.createCovenantTransaction({
277
279
 
278
280
  #### 1. **Minimal Setup** - Core + Script Helper (476KB)
279
281
  ```html
280
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
281
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-script-helper.min.js"></script>
282
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
283
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js"></script>
282
284
  <script>
283
285
  const tx = new bsv.Transaction();
284
286
  const sig = bsvScriptHelper.createSignature(tx, privateKey, 0, script, satoshis);
@@ -287,9 +289,9 @@ const contractTx = covenant.createCovenantTransaction({
287
289
 
288
290
  #### 2. **DeFi Development** - Core + Covenants + Debug (932KB)
289
291
  ```html
290
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
291
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-covenant.min.js"></script>
292
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-smartcontract.min.js"></script>
292
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
293
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js"></script>
294
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js"></script>
293
295
  <script>
294
296
  const covenant = new bsvCovenant.CovenantInterface();
295
297
  const debugInfo = SmartContract.interpretScript(script);
@@ -299,8 +301,8 @@ const contractTx = covenant.createCovenantTransaction({
299
301
 
300
302
  #### 3. **Security First** - Core + Enhanced Security (739KB)
301
303
  ```html
302
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
303
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-security.min.js"></script>
304
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
305
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js"></script>
304
306
  <script>
305
307
  const verified = bsvSecurity.SmartVerify.verify(signature, hash, publicKey);
306
308
  const enhanced = bsvSecurity.EllipticFixed.createSignature(privateKey, hash);
@@ -309,7 +311,7 @@ const contractTx = covenant.createCovenantTransaction({
309
311
 
310
312
  #### 4. **Everything Bundle** - One File Solution (764KB)
311
313
  ```html
312
- <script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.bundle.js"></script>
314
+ <script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
313
315
  <script>
314
316
  // Everything available under bsv namespace
315
317
  const keys = bsv.SmartLedgerBundle.generateKeys();
@@ -730,6 +732,6 @@ We welcome contributions to SmartLedger-BSV! Please see our [Contributing Guide]
730
732
 
731
733
  ---
732
734
 
733
- **SmartLedger-BSV v3.3.3** - *Complete Bitcoin SV Development Framework*
735
+ **SmartLedger-BSV v3.3.4** - *Complete Bitcoin SV Development Framework*
734
736
 
735
737
  Built with ❤️ for the Bitcoin SV ecosystem • 9 Loading Options • Enterprise Ready