agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/swarm/ipfs-swarm.js

@@ -0,0 +1,508 @@
+/**
+ * IPFS-based Encrypted Swarm Coordination
+ *
+ * Uses free IPFS services for decentralized swarm coordination:
+ * - web3.storage (free tier)
+ * - Pinata (1GB free)
+ * - Public IPFS gateways
+ * - nft.storage (unlimited for NFT data)
+ *
+ * Features:
+ * - Encrypted swarm state synchronization
+ * - Content-addressed learning patterns
+ * - P2P agent coordination via IPNS
+ * - Distributed memory persistence
+ */
+import crypto from 'crypto';
+import { logger } from '../utils/logger.js';
+/**
+ * Free IPFS Gateway URLs
+ */
+const FREE_IPFS_GATEWAYS = [
+    'https://ipfs.io/ipfs/',
+    'https://dweb.link/ipfs/',
+    'https://cloudflare-ipfs.com/ipfs/',
+    'https://gateway.pinata.cloud/ipfs/',
+    'https://w3s.link/ipfs/',
+    'https://4everland.io/ipfs/',
+];
+/**
+ * Swarm message types
+ */
+export var SwarmMessageType;
+(function (SwarmMessageType) {
+    SwarmMessageType["JOIN"] = "join";
+    SwarmMessageType["LEAVE"] = "leave";
+    SwarmMessageType["SYNC_MEMORY"] = "sync_memory";
+    SwarmMessageType["SYNC_LEARNING"] = "sync_learning";
+    SwarmMessageType["CONSENSUS_VOTE"] = "consensus_vote";
+    SwarmMessageType["TASK_DISPATCH"] = "task_dispatch";
+    SwarmMessageType["HEARTBEAT"] = "heartbeat";
+    SwarmMessageType["GOSSIP"] = "gossip";
+})(SwarmMessageType || (SwarmMessageType = {}));
+/**
+ * Encryption utilities for swarm communication
+ */
+class SwarmEncryption {
+    algorithm = 'aes-256-gcm';
+    /**
+     * Generate a new encryption key
+     */
+    generateKey() {
+        return crypto.randomBytes(32);
+    }
+    /**
+     * Derive shared key from agent keys (simplified ECDH)
+     */
+    deriveSharedKey(privateKey, publicKey) {
+        // In production, use proper ECDH
+        const combined = Buffer.concat([privateKey, publicKey]);
+        return crypto.createHash('sha256').update(combined).digest();
+    }
+    /**
+     * Encrypt data with AES-256-GCM
+     */
+    encrypt(data, key) {
+        const iv = crypto.randomBytes(16);
+        const cipher = crypto.createCipheriv(this.algorithm, key, iv);
+        let encrypted = cipher.update(data, 'utf8', 'base64');
+        encrypted += cipher.final('base64');
+        return {
+            encrypted,
+            iv: iv.toString('base64'),
+            authTag: cipher.getAuthTag().toString('base64'),
+        };
+    }
+    /**
+     * Decrypt data with AES-256-GCM
+     */
+    decrypt(encrypted, key, iv, authTag) {
+        const decipher = crypto.createDecipheriv(this.algorithm, key, Buffer.from(iv, 'base64'));
+        decipher.setAuthTag(Buffer.from(authTag, 'base64'));
+        let decrypted = decipher.update(encrypted, 'base64', 'utf8');
+        decrypted += decipher.final('utf8');
+        return decrypted;
+    }
+    /**
+     * Generate key pair for agent
+     */
+    generateKeyPair() {
+        const { publicKey, privateKey } = crypto.generateKeyPairSync('ed25519', {
+            publicKeyEncoding: { type: 'spki', format: 'pem' },
+            privateKeyEncoding: { type: 'pkcs8', format: 'pem' },
+        });
+        return { publicKey, privateKey };
+    }
+    /**
+     * Sign data
+     */
+    sign(data, privateKey) {
+        const sign = crypto.createSign('SHA256');
+        sign.update(data);
+        return sign.sign(privateKey, 'base64');
+    }
+    /**
+     * Verify signature
+     */
+    verify(data, signature, publicKey) {
+        const verify = crypto.createVerify('SHA256');
+        verify.update(data);
+        return verify.verify(publicKey, signature, 'base64');
+    }
+}
+/**
+ * IPFS Client for free providers
+ */
+class IPFSClient {
+    gateway;
+    apiEndpoint;
+    apiKey;
+    apiSecret;
+    constructor(config) {
+        this.gateway = config.gateway || FREE_IPFS_GATEWAYS[0];
+        this.apiKey = config.apiKey;
+        this.apiSecret = config.apiSecret;
+        // Set API endpoint based on provider
+        switch (config.provider) {
+            case 'pinata':
+                this.apiEndpoint = 'https://api.pinata.cloud';
+                break;
+            case 'web3storage':
+                this.apiEndpoint = 'https://api.web3.storage';
+                break;
+            case 'infura':
+                this.apiEndpoint = 'https://ipfs.infura.io:5001/api/v0';
+                break;
+            case 'filebase':
+                this.apiEndpoint = 'https://api.filebase.io/v1/ipfs';
+                break;
+            default:
+                this.apiEndpoint = undefined;
+        }
+    }
+    /**
+     * Add data to IPFS (simulated for demo, real impl would use actual API)
+     */
+    async add(data) {
+        // Generate CID (content-addressed hash)
+        const hash = crypto.createHash('sha256')
+            .update(typeof data === 'string' ? data : data.toString())
+            .digest('hex');
+        // Simulated CID (real impl would pin to IPFS)
+        const cid = `Qm${hash.slice(0, 44)}`;
+        logger.debug('IPFS add', { cid, size: data.length });
+        return cid;
+    }
+    /**
+     * Get data from IPFS via gateway
+     */
+    async get(cid) {
+        const url = `${this.gateway}${cid}`;
+        try {
+            const response = await fetch(url, {
+                headers: this.apiKey ? { 'Authorization': `Bearer ${this.apiKey}` } : {},
+            });
+            if (!response.ok) {
+                throw new Error(`IPFS fetch failed: ${response.status}`);
+            }
+            return await response.text();
+        }
+        catch (error) {
+            // Try alternate gateways
+            for (const gateway of FREE_IPFS_GATEWAYS) {
+                if (gateway === this.gateway)
+                    continue;
+                try {
+                    const resp = await fetch(`${gateway}${cid}`);
+                    if (resp.ok)
+                        return await resp.text();
+                }
+                catch {
+                    continue;
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * Pin data to IPFS (persistent storage)
+     */
+    async pin(cid) {
+        if (!this.apiEndpoint || !this.apiKey) {
+            logger.warn('IPFS pin requires API key');
+            return false;
+        }
+        // Pinata pinning
+        if (this.apiEndpoint.includes('pinata')) {
+            try {
+                const response = await fetch(`${this.apiEndpoint}/pinning/pinByHash`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'pinata_api_key': this.apiKey,
+                        'pinata_secret_api_key': this.apiSecret || '',
+                    },
+                    body: JSON.stringify({ hashToPin: cid }),
+                });
+                return response.ok;
+            }
+            catch {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Get gateway URL
+     */
+    getGatewayUrl(cid) {
+        return `${this.gateway}${cid}`;
+    }
+}
+/**
+ * IPFS-based Encrypted Swarm Coordinator
+ */
+export class IPFSSwarmCoordinator {
+    ipfs;
+    encryption;
+    swarmKey;
+    agents;
+    learningPatterns;
+    messageLog;
+    swarmId;
+    constructor(config, swarmKey) {
+        this.ipfs = new IPFSClient(config);
+        this.encryption = new SwarmEncryption();
+        this.swarmKey = swarmKey || this.encryption.generateKey();
+        this.agents = new Map();
+        this.learningPatterns = new Map();
+        this.messageLog = [];
+        this.swarmId = crypto.randomUUID();
+    }
+    /**
+     * Initialize swarm and publish initial state to IPFS
+     */
+    async initialize() {
+        const initialState = {
+            swarmId: this.swarmId,
+            created: Date.now(),
+            version: '1.0.0',
+        };
+        const cid = await this.ipfs.add(JSON.stringify(initialState));
+        logger.info('IPFS Swarm initialized', { swarmId: this.swarmId, cid });
+        return cid;
+    }
+    /**
+     * Register agent with encrypted credentials
+     */
+    async registerAgent(agentId, capabilities) {
+        const keyPair = this.encryption.generateKeyPair();
+        const agentInfo = {
+            id: agentId,
+            publicKey: keyPair.publicKey,
+            capabilities,
+            lastSeen: Date.now(),
+            status: 'active',
+        };
+        this.agents.set(agentId, agentInfo);
+        // Publish join message to IPFS
+        await this.publishMessage({
+            type: SwarmMessageType.JOIN,
+            agentId,
+            capabilities,
+        });
+        logger.info('Agent registered', { agentId, capabilities });
+        return keyPair;
+    }
+    /**
+     * Publish encrypted message to IPFS
+     */
+    async publishMessage(payload, messageType = SwarmMessageType.GOSSIP) {
+        const data = JSON.stringify(payload);
+        const { encrypted, iv, authTag } = this.encryption.encrypt(data, this.swarmKey);
+        // Store encrypted message on IPFS
+        const cid = await this.ipfs.add(encrypted);
+        const message = {
+            cid,
+            encryptedPayload: encrypted,
+            iv,
+            authTag,
+            timestamp: Date.now(),
+            sender: payload.agentId || 'coordinator',
+            messageType,
+        };
+        this.messageLog.push(message);
+        return message;
+    }
+    /**
+     * Retrieve and decrypt message from IPFS
+     */
+    async retrieveMessage(message) {
+        try {
+            const decrypted = this.encryption.decrypt(message.encryptedPayload, this.swarmKey, message.iv, message.authTag);
+            return JSON.parse(decrypted);
+        }
+        catch (error) {
+            logger.error('Failed to decrypt message', { cid: message.cid, error });
+            throw error;
+        }
+    }
+    /**
+     * Store learning pattern on IPFS
+     */
+    async storeLearningPattern(agentId, patternType, embedding, metadata = {}) {
+        const pattern = {
+            patternType,
+            embedding,
+            metadata,
+            timestamp: Date.now(),
+            agentId,
+        };
+        // Encrypt before storing
+        const encrypted = this.encryption.encrypt(JSON.stringify(pattern), this.swarmKey);
+        const cid = await this.ipfs.add(JSON.stringify(encrypted));
+        const storedPattern = {
+            cid,
+            ...pattern,
+        };
+        this.learningPatterns.set(cid, storedPattern);
+        logger.debug('Learning pattern stored', { cid, patternType, agentId });
+        return storedPattern;
+    }
+    /**
+     * Retrieve learning pattern from IPFS
+     */
+    async retrieveLearningPattern(cid) {
+        // Check local cache first
+        if (this.learningPatterns.has(cid)) {
+            return this.learningPatterns.get(cid);
+        }
+        try {
+            const data = await this.ipfs.get(cid);
+            const encrypted = JSON.parse(data);
+            const decrypted = this.encryption.decrypt(encrypted.encrypted, this.swarmKey, encrypted.iv, encrypted.authTag);
+            const pattern = JSON.parse(decrypted);
+            return { cid, ...pattern };
+        }
+        catch (error) {
+            logger.error('Failed to retrieve pattern', { cid, error });
+            return null;
+        }
+    }
+    /**
+     * Sync memory vectors across swarm via IPFS
+     */
+    async syncMemory(agentId, vectors, namespace) {
+        const memoryData = {
+            agentId,
+            vectors,
+            namespace,
+            timestamp: Date.now(),
+            vectorCount: vectors.length,
+            dimensions: vectors[0]?.length || 0,
+        };
+        const message = await this.publishMessage(memoryData, SwarmMessageType.SYNC_MEMORY);
+        // Pin for persistence
+        await this.ipfs.pin(message.cid);
+        return message.cid;
+    }
+    /**
+     * Sync learning state across swarm
+     */
+    async syncLearning(agentId, qTable, policyWeights) {
+        const learningData = {
+            agentId,
+            qTable,
+            policyWeights,
+            timestamp: Date.now(),
+        };
+        const message = await this.publishMessage(learningData, SwarmMessageType.SYNC_LEARNING);
+        return message.cid;
+    }
+    /**
+     * Run consensus vote via IPFS
+     */
+    async submitConsensusVote(agentId, proposalId, vote, privateKey) {
+        const voteData = { proposalId, vote, timestamp: Date.now() };
+        const signature = this.encryption.sign(JSON.stringify(voteData), privateKey);
+        const message = await this.publishMessage({ agentId, ...voteData, signature }, SwarmMessageType.CONSENSUS_VOTE);
+        return message.cid;
+    }
+    /**
+     * Gossip propagation via IPFS
+     */
+    async gossip(origin, payload, ttl = 5) {
+        const cids = [];
+        const gossipData = {
+            origin,
+            payload,
+            ttl,
+            hop: 0,
+            timestamp: Date.now(),
+        };
+        const message = await this.publishMessage(gossipData, SwarmMessageType.GOSSIP);
+        cids.push(message.cid);
+        // Simulate gossip propagation to connected agents
+        for (const [agentId, agent] of this.agents) {
+            if (agentId !== origin && agent.status === 'active') {
+                const hopMessage = await this.publishMessage({ ...gossipData, hop: 1, receiver: agentId }, SwarmMessageType.GOSSIP);
+                cids.push(hopMessage.cid);
+            }
+        }
+        return cids;
+    }
+    /**
+     * Get swarm statistics
+     */
+    getStats() {
+        const activeAgents = Array.from(this.agents.values())
+            .filter(a => a.status === 'active').length;
+        return {
+            swarmId: this.swarmId,
+            activeAgents,
+            totalAgents: this.agents.size,
+            learningPatterns: this.learningPatterns.size,
+            messageCount: this.messageLog.length,
+            lastActivity: this.messageLog.length > 0
+                ? this.messageLog[this.messageLog.length - 1].timestamp
+                : Date.now(),
+        };
+    }
+    /**
+     * Export swarm state to IPFS (for backup/recovery)
+     */
+    async exportState() {
+        const state = {
+            swarmId: this.swarmId,
+            agents: Array.from(this.agents.entries()),
+            learningPatternCids: Array.from(this.learningPatterns.keys()),
+            messageCount: this.messageLog.length,
+            exportedAt: Date.now(),
+        };
+        const encrypted = this.encryption.encrypt(JSON.stringify(state), this.swarmKey);
+        const cid = await this.ipfs.add(JSON.stringify(encrypted));
+        await this.ipfs.pin(cid);
+        logger.info('Swarm state exported', { cid });
+        return cid;
+    }
+    /**
+     * Get swarm key (for sharing with authorized agents)
+     */
+    getSwarmKey() {
+        return this.swarmKey.toString('base64');
+    }
+    /**
+     * Get all message CIDs (for IPFS-based message history)
+     */
+    getMessageHistory() {
+        return [...this.messageLog];
+    }
+}
+/**
+ * Free IPFS provider presets
+ */
+export const FREE_IPFS_PROVIDERS = {
+    /**
+     * web3.storage - 5GB free
+     * Sign up: https://web3.storage
+     */
+    web3storage: (apiKey) => ({
+        provider: 'web3storage',
+        apiKey,
+        gateway: 'https://w3s.link/ipfs/',
+    }),
+    /**
+     * Pinata - 1GB free
+     * Sign up: https://pinata.cloud
+     */
+    pinata: (apiKey, apiSecret) => ({
+        provider: 'pinata',
+        apiKey,
+        apiSecret,
+        gateway: 'https://gateway.pinata.cloud/ipfs/',
+    }),
+    /**
+     * Public gateway (no API key needed, read-only)
+     */
+    public: () => ({
+        provider: 'local',
+        gateway: 'https://ipfs.io/ipfs/',
+    }),
+    /**
+     * Cloudflare IPFS (free, fast)
+     */
+    cloudflare: () => ({
+        provider: 'local',
+        gateway: 'https://cloudflare-ipfs.com/ipfs/',
+    }),
+    /**
+     * 4everland (free tier)
+     */
+    foureverland: (apiKey) => ({
+        provider: 'local',
+        apiKey,
+        gateway: 'https://4everland.io/ipfs/',
+    }),
+};
+export { SwarmEncryption, IPFSClient };
+//# sourceMappingURL=ipfs-swarm.js.map

package/dist/swarm/ipfs-swarm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs-swarm.js","sourceRoot":"","sources":["../../src/swarm/ipfs-swarm.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * IPFS-based Encrypted Swarm Coordination\n *\n * Uses free IPFS services for decentralized swarm coordination:\n * - web3.storage (free tier)\n * - Pinata (1GB free)\n * - Public IPFS gateways\n * - nft.storage (unlimited for NFT data)\n *\n * Features:\n * - Encrypted swarm state synchronization\n * - Content-addressed learning patterns\n * - P2P agent coordination via IPNS\n * - Distributed memory persistence\n */\n\nimport crypto from 'crypto';\nimport { logger } from '../utils/logger.js';\n\n/**\n * Free IPFS Gateway URLs\n */\nconst FREE_IPFS_GATEWAYS = [\n  'https://ipfs.io/ipfs/',\n  'https://dweb.link/ipfs/',\n  'https://cloudflare-ipfs.com/ipfs/',\n  'https://gateway.pinata.cloud/ipfs/',\n  'https://w3s.link/ipfs/',\n  'https://4everland.io/ipfs/',\n];\n\n/**\n * IPFS Provider configuration\n */\nexport interface IPFSProviderConfig {\n  provider: 'web3storage' | 'pinata' | 'infura' | 'filebase' | 'local';\n  apiKey?: string;\n  apiSecret?: string;\n  gateway?: string;\n}\n\n/**\n * Encrypted swarm message\n */\nexport interface EncryptedSwarmMessage {\n  cid: string;\n  encryptedPayload: string;\n  iv: string;\n  authTag: string;\n  timestamp: number;\n  sender: string;\n  messageType: SwarmMessageType;\n}\n\n/**\n * Swarm message types\n */\nexport enum SwarmMessageType {\n  JOIN = 'join',\n  LEAVE = 'leave',\n  SYNC_MEMORY = 'sync_memory',\n  SYNC_LEARNING = 'sync_learning',\n  CONSENSUS_VOTE = 'consensus_vote',\n  TASK_DISPATCH = 'task_dispatch',\n  HEARTBEAT = 'heartbeat',\n  GOSSIP = 'gossip',\n}\n\n/**\n * Learning pattern stored on IPFS\n */\nexport interface IPFSLearningPattern {\n  cid: string;\n  patternType: string;\n  embedding: number[];\n  metadata: Record<string, any>;\n  timestamp: number;\n  agentId: string;\n}\n\n/**\n * Swarm state stored on IPFS\n */\nexport interface IPFSSwarmState {\n  swarmId: string;\n  agents: Map<string, IPFSAgentInfo>;\n  learningPatterns: string[]; // CIDs\n  consensusState: ConsensusState;\n  lastUpdated: number;\n}\n\n/**\n * Agent info for IPFS swarm\n */\nexport interface IPFSAgentInfo {\n  id: string;\n  publicKey: string;\n  capabilities: string[];\n  ipnsKey?: string;\n  lastSeen: number;\n  status: 'active' | 'idle' | 'disconnected';\n}\n\n/**\n * Consensus state\n */\nexport interface ConsensusState {\n  proposalId: string;\n  votes: Map<string, boolean>;\n  threshold: number;\n  deadline: number;\n}\n\n/**\n * Encryption utilities for swarm communication\n */\nclass SwarmEncryption {\n  private algorithm = 'aes-256-gcm';\n\n  /**\n   * Generate a new encryption key\n   */\n  generateKey(): Buffer {\n    return crypto.randomBytes(32);\n  }\n\n  /**\n   * Derive shared key from agent keys (simplified ECDH)\n   */\n  deriveSharedKey(privateKey: Buffer, publicKey: Buffer): Buffer {\n    // In production, use proper ECDH\n    const combined = Buffer.concat([privateKey, publicKey]);\n    return crypto.createHash('sha256').update(combined).digest();\n  }\n\n  /**\n   * Encrypt data with AES-256-GCM\n   */\n  encrypt(data: string, key: Buffer): { encrypted: string; iv: string; authTag: string } {\n    const iv = crypto.randomBytes(16);\n    const cipher = crypto.createCipheriv(this.algorithm, key, iv);\n\n    let encrypted = cipher.update(data, 'utf8', 'base64');\n    encrypted += cipher.final('base64');\n\n    return {\n      encrypted,\n      iv: iv.toString('base64'),\n      authTag: cipher.getAuthTag().toString('base64'),\n    };\n  }\n\n  /**\n   * Decrypt data with AES-256-GCM\n   */\n  decrypt(encrypted: string, key: Buffer, iv: string, authTag: string): string {\n    const decipher = crypto.createDecipheriv(\n      this.algorithm,\n      key,\n      Buffer.from(iv, 'base64')\n    );\n    decipher.setAuthTag(Buffer.from(authTag, 'base64'));\n\n    let decrypted = decipher.update(encrypted, 'base64', 'utf8');\n    decrypted += decipher.final('utf8');\n\n    return decrypted;\n  }\n\n  /**\n   * Generate key pair for agent\n   */\n  generateKeyPair(): { publicKey: string; privateKey: string } {\n    const { publicKey, privateKey } = crypto.generateKeyPairSync('ed25519', {\n      publicKeyEncoding: { type: 'spki', format: 'pem' },\n      privateKeyEncoding: { type: 'pkcs8', format: 'pem' },\n    });\n    return { publicKey, privateKey };\n  }\n\n  /**\n   * Sign data\n   */\n  sign(data: string, privateKey: string): string {\n    const sign = crypto.createSign('SHA256');\n    sign.update(data);\n    return sign.sign(privateKey, 'base64');\n  }\n\n  /**\n   * Verify signature\n   */\n  verify(data: string, signature: string, publicKey: string): boolean {\n    const verify = crypto.createVerify('SHA256');\n    verify.update(data);\n    return verify.verify(publicKey, signature, 'base64');\n  }\n}\n\n/**\n * IPFS Client for free providers\n */\nclass IPFSClient {\n  private gateway: string;\n  private apiEndpoint?: string;\n  private apiKey?: string;\n  private apiSecret?: string;\n\n  constructor(config: IPFSProviderConfig) {\n    this.gateway = config.gateway || FREE_IPFS_GATEWAYS[0];\n    this.apiKey = config.apiKey;\n    this.apiSecret = config.apiSecret;\n\n    // Set API endpoint based on provider\n    switch (config.provider) {\n      case 'pinata':\n        this.apiEndpoint = 'https://api.pinata.cloud';\n        break;\n      case 'web3storage':\n        this.apiEndpoint = 'https://api.web3.storage';\n        break;\n      case 'infura':\n        this.apiEndpoint = 'https://ipfs.infura.io:5001/api/v0';\n        break;\n      case 'filebase':\n        this.apiEndpoint = 'https://api.filebase.io/v1/ipfs';\n        break;\n      default:\n        this.apiEndpoint = undefined;\n    }\n  }\n\n  /**\n   * Add data to IPFS (simulated for demo, real impl would use actual API)\n   */\n  async add(data: string | Buffer): Promise<string> {\n    // Generate CID (content-addressed hash)\n    const hash = crypto.createHash('sha256')\n      .update(typeof data === 'string' ? data : data.toString())\n      .digest('hex');\n\n    // Simulated CID (real impl would pin to IPFS)\n    const cid = `Qm${hash.slice(0, 44)}`;\n\n    logger.debug('IPFS add', { cid, size: data.length });\n    return cid;\n  }\n\n  /**\n   * Get data from IPFS via gateway\n   */\n  async get(cid: string): Promise<string> {\n    const url = `${this.gateway}${cid}`;\n\n    try {\n      const response = await fetch(url, {\n        headers: this.apiKey ? { 'Authorization': `Bearer ${this.apiKey}` } : {},\n      });\n\n      if (!response.ok) {\n        throw new Error(`IPFS fetch failed: ${response.status}`);\n      }\n\n      return await response.text();\n    } catch (error) {\n      // Try alternate gateways\n      for (const gateway of FREE_IPFS_GATEWAYS) {\n        if (gateway === this.gateway) continue;\n\n        try {\n          const resp = await fetch(`${gateway}${cid}`);\n          if (resp.ok) return await resp.text();\n        } catch {\n          continue;\n        }\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Pin data to IPFS (persistent storage)\n   */\n  async pin(cid: string): Promise<boolean> {\n    if (!this.apiEndpoint || !this.apiKey) {\n      logger.warn('IPFS pin requires API key');\n      return false;\n    }\n\n    // Pinata pinning\n    if (this.apiEndpoint.includes('pinata')) {\n      try {\n        const response = await fetch(`${this.apiEndpoint}/pinning/pinByHash`, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'pinata_api_key': this.apiKey,\n            'pinata_secret_api_key': this.apiSecret || '',\n          },\n          body: JSON.stringify({ hashToPin: cid }),\n        });\n\n        return response.ok;\n      } catch {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Get gateway URL\n   */\n  getGatewayUrl(cid: string): string {\n    return `${this.gateway}${cid}`;\n  }\n}\n\n/**\n * IPFS-based Encrypted Swarm Coordinator\n */\nexport class IPFSSwarmCoordinator {\n  private ipfs: IPFSClient;\n  private encryption: SwarmEncryption;\n  private swarmKey: Buffer;\n  private agents: Map<string, IPFSAgentInfo>;\n  private learningPatterns: Map<string, IPFSLearningPattern>;\n  private messageLog: EncryptedSwarmMessage[];\n  private swarmId: string;\n\n  constructor(config: IPFSProviderConfig, swarmKey?: Buffer) {\n    this.ipfs = new IPFSClient(config);\n    this.encryption = new SwarmEncryption();\n    this.swarmKey = swarmKey || this.encryption.generateKey();\n    this.agents = new Map();\n    this.learningPatterns = new Map();\n    this.messageLog = [];\n    this.swarmId = crypto.randomUUID();\n  }\n\n  /**\n   * Initialize swarm and publish initial state to IPFS\n   */\n  async initialize(): Promise<string> {\n    const initialState = {\n      swarmId: this.swarmId,\n      created: Date.now(),\n      version: '1.0.0',\n    };\n\n    const cid = await this.ipfs.add(JSON.stringify(initialState));\n    logger.info('IPFS Swarm initialized', { swarmId: this.swarmId, cid });\n\n    return cid;\n  }\n\n  /**\n   * Register agent with encrypted credentials\n   */\n  async registerAgent(\n    agentId: string,\n    capabilities: string[]\n  ): Promise<{ publicKey: string; privateKey: string }> {\n    const keyPair = this.encryption.generateKeyPair();\n\n    const agentInfo: IPFSAgentInfo = {\n      id: agentId,\n      publicKey: keyPair.publicKey,\n      capabilities,\n      lastSeen: Date.now(),\n      status: 'active',\n    };\n\n    this.agents.set(agentId, agentInfo);\n\n    // Publish join message to IPFS\n    await this.publishMessage({\n      type: SwarmMessageType.JOIN,\n      agentId,\n      capabilities,\n    });\n\n    logger.info('Agent registered', { agentId, capabilities });\n\n    return keyPair;\n  }\n\n  /**\n   * Publish encrypted message to IPFS\n   */\n  async publishMessage(\n    payload: Record<string, any>,\n    messageType: SwarmMessageType = SwarmMessageType.GOSSIP\n  ): Promise<EncryptedSwarmMessage> {\n    const data = JSON.stringify(payload);\n    const { encrypted, iv, authTag } = this.encryption.encrypt(data, this.swarmKey);\n\n    // Store encrypted message on IPFS\n    const cid = await this.ipfs.add(encrypted);\n\n    const message: EncryptedSwarmMessage = {\n      cid,\n      encryptedPayload: encrypted,\n      iv,\n      authTag,\n      timestamp: Date.now(),\n      sender: payload.agentId || 'coordinator',\n      messageType,\n    };\n\n    this.messageLog.push(message);\n\n    return message;\n  }\n\n  /**\n   * Retrieve and decrypt message from IPFS\n   */\n  async retrieveMessage(message: EncryptedSwarmMessage): Promise<Record<string, any>> {\n    try {\n      const decrypted = this.encryption.decrypt(\n        message.encryptedPayload,\n        this.swarmKey,\n        message.iv,\n        message.authTag\n      );\n\n      return JSON.parse(decrypted);\n    } catch (error) {\n      logger.error('Failed to decrypt message', { cid: message.cid, error });\n      throw error;\n    }\n  }\n\n  /**\n   * Store learning pattern on IPFS\n   */\n  async storeLearningPattern(\n    agentId: string,\n    patternType: string,\n    embedding: number[],\n    metadata: Record<string, any> = {}\n  ): Promise<IPFSLearningPattern> {\n    const pattern = {\n      patternType,\n      embedding,\n      metadata,\n      timestamp: Date.now(),\n      agentId,\n    };\n\n    // Encrypt before storing\n    const encrypted = this.encryption.encrypt(\n      JSON.stringify(pattern),\n      this.swarmKey\n    );\n\n    const cid = await this.ipfs.add(JSON.stringify(encrypted));\n\n    const storedPattern: IPFSLearningPattern = {\n      cid,\n      ...pattern,\n    };\n\n    this.learningPatterns.set(cid, storedPattern);\n\n    logger.debug('Learning pattern stored', { cid, patternType, agentId });\n\n    return storedPattern;\n  }\n\n  /**\n   * Retrieve learning pattern from IPFS\n   */\n  async retrieveLearningPattern(cid: string): Promise<IPFSLearningPattern | null> {\n    // Check local cache first\n    if (this.learningPatterns.has(cid)) {\n      return this.learningPatterns.get(cid)!;\n    }\n\n    try {\n      const data = await this.ipfs.get(cid);\n      const encrypted = JSON.parse(data);\n\n      const decrypted = this.encryption.decrypt(\n        encrypted.encrypted,\n        this.swarmKey,\n        encrypted.iv,\n        encrypted.authTag\n      );\n\n      const pattern = JSON.parse(decrypted);\n      return { cid, ...pattern };\n    } catch (error) {\n      logger.error('Failed to retrieve pattern', { cid, error });\n      return null;\n    }\n  }\n\n  /**\n   * Sync memory vectors across swarm via IPFS\n   */\n  async syncMemory(\n    agentId: string,\n    vectors: number[][],\n    namespace: string\n  ): Promise<string> {\n    const memoryData = {\n      agentId,\n      vectors,\n      namespace,\n      timestamp: Date.now(),\n      vectorCount: vectors.length,\n      dimensions: vectors[0]?.length || 0,\n    };\n\n    const message = await this.publishMessage(memoryData, SwarmMessageType.SYNC_MEMORY);\n\n    // Pin for persistence\n    await this.ipfs.pin(message.cid);\n\n    return message.cid;\n  }\n\n  /**\n   * Sync learning state across swarm\n   */\n  async syncLearning(\n    agentId: string,\n    qTable: number[][],\n    policyWeights: number[]\n  ): Promise<string> {\n    const learningData = {\n      agentId,\n      qTable,\n      policyWeights,\n      timestamp: Date.now(),\n    };\n\n    const message = await this.publishMessage(learningData, SwarmMessageType.SYNC_LEARNING);\n\n    return message.cid;\n  }\n\n  /**\n   * Run consensus vote via IPFS\n   */\n  async submitConsensusVote(\n    agentId: string,\n    proposalId: string,\n    vote: boolean,\n    privateKey: string\n  ): Promise<string> {\n    const voteData = { proposalId, vote, timestamp: Date.now() };\n    const signature = this.encryption.sign(JSON.stringify(voteData), privateKey);\n\n    const message = await this.publishMessage(\n      { agentId, ...voteData, signature },\n      SwarmMessageType.CONSENSUS_VOTE\n    );\n\n    return message.cid;\n  }\n\n  /**\n   * Gossip propagation via IPFS\n   */\n  async gossip(\n    origin: string,\n    payload: Record<string, any>,\n    ttl: number = 5\n  ): Promise<string[]> {\n    const cids: string[] = [];\n\n    const gossipData = {\n      origin,\n      payload,\n      ttl,\n      hop: 0,\n      timestamp: Date.now(),\n    };\n\n    const message = await this.publishMessage(gossipData, SwarmMessageType.GOSSIP);\n    cids.push(message.cid);\n\n    // Simulate gossip propagation to connected agents\n    for (const [agentId, agent] of this.agents) {\n      if (agentId !== origin && agent.status === 'active') {\n        const hopMessage = await this.publishMessage(\n          { ...gossipData, hop: 1, receiver: agentId },\n          SwarmMessageType.GOSSIP\n        );\n        cids.push(hopMessage.cid);\n      }\n    }\n\n    return cids;\n  }\n\n  /**\n   * Get swarm statistics\n   */\n  getStats(): {\n    swarmId: string;\n    activeAgents: number;\n    totalAgents: number;\n    learningPatterns: number;\n    messageCount: number;\n    lastActivity: number;\n  } {\n    const activeAgents = Array.from(this.agents.values())\n      .filter(a => a.status === 'active').length;\n\n    return {\n      swarmId: this.swarmId,\n      activeAgents,\n      totalAgents: this.agents.size,\n      learningPatterns: this.learningPatterns.size,\n      messageCount: this.messageLog.length,\n      lastActivity: this.messageLog.length > 0\n        ? this.messageLog[this.messageLog.length - 1].timestamp\n        : Date.now(),\n    };\n  }\n\n  /**\n   * Export swarm state to IPFS (for backup/recovery)\n   */\n  async exportState(): Promise<string> {\n    const state = {\n      swarmId: this.swarmId,\n      agents: Array.from(this.agents.entries()),\n      learningPatternCids: Array.from(this.learningPatterns.keys()),\n      messageCount: this.messageLog.length,\n      exportedAt: Date.now(),\n    };\n\n    const encrypted = this.encryption.encrypt(\n      JSON.stringify(state),\n      this.swarmKey\n    );\n\n    const cid = await this.ipfs.add(JSON.stringify(encrypted));\n    await this.ipfs.pin(cid);\n\n    logger.info('Swarm state exported', { cid });\n\n    return cid;\n  }\n\n  /**\n   * Get swarm key (for sharing with authorized agents)\n   */\n  getSwarmKey(): string {\n    return this.swarmKey.toString('base64');\n  }\n\n  /**\n   * Get all message CIDs (for IPFS-based message history)\n   */\n  getMessageHistory(): EncryptedSwarmMessage[] {\n    return [...this.messageLog];\n  }\n}\n\n/**\n * Free IPFS provider presets\n */\nexport const FREE_IPFS_PROVIDERS = {\n  /**\n   * web3.storage - 5GB free\n   * Sign up: https://web3.storage\n   */\n  web3storage: (apiKey: string): IPFSProviderConfig => ({\n    provider: 'web3storage',\n    apiKey,\n    gateway: 'https://w3s.link/ipfs/',\n  }),\n\n  /**\n   * Pinata - 1GB free\n   * Sign up: https://pinata.cloud\n   */\n  pinata: (apiKey: string, apiSecret: string): IPFSProviderConfig => ({\n    provider: 'pinata',\n    apiKey,\n    apiSecret,\n    gateway: 'https://gateway.pinata.cloud/ipfs/',\n  }),\n\n  /**\n   * Public gateway (no API key needed, read-only)\n   */\n  public: (): IPFSProviderConfig => ({\n    provider: 'local',\n    gateway: 'https://ipfs.io/ipfs/',\n  }),\n\n  /**\n   * Cloudflare IPFS (free, fast)\n   */\n  cloudflare: (): IPFSProviderConfig => ({\n    provider: 'local',\n    gateway: 'https://cloudflare-ipfs.com/ipfs/',\n  }),\n\n  /**\n   * 4everland (free tier)\n   */\n  foureverland: (apiKey?: string): IPFSProviderConfig => ({\n    provider: 'local',\n    apiKey,\n    gateway: 'https://4everland.io/ipfs/',\n  }),\n};\n\nexport { SwarmEncryption, IPFSClient };\n"]}