@smartledger/bsv 8.0.0 → 8.0.1

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 (17) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/README.md +38 -38
  3. package/bsv-gdaf.min.js +2 -2
  4. package/bsv-ltp.min.js +7 -7
  5. package/bsv-smartcontract.min.js +1 -1
  6. package/bsv.bundle.js +2 -2
  7. package/bsv.min.js +2 -2
  8. package/docs/AUDIT_SCOPE.md +9 -9
  9. package/docs/MODULE_REFERENCE_COMPLETE.md +27 -27
  10. package/docs/advanced/UTXO_MANAGER_GUIDE.md +1 -1
  11. package/docs/getting-started/INSTALLATION.md +23 -23
  12. package/docs/getting-started/QUICK_START.md +7 -7
  13. package/docs/migration/FROM_BSV_1_5_6.md +5 -5
  14. package/lib/script/interpreter.js +20 -25
  15. package/package.json +1 -1
  16. package/test/script/defaults.js +67 -0
  17. package/version.js +1 -1
package/docs/AUDIT_SCOPE.md CHANGED
@@ -5,7 +5,7 @@ cryptographic core, and carries the enquiry text to send to vendors. It exists s
5
5
  every vendor prices the *same* thing, and so that the reasoning behind the scope
6
6
  boundary survives past the engagement that prompted it.
7
7
 
8
- Measured against **v8.0.0**, 2026-08-13. Re-measure before sending if the version has
8
+ Measured against **v8.0.1**, 2026-08-13. Re-measure before sending if the version has
9
9
  moved (`docs/AUDIT_SCOPE.md` is not covered by a drift gate).
10
10
 
11
11
  ## 1. The question we are asking
@@ -29,11 +29,11 @@ testing.
29
29
  Two tiers, to be **priced separately** so the boundary can be drawn against a number
30
30
  rather than before seeing one.
31
31
 
32
- ### Tier 1 — core, 12,254 lines across 33 files
32
+ ### Tier 1 — core, 12,249 lines across 33 files
33
33
 
34
34
  | Module | Lines | Why it matters |
35
35
  | --- | ---: | --- |
36
- | `lib/script/` | 3,737 | Consensus script interpreter. Divergence from the node means accepting a transaction the network rejects, or the reverse. |
36
+ | `lib/script/` | 3,732 | Consensus script interpreter. Divergence from the node means accepting a transaction the network rejects, or the reverse. |
37
37
  | `lib/transaction/` | 2,779 | Sighash construction and signing — both BIP-143 and the Original Transaction Digest Algorithm. |
38
38
  | `lib/crypto/` | 2,519 | ECDSA, nonce derivation, signature encoding, the script-number type. |
39
39
  | `lib/hdprivatekey.js`, `lib/hdpublickey.js` | 1,168 | BIP-32 derivation, including hardened paths. |
@@ -60,17 +60,17 @@ is not.
60
60
  | `@noble/curves`, `@noble/hashes`, `@noble/ciphers` | Already audited | The primitives come from the Noble libraries, which **Cure53 has audited and published on**. We do not implement curve or hash arithmetic ourselves. State this explicitly to vendors — otherwise they price work we do not need. |
61
61
  | `lib/smart_contract/`, `lib/ltp/`, `lib/gdaf/`, `lib/ordinals/`, `lib/block/`, plus 9 further directories and 6 top-level files | Excluded | Application layer, 22,815 lines — 18,435 in the five named modules and 4,380 in the remainder. Written in-house and covered by adversarial tests. Worth a separate engagement; including it here would blur the question in §1. |
62
62
 
63
- Totals reconcile against `lib/`, which is 36,676 lines across 123 files:
63
+ Totals reconcile against `lib/`, which is 36,671 lines across 123 files:
64
64
 
65
65
  ```
66
- tier 1 12,254
66
+ tier 1 12,249
67
67
  tier 2 1,607
68
68
  excluded 22,815
69
69
  ------
70
- total 36,676
70
+ total 36,671
71
71
  ```
72
72
 
73
- Core + optional = 13,861.
73
+ Core + optional = 13,856.
74
74
 
75
75
  ## 4. What an auditor gets on day one
76
76
 
@@ -133,7 +133,7 @@ seeking a quote for an independent security review of its cryptographic core.
133
133
 
134
134
  Scope, and we would like these priced separately:
135
135
 
136
- Tier 1 — 12,254 lines, 33 files. Script interpreter, sighash and signing,
136
+ Tier 1 — 12,249 lines, 33 files. Script interpreter, sighash and signing,
137
137
  ECDSA and signature encoding, BIP-32 derivation, key and address
138
138
  construction.
139
139
 
@@ -171,7 +171,7 @@ SmartLedger Technology
171
171
  Every figure in this document, including the excluded total, must come out of this
172
172
  script. **Derive the excluded count as the complement — never by subtracting tier 1
173
173
  alone.** The first draft did exactly that, double-counted tier 2, and published parts
174
- summing to 37,430 against a 36,676 whole; §7 could not catch it because it reproduced
174
+ summing to 37,430 against a 36,671 whole; §7 could not catch it because it reproduced
175
175
  every figure except the wrong one.
176
176
 
177
177
  ```sh
package/docs/MODULE_REFERENCE_COMPLETE.md CHANGED
@@ -55,19 +55,19 @@ Three advanced modules totaling **~2.7MB** of functionality:
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@8.0.0/bsv-shamir.min.js`
58
+ - **CDN**: `unpkg.com/@smartledger/bsv@8.0.1/bsv-shamir.min.js`
59
59
 
60
60
  #### **🌐 Global Digital Attestation Framework - GDAF (1184KB)**
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@8.0.0/bsv-gdaf.min.js`
64
+ - **CDN**: `unpkg.com/@smartledger/bsv@8.0.1/bsv-gdaf.min.js`
65
65
 
66
66
  #### **⚖️ Legal Token Protocol - LTP (1184KB)**
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@8.0.0/bsv-ltp.min.js`
70
+ - **CDN**: `unpkg.com/@smartledger/bsv@8.0.1/bsv-ltp.min.js`
71
71
 
72
72
  ### **2. Incorrect File Sizes in Documentation**
73
73
 
@@ -81,18 +81,18 @@ Three advanced modules totaling **~2.7MB** of functionality:
81
81
 
82
82
  | Module | Size | Use Case | CDN Link |
83
83
  |--------|------|----------|----------|
84
- | **bsv.min.js** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js` |
85
- | **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@8.0.0/bsv.bundle.js` |
86
- | **bsv-smartcontract.min.js** | 937KB | Covenant development | `unpkg.com/@smartledger/bsv@8.0.0/bsv-smartcontract.min.js` |
87
- | **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@8.0.0/bsv-covenant.min.js` |
88
- | **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@8.0.0/bsv-script-helper.min.js` |
89
- | **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@8.0.0/bsv-security.min.js` |
90
- | **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@8.0.0/bsv-ecies.min.js` |
91
- | **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@8.0.0/bsv-message.min.js` |
92
- | **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@8.0.0/bsv-mnemonic.min.js` |
93
- | **🆕 bsv-shamir.min.js** | 432KB | **Secret sharing** | `unpkg.com/@smartledger/bsv@8.0.0/bsv-shamir.min.js` |
94
- | **🆕 bsv-gdaf.min.js** | 1184KB | **Digital attestation** | `unpkg.com/@smartledger/bsv@8.0.0/bsv-gdaf.min.js` |
95
- | **🆕 bsv-ltp.min.js** | 1184KB | **Legal tokens** | `unpkg.com/@smartledger/bsv@8.0.0/bsv-ltp.min.js` |
84
+ | **bsv.min.js** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js` |
85
+ | **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@8.0.1/bsv.bundle.js` |
86
+ | **bsv-smartcontract.min.js** | 937KB | Covenant development | `unpkg.com/@smartledger/bsv@8.0.1/bsv-smartcontract.min.js` |
87
+ | **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@8.0.1/bsv-covenant.min.js` |
88
+ | **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@8.0.1/bsv-script-helper.min.js` |
89
+ | **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@8.0.1/bsv-security.min.js` |
90
+ | **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@8.0.1/bsv-ecies.min.js` |
91
+ | **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@8.0.1/bsv-message.min.js` |
92
+ | **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@8.0.1/bsv-mnemonic.min.js` |
93
+ | **🆕 bsv-shamir.min.js** | 432KB | **Secret sharing** | `unpkg.com/@smartledger/bsv@8.0.1/bsv-shamir.min.js` |
94
+ | **🆕 bsv-gdaf.min.js** | 1184KB | **Digital attestation** | `unpkg.com/@smartledger/bsv@8.0.1/bsv-gdaf.min.js` |
95
+ | **🆕 bsv-ltp.min.js** | 1184KB | **Legal tokens** | `unpkg.com/@smartledger/bsv@8.0.1/bsv-ltp.min.js` |
96
96
 
97
97
  ## 🎯 **Updated Usage Examples**
98
98
 
@@ -100,22 +100,22 @@ Three advanced modules totaling **~2.7MB** of functionality:
100
100
 
101
101
  #### **1. Basic Development (~963KB)**
102
102
  ```html
103
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js"></script>
104
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-script-helper.min.js"></script>
103
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js"></script>
104
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-script-helper.min.js"></script>
105
105
  ```
106
106
 
107
107
  #### **2. Smart Contract Development (~2.7MB — each bundle re-embeds core BSV)**
108
108
  ```html
109
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js"></script>
110
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-covenant.min.js"></script>
111
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-smartcontract.min.js"></script>
109
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js"></script>
110
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-covenant.min.js"></script>
111
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-smartcontract.min.js"></script>
112
112
  ```
113
113
 
114
114
  #### **3. 🆕 Legal & Compliance Development (~3.2MB — each bundle re-embeds core BSV)**
115
115
  ```html
116
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js"></script>
117
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-ltp.min.js"></script>
118
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-gdaf.min.js"></script>
116
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js"></script>
117
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-ltp.min.js"></script>
118
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-gdaf.min.js"></script>
119
119
  <script>
120
120
  // Legal Token Protocol
121
121
  const legalToken = bsv.createLegalToken({
@@ -132,9 +132,9 @@ Three advanced modules totaling **~2.7MB** of functionality:
132
132
 
133
133
  #### **4. 🆕 Security & Cryptography (~1.4MB)**
134
134
  ```html
135
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js"></script>
136
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-security.min.js"></script>
137
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-shamir.min.js"></script>
135
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js"></script>
136
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-security.min.js"></script>
137
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-shamir.min.js"></script>
138
138
  <script>
139
139
  // Shamir Secret Sharing
140
140
  const shares = bsv.splitSecret('my_secret_key', 5, 3); // 5 shares, 3 needed
@@ -146,7 +146,7 @@ Three advanced modules totaling **~2.7MB** of functionality:
146
146
 
147
147
  #### **5. Everything Bundle (937KB)**
148
148
  ```html
149
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.bundle.js"></script>
149
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.bundle.js"></script>
150
150
  <script>
151
151
  // Everything available immediately
152
152
  const shares = bsv.splitSecret('secret', 5, 3);
package/docs/advanced/UTXO_MANAGER_GUIDE.md CHANGED
@@ -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@8.0.0/bsv.min.js"></script>
725
+ <script src="https://cdn.jsdelivr.net/npm/@smartledger/bsv@8.0.1/bsv.min.js"></script>
726
726
  </head>
727
727
  <body>
728
728
  <script>
package/docs/getting-started/INSTALLATION.md CHANGED
@@ -48,7 +48,7 @@ const tx: Transaction = new Transaction();
48
48
  #### **Core Library Only (937KB)**
49
49
  For basic Bitcoin SV operations:
50
50
  ```html
51
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js"></script>
51
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/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 (937KB)**
59
59
  Everything in one file:
60
60
  ```html
61
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.bundle.js"></script>
61
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/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 (~2.7MB total — each bundle is self-contained and re-embeds core BSV)**
73
73
  ```html
74
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js"></script>
75
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-covenant.min.js"></script>
76
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-smartcontract.min.js"></script>
74
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js"></script>
75
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-covenant.min.js"></script>
76
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/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 (~3.2MB total — each bundle is self-contained and re-embeds core BSV)**
84
84
  ```html
85
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js"></script>
86
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-ltp.min.js"></script>
87
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-gdaf.min.js"></script>
85
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js"></script>
86
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-ltp.min.js"></script>
87
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/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.4MB total — each bundle is self-contained and re-embeds core BSV)**
100
100
  ```html
101
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js"></script>
102
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-security.min.js"></script>
103
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-shamir.min.js"></script>
101
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js"></script>
102
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-security.min.js"></script>
103
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/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** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js` |
118
- | **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@8.0.0/bsv.bundle.js` |
119
- | **bsv-smartcontract.min.js** | 937KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@8.0.0/bsv-smartcontract.min.js` |
120
- | **bsv-ltp.min.js** | 1184KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@8.0.0/bsv-ltp.min.js` |
121
- | **bsv-gdaf.min.js** | 1184KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@8.0.0/bsv-gdaf.min.js` |
122
- | **bsv-shamir.min.js** | 432KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@8.0.0/bsv-shamir.min.js` |
123
- | **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@8.0.0/bsv-security.min.js` |
124
- | **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@8.0.0/bsv-mnemonic.min.js` |
125
- | **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@8.0.0/bsv-ecies.min.js` |
126
- | **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@8.0.0/bsv-covenant.min.js` |
127
- | **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@8.0.0/bsv-script-helper.min.js` |
128
- | **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@8.0.0/bsv-message.min.js` |
117
+ | **bsv.min.js** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js` |
118
+ | **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@8.0.1/bsv.bundle.js` |
119
+ | **bsv-smartcontract.min.js** | 937KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@8.0.1/bsv-smartcontract.min.js` |
120
+ | **bsv-ltp.min.js** | 1184KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@8.0.1/bsv-ltp.min.js` |
121
+ | **bsv-gdaf.min.js** | 1184KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@8.0.1/bsv-gdaf.min.js` |
122
+ | **bsv-shamir.min.js** | 432KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@8.0.1/bsv-shamir.min.js` |
123
+ | **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@8.0.1/bsv-security.min.js` |
124
+ | **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@8.0.1/bsv-mnemonic.min.js` |
125
+ | **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@8.0.1/bsv-ecies.min.js` |
126
+ | **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@8.0.1/bsv-covenant.min.js` |
127
+ | **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@8.0.1/bsv-script-helper.min.js` |
128
+ | **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@8.0.1/bsv-message.min.js` |
129
129
 
130
130
  ## ⚙️ **Development Environment Setup**
131
131
 
package/docs/getting-started/QUICK_START.md CHANGED
@@ -14,10 +14,10 @@ npm install @smartledger/bsv
14
14
  ### Browser CDN (Instant)
15
15
  ```html
16
16
  <!-- Core library (937KB) -->
17
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js"></script>
17
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js"></script>
18
18
 
19
19
  <!-- Everything included (937KB) -->
20
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.bundle.js"></script>
20
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/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 (937KB) -->
130
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js"></script>
130
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js"></script>
131
131
 
132
132
  <!-- Smart contracts (937KB) -->
133
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-smartcontract.min.js"></script>
133
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-smartcontract.min.js"></script>
134
134
 
135
135
  <!-- Legal tokens (1.16MB) -->
136
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-ltp.min.js"></script>
136
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-ltp.min.js"></script>
137
137
 
138
138
  <!-- Digital identity (1.16MB) -->
139
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-gdaf.min.js"></script>
139
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-gdaf.min.js"></script>
140
140
 
141
141
  <!-- Everything (937KB) -->
142
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.bundle.js"></script>
142
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.bundle.js"></script>
143
143
  ```
144
144
 
145
145
  ## ⚡ **Key Advantages**
package/docs/migration/FROM_BSV_1_5_6.md CHANGED
@@ -159,17 +159,17 @@ const recovered = bsv.reconstructSecret([shares[0], shares[2], shares[4]]);
159
159
  ### **New Modular Options**
160
160
  ```html
161
161
  <!-- Core compatibility (same size as bsv@1.5.6) -->
162
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.min.js"></script>
162
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.min.js"></script>
163
163
 
164
164
  <!-- Add smart contracts when ready -->
165
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-smartcontract.min.js"></script>
165
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-smartcontract.min.js"></script>
166
166
 
167
167
  <!-- Add advanced features as needed -->
168
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-ltp.min.js"></script>
169
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv-gdaf.min.js"></script>
168
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-ltp.min.js"></script>
169
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv-gdaf.min.js"></script>
170
170
 
171
171
  <!-- Everything in one file -->
172
- <script src="https://unpkg.com/@smartledger/bsv@8.0.0/bsv.bundle.js"></script>
172
+ <script src="https://unpkg.com/@smartledger/bsv@8.0.1/bsv.bundle.js"></script>
173
173
  ```
174
174
 
175
175
  ## 🔍 **Testing Your Migration**
package/lib/script/interpreter.js CHANGED
@@ -268,11 +268,6 @@ Interpreter.MAX_SCRIPT_ELEMENT_SIZE = 520
268
268
  // operands through it, and Chronicle's shift bounds its result against it.
269
269
  Interpreter.MAXIMUM_ELEMENT_SIZE = 4
270
270
 
271
- // The script-number bound `useMainnetConsensus()` applies. Held separately from the
272
- // pre-Genesis default above so the two can diverge once the post-Genesis value is pinned
273
- // against the node source; see the note in useMainnetConsensus for why it is not simply
274
- // raised with the other caps.
275
- Interpreter.DEFAULT_SCRIPT_NUM_LENGTH = 4
276
271
  // Maximum number of non-push opcodes per script. Pre-Genesis consensus is 201;
277
272
  // post-Genesis BSV removed this limit. Exposed as a constant (instead of a magic
278
273
  // number) so applications can opt into post-Genesis rules — e.g. OP_PUSH_TX
@@ -535,9 +530,16 @@ Interpreter.mainnetFlags = function (opts) {
535
530
  Interpreter.SCRIPT_VERIFY_MINIMALDATA |
536
531
  Interpreter.SCRIPT_ENABLE_SIGHASH_FORKID |
537
532
  Interpreter.SCRIPT_ENABLE_MAGNETIC_OPCODES |
538
- Interpreter.SCRIPT_ENABLE_MONOLITH_OPCODES
533
+ Interpreter.SCRIPT_ENABLE_MONOLITH_OPCODES |
534
+ // The era flags. Without these the interpreter falls back to the pre-Genesis
535
+ // statics, so a validator built from a helper named after mainnet was applying
536
+ // 2019 limits — most sharply the 4-byte script-number bound, where post-Genesis
537
+ // is 750,000 and post-Chronicle 32,000,000. Genesis is unconditional here: it
538
+ // activated in 2020 and cannot be opted out of by anything still being spent.
539
+ Interpreter.SCRIPT_GENESIS |
540
+ Interpreter.SCRIPT_UTXO_AFTER_GENESIS
539
541
  if (opts.afterChronicle !== false) {
540
- flags |= Interpreter.SCRIPT_ENABLE_CHRONICLE
542
+ flags |= Interpreter.SCRIPT_ENABLE_CHRONICLE | Interpreter.SCRIPT_UTXO_AFTER_CHRONICLE
541
543
  }
542
544
  return flags
543
545
  }
@@ -601,25 +603,18 @@ Interpreter.useMainnetConsensus = function (opts) {
601
603
  opts = opts || {}
602
604
  Interpreter.useGenesisLimits(opts.max)
603
605
 
604
- // Restore a FINITE script-number bound. `useGenesisLimits()` raises all four caps to
605
- // the same ceiling, and for MAXIMUM_ELEMENT_SIZE — which is CScriptNum's `max_length`,
606
- // not a push-size cap — a ceiling of 0x7fffffff makes Chronicle's shift overflow check
607
- // unreachable, because it tests `current_size + shift_bytes > max_length`. Measured:
608
- //
609
- // default limits: SCRIPT_ERR_SCRIPTNUM_OVERFLOW (correct)
610
- // after useGenesisLimits(): valid, grows without bound (WRONG)
611
- //
612
- // A validator looser than consensus accepts what the network rejects, so the ceiling
613
- // cannot be right whatever the true post-Genesis value turns out to be.
606
+ // The script-number bound is NOT set here. It is era-derived from the flags by
607
+ // Interpreter#maxScriptNumLength(): 4 bytes pre-Genesis, 750,000 after Genesis,
608
+ // 32,000,000 after Chronicle. An earlier version of this function pinned
609
+ // MAXIMUM_ELEMENT_SIZE to a static value to stop useGenesisLimits() raising it to
610
+ // 0x7fffffff, which made Chronicle's shift-overflow check unreachable. That was
611
+ // treating the symptom: the real defect was mainnetFlags() omitting the era flags,
612
+ // so the era-derived bound never applied. Fixed there instead.
614
613
  //
615
- // The true value is NOT settled here. Genesis raised this bound above the pre-Genesis
616
- // 4 bytes, so the conservative default below is stricter than mainnet for wide
617
- // arithmetic — the same class of error #112 fixed, in the opposite direction. It is
618
- // chosen deliberately: given a choice between rejecting a valid script and accepting
619
- // an invalid one, this library fails closed. Callers who know the bound their workload
620
- // needs should pass `maxScriptNumLength` explicitly, and the value should be pinned
621
- // against the SV Node source before this default changes.
622
- Interpreter.MAXIMUM_ELEMENT_SIZE = opts.maxScriptNumLength || Interpreter.DEFAULT_SCRIPT_NUM_LENGTH
614
+ // The node's vectors settle the pre-Genesis value at 4 and are silent on the rest —
615
+ // all 22 SCRIPTNUM_OVERFLOW rows carry P2SH,STRICTENC and no era flag. Raising the
616
+ // static bound to 8 turns 15 of them into false accepts, which is how that was
617
+ // measured.
623
618
 
624
619
  return Interpreter.mainnetFlags(opts)
625
620
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@smartledger/bsv",
3
- "version": "8.0.0",
3
+ "version": "8.0.1",
4
4
  "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.",
5
5
  "author": "SmartLedger Technology <hello@smartledger.technology> (https://smartledger.technology)",
6
6
  "homepage": "https://github.com/codenlighten/smartledger-bsv#readme",
package/test/script/defaults.js CHANGED
@@ -91,3 +91,70 @@ describe('verify() consensus defaults', function () {
91
91
  })
92
92
  })
93
93
  })
94
+
95
+ // The script-number bound is era-derived, not a process-wide static.
96
+ //
97
+ // `mainnetFlags()` omitted every era flag except SCRIPT_ENABLE_CHRONICLE, so
98
+ // `maxScriptNumLength()` fell back to the pre-Genesis 4 for a validator built from the
99
+ // helper named after mainnet — while post-Genesis is 750,000 and post-Chronicle
100
+ // 32,000,000. An earlier fix pinned MAXIMUM_ELEMENT_SIZE to stop useGenesisLimits()
101
+ // raising it to 0x7fffffff and making Chronicle's shift-overflow check unreachable; that
102
+ // treated the symptom rather than the missing flags.
103
+ //
104
+ // The node's vectors settle the pre-Genesis value at 4 and are silent above it: all 22
105
+ // SCRIPTNUM_OVERFLOW rows carry P2SH,STRICTENC and no era flag, and raising the static
106
+ // bound to 8 turns 15 of them into false accepts.
107
+ describe('script-number bound follows the era', function () {
108
+ function boundFor (flags) {
109
+ var i = new Interpreter()
110
+ i.set({ flags: flags })
111
+ return i.maxScriptNumLength()
112
+ }
113
+
114
+ it('is 4 before Genesis, which the node vectors pin', function () {
115
+ boundFor(0).should.equal(4)
116
+ })
117
+
118
+ it('is the post-Genesis figure when only Genesis is asked for', function () {
119
+ boundFor(Interpreter.mainnetFlags({ afterChronicle: false }))
120
+ .should.equal(Interpreter.MAX_SCRIPT_NUM_LENGTH_AFTER_GENESIS)
121
+ })
122
+
123
+ it('is the post-Chronicle figure under mainnetFlags() and the default', function () {
124
+ boundFor(Interpreter.mainnetFlags())
125
+ .should.equal(Interpreter.MAX_SCRIPT_NUM_LENGTH_AFTER_CHRONICLE)
126
+ boundFor(Interpreter.currentConsensusFlags())
127
+ .should.equal(Interpreter.MAX_SCRIPT_NUM_LENGTH_AFTER_CHRONICLE)
128
+ })
129
+
130
+ // Genesis activated in 2020 and nothing still spendable predates it in a way that
131
+ // makes a mainnet helper want the older limits, so it is not opt-out-able here.
132
+ it('carries the Genesis era flags in mainnetFlags(), both variants', function () {
133
+ ;[Interpreter.mainnetFlags(), Interpreter.mainnetFlags({ afterChronicle: false })].forEach(function (f) {
134
+ (f & Interpreter.SCRIPT_GENESIS).should.equal(Interpreter.SCRIPT_GENESIS)
135
+ ;(f & Interpreter.SCRIPT_UTXO_AFTER_GENESIS).should.equal(Interpreter.SCRIPT_UTXO_AFTER_GENESIS)
136
+ })
137
+ })
138
+
139
+ it('drops only the Chronicle pair for a pre-activation UTXO', function () {
140
+ var pre = Interpreter.mainnetFlags({ afterChronicle: false })
141
+ ;(pre & Interpreter.SCRIPT_ENABLE_CHRONICLE).should.equal(0)
142
+ ;(pre & Interpreter.SCRIPT_UTXO_AFTER_CHRONICLE).should.equal(0)
143
+ })
144
+
145
+ // useMainnetConsensus() must no longer pin the static; the flags carry the bound.
146
+ //
147
+ // The limits are process-wide statics, so this saves and restores them. Without the
148
+ // restore the raised caps leak into every later test in the same mocha process — 24 of
149
+ // them, when this was first written, including the inherited pre-Genesis bitcoind
150
+ // vectors. The same trap #114 hit and documented.
151
+ it('is not overridden by useMainnetConsensus()', function () {
152
+ var saved = Interpreter.getLimits()
153
+ try {
154
+ var flags = Interpreter.useMainnetConsensus()
155
+ boundFor(flags).should.equal(Interpreter.MAX_SCRIPT_NUM_LENGTH_AFTER_CHRONICLE)
156
+ } finally {
157
+ Interpreter.setLimits(saved)
158
+ }
159
+ })
160
+ })
package/version.js CHANGED
@@ -1,3 +1,3 @@
1
1
  'use strict'
2
2
  // GENERATED by scripts/sync-version.js on `npm version` — do not edit.
3
- module.exports = '8.0.0'
3
+ module.exports = '8.0.1'