@smartledger/bsv 9.12.0 → 9.14.0

package/CHANGELOG.md

@@ -7,6 +7,62 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [9.14.0] - 2026-09-29
+
+### Added — `minDifficulty`, because a work floor in hashes invites a unit error that fails open
+
+`minWork` counts **hashes**. Difficulty is the unit a floor is actually quoted in: a real BSV
+header is "difficulty 2.6e10", not "1.1e20 hashes". The two are 4,295,032,833 apart, so reading
+one as the other sets a floor **4.3 billion times too low** — and it fails *open*, because the
+call keeps succeeding and nothing says the floor stopped meaning anything.
+
+That is not hypothetical. While comparing this library's cap with the BRC-220 reference
+implementation's floor, its `minDifficulty: 5e9` was read here as 5e9 *hashes* and reported as
+"difficulty 1.16, a twentieth of a billionth of a real header". The true figure is 5e9 ×
+4,295,032,833 ≈ **2.1e19** hashes, about a fifth of block 954784's 1.098e20 — a sound floor,
+misread by a factor of 4.3e9 in the direction that looks alarming rather than safe. The
+reference's API had the better name first.
+
+So `SPV.verifyTxInclusion` and `NotaryHash.verify` now take `minDifficulty` beside `minWork`:
+
+```js
+NotaryHash.verify(cert, { header, minDifficulty: '2.5e10' })  // difficulty, as quoted
+NotaryHash.verify(cert, { header, minWork: '1e20' })          // hashes, as counted
+```
+
+Exactly one of the two: passing both throws rather than leaving the caller to guess which
+applied. The conversion is exact — a fractional or exponent-form difficulty is expanded by
+moving the decimal point, never through a float — and `minDifficulty` also satisfies the 9.13.0
+notice, so a caller stating a policy in difficulty is not warned.
+
+## [9.13.0] - 2026-09-29
+
+### Deprecated — verifying an anchor with a header and no trust policy
+
+9.12.0 stopped a **free** forgery. It does not stop a **cheap** one: the default limit is
+difficulty 1, which costs about **4.3e9** double-SHA256 attempts — seconds on one consumer GPU,
+well under a second on an ASIC — while a real mainnet header carries about **1e20** (measured:
+`1.098e20` at block 954784's `bits` of `0x182afffe`, a factor of 2.6e10). So a caller whose only
+input is "a header" has proved inclusion in something that cost very little, unless the header
+came from a source it trusts.
+
+`NotaryHash.verify(certificate, { header })` now warns once when neither `minWork` nor
+`blockHashAtHeight` is given, and **10.0.0 will require one of them**. Per STABILITY.md this is
+marked in a minor and breaks in the major; nothing throws today, and `requirePow: false` is
+silent because none of it applies. There is no universally right default to pick instead:
+`minWork` depends on the chain and the application, and testnet would break under a mainnet
+floor.
+
+### Fixed — a `powLimit` or `minWork` passed as a BN was not range-checked
+
+`powLimit: BN(2^256)` admitted the very forgery the cap exists to refuse, because every target
+is below 2^256; `BN(0)` admitted nothing; a negative BN `minWork` passed any header. A BN
+`powLimit` must now be above zero and below 2^256, and a BN `minWork` must not be negative.
+Compact bits and decimal strings were already checked.
+
+Both found by an independent verification of the published 9.12.0 and of
+`smartledger-bsv-core`, which agreed on all 35 checks.
+
 ## [9.12.0] - 2026-09-29
 
 **A block header is no longer believed about the difficulty it declares.** A forged header cost

package/README.md

@@ -2,7 +2,7 @@
 
 Bitcoin SV library with an interpreter-verified script engine.
 
-[![Version](https://img.shields.io/badge/version-9.12.0-blue.svg)](https://www.npmjs.com/package/@smartledger/bsv)
+[![Version](https://img.shields.io/badge/version-9.14.0-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** | 1060KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@9.12.0/bsv.min.js` |
-| **bsv.bundle.js** | 1060KB | Everything in one file | `unpkg.com/@smartledger/bsv@9.12.0/bsv.bundle.js` |
+| **bsv.min.js** | 1062KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@9.14.0/bsv.min.js` |
+| **bsv.bundle.js** | 1062KB | Everything in one file | `unpkg.com/@smartledger/bsv@9.14.0/bsv.bundle.js` |
 
 ### **W3C Verifiable Credentials**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **🟢 bsv-didweb.min.js** | 166KB | **DID:web generation** | `unpkg.com/@smartledger/bsv@9.12.0/bsv-didweb.min.js` |
-| **🟢 bsv-vcjwt.min.js** | 166KB | **VC-JWT issue/verify** | `unpkg.com/@smartledger/bsv@9.12.0/bsv-vcjwt.min.js` |
-| **🟢 bsv-statuslist.min.js** | 256KB | **StatusList2021 revocation** | `unpkg.com/@smartledger/bsv@9.12.0/bsv-statuslist.min.js` |
-| **🟢 bsv-anchor.min.js** | 164KB | **BSV anchoring (hash-only)** | `unpkg.com/@smartledger/bsv@9.12.0/bsv-anchor.min.js` |
+| **🟢 bsv-didweb.min.js** | 166KB | **DID:web generation** | `unpkg.com/@smartledger/bsv@9.14.0/bsv-didweb.min.js` |
+| **🟢 bsv-vcjwt.min.js** | 166KB | **VC-JWT issue/verify** | `unpkg.com/@smartledger/bsv@9.14.0/bsv-vcjwt.min.js` |
+| **🟢 bsv-statuslist.min.js** | 256KB | **StatusList2021 revocation** | `unpkg.com/@smartledger/bsv@9.14.0/bsv-statuslist.min.js` |
+| **🟢 bsv-anchor.min.js** | 164KB | **BSV anchoring (hash-only)** | `unpkg.com/@smartledger/bsv@9.14.0/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.12.0/bsv-smartcontract.min.js` |
-| **bsv-covenant.min.js** | 35KB | Covenant operations | `unpkg.com/@smartledger/bsv@9.12.0/bsv-covenant.min.js` |
-| **bsv-script-helper.min.js** | 33KB | Custom script tools | `unpkg.com/@smartledger/bsv@9.12.0/bsv-script-helper.min.js` |
-| **bsv-security.min.js** | 32KB | Security enhancements | `unpkg.com/@smartledger/bsv@9.12.0/bsv-security.min.js` |
+| **bsv-smartcontract.min.js** | 141KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@9.14.0/bsv-smartcontract.min.js` |
+| **bsv-covenant.min.js** | 35KB | Covenant operations | `unpkg.com/@smartledger/bsv@9.14.0/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 33KB | Custom script tools | `unpkg.com/@smartledger/bsv@9.14.0/bsv-script-helper.min.js` |
+| **bsv-security.min.js** | 32KB | Security enhancements | `unpkg.com/@smartledger/bsv@9.14.0/bsv-security.min.js` |
 
 ### **Legal & Compliance**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-ltp.min.js** | 541KB | Legal Token Protocol | `unpkg.com/@smartledger/bsv@9.12.0/bsv-ltp.min.js` |
-| **bsv-gdaf.min.js** | 1060KB | Digital Identity & Attestation | `unpkg.com/@smartledger/bsv@9.12.0/bsv-gdaf.min.js` |
+| **bsv-ltp.min.js** | 541KB | Legal Token Protocol | `unpkg.com/@smartledger/bsv@9.14.0/bsv-ltp.min.js` |
+| **bsv-gdaf.min.js** | 1062KB | Digital Identity & Attestation | `unpkg.com/@smartledger/bsv@9.14.0/bsv-gdaf.min.js` |
 
 ### **Advanced Cryptography**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-shamir.min.js** | 177KB | Threshold Cryptography | `unpkg.com/@smartledger/bsv@9.12.0/bsv-shamir.min.js` |
+| **bsv-shamir.min.js** | 177KB | Threshold Cryptography | `unpkg.com/@smartledger/bsv@9.14.0/bsv-shamir.min.js` |
 
 ### **Utilities**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-ecies.min.js** | 137KB | Encryption | `unpkg.com/@smartledger/bsv@9.12.0/bsv-ecies.min.js` |
-| **bsv-message.min.js** | 34KB | Message signing | `unpkg.com/@smartledger/bsv@9.12.0/bsv-message.min.js` |
-| **bsv-mnemonic.min.js** | 320KB | HD wallets | `unpkg.com/@smartledger/bsv@9.12.0/bsv-mnemonic.min.js` |
+| **bsv-ecies.min.js** | 137KB | Encryption | `unpkg.com/@smartledger/bsv@9.14.0/bsv-ecies.min.js` |
+| **bsv-message.min.js** | 34KB | Message signing | `unpkg.com/@smartledger/bsv@9.14.0/bsv-message.min.js` |
+| **bsv-mnemonic.min.js** | 320KB | HD wallets | `unpkg.com/@smartledger/bsv@9.14.0/bsv-mnemonic.min.js` |
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@9.12.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@9.14.0/bsv.min.js"></script>
 <script>
   const key = bsv.PrivateKey.fromRandom()
 </script>
@@ -240,4 +240,4 @@ MIT
 
 ---
 
-**SmartLedger-BSV v9.12.0**
+**SmartLedger-BSV v9.14.0**