@ruvector/edge-net 0.3.0 → 0.4.0

package/p2p.js

@@ -20,6 +20,7 @@ import { SignalingClient } from './signaling.js';
 import { SyncManager } from './sync.js';
 import { QDAG } from './qdag.js';
 import { Ledger } from './ledger.js';
+import { HybridBootstrap, FirebaseLedgerSync } from './firebase-signaling.js';
 
 // ============================================
 // P2P NETWORK CONFIGURATION
@@ -32,7 +33,10 @@ export const P2P_CONFIG = {
         webrtc: true,
         dht: true,
         sync: true,
+        firebase: true,  // Use Firebase for bootstrap
     },
+    // Bootstrap strategy: 'firebase' | 'local' | 'dht-only'
+    bootstrapStrategy: 'firebase',
     // Connection settings
     maxPeers: 50,
     minPeers: 3,
@@ -43,6 +47,18 @@ export const P2P_CONFIG = {
     dhtAnnounceInterval: 60000,
     // Sync settings
     syncInterval: 30000,
+    // Firebase settings (optional override)
+    firebase: {
+        // Default uses public edge-net Firebase
+        // Override with your own project for production
+        projectId: null,
+        apiKey: null,
+    },
+    // Migration thresholds
+    migration: {
+        dhtPeerThreshold: 5,   // Peers needed before reducing Firebase dependency
+        p2pPeerThreshold: 10,  // Peers needed for full P2P mode
+    },
 };
 
 // ============================================
@@ -75,6 +91,10 @@ export class P2PNetwork extends EventEmitter {
         this.qdag = null;
         this.ledger = null;
 
+        // Firebase bootstrap (Google Cloud)
+        this.hybridBootstrap = null;
+        this.firebaseLedgerSync = null;
+
         // State
         this.state = 'stopped';
         this.peers = new Map();
@@ -107,8 +127,12 @@ export class P2PNetwork extends EventEmitter {
             this.ledger = new Ledger({ nodeId: this.nodeId });
             console.log('   ✅ Ledger initialized');
 
-            // Try signaling server first
-            if (this.options.autoStart.signaling) {
+            // Start Firebase bootstrap (Google Cloud) - Primary path
+            if (this.options.autoStart.firebase && this.options.bootstrapStrategy === 'firebase') {
+                await this.startFirebaseBootstrap();
+            }
+            // Fallback: Try local signaling server
+            else if (this.options.autoStart.signaling) {
                 await this.startSignaling();
             }
 
@@ -127,6 +151,14 @@ export class P2PNetwork extends EventEmitter {
                 await this.startSync();
             }
 
+            // Start Firebase hybrid bootstrap after WebRTC/DHT are ready
+            if (this.hybridBootstrap && this.webrtc) {
+                await this.hybridBootstrap.start(this.webrtc, this.dht);
+
+                // Also start Firebase ledger sync
+                await this.startFirebaseLedgerSync();
+            }
+
             // Wire up event handlers
             this.setupEventHandlers();
 
@@ -159,6 +191,11 @@ export class P2PNetwork extends EventEmitter {
 
         this.state = 'stopping';
 
+        // Stop Firebase components
+        if (this.hybridBootstrap) await this.hybridBootstrap.stop();
+        if (this.firebaseLedgerSync) this.firebaseLedgerSync.stop();
+
+        // Stop P2P components
         if (this.syncManager) this.syncManager.stop();
         if (this.dht) this.dht.stop();
         if (this.webrtc) this.webrtc.close();
@@ -171,7 +208,69 @@ export class P2PNetwork extends EventEmitter {
     }
 
     /**
-     * Start signaling client
+     * Start Firebase hybrid bootstrap (Google Cloud)
+     * Primary bootstrap path - uses Firebase for discovery, migrates to P2P
+     */
+    async startFirebaseBootstrap() {
+        try {
+            this.hybridBootstrap = new HybridBootstrap({
+                peerId: this.nodeId,
+                firebaseConfig: this.options.firebase?.projectId ? {
+                    apiKey: this.options.firebase.apiKey,
+                    projectId: this.options.firebase.projectId,
+                    authDomain: `${this.options.firebase.projectId}.firebaseapp.com`,
+                    databaseURL: `https://${this.options.firebase.projectId}-default-rtdb.firebaseio.com`,
+                } : undefined,
+                dhtPeerThreshold: this.options.migration?.dhtPeerThreshold,
+                p2pPeerThreshold: this.options.migration?.p2pPeerThreshold,
+            });
+
+            // Wire up bootstrap events
+            this.hybridBootstrap.on('peer-discovered', ({ peerId, source }) => {
+                console.log(`   🔍 Discovered peer via ${source}: ${peerId.slice(0, 8)}...`);
+            });
+
+            this.hybridBootstrap.on('mode-changed', ({ from, to }) => {
+                console.log(`   🔄 Bootstrap mode: ${from} → ${to}`);
+                this.emit('bootstrap-mode-changed', { from, to });
+            });
+
+            // Start will be called after WebRTC/DHT init
+            console.log('   ✅ Firebase bootstrap initialized');
+
+        } catch (err) {
+            console.log('   ⚠️  Firebase bootstrap failed:', err.message);
+            // Fall back to local signaling
+            await this.startSignaling();
+        }
+    }
+
+    /**
+     * Start Firebase ledger sync
+     */
+    async startFirebaseLedgerSync() {
+        if (!this.ledger) return;
+
+        try {
+            this.firebaseLedgerSync = new FirebaseLedgerSync(this.ledger, {
+                peerId: this.nodeId,
+                firebaseConfig: this.options.firebase?.projectId ? {
+                    apiKey: this.options.firebase.apiKey,
+                    projectId: this.options.firebase.projectId,
+                } : undefined,
+                syncInterval: this.options.syncInterval,
+            });
+
+            await this.firebaseLedgerSync.start();
+            console.log('   ✅ Firebase ledger sync started');
+
+        } catch (err) {
+            console.log('   ⚠️  Firebase ledger sync failed:', err.message);
+        }
+    }
+
+    /**
+     * Start signaling client (fallback for local development)
      */
     async startSignaling() {
         try {
@@ -182,7 +281,7 @@ export class P2PNetwork extends EventEmitter {
 
             const connected = await this.signaling.connect();
             if (connected) {
-                console.log('   ✅ Signaling connected');
+                console.log('   ✅ Signaling connected (local)');
             } else {
                 console.log('   ⚠️  Signaling unavailable (will use DHT)');
             }
@@ -520,8 +619,18 @@ export class P2PNetwork extends EventEmitter {
 
     /**
      * Get connection mode
+     * Returns the current bootstrap/connectivity mode
      */
     getMode() {
+        // Check Firebase hybrid bootstrap mode first
+        if (this.hybridBootstrap) {
+            const bootstrapMode = this.hybridBootstrap.mode;
+            if (bootstrapMode === 'p2p') return 'full-p2p';
+            if (bootstrapMode === 'hybrid') return 'firebase-hybrid';
+            if (bootstrapMode === 'firebase') return 'firebase-bootstrap';
+        }
+
+        // Legacy mode detection
         if (this.webrtc?.mode === 'webrtc' && this.signaling?.isConnected) {
             return 'full-p2p';
         }
@@ -534,16 +643,32 @@ export class P2PNetwork extends EventEmitter {
         return 'local';
     }
 
+    /**
+     * Get bootstrap mode (firebase/hybrid/p2p)
+     */
+    getBootstrapMode() {
+        return this.hybridBootstrap?.mode || 'none';
+    }
+
     /**
      * Get network statistics
      */
     getStats() {
+        const bootstrapStats = this.hybridBootstrap?.getStats() || {};
+
         return {
             ...this.stats,
             nodeId: this.nodeId,
             state: this.state,
             mode: this.getMode(),
+            bootstrapMode: this.getBootstrapMode(),
             peers: this.peers.size,
+            // Firebase stats
+            firebaseConnected: bootstrapStats.firebaseConnected || false,
+            firebasePeers: bootstrapStats.firebasePeers || 0,
+            firebaseSignals: bootstrapStats.firebaseSignals || 0,
+            p2pSignals: bootstrapStats.p2pSignals || 0,
+            // Legacy signaling
             signalingConnected: this.signaling?.isConnected || false,
             webrtcMode: this.webrtc?.mode || 'none',
             dhtPeers: this.dht?.getPeers().length || 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruvector/edge-net",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Distributed compute intelligence network with AI agents and workers - contribute browser compute, spawn distributed AI agents, earn credits. Features Time Crystal coordination, Neural DAG attention, P2P swarm intelligence, ONNX inference, WebRTC signaling, CRDT ledger, and multi-agent workflows.",
   "main": "ruvector_edge_net.js",
@@ -10,7 +10,8 @@
     "edge-net": "./cli.js",
     "ruvector-edge": "./cli.js",
     "edge-net-join": "./join.js",
-    "edge-net-genesis": "./genesis.js"
+    "edge-net-genesis": "./genesis.js",
+    "edge-net-firebase-setup": "./firebase-setup.js"
   },
   "keywords": [
     "wasm",
@@ -49,7 +50,12 @@
     "kademlia",
     "genesis-node",
     "turn-server",
-    "nat-traversal"
+    "nat-traversal",
+    "google-cloud",
+    "firebase",
+    "gcloud",
+    "firestore",
+    "realtime-database"
   ],
   "author": "RuVector Team <team@ruvector.dev>",
   "license": "MIT",
@@ -88,6 +94,8 @@
     "dht.js",
     "genesis.js",
     "p2p.js",
+    "firebase-signaling.js",
+    "firebase-setup.js",
     "README.md",
     "LICENSE"
   ],
@@ -146,6 +154,12 @@
     },
     "./p2p": {
       "import": "./p2p.js"
+    },
+    "./firebase-signaling": {
+      "import": "./firebase-signaling.js"
+    },
+    "./firebase-setup": {
+      "import": "./firebase-setup.js"
     }
   },
   "sideEffects": [
@@ -168,11 +182,21 @@
     "genesis": "node genesis.js",
     "genesis:start": "node genesis.js --port 8787",
     "p2p": "node -e \"import('./p2p.js').then(m => m.createP2PNetwork({ nodeId: 'test' }))\"",
-    "monitor": "node -e \"import('./monitor.js').then(m => { const mon = new m.Monitor(); mon.start(); setInterval(() => console.log(JSON.stringify(mon.generateReport(), null, 2)), 5000); })\""
+    "monitor": "node -e \"import('./monitor.js').then(m => { const mon = new m.Monitor(); mon.start(); setInterval(() => console.log(JSON.stringify(mon.generateReport(), null, 2)), 5000); })\"",
+    "firebase:setup": "node firebase-setup.js",
+    "firebase:check": "node firebase-setup.js --check"
   },
   "dependencies": {
     "@ruvector/ruvllm": "^0.2.3",
     "@xenova/transformers": "^2.17.2",
     "ws": "^8.18.3"
+  },
+  "peerDependencies": {
+    "firebase": "^10.0.0"
+  },
+  "peerDependenciesMeta": {
+    "firebase": {
+      "optional": true
+    }
   }
 }