@smartledger/bsv 9.10.0 → 9.11.0
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 +68 -0
- package/README.md +19 -19
- package/bsv-gdaf.min.js +58 -58
- package/bsv-ltp.min.js +28 -28
- package/bsv-smartcontract.min.js +1 -1
- package/bsv.bundle.js +58 -58
- package/bsv.min.js +58 -58
- package/docs/AUDIT_SCOPE.md +8 -8
- package/docs/BRC220_CERTIFICATE_FIELDS_AMENDMENT.md +7 -3
- package/docs/MODULE_REFERENCE_COMPLETE.md +27 -27
- package/docs/advanced/UTXO_MANAGER_GUIDE.md +1 -1
- package/docs/audit-rfq/cure53.txt +2 -2
- package/docs/audit-rfq/ncc-group.txt +2 -2
- package/docs/audit-rfq/trail-of-bits.txt +2 -2
- package/docs/getting-started/INSTALLATION.md +23 -23
- package/docs/getting-started/QUICK_START.md +7 -7
- package/docs/migration/FROM_BSV_1_5_6.md +5 -5
- package/lib/notaryhash/suites.js +2 -2
- package/lib/script/interpreter.js +40 -10
- package/lib/script/script.js +72 -21
- package/lib/transaction/sighash.js +12 -5
- package/package.json +1 -1
- package/version.js +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,74 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [9.11.0] - 2026-09-16
|
|
11
|
+
|
|
12
|
+
**The interpreter now accepts only what the node accepts when a script pushes a copy of a signature, and signature checks over large scripts are about eight times faster.** No API change. The consensus fix follows bitcoin-sv v1.2.0 `CleanupScriptCode`; every signature digest is byte-identical to 9.10.1.
|
|
13
|
+
|
|
14
|
+
### Fixed — a spend the network rejects was accepted: signatures removed from the scriptCode where the node keeps them
|
|
15
|
+
|
|
16
|
+
Before checking a signature, `OP_CHECKSIG`, `OP_CHECKSIGVERIFY` and `OP_CHECKMULTISIG(VERIFY)`
|
|
17
|
+
removed every copy of the signature from the script it signs. The node does that only when
|
|
18
|
+
FORKID is not in effect (bitcoin-sv `src/script/interpreter.cpp`, `CleanupScriptCode`):
|
|
19
|
+
|
|
20
|
+
```cpp
|
|
21
|
+
if (!(flags & SCRIPT_ENABLE_SIGHASH_FORKID) || !sigHashType.hasForkId())
|
|
22
|
+
scriptCode.FindAndDelete(CScript(vchSig));
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
So a locking script that pushes a copy of a signature could be satisfied by that signature
|
|
26
|
+
made over the script *without* the push. The library removed the push, found the digest it
|
|
27
|
+
expected and accepted; the node signs over the script as it is and rejects. A covenant or
|
|
28
|
+
wallet relying on this library's verdict could build, and consider final, a transaction the
|
|
29
|
+
network will never mine. All three opcodes now follow the node's rule.
|
|
30
|
+
|
|
31
|
+
`Script#findAndDelete` also skipped the chunk after each removal, so of two consecutive copies
|
|
32
|
+
only the first went. `CScript::FindAndDelete` removes consecutive occurrences, including every
|
|
33
|
+
`OP_0` for an empty non-FORKID signature; so does this now. A byte-level transcription of the
|
|
34
|
+
node's `FindAndDelete` agrees with it over 30,000 generated scripts, where the previous version
|
|
35
|
+
disagreed on 15,380.
|
|
36
|
+
|
|
37
|
+
### Changed — signature checks over large scripts are much faster
|
|
38
|
+
|
|
39
|
+
On a 238 KB OP_PUSH_TX locking script one `OP_CHECKSIGVERIFY` took about 450 ms, against 0.2 ms to
|
|
40
|
+
hash the bytes it signs. The scriptCode is no longer copied on the FORKID path, is serialized
|
|
41
|
+
once rather than twice, `Script#toBuffer` writes one allocation, and `findAndDelete` serializes
|
|
42
|
+
only chunks that can match. Measured on a 139 KB script: 207 ms → 27 ms. Every serialization and
|
|
43
|
+
every digest is unchanged: 65,044 sighash digests over generated transactions and scriptCodes,
|
|
44
|
+
both algorithms, all hash types, are byte-identical to 9.10.1.
|
|
45
|
+
|
|
46
|
+
## [9.10.1] - 2026-09-16
|
|
47
|
+
|
|
48
|
+
**A patch: evaluating a script no longer rewrites it or the interpreter's shared boolean values.** No API change; consensus results are unchanged.
|
|
49
|
+
|
|
50
|
+
### Fixed — evaluating a script could rewrite it, and corrupt `true` for every later script
|
|
51
|
+
|
|
52
|
+
`OP_AND`, `OP_OR`, `OP_XOR` and `OP_INVERT` wrote their result into their operand, and
|
|
53
|
+
`OP_NUM2BIN`/`OP_BIN2NUM` went through `_minimallyEncode`, which rewrote the last byte of
|
|
54
|
+
its argument. An operand is not necessarily the interpreter's own memory: a push places the
|
|
55
|
+
script chunk's buffer on the stack, `OP_SPLIT` returns views into its input, and boolean
|
|
56
|
+
results are the shared `Interpreter.true` and `Interpreter.false`. So evaluation could:
|
|
57
|
+
|
|
58
|
+
- **rewrite the script being evaluated**, including a buffer a caller passed to
|
|
59
|
+
`Script.fromBuffer`, and with it the script code a later signature covers;
|
|
60
|
+
- **corrupt `Interpreter.true` for the rest of the process.** After
|
|
61
|
+
`OP_2 OP_2 OP_3 OP_WITHIN OP_INVERT`, every later `OP_EQUAL`, `OP_WITHIN` and
|
|
62
|
+
`OP_CHECKSIG` pushed `0xfe` instead of `0x01`; `OP_XOR` of two boolean results zeroed it.
|
|
63
|
+
|
|
64
|
+
Each opcode now writes a new buffer. `test/script/in_place_mutation.js` fails 12 of 18 on
|
|
65
|
+
the previous code. A fuzz of 20,000 random scripts found 58 that altered the script or the
|
|
66
|
+
shared booleans before the fix, and none after. Consensus results are unchanged:
|
|
67
|
+
conformance 452/452, SV vectors 1483/1483.
|
|
68
|
+
|
|
69
|
+
### Docs
|
|
70
|
+
|
|
71
|
+
- `docs/BRC220_CERTIFICATE_FIELDS_AMENDMENT.md` follows bsv-blockchain/BRCs#247 after review.
|
|
72
|
+
The first wording said DER "is not 64 bytes long", which is false: DER can be 64 bytes when
|
|
73
|
+
`r` and `s` are unusually short. The text now states the rule the reference implementation
|
|
74
|
+
and this library both apply: exactly 64 bytes is `r ‖ s`, and anything else must parse as
|
|
75
|
+
DER. The matching comment in `lib/notaryhash/suites.js` is corrected the same way; the
|
|
76
|
+
code already applied that rule.
|
|
77
|
+
|
|
10
78
|
## [9.10.0] - 2026-09-11
|
|
11
79
|
|
|
12
80
|
**NotaryHash refuses base64 that is not base64, can check a header's height, and its
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Bitcoin SV library with an interpreter-verified script engine.
|
|
4
4
|
|
|
5
|
-
[](https://www.npmjs.com/package/@smartledger/bsv)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
[](STABILITY.md)
|
|
8
8
|
|
|
@@ -155,44 +155,44 @@ const bsv = require('@smartledger/bsv') // 128 modules
|
|
|
155
155
|
### **Core Modules**
|
|
156
156
|
| Module | Size | Use Case | CDN |
|
|
157
157
|
|--------|------|----------|-----|
|
|
158
|
-
| **bsv.min.js** |
|
|
159
|
-
| **bsv.bundle.js** |
|
|
158
|
+
| **bsv.min.js** | 1057KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@9.11.0/bsv.min.js` |
|
|
159
|
+
| **bsv.bundle.js** | 1057KB | Everything in one file | `unpkg.com/@smartledger/bsv@9.11.0/bsv.bundle.js` |
|
|
160
160
|
|
|
161
161
|
### **W3C Verifiable Credentials**
|
|
162
162
|
| Module | Size | Use Case | CDN |
|
|
163
163
|
|--------|------|----------|-----|
|
|
164
|
-
| **🟢 bsv-didweb.min.js** | 166KB | **DID:web generation** | `unpkg.com/@smartledger/bsv@9.
|
|
165
|
-
| **🟢 bsv-vcjwt.min.js** | 166KB | **VC-JWT issue/verify** | `unpkg.com/@smartledger/bsv@9.
|
|
166
|
-
| **🟢 bsv-statuslist.min.js** | 256KB | **StatusList2021 revocation** | `unpkg.com/@smartledger/bsv@9.
|
|
167
|
-
| **🟢 bsv-anchor.min.js** | 164KB | **BSV anchoring (hash-only)** | `unpkg.com/@smartledger/bsv@9.
|
|
164
|
+
| **🟢 bsv-didweb.min.js** | 166KB | **DID:web generation** | `unpkg.com/@smartledger/bsv@9.11.0/bsv-didweb.min.js` |
|
|
165
|
+
| **🟢 bsv-vcjwt.min.js** | 166KB | **VC-JWT issue/verify** | `unpkg.com/@smartledger/bsv@9.11.0/bsv-vcjwt.min.js` |
|
|
166
|
+
| **🟢 bsv-statuslist.min.js** | 256KB | **StatusList2021 revocation** | `unpkg.com/@smartledger/bsv@9.11.0/bsv-statuslist.min.js` |
|
|
167
|
+
| **🟢 bsv-anchor.min.js** | 164KB | **BSV anchoring (hash-only)** | `unpkg.com/@smartledger/bsv@9.11.0/bsv-anchor.min.js` |
|
|
168
168
|
|
|
169
169
|
### **Smart Contract & Development**
|
|
170
170
|
| Module | Size | Use Case | CDN |
|
|
171
171
|
|--------|------|----------|-----|
|
|
172
|
-
| **bsv-smartcontract.min.js** | 141KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@9.
|
|
173
|
-
| **bsv-covenant.min.js** | 35KB | Covenant operations | `unpkg.com/@smartledger/bsv@9.
|
|
174
|
-
| **bsv-script-helper.min.js** | 33KB | Custom script tools | `unpkg.com/@smartledger/bsv@9.
|
|
175
|
-
| **bsv-security.min.js** | 32KB | Security enhancements | `unpkg.com/@smartledger/bsv@9.
|
|
172
|
+
| **bsv-smartcontract.min.js** | 141KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@9.11.0/bsv-smartcontract.min.js` |
|
|
173
|
+
| **bsv-covenant.min.js** | 35KB | Covenant operations | `unpkg.com/@smartledger/bsv@9.11.0/bsv-covenant.min.js` |
|
|
174
|
+
| **bsv-script-helper.min.js** | 33KB | Custom script tools | `unpkg.com/@smartledger/bsv@9.11.0/bsv-script-helper.min.js` |
|
|
175
|
+
| **bsv-security.min.js** | 32KB | Security enhancements | `unpkg.com/@smartledger/bsv@9.11.0/bsv-security.min.js` |
|
|
176
176
|
|
|
177
177
|
### **Legal & Compliance**
|
|
178
178
|
| Module | Size | Use Case | CDN |
|
|
179
179
|
|--------|------|----------|-----|
|
|
180
|
-
| **bsv-ltp.min.js** |
|
|
181
|
-
| **bsv-gdaf.min.js** |
|
|
180
|
+
| **bsv-ltp.min.js** | 541KB | Legal Token Protocol | `unpkg.com/@smartledger/bsv@9.11.0/bsv-ltp.min.js` |
|
|
181
|
+
| **bsv-gdaf.min.js** | 1057KB | Digital Identity & Attestation | `unpkg.com/@smartledger/bsv@9.11.0/bsv-gdaf.min.js` |
|
|
182
182
|
|
|
183
183
|
### **Advanced Cryptography**
|
|
184
184
|
| Module | Size | Use Case | CDN |
|
|
185
185
|
|--------|------|----------|-----|
|
|
186
|
-
| **bsv-shamir.min.js** | 177KB | Threshold Cryptography | `unpkg.com/@smartledger/bsv@9.
|
|
186
|
+
| **bsv-shamir.min.js** | 177KB | Threshold Cryptography | `unpkg.com/@smartledger/bsv@9.11.0/bsv-shamir.min.js` |
|
|
187
187
|
|
|
188
188
|
### **Utilities**
|
|
189
189
|
| Module | Size | Use Case | CDN |
|
|
190
190
|
|--------|------|----------|-----|
|
|
191
|
-
| **bsv-ecies.min.js** | 137KB | Encryption | `unpkg.com/@smartledger/bsv@9.
|
|
192
|
-
| **bsv-message.min.js** | 34KB | Message signing | `unpkg.com/@smartledger/bsv@9.
|
|
193
|
-
| **bsv-mnemonic.min.js** | 320KB | HD wallets | `unpkg.com/@smartledger/bsv@9.
|
|
191
|
+
| **bsv-ecies.min.js** | 137KB | Encryption | `unpkg.com/@smartledger/bsv@9.11.0/bsv-ecies.min.js` |
|
|
192
|
+
| **bsv-message.min.js** | 34KB | Message signing | `unpkg.com/@smartledger/bsv@9.11.0/bsv-message.min.js` |
|
|
193
|
+
| **bsv-mnemonic.min.js** | 320KB | HD wallets | `unpkg.com/@smartledger/bsv@9.11.0/bsv-mnemonic.min.js` |
|
|
194
194
|
```html
|
|
195
|
-
<script src="https://unpkg.com/@smartledger/bsv@9.
|
|
195
|
+
<script src="https://unpkg.com/@smartledger/bsv@9.11.0/bsv.min.js"></script>
|
|
196
196
|
<script>
|
|
197
197
|
const key = bsv.PrivateKey.fromRandom()
|
|
198
198
|
</script>
|
|
@@ -240,4 +240,4 @@ MIT
|
|
|
240
240
|
|
|
241
241
|
---
|
|
242
242
|
|
|
243
|
-
**SmartLedger-BSV v9.
|
|
243
|
+
**SmartLedger-BSV v9.11.0**
|