keychat-save 1.0.0 → 1.2.0

package/index.mjs

@@ -21,10 +21,12 @@ import { join } from 'node:path'
 
 const CONFIG_DIR = join(homedir(), '.keychat')
 const WIF_PATH = join(CONFIG_DIR, 'identity.wif')
+const INDEX_PATH = join(CONFIG_DIR, 'saves-index.md')
 const BRIDGE = 'https://www.keychat.pro/api/bridge'
 const SAVE_PREFIX = '4b534156' // "KSAV"
 const VERSION = '01'
 const SUB_UNIT_SATS = 125
+const INDEX_MARKER = '\n\n## __SAVES_INDEX__\n'
 
 // ── crypto ───────────────────────────────────────────────────────
 function bytesToHex (bytes) {
@@ -147,7 +149,13 @@ async function cmdSave (label, body) {
   const address = key.toPublicKey().toAddress()
   const pubHex = key.toPublicKey().toString()
 
-  const envelope = JSON.stringify({ kv: 1, kind: 'save', label, body })
+  // Bundle the local saves index into every save body so any single save
+  // bootstraps the full chain on a fresh device.
+  let index = ''
+  try { index = readFileSync(INDEX_PATH, 'utf8') } catch {}
+  const fullBody = body + INDEX_MARKER + index
+
+  const envelope = JSON.stringify({ kv: 1, kind: 'save', label, body: fullBody })
   const encrypted = encrypt(envelope, key, pubHex)
   const cipherHex = bytesToHex(encrypted)
   const timestamp = Math.floor(Date.now() / 1000).toString(16).padStart(8, '0')
@@ -187,12 +195,70 @@ async function cmdSave (label, body) {
   await tx.sign()
 
   const txid = await broadcast(tx.toHex())
+
+  // Prepend new entry to local saves index
+  const date = new Date().toISOString().slice(0, 10)
+  const computeCost = (totalCost / 500).toString()
+  const newRow = `| ${date} | ${label} | ${txid} | ${computeCost}C |\n`
+  let header = '# KeyChat saves index\n\n| Date | Label | TxID | Cost |\n|------|-------|------|------|\n'
+  let existing = ''
+  try {
+    const cur = readFileSync(INDEX_PATH, 'utf8')
+    // Strip header if present, keep existing rows
+    const tableStart = cur.indexOf('|------|-------|------|------|')
+    existing = tableStart >= 0 ? cur.slice(tableStart + '|------|-------|------|------|'.length).trim() + '\n' : cur
+  } catch {}
+  writeFileSync(INDEX_PATH, header + newRow + existing, { mode: 0o600 })
+
   console.log(`Saved to chain!`)
   console.log(`  Label: ${label}`)
   console.log(`  Size:  ${tx.toHex().length / 2} bytes`)
   console.log(`  Tx:    ${txid}`)
 }
 
+async function cmdLoadByTxid (txid) {
+  if (!existsSync(WIF_PATH)) { console.error('Run: keychat-save init'); process.exit(1) }
+  const key = PrivateKey.fromWif(readFileSync(WIF_PATH, 'utf8').trim())
+  const tx = await getTx(txid)
+  let opReturnHex = null
+  for (const o of (tx.outputs || [])) {
+    const s = o.script || ''
+    if (s.startsWith('006a') || s.startsWith('6a') || o.satoshis === 0) { opReturnHex = s; break }
+  }
+  if (!opReturnHex) { console.error('No OP_RETURN in tx.'); process.exit(1) }
+  const parts = extractParts(opReturnHex)
+  if (!parts || parts.length < 5 || parts[0] !== SAVE_PREFIX || parts[1] !== VERSION) {
+    console.error('Not a KSAV save tx.'); process.exit(1)
+  }
+  const cipherHex = parts[3]
+  const tsHex = parts[4]
+  const decrypted = decrypt(Array.from(hexToBytes(cipherHex)), key)
+  let label = 'Untitled', body = decrypted
+  try {
+    const env = JSON.parse(decrypted)
+    if (env.kind === 'save') { label = env.label || 'Untitled'; body = env.body || '' }
+  } catch {}
+
+  // Extract embedded saves index. Only write to local file if local is
+  // missing (fresh device bootstrap). Existing local index is left alone
+  // so loading an older save can't wipe out newer entries.
+  const idx = body.indexOf(INDEX_MARKER)
+  let userBody = body
+  if (idx >= 0) {
+    userBody = body.slice(0, idx)
+    const embeddedIndex = body.slice(idx + INDEX_MARKER.length).trim()
+    if (embeddedIndex && !existsSync(INDEX_PATH)) {
+      try {
+        writeFileSync(INDEX_PATH, embeddedIndex + '\n', { mode: 0o600 })
+        console.error(`(restored saves index to ${INDEX_PATH})`)
+      } catch {}
+    }
+  }
+
+  console.log(`[${label}] — ${new Date(parseInt(tsHex, 16) * 1000).toLocaleString()}`)
+  console.log(userBody)
+}
+
 async function cmdLoad (opts = {}) {
   if (!existsSync(WIF_PATH)) { console.error('Run: keychat-save init'); process.exit(1) }
   const key = PrivateKey.fromWif(readFileSync(WIF_PATH, 'utf8').trim())
@@ -269,10 +335,16 @@ if (cmd === 'init') {
   if (!body) { console.error('Usage: keychat-save save "label" "content"'); process.exit(1) }
   await cmdSave(label, body)
 } else if (cmd === 'load') {
-  const opts = {}
-  if (args.includes('--last')) opts.last = true
-  if (args.includes('--search')) opts.search = args[args.indexOf('--search') + 1]
-  await cmdLoad(opts)
+  // Direct txid lookup — instant, no history scan
+  const txidIdx = args.indexOf('--txid')
+  if (txidIdx >= 0 && args[txidIdx + 1]) {
+    await cmdLoadByTxid(args[txidIdx + 1])
+  } else {
+    const opts = {}
+    if (args.includes('--last')) opts.last = true
+    if (args.includes('--search')) opts.search = args[args.indexOf('--search') + 1]
+    await cmdLoad(opts)
+  }
 } else {
   console.log(`keychat-save — Save to BSV blockchain via KeyChat (keychat.pro)
 
@@ -284,6 +356,7 @@ Commands:
   load                          List all saves
   load --last                   Most recent save
   load --search "keyword"       Search saves
+  load --txid <txid>            Load a specific save by txid (instant, no scan)
 
 Your data. Your key. Permanent on BSV.`)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keychat-save",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Save and load files to BSV blockchain via KeyChat",
   "type": "module",
   "bin": {