@smartledger/bsv 3.4.1 → 3.4.3

package/docs/MODULE_REFERENCE_COMPLETE.md

@@ -25,7 +25,7 @@ Based on actual library analysis, SmartLedger-BSV provides **12 distinct modules
 | **bsv-smartcontract.min.js** | SmartContract framework | 451KB | Covenant development | ✅ Documented |
 | **bsv-covenant.min.js** | Covenant interface | 32KB | Covenant operations | ✅ Documented |
 | **bsv-script-helper.min.js** | Custom script tools | 27KB | Script development | ✅ Documented |
-| **bsv-security.min.js** | Security enhancements | 290KB | Hardened crypto | ✅ Documented |
+| **bsv-security.min.js** | Security enhancements (opt-in helpers) | 26KB | `SmartVerify` / `EllipticFixed` | ✅ Documented |
 
 ### **Utility Modules**
 
@@ -55,19 +55,19 @@ Three major modules totaling **1.82MB** of functionality are completely missing
 - **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@3.3.4/bsv-shamir.min.js`
+- **CDN**: `unpkg.com/@smartledger/bsv@3.4.2/bsv-shamir.min.js`
 
 #### **🌐 Global Digital Attestation Framework - GDAF (604KB)**  
 - **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@3.3.4/bsv-gdaf.min.js`
+- **CDN**: `unpkg.com/@smartledger/bsv@3.4.2/bsv-gdaf.min.js`
 
 #### **⚖️ Legal Token Protocol - LTP (817KB)**
 - **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@3.3.4/bsv-ltp.min.js`
+- **CDN**: `unpkg.com/@smartledger/bsv@3.4.2/bsv-ltp.min.js`
 
 ### **2. Incorrect File Sizes in Documentation**
 
@@ -82,18 +82,18 @@ Three major modules totaling **1.82MB** of functionality are completely missing
 
 | Module | Size | Use Case | CDN Link |
 |--------|------|----------|----------|
-| **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js` |
-| **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js` |
-| **bsv-smartcontract.min.js** | 451KB | Covenant development | `unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js` |
-| **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js` |
-| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js` |
-| **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js` |
-| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ecies.min.js` |
-| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.3.4/bsv-message.min.js` |
-| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.3.4/bsv-mnemonic.min.js` |
-| **🆕 bsv-shamir.min.js** | 433KB | **Secret sharing** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js` |
-| **🆕 bsv-gdaf.min.js** | 604KB | **Digital attestation** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js` |
-| **🆕 bsv-ltp.min.js** | 817KB | **Legal tokens** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js` |
+| **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.4.2/bsv.min.js` |
+| **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.4.2/bsv.bundle.js` |
+| **bsv-smartcontract.min.js** | 451KB | Covenant development | `unpkg.com/@smartledger/bsv@3.4.2/bsv-smartcontract.min.js` |
+| **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.4.2/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.4.2/bsv-script-helper.min.js` |
+| **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@3.4.2/bsv-security.min.js` |
+| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.4.2/bsv-ecies.min.js` |
+| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.4.2/bsv-message.min.js` |
+| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.4.2/bsv-mnemonic.min.js` |
+| **🆕 bsv-shamir.min.js** | 433KB | **Secret sharing** | `unpkg.com/@smartledger/bsv@3.4.2/bsv-shamir.min.js` |
+| **🆕 bsv-gdaf.min.js** | 604KB | **Digital attestation** | `unpkg.com/@smartledger/bsv@3.4.2/bsv-gdaf.min.js` |
+| **🆕 bsv-ltp.min.js** | 817KB | **Legal tokens** | `unpkg.com/@smartledger/bsv@3.4.2/bsv-ltp.min.js` |
 
 ## 🎯 **Updated Usage Examples**
 
@@ -101,22 +101,22 @@ Three major modules totaling **1.82MB** of functionality are completely missing
 
 #### **1. Basic Development (476KB)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-script-helper.min.js"></script>
 ```
 
 #### **2. Smart Contract Development (932KB)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-smartcontract.min.js"></script>
 ```
 
 #### **3. 🆕 Legal & Compliance Development (1.7MB)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-gdaf.min.js"></script>
 <script>
   // Legal Token Protocol
   const legalToken = bsv.createLegalToken({
@@ -133,9 +133,9 @@ Three major modules totaling **1.82MB** of functionality are completely missing
 
 #### **4. 🆕 Security & Cryptography (1.35MB)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-security.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-shamir.min.js"></script>
 <script>
   // Shamir Secret Sharing
   const shares = bsv.splitSecret('my_secret_key', 5, 3); // 5 shares, 3 needed
@@ -147,7 +147,7 @@ Three major modules totaling **1.82MB** of functionality are completely missing
 
 #### **5. Everything Bundle (885KB)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.bundle.js"></script>
 <script>
   // Everything available immediately
   const shares = bsv.splitSecret('secret', 5, 3);

package/docs/advanced/LEGAL_TOKEN_PROTOCOL.md

@@ -165,7 +165,7 @@ LTP is built on top of SmartLedger-BSV's modular architecture and integrates sea
 
 #### **Foundation Layer (Required)**
 - **Core BSV (`bsv.min.js`)**: Provides Bitcoin SV primitives (keys, transactions, addresses)
-- **Cryptographic Functions**: Uses hardened elliptic curve implementations for all signatures
+- **Cryptographic Functions**: Token signing uses BSV's standard ECDSA path (the same one used by Bitcoin transaction signing). For stricter verification of incoming tokens from untrusted sources, callers can route verification through `bsv.SmartVerify.smartVerify(...)` explicitly — it is not on by default. See [README › Security](../../README.md#-security).
 
 #### **Identity Layer (Recommended)**  
 - **GDAF Module (`bsv-gdaf.min.js`)**: Provides DID creation and Verifiable Credential standards
@@ -242,7 +242,7 @@ const propertyToken = bsv.createRightToken({
   type: 'PropertyTitle',              // LTP: Legal structure
   owner: ownerDID,                    // GDAF: Digital identity  
   jurisdiction: 'US-CA',              // LTP: Legal compliance
-  // Signed with hardened crypto     // Core: Enhanced security
+  // Signed with BSV's standard ECDSA // Core: Bitcoin SV signature
   // Can be covenant-protected       // SmartContract: Enforcement
   // Keys can use Shamir sharing     // Shamir: Distributed control
 });
@@ -301,7 +301,7 @@ const anchor = bsv.LTP.Anchor.prepareCommitment(rightToken);            // 6. Pr
 
 ## 🔐 Security & Trust Features
 
-- **🔒 Cryptographic Signatures** - All tokens signed with enhanced elliptic curves
+- **🔒 Cryptographic Signatures** - Tokens signed with BSV's standard secp256k1 ECDSA path. Opt-in `bsv.SmartVerify` available for stricter verification of incoming tokens.
 - **🎭 Selective Disclosure** - Privacy-preserving proof generation with zero-knowledge
 - **⚖️ Legal Validity Proofs** - Jurisdiction-specific compliance verification
 - **⛓️ Blockchain Anchoring** - Immutable commitment proofs on BSV blockchain

package/docs/getting-started/INSTALLATION.md

@@ -12,10 +12,10 @@ SmartLedger-BSV offers multiple installation methods to suit different developme
 npm install @smartledger/bsv
 
 # Install specific version
-npm install @smartledger/bsv@3.3.4
+npm install @smartledger/bsv@3.4.2
 
 # Install with exact version lock
-npm install --save-exact @smartledger/bsv@3.3.4
+npm install --save-exact @smartledger/bsv@3.4.2
 ```
 
 ### **Usage in Node.js**
@@ -48,7 +48,7 @@ const tx: Transaction = new Transaction();
 #### **Core Library Only (449KB)**
 For basic Bitcoin SV operations:
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/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 (885KB)**  
 Everything in one file:
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/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 (932KB total)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/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 (1.87MB total)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-gdaf.min.js"></script>
 <script>
   // Legal Token Protocol
   const propertyToken = bsv.createPropertyToken({
@@ -98,9 +98,9 @@ Everything in one file:
 
 #### **Security & Cryptography (1.17MB total)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-security.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/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** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js` |
-| **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js` |
-| **bsv-smartcontract.min.js** | 451KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js` |
-| **bsv-ltp.min.js** | 817KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js` |
-| **bsv-gdaf.min.js** | 604KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js` |
-| **bsv-shamir.min.js** | 433KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@3.3.4/bsv-shamir.min.js` |
-| **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.3.4/bsv-security.min.js` |
-| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.3.4/bsv-mnemonic.min.js` |
-| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.3.4/bsv-ecies.min.js` |
-| **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.3.4/bsv-covenant.min.js` |
-| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.3.4/bsv-script-helper.min.js` |
-| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.3.4/bsv-message.min.js` |
+| **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.4.2/bsv.min.js` |
+| **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.4.2/bsv.bundle.js` |
+| **bsv-smartcontract.min.js** | 451KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@3.4.2/bsv-smartcontract.min.js` |
+| **bsv-ltp.min.js** | 817KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@3.4.2/bsv-ltp.min.js` |
+| **bsv-gdaf.min.js** | 604KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@3.4.2/bsv-gdaf.min.js` |
+| **bsv-shamir.min.js** | 433KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@3.4.2/bsv-shamir.min.js` |
+| **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@3.4.2/bsv-security.min.js` |
+| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.4.2/bsv-mnemonic.min.js` |
+| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.4.2/bsv-ecies.min.js` |
+| **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.4.2/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.4.2/bsv-script-helper.min.js` |
+| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.4.2/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 (449KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.min.js"></script>
 
 <!-- Everything included (885KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.bundle.js"></script>
 ```
 
 ## 💰 **Your First Transaction (60 seconds)**
@@ -127,27 +127,27 @@ SmartLedger-BSV offers 12 different loading options - use only what you need:
 
 ```html
 <!-- Core BSV only (449KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.min.js"></script>
 
 <!-- Smart contracts (873KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-smartcontract.min.js"></script>
 
 <!-- Legal tokens (1.1MB) -->
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-ltp.min.js"></script>
 
 <!-- Digital identity (1.1MB) -->
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv-gdaf.min.js"></script>
 
 <!-- Everything (885KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@3.3.4/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.4.2/bsv.bundle.js"></script>
 ```
 
 ## ⚡ **Key Advantages**
 
-### **Security First**
-- ✅ **Elliptic curve hardening** - Enhanced cryptographic security
-- ✅ **Production tested** - Battle-tested in real applications  
-- ✅ **Comprehensive validation** - Built-in error checking
+### **Security helpers (opt-in)**
+- ✅ **`bsv.SmartVerify` / `bsv.EllipticFixed`** - hardened verify with strict input validation and low-`s` canonicalization. Call explicitly; the default `signature.verify()` does **not** route through them. See [README › Security](../../README.md#-security).
+- ✅ **Pinned dependencies** - `elliptic@6.6.1` (upstream-patched), `bn.js@4.11.9`, `bs58@4.0.1`
+- ✅ **Comprehensive validation** - Built-in error checking and 534+ mocha tests
 
 ### **Developer Experience**  
 - ✅ **Zero breaking changes** - Drop-in replacement for bsv@1.5.6

package/docs/migration/FROM_BSV_1_5_6.md

@@ -2,7 +2,7 @@
 
 **Seamless upgrade path with zero breaking changes**
 
-SmartLedger-BSV is designed as a **100% backward-compatible** drop-in replacement for bsv@1.5.6. Your existing code will work unchanged while gaining access to enhanced security and powerful new features.
+SmartLedger-BSV is designed as a **100% backward-compatible** drop-in replacement for bsv@1.5.6. Your existing code will work unchanged while gaining access to optional hardening helpers and powerful new features.
 
 ## 🔄 **Instant Migration (30 seconds)**
 
@@ -73,13 +73,19 @@ const hdKey = bsv.HDPrivateKey.fromSeed(mnemonic.toSeed());
 
 ## 🚀 **What You Gain (No Code Changes Required)**
 
-### **Enhanced Security**
+### **Optional hardening helpers (opt-in)**
 ```javascript
-// Same API, enhanced security under the hood
-const privateKey = new bsv.PrivateKey();  // Now with hardened elliptic curves
-const signature = privateKey.sign(hash);   // Enhanced cryptographic operations
+// Standard API behaves identically to bsv@1.5.6
+const privateKey = new bsv.PrivateKey();
+const signature = privateKey.sign(hash);
+
+// Opt-in: stricter verification helpers that reject malformed signatures
+// (r=0, s=0, r>=n, s>=n) and canonicalize s to the low half. Call explicitly.
+const ok = bsv.SmartVerify.smartVerify(msgHashBuffer, derSigBuffer, publicKey);
 ```
 
+> **Note:** the standard `signature.verify()` / `transaction.verify()` / `Message().verify()` paths in this library use BSV's own pure-JS ECDSA and are **not** routed through `SmartVerify` or `EllipticFixed` by default. See the [Security section in the README](../../README.md#-security) for details on what's opt-in vs. on by default.
+
 ### **Improved Performance**  
 - ✅ **Optimized operations** - Faster transaction creation and signing
 - ✅ **Better memory usage** - Reduced memory footprint

package/index.js

@@ -29,7 +29,15 @@ bsv.versionGuard = function (version) {
 bsv.versionGuard(global._bsv)
 global._bsv = bsv.version
 
-// SmartLedger security information
+// SmartLedger security information.
+// NOTE: these properties advertise that hardening *helpers* ship in this
+// package (`bsv.SmartVerify`, `bsv.EllipticFixed`, `signature.toCanonical()`,
+// etc.). They are NOT automatically wired into the default verify path:
+// `transaction.verify()`, `signature.verify()`, and `Message().verify()` go
+// through `lib/crypto/ecdsa.js`, which uses BSV's own pure-JS ECDSA and does
+// not route through `SmartVerify` or `EllipticFixed`. To get the strict
+// input validation, call `bsv.SmartVerify.smartVerify(...)` explicitly.
+// See the Security section of README.md.
 bsv.isHardened = true
 bsv.hardenedBy = 'SmartLedger'
 bsv.baseVersion = 'v1.5.6'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartledger/bsv",
-  "version": "3.4.1",
+  "version": "3.4.3",
   "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",