@smartledger/bsv 9.9.0 → 9.10.1

package/CHANGELOG.md

@@ -7,6 +7,73 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [9.10.1] - 2026-09-16
+
+**A patch: evaluating a script no longer rewrites it or the interpreter's shared boolean values.** No API change; consensus results are unchanged.
+
+### Fixed — evaluating a script could rewrite it, and corrupt `true` for every later script
+
+`OP_AND`, `OP_OR`, `OP_XOR` and `OP_INVERT` wrote their result into their operand, and
+`OP_NUM2BIN`/`OP_BIN2NUM` went through `_minimallyEncode`, which rewrote the last byte of
+its argument. An operand is not necessarily the interpreter's own memory: a push places the
+script chunk's buffer on the stack, `OP_SPLIT` returns views into its input, and boolean
+results are the shared `Interpreter.true` and `Interpreter.false`. So evaluation could:
+
+- **rewrite the script being evaluated**, including a buffer a caller passed to
+  `Script.fromBuffer`, and with it the script code a later signature covers;
+- **corrupt `Interpreter.true` for the rest of the process.** After
+  `OP_2 OP_2 OP_3 OP_WITHIN OP_INVERT`, every later `OP_EQUAL`, `OP_WITHIN` and
+  `OP_CHECKSIG` pushed `0xfe` instead of `0x01`; `OP_XOR` of two boolean results zeroed it.
+
+Each opcode now writes a new buffer. `test/script/in_place_mutation.js` fails 12 of 18 on
+the previous code. A fuzz of 20,000 random scripts found 58 that altered the script or the
+shared booleans before the fix, and none after. Consensus results are unchanged:
+conformance 452/452, SV vectors 1483/1483.
+
+### Docs
+
+- `docs/BRC220_CERTIFICATE_FIELDS_AMENDMENT.md` follows bsv-blockchain/BRCs#247 after review.
+  The first wording said DER "is not 64 bytes long", which is false: DER can be 64 bytes when
+  `r` and `s` are unusually short. The text now states the rule the reference implementation
+  and this library both apply: exactly 64 bytes is `r ‖ s`, and anything else must parse as
+  DER. The matching comment in `lib/notaryhash/suites.js` is corrected the same way; the
+  code already applied that rule.
+
+## [9.10.0] - 2026-09-11
+
+**NotaryHash refuses base64 that is not base64, can check a header's height, and its
+certificate fields are proposed for BRC-220.** Everything here is additive or refuses only
+malformed input: nothing that verified in 9.9.0 stops verifying.
+
+### Fixed — NotaryHash reads base64 strictly, and can check a header's height
+
+`Certificate.decodeBytes` refuses a base64 length that no byte string encodes, and padding
+anywhere but the end. `Buffer.from` drops a trailing character that cannot complete a byte,
+so `"AAAAA"` decoded to three bytes instead of failing — the same corruption-as-decoding
+that 9.9.0 already refused for characters outside the alphabet. Everything a writer
+produces, in either alphabet and with or without padding, is still accepted.
+
+`verify()` and `verifyAnchorSPV()` take an optional `height`. BRC-220 anchors a certificate
+in "the block header for `spv.blockHash` at `spv.blockHeight`", and an 80-byte header does
+not carry its height, so until now the height could not be checked at all. A caller that
+obtained the header at a known height passes it, and a mismatch fails the anchor. It is
+optional because requiring it would break every caller that holds only the header.
+
+### Docs
+
+- `docs/BRC220_CERTIFICATE_FIELDS_AMENDMENT.md`: a BRC-220 amendment defining the
+  certificate's field values as the reference implementation writes them, and two rules
+  for reading them. BRC-220 names the twelve required fields and defines none of their
+  values, which is how 8.3.0–9.8.0 and the reference came to be unable to read each
+  other's certificates. Filed as
+  [bsv-blockchain/BRCs#247](https://github.com/bsv-blockchain/BRCs/pull/247).
+  `test/notaryhash/fields_amendment.js` checks its examples against certificates the
+  reference produced, and checks that this library does what each reader rule says.
+- `docs/BRC220_BATCH_LEAF_AMENDMENT.md` says that `leafIndex` counts from 0, and how `i`
+  is written in the batch vector's preimages. Review of
+  [bsv-blockchain/BRCs#246](https://github.com/bsv-blockchain/BRCs/pull/246) asked for
+  both, and #246 now carries them too. The vector's values are unchanged.
+
 ## [9.9.0] - 2026-09-11
 
 **NotaryHash interoperates with the BRC-220 reference implementation, without breaking

package/README.md

@@ -2,7 +2,7 @@
 
 Bitcoin SV library with an interpreter-verified script engine.
 
-[![Version](https://img.shields.io/badge/version-9.9.0-blue.svg)](https://www.npmjs.com/package/@smartledger/bsv)
+[![Version](https://img.shields.io/badge/version-9.10.1-blue.svg)](https://www.npmjs.com/package/@smartledger/bsv)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Stability](https://img.shields.io/badge/9.x%20stable%20until-2027--09--01-brightgreen.svg)](STABILITY.md)
 
@@ -155,44 +155,44 @@ const bsv = require('@smartledger/bsv')                 // 128 modules
 ### **Core Modules**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv.min.js** | 1056KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@9.9.0/bsv.min.js` |
-| **bsv.bundle.js** | 1056KB | Everything in one file | `unpkg.com/@smartledger/bsv@9.9.0/bsv.bundle.js` |
+| **bsv.min.js** | 1056KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@9.10.1/bsv.min.js` |
+| **bsv.bundle.js** | 1056KB | Everything in one file | `unpkg.com/@smartledger/bsv@9.10.1/bsv.bundle.js` |
 
 ### **W3C Verifiable Credentials**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **🟢 bsv-didweb.min.js** | 166KB | **DID:web generation** | `unpkg.com/@smartledger/bsv@9.9.0/bsv-didweb.min.js` |
-| **🟢 bsv-vcjwt.min.js** | 166KB | **VC-JWT issue/verify** | `unpkg.com/@smartledger/bsv@9.9.0/bsv-vcjwt.min.js` |
-| **🟢 bsv-statuslist.min.js** | 256KB | **StatusList2021 revocation** | `unpkg.com/@smartledger/bsv@9.9.0/bsv-statuslist.min.js` |
-| **🟢 bsv-anchor.min.js** | 164KB | **BSV anchoring (hash-only)** | `unpkg.com/@smartledger/bsv@9.9.0/bsv-anchor.min.js` |
+| **🟢 bsv-didweb.min.js** | 166KB | **DID:web generation** | `unpkg.com/@smartledger/bsv@9.10.1/bsv-didweb.min.js` |
+| **🟢 bsv-vcjwt.min.js** | 166KB | **VC-JWT issue/verify** | `unpkg.com/@smartledger/bsv@9.10.1/bsv-vcjwt.min.js` |
+| **🟢 bsv-statuslist.min.js** | 256KB | **StatusList2021 revocation** | `unpkg.com/@smartledger/bsv@9.10.1/bsv-statuslist.min.js` |
+| **🟢 bsv-anchor.min.js** | 164KB | **BSV anchoring (hash-only)** | `unpkg.com/@smartledger/bsv@9.10.1/bsv-anchor.min.js` |
 
 ### **Smart Contract & Development**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-smartcontract.min.js** | 141KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@9.9.0/bsv-smartcontract.min.js` |
-| **bsv-covenant.min.js** | 35KB | Covenant operations | `unpkg.com/@smartledger/bsv@9.9.0/bsv-covenant.min.js` |
-| **bsv-script-helper.min.js** | 33KB | Custom script tools | `unpkg.com/@smartledger/bsv@9.9.0/bsv-script-helper.min.js` |
-| **bsv-security.min.js** | 32KB | Security enhancements | `unpkg.com/@smartledger/bsv@9.9.0/bsv-security.min.js` |
+| **bsv-smartcontract.min.js** | 141KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@9.10.1/bsv-smartcontract.min.js` |
+| **bsv-covenant.min.js** | 35KB | Covenant operations | `unpkg.com/@smartledger/bsv@9.10.1/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 33KB | Custom script tools | `unpkg.com/@smartledger/bsv@9.10.1/bsv-script-helper.min.js` |
+| **bsv-security.min.js** | 32KB | Security enhancements | `unpkg.com/@smartledger/bsv@9.10.1/bsv-security.min.js` |
 
 ### **Legal & Compliance**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-ltp.min.js** | 540KB | Legal Token Protocol | `unpkg.com/@smartledger/bsv@9.9.0/bsv-ltp.min.js` |
-| **bsv-gdaf.min.js** | 1056KB | Digital Identity & Attestation | `unpkg.com/@smartledger/bsv@9.9.0/bsv-gdaf.min.js` |
+| **bsv-ltp.min.js** | 540KB | Legal Token Protocol | `unpkg.com/@smartledger/bsv@9.10.1/bsv-ltp.min.js` |
+| **bsv-gdaf.min.js** | 1056KB | Digital Identity & Attestation | `unpkg.com/@smartledger/bsv@9.10.1/bsv-gdaf.min.js` |
 
 ### **Advanced Cryptography**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-shamir.min.js** | 177KB | Threshold Cryptography | `unpkg.com/@smartledger/bsv@9.9.0/bsv-shamir.min.js` |
+| **bsv-shamir.min.js** | 177KB | Threshold Cryptography | `unpkg.com/@smartledger/bsv@9.10.1/bsv-shamir.min.js` |
 
 ### **Utilities**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-ecies.min.js** | 137KB | Encryption | `unpkg.com/@smartledger/bsv@9.9.0/bsv-ecies.min.js` |
-| **bsv-message.min.js** | 34KB | Message signing | `unpkg.com/@smartledger/bsv@9.9.0/bsv-message.min.js` |
-| **bsv-mnemonic.min.js** | 320KB | HD wallets | `unpkg.com/@smartledger/bsv@9.9.0/bsv-mnemonic.min.js` |
+| **bsv-ecies.min.js** | 137KB | Encryption | `unpkg.com/@smartledger/bsv@9.10.1/bsv-ecies.min.js` |
+| **bsv-message.min.js** | 34KB | Message signing | `unpkg.com/@smartledger/bsv@9.10.1/bsv-message.min.js` |
+| **bsv-mnemonic.min.js** | 320KB | HD wallets | `unpkg.com/@smartledger/bsv@9.10.1/bsv-mnemonic.min.js` |
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@9.9.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@9.10.1/bsv.min.js"></script>
 <script>
   const key = bsv.PrivateKey.fromRandom()
 </script>
@@ -240,4 +240,4 @@ MIT
 
 ---
 
-**SmartLedger-BSV v9.9.0**
+**SmartLedger-BSV v9.10.1**