yakmesh 1.6.0 → 1.7.1

package/CHANGELOG.md

@@ -2,6 +2,95 @@
 
 All notable changes to YAKMESH will be documented in this file.
 
+## [1.7.0] - 2026-01-18
+
+### 🦬 NAKPAK & SHERPA: Yak-Themed Protocol Naming
+
+This release renames dark-themed protocols to yak-themed names for brand consistency.
+
+#### Renamed Protocols
+
+##### NAKPAK (formerly Phantom)
+- **N**ested **A**nonymous **K**ernel for **P**rivate **A**uthenticated **K**omms
+- Post-quantum onion routing with ML-KEM768 key encapsulation
+- File renamed: `phantom-routing.js` → `nakpak-routing.js`
+- Classes renamed: `PhantomRouter` → `NakpakRouter`, etc.
+- Etymology: NAK (female yak) + PAK (package) = sounds like "knapsack" 🎒
+
+##### SHERPA (new protocol slot)
+- **S**ecure **H**idden **E**ndpoint **R**esolution **P**ath **A**rchitecture
+- Peer discovery DHT via public web layer
+- Guides nodes to find each other like Sherpas guide travelers
+
+#### Protocol Stack Update
+```text
+1. HTTP API - Public content delivery
+2. Annex - Encrypted P2P messaging
+3. Gossip - Message propagation
+4. Beacon - Emergency broadcast
+5. Nakpak - Onion routing (NEW NAME)
+6. Sherpa - Peer discovery (NEW)
+7. Mesh - Core P2P network
+```
+
+---
+
+### 🛡️ SLH-DSA Backup Signatures & Monitoring Dashboard
+
+This release adds defense-in-depth with FIPS 205 hash-based backup signatures and a comprehensive monitoring dashboard.
+
+#### New Features
+
+##### SLH-DSA Backup Signatures (FIPS 205)
+- **Dual Algorithm Support:** ML-DSA (lattice-based) + SLH-DSA (hash-based)
+- **Level 3:** SLH-DSA-SHA2-192f (hash-based, different cryptographic assumptions)
+- **Level 5:** SLH-DSA-SHA2-256f (hash-based, paranoid mode)
+- New functions: `signBackup()`, `verifyBackup()`, `signDual()`, `verifyDual()`
+- Generate dual keypairs with `generateDualSignatureKeyPairs()`
+- Defense-in-depth: if lattice assumptions break, hash-based signatures still hold
+
+##### Monitoring Dashboard
+- Updated `/dashboard` with YAKMESH branding
+- New `/metrics` endpoint aggregates all node status
+- **Oracle Status:** Health, network identity, verified peers
+- **Crypto Info:** Active algorithms, security level, NIST standards
+- **Time Source:** Trust level, stratum, precision indicators
+- **Uptime Tracking:** Human-readable uptime display
+
+##### Dev.to Automation
+- GitHub Actions now posts to Dev.to on major releases
+- Automated article creation with version info
+- Add `DEVTO_API_KEY` to GitHub secrets to enable
+
+#### Technical Details
+
+##### SLH-DSA Key/Signature Sizes
+| Level | Public Key | Secret Key | Signature |
+|-------|------------|------------|-----------|
+| 3 (192f) | 48 bytes | 96 bytes | ~35 KB |
+| 5 (256f) | 64 bytes | 128 bytes | ~50 KB |
+
+##### Performance (SLH-DSA is slower than ML-DSA)
+- Sign: ~100-160ms (vs 3ms for ML-DSA)
+- Verify: ~5-9ms (vs 1ms for ML-DSA)
+- Use dual signatures only for high-value operations
+
+#### Added
+- `signBackup()`, `verifyBackup()` - SLH-DSA standalone operations
+- `signDual()`, `verifyDual()` - Dual signature operations
+- `generateDualSignatureKeyPairs()` - Generate both ML-DSA and SLH-DSA keypairs
+- `getBackupSignatureAlgorithm()`, `getBackupSignatureName()` - Config accessors
+- `/metrics` endpoint for comprehensive node status
+- Dashboard cards for Oracle, Crypto, Time Source
+- Uptime tracking with human-readable formatting
+
+#### Changed
+- `getCryptoSummary()` now includes `backupSignatureAlgorithm` and FIPS 205 in standards
+- Dashboard rebranded from "Lantern Mesh" to "YAKMESH"
+- `discord-release.yml` now includes Dev.to posting job
+
+---
+
 ## [1.6.0] - 2026-01-17
 
 ### 🔐 NIST Level 5 (Paranoid Mode) & Cryptographic Unification
@@ -37,7 +126,7 @@ All hash operations now use SHA3-256 for post-quantum consistency:
 - `oracle/phase-epoch.js` - Phase derivation uses SHA3-256
 - `gossip/protocol.js` - Bloom filters and message IDs use SHA3-256
 - `mesh/temporal-encoder.js` - Temporal hashes use SHA3-256
-- `mesh/phantom-routing.js` - Key derivation uses SHA3-256
+- `mesh/nakpak-routing.js` - Key derivation uses SHA3-256 (formerly phantom-routing)
 - `mesh/annex.js` - Session key derivation uses SHA3-256
 - `mesh/echo-ranging.js` - Probe key derivation uses SHA3-256
 

package/README.md

@@ -182,7 +182,8 @@ See [TRADEMARK.md](TRADEMARK.md) for trademark usage policy.
   <p>
     <a href="https://discord.gg/8mSPfbJB8N">💬 Discord</a> •
     <a href="https://t.me/yakmesh">📱 Telegram</a> •
-    <a href="https://x.com/yakmesh_dev">𝕏 Twitter</a>
+    <a href="https://x.com/yakmesh_dev">𝕏 Twitter</a> •
+    <a href="https://patreon.com/yakmesh">❤️ Patreon</a>
   </p>
   <br>
   <sub>© 2026 YAKMESH™ Project. Sturdy & Secure.</sub>

package/announcements/discord-v1.6.0.md

@@ -0,0 +1,49 @@
+# 🔐 YAKMESH v1.6.0 - NIST Level 5 & Cryptographic Unification
+
+**The paranoid mode has arrived.**
+
+## What's New
+
+### 🛡️ NIST Level 5 Support (Paranoid Mode)
+Choose your security level:
+- **Level 3** (default): ML-DSA-65/ML-KEM-768 - ~192-bit classical security  
+- **Level 5** (paranoid): ML-DSA-87/ML-KEM-1024 - ~256-bit classical security
+
+```javascript
+import { setSecurityLevel, SecurityLevel } from 'yakmesh/security/crypto-config';
+setSecurityLevel(SecurityLevel.LEVEL_5);  // Maximum security
+```
+
+### 🔄 SHA3-256 Everywhere
+All hash operations now use SHA3-256 for post-quantum consistency:
+- Bloom filter hashing in gossip protocol
+- Temporal mesh encoding
+- Phantom routing key derivation
+- Annex session keys
+- Echo ranging probes
+
+**Why?** SHA3-256 provides 128-bit quantum security (Grover resistance) with its sponge construction.
+
+### 📋 Crypto Agility Documentation
+New `docs/CRYPTO-AGILITY.md` formalizes our algorithm upgrade path:
+- When to upgrade (NIST recommendations, new attacks, standards updates)
+- 90-day dual-algorithm transition periods
+- Version negotiation between nodes
+
+### ✅ 36-Test PQ Crypto Suite
+Comprehensive validation of all cryptographic operations:
+```bash
+npm run test:crypto
+```
+Tests ML-DSA-65/87, ML-KEM-768/1024, SHA3-256, and full handshake simulations.
+
+## Upgrade
+```bash
+npm install yakmesh@1.6.0
+```
+
+---
+
+**No classical asymmetric crypto. Only post-quantum. Only math.**
+
+🦬 https://yakmesh.dev | 📦 npm: yakmesh

package/announcements/discord-v1.7.0.md

@@ -0,0 +1,35 @@
+# Discord Announcement - v1.7.0
+
+## Embed
+
+**Title:** 🦬 YAKMESH™ v1.7.0 Released!
+
+**Description:**
+Defense-in-depth with dual post-quantum signatures!
+
+**Fields:**
+
+### 🛡️ SLH-DSA Backup Signatures
+- Hash-based signatures (FIPS 205) as backup to ML-DSA
+- Defense-in-depth: if lattice breaks, hash-based still holds
+- `signDual()` and `verifyDual()` for maximum security
+
+### 📊 Monitoring Dashboard  
+- New `/metrics` endpoint with comprehensive node status
+- Dashboard shows Oracle, Crypto, Time Source, Uptime
+- Real-time health monitoring
+
+### 🤖 Dev.to Automation
+- Release articles now auto-posted to Dev.to
+- Three platforms automated: Discord, Telegram, Dev.to
+
+### 📦 Install
+```
+npm install yakmesh@1.7.0
+```
+
+**Links:** [npm](https://npmjs.com/package/yakmesh) • [GitHub](https://github.com/yakmesh/yakmesh) • [Docs](https://yakmesh.dev/docs) • [Discord](https://discord.gg/8mSPfbJB8N) • [Telegram](https://t.me/yakmesh)
+
+---
+
+YAKMESH™ - Sturdy & Secure 🏔️

package/announcements/patreon-welcome.md

@@ -0,0 +1,83 @@
+# Welcome to YAKMESH™ Patreon! 🦬
+
+## Thank You for Supporting Post-Quantum Security
+
+Welcome to the YAKMESH™ community! Your support helps us build the future of secure, decentralized networking.
+
+---
+
+## 🏔️ What is YAKMESH?
+
+**YAKMESH** (Yielding Atomic Kernel Modular Encryption Secured Hub) is a high-resiliency, decentralized mesh network designed to survive the quantum computing era.
+
+### Why It Matters
+- 🔐 **Post-quantum cryptography** - Protected against future quantum attacks using ML-DSA-65, ML-KEM768, and SLH-DSA
+- 🌐 **Truly decentralized** - No central servers, no single points of failure
+- 🔮 **Self-verifying oracle** - Code is the authority, not humans
+- 🕵️ **Phantom routing** - Onion routing for privacy
+- ⚡ **PCIe atomic timing** - Nanosecond precision across the network
+
+---
+
+## 💚 What Your Support Enables
+
+### Infrastructure
+- 🖥️ Official node hosting and bandwidth
+- 🔒 Security audits and penetration testing
+- 📊 Network monitoring and uptime
+
+### Development
+- 🛠️ Full-time development resources
+- 🧪 Testing infrastructure
+- 📚 Documentation and tutorials
+
+### Community
+- 🎮 Discord bot (YakBot) hosting
+- 🎉 Community events and hackathons
+- 📰 Regular development updates
+
+---
+
+## 🎁 Supporter Benefits
+
+### All Supporters
+- 💬 Patron-only Discord channel access
+- 📋 Early access to roadmap discussions
+- 🏷️ Patron badge in Discord
+- 📰 Monthly development digest
+
+### Future Tiers (Coming Soon)
+- **Builder** - Vote on feature priorities
+- **Pioneer** - Name in contributors list
+- **Architect** - Monthly dev call access
+
+---
+
+## 🔗 Connect With Us
+
+- 🌐 **Website**: [yakmesh.dev](https://yakmesh.dev)
+- 💬 **Discord**: [Join Server](https://discord.gg/8mSPfbJB8N)
+- 📱 **Telegram**: [@yakmesh](https://t.me/yakmesh)
+- 𝕏 **Twitter/X**: [@yakmesh_dev](https://x.com/yakmesh_dev)
+- 📦 **npm**: [yakmesh](https://npmjs.com/package/yakmesh)
+- 📂 **GitHub**: [yakmesh/yakmesh](https://github.com/yakmesh/yakmesh)
+
+---
+
+## 🚀 Quick Start
+
+```bash
+npm install yakmesh
+npx yakmesh init
+npx yakmesh start
+```
+
+---
+
+**Thank you for being part of the quantum-resistant future!**
+
+*Sturdy & Secure* 🏔️
+
+---
+
+© 2026 YAKMESH™ Project | [PeerQuanta](https://peerquanta.com)

package/announcements/telegram-v1.6.0.md

@@ -0,0 +1,15 @@
+🔐 YAKMESH v1.6.0 - Paranoid Mode
+
+New:
+• NIST Level 5 support (ML-DSA-87/ML-KEM-1024)
+• SHA3-256 unified across all modules
+• Crypto agility documentation
+• 36-test PQ crypto suite
+
+```js
+setSecurityLevel(SecurityLevel.LEVEL_5); // Maximum security
+```
+
+npm install yakmesh@1.6.0
+
+🦬 https://yakmesh.dev

package/announcements/telegram-v1.7.0.md

@@ -0,0 +1,11 @@
+# Telegram Announcement - v1.7.0
+
+🦬 *YAKMESH™ v1.7.0 Released!*
+
+🛡️ SLH-DSA backup signatures for defense-in-depth
+📊 New monitoring dashboard with /metrics endpoint  
+🤖 Automated Dev.to article posting
+
+📦 `npm install yakmesh@1.7.0`
+
+🔗 https://github.com/yakmesh/yakmesh/releases/tag/v1.7.0

package/announcements/x-v1.6.0.md

@@ -0,0 +1,13 @@
+🔐 YAKMESH v1.6.0 - Paranoid Mode
+
+NIST Level 5 support is here:
+• ML-DSA-87 (Dilithium5) - 256-bit classical
+• ML-KEM-1024 (Kyber1024) - 256-bit classical
+
+Plus: SHA3-256 unified across all hashing operations.
+
+No classical asymmetric crypto. Only post-quantum. Only math.
+
+npm i yakmesh@1.6.0
+
+🦬 yakmesh.dev

package/announcements/x-v1.7.0.md

@@ -0,0 +1,41 @@
+# X/Twitter Announcement - v1.7.0
+
+## Thread
+
+### Tweet 1
+🦬 YAKMESH™ v1.7.0 Released!
+
+Defense-in-depth with dual post-quantum signatures 🛡️
+
+Now using BOTH:
+• ML-DSA (lattice-based) - fast primary
+• SLH-DSA (hash-based) - backup
+
+If lattice crypto ever breaks, hash-based still protects you.
+
+npm i yakmesh@1.7.0
+
+### Tweet 2 (Reply)
+New features in v1.7.0:
+
+📊 Monitoring Dashboard
+- /metrics endpoint with full node status
+- Oracle, Crypto, Time Source visualization
+- Real-time uptime tracking
+
+🤖 Automation
+- Release articles auto-posted to Dev.to
+- Discord + Telegram + Dev.to = 3 platforms automated
+
+### Tweet 3 (Reply)
+The philosophy: Sturdy & Secure 🏔️
+
+Like a yak on a mountain, YAKMESH™ is built to survive harsh conditions.
+
+Quantum computers? Covered.
+Lattice assumptions break? Still covered.
+Single point of failure? Mesh eliminates it.
+
+Docs: yakmesh.dev
+
+#PostQuantum #P2P #Cryptography

package/cli/index.js

@@ -56,7 +56,7 @@ program
     // Parse bootstrap nodes
     const bootstrapNodes = options.bootstrap 
       ? options.bootstrap.split(',').map(s => s.trim())
-      : ['wss://peerquanta.com:9001'];
+      : [];  // Empty by default - YAKMESH is decentralized, no central bootstrap
 
     // Generate config
     const config = `/**
@@ -302,6 +302,6 @@ if (!process.argv.slice(2).length) {
   showBanner();
   program.outputHelp();
 }
-
-
-
+
+
+

package/dashboard/index.html

@@ -3,20 +3,22 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Lantern Mesh Network Dashboard</title>
+  <title>YAKMESH Dashboard</title>
   <style>
     :root {
-      --bg-dark: #0a0a0f;
-      --bg-card: #12121a;
-      --bg-hover: #1a1a25;
-      --border: #2a2a35;
-      --text: #e0e0e5;
-      --text-dim: #888;
-      --accent: #f59e0b;
-      --accent-glow: rgba(245, 158, 11, 0.2);
-      --success: #10b981;
-      --warning: #f59e0b;
-      --error: #ef4444;
+      --bg-dark: #0f1419;
+      --bg-card: #1a2027;
+      --bg-hover: #242d38;
+      --border: #2d3a47;
+      --text: #e6edf3;
+      --text-dim: #8b949e;
+      --accent: #4ade80;
+      --accent-glow: rgba(74, 222, 128, 0.2);
+      --mountain: #4ade80;
+      --frost: #38bdf8;
+      --success: #4ade80;
+      --warning: #fbbf24;
+      --error: #f87171;
     }
     
     * {
@@ -27,7 +29,7 @@
     
     body {
       font-family: 'SF Mono', 'Monaco', 'Consolas', monospace;
-      background: var(--bg-dark);
+      background: linear-gradient(135deg, var(--bg-dark) 0%, #0a1520 100%);
       color: var(--text);
       min-height: 100vh;
       padding: 2rem;
@@ -46,8 +48,9 @@
     
     h1 {
       font-size: 1.5rem;
-      font-weight: 500;
-      color: var(--accent);
+      font-weight: 600;
+      color: var(--mountain);
+      letter-spacing: 0.05em;
     }
     
     .subtitle {
@@ -306,10 +309,10 @@
 </head>
 <body>
   <div class="header">
-    <span class="logo">🏮</span>
+    <span class="logo">🦬</span>
     <div>
-      <h1>Lantern Mesh Network</h1>
-      <div class="subtitle">Post-Quantum Secure • Decentralized • Federated</div>
+      <h1>YAKMESH™ Dashboard</h1>
+      <div class="subtitle">Post-Quantum Secure • Sturdy & Secure • v1.7.0</div>
     </div>
   </div>
   
@@ -329,7 +332,7 @@
   <div class="grid">
     <!-- Node Identity -->
     <div class="card">
-      <div class="card-title">🔐 Node Identity</div>
+      <div class="card-title">🦬 Node Identity</div>
       <div id="node-identity">
         <div class="empty-state">Connect to a node to view identity</div>
       </div>
@@ -348,8 +351,8 @@
           <div class="stat-label">Discovered Nodes</div>
         </div>
         <div class="stat">
-          <div class="stat-value" id="replication-log">-</div>
-          <div class="stat-label">Replication Log</div>
+          <div class="stat-value" id="uptime">-</div>
+          <div class="stat-label">Uptime</div>
         </div>
         <div class="stat">
           <div class="stat-value" id="gossip-messages">-</div>
@@ -358,6 +361,30 @@
       </div>
     </div>
     
+    <!-- Oracle Status -->
+    <div class="card">
+      <div class="card-title">🔮 Oracle Status</div>
+      <div id="oracle-status">
+        <div class="empty-state">Connect to view oracle status</div>
+      </div>
+    </div>
+    
+    <!-- Crypto Configuration -->
+    <div class="card">
+      <div class="card-title">🔐 Post-Quantum Cryptography</div>
+      <div id="crypto-info">
+        <div class="empty-state">Connect to view crypto configuration</div>
+      </div>
+    </div>
+    
+    <!-- Time Source -->
+    <div class="card">
+      <div class="card-title">⏱️ Time Source</div>
+      <div id="time-info">
+        <div class="empty-state">Connect to view time source</div>
+      </div>
+    </div>
+    
     <!-- Connected Peers -->
     <div class="card">
       <div class="card-title">
@@ -399,14 +426,6 @@
         <li class="empty-state">No nodes discovered</li>
       </ul>
     </div>
-    
-    <!-- Replication -->
-    <div class="card">
-      <div class="card-title">🔄 Replication Engine</div>
-      <div class="replication-log" id="replication-info">
-        <div class="empty-state">Connect to view replication info</div>
-      </div>
-    </div>
   </div>
 
   <script>
@@ -439,10 +458,10 @@
       
       try {
         // Fetch all data in parallel
-        const [node, peers, replication, gossip, discovered] = await Promise.all([
+        const [node, peers, metrics, gossip, discovered] = await Promise.all([
           fetch(`${nodeUrl}/node`).then(r => r.json()).catch(() => null),
           fetch(`${nodeUrl}/peers`).then(r => r.json()).catch(() => []),
-          fetch(`${nodeUrl}/replication`).then(r => r.json()).catch(() => null),
+          fetch(`${nodeUrl}/metrics`).then(r => r.json()).catch(() => null),
           fetch(`${nodeUrl}/gossip`).then(r => r.json()).catch(() => null),
           fetch(`${nodeUrl}/discovered`).then(r => r.json()).catch(() => []),
         ]);
@@ -464,9 +483,73 @@
         // Update stats
         document.getElementById('peer-count').textContent = peers.length;
         document.getElementById('discovered-count').textContent = discovered.length;
-        document.getElementById('replication-log').textContent = replication?.replicationLogSize ?? '-';
+        document.getElementById('uptime').textContent = metrics?.node?.uptimeFormatted || '-';
         document.getElementById('gossip-messages').textContent = gossip?.seenMessages ?? '-';
         
+        // Update Oracle status
+        if (metrics?.oracle) {
+          const oracle = metrics.oracle;
+          const statusColor = oracle.status === 'healthy' ? 'var(--success)' : 'var(--error)';
+          document.getElementById('oracle-status').innerHTML = `
+            <div style="display: flex; align-items: center; gap: 0.5rem; margin-bottom: 1rem;">
+              <div style="width: 12px; height: 12px; border-radius: 50%; background: ${statusColor}; box-shadow: 0 0 8px ${statusColor};"></div>
+              <span style="font-weight: 600; color: ${statusColor}">${oracle.status.toUpperCase()}</span>
+            </div>
+            <div style="color: var(--text-dim); font-size: 0.85rem;">
+              <div>Network: ${oracle.networkName || 'N/A'}</div>
+              <div>ID: ${oracle.networkId || 'N/A'}</div>
+              <div style="word-break: break-all;">Fingerprint: ${oracle.fingerprint?.slice(0, 24) || 'N/A'}...</div>
+              <div>Verified Peers: ${oracle.verifiedPeers}</div>
+            </div>
+          `;
+        }
+        
+        // Update Crypto info
+        if (metrics?.crypto) {
+          const crypto = metrics.crypto;
+          document.getElementById('crypto-info').innerHTML = `
+            <div style="color: var(--text-dim); font-size: 0.85rem;">
+              <div style="margin-bottom: 0.75rem;">
+                <span style="color: var(--frost)">Security Level:</span> 
+                <span style="color: var(--mountain); font-weight: 600;">${crypto.levelName}</span>
+              </div>
+              <div>Signature: <span style="color: var(--text)">${crypto.signatureAlgorithm}</span></div>
+              <div>Backup Sig: <span style="color: var(--text)">${crypto.backupSignatureAlgorithm || 'N/A'}</span></div>
+              <div>KEM: <span style="color: var(--text)">${crypto.kemAlgorithm}</span></div>
+              <div style="margin-top: 0.5rem;">
+                Classical: ${crypto.classicalSecurity} | Quantum: ${crypto.quantumSecurity}
+              </div>
+              <div style="margin-top: 0.5rem; font-size: 0.75rem;">
+                ${crypto.nistStandards?.join(' • ') || ''}
+              </div>
+            </div>
+          `;
+        }
+        
+        // Update Time info
+        if (metrics?.time) {
+          const time = metrics.time;
+          const trustColors = {
+            ATOMIC: 'var(--success)',
+            GPS: 'var(--success)', 
+            PTP: 'var(--warning)',
+            NTP: 'var(--text-dim)',
+          };
+          const trustColor = trustColors[time.trustLevel] || 'var(--text-dim)';
+          document.getElementById('time-info').innerHTML = `
+            <div style="display: flex; align-items: center; gap: 0.5rem; margin-bottom: 1rem;">
+              <div style="width: 12px; height: 12px; border-radius: 50%; background: ${trustColor}; box-shadow: 0 0 8px ${trustColor};"></div>
+              <span style="font-weight: 600; color: ${trustColor}">${time.trustLevel}</span>
+            </div>
+            <div style="color: var(--text-dim); font-size: 0.85rem;">
+              <div>Stratum: ${time.stratum ?? 'N/A'}</div>
+              <div>Phase Tolerance: ${time.phaseTolerance ? time.phaseTolerance + 'ms' : 'N/A'}</div>
+              <div>Atomic Time: ${time.hasAtomicTime ? '✅ Yes' : '❌ No'}</div>
+              <div>High Precision: ${time.hasHighPrecisionTime ? '✅ Yes' : '❌ No'}</div>
+            </div>
+          `;
+        }
+        
         // Update peer list
         const peerList = document.getElementById('peer-list');
         if (peers.length === 0) {
@@ -508,15 +591,6 @@
           `).join('');
         }
         
-        // Update replication info
-        if (replication) {
-          document.getElementById('replication-info').innerHTML = `
-            <div>Log Entries: ${replication.replicationLogSize}</div>
-            <div>Peer States: ${replication.peerStates}</div>
-            <div>Tables: ${replication.tables?.join(', ') || 'N/A'}</div>
-          `;
-        }
-        
       } catch (e) {
         console.error('Refresh failed:', e);
       }

package/mesh/{phantom-routing.js → nakpak-routing.js}

@@ -1,5 +1,5 @@
 /**
- * Yakmesh Phantom Routing - Post-quantum Hidden Anonymous Network Transmission Over Mesh
+ * Yakmesh NAKPAK Routing - Nested Anonymous Kernel for Private Authenticated Komms
  * 
  * The first post-quantum secure onion routing implementation featuring:
  * - ML-DSA-65 signatures at every routing layer
@@ -7,12 +7,15 @@
  * - Multi-layer encryption with perfect forward secrecy
  * - Timing attack resistance through temporal padding
  * 
- * Key Innovation: "Your packets become ghosts"
+ * Key Innovation: "Your packets travel like yak caravans through hidden mountain paths"
  * - Each routing layer uses different quantum-resistant keys
  * - Decoy traffic masks real communication patterns
  * - Temporal obfuscation defeats traffic analysis
  * 
- * @module mesh/phantom-routing
+ * Etymology: NAK (female yak, the pack carrier) + PAK (package) = NAKPAK (sounds like "knapsack")
+ * Works with SHERPA (Secure Hidden Endpoint Resolution Path Architecture) for peer discovery.
+ * 
+ * @module mesh/nakpak-routing
  * @license MIT
  * @copyright 2026 YAKMESH™ Contributors
  */
@@ -23,7 +26,7 @@ import { ml_kem768 } from '@noble/post-quantum/ml-kem.js';
 import { sha3_256 } from '@noble/hashes/sha3.js';
 import { bytesToHex, hexToBytes, utf8ToBytes } from '@noble/hashes/utils.js';
 
-const PHANTOM_CONFIG = {
+const NAKPAK_CONFIG = {
   // Circuit settings
   defaultHopCount: 3,           // Number of hops (like Tor)
   maxHopCount: 7,               // Maximum allowed hops
@@ -44,13 +47,13 @@ const PHANTOM_CONFIG = {
   maxPayloadSize: 7000,         // Max actual payload
   
   // Key derivation
-  keyDerivationSalt: 'PHANTOM-YAKMESH-2026',
+  keyDerivationSalt: 'NAKPAK-YAKMESH-2026',
 };
 
 /**
- * A single routing layer in the onion
+ * A single routing layer in the onion (like a yak's pack saddle layer)
  */
-class PhantomLayer {
+class NakpakLayer {
   constructor(options) {
     this.hopIndex = options.hopIndex;
     this.nodeId = options.nodeId;
@@ -114,12 +117,12 @@ class PhantomLayer {
       throw new Error('No encryption key established');
     }
 
-    const nonce = randomBytes(PHANTOM_CONFIG.nonceSize);
+    const nonce = randomBytes(NAKPAK_CONFIG.nonceSize);
     const cipher = createCipheriv(
-      PHANTOM_CONFIG.layerEncryption,
+      NAKPAK_CONFIG.layerEncryption,
       this.encryptionKey,
       nonce,
-      { authTagLength: PHANTOM_CONFIG.authTagLength }
+      { authTagLength: NAKPAK_CONFIG.authTagLength }
     );
 
     const plaintext = typeof data === 'string' ? data : JSON.stringify(data);
@@ -148,10 +151,10 @@ class PhantomLayer {
     const tag = Buffer.from(encryptedData.tag, 'hex');
 
     const decipher = createDecipheriv(
-      PHANTOM_CONFIG.layerEncryption,
+      NAKPAK_CONFIG.layerEncryption,
       this.encryptionKey,
       nonce,
-      { authTagLength: PHANTOM_CONFIG.authTagLength }
+      { authTagLength: NAKPAK_CONFIG.authTagLength }
     );
     decipher.setAuthTag(tag);
 
@@ -166,16 +169,16 @@ class PhantomLayer {
   _deriveEncryptionKey(sharedSecret) {
     return createHash('sha3-256')
       .update(sharedSecret)
-      .update(PHANTOM_CONFIG.keyDerivationSalt)
+      .update(NAKPAK_CONFIG.keyDerivationSalt)
       .update(Buffer.from([this.hopIndex]))
       .digest();
   }
 }
 
 /**
- * An onion-wrapped packet
+ * An onion-wrapped packet (like a yak's cargo bundle)
  */
-class PhantomPacket {
+class NakpakPacket {
   constructor(options = {}) {
     this.id = options.id || bytesToHex(randomBytes(16));
     this.circuitId = options.circuitId;
@@ -211,7 +214,7 @@ class PhantomPacket {
     });
 
     const currentSize = Buffer.byteLength(serialized, 'utf8');
-    const paddingNeeded = PHANTOM_CONFIG.fixedPacketSize - currentSize - 50; // Reserve for padding field
+    const paddingNeeded = NAKPAK_CONFIG.fixedPacketSize - currentSize - 50; // Reserve for padding field
 
     if (paddingNeeded > 0) {
       this.padding = randomBytes(Math.max(1, paddingNeeded)).toString('base64');
@@ -222,7 +225,7 @@ class PhantomPacket {
    * Create decoy packet
    */
   static createDecoy(circuitId) {
-    const decoy = new PhantomPacket({
+    const decoy = new NakpakPacket({
       circuitId,
       isDecoy: true,
     });
@@ -251,7 +254,7 @@ class PhantomPacket {
   }
 
   static deserialize(obj) {
-    const packet = new PhantomPacket({
+    const packet = new NakpakPacket({
       id: obj.id,
       circuitId: obj.circuitId,
       timestamp: obj.timestamp,
@@ -263,12 +266,12 @@ class PhantomPacket {
 }
 
 /**
- * A circuit through the mesh (like a Tor circuit)
+ * A circuit through the mesh (like a yak caravan route)
  */
-class PhantomCircuit {
+class NakpakCircuit {
   constructor(options = {}) {
     this.circuitId = options.circuitId || bytesToHex(randomBytes(16));
-    this.hops = [];                // Array of PhantomLayer
+    this.hops = [];                // Array of NakpakLayer
     this.isEstablished = false;
     this.createdAt = Date.now();
     this.lastUsed = Date.now();
@@ -279,14 +282,14 @@ class PhantomCircuit {
    * Build a circuit through specified nodes
    */
   async buildCircuit(nodeIds) {
-    if (nodeIds.length > PHANTOM_CONFIG.maxHopCount) {
-      throw new Error('Too many hops: max is ' + PHANTOM_CONFIG.maxHopCount);
+    if (nodeIds.length > NAKPAK_CONFIG.maxHopCount) {
+      throw new Error('Too many hops: max is ' + NAKPAK_CONFIG.maxHopCount);
     }
 
     this.hops = [];
     
     for (let i = 0; i < nodeIds.length; i++) {
-      const layer = new PhantomLayer({
+      const layer = new NakpakLayer({
         hopIndex: i,
         nodeId: nodeIds[i],
         nextHop: nodeIds[i + 1] || null,
@@ -356,7 +359,7 @@ class PhantomCircuit {
       };
     }
 
-    const packet = new PhantomPacket({
+    const packet = new NakpakPacket({
       circuitId: this.circuitId,
     });
     packet.addLayer(payload);
@@ -369,14 +372,14 @@ class PhantomCircuit {
   }
 
   isExpired() {
-    return Date.now() - this.createdAt > PHANTOM_CONFIG.circuitTimeout;
+    return Date.now() - this.createdAt > NAKPAK_CONFIG.circuitTimeout;
   }
 }
 
 /**
- * Relay node handler for forwarding phantom packets
+ * Relay node handler for forwarding nakpak packets
  */
-class PhantomRelay {
+class NakpakRelay {
   constructor(options = {}) {
     this.nodeId = options.nodeId || bytesToHex(randomBytes(16));
     this.circuits = new Map();    // circuitId -> local layer info
@@ -401,7 +404,7 @@ class PhantomRelay {
    * Handle incoming circuit creation request
    */
   async handleCircuitCreate(request) {
-    const layer = new PhantomLayer({
+    const layer = new NakpakLayer({
       hopIndex: request.hopIndex,
       nodeId: this.nodeId,
       nextHop: request.nextHop,
@@ -491,8 +494,8 @@ class PhantomRelay {
    * Add random delay to defeat timing analysis
    */
   async _addTimingDelay() {
-    const delay = PHANTOM_CONFIG.minPaddingMs + 
-      Math.random() * (PHANTOM_CONFIG.maxPaddingMs - PHANTOM_CONFIG.minPaddingMs);
+    const delay = NAKPAK_CONFIG.minPaddingMs + 
+      Math.random() * (NAKPAK_CONFIG.maxPaddingMs - NAKPAK_CONFIG.minPaddingMs);
     await new Promise(resolve => setTimeout(resolve, delay));
   }
 
@@ -500,9 +503,9 @@ class PhantomRelay {
    * Maybe inject a decoy packet to mask traffic patterns
    */
   _maybeInjectDecoy(circuitId) {
-    if (Math.random() < PHANTOM_CONFIG.decoyProbability) {
+    if (Math.random() < NAKPAK_CONFIG.decoyProbability) {
       this.stats.decoysInjected++;
-      return PhantomPacket.createDecoy(circuitId).serialize();
+      return NakpakPacket.createDecoy(circuitId).serialize();
     }
     return null;
   }
@@ -537,13 +540,13 @@ class PhantomRelay {
 }
 
 /**
- * Main PHANTOM routing manager
+ * Main NAKPAK routing manager
  */
-class PhantomRouter {
+class NakpakRouter {
   constructor(options = {}) {
     this.nodeId = options.nodeId || bytesToHex(randomBytes(16));
-    this.relay = new PhantomRelay({ nodeId: this.nodeId });
-    this.circuits = new Map();     // circuitId -> PhantomCircuit (for circuits we created)
+    this.relay = new NakpakRelay({ nodeId: this.nodeId });
+    this.circuits = new Map();     // circuitId -> NakpakCircuit (for circuits we created)
     this.knownNodes = new Map();   // nodeId -> { publicKey, lastSeen }
     
     this.stats = {
@@ -576,7 +579,7 @@ class PhantomRouter {
       const availableNodes = Array.from(this.knownNodes.keys())
         .filter(id => id !== this.nodeId);
       
-      if (availableNodes.length < PHANTOM_CONFIG.defaultHopCount) {
+      if (availableNodes.length < NAKPAK_CONFIG.defaultHopCount) {
         throw new Error('Not enough known nodes for circuit');
       }
       
@@ -586,10 +589,10 @@ class PhantomRouter {
         [availableNodes[i], availableNodes[j]] = [availableNodes[j], availableNodes[i]];
       }
       
-      hopNodeIds = availableNodes.slice(0, PHANTOM_CONFIG.defaultHopCount);
+      hopNodeIds = availableNodes.slice(0, NAKPAK_CONFIG.defaultHopCount);
     }
 
-    const circuit = new PhantomCircuit();
+    const circuit = new NakpakCircuit();
     const buildResult = await circuit.buildCircuit(hopNodeIds);
     
     this.circuits.set(circuit.circuitId, circuit);
@@ -638,7 +641,7 @@ class PhantomRouter {
    * Handle incoming packet (as a relay)
    */
   async handlePacket(packetData) {
-    const packet = PhantomPacket.deserialize(packetData);
+    const packet = NakpakPacket.deserialize(packetData);
     const result = await this.relay.processPacket(packet);
 
     if (result.type === 'EXIT') {
@@ -690,10 +693,10 @@ class PhantomRouter {
 }
 
 export {
-  PHANTOM_CONFIG,
-  PhantomLayer,
-  PhantomPacket,
-  PhantomCircuit,
-  PhantomRelay,
-  PhantomRouter,
+  NAKPAK_CONFIG,
+  NakpakLayer,
+  NakpakPacket,
+  NakpakCircuit,
+  NakpakRelay,
+  NakpakRouter,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yakmesh",
-  "version": "1.6.0",
+  "version": "1.7.1",
   "description": "YAKMESH: Yielding Atomic Kernel Modular Encryption Secured Hub - Post-quantum secure P2P mesh network for the 2026 threat landscape",
   "type": "module",
   "main": "server/index.js",
@@ -25,7 +25,7 @@
     "./mesh/sybil-defense": "./mesh/sybil-defense.js",
     "./mesh/echo-ranging": "./mesh/echo-ranging.js",
     "./mesh/pulse-sync": "./mesh/pulse-sync.js",
-    "./mesh/phantom-routing": "./mesh/phantom-routing.js",
+    "./mesh/nakpak-routing": "./mesh/nakpak-routing.js",
     "./mesh/beacon-broadcast": "./mesh/beacon-broadcast.js"
   },
   "bin": {
@@ -66,7 +66,7 @@
     "distributed-oracle",
     "onion-routing",
     "echo-ranging",
-    "phantom-routing",
+    "nakpak-routing",
     "pulse-sync",
     "beacon-broadcast",
     "kyber",
@@ -75,6 +75,10 @@
   ],
   "author": "Yakmesh",
   "license": "MIT",
+  "funding": {
+    "type": "patreon",
+    "url": "https://patreon.com/yakmesh"
+  },
   "homepage": "https://yakmesh.dev",
   "repository": {
     "url": "git+https://github.com/peerquanta/yakmesh.git",

package/server/index.js

@@ -47,6 +47,19 @@ import {
 } from '../oracle/time-source.js';
 import { setTimeSourceConfig, getActiveConfig } from '../oracle/phase-epoch.js';
 
+// Helper: Format uptime in human-readable format
+function formatUptime(seconds) {
+  const days = Math.floor(seconds / 86400);
+  const hours = Math.floor((seconds % 86400) / 3600);
+  const mins = Math.floor((seconds % 3600) / 60);
+  const secs = seconds % 60;
+  
+  if (days > 0) return `${days}d ${hours}h ${mins}m`;
+  if (hours > 0) return `${hours}h ${mins}m ${secs}s`;
+  if (mins > 0) return `${mins}m ${secs}s`;
+  return `${secs}s`;
+}
+
 // Optional adapter integration (loaded dynamically if enabled)
 let ActiveAdapter = null;
 
@@ -140,6 +153,9 @@ export class YakmeshNode {
 
   async start() {
     console.log('\n🦬 Starting Yakmesh Node...\n');
+    
+    // Record start time for uptime tracking
+    this._startTime = Date.now();
 
     // 0. LOCK THE CODEBASE - Prevent any modifications during runtime
     // This is critical for Code Proof Protocol security
@@ -898,6 +914,81 @@ export class YakmeshNode {
       });
     });
 
+    // =========================================
+    // Metrics Endpoint - Dashboard Data
+    // =========================================
+    
+    app.get('/metrics', (req, res) => {
+      const startTime = this._startTime || Date.now();
+      const uptime = Math.floor((Date.now() - startTime) / 1000);
+      
+      // Crypto configuration (imported at top of file)
+      let cryptoInfo = null;
+      try {
+        // Dynamic import not needed - use the imported module
+        cryptoInfo = this._cryptoSummary || { 
+          levelName: 'NIST Level 3',
+          signatureAlgorithm: 'ML-DSA-65',
+          backupSignatureAlgorithm: 'SLH-DSA-SHA2-192f',
+          kemAlgorithm: 'ML-KEM-768',
+          classicalSecurity: '192-bit',
+          quantumSecurity: '128-bit',
+          nistStandards: ['FIPS 203 (ML-KEM)', 'FIPS 204 (ML-DSA)', 'FIPS 205 (SLH-DSA)'],
+        };
+      } catch (e) {
+        cryptoInfo = { error: 'Could not load crypto config' };
+      }
+      
+      // Time source info
+      let timeInfo = null;
+      if (this.timeSource) {
+        const status = this.timeSource.getStatus();
+        timeInfo = {
+          trustLevel: status.trustLevel,
+          stratum: status.stratum,
+          phaseTolerance: status.phaseTolerance,
+          hasAtomicTime: this.timeSource.hasAtomicTime(),
+          hasHighPrecisionTime: this.timeSource.hasHighPrecisionTime(),
+        };
+      }
+      
+      // Oracle status
+      let oracleInfo = null;
+      if (this.oracle) {
+        const integrity = this.oracle.verifySelfIntegrity();
+        oracleInfo = {
+          status: integrity.valid ? 'healthy' : 'compromised',
+          valid: integrity.valid,
+          networkName: this.genesisNetwork?.networkName || null,
+          networkId: this.genesisNetwork?.networkId || null,
+          fingerprint: this.genesisNetwork?.fingerprint || null,
+          verifiedPeers: this.codeProof?.getVerifiedPeers()?.length || 0,
+        };
+      }
+      
+      // Mesh stats
+      const peerCount = this.mesh?.getPeers()?.length || 0;
+      const gossipStats = this.gossip?.getStats() || null;
+      
+      res.json({
+        node: {
+          id: this.identity?.identity?.nodeId || null,
+          name: this.config?.node?.name || 'unknown',
+          version: '1.7.0',
+          uptime,
+          uptimeFormatted: formatUptime(uptime),
+        },
+        crypto: cryptoInfo,
+        time: timeInfo,
+        oracle: oracleInfo,
+        network: {
+          peers: peerCount,
+          gossip: gossipStats,
+        },
+        timestamp: new Date().toISOString(),
+      });
+    });
+
     // =========================================
     // Time Source Endpoints - Precision Timing
     // =========================================

package/yakbot/index.js

@@ -7,6 +7,7 @@
  * - /changelog - Recent changes
  * - /ask [question] - AI-powered Q&A about YAKMESH
  * - /nodes - Check health of official YAKMESH nodes
+ * - /faq - Frequently asked questions
  * - /ping - Bot latency check
  * - Auto-greet new members
  * 
@@ -26,7 +27,7 @@ const config = {
   geminiKey: process.env.GEMINI_API_KEY,
   
   // Current version
-  version: '1.6.0',
+  version: '1.7.0',
   
   // Official YAKMESH nodes for health checks
   officialNodes: [
@@ -43,6 +44,7 @@ const config = {
     discord: 'https://discord.gg/8mSPfbJB8N',
     twitter: 'https://x.com/yakmesh_dev',
     telegram: 'https://t.me/yakmesh',
+    patreon: 'https://patreon.com/yakmesh',
   },
   
   // Brand colors
@@ -75,8 +77,9 @@ Protocol Stack (top to bottom):
 2. Annex - Encrypted point-to-point messaging (ML-KEM768 + AES-256-GCM)
 3. Gossip - Epidemic-style message propagation
 4. Beacon - Emergency broadcast with priority levels
-5. Phantom - Onion routing for anonymity
-6. Mesh - Core P2P network with Code Proof Protocol
+5. Nakpak - Onion routing for anonymity (Nested Anonymous Kernel for Private Authenticated Komms)
+6. Sherpa - Peer discovery DHT (Secure Hidden Endpoint Resolution Path Architecture)
+7. Mesh - Core P2P network with Code Proof Protocol
 
 Installation:
 npm install yakmesh
@@ -470,6 +473,7 @@ const commands = {
         { name: '💬 Discord', value: `[Join Server](${config.links.discord})`, inline: true },
         { name: '🐦 Twitter/X', value: `[@yakmesh](${config.links.twitter})`, inline: true },
         { name: '📱 Telegram', value: `[@yakmesh](${config.links.telegram})`, inline: true },
+        { name: '❤️ Patreon', value: `[Support Us](${config.links.patreon})`, inline: true },
       ],
       footer: 'YAKMESH™ - Sturdy & Secure',
     });
@@ -489,6 +493,7 @@ const commands = {
         { name: '📦 `/install`', value: 'Quick installation guide', inline: true },
         { name: '❓ `/ask <question>`', value: 'Ask YakBot about YAKMESH', inline: true },
         { name: '🔗 `/links`', value: 'All social and resource links', inline: true },
+        { name: '❔ `/faq`', value: 'Frequently asked questions', inline: true },
         { name: '🏓 `/ping`', value: 'Check bot latency', inline: true },
         { name: '📈 `/botstats`', value: 'View bot performance metrics', inline: true },
       ],
@@ -497,6 +502,48 @@ const commands = {
     await interaction.reply({ embeds: [embed] });
   },
   
+  // /faq - Frequently asked questions
+  async faq(interaction) {
+    const embed = createEmbed({
+      title: '❔ Frequently Asked Questions',
+      description: 'Common questions about YAKMESH',
+      fields: [
+        { 
+          name: '🦬 What is YAKMESH?', 
+          value: 'YAKMESH (Yielding Atomic Kernel Modular Encryption Secured Hub) is a post-quantum secure P2P mesh network designed for the 2026 threat landscape.',
+          inline: false,
+        },
+        { 
+          name: '🔐 What makes it "post-quantum"?', 
+          value: 'We use ML-DSA-65/87 (NIST FIPS 204) for signatures and ML-KEM-768/1024 (NIST FIPS 203) for key exchange. These algorithms are resistant to quantum computer attacks.',
+          inline: false,
+        },
+        { 
+          name: '💻 What are the requirements?', 
+          value: 'Node.js 18+ is required. Install with `npm install yakmesh`.',
+          inline: false,
+        },
+        { 
+          name: '🌐 How do nodes find each other?', 
+          value: 'Nodes with identical code share the same "network name" derived from the codebase hash. Gossip protocol handles peer discovery.',
+          inline: false,
+        },
+        { 
+          name: '🔒 Is traffic encrypted?', 
+          value: 'Yes! Annex provides ML-KEM768 key exchange + AES-256-GCM encryption with perfect forward secrecy for P2P channels.',
+          inline: false,
+        },
+        { 
+          name: '📦 Is it production ready?', 
+          value: 'YAKMESH is actively developed. Check releases for stable versions. Current: v' + config.version,
+          inline: false,
+        },
+      ],
+      footer: 'More questions? Use /ask <question> or check the docs!',
+    });
+    await interaction.reply({ embeds: [embed] });
+  },
+  
   // /botstats - Bot performance metrics
   async botstats(interaction) {
     const uptime = Date.now() - stats.startTime;

package/yakbot/register-commands.js

@@ -64,6 +64,10 @@ const commands = [
     .setName('help')
     .setDescription('Show all available YakBot commands'),
     
+  new SlashCommandBuilder()
+    .setName('faq')
+    .setDescription('Frequently asked questions about YAKMESH'),
+    
   new SlashCommandBuilder()
     .setName('botstats')
     .setDescription('View YakBot performance metrics and statistics'),