indelible-mcp 3.7.0 → 3.9.0

package/README.md

@@ -1,6 +1,6 @@
 # Indelible MCP Server
 
-Blockchain-backed memory for Claude Code. Save your AI conversations permanently on BSV.
+Blockchain-backed memory for Claude Code. Save your AI conversations permanently on BSV via a federated mesh of SPV bridges.
 
 ## Quick Start
 
@@ -71,6 +71,12 @@ indelible-mcp hook post-compact  Post-compaction restore hook
 3. The signed transaction is broadcast via Indelible's SPV bridge
 4. Your private key **never** leaves your machine
 
+## Federation
+
+Indelible uses a multi-seed architecture — your saves and loads automatically try multiple federation bridges. If one bridge is down, the next picks up. No single point of failure.
+
+The federation mesh is powered by [Relay Federation](https://github.com/zcoolz/relay-federation).
+
 ## Security
 
 - **Zero-knowledge encryption** - your WIF-derived AES-256-GCM key encrypts all data before it touches the network

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "indelible-mcp",
-  "version": "3.7.0",
+  "version": "3.9.0",
   "description": "Blockchain-backed memory and code storage for Claude Code. Save AI conversations and source code permanently on BSV.",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -254,7 +254,7 @@ Commands:
 
 function printHelp() {
   console.log(`
-Indelible MCP — Blockchain memory for Claude Code (v3.7.0)
+Indelible MCP — Blockchain memory for Claude Code (v3.9.0)
 
 Setup:
   indelible-mcp setup --wif=KEY --pin=PIN    Import and encrypt your private key
@@ -466,7 +466,7 @@ function readStdin() {
 
 const SERVER_INFO = {
   name: 'indelible',
-  version: '3.7.0',
+  version: '3.9.0',
   description: 'Blockchain-backed memory and code storage for Claude Code'
 }
 

package/src/lib/api-client.js

@@ -4,6 +4,7 @@
  * Blockchain operations go through SPV bridge (see spv.js).
  */
 
+import { Transaction } from '@bsv/sdk'
 import { loadConfig } from './config.js'
 import * as spv from './spv.js'
 
@@ -185,8 +186,17 @@ export async function getLatestSessions(address, wif, limit = 3) {
       for (const txInfo of history) {
         if (sessions.length >= limit) break
         try {
-          const tx = await spv.getTx(txInfo.tx_hash)
-          const encrypted = spv.extractEncryptedFromTx(tx)
+          const rawHex = await spv.getRawTx(txInfo.tx_hash)
+          const tx = Transaction.fromHex(rawHex)
+          let encrypted = null
+          for (const output of tx.outputs) {
+            if (output.satoshis === 0) {
+              const hex = output.lockingScript.toHex()
+              const str = Buffer.from(hex, 'hex').toString('utf8')
+              const match = str.match(/([A-Za-z0-9+/=]{12,}):([A-Za-z0-9+/=]{20,}):([A-Za-z0-9+/=]{20,})/)
+              if (match) { encrypted = match[0]; break }
+            }
+          }
           if (encrypted) {
             sessions.push({
               txId: txInfo.tx_hash,

package/src/lib/spv.js

@@ -10,8 +10,12 @@
 import { Transaction, P2PKH, PrivateKey, SatoshisPerKilobyte, LockingScript, OP } from '@bsv/sdk'
 import { loadConfig, saveConfig } from './config.js'
 
-const GATEWAY_URL = 'http://155.138.238.167:8080'
-const GATEWAY_BRIDGE = { url: GATEWAY_URL, name: 'relay-gateway' }
+const SEED_BRIDGES = [
+  { url: 'http://149.28.243.56:9333', name: 'bridge-delta' },
+  { url: 'http://144.202.48.217:9333', name: 'bridge-alpha' },
+  { url: 'http://45.63.77.31:9333', name: 'bridge-beta' },
+  { url: 'http://45.63.70.235:9333', name: 'bridge-gamma' },
+]
 
 // Old individual bridge IPs — used to detect configs that need migration
 const OLD_BRIDGE_IPS = [
@@ -67,7 +71,7 @@ async function getBridges() {
       return OLD_BRIDGE_IPS.some(ip => url.includes(ip))
     })
     if (hasOldIps) {
-      bridges = [GATEWAY_BRIDGE]
+      bridges = [...SEED_BRIDGES]
       config.spv_bridges = bridges
       // Auto-generate relay key if missing
       if (!apiKey || !apiKey.startsWith('relay_sk_')) {
@@ -103,7 +107,7 @@ async function getBridges() {
       const result = await ensureRelayKey(config.address)
       if (result) {
         apiKey = result.key
-        config.spv_bridges = [GATEWAY_BRIDGE]
+        config.spv_bridges = [...SEED_BRIDGES]
         config.spv_api_key = apiKey
         saveConfig(config)
       }
@@ -111,7 +115,7 @@ async function getBridges() {
     migrationDone = true
   }
 
-  return [{ ...GATEWAY_BRIDGE, apiKey }]
+  return SEED_BRIDGES.map(b => ({ ...b, apiKey }))
 }
 
 async function spvFetch(path, options = {}) {
@@ -167,15 +171,8 @@ export async function checkHealth() {
 }
 
 export async function getUtxos(address) {
-  try {
-    const res = await spvFetch(`/api/address/${address}/unspent`)
-    if (res.ok) return res.json()
-  } catch { /* bridge unavailable */ }
-
-  // WoC lookup for address-based indexing
-  const wocRes = await fetch(`https://api.whatsonchain.com/v1/bsv/main/address/${address}/unspent`)
-  if (wocRes.ok) return wocRes.json()
-
+  const res = await spvFetch(`/api/address/${address}/unspent`)
+  if (res.ok) return res.json()
   throw new Error(`Failed to get UTXOs for ${address}`)
 }
 
@@ -249,6 +246,24 @@ export async function broadcastTx(rawTxHex) {
   throw new Error(`Broadcast failed on all bridges: ${errors.join(', ')}`)
 }
 
+/**
+ * Index session metadata on all federation bridges (best-effort).
+ * @param {object} sessionData — { txId, address, session_id, summary, message_count, save_type, timestamp, ... }
+ */
+export async function indexSessionOnBridge(sessionData) {
+  const bridges = await getBridges()
+  for (const bridge of bridges) {
+    try {
+      await fetch(`${bridge.url}/api/sessions/index`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(sessionData),
+        signal: AbortSignal.timeout(5000)
+      })
+    } catch {} // best-effort
+  }
+}
+
 function pushDataChunk(data) {
   const len = data.length
   let op

package/src/tools/load_context.js

@@ -11,6 +11,7 @@
 import { readFileSync, existsSync } from 'node:fs'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
+import { Transaction } from '@bsv/sdk'
 import { loadConfig, getWif } from '../lib/config.js'
 import { decrypt } from '../lib/crypto.js'
 import { getSessions } from '../lib/api-client.js'
@@ -152,28 +153,24 @@ function formatPreviousConversation(session) {
 }
 
 /**
- * Fetch encrypted data directly from a tx's OP_RETURN
- * Tries SPV bridge first, falls back to WhatsOnChain
+ * Fetch encrypted data directly from blockchain tx
+ * Uses getRawTx (federation bridge) — no WoC dependency
  */
 async function fetchEncryptedFromChain(txId) {
   const cleanTxId = txId.trim()
-
-  // Try SPV bridge
-  try {
-    const tx = await spv.getTx(cleanTxId)
-    const encrypted = spv.extractEncryptedFromTx(tx)
-    if (encrypted) return encrypted
-  } catch { /* fall through */ }
-
-  // Fallback: WhatsOnChain
   try {
-    const res = await fetch(`https://api.whatsonchain.com/v1/bsv/main/tx/${cleanTxId}`)
-    if (!res.ok) return null
-    const tx = await res.json()
-    return spv.extractEncryptedFromTx(tx)
-  } catch {
-    return null
-  }
+    const rawHex = await spv.getRawTx(cleanTxId)
+    const tx = Transaction.fromHex(rawHex)
+    for (const output of tx.outputs) {
+      if (output.satoshis === 0) {
+        const hex = output.lockingScript.toHex()
+        const str = Buffer.from(hex, 'hex').toString('utf8')
+        const match = str.match(/([A-Za-z0-9+/=]{12,}):([A-Za-z0-9+/=]{20,}):([A-Za-z0-9+/=]{20,})/)
+        if (match) return match[0]
+      }
+    }
+  } catch { /* failed */ }
+  return null
 }
 
 /**
@@ -222,8 +219,7 @@ export async function loadContext(numSessions = 5) {
           for (const tx of recent) {
             if (sessions.length >= numSessions) break
             try {
-              const txData = await spv.getTx(tx.tx_hash)
-              const encrypted = spv.extractEncryptedFromTx(txData)
+              const encrypted = await fetchEncryptedFromChain(tx.tx_hash)
               if (encrypted) {
                 sessions.push({ txId: tx.tx_hash, encrypted })
               }

package/src/tools/load_file.js

@@ -7,10 +7,28 @@
 import { writeFileSync } from 'node:fs'
 import { dirname } from 'node:path'
 import { mkdirSync, existsSync } from 'node:fs'
+import { Transaction } from '@bsv/sdk'
 import { getWif } from '../lib/config.js'
 import { decrypt, sha256 } from '../lib/crypto.js'
 import * as spv from '../lib/spv.js'
 
+/**
+ * Parse OP_RETURN JSON from raw tx hex — no WoC/getTx dependency
+ */
+function parseOpReturnJson(rawHex) {
+  const tx = Transaction.fromHex(rawHex)
+  for (const output of tx.outputs) {
+    if (output.satoshis === 0) {
+      const hex = output.lockingScript.toHex()
+      const str = Buffer.from(hex, 'hex').toString('utf8')
+      const jsonStart = str.indexOf('{')
+      if (jsonStart === -1) continue
+      try { return JSON.parse(str.slice(jsonStart)) } catch { continue }
+    }
+  }
+  return null
+}
+
 export async function loadFile(txId, options = {}) {
   const wif = await getWif()
   if (!wif) {
@@ -18,31 +36,16 @@ export async function loadFile(txId, options = {}) {
   }
 
   try {
-    const txData = await spv.getTx(txId)
-    if (!txData) {
+    const rawHex = await spv.getRawTx(txId)
+    if (!rawHex) {
       return { success: false, error: `Transaction not found: ${txId}` }
     }
 
-    // Extract OP_RETURN payload
-    const opReturn = txData.vout?.find(out => out.value === 0)
-    if (!opReturn) {
-      return { success: false, error: 'No OP_RETURN output found' }
-    }
-
-    const hex = opReturn.scriptPubKey?.hex
-    if (!hex) {
-      return { success: false, error: 'Empty script' }
-    }
-
-    // Parse JSON from OP_RETURN
-    const raw = Buffer.from(hex, 'hex').toString('utf8')
-    const jsonStart = raw.indexOf('{')
-    if (jsonStart === -1) {
+    const payload = parseOpReturnJson(rawHex)
+    if (!payload) {
       return { success: false, error: 'No JSON payload found in OP_RETURN' }
     }
 
-    const payload = JSON.parse(raw.slice(jsonStart))
-
     if (payload.protocol !== 'indelible.file') {
       return { success: false, error: `Not an indelible.file tx (got: ${payload.protocol || 'unknown'})` }
     }
@@ -57,15 +60,11 @@ export async function loadFile(txId, options = {}) {
         if (!chunkTxId) {
           return { success: false, error: `Missing chunk_${i} reference` }
         }
-        const chunkTx = await spv.getTx(chunkTxId)
-        const chunkOp = chunkTx?.vout?.find(out => out.value === 0)
-        const chunkHex = chunkOp?.scriptPubKey?.hex
-        if (!chunkHex) {
+        const chunkRawHex = await spv.getRawTx(chunkTxId)
+        const chunkData = parseOpReturnJson(chunkRawHex)
+        if (!chunkData || !chunkData.data) {
           return { success: false, error: `Chunk ${i} has no data` }
         }
-        const chunkRaw = Buffer.from(chunkHex, 'hex').toString('utf8')
-        const chunkJsonStart = chunkRaw.indexOf('{')
-        const chunkData = JSON.parse(chunkRaw.slice(chunkJsonStart))
         encryptedFull += chunkData.data
 
         if (i < payload._chunks) {

package/src/tools/load_project.js

@@ -6,6 +6,7 @@
 
 import { writeFileSync, mkdirSync, existsSync } from 'node:fs'
 import { join, dirname } from 'node:path'
+import { Transaction } from '@bsv/sdk'
 import { getWif } from '../lib/config.js'
 import { decrypt, sha256 } from '../lib/crypto.js'
 import * as spv from '../lib/spv.js'
@@ -18,19 +19,25 @@ export async function loadProject(txId, options = {}) {
   }
 
   try {
-    const txData = await spv.getTx(txId)
-    if (!txData) {
+    const rawHex = await spv.getRawTx(txId)
+    if (!rawHex) {
       return { success: false, error: `Manifest transaction not found: ${txId}` }
     }
 
-    // Extract OP_RETURN payload
-    const opReturn = txData.vout?.find(out => out.value === 0)
-    if (!opReturn) {
+    // Parse raw tx and extract OP_RETURN JSON payload
+    const txData = Transaction.fromHex(rawHex)
+    let raw = null
+    for (const output of txData.outputs) {
+      if (output.satoshis === 0) {
+        const hex = output.lockingScript.toHex()
+        raw = Buffer.from(hex, 'hex').toString('utf8')
+        break
+      }
+    }
+    if (!raw) {
       return { success: false, error: 'No OP_RETURN output found' }
     }
 
-    const hex = opReturn.scriptPubKey?.hex
-    const raw = Buffer.from(hex, 'hex').toString('utf8')
     const jsonStart = raw.indexOf('{')
     if (jsonStart === -1) {
       return { success: false, error: 'No JSON payload found in OP_RETURN' }

package/src/tools/load_style.js

@@ -7,58 +7,45 @@
  * Used by post-compact hook to reload rules after context compaction.
  */
 
+import { Transaction } from '@bsv/sdk'
 import { loadConfig, getWif } from '../lib/config.js'
 import { decrypt } from '../lib/crypto.js'
 import * as spv from '../lib/spv.js'
 
 /**
  * Fetch and extract encrypted style data from a blockchain tx.
- * Tries SPV bridge first, falls back to WhatsOnChain.
+ * Uses getRawTx (federation bridge) — no WoC dependency.
  *
  * @param {string} txId - Transaction ID
  * @returns {Promise<string|null>} Encrypted data string or null
  */
 async function fetchStyleFromChain(txId) {
   const cleanTxId = txId.trim()
-
-  // Try SPV bridge first
   try {
-    const tx = await spv.getTx(cleanTxId)
-    const encrypted = spv.extractEncryptedFromTx(tx)
-    if (encrypted) return encrypted
-  } catch {
-    // SPV bridge failed, try WhatsOnChain
-  }
+    const rawHex = await spv.getRawTx(cleanTxId)
+    const tx = Transaction.fromHex(rawHex)
+    for (const output of tx.outputs) {
+      if (output.satoshis === 0) {
+        const hex = output.lockingScript.toHex()
+        const str = Buffer.from(hex, 'hex').toString('utf8')
 
-  // Fallback: WhatsOnChain — parse OP_RETURN for JSON payload
-  try {
-    const res = await fetch(`https://api.whatsonchain.com/v1/bsv/main/tx/${cleanTxId}`)
-    if (!res.ok) return null
-    const tx = await res.json()
-    const opReturn = tx.vout?.find(out => out.value === 0)
-    if (!opReturn) return null
-    const hex = opReturn.scriptPubKey?.hex
-    if (!hex) return null
-    const str = Buffer.from(hex, 'hex').toString('utf8')
+        // Try JSON payload first (style format has encrypted field inside JSON)
+        try {
+          const jsonStart = str.indexOf('{')
+          if (jsonStart !== -1) {
+            const json = JSON.parse(str.slice(jsonStart))
+            if (json.protocol === 'indelible.style' && json.encrypted) {
+              return json.encrypted
+            }
+          }
+        } catch { /* not JSON, try raw */ }
 
-    // Try to parse as JSON payload (style format has encrypted field inside JSON)
-    try {
-      // Find the JSON object in the OP_RETURN data
-      const jsonStart = str.indexOf('{')
-      if (jsonStart === -1) return null
-      const json = JSON.parse(str.slice(jsonStart))
-      if (json.protocol === 'indelible.style' && json.encrypted) {
-        return json.encrypted
+        // Raw encrypted format (iv:tag:ciphertext)
+        const match = str.match(/([A-Za-z0-9+/=]{12,}):([A-Za-z0-9+/=]{20,}):([A-Za-z0-9+/=]{20,})/)
+        if (match) return match[0]
       }
-    } catch {
-      // Not JSON format, try raw encrypted format (iv:tag:ciphertext)
-      const match = str.match(/([A-Za-z0-9+/=]{12,}):([A-Za-z0-9+/=]{20,}):([A-Za-z0-9+/=]{20,})/)
-      return match ? match[0] : null
     }
-  } catch {
-    return null
-  }
-
+  } catch { /* failed */ }
   return null
 }
 

package/src/tools/save_session.js

@@ -527,19 +527,19 @@ export async function saveSession(transcriptPath, summary) {
   // Encrypt locally — WIF never leaves
   const sessionJson = JSON.stringify(session)
   process.stderr.write(`[indelible] Saving session (${(sessionJson.length / 1024).toFixed(0)} KB, rich_mode: ${richMode})\n`)
+
+  // Cost warning — estimate fee from JSON size (base64 + tx overhead ≈ 1.4x)
+  const COST_WARNING_SATS = 333_333 // ~$0.05 at $15/BSV
+  const estimatedFee = Math.ceil(sessionJson.length * 1.4)
+  if (estimatedFee > COST_WARNING_SATS) {
+    process.stderr.write(`[indelible] WARNING: Estimated cost ~${estimatedFee} sats (~$${(estimatedFee / 1e8 * 15).toFixed(2)}). Rich mode is ${richMode ? 'ON' : 'OFF'}. Set "rich_saves": false in config to reduce cost.\n`)
+  }
   const encrypted = encrypt(sessionJson, wif)
 
   // Build the blockchain payload
   const payload = {
     protocol: 'indelible.claude-code',
-    version: 2,
-    address: config.address,
-    session_id: sessionId,
-    prev_session_id: prevSessionId,
-    summary: session.summary,
-    message_count: session.message_count,
-    encrypted,
-    timestamp: session.created_at
+    encrypted
   }
 
   // Build + sign transaction LOCALLY with @bsv/sdk
@@ -567,6 +567,19 @@ export async function saveSession(transcriptPath, summary) {
       }, config)
     } catch { /* indexing failure doesn't block save */ }
 
+    // Index session on federation bridges (LevelDB)
+    try {
+      await spv.indexSessionOnBridge({
+        txId: finalTxId, address: config.address,
+        session_id: sessionId,
+        prev_session_id: prevSessionId,
+        summary: session.summary,
+        message_count: session.message_count,
+        save_type: isDelta ? 'delta' : 'full',
+        timestamp: session.created_at
+      })
+    } catch { /* bridge indexing failure doesn't block save */ }
+
     // Update session history with txId now that we have it
     const structuredCtx = session.structured_context || {}
     updateSessionHistory(