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.
- package/CHANGELOG.md +30 -21
- package/README.md +37 -35
- package/bsv-covenant.min.js +5 -5
- package/bsv-gdaf.min.js +6 -6
- package/bsv-ltp.min.js +6 -6
- package/bsv-smartcontract.min.js +5 -5
- package/bsv.bundle.js +5 -5
- package/bsv.min.js +5 -5
- package/demos/README.md +1 -1
- package/demos/browser-test.html +1208 -0
- package/demos/smart_contract_demo.html +1 -1
- package/demos/smart_contract_demo.js +1 -1
- package/demos/web3keys.html +3 -3
- package/docs/DOCUMENTATION_REVIEW_REPORT.md +11 -11
- package/docs/FIX_CREATEHMAC_ISSUE.md +1 -1
- package/docs/MODULE_REFERENCE_COMPLETE.md +28 -28
- package/docs/SMARTLEDGER_BSV_USAGE_ANSWERS.md +4 -4
- package/docs/SMARTLEDGER_BSV_USAGE_EXAMPLES.js +2 -2
- package/docs/SMARTLEDGER_BSV_USAGE_GUIDE.md +3 -3
- package/docs/SMART_CONTRACT_DEVELOPMENT_GUIDE.md +1 -1
- package/docs/advanced/UTXO_MANAGER_GUIDE.md +2 -2
- package/docs/getting-started/INSTALLATION.md +25 -25
- package/docs/getting-started/QUICK_START.md +7 -7
- package/docs/migration/FROM_BSV_1_5_6.md +5 -5
- package/index.js +7 -0
- package/lib/browser-utxo-manager-es5.js +316 -0
- package/lib/browser-utxo-manager.js +533 -0
- package/package.json +3 -3
- package/tests/browser-compatibility/test-cdn-vs-local.html +2 -2
|
@@ -549,7 +549,7 @@ if (bsv.SmartContract) {
|
|
|
549
549
|
}
|
|
550
550
|
|
|
551
551
|
log('basics-output', '✅ BSV library loaded successfully!', 'success');
|
|
552
|
-
log('basics-output', `📊 BSV version: ${bsv.version || 'Bundle v3.3.
|
|
552
|
+
log('basics-output', `📊 BSV version: ${bsv.version || 'Bundle v3.3.4'}`, 'info');
|
|
553
553
|
|
|
554
554
|
// Check available SmartLedger modules
|
|
555
555
|
const availableModules = [];
|
|
@@ -115,7 +115,7 @@ function loadLibrary() {
|
|
|
115
115
|
}
|
|
116
116
|
|
|
117
117
|
log('BSV library loaded successfully!', 'success');
|
|
118
|
-
log(`BSV version: ${bsv.version || 'v3.3.
|
|
118
|
+
log(`BSV version: ${bsv.version || 'v3.3.4'}`, 'info');
|
|
119
119
|
|
|
120
120
|
// Check available SmartLedger modules
|
|
121
121
|
const availableModules = [];
|
package/demos/web3keys.html
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
<title>Web3Keys Playground – All-in-One SPA (No Server)</title>
|
|
6
6
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
7
7
|
<script src="https://cdn.tailwindcss.com"></script>
|
|
8
|
-
<!-- SmartLedger BSV Security-Hardened Library - Local Fixed v3.3.
|
|
8
|
+
<!-- SmartLedger BSV Security-Hardened Library - Local Fixed v3.3.4 -->
|
|
9
9
|
<script src="../bsv.min.js"></script>
|
|
10
10
|
<script src="../bsv-mnemonic.min.js"></script>
|
|
11
11
|
<script>
|
|
@@ -251,7 +251,7 @@
|
|
|
251
251
|
</section>
|
|
252
252
|
|
|
253
253
|
<footer class="px-6 py-5 bg-gradient-to-r from-primaryDark to-primary text-white flex flex-col md:flex-row md:items-center md:justify-between gap-2">
|
|
254
|
-
<div class="text-sm opacity-90">Powered by <a href="https://smartledger.technology" class="underline hover:text-primaryLight">SmartLedger Technology</a> BSV v3.3.
|
|
254
|
+
<div class="text-sm opacity-90">Powered by <a href="https://smartledger.technology" class="underline hover:text-primaryLight">SmartLedger Technology</a> BSV v3.3.4 • Security-Hardened</div>
|
|
255
255
|
<div class="text-sm">Client-side only • No network calls • Zero vulnerabilities</div>
|
|
256
256
|
</footer>
|
|
257
257
|
</div>
|
|
@@ -463,7 +463,7 @@
|
|
|
463
463
|
globalMnemonic: !!window.Mnemonic,
|
|
464
464
|
bsvInternal: !!(window.bsv && bsv.Mnemonic)
|
|
465
465
|
},
|
|
466
|
-
version: window.bsv ? `SmartLedger BSV v${bsv.version || '3.3.
|
|
466
|
+
version: window.bsv ? `SmartLedger BSV v${bsv.version || '3.3.4'}` : 'SmartLedger BSV v3.3.4'
|
|
467
467
|
}, null, 2);
|
|
468
468
|
}
|
|
469
469
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
## 🔍 **Comprehensive Analysis of SmartLedger-BSV Documentation**
|
|
4
4
|
|
|
5
5
|
*Review Date: October 28, 2025*
|
|
6
|
-
*SmartLedger-BSV Version: v3.3.
|
|
6
|
+
*SmartLedger-BSV Version: v3.3.4*
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -30,13 +30,13 @@
|
|
|
30
30
|
|
|
31
31
|
| Document | Version Referenced | Actual Version | Status |
|
|
32
32
|
|----------|-------------------|----------------|---------|
|
|
33
|
-
| `README.md` | v3.2.1 | v3.3.
|
|
34
|
-
| `SMARTCONTRACT_INTEGRATION.md` | v3.2.1 | v3.3.
|
|
35
|
-
| `examples/README.md` | v3.1.1+ | v3.3.
|
|
36
|
-
| `ADVANCED_COVENANT_DEVELOPMENT.md` | v3.1.1+ | v3.3.
|
|
37
|
-
| `lib/smart_contract/EXAMPLES.md` | v3.2.0 | v3.3.
|
|
33
|
+
| `README.md` | v3.2.1 | v3.3.4 | ❌ Outdated |
|
|
34
|
+
| `SMARTCONTRACT_INTEGRATION.md` | v3.2.1 | v3.3.4 | ❌ Outdated |
|
|
35
|
+
| `examples/README.md` | v3.1.1+ | v3.3.4 | ❌ Outdated |
|
|
36
|
+
| `ADVANCED_COVENANT_DEVELOPMENT.md` | v3.1.1+ | v3.3.4 | ❌ Outdated |
|
|
37
|
+
| `lib/smart_contract/EXAMPLES.md` | v3.2.0 | v3.3.4 | ❌ Outdated |
|
|
38
38
|
|
|
39
|
-
**Recommendation**: Update all version references to v3.3.
|
|
39
|
+
**Recommendation**: Update all version references to v3.3.4
|
|
40
40
|
|
|
41
41
|
### 2. **Outdated API Usage Examples**
|
|
42
42
|
|
|
@@ -169,7 +169,7 @@ const pushtxCovenant = covenant.createAdvancedCovenant('pushtx', {...});
|
|
|
169
169
|
|
|
170
170
|
### **Phase 1: Critical Fixes (Immediate)**
|
|
171
171
|
|
|
172
|
-
1. **Update All Version References** → v3.3.
|
|
172
|
+
1. **Update All Version References** → v3.3.4
|
|
173
173
|
- `README.md`: Update CDN links and version badges
|
|
174
174
|
- `SMARTCONTRACT_INTEGRATION.md`: Update version references
|
|
175
175
|
- `examples/README.md`: Update version claims
|
|
@@ -221,7 +221,7 @@ const pushtxCovenant = covenant.createAdvancedCovenant('pushtx', {...});
|
|
|
221
221
|
### **High Priority Updates Needed:**
|
|
222
222
|
|
|
223
223
|
1. **`README.md`** - Major updates required
|
|
224
|
-
- Version references (v3.2.1 → v3.3.
|
|
224
|
+
- Version references (v3.2.1 → v3.3.4)
|
|
225
225
|
- API examples (createTestEnvironment → UTXOGenerator)
|
|
226
226
|
- File sizes and CDN links
|
|
227
227
|
- Add links to new SmartContract documentation
|
|
@@ -249,7 +249,7 @@ const pushtxCovenant = covenant.createAdvancedCovenant('pushtx', {...});
|
|
|
249
249
|
- Verify all examples work
|
|
250
250
|
|
|
251
251
|
### **Cross-Cutting Updates:**
|
|
252
|
-
- Global version update (v3.3.
|
|
252
|
+
- Global version update (v3.3.4)
|
|
253
253
|
- Consistent package naming
|
|
254
254
|
- Standardized error handling
|
|
255
255
|
- Updated cross-references
|
|
@@ -290,6 +290,6 @@ const pushtxCovenant = covenant.createAdvancedCovenant('pushtx', {...});
|
|
|
290
290
|
|
|
291
291
|
---
|
|
292
292
|
|
|
293
|
-
This review identifies **42 specific issues** across **15 documentation files**, with a clear prioritized plan for resolution. The documentation foundation is solid, but needs systematic updates to match the current v3.3.
|
|
293
|
+
This review identifies **42 specific issues** across **15 documentation files**, with a clear prioritized plan for resolution. The documentation foundation is solid, but needs systematic updates to match the current v3.3.4 implementation.
|
|
294
294
|
|
|
295
295
|
*Next Step: Begin Phase 1 critical fixes immediately to restore documentation accuracy.*
|
|
@@ -50,7 +50,7 @@ Created test files to verify the fix:
|
|
|
50
50
|
|
|
51
51
|
## What CDN Users Will Experience
|
|
52
52
|
|
|
53
|
-
### Before Fix (Current CDN v3.3.
|
|
53
|
+
### Before Fix (Current CDN v3.3.4):
|
|
54
54
|
- ❌ `createHmac is not a function` errors
|
|
55
55
|
- ❌ Cannot generate mnemonics
|
|
56
56
|
- ❌ Cannot derive HD wallet keys
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
## 🔍 **Actual vs Documented Module Analysis**
|
|
4
4
|
|
|
5
5
|
*Analysis Date: October 28, 2025*
|
|
6
|
-
*SmartLedger-BSV Version: v3.3.
|
|
6
|
+
*SmartLedger-BSV Version: v3.3.4*
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -55,19 +55,19 @@ Three major modules totaling **1.82MB** of functionality are completely missing
|
|
|
55
55
|
- **Purpose**: Threshold cryptography for secure secret distribution
|
|
56
56
|
- **Use Cases**: Backup keys, multi-party security, key recovery
|
|
57
57
|
- **Features**: Split secrets into N shares, require M to reconstruct
|
|
58
|
-
- **CDN**: `unpkg.com/@smartledger/bsv@3.3.
|
|
58
|
+
- **CDN**: `unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js`
|
|
59
59
|
|
|
60
60
|
#### **🌐 Global Digital Attestation Framework - GDAF (604KB)**
|
|
61
61
|
- **Purpose**: W3C Verifiable Credentials and decentralized identity
|
|
62
62
|
- **Use Cases**: Identity verification, attestations, zero-knowledge proofs
|
|
63
63
|
- **Features**: DID creation, credential issuance, selective disclosure
|
|
64
|
-
- **CDN**: `unpkg.com/@smartledger/bsv@3.3.
|
|
64
|
+
- **CDN**: `unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js`
|
|
65
65
|
|
|
66
66
|
#### **⚖️ Legal Token Protocol - LTP (817KB)**
|
|
67
67
|
- **Purpose**: Legal compliance framework for tokenized assets
|
|
68
68
|
- **Use Cases**: Property rights, obligations, compliant tokenization
|
|
69
69
|
- **Features**: Legal primitives, compliance checking, attestation anchoring
|
|
70
|
-
- **CDN**: `unpkg.com/@smartledger/bsv@3.3.
|
|
70
|
+
- **CDN**: `unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js`
|
|
71
71
|
|
|
72
72
|
### **2. Incorrect File Sizes in Documentation**
|
|
73
73
|
|
|
@@ -82,18 +82,18 @@ Three major modules totaling **1.82MB** of functionality are completely missing
|
|
|
82
82
|
|
|
83
83
|
| Module | Size | Use Case | CDN Link |
|
|
84
84
|
|--------|------|----------|----------|
|
|
85
|
-
| **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.3.
|
|
86
|
-
| **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.3.
|
|
87
|
-
| **bsv-smartcontract.min.js** | 451KB | Covenant development | `unpkg.com/@smartledger/bsv@3.3.
|
|
88
|
-
| **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.3.
|
|
89
|
-
| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.3.
|
|
90
|
-
| **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.3.
|
|
91
|
-
| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.3.
|
|
92
|
-
| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.3.
|
|
93
|
-
| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.3.
|
|
94
|
-
| **🆕 bsv-shamir.min.js** | 433KB | **Secret sharing** | `unpkg.com/@smartledger/bsv@3.3.
|
|
95
|
-
| **🆕 bsv-gdaf.min.js** | 604KB | **Digital attestation** | `unpkg.com/@smartledger/bsv@3.3.
|
|
96
|
-
| **🆕 bsv-ltp.min.js** | 817KB | **Legal tokens** | `unpkg.com/@smartledger/bsv@3.3.
|
|
85
|
+
| **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js` |
|
|
86
|
+
| **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js` |
|
|
87
|
+
| **bsv-smartcontract.min.js** | 451KB | Covenant development | `unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js` |
|
|
88
|
+
| **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js` |
|
|
89
|
+
| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js` |
|
|
90
|
+
| **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js` |
|
|
91
|
+
| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ecies.min.js` |
|
|
92
|
+
| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.3.4/bsv-message.min.js` |
|
|
93
|
+
| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.3.4/bsv-mnemonic.min.js` |
|
|
94
|
+
| **🆕 bsv-shamir.min.js** | 433KB | **Secret sharing** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js` |
|
|
95
|
+
| **🆕 bsv-gdaf.min.js** | 604KB | **Digital attestation** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js` |
|
|
96
|
+
| **🆕 bsv-ltp.min.js** | 817KB | **Legal tokens** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js` |
|
|
97
97
|
|
|
98
98
|
## 🎯 **Updated Usage Examples**
|
|
99
99
|
|
|
@@ -101,22 +101,22 @@ Three major modules totaling **1.82MB** of functionality are completely missing
|
|
|
101
101
|
|
|
102
102
|
#### **1. Basic Development (476KB)**
|
|
103
103
|
```html
|
|
104
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
105
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
104
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
105
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js"></script>
|
|
106
106
|
```
|
|
107
107
|
|
|
108
108
|
#### **2. Smart Contract Development (932KB)**
|
|
109
109
|
```html
|
|
110
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
111
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
112
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
110
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
111
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js"></script>
|
|
112
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js"></script>
|
|
113
113
|
```
|
|
114
114
|
|
|
115
115
|
#### **3. 🆕 Legal & Compliance Development (1.7MB)**
|
|
116
116
|
```html
|
|
117
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
118
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
119
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
117
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
118
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js"></script>
|
|
119
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js"></script>
|
|
120
120
|
<script>
|
|
121
121
|
// Legal Token Protocol
|
|
122
122
|
const legalToken = bsv.createLegalToken({
|
|
@@ -133,9 +133,9 @@ Three major modules totaling **1.82MB** of functionality are completely missing
|
|
|
133
133
|
|
|
134
134
|
#### **4. 🆕 Security & Cryptography (1.35MB)**
|
|
135
135
|
```html
|
|
136
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
137
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
138
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
136
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
137
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js"></script>
|
|
138
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js"></script>
|
|
139
139
|
<script>
|
|
140
140
|
// Shamir Secret Sharing
|
|
141
141
|
const shares = bsv.splitSecret('my_secret_key', 5, 3); // 5 shares, 3 needed
|
|
@@ -147,7 +147,7 @@ Three major modules totaling **1.82MB** of functionality are completely missing
|
|
|
147
147
|
|
|
148
148
|
#### **5. Everything Bundle (885KB)**
|
|
149
149
|
```html
|
|
150
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
150
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
|
|
151
151
|
<script>
|
|
152
152
|
// Everything available immediately
|
|
153
153
|
const shares = bsv.splitSecret('secret', 5, 3);
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# 🎯 **SmartLedger-BSV v3.3.
|
|
1
|
+
# 🎯 **SmartLedger-BSV v3.3.4 Usage Questions - ANSWERS**
|
|
2
2
|
|
|
3
3
|
**Date:** October 30, 2025
|
|
4
4
|
**Status:** ✅ **COMPREHENSIVE ANSWERS PROVIDED**
|
|
5
|
-
**Library:** smartledger-bsv v3.3.
|
|
5
|
+
**Library:** smartledger-bsv v3.3.4
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -326,7 +326,7 @@ const sighash = bsv.SmartContract.testFieldExtraction(preimageHex, 'sighashType'
|
|
|
326
326
|
|
|
327
327
|
**Current status and future outlook:**
|
|
328
328
|
|
|
329
|
-
- **✅ Stable API:** Field names and core functions are stable in v3.3.
|
|
329
|
+
- **✅ Stable API:** Field names and core functions are stable in v3.3.4
|
|
330
330
|
- **✅ Backward compatibility:** Dual naming conventions will be maintained
|
|
331
331
|
- **✅ No breaking changes planned:** Current usage patterns will continue working
|
|
332
332
|
- **✅ Enhanced error handling:** Future versions will have better error messages
|
|
@@ -468,7 +468,7 @@ Your comprehensive testing revealed the exact usage patterns. The library is **f
|
|
|
468
468
|
- **Robust error handling** with fallbacks
|
|
469
469
|
- **Appropriate method** for your use case
|
|
470
470
|
|
|
471
|
-
All your questions have definitive answers. **SmartLedger-BSV v3.3.
|
|
471
|
+
All your questions have definitive answers. **SmartLedger-BSV v3.3.4 is production-ready** with the patterns documented above.
|
|
472
472
|
|
|
473
473
|
---
|
|
474
474
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
* ==============================
|
|
4
4
|
*
|
|
5
5
|
* Practical examples demonstrating solutions to common usage questions
|
|
6
|
-
* Based on smartledger-bsv v3.3.
|
|
6
|
+
* Based on smartledger-bsv v3.3.4 analysis
|
|
7
7
|
*/
|
|
8
8
|
|
|
9
9
|
const bsv = require('../index');
|
|
@@ -330,7 +330,7 @@ OP_TRUE
|
|
|
330
330
|
* Main demonstration function
|
|
331
331
|
*/
|
|
332
332
|
function runAllExamples() {
|
|
333
|
-
console.log('🚀 SmartLedger-BSV v3.3.
|
|
333
|
+
console.log('🚀 SmartLedger-BSV v3.3.4 Usage Examples');
|
|
334
334
|
console.log('=' .repeat(50));
|
|
335
335
|
|
|
336
336
|
try {
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# 📖 SmartLedger-BSV v3.3.
|
|
1
|
+
# 📖 SmartLedger-BSV v3.3.4 Usage Guide
|
|
2
2
|
|
|
3
3
|
**Comprehensive answers to BIP-143 preimage extraction questions**
|
|
4
4
|
**Date:** October 30, 2025
|
|
5
|
-
**Library:** smartledger-bsv v3.3.
|
|
5
|
+
**Library:** smartledger-bsv v3.3.4
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -551,5 +551,5 @@ const demo = completeFieldExtractionDemo();
|
|
|
551
551
|
---
|
|
552
552
|
|
|
553
553
|
**Created by:** SmartLedger-BSV Development Team
|
|
554
|
-
**Version:** v3.3.
|
|
554
|
+
**Version:** v3.3.4
|
|
555
555
|
**Last Updated:** October 30, 2025
|
|
@@ -722,7 +722,7 @@ interface UTXO {
|
|
|
722
722
|
<html>
|
|
723
723
|
<head>
|
|
724
724
|
<title>UTXO Manager Demo</title>
|
|
725
|
-
<script src="https://cdn.jsdelivr.net/npm/@smartledger/bsv@3.3.
|
|
725
|
+
<script src="https://cdn.jsdelivr.net/npm/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
726
726
|
</head>
|
|
727
727
|
<body>
|
|
728
728
|
<script>
|
|
@@ -835,7 +835,7 @@ The SmartLedger BSV UTXO Manager provides a comprehensive solution for Bitcoin S
|
|
|
835
835
|
- **🌐 Network Flexible** - Support for mainnet, testnet, and regtest
|
|
836
836
|
|
|
837
837
|
### Tested Examples:
|
|
838
|
-
All examples in this guide have been tested and verified to work with SmartLedger BSV v3.3.
|
|
838
|
+
All examples in this guide have been tested and verified to work with SmartLedger BSV v3.3.4. The documentation reflects the actual API and behavior of the library modules.
|
|
839
839
|
|
|
840
840
|
For more examples and advanced usage, see the `/examples` directory in the repository.
|
|
841
841
|
|
|
@@ -12,10 +12,10 @@ SmartLedger-BSV offers multiple installation methods to suit different developme
|
|
|
12
12
|
npm install @smartledger/bsv
|
|
13
13
|
|
|
14
14
|
# Install specific version
|
|
15
|
-
npm install @smartledger/bsv@3.3.
|
|
15
|
+
npm install @smartledger/bsv@3.3.4
|
|
16
16
|
|
|
17
17
|
# Install with exact version lock
|
|
18
|
-
npm install --save-exact @smartledger/bsv@3.3.
|
|
18
|
+
npm install --save-exact @smartledger/bsv@3.3.4
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
### **Usage in Node.js**
|
|
@@ -48,7 +48,7 @@ const tx: Transaction = new Transaction();
|
|
|
48
48
|
#### **Core Library Only (449KB)**
|
|
49
49
|
For basic Bitcoin SV operations:
|
|
50
50
|
```html
|
|
51
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
51
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
52
52
|
<script>
|
|
53
53
|
const privateKey = new bsv.PrivateKey();
|
|
54
54
|
const address = privateKey.toAddress();
|
|
@@ -58,7 +58,7 @@ For basic Bitcoin SV operations:
|
|
|
58
58
|
#### **Complete Bundle (885KB)**
|
|
59
59
|
Everything in one file:
|
|
60
60
|
```html
|
|
61
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
61
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
|
|
62
62
|
<script>
|
|
63
63
|
// All features available immediately
|
|
64
64
|
const shares = bsv.splitSecret('secret', 5, 3);
|
|
@@ -71,9 +71,9 @@ Everything in one file:
|
|
|
71
71
|
|
|
72
72
|
#### **Smart Contract Development (932KB total)**
|
|
73
73
|
```html
|
|
74
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
75
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
76
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
74
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
75
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js"></script>
|
|
76
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js"></script>
|
|
77
77
|
<script>
|
|
78
78
|
const covenant = bsv.SmartContract.createCovenantBuilder()
|
|
79
79
|
.extractField('amount').push(50000).greaterThanOrEqual().build();
|
|
@@ -82,9 +82,9 @@ Everything in one file:
|
|
|
82
82
|
|
|
83
83
|
#### **Legal & Identity Development (1.87MB total)**
|
|
84
84
|
```html
|
|
85
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
86
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
87
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
85
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
86
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js"></script>
|
|
87
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js"></script>
|
|
88
88
|
<script>
|
|
89
89
|
// Legal Token Protocol
|
|
90
90
|
const propertyToken = bsv.createPropertyToken({
|
|
@@ -98,9 +98,9 @@ Everything in one file:
|
|
|
98
98
|
|
|
99
99
|
#### **Security & Cryptography (1.17MB total)**
|
|
100
100
|
```html
|
|
101
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
102
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
103
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
101
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
102
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js"></script>
|
|
103
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js"></script>
|
|
104
104
|
<script>
|
|
105
105
|
// Threshold Cryptography
|
|
106
106
|
const shares = bsv.splitSecret('my_secret_key', 5, 3);
|
|
@@ -114,18 +114,18 @@ Everything in one file:
|
|
|
114
114
|
|
|
115
115
|
| Module | Size | Purpose | CDN Link |
|
|
116
116
|
|--------|------|---------|----------|
|
|
117
|
-
| **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.3.
|
|
118
|
-
| **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.3.
|
|
119
|
-
| **bsv-smartcontract.min.js** | 451KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@3.3.
|
|
120
|
-
| **bsv-ltp.min.js** | 817KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@3.3.
|
|
121
|
-
| **bsv-gdaf.min.js** | 604KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@3.3.
|
|
122
|
-
| **bsv-shamir.min.js** | 433KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@3.3.
|
|
123
|
-
| **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.3.
|
|
124
|
-
| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.3.
|
|
125
|
-
| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.3.
|
|
126
|
-
| **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.3.
|
|
127
|
-
| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.3.
|
|
128
|
-
| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.3.
|
|
117
|
+
| **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js` |
|
|
118
|
+
| **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js` |
|
|
119
|
+
| **bsv-smartcontract.min.js** | 451KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js` |
|
|
120
|
+
| **bsv-ltp.min.js** | 817KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js` |
|
|
121
|
+
| **bsv-gdaf.min.js** | 604KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js` |
|
|
122
|
+
| **bsv-shamir.min.js** | 433KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js` |
|
|
123
|
+
| **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js` |
|
|
124
|
+
| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.3.4/bsv-mnemonic.min.js` |
|
|
125
|
+
| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ecies.min.js` |
|
|
126
|
+
| **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js` |
|
|
127
|
+
| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js` |
|
|
128
|
+
| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.3.4/bsv-message.min.js` |
|
|
129
129
|
|
|
130
130
|
## ⚙️ **Development Environment Setup**
|
|
131
131
|
|
|
@@ -14,10 +14,10 @@ npm install @smartledger/bsv
|
|
|
14
14
|
### Browser CDN (Instant)
|
|
15
15
|
```html
|
|
16
16
|
<!-- Core library (449KB) -->
|
|
17
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
17
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
18
18
|
|
|
19
19
|
<!-- Everything included (885KB) -->
|
|
20
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
20
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
## 💰 **Your First Transaction (60 seconds)**
|
|
@@ -127,19 +127,19 @@ SmartLedger-BSV offers 12 different loading options - use only what you need:
|
|
|
127
127
|
|
|
128
128
|
```html
|
|
129
129
|
<!-- Core BSV only (449KB) -->
|
|
130
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
130
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
131
131
|
|
|
132
132
|
<!-- Smart contracts (873KB) -->
|
|
133
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
133
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js"></script>
|
|
134
134
|
|
|
135
135
|
<!-- Legal tokens (1.1MB) -->
|
|
136
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
136
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js"></script>
|
|
137
137
|
|
|
138
138
|
<!-- Digital identity (1.1MB) -->
|
|
139
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
139
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js"></script>
|
|
140
140
|
|
|
141
141
|
<!-- Everything (885KB) -->
|
|
142
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
142
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
|
|
143
143
|
```
|
|
144
144
|
|
|
145
145
|
## ⚡ **Key Advantages**
|
|
@@ -153,17 +153,17 @@ const recovered = bsv.reconstructSecret([shares[0], shares[2], shares[4]]);
|
|
|
153
153
|
### **New Modular Options**
|
|
154
154
|
```html
|
|
155
155
|
<!-- Core compatibility (same size as bsv@1.5.6) -->
|
|
156
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
156
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
|
|
157
157
|
|
|
158
158
|
<!-- Add smart contracts when ready -->
|
|
159
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
159
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js"></script>
|
|
160
160
|
|
|
161
161
|
<!-- Add advanced features as needed -->
|
|
162
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
163
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
162
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js"></script>
|
|
163
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js"></script>
|
|
164
164
|
|
|
165
165
|
<!-- Everything in one file -->
|
|
166
|
-
<script src="https://unpkg.com/@smartledger/bsv@3.3.
|
|
166
|
+
<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
|
|
167
167
|
```
|
|
168
168
|
|
|
169
169
|
## 🔍 **Testing Your Migration**
|
package/index.js
CHANGED
|
@@ -115,6 +115,13 @@ try {
|
|
|
115
115
|
}
|
|
116
116
|
}
|
|
117
117
|
|
|
118
|
+
// Browser-compatible UTXO Manager (always available)
|
|
119
|
+
try {
|
|
120
|
+
bsv.BrowserUTXOManager = require('./lib/browser-utxo-manager-es5')
|
|
121
|
+
} catch (e) {
|
|
122
|
+
// BrowserUTXOManager not available
|
|
123
|
+
}
|
|
124
|
+
|
|
118
125
|
// Node.js specific tools (advanced development tools)
|
|
119
126
|
if (typeof window === 'undefined' && typeof require === 'function') {
|
|
120
127
|
try {
|