@smartledger/bsv 7.6.2 → 7.8.0

package/CHANGELOG.md

@@ -7,6 +7,121 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [7.8.0] - 2026-08-10
+
+`OP_LSHIFTNUM` / `OP_RSHIFTNUM` are implemented, and **7.6.0's fail-closed posture for
+their bytes is corrected**. Both come from reading the SV Node implementation
+([`src/script/interpreter.cpp`](https://github.com/bitcoin-sv/bitcoin-sv/blob/master/src/script/interpreter.cpp),
+with the arithmetic in `src/script/script_num.cpp` and `src/big_int.cpp`) rather than
+inferring from the one-sentence spec.
+
+### Fixed
+
+- **Bytes 182/183 are upgradable NOPs before Chronicle, not errors.** 7.6.0 made them
+  reject unconditionally, on the reasoning that refusing to validate is safer than
+  validating wrongly. The node does something else:
+
+  ```cpp
+  if(!utxo_after_chronicle)
+  {
+      if(IsDiscourageUpgradableNops(flags))
+          return SCRIPT_ERR_DISCOURAGE_UPGRADABLE_NOPS;
+      else
+          break;          // no-op
+  }
+  ```
+
+  So this library was rejecting scripts the network accepts — a false negative, which
+  is the mirror image of the defect 7.6.0 set out to fix rather than a cure for it. In
+  fairness to the original code, byte 182 behaving as a no-op was *correct* before
+  Chronicle; the real defect was that it would have stayed a no-op *after* activation,
+  silently skipping the shift. Two of the `BSV_DIVERGENCES` entries added in 7.6.0 are
+  removed as a result: this library now agrees with Bitcoin Core on those vectors again.
+
+### Added
+
+- **`OP_LSHIFTNUM` / `OP_RSHIFTNUM` under `SCRIPT_ENABLE_CHRONICLE`.** Every question
+  the spec left open is answered by the implementation:
+
+  - **Operand order** — `// (x n -- out)`: the shift *count* is on top, the value beneath.
+  - **Negative counts** — `if(n < 0) return SCRIPT_ERR_INVALID_NUMBER_RANGE`.
+  - **"Preserving sign"** — sign-magnitude, and the right shift **truncates toward
+    zero**: `"Mathematical division by 2^bit_shift, rounding toward zero ... For
+    negative values: n / 2^k = -((-n) >> k)"`. So `-5 1 OP_RSHIFTNUM` is **-2, not -3**;
+    a two's-complement arithmetic shift would floor. The bignum path agrees — it is
+    OpenSSL `BN_rshift` on a sign-magnitude value. This is the same convention as
+    `OP_DIV` and `OP_2DIV`, and there is a test asserting all three agree.
+  - **Oversized counts** — right shift past the bit length is `0` (not an error); left
+    shift raises overflow, bounded *before* shifting (`current_size + shift_bytes >
+    max_length`) so a huge count cannot allocate a huge number on its way to rejection.
+  - **Result encoding** — minimal, via the script-number encoder, bounded by the
+    script-number width.
+
+### Note on the conformance corpus
+
+The independent Chronicle corpus in `@smartledger/bsv-core` pins *that* library's
+fail-closed choice for these bytes, so it now reports 6 differences against this one —
+all of them cases where this library matches SV Node and the corpus does not, including
+a shrinking rather than growing set of divergences from Bitcoin Core. `CHRONICLE.md`
+there reaches the same conclusion 7.6.0 did and is equally out of date; the node source
+settles it.
+
+17 → 26 tests in `test/script/chronicle.js`, each mapped to a specific line of the C++.
+Suite 4629 → 4638.
+
+## [7.7.0] - 2026-08-10
+
+Completes the BSV **Chronicle** script surface. 7.6.0 fixed the opcode *numbering*
+so the reassigned bytes fail closed; this adds the behaviour behind an explicit
+`SCRIPT_ENABLE_CHRONICLE` flag.
+
+### Added
+
+- **`Interpreter.SCRIPT_ENABLE_CHRONICLE`** (`1 << 20`). Off by default — enabling it
+  changes script evaluation, so it is an opt-in exactly like the Monolith and Magnetic
+  flags.
+
+- **`OP_2MUL` / `OP_2DIV`**, restored behind the flag. Without it they remain
+  `SCRIPT_ERR_DISABLED_OPCODE`, and "disabled" is deliberately stronger than
+  "unimplemented": a disabled opcode fails the script even in an **unexecuted** branch,
+  which is why the gate lives in `isOpcodeDisabled` rather than the evaluation switch.
+  `OP_2DIV` truncates toward zero — `-5 OP_2DIV` is `-2`, not `-3` — so it agrees with
+  `x 2 OP_DIV`; pinned over negative and odd values, which is where a rounding change
+  would otherwise hide. (`bn.js` `shrn` is unusable here: it asserts on negatives.)
+
+- **`OP_VER` / `OP_VERIF` / `OP_VERNOTIF`**, behind the same flag. `OP_VER` pushes the
+  executing transaction's version. `OP_VERIF` is an `IF` whose condition is "top of
+  stack equals the transaction version", closed by `OP_ENDIF`; `OP_VERNOTIF` is its
+  negation.
+
+  Two details worth recording. Before Chronicle, `OP_VERIF`/`OP_VERNOTIF` are invalid
+  **even in an unexecuted branch** — a rule Bitcoin applies to no other opcode — so the
+  flag check sits deliberately *outside* the `fExec` guard, preserving it. And
+  `OP_VERIF` **pops** its operand, mirroring `OP_IF`: the spec describes the comparison
+  but not the stack effect, and an `IF` that left its condition behind would unbalance
+  every script using it. That is an inference, and it has its own test so a correction
+  surfaces as a failure.
+
+- **`Signature.SIGHASH_CHRONICLE`** (`0x20`), selecting the Original Transaction Digest
+  Algorithm. It **overrides** `SIGHASH_FORKID` rather than merely coexisting with it:
+  FORKID is set on essentially every BSV signature written since 2018, so a bit that
+  only applied when FORKID was absent could never select OTDA in practice. Gated on
+  `SCRIPT_ENABLE_CHRONICLE` because before the upgrade the `0x20` bit means nothing —
+  BIP-143 signatures already exist whose type byte happens to set it, and honouring it
+  unconditionally would silently reinterpret those as OTDA.
+
+### Verification
+
+17 new tests in `test/script/chronicle.js` pin both states: every feature above with
+the flag on, **and** the unchanged default with it off. Against the independent
+Chronicle conformance corpus in `@smartledger/bsv-core`, divergences fall **14 → 1**,
+and that one is Node echoing an assertion's source text (`assert(Buffer.isBuffer(buf))`
+vs `(Buffer.isBuffer(buf))`) — a difference in how the two codebases wrote the same
+check, not behaviour. Under the default comparison the corpus reports
+**PASS: 442/442**.
+
+Suite 4612 → 4629.
+
 ## [7.6.2] - 2026-08-10
 
 ### Changed

package/README.md

@@ -186,42 +186,42 @@ console.log('Status:', status) // 'revoked'
 ### **Core Modules**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv.min.js** | 1149KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@7.6.2/bsv.min.js` |
-| **bsv.bundle.js** | 1149KB | Everything in one file | `unpkg.com/@smartledger/bsv@7.6.2/bsv.bundle.js` |
+| **bsv.min.js** | 1149KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@7.8.0/bsv.min.js` |
+| **bsv.bundle.js** | 1149KB | Everything in one file | `unpkg.com/@smartledger/bsv@7.8.0/bsv.bundle.js` |
 
 ### **W3C Verifiable Credentials**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **🟢 bsv-didweb.min.js** | 315KB | **DID:web generation** | `unpkg.com/@smartledger/bsv@7.6.2/bsv-didweb.min.js` |
-| **🟢 bsv-vcjwt.min.js** | 315KB | **VC-JWT issue/verify** | `unpkg.com/@smartledger/bsv@7.6.2/bsv-vcjwt.min.js` |
-| **🟢 bsv-statuslist.min.js** | 415KB | **StatusList2021 revocation** | `unpkg.com/@smartledger/bsv@7.6.2/bsv-statuslist.min.js` |
-| **🟢 bsv-anchor.min.js** | 314KB | **BSV anchoring (hash-only)** | `unpkg.com/@smartledger/bsv@7.6.2/bsv-anchor.min.js` |
+| **🟢 bsv-didweb.min.js** | 315KB | **DID:web generation** | `unpkg.com/@smartledger/bsv@7.8.0/bsv-didweb.min.js` |
+| **🟢 bsv-vcjwt.min.js** | 315KB | **VC-JWT issue/verify** | `unpkg.com/@smartledger/bsv@7.8.0/bsv-vcjwt.min.js` |
+| **🟢 bsv-statuslist.min.js** | 415KB | **StatusList2021 revocation** | `unpkg.com/@smartledger/bsv@7.8.0/bsv-statuslist.min.js` |
+| **🟢 bsv-anchor.min.js** | 314KB | **BSV anchoring (hash-only)** | `unpkg.com/@smartledger/bsv@7.8.0/bsv-anchor.min.js` |
 
 ### **Smart Contract & Development**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-smartcontract.min.js** | 873KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@7.6.2/bsv-smartcontract.min.js` |
-| **bsv-covenant.min.js** | 873KB | Covenant operations | `unpkg.com/@smartledger/bsv@7.6.2/bsv-covenant.min.js` |
-| **bsv-script-helper.min.js** | 30KB | Custom script tools | `unpkg.com/@smartledger/bsv@7.6.2/bsv-script-helper.min.js` |
-| **bsv-security.min.js** | 30KB | Security enhancements | `unpkg.com/@smartledger/bsv@7.6.2/bsv-security.min.js` |
+| **bsv-smartcontract.min.js** | 873KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@7.8.0/bsv-smartcontract.min.js` |
+| **bsv-covenant.min.js** | 873KB | Covenant operations | `unpkg.com/@smartledger/bsv@7.8.0/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 30KB | Custom script tools | `unpkg.com/@smartledger/bsv@7.8.0/bsv-script-helper.min.js` |
+| **bsv-security.min.js** | 30KB | Security enhancements | `unpkg.com/@smartledger/bsv@7.8.0/bsv-security.min.js` |
 
 ### **Legal & Compliance**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-ltp.min.js** | 1149KB | Legal Token Protocol | `unpkg.com/@smartledger/bsv@7.6.2/bsv-ltp.min.js` |
-| **bsv-gdaf.min.js** | 1149KB | Digital Identity & Attestation | `unpkg.com/@smartledger/bsv@7.6.2/bsv-gdaf.min.js` |
+| **bsv-ltp.min.js** | 1149KB | Legal Token Protocol | `unpkg.com/@smartledger/bsv@7.8.0/bsv-ltp.min.js` |
+| **bsv-gdaf.min.js** | 1149KB | Digital Identity & Attestation | `unpkg.com/@smartledger/bsv@7.8.0/bsv-gdaf.min.js` |
 
 ### **Advanced Cryptography**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-shamir.min.js** | 353KB | Threshold Cryptography | `unpkg.com/@smartledger/bsv@7.6.2/bsv-shamir.min.js` |
+| **bsv-shamir.min.js** | 353KB | Threshold Cryptography | `unpkg.com/@smartledger/bsv@7.8.0/bsv-shamir.min.js` |
 
 ### **Utilities**
 | Module | Size | Use Case | CDN |
 |--------|------|----------|-----|
-| **bsv-ecies.min.js** | 79KB | Encryption | `unpkg.com/@smartledger/bsv@7.6.2/bsv-ecies.min.js` |
-| **bsv-message.min.js** | 30KB | Message signing | `unpkg.com/@smartledger/bsv@7.6.2/bsv-message.min.js` |
-| **bsv-mnemonic.min.js** | 592KB | HD wallets | `unpkg.com/@smartledger/bsv@7.6.2/bsv-mnemonic.min.js` |
+| **bsv-ecies.min.js** | 79KB | Encryption | `unpkg.com/@smartledger/bsv@7.8.0/bsv-ecies.min.js` |
+| **bsv-message.min.js** | 30KB | Message signing | `unpkg.com/@smartledger/bsv@7.8.0/bsv-message.min.js` |
+| **bsv-mnemonic.min.js** | 592KB | HD wallets | `unpkg.com/@smartledger/bsv@7.8.0/bsv-mnemonic.min.js` |
 
 ## ⚡ **2-Minute Quick Start**
 
@@ -232,7 +232,7 @@ Get started with Bitcoin SV development in under 2 minutes:
 npm install @smartledger/bsv
 
 # Or include in HTML
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv.min.js"></script>
 ```
 
 > **🔒 v5.0.0 (production hardening — has breaking changes):** Shamir secret
@@ -332,8 +332,8 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
 
 ### 🔧 **Basic Development** (~1.2MB total)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv-script-helper.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv-script-helper.min.js"></script>
 <script>
   const privateKey = new bsv.PrivateKey();
   const utxos = new bsv.SmartContract.UTXOGenerator().createRealUTXOs(2, 100000);
@@ -342,9 +342,9 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
 
 ### 🔒 **Smart Contract Development** (~2.8MB total — each bundle re-embeds core BSV)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv-covenant.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv-smartcontract.min.js"></script>
 <script>
   const covenant = bsv.SmartContract.createCovenantBuilder()
     .extractField('amount').push(50000).greaterThanOrEqual().verify().build();
@@ -354,9 +354,9 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
 
 ### 🆕 **Legal & Identity Development** (~3.4MB total — each bundle re-embeds core BSV)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv-ltp.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv-gdaf.min.js"></script>
 <script>
   // Legal Token Protocol
   const propertyToken = bsv.createPropertyToken({
@@ -370,9 +370,9 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
 
 ### 🆕 **Security & Cryptography** (~1.5MB total)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv-security.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv-shamir.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv-security.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv-shamir.min.js"></script>
 <script>
   // Threshold Cryptography
   const shares = bsv.splitSecret('my_secret_key', 5, 3); // 5 shares, 3 needed
@@ -384,7 +384,7 @@ const covenant = bsv.SmartContract.createCovenantBuilder()
 
 ### 🎯 **Everything Bundle** (~1.1MB)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv.bundle.js"></script>
 <script>
   // Everything available immediately
   const shares = bsv.splitSecret('secret', 5, 3);           // Shamir Secret Sharing
@@ -494,8 +494,8 @@ const contractTx = covenant.createCovenantTransaction({
 
 #### 1. **Minimal Setup** - Core + Script Helper (~1.2MB)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv-script-helper.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv-script-helper.min.js"></script>
 <script>
   const tx = new bsv.Transaction();
   const sig = bsvScriptHelper.createSignature(tx, privateKey, 0, script, satoshis);
@@ -504,9 +504,9 @@ const contractTx = covenant.createCovenantTransaction({
 
 #### 2. **DeFi Development** - Core + Covenants + Debug (~2.8MB — each bundle re-embeds core BSV)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv-covenant.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv-smartcontract.min.js"></script>
 <script>
   const covenant = new bsvCovenant.CovenantInterface();
   const debugInfo = SmartContract.interpretScript(script);
@@ -516,8 +516,8 @@ const contractTx = covenant.createCovenantTransaction({
 
 #### 3. **Security First** - Core + Enhanced Security (~1.2MB)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv-security.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv-security.min.js"></script>
 <script>
   const verified = bsvSecurity.SmartVerify.verify(signature, hash, publicKey);
   const enhanced = bsvSecurity.EllipticFixed.createSignature(privateKey, hash);
@@ -526,7 +526,7 @@ const contractTx = covenant.createCovenantTransaction({
 
 #### 4. **Everything Bundle** - One File Solution (~1.1MB)
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.6.2/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.0/bsv.bundle.js"></script>
 <script>
   // Everything available under bsv namespace
   const keys = bsv.SmartLedgerBundle.generateKeys();
@@ -834,7 +834,7 @@ const timelockScript = helper.createTimelockScript(
 
 See the **[16 Loading Options](#-16-loading-options---choose-your-approach)**
 table near the top for the full list of bundles with current sizes and
-canonical `unpkg.com/@smartledger/bsv@7.6.2/...` URLs.
+canonical `unpkg.com/@smartledger/bsv@7.8.0/...` URLs.
 
 ## 🔐 Security