@smartledger/bsv 7.7.1 → 7.8.1

package/docs/MODULE_REFERENCE_COMPLETE.md

@@ -55,19 +55,19 @@ Three advanced modules totaling **~2.7MB** of functionality:
 - **Purpose**: Threshold cryptography for secure secret distribution
 - **Use Cases**: Backup keys, multi-party security, key recovery
 - **Features**: Split secrets into N shares, require M to reconstruct
-- **CDN**: `unpkg.com/@smartledger/bsv@7.7.1/bsv-shamir.min.js`
+- **CDN**: `unpkg.com/@smartledger/bsv@7.8.1/bsv-shamir.min.js`
 
 #### **🌐 Global Digital Attestation Framework - GDAF (1184KB)**  
 - **Purpose**: W3C Verifiable Credentials and decentralized identity
 - **Use Cases**: Identity verification, attestations, zero-knowledge proofs
 - **Features**: DID creation, credential issuance, selective disclosure
-- **CDN**: `unpkg.com/@smartledger/bsv@7.7.1/bsv-gdaf.min.js`
+- **CDN**: `unpkg.com/@smartledger/bsv@7.8.1/bsv-gdaf.min.js`
 
 #### **⚖️ Legal Token Protocol - LTP (1184KB)**
 - **Purpose**: Legal compliance framework for tokenized assets
 - **Use Cases**: Property rights, obligations, compliant tokenization  
 - **Features**: Legal primitives, compliance checking, attestation anchoring
-- **CDN**: `unpkg.com/@smartledger/bsv@7.7.1/bsv-ltp.min.js`
+- **CDN**: `unpkg.com/@smartledger/bsv@7.8.1/bsv-ltp.min.js`
 
 ### **2. Incorrect File Sizes in Documentation**
 
@@ -81,18 +81,18 @@ Three advanced modules totaling **~2.7MB** of functionality:
 
 | Module | Size | Use Case | CDN Link |
 |--------|------|----------|----------|
-| **bsv.min.js** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js` |
-| **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@7.7.1/bsv.bundle.js` |
-| **bsv-smartcontract.min.js** | 937KB | Covenant development | `unpkg.com/@smartledger/bsv@7.7.1/bsv-smartcontract.min.js` |
-| **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@7.7.1/bsv-covenant.min.js` |
-| **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@7.7.1/bsv-script-helper.min.js` |
-| **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@7.7.1/bsv-security.min.js` |
-| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@7.7.1/bsv-ecies.min.js` |
-| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@7.7.1/bsv-message.min.js` |
-| **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@7.7.1/bsv-mnemonic.min.js` |
-| **🆕 bsv-shamir.min.js** | 432KB | **Secret sharing** | `unpkg.com/@smartledger/bsv@7.7.1/bsv-shamir.min.js` |
-| **🆕 bsv-gdaf.min.js** | 1184KB | **Digital attestation** | `unpkg.com/@smartledger/bsv@7.7.1/bsv-gdaf.min.js` |
-| **🆕 bsv-ltp.min.js** | 1184KB | **Legal tokens** | `unpkg.com/@smartledger/bsv@7.7.1/bsv-ltp.min.js` |
+| **bsv.min.js** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js` |
+| **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@7.8.1/bsv.bundle.js` |
+| **bsv-smartcontract.min.js** | 937KB | Covenant development | `unpkg.com/@smartledger/bsv@7.8.1/bsv-smartcontract.min.js` |
+| **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@7.8.1/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@7.8.1/bsv-script-helper.min.js` |
+| **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@7.8.1/bsv-security.min.js` |
+| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@7.8.1/bsv-ecies.min.js` |
+| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@7.8.1/bsv-message.min.js` |
+| **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@7.8.1/bsv-mnemonic.min.js` |
+| **🆕 bsv-shamir.min.js** | 432KB | **Secret sharing** | `unpkg.com/@smartledger/bsv@7.8.1/bsv-shamir.min.js` |
+| **🆕 bsv-gdaf.min.js** | 1184KB | **Digital attestation** | `unpkg.com/@smartledger/bsv@7.8.1/bsv-gdaf.min.js` |
+| **🆕 bsv-ltp.min.js** | 1184KB | **Legal tokens** | `unpkg.com/@smartledger/bsv@7.8.1/bsv-ltp.min.js` |
 
 ## 🎯 **Updated Usage Examples**
 
@@ -100,22 +100,22 @@ Three advanced modules totaling **~2.7MB** of functionality:
 
 #### **1. Basic Development (~963KB)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-script-helper.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-script-helper.min.js"></script>
 ```
 
 #### **2. Smart Contract Development (~2.7MB — each bundle re-embeds core BSV)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-covenant.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-smartcontract.min.js"></script>
 ```
 
 #### **3. 🆕 Legal & Compliance Development (~3.2MB — each bundle re-embeds core BSV)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-ltp.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-gdaf.min.js"></script>
 <script>
   // Legal Token Protocol
   const legalToken = bsv.createLegalToken({
@@ -132,9 +132,9 @@ Three advanced modules totaling **~2.7MB** of functionality:
 
 #### **4. 🆕 Security & Cryptography (~1.4MB)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-security.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-shamir.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-security.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-shamir.min.js"></script>
 <script>
   // Shamir Secret Sharing
   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:
 
 #### **5. Everything Bundle (937KB)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.bundle.js"></script>
 <script>
   // Everything available immediately
   const shares = bsv.splitSecret('secret', 5, 3);

package/docs/advanced/UTXO_MANAGER_GUIDE.md

@@ -722,7 +722,7 @@ interface UTXO {
 <html>
 <head>
     <title>UTXO Manager Demo</title>
-    <script src="https://cdn.jsdelivr.net/npm/@smartledger/bsv@7.7.1/bsv.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@smartledger/bsv@7.8.1/bsv.min.js"></script>
 </head>
 <body>
     <script>

package/docs/getting-started/INSTALLATION.md

@@ -48,7 +48,7 @@ const tx: Transaction = new Transaction();
 #### **Core Library Only (937KB)**
 For basic Bitcoin SV operations:
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js"></script>
 <script>
   const privateKey = new bsv.PrivateKey();
   const address = privateKey.toAddress();
@@ -58,7 +58,7 @@ For basic Bitcoin SV operations:
 #### **Complete Bundle (937KB)**  
 Everything in one file:
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.bundle.js"></script>
 <script>
   // All features available immediately
   const shares = bsv.splitSecret('secret', 5, 3);
@@ -71,9 +71,9 @@ Everything in one file:
 
 #### **Smart Contract Development (~2.7MB total — each bundle is self-contained and re-embeds core BSV)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-covenant.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-smartcontract.min.js"></script>
 <script>
   const covenant = bsv.SmartContract.createCovenantBuilder()
     .extractField('amount').push(50000).greaterThanOrEqual().build();
@@ -82,9 +82,9 @@ Everything in one file:
 
 #### **Legal & Identity Development (~3.2MB total — each bundle is self-contained and re-embeds core BSV)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-ltp.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-gdaf.min.js"></script>
 <script>
   // Legal Token Protocol
   const propertyToken = bsv.createPropertyToken({
@@ -98,9 +98,9 @@ Everything in one file:
 
 #### **Security & Cryptography (~1.4MB total — each bundle is self-contained and re-embeds core BSV)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-security.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-shamir.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-security.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-shamir.min.js"></script>
 <script>
   // Threshold Cryptography
   const shares = bsv.splitSecret('my_secret_key', 5, 3);
@@ -114,18 +114,18 @@ Everything in one file:
 
 | Module | Size | Purpose | CDN Link |
 |--------|------|---------|----------|
-| **bsv.min.js** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js` |
-| **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@7.7.1/bsv.bundle.js` |
-| **bsv-smartcontract.min.js** | 937KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@7.7.1/bsv-smartcontract.min.js` |
-| **bsv-ltp.min.js** | 1184KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@7.7.1/bsv-ltp.min.js` |
-| **bsv-gdaf.min.js** | 1184KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@7.7.1/bsv-gdaf.min.js` |
-| **bsv-shamir.min.js** | 432KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@7.7.1/bsv-shamir.min.js` |
-| **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@7.7.1/bsv-security.min.js` |
-| **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@7.7.1/bsv-mnemonic.min.js` |
-| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@7.7.1/bsv-ecies.min.js` |
-| **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@7.7.1/bsv-covenant.min.js` |
-| **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@7.7.1/bsv-script-helper.min.js` |
-| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@7.7.1/bsv-message.min.js` |
+| **bsv.min.js** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js` |
+| **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@7.8.1/bsv.bundle.js` |
+| **bsv-smartcontract.min.js** | 937KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@7.8.1/bsv-smartcontract.min.js` |
+| **bsv-ltp.min.js** | 1184KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@7.8.1/bsv-ltp.min.js` |
+| **bsv-gdaf.min.js** | 1184KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@7.8.1/bsv-gdaf.min.js` |
+| **bsv-shamir.min.js** | 432KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@7.8.1/bsv-shamir.min.js` |
+| **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@7.8.1/bsv-security.min.js` |
+| **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@7.8.1/bsv-mnemonic.min.js` |
+| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@7.8.1/bsv-ecies.min.js` |
+| **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@7.8.1/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@7.8.1/bsv-script-helper.min.js` |
+| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@7.8.1/bsv-message.min.js` |
 
 ## ⚙️ **Development Environment Setup**
 

package/docs/getting-started/QUICK_START.md

@@ -14,10 +14,10 @@ npm install @smartledger/bsv
 ### Browser CDN (Instant)
 ```html
 <!-- Core library (937KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js"></script>
 
 <!-- Everything included (937KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.bundle.js"></script>
 ```
 
 ## 💰 **Your First Transaction (60 seconds)**
@@ -127,19 +127,19 @@ SmartLedger-BSV offers 12 different loading options - use only what you need:
 
 ```html
 <!-- Core BSV only (937KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js"></script>
 
 <!-- Smart contracts (937KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-smartcontract.min.js"></script>
 
 <!-- Legal tokens (1.16MB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-ltp.min.js"></script>
 
 <!-- Digital identity (1.16MB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-gdaf.min.js"></script>
 
 <!-- Everything (937KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.bundle.js"></script>
 ```
 
 ## ⚡ **Key Advantages**

package/docs/migration/FROM_BSV_1_5_6.md

@@ -159,17 +159,17 @@ const recovered = bsv.reconstructSecret([shares[0], shares[2], shares[4]]);
 ### **New Modular Options** 
 ```html
 <!-- Core compatibility (same size as bsv@1.5.6) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.min.js"></script>
 
 <!-- Add smart contracts when ready -->
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-smartcontract.min.js"></script>
 
 <!-- Add advanced features as needed -->
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-ltp.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv-gdaf.min.js"></script>
 
 <!-- Everything in one file -->
-<script src="https://unpkg.com/@smartledger/bsv@7.7.1/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.8.1/bsv.bundle.js"></script>
 ```
 
 ## 🔍 **Testing Your Migration**

package/lib/script/interpreter.js

@@ -965,6 +965,84 @@ Interpreter.prototype.step = function () {
         }
         break
 
+      case Opcode.OP_LSHIFTNUM:
+      case Opcode.OP_RSHIFTNUM:
+        // Chronicle numeric shifts, ported from SV Node's src/script/interpreter.cpp.
+        //
+        // Before Chronicle activates for the UTXO these bytes are UPGRADABLE NOPS on
+        // the network, not errors — the node does exactly this:
+        //
+        //   if(!utxo_after_chronicle) {
+        //     if(IsDiscourageUpgradableNops(flags))
+        //       return SCRIPT_ERR_DISCOURAGE_UPGRADABLE_NOPS;
+        //     else break;
+        //   }
+        //
+        // Rejecting them outright would make this library refuse scripts the network
+        // accepts, which is the mirror of the bug that made them silently succeed.
+        if ((this.flags & Interpreter.SCRIPT_ENABLE_CHRONICLE) === 0) {
+          if (this.flags & Interpreter.SCRIPT_VERIFY_DISCOURAGE_UPGRADABLE_NOPS) {
+            this.errstr = 'SCRIPT_ERR_DISCOURAGE_UPGRADABLE_NOPS'
+            return false
+          }
+          break
+        }
+
+        // (x n -- out): the shift COUNT is on top, the value beneath.
+        if (this.stack.length < 2) {
+          this.errstr = 'SCRIPT_ERR_INVALID_STACK_OPERATION'
+          return false
+        }
+        var maxNumSize = Interpreter.MAXIMUM_ELEMENT_SIZE
+        var shiftBn = BN.fromScriptNumBuffer(stacktop(-1), fRequireMinimal, maxNumSize)
+        if (shiftBn.isNeg()) {
+          this.errstr = 'SCRIPT_ERR_INVALID_NUMBER_RANGE'
+          return false
+        }
+        this.stack.pop()
+        var valueBn = BN.fromScriptNumBuffer(stacktop(-1), fRequireMinimal, maxNumSize)
+        this.stack.pop()
+
+        var shiftBy = shiftBn.toNumber()
+        var negative = valueBn.isNeg()
+        // Shift the MAGNITUDE and carry the sign. That is what "preserving sign"
+        // means: CScriptNum is sign-magnitude (its bignum path is OpenSSL BN_lshift /
+        // BN_rshift), and the int64 path spells the same thing out —
+        //   "Mathematical division by 2^bit_shift, rounding toward zero ...
+        //    For negative values: n / 2^k = -((-n) >> k)"
+        // so -5 RSHIFTNUM 1 is -2, NOT -3. An arithmetic (two's-complement) shift
+        // would floor to -3; this is division truncating toward zero, matching
+        // OP_DIV and OP_2DIV. bn.js shrn/shln assert on negatives, so operating on
+        // abs() is required anyway.
+        var magnitude = valueBn.abs()
+        var shifted
+        if (opcodenum === Opcode.OP_LSHIFTNUM) {
+          // Bound the result BEFORE shifting, exactly as CScriptNum does
+          // (current_size + shift_bytes > max_length), so an enormous count cannot
+          // allocate an enormous number on the way to being rejected.
+          var currentSize = valueBn.toScriptNumBuffer().length
+          if (currentSize + Math.floor(shiftBy / 8) > maxNumSize) {
+            this.errstr = 'SCRIPT_ERR_SCRIPTNUM_OVERFLOW'
+            return false
+          }
+          shifted = magnitude.shln(shiftBy)
+        } else {
+          // Right-shifting by at least the bit length is zero. Checking that first
+          // keeps an arbitrarily large count cheap and matches the node, whose
+          // int64 path returns 0 for counts >= 64 and whose bignum path reaches the
+          // same value through BN_rshift.
+          shifted = shiftBy >= magnitude.bitLength() ? new BN(0) : magnitude.shrn(shiftBy)
+        }
+        if (negative && !shifted.isZero()) {
+          shifted = shifted.neg()
+        }
+        if (shifted.toScriptNumBuffer().length > maxNumSize) {
+          this.errstr = 'SCRIPT_ERR_SCRIPTNUM_OVERFLOW'
+          return false
+        }
+        this.stack.push(shifted.toScriptNumBuffer())
+        break
+
       case Opcode.OP_VER:
         // Chronicle: pushes the executing transaction's version.
         if ((this.flags & Interpreter.SCRIPT_ENABLE_CHRONICLE) === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartledger/bsv",
-  "version": "7.7.1",
+  "version": "7.8.1",
   "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.",
   "author": "SmartLedger Technology <hello@smartledger.technology> (https://smartledger.technology)",
   "homepage": "https://github.com/codenlighten/smartledger-bsv#readme",

package/test/script/chronicle.js

@@ -164,6 +164,102 @@ describe('Chronicle script surface', function () {
     })
   })
 
+  // Ported from SV Node src/script/interpreter.cpp (OP_LSHIFTNUM / OP_RSHIFTNUM) and
+  // the CScriptNum / bsv::bint arithmetic behind it. Each case below corresponds to a
+  // specific line of that implementation, so a divergence shows up as a named failure.
+  describe('OP_LSHIFTNUM / OP_RSHIFTNUM', function () {
+    // Push x then n then the opcode: the node's comment is literally `(x n -- out)`,
+    // so the COUNT is on top.
+    function shift (x, n, op, flags) {
+      return run(function (s) {
+        s.add(new BN(x).toScriptNumBuffer()).add(new BN(n).toScriptNumBuffer()).add(op)
+      }, { flags: flags == null ? CHRONICLE : flags })
+    }
+    function value (x, n, op) {
+      var r = shift(x, n, op)
+      return r.stack[r.stack.length - 1]
+    }
+    // A zero result makes the script fail EVAL_FALSE, so compare against OP_0 instead.
+    function isZero (x, n, op) {
+      return run(function (s) {
+        s.add(new BN(x).toScriptNumBuffer()).add(new BN(n).toScriptNumBuffer()).add(op)
+          .add(Opcode.OP_0).add(Opcode.OP_EQUAL)
+      }).verified
+    }
+
+    it('are upgradable NOPs before Chronicle, as the node has them', function () {
+      // if(!utxo_after_chronicle) { ... else break; }  — a no-op, NOT an error.
+      // Rejecting here would refuse scripts the network accepts.
+      var r = shift(8, 1, Opcode.OP_LSHIFTNUM, 0)
+      r.verified.should.equal(true)
+      r.stack.should.deep.equal(['8', '1']) // untouched: no shift, nothing popped
+    })
+
+    it('honour DISCOURAGE_UPGRADABLE_NOPS before Chronicle', function () {
+      var r = shift(8, 1, Opcode.OP_LSHIFTNUM, Interpreter.SCRIPT_VERIFY_DISCOURAGE_UPGRADABLE_NOPS)
+      r.verified.should.equal(false)
+      r.errstr.should.match(/DISCOURAGE_UPGRADABLE_NOPS/)
+    })
+
+    it('left shift multiplies by 2^n, carrying the sign', function () {
+      value(1, 4, Opcode.OP_LSHIFTNUM).should.equal('16')
+      value(3, 3, Opcode.OP_LSHIFTNUM).should.equal('24')
+      value(1, 0, Opcode.OP_LSHIFTNUM).should.equal('1')
+      value(-1, 4, Opcode.OP_LSHIFTNUM).should.equal('-16')
+      value(-3, 3, Opcode.OP_LSHIFTNUM).should.equal('-24')
+    })
+
+    it('right shift TRUNCATES TOWARD ZERO, which is the whole of "preserving sign"', function () {
+      // The node spells this out: "Mathematical division by 2^bit_shift, rounding
+      // toward zero ... For negative values: n / 2^k = -((-n) >> k)". A two's
+      // complement arithmetic shift would FLOOR instead, giving -3 and -4 here.
+      value(-5, 1, Opcode.OP_RSHIFTNUM).should.equal('-2')
+      value(-7, 1, Opcode.OP_RSHIFTNUM).should.equal('-3')
+      value(5, 1, Opcode.OP_RSHIFTNUM).should.equal('2')
+      value(-1000, 3, Opcode.OP_RSHIFTNUM).should.equal('-125')
+    })
+
+    it('agrees with OP_DIV by 2^n, the same convention as OP_2DIV', function () {
+      [5, -5, 7, -7, 1000, -1000].forEach(function (x) {
+        var viaShift = value(x, 1, Opcode.OP_RSHIFTNUM)
+        var viaDiv = run(function (s) {
+          s.add(new BN(x).toScriptNumBuffer()).add(new BN(2).toScriptNumBuffer()).add(Opcode.OP_DIV)
+        })
+        viaShift.should.equal(viaDiv.stack[viaDiv.stack.length - 1])
+      })
+    })
+
+    it('rejects a negative shift count', function () {
+      // if(n < 0) return SCRIPT_ERR_INVALID_NUMBER_RANGE
+      ;[Opcode.OP_LSHIFTNUM, Opcode.OP_RSHIFTNUM].forEach(function (op) {
+        var r = shift(8, -1, op)
+        r.verified.should.equal(false)
+        r.errstr.should.match(/INVALID_NUMBER_RANGE/)
+      })
+    })
+
+    it('right shift past the bit length is zero, not an error', function () {
+      isZero(5, 1000, Opcode.OP_RSHIFTNUM).should.equal(true)
+      isZero(-5, 1000, Opcode.OP_RSHIFTNUM).should.equal(true) // and no negative zero
+      isZero(1, 1, Opcode.OP_RSHIFTNUM).should.equal(true)
+      isZero(-1, 1, Opcode.OP_RSHIFTNUM).should.equal(true)
+    })
+
+    it('left shift overflows rather than growing without bound', function () {
+      // CScriptNum bounds this BEFORE shifting (current_size + shift_bytes >
+      // max_length), so a huge count cannot allocate a huge number first.
+      var r = shift(5, 1000, Opcode.OP_LSHIFTNUM)
+      r.verified.should.equal(false)
+      r.errstr.should.match(/OVERFLOW/)
+    })
+
+    it('fails on a short stack', function () {
+      var r = run(function (s) { s.add(new BN(1).toScriptNumBuffer()).add(Opcode.OP_LSHIFTNUM) })
+      r.verified.should.equal(false)
+      r.errstr.should.match(/INVALID_STACK_OPERATION/)
+    })
+  })
+
   describe('SIGHASH_CHRONICLE selects the original digest algorithm', function () {
     function fixture () {
       var key = bsv.PrivateKey.fromBuffer(Buffer.alloc(32, 5))

package/test/script/interpreter.js

@@ -643,10 +643,9 @@ describe('Interpreter', function () {
   //  - Chronicle reassigned 0xb3-0xb7 to OP_SUBSTR/OP_LEFT/OP_RIGHT/OP_LSHIFTNUM/
   //    OP_RSHIFTNUM, so Core's NOP4..NOP8 no longer exist as no-ops. Vectors that
   //    expect those bytes to do nothing now fail here: 0xb3-0xb5 consume stack as
-  //    string ops (INVALID_STACK_OPERATION), and 0xb6/0xb7 are rejected outright
-  //    (BAD_OPCODE) because the shift SEMANTICS are deliberately unimplemented —
-  //    the spec underdetermines them, and validating wrongly is worse than
-  //    refusing. This is a real consensus divergence from Core, not a quirk.
+  //    string ops (INVALID_STACK_OPERATION). 0xb6/0xb7 are NOT divergent: they are
+  //    upgradable NOPs until Chronicle activates, exactly as in SV Node and Core,
+  //    and only perform a shift under SCRIPT_ENABLE_CHRONICLE.
   //    (0xba is no longer a NOP either; it is unassigned, which now AGREES with
   //    Core, so its former override has been removed.)
   var BSV_DIVERGENCES = {
@@ -670,11 +669,7 @@ describe('Interpreter', function () {
     "'NOP_1_to_10' NOP1 CHECKLOCKTIMEVERIFY CHECKSEQUENCEVERIFY NOP4 NOP5 NOP6 NOP7 NOP8 NOP9 NOP10|'NOP_1_to_10' EQUAL|P2SH,STRICTENC": 'SCRIPT_ERR_INVALID_STACK_OPERATION',
     'NOP|NOP4 1|P2SH,STRICTENC': 'SCRIPT_ERR_INVALID_STACK_OPERATION',
     'NOP|NOP5 1|P2SH,STRICTENC': 'SCRIPT_ERR_INVALID_STACK_OPERATION',
-    'NOP|NOP6 1|P2SH,STRICTENC': 'SCRIPT_ERR_INVALID_STACK_OPERATION',
-    'NOP|NOP7 1|P2SH,STRICTENC': 'SCRIPT_ERR_BAD_OPCODE',
-    'NOP|NOP8 1|P2SH,STRICTENC': 'SCRIPT_ERR_BAD_OPCODE',
-    '0x47 0x3044022018a2a81a93add5cb5f5da76305718e4ea66045ec4888b28d84cb22fae7f4645b02201e6daa5ed5d2e4b2b2027cf7ffd43d8d9844dd49f74ef86899ec8e669dfd39aa01 NOP8 0x23 0x2103363d90d447b00c9c99ceac05b6262ee053441c7e55552ffe526bad8f83ff4640ac|HASH160 0x14 0x215640c2f72f0d16b4eced26762035a42ffed39a EQUAL|': 'SCRIPT_ERR_BAD_OPCODE',
-    '0x47 0x304402203e4516da7253cf068effec6b95c41221c0cf3a8e6ccb8cbf1725b562e9afde2c022054e1c258c2981cdfba5df1f46661fb6541c44f77ca0092f3600331abfffb125101 NOP8|0x21 0x03363d90d447b00c9c99ceac05b6262ee053441c7e55552ffe526bad8f83ff4640 CHECKSIG|': 'SCRIPT_ERR_BAD_OPCODE'
+    'NOP|NOP6 1|P2SH,STRICTENC': 'SCRIPT_ERR_INVALID_STACK_OPERATION'
   }
 
   describe('bitcoind script evaluation fixtures', function () {

package/version.js

@@ -1,3 +1,3 @@
 'use strict'
 // GENERATED by scripts/sync-version.js on `npm version` — do not edit.
-module.exports = '7.7.1'
+module.exports = '7.8.1'