@smartledger/bsv 3.2.1 → 3.3.2

package/CHANGELOG.md

@@ -5,6 +5,153 @@ All notable changes to SmartLedger-BSV will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.3.0] - 2025-10-22
+
+### 🚀 MAJOR RELEASE: Legal Token Protocol (LTP) & Global Digital Attestation Framework (GDAF)
+
+#### Revolutionary Legal Token Protocol Framework
+- **Complete Legal Token Protocol (LTP)**: 6-module comprehensive legal framework
+  - **lib/ltp/anchor.js**: Blockchain anchoring preparation primitives
+  - **lib/ltp/registry.js**: Token registry management primitives  
+  - **lib/ltp/claim.js**: Legal claim validation and attestation primitives
+  - **lib/ltp/proof.js**: Cryptographic proof generation primitives
+  - **lib/ltp/right.js**: Legal rights token creation and validation primitives
+  - **lib/ltp/obligation.js**: Legal obligation token management primitives
+
+#### Primitives-Only Architecture Philosophy
+- **No Blockchain Publishing**: Library provides preparation functions only
+- **External System Integration**: Perfect for enterprise and custom implementations
+- **Maximum Flexibility**: Choose your own blockchain, storage, and UI frameworks
+- **Clean Separation**: Cryptographic correctness separated from application logic
+
+#### Legal Token Framework Components
+- **46 LTP Primitive Methods**: Complete coverage across all legal token operations
+  - 4 Right Token Primitives (prepare, verify, transfer, validate)
+  - 5 Obligation Token Primitives (create, verify, fulfill, breach assessment, monitoring)
+  - 5 Claim Validation Primitives (validate, attest, dispute, bulk processing, templates)
+  - 6 Proof Generation Primitives (signature, selective disclosure, ZK, legal validity)
+  - 8 Registry Management Primitives (registry setup, registration, approval, revocation, queries)
+  - 4 Blockchain Anchoring Primitives (commitment, batch processing, verification, revocation)
+
+#### W3C-Compliant Legal Standards
+- **PropertyTitle**: Complete property ownership claim schema
+- **VehicleTitle**: Vehicle ownership and transfer documentation
+- **PromissoryNote**: Financial obligation and debt instruments
+- **IntellectualProperty**: IP rights and licensing framework
+- **ProfessionalLicense**: Professional certification and licensing
+- **MusicLicense**: Music rights and royalty management
+
+#### Global Digital Attestation Framework (GDAF)
+- **6-Module GDAF Implementation**: Complete W3C Verifiable Credentials compliance
+  - **lib/gdaf/attestation.js**: Digital attestation creation and verification
+  - **lib/gdaf/identity.js**: Decentralized identity management
+  - **lib/gdaf/registry.js**: Attestation registry and discovery
+  - **lib/gdaf/credential.js**: W3C Verifiable Credentials implementation
+  - **lib/gdaf/proof.js**: Cryptographic proof systems
+  - **lib/gdaf/verification.js**: Multi-layer verification framework
+
+#### Enhanced Cryptographic Primitives
+- **Shamir Secret Sharing**: Complete k-of-n threshold cryptography
+  - **lib/crypto/shamir.js**: Production-ready SSS implementation
+  - **bsv.createShares()**: Split secrets into threshold shares
+  - **bsv.reconstructSecret()**: Reconstruct from threshold shares
+  - **bsv.verifyShares()**: Validate share integrity
+
+### 🎯 Complete Legal Token Workflow Example
+
+#### Real BSV Integration Demonstration
+- **Real Private Keys**: Actual BSV addresses and WIF keys generated
+- **Mock UTXO System**: Complete testing framework without blockchain dependency
+- **Smart Contract Covenants**: Legal token enforcement through BSV covenants
+- **End-to-End Workflow**: From claim creation to token transfer with covenant validation
+
+#### Example Results from `complete_ltp_demo.js`:
+- Property Right Token: `RT-1bd80ac44e27c3ec0f9dffdd2efffe07`
+- Obligation Token: `OB-e87eb0388db36b8b5777118ae45c46d3`
+- Covenant Address: `1MhX6MRVE79Qn4CtQ6bkk5JJJeMCTXBwwo`
+- Transfer Transaction: `4b1125d5dfc53e0157b843b8d2e964922331dd509ca096f9a470bfda421b43e6`
+
+### 🏗️ Architecture Excellence
+
+#### Interface Transformation
+**Before (Application Framework):**
+```javascript
+bsv.createRightToken()     // Created AND published to blockchain
+bsv.validateLegalClaim()   // Validated AND stored in database
+bsv.anchorTokenBatch()     // Created batch AND sent transaction
+```
+
+**After (Primitives-Only):**
+```javascript
+bsv.prepareRightToken()           // Prepares token structure only
+bsv.prepareClaimValidation()      // Validates structure only  
+bsv.prepareBatchCommitment()      // Prepares commitment only
+```
+
+### 🛠️ New Development Tools & Testing
+
+#### Comprehensive Demo Suite
+- **complete_ltp_demo.js**: Full end-to-end LTP workflow with real BSV keys
+- **simple_demo.js**: Architectural overview and primitives showcase
+- **architecture_demo.js**: Before/after comparison demonstration
+- **gdaf_demo.js**: Complete GDAF framework demonstration
+- **shamir_demo.js**: Threshold cryptography examples
+
+#### New NPM Scripts
+- **`npm run test:ltp`**: Complete Legal Token Protocol demonstration
+- **`npm run test:ltp-primitives`**: Primitives-only architecture showcase
+- **`npm run test:architecture`**: Architectural transformation comparison
+
+### 📦 Enhanced Build System
+
+#### New Standalone Modules
+- **bsv-ltp.min.js**: Complete Legal Token Protocol standalone module
+- **bsv-shamir.min.js**: Standalone Shamir Secret Sharing module
+- **bsv-gdaf.min.js**: Complete GDAF framework module
+
+#### Updated Keywords & Metadata
+```json
+"legal-token-protocol", "ltp", "legal-tokens", "primitives-only",
+"legal-compliance", "property-rights", "obligations", "attestations",
+"gdaf", "global-digital-attestation", "w3c-credentials", 
+"verifiable-credentials", "shamir-secret-sharing", "threshold-cryptography"
+```
+
+### 💫 Enterprise Integration Benefits
+
+#### For Developers
+- ✅ Choose any blockchain platform (BSV, Bitcoin, Ethereum, etc.)
+- ✅ Choose any storage solution (SQL, NoSQL, IPFS, etc.)
+- ✅ Full architectural control and system integration
+- ✅ Easy integration with existing business systems
+
+#### For Enterprises  
+- ✅ No vendor lock-in to specific platforms
+- ✅ Compliance with existing IT policies
+- ✅ Legacy system compatibility
+- ✅ Audit-friendly separation of concerns
+
+#### For Security & Legal
+- ✅ Isolated cryptographic operations
+- ✅ Standardized legal token structures
+- ✅ Predictable, deterministic behavior
+- ✅ Regulatory compliance primitives
+
+### 🔄 Migration from v3.2.x
+
+#### Backward Compatibility
+- All existing APIs remain functional
+- New primitives-only methods added alongside existing functionality
+- Gradual migration path available for existing applications
+
+#### Recommended Migration Steps
+1. Test new LTP primitives with existing data structures
+2. Gradually replace direct blockchain operations with preparation primitives
+3. Implement external systems for blockchain publishing and storage
+4. Enjoy increased flexibility and architectural control
+
+---
+
 ## [3.2.0] - 2025-10-19
 
 ### 🚀 MAJOR RELEASE: JavaScript-to-Bitcoin Script Framework

package/README.md

@@ -1,72 +1,244 @@
 # SmartLedger-BSV
 
-**Advanced Bitcoin SV Library with Enterprise Covenant Framework**
+**🚀 Complete Bitcoin SV Development Framework with 9 Flexible Loading Options**
 
-[![Version](https://img.shields.io/badge/version-3.1.1-blue.svg)](https://www.npmjs.com/package/@smartledger/bsv)
+[![Version](https://img.shields.io/badge/version-3.2.1-blue.svg)](https://www.npmjs.com/package/@smartledger/bsv)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![BSV](https://img.shields.io/badge/BSV-Compatible-orange.svg)](https://bitcoinsv.com/)
-[![Covenant](https://img.shields.io/badge/Covenants-Advanced-purple.svg)](#covenant-framework)
-
-SmartLedger-BSV is a comprehensive Bitcoin SV library that provides both high-level abstractions and granular control for advanced blockchain development. Built on the foundation of BSV library with enhanced covenant capabilities, custom script framework, and enterprise-grade features.
-
-## 🚀 Key Features
-
-### Core Library
-- ✅ **Complete BSV API**: Full compatibility with BSV blockchain operations
-- ✅ **Ultra-Low Fees**: 0.01 sats/byte configuration (91% fee reduction)
-- ✅ **UTXO Management**: Advanced state management with change output handling
-- ✅ **CDN Distribution**: Multiple webpack bundles for web development
-- ✅ **NPM Ready**: Published as `smartledger-bsv` and `@smartledger/bsv`
-
-### Advanced Covenant Framework
-- 🔒 **BIP143 Compliant**: Complete preimage parsing with field-by-field access
-- 🔒 **PUSHTX Integration**: nChain WP1605 in-script signature generation
-- 🔒 **PELS Support**: Perpetually Enforcing Locking Scripts
-- 🔒 **JavaScript-to-Script**: Write covenant logic in JavaScript, get Bitcoin Script ASM
-- 🔒 **Complete Opcode Mapping**: All 121 Bitcoin Script opcodes with JavaScript equivalents
-- 🔒 **Covenant Builder**: High-level API for rapid covenant development
-- 🔒 **Script Simulation**: Real-time debugging with stack visualization
-- 🔒 **Template Patterns**: Pre-built covenant templates for common use cases
-- 🔒 **Dual-Level API**: High-level abstractions + granular BSV control
-- 🔒 **Production Ready**: Comprehensive validation and error handling
-
-### Custom Script Development  
-- 🛠️ **Multi-signature Scripts**: Advanced m-of-n signature schemes
-- 🛠️ **Timelock Contracts**: Block height and timestamp constraints
-- 🛠️ **Conditional Logic**: Complex branching and validation rules
-- 🛠️ **Template System**: Pre-built patterns for common use cases
-- 🛠️ **Developer API**: Simplified interface for rapid development
-
-## � Table of Contents
-
-- [Quick Start](#quick-start)
-- [Installation](#installation)
-- [Basic Usage](#basic-usage)
-- [Covenant Framework](#covenant-framework)
-- [Custom Scripts](#custom-scripts)
-- [Examples](#examples)
-- [Documentation](#documentation)
-- [API Reference](#api-reference)
-- [Contributing](#contributing)
-- [License](#license)
-
-## ⚡ Quick Start
+[![Modular](https://img.shields.io/badge/Loading-Modular-purple.svg)](#loading-options)
 
+The most comprehensive and flexible Bitcoin SV library available. Choose from 9 different distribution methods: standalone modules, complete bundle, or mix-and-match approach. Perfect for everything from simple transactions to complex DeFi protocols and smart contracts.
+
+## 🎯 **9 Loading Options - Choose Your Approach**
+
+| Module | Size | Use Case | CDN |
+|--------|------|----------|-----|
+| **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.2.1/bsv.min.js` |
+| **bsv.bundle.js** | 764KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.2.1/bsv.bundle.js` |
+| **bsv-covenant.min.js** | 32KB | Covenant development | `unpkg.com/@smartledger/bsv@3.2.1/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.2.1/bsv-script-helper.min.js` |
+| **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.2.1/bsv-security.min.js` |
+| **bsv-smartcontract.min.js** | 451KB | Debug tools | `unpkg.com/@smartledger/bsv@3.2.1/bsv-smartcontract.min.js` |
+| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.2.1/bsv-ecies.min.js` |
+| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.2.1/bsv-message.min.js` |
+| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.2.1/bsv-mnemonic.min.js` |
+
+## ⚡ **2-Minute Quick Start**
+
+Get started with Bitcoin SV development in under 2 minutes:
+
+```bash
+# Install via npm
+npm install @smartledger/bsv
+
+# Or include in HTML
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv.min.js"></script>
+```
+
+**Basic Transaction (30 seconds):**
+```javascript
+const bsv = require('@smartledger/bsv'); // Node.js
+// const bsv = window.bsv; // Browser
+
+// 1. Generate keys
+const privateKey = new bsv.PrivateKey();
+const address = privateKey.toAddress();
+
+// 2. Create transaction
+const tx = new bsv.Transaction()
+  .from(utxo)                    // Add input
+  .to(targetAddress, 50000)      // Send 50,000 satoshis
+  .change(address)               // Send change back
+  .sign(privateKey);             // Sign transaction
+
+console.log('Transaction ID:', tx.id);
+```
+
+**Covenant Development (90 seconds):**
+```javascript
+// Load covenant interface
+const covenant = new bsv.CovenantInterface();
+
+// Create covenant transaction with preimage access
+const covenantTx = covenant.createCovenantTransaction({
+  inputs: [utxo],
+  outputs: [{ address: targetAddress, satoshis: 99000 }]
+});
+
+// Get BIP143 preimage for validation
+const preimage = covenantTx.getPreimage(0, lockingScript, satoshis);
+
+// Create manual signature
+const signature = covenant.createSignature(tx, privateKey, 0, script, satoshis);
+```
+
+**Next Steps:**
+- 📖 [Advanced Covenant Guide](docs/ADVANCED_COVENANT_DEVELOPMENT.md)
+- 🛠️ [Custom Script Development](docs/CUSTOM_SCRIPT_DEVELOPMENT.md)
+- 🔧 [API Reference](#api-reference)
+- 💡 [Examples Directory](examples/)
+
+## 🔧 **API Reference**
+
+| Component | Method | Purpose | Example |
+|-----------|--------|---------|---------|
+| **Core** | `new PrivateKey()` | Generate private key | `const key = new bsv.PrivateKey()` |
+| | `new Transaction()` | Create transaction | `const tx = new bsv.Transaction()` |
+| | `Script.fromASM()` | Parse script | `const script = bsv.Script.fromASM('OP_DUP')` |
+| **Covenant** | `CovenantInterface()` | Covenant development | `const covenant = new bsv.CovenantInterface()` |
+| | `createCovenantTransaction()` | Covenant transaction | `covenant.createCovenantTransaction(config)` |
+| | `getPreimage()` | BIP143 preimage | `covenant.getPreimage(tx, 0, script, sats)` |
+| **Custom Scripts** | `CustomScriptHelper()` | Script utilities | `const helper = new bsv.CustomScriptHelper()` |
+| | `createSignature()` | Manual signature | `helper.createSignature(tx, key, 0, script, sats)` |
+| | `createMultisigScript()` | Multi-signature | `helper.createMultisigScript([pk1, pk2], 2)` |
+| **Debug Tools** | `SmartContract.examineStack()` | Analyze script | `SmartContract.examineStack(script)` |
+| | `interpretScript()` | Execute script | `SmartContract.interpretScript(script)` |
+| | `getScriptMetrics()` | Performance data | `SmartContract.getScriptMetrics(script)` |
+| **Security** | `SmartVerify.verify()` | Enhanced verification | `SmartVerify.verify(sig, hash, pubkey)` |
+| | `EllipticFixed.sign()` | Secure signing | `EllipticFixed.sign(hash, privateKey)` |
+
+> 💡 **Tip:** All methods include comprehensive error handling and validation. See [documentation links](#documentation) for detailed guides.
+
+## 📚 **Quick Start Examples**
+
+### Minimal Setup (476KB total)
+```html
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv-script-helper.min.js"></script>
+<script>
+  const privateKey = new bsv.PrivateKey();
+  const signature = bsvScriptHelper.createSignature(tx, privateKey, 0, script, satoshis);
+</script>
+```
+
+### Advanced Development (932KB total)
+```html
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv-smartcontract.min.js"></script>
+<script>
+  const covenant = new bsvCovenant.CovenantInterface();
+  const contractTx = covenant.createCovenantTransaction(config);
+  const debugInfo = SmartContract.examineStack(script);
+</script>
+```
+
+### Everything Bundle (764KB)
+```html
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv.bundle.js"></script>
+<script>
+  // Everything available immediately
+  const keys = bsv.SmartLedgerBundle.generateKeys();
+  const covenant = new bsv.CovenantInterface();
+  const encrypted = bsv.ECIES.encrypt(data, publicKey);
+</script>
 ```
 
-## 📦 Installation
+## 🎯 **Key Features**
+
+### Core Library  
+- ✅ **Complete BSV API**: Full Bitcoin SV blockchain operations → [API Reference](#api-reference)
+- ✅ **SmartContract Framework**: 59+ methods for script development and debugging → [SmartContract Integration](SMARTCONTRACT_INTEGRATION.md)
+- ✅ **Security Hardened**: SmartLedger elliptic curve fixes and enhanced validation → [Security Features](#smart-security)
+- ✅ **Browser + Node.js**: Universal compatibility with proper polyfills → [Loading Options](#9-loading-options--choose-your-approach)
+- ✅ **TypeScript Ready**: Complete type definitions included
+
+### Advanced Development Tools
+- � **Covenant Interface**: High-level covenant development framework → [Covenant Guide](docs/ADVANCED_COVENANT_DEVELOPMENT.md)
+- � **Custom Script Helper**: Simplified API for script creation and signing → [Script Development](docs/CUSTOM_SCRIPT_DEVELOPMENT.md)
+- 🔒 **Debug Tools**: Script interpreter, stack examiner, metrics, and optimizer → [Debug Examples](tests/smartcontract-test.html)
+- 🔒 **BIP143 Compliant**: Complete preimage parsing and manipulation → [Preimage Tools](examples/preimage/)
+- 🔒 **PUSHTX Integration**: nChain techniques for advanced covenant patterns → [PUSHTX Insights](docs/pushtx-key-insights.md)
+
+### Flexible Architecture
+- 📦 **Modular Loading**: Load only what you need → [Loading Strategy](#loading-strategy-examples)
+- 📦 **Standalone Modules**: Independent security and utility modules → [Standalone Test](tests/standalone-modules-test.html)
+- 📦 **Complete Bundle**: Everything in one file for convenience → [Bundle Demo](tests/bundle-demo.html)
+- 📦 **CDN Ready**: All modules available via unpkg and jsDelivr
+- 📦 **Webpack Optimized**: Tree-shakeable and build-tool friendly
+
+## ⚡ **Installation & Usage**
+
+> 💡 **Quick Start**: Jump to [2-Minute Quick Start](#2-minute-quick-start) for instant setup examples
 
 ### NPM Installation
 ```bash
 # Main package
 npm install @smartledger/bsv
 
-# Alternative package name
+# Alternative package name (legacy)
 npm install smartledger-bsv
 ```
 
-### CDN Usage
+> 📖 **Next Steps**: After installation, see [Loading Options](#9-loading-options--choose-your-approach) to choose your distribution method
+
+### Node.js Usage
+```javascript
+const bsv = require('@smartledger/bsv');
+
+// Basic transaction
+const privateKey = new bsv.PrivateKey();
+const publicKey = privateKey.toPublicKey();
+const address = privateKey.toAddress();
+
+// SmartContract debugging
+const script = bsv.Script.fromASM('OP_1 OP_2 OP_ADD OP_3 OP_EQUAL');
+const metrics = bsv.SmartContract.getScriptMetrics(script);
+const stackInfo = bsv.SmartContract.examineStack(script);
+
+// Covenant development
+const covenant = new bsv.CovenantInterface();
+const contractTx = covenant.createCovenantTransaction({
+  inputs: [...],
+  outputs: [...]
+});
+```
+
+### Browser CDN (Choose Your Loading Strategy)
+
+#### 1. **Minimal Setup** - Core + Script Helper (476KB)
 ```html
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv-script-helper.min.js"></script>
+<script>
+  const tx = new bsv.Transaction();
+  const sig = bsvScriptHelper.createSignature(tx, privateKey, 0, script, satoshis);
+</script>
+```
+
+#### 2. **DeFi Development** - Core + Covenants + Debug (932KB)
+```html
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv-smartcontract.min.js"></script>
+<script>
+  const covenant = new bsvCovenant.CovenantInterface();
+  const debugInfo = SmartContract.interpretScript(script);
+  const optimized = SmartContract.optimizeScript(script);
+</script>
+```
+
+#### 3. **Security First** - Core + Enhanced Security (739KB)
+```html
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv-security.min.js"></script>
+<script>
+  const verified = bsvSecurity.SmartVerify.verify(signature, hash, publicKey);
+  const enhanced = bsvSecurity.EllipticFixed.createSignature(privateKey, hash);
+</script>
+```
+
+#### 4. **Everything Bundle** - One File Solution (764KB)
+```html
+<script src="https://unpkg.com/@smartledger/bsv@3.2.1/bsv.bundle.js"></script>
+<script>
+  // Everything available under bsv namespace
+  const keys = bsv.SmartLedgerBundle.generateKeys();
+  const covenant = new bsv.CovenantInterface();
+  const message = new bsv.Message('Hello BSV');
+  const encrypted = bsv.ECIES.encrypt('secret', publicKey);
+</script>
+```
 <!-- Main library -->
 <script src="https://unpkg.com/@smartledger/bsv@latest/dist/bsv.bundle.js"></script>
 
@@ -270,20 +442,82 @@ const timelockScript = helper.createTimelockScript(
 
 ## 📄 License
 
+---
+
+## 📚 **Complete Documentation**
+
+### 🚀 **Getting Started**
+- **[2-Minute Quick Start](#2-minute-quick-start)** - Get up and running fast
+- **[Loading Options](#9-loading-options--choose-your-approach)** - Choose your distribution method
+- **[API Reference](#api-reference)** - Quick method lookup
+- **[Installation Guide](#installation)** - npm, CDN, and browser setup
+
+### 🎯 **Development Guides**
+- **[Advanced Covenant Development](docs/ADVANCED_COVENANT_DEVELOPMENT.md)** - Complete BIP143 + PUSHTX guide
+- **[Custom Script Development](docs/CUSTOM_SCRIPT_DEVELOPMENT.md)** - Multi-sig, timelock, and custom patterns
+- **[Covenant Development Resolved](docs/COVENANT_DEVELOPMENT_RESOLVED.md)** - Solutions to common issues
+- **[PUSHTX Key Insights](docs/pushtx-key-insights.md)** - nChain research implementation
+
+### 🔧 **Technical Resources**
+- **[SmartContract Integration](SMARTCONTRACT_INTEGRATION.md)** - Debug tools and analysis
+- **[Examples Directory](examples/)** - Working code samples
+- **[Test Suite](tests/)** - Comprehensive testing examples
+- **[Build System](build/)** - Webpack configurations
+
+### 🌐 **Loading Strategy Examples**
+
+| **Use Case** | **Recommended Load** | **Size** | **Features** |
+|--------------|---------------------|----------|--------------|
+| **Simple Transactions** | `bsv.min.js` | 449KB | Core BSV + SmartContract |
+| **DeFi Development** | Core + Covenant + Debug | 932KB | Advanced contracts + tools |
+| **Enterprise Apps** | `bsv.bundle.js` | 764KB | Everything included |
+| **Mobile/Lightweight** | Core + Script Helper | 476KB | Essential tools only |
+| **Research/Analysis** | Core + SmartContract | 900KB | Full debug capabilities |
+
+### 🔗 **Cross-References**
+
+**From Quick Start → Deep Dive:**
+- [Basic Transaction](#2-minute-quick-start) → [Transaction API](docs/transaction.md)
+- [Covenant Example](#2-minute-quick-start) → [Advanced Covenant Guide](docs/ADVANCED_COVENANT_DEVELOPMENT.md)
+- [API Reference](#api-reference) → [Method Documentation](docs/)
+
+**From Examples → Implementation:**
+- [Covenant Examples](examples/covenants/) → [Production Guide](docs/ADVANCED_COVENANT_DEVELOPMENT.md#production-guidelines)
+- [Script Examples](examples/scripts/) → [Custom Script Guide](docs/CUSTOM_SCRIPT_DEVELOPMENT.md)
+- [Test Files](tests/) → [Integration Examples](examples/)
+
+**From Concepts → Code:**
+- [PUSHTX Theory](docs/pushtx-key-insights.md) → [Covenant Implementation](examples/covenants/advanced_covenant_demo.js)
+- [Security Features](#smart-security) → [Implementation](lib/crypto/smartledger_verify.js)
+- [Debug Tools](#debug-tools) → [Usage Examples](tests/smartcontract-test.html)
+
+### 🎓 **Learning Path**
+
+1. **Start**: [2-Minute Quick Start](#2-minute-quick-start)
+2. **Practice**: [Examples Directory](examples/) 
+3. **Build**: [Custom Script Guide](docs/CUSTOM_SCRIPT_DEVELOPMENT.md)
+4. **Advanced**: [Covenant Development](docs/ADVANCED_COVENANT_DEVELOPMENT.md)
+5. **Deploy**: [Production Guidelines](docs/ADVANCED_COVENANT_DEVELOPMENT.md#production-guidelines)
+
+---
+
+## 📄 **License**
+
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-## 🤝 Contributing
+## 🤝 **Contributing**
 
 We welcome contributions to SmartLedger-BSV! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
 
-## 🏢 Enterprise Support
+## 🏢 **Enterprise Support**
 
 - **GitHub**: [github.com/codenlighten/smartledger-bsv](https://github.com/codenlighten/smartledger-bsv)
 - **NPM**: [@smartledger/bsv](https://www.npmjs.com/package/@smartledger/bsv)
 - **Issues**: [GitHub Issues](https://github.com/codenlighten/smartledger-bsv/issues)
+- **Documentation**: [Complete Docs](#complete-documentation)
 
 ---
 
-**SmartLedger-BSV v3.1.1** - *Advanced Bitcoin SV Library with Enterprise Covenant Framework*
+**SmartLedger-BSV v3.2.1** - *Complete Bitcoin SV Development Framework*
 
-Built with ❤️ for the Bitcoin SV ecosystem
+Built with ❤️ for the Bitcoin SV ecosystem • 9 Loading Options • Enterprise Ready