smartledger-bsv 3.3.2 → 3.3.4

package/docs/MODULE_REFERENCE_COMPLETE.md

@@ -0,0 +1,330 @@
+# 📦 SmartLedger-BSV Module Reference - Complete Library Analysis
+
+## 🔍 **Actual vs Documented Module Analysis**
+
+*Analysis Date: October 28, 2025*  
+*SmartLedger-BSV Version: v3.3.3*  
+
+---
+
+## 📊 **Complete Module Inventory**
+
+Based on actual library analysis, SmartLedger-BSV provides **12 distinct modules** with flexible loading options:
+
+### **Core Modules**
+
+| Module | File | Size | Purpose | Status in Docs |
+|--------|------|------|---------|----------------|
+| **bsv.min.js** | Core BSV + SmartContract | 449KB | Complete BSV development | ✅ Documented |
+| **bsv.bundle.js** | Everything in one | 885KB | All features included | ⚠️ Size wrong (764KB→885KB) |
+
+### **Specialized Modules** 
+
+| Module | File | Size | Purpose | Status in Docs |
+|--------|------|------|---------|----------------|
+| **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 |
+
+### **Utility Modules**
+
+| Module | File | Size | Purpose | Status in Docs |
+|--------|------|------|---------|----------------|
+| **bsv-ecies.min.js** | ECIES encryption | 71KB | Message encryption | ✅ Documented |
+| **bsv-message.min.js** | Message signing | 26KB | Message operations | ✅ Documented |
+| **bsv-mnemonic.min.js** | HD wallet support | 670KB | Mnemonic operations | ✅ Documented |
+
+### **🆕 Advanced Modules (Missing from Documentation!)**
+
+| Module | File | Size | Purpose | Status in Docs |
+|--------|------|------|---------|----------------|
+| **🔐 bsv-shamir.min.js** | Shamir Secret Sharing | 433KB | Threshold cryptography | ❌ **NOT DOCUMENTED** |
+| **🌐 bsv-gdaf.min.js** | Global Digital Attestation | 604KB | Verifiable credentials | ❌ **NOT DOCUMENTED** |
+| **⚖️ bsv-ltp.min.js** | Legal Token Protocol | 817KB | Legal compliance tokens | ❌ **NOT DOCUMENTED** |
+
+---
+
+## 🚨 **Critical Documentation Gaps Discovered**
+
+### **1. Missing Advanced Modules (40% of library undocumented!)**
+
+Three major modules totaling **1.82MB** of functionality are completely missing from documentation:
+
+#### **🔐 Shamir Secret Sharing (433KB)**
+- **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.3/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.3/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.3/bsv-ltp.min.js`
+
+### **2. Incorrect File Sizes in Documentation**
+
+| Module | Documented Size | Actual Size | Difference |
+|--------|----------------|-------------|------------|
+| `bsv.bundle.js` | 764KB | 885KB | +121KB (+16%) |
+| All others | Accurate | Accurate | ✅ Correct |
+
+---
+
+## 📋 **Updated Loading Options Table**
+
+| Module | Size | Use Case | CDN Link |
+|--------|------|----------|----------|
+| **bsv.min.js** | 449KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js` |
+| **bsv.bundle.js** | 885KB | Everything in one file | `unpkg.com/@smartledger/bsv@3.3.3/bsv.bundle.js` |
+| **bsv-smartcontract.min.js** | 451KB | Covenant development | `unpkg.com/@smartledger/bsv@3.3.3/bsv-smartcontract.min.js` |
+| **bsv-covenant.min.js** | 32KB | Covenant operations | `unpkg.com/@smartledger/bsv@3.3.3/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 27KB | Custom script tools | `unpkg.com/@smartledger/bsv@3.3.3/bsv-script-helper.min.js` |
+| **bsv-security.min.js** | 290KB | Security enhancements | `unpkg.com/@smartledger/bsv@3.3.3/bsv-security.min.js` |
+| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@3.3.3/bsv-ecies.min.js` |
+| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@3.3.3/bsv-message.min.js` |
+| **bsv-mnemonic.min.js** | 670KB | HD wallets | `unpkg.com/@smartledger/bsv@3.3.3/bsv-mnemonic.min.js` |
+| **🆕 bsv-shamir.min.js** | 433KB | **Secret sharing** | `unpkg.com/@smartledger/bsv@3.3.3/bsv-shamir.min.js` |
+| **🆕 bsv-gdaf.min.js** | 604KB | **Digital attestation** | `unpkg.com/@smartledger/bsv@3.3.3/bsv-gdaf.min.js` |
+| **🆕 bsv-ltp.min.js** | 817KB | **Legal tokens** | `unpkg.com/@smartledger/bsv@3.3.3/bsv-ltp.min.js` |
+
+## 🎯 **Updated Usage Examples**
+
+### **Complete Loading Strategy Examples**
+
+#### **1. Basic Development (476KB)**
+```html
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-script-helper.min.js"></script>
+```
+
+#### **2. Smart Contract Development (932KB)**
+```html
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-smartcontract.min.js"></script>
+```
+
+#### **3. 🆕 Legal & Compliance Development (1.7MB)**
+```html
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-gdaf.min.js"></script>
+<script>
+  // Legal Token Protocol
+  const legalToken = bsv.createLegalToken({
+    propertyType: 'real_estate',
+    jurisdiction: 'us_delaware'
+  });
+  
+  // Digital Attestation
+  const credential = bsv.createEmailCredential(
+    issuerDID, subjectDID, 'user@example.com', issuerPrivateKey
+  );
+</script>
+```
+
+#### **4. 🆕 Security & Cryptography (1.35MB)**
+```html
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-security.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv-shamir.min.js"></script>
+<script>
+  // Shamir Secret Sharing
+  const shares = bsv.splitSecret('my_secret_key', 5, 3); // 5 shares, 3 needed
+  
+  // Enhanced Security
+  const verified = bsvSecurity.SmartVerify.verify(signature, hash, publicKey);
+</script>
+```
+
+#### **5. Everything Bundle (885KB)**
+```html
+<script src="https://unpkg.com/@smartledger/bsv@3.3.3/bsv.bundle.js"></script>
+<script>
+  // Everything available immediately
+  const shares = bsv.splitSecret('secret', 5, 3);
+  const credential = bsv.createDID(publicKey);
+  const legalToken = bsv.createPropertyToken({...});
+  const covenant = new bsv.CovenantInterface();
+</script>
+```
+
+---
+
+## 🔧 **New Advanced Module APIs**
+
+### **🔐 Shamir Secret Sharing API**
+
+```javascript
+const bsv = require('@smartledger/bsv');
+
+// Split a secret into shares
+const secret = 'my_private_key_or_password';
+const shares = bsv.splitSecret(secret, 5, 3); // 5 shares, need 3 to reconstruct
+
+// Reconstruct secret from shares
+const reconstructed = bsv.reconstructSecret([shares[0], shares[2], shares[4]]);
+
+// Validate share integrity
+const isValid = bsv.validateShare(shares[0]);
+
+console.log('Secret reconstructed:', reconstructed === secret);
+```
+
+### **🌐 Global Digital Attestation Framework API**
+
+```javascript
+const bsv = require('@smartledger/bsv');
+
+// Simple Interface (Recommended)
+const issuerDID = bsv.createDID(privateKey.toPublicKey());
+const credential = bsv.createEmailCredential(
+  issuerDID, subjectDID, 'user@example.com', issuerPrivateKey
+);
+
+// Validate credentials
+const validation = bsv.validateCredential(credential, 'EmailVerifiedCredential');
+
+// Generate zero-knowledge proofs
+const proof = bsv.generateSelectiveProof(
+  credential, 
+  ['credentialSubject.verified'], 
+  nonce
+);
+
+// Advanced Interface
+const gdaf = new bsv.GDAF({
+  anchor: { network: 'mainnet' },
+  attestationSigner: { customConfig: true }
+});
+```
+
+### **⚖️ Legal Token Protocol API**
+
+```javascript
+const bsv = require('@smartledger/bsv');
+
+// Create legal property token (Direct API)
+const ownerKey = new bsv.PrivateKey();
+const propertyData = {
+  type: 'PropertyTitle',
+  owner: 'did:smartledger:' + ownerKey.toPublicKey().toString(),
+  jurisdiction: 'US-CA',
+  property: {
+    address: '123 Main St, San Francisco, CA 94105',
+    parcelId: 'APN-12345678',
+    area: { value: 1000, unit: 'sqft' }
+  },
+  value: { amount: 850000, currency: 'USD' }
+};
+
+const propertyToken = bsv.createRightToken(propertyData, ownerKey, {
+  addProof: true
+});
+
+// Verify legal token
+const verification = bsv.verifyLegalToken(propertyToken.token, ownerKey.toPublicKey().toString());
+
+// Create selective disclosure for privacy
+const disclosure = bsv.createSelectiveDisclosure(propertyToken.token, 
+  ['type', 'jurisdiction', 'property.address'], 'demo-nonce-' + Date.now());
+
+// Primitives-only architecture (for external systems)
+const rightPrep = bsv.prepareRightToken('PropertyTitle', issuerDID, subjectDID, 
+  claimData, issuerPrivateKey, { jurisdiction: 'US-CA' });
+
+const obligationPrep = bsv.prepareObligationToken('PaymentObligation', issuerDID, 
+  obligorDID, obligationData, issuerPrivateKey, { priority: 'HIGH' });
+```
+
+---
+
+## 📈 **Module Size Analysis**
+
+### **Total Library Capabilities**: 4.82MB across 12 modules
+
+| Category | Modules | Total Size | Percentage |
+|----------|---------|------------|------------|
+| **Core & Smart Contracts** | 4 modules | 1.39MB | 29% |
+| **🆕 Legal & Identity** | 2 modules | 1.42MB | 29% |
+| **Utilities** | 3 modules | 767KB | 16% |
+| **🆕 Advanced Crypto** | 1 module | 433KB | 9% |
+| **Security** | 1 module | 290KB | 6% |
+| **Everything Bundle** | 1 file | 885KB | 18% |
+
+### **Modular Loading Benefits**
+
+- **Selective Loading**: Load only needed functionality
+- **Performance**: Reduce bundle size by 60-80% for specific use cases  
+- **Flexibility**: Mix and match modules for custom requirements
+- **CDN Optimization**: Cache individual modules across projects
+
+---
+
+## 🚨 **Immediate Documentation Actions Required**
+
+### **1. Add Missing Module Documentation** (Critical Priority)
+
+**Files to Update:**
+- `README.md` - Add 3 new modules to loading options table
+- `README.md` - Add usage examples for Shamir, GDAF, LTP
+- `README.md` - Update file sizes (bundle.js: 764KB → 885KB)
+
+**New Sections Needed:**
+- Shamir Secret Sharing usage guide
+- GDAF digital identity examples  
+- LTP legal token examples
+- Advanced cryptography patterns
+
+### **2. Create Dedicated Module Documentation**
+
+**New Files to Create:**
+- `docs/SHAMIR_SECRET_SHARING_GUIDE.md`
+- `docs/GDAF_DIGITAL_ATTESTATION_GUIDE.md`  
+- `docs/LTP_LEGAL_TOKENS_GUIDE.md`
+- `docs/ADVANCED_CRYPTOGRAPHY_GUIDE.md`
+
+### **3. Update All Cross-References**
+
+**Files to Update:**
+- All documentation mentioning "9 loading options" → "12 loading options"
+- Update module counts and size references
+- Add new module examples to relevant guides
+
+---
+
+## 💡 **Strategic Recommendations**
+
+### **1. Highlight Unique Capabilities**
+
+SmartLedger-BSV is likely the **only Bitcoin library** providing:
+- ✅ Legal Token Protocol for compliant tokenization
+- ✅ Global Digital Attestation Framework for W3C credentials  
+- ✅ Shamir Secret Sharing for threshold cryptography
+- ✅ Complete smart contract development framework
+
+### **2. Market Positioning Updates**
+
+**Current Tagline**: "Complete Bitcoin SV Development Framework with 9 Flexible Loading Options"
+
+**Recommended**: "Complete Bitcoin SV Development Framework with Legal Compliance, Digital Identity, and 12 Flexible Loading Options"
+
+### **3. Developer Onboarding**
+
+Create **use-case specific guides**:
+- **DeFi Developers** → Core + SmartContract + Covenant
+- **Legal Tech** → Core + LTP + GDAF  
+- **Security Applications** → Core + Security + Shamir
+- **Enterprise** → Everything Bundle
+
+---
+
+This analysis reveals SmartLedger-BSV is significantly more capable than documented, with 40% of functionality (3 major modules) completely undocumented. Immediate action needed to update documentation and showcase unique legal/identity capabilities not available in other Bitcoin libraries.

package/docs/README.md

@@ -1,84 +1,112 @@
 # SmartLedger-BSV Documentation
 
-Comprehensive documentation for SmartLedger-BSV v3.1.1+ - Advanced Bitcoin SV Library with Enterprise Covenant Framework.
-
-## 📚 Documentation Structure
-
-### Core Guides
-- **[Getting Started](getting-started.md)** - Installation, setup, and first steps
-- **[API Reference](api-reference.md)** - Complete API documentation
-- **[Configuration Guide](configuration.md)** - Setup and optimization
-
-### Advanced Features
-- **[Advanced Covenant Development](ADVANCED_COVENANT_DEVELOPMENT.md)** - BIP143 + nChain PUSHTX techniques
-- **[Custom Script Development](CUSTOM_SCRIPT_DEVELOPMENT.md)** - Script creation patterns
-- **[Covenant Development Resolved](COVENANT_DEVELOPMENT_RESOLVED.md)** - Problem solutions and working examples
-
-### Technical Specifications
-- **[BIP143 Preimage Format](preimage.md)** - Detailed preimage structure specification
-- **[nChain PUSHTX Paper](nchain.md)** - Academic research integration (WP1605)
-- **[Security Best Practices](security-best-practices.md)** - Production guidelines
-
-## 🎯 Quick Navigation
-
-### New to SmartLedger-BSV?
-1. **[Getting Started](getting-started.md)** - Begin here for installation and basic usage
-2. **[Examples Directory](../examples/)** - Hands-on code examples
-3. **[Basic Usage](#basic-usage)** - Common patterns and workflows
-
-### Building Custom Scripts?
-1. **[Custom Script Development](CUSTOM_SCRIPT_DEVELOPMENT.md)** - Complete guide to script creation
-2. **[Script Examples](../examples/scripts/)** - Working code examples
-3. **[API Reference](api-reference.md)** - CustomScriptHelper documentation
-
-### Developing Covenants?
-1. **[Advanced Covenant Development](ADVANCED_COVENANT_DEVELOPMENT.md)** - Complete covenant framework
-2. **[Covenant Examples](../examples/covenants/)** - Working covenant patterns  
-3. **[BIP143 Specification](preimage.md)** - Preimage structure details
-4. **[nChain PUSHTX](nchain.md)** - Academic research foundation
-
-### Production Deployment?
-1. **[Security Best Practices](security-best-practices.md)** - Production guidelines
-2. **[Configuration Guide](configuration.md)** - Optimization and setup
-3. **[API Reference](api-reference.md)** - Complete API documentation
-
-## 🚀 Key Features Overview
-
-### Core Library Capabilities
-- **Complete BSV API**: Full compatibility with Bitcoin SV operations
-- **Ultra-Low Fees**: 0.01 sats/byte configuration (91% fee reduction)  
-- **UTXO Management**: Advanced state management with change outputs
-- **CDN Distribution**: Multiple webpack bundles for web development
-- **Security Hardened**: Enhanced elliptic curve security fixes
-
-### 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 for ongoing rules
-- **Dual-Level API**: High-level abstractions with 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
-
-## 📖 Documentation Categories
-
-### 📦 Installation & Setup
-```javascript
-// NPM installation
-npm install @smartledger/bsv
-
-// Basic usage
-const bsv = require('@smartledger/bsv');
-const tx = new bsv.Transaction()
-  .from(utxo)
-  .to(address, amount)
-  .feePerKb(10); // Ultra-low fees
-```
+**The Standard Bitcoin SV Library - Enhanced, Hardened, and Extended**
+
+SmartLedger-BSV is a fully backward-compatible extension of bsv@1.5.6 with elliptic curve hardening and comprehensive additional modules for modern Bitcoin SV development.
+
+## 🎯 **What Makes SmartLedger-BSV the Standard**
+
+- **✅ 100% Backward Compatible** with bsv@1.5.6 - Drop-in replacement
+- **🛡️ Security Hardened** - Enhanced elliptic curve implementations  
+- **📦 12 Modular Loading Options** - Use only what you need
+- **⚖️ Legal Compliance Ready** - Built-in Legal Token Protocol (LTP)
+- **🌐 Digital Identity Native** - W3C standard DIDs and Verifiable Credentials
+- **🔐 Enterprise Security** - Shamir Secret Sharing and advanced cryptography
+- **🔒 Smart Contract Framework** - Complete covenant development toolkit
+- **📚 Production Ready** - Comprehensive documentation and examples
+
+## 📚 **Documentation Structure**
+
+### 🚀 **Getting Started**
+Perfect for developers new to Bitcoin SV or migrating from other libraries.
+
+- [**Quick Start Guide**](getting-started/QUICK_START.md) - Get running in 2 minutes
+- [**Installation & Setup**](getting-started/INSTALLATION.md) - All installation methods
+- [**Migration from bsv@1.5.6**](migration/FROM_BSV_1_5_6.md) - Seamless upgrade path
+- [**Migration from BitcoinJS**](migration/FROM_BITCOINJS.md) - Switch from BitcoinJS-lib
+- [**First Transaction**](getting-started/FIRST_TRANSACTION.md) - Hello World example
+
+### 📖 **Core API Guides** 
+Complete guides for standard Bitcoin SV operations.
+
+- [**Transactions**](api/TRANSACTIONS.md) - Create, sign, and broadcast transactions
+- [**Addresses & Keys**](api/ADDRESSES_KEYS.md) - Generate and manage Bitcoin addresses
+- [**Scripts**](api/SCRIPTS.md) - Bitcoin Script creation and execution
+- [**Networks**](api/NETWORKS.md) - Mainnet, testnet, and custom networks
+- [**ECIES Encryption**](api/ECIES.md) - Elliptic Curve encryption/decryption
+- [**Message Signing**](api/MESSAGE_SIGNING.md) - Sign and verify messages
+- [**HD Wallets**](api/HD_WALLETS.md) - Hierarchical Deterministic wallets
+
+### � **Advanced Features**
+Unique capabilities that set SmartLedger-BSV apart.
+
+- [**Legal Token Protocol (LTP)**](advanced/LEGAL_TOKEN_PROTOCOL.md) - Property rights & obligations
+- [**Global Digital Attestation (GDAF)**](advanced/DIGITAL_ATTESTATION.md) - DIDs & credentials
+- [**Shamir Secret Sharing**](advanced/SHAMIR_SECRET_SHARING.md) - Threshold cryptography
+- [**Smart Contract Framework**](advanced/SMART_CONTRACT_GUIDE.md) - Complete covenant development
+- [**UTXO Management**](advanced/UTXO_MANAGER_GUIDE.md) - Advanced UTXO operations
+- [**Custom Script Development**](advanced/CUSTOM_SCRIPT_DEVELOPMENT.md) - Build custom Bitcoin scripts
+
+### 🎓 **Developer Guides**
+Step-by-step tutorials for common development patterns.
+
+- [**Building a Wallet**](guides/BUILDING_WALLET.md) - Complete wallet implementation
+- [**Payment Processing**](guides/PAYMENT_PROCESSING.md) - Accept Bitcoin payments
+- [**Multi-signature Transactions**](guides/MULTISIG_TRANSACTIONS.md) - Multi-party security
+- [**Atomic Swaps**](guides/ATOMIC_SWAPS.md) - Trustless exchanges
+- [**Micropayment Channels**](guides/MICROPAYMENT_CHANNELS.md) - Payment channels
+- [**Data Storage on BSV**](guides/DATA_STORAGE.md) - Store data on-chain
+
+### 🔬 **Advanced Development**
+Production-ready patterns and advanced use cases.
+
+- [**Covenant Development**](advanced/ADVANCED_COVENANT_DEVELOPMENT.md) - Production covenant patterns
+- [**Smart Contract Security**](advanced/SMART_CONTRACT_SECURITY.md) - Security best practices  
+- [**Performance Optimization**](advanced/PERFORMANCE_OPTIMIZATION.md) - Scale your applications
+- [**Testing Strategies**](advanced/TESTING_STRATEGIES.md) - Comprehensive testing
+- [**Production Deployment**](advanced/PRODUCTION_DEPLOYMENT.md) - Deploy with confidence
+
+### 📋 **Examples & Templates**
+Ready-to-use code examples and project templates.
+
+- [**Basic Examples**](../examples/basic/) - Simple transaction examples
+- [**Smart Contract Examples**](../examples/covenants/) - Covenant patterns
+- [**Advanced Examples**](../examples/covenants2/) - Production patterns
+- [**Project Templates**](examples/TEMPLATES.md) - Starter projects
+
+### 🔧 **Troubleshooting & Support**
+Solutions to common issues and getting help.
+
+- [**Common Issues**](troubleshooting/COMMON_ISSUES.md) - Frequently encountered problems
+- [**Error Reference**](troubleshooting/ERROR_REFERENCE.md) - Complete error guide
+- [**Performance Issues**](troubleshooting/PERFORMANCE_ISSUES.md) - Optimization tips
+- [**Browser Compatibility**](troubleshooting/BROWSER_COMPATIBILITY.md) - Cross-browser support
+- [**Getting Support**](troubleshooting/GETTING_SUPPORT.md) - Community and help
+
+## 🔗 **Quick Navigation**
+
+**I want to...**
+- **Get started quickly** → [Quick Start Guide](getting-started/QUICK_START.md)
+- **Migrate from bsv@1.5.6** → [Migration Guide](migration/FROM_BSV_1_5_6.md)  
+- **Learn smart contracts** → [Smart Contract Guide](advanced/SMART_CONTRACT_GUIDE.md)
+- **Use legal tokens** → [Legal Token Protocol](advanced/LEGAL_TOKEN_PROTOCOL.md)
+- **Implement digital identity** → [Digital Attestation Guide](advanced/DIGITAL_ATTESTATION.md)
+- **Build a production app** → [Advanced Development](advanced/)
+- **See working examples** → [Examples Directory](../examples/)
+- **Get help** → [Troubleshooting](troubleshooting/)
+
+## � **Library Comparison**
+
+| Feature | SmartLedger-BSV | bsv@1.5.6 | BitcoinJS-lib |
+|---------|-----------------|-----------|---------------|
+| **Core BSV Support** | ✅ Full | ✅ Full | ❌ Bitcoin only |
+| **Backward Compatibility** | ✅ 100% | - | ❌ Different API |
+| **Security Hardening** | ✅ Yes | ❌ No | ❌ No |
+| **Legal Tokens** | ✅ Built-in | ❌ No | ❌ No |
+| **Digital Identity** | ✅ W3C Standard | ❌ No | ❌ No |
+| **Smart Contracts** | ✅ Complete Framework | ❌ Basic | ❌ No |
+| **Modular Loading** | ✅ 12 Options | ❌ Monolithic | ❌ Monolithic |
+| **Production Ready** | ✅ Yes | ⚠️ Limited | ⚠️ Bitcoin only |
 
 ### 🔒 Covenant Development
 ```javascript