keychat-save 1.0.0

package/README.md

@@ -0,0 +1,53 @@
+# @keychat/save
+
+Save files and sessions to BSV blockchain. Sealed with your key, permanent on chain.
+
+## Install
+
+```bash
+npm install -g @keychat/save
+```
+
+## Setup
+
+```bash
+keychat-save init
+```
+
+This creates your identity at `~/.keychat/identity.wif` and shows your BSV address. Fund it with BSV to start saving.
+
+## Usage
+
+```bash
+# Save content
+keychat-save save "my notes" "content to save permanently"
+
+# Save a file
+keychat-save save "backup" --file ./myfile.txt
+
+# Pipe content in
+cat session.log | keychat-save save "session log" --stdin
+
+# Load all saves
+keychat-save load
+
+# Load most recent
+keychat-save load --last
+
+# Search
+keychat-save load --search "keyword"
+```
+
+## How it works
+
+Content is sealed with your identity key (ECIES) and broadcast as a transaction on BSV via [KeyChat](https://keychat.pro). Only your key can decrypt it. Saves are permanent and portable — load them on any device with your identity key.
+
+Cost: 0.25 Compute (125 sats) minimum, scales with content size.
+
+## Web UI
+
+You can also save and load from the browser at [keychat.pro](https://keychat.pro) — click **KeyChain** in the sidebar.
+
+## License
+
+MIT

package/index.mjs

@@ -0,0 +1,289 @@
+#!/usr/bin/env node
+/**
+ * @keychat/save — Save and load content to BSV blockchain via KeyChat.
+ *
+ * Usage:
+ *   keychat-save init                          Create identity (~/.keychat/identity.wif)
+ *   keychat-save save "label" "content"        Save content to chain
+ *   keychat-save save "label" --file path      Save file to chain
+ *   keychat-save save "label" --stdin          Pipe content in
+ *   keychat-save load                          List all saves
+ *   keychat-save load --last                   Most recent save
+ *   keychat-save load --search "keyword"       Search saves
+ *
+ * Identity stored at ~/.keychat/identity.wif
+ * Data sealed with your key, permanent on BSV. https://keychat.pro
+ */
+import { PrivateKey, Transaction, P2PKH, Script, SatoshisPerKilobyte, EncryptedMessage, PublicKey, Utils } from '@bsv/sdk'
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+const CONFIG_DIR = join(homedir(), '.keychat')
+const WIF_PATH = join(CONFIG_DIR, 'identity.wif')
+const BRIDGE = 'https://www.keychat.pro/api/bridge'
+const SAVE_PREFIX = '4b534156' // "KSAV"
+const VERSION = '01'
+const SUB_UNIT_SATS = 125
+
+// ── crypto ───────────────────────────────────────────────────────
+function bytesToHex (bytes) {
+  return Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('')
+}
+function hexToBytes (hex) {
+  const bytes = new Uint8Array(hex.length / 2)
+  for (let i = 0; i < hex.length; i += 2) bytes[i / 2] = parseInt(hex.substr(i, 2), 16)
+  return bytes
+}
+function encrypt (plaintext, privKey, pubHex) {
+  return EncryptedMessage.encrypt(Utils.toArray(plaintext, 'utf8'), privKey, PublicKey.fromString(pubHex))
+}
+function decrypt (encrypted, privKey) {
+  return Utils.toUTF8(EncryptedMessage.decrypt(encrypted, privKey))
+}
+
+// ── bridge API ───────────────────────────────────────────────────
+async function getUnspent (address) {
+  const res = await fetch(`${BRIDGE}/api/address/${address}/unspent`)
+  if (!res.ok) throw new Error(`unspent ${res.status}`)
+  const data = await res.json()
+  return data.map(u => ({
+    txid: u.tx_hash || u.txid,
+    vout: u.tx_pos ?? u.vout,
+    satoshis: u.value ?? u.satoshis,
+    height: u.height
+  }))
+}
+async function getTx (txid) {
+  const res = await fetch(`${BRIDGE}/api/tx/${txid}`)
+  if (!res.ok) throw new Error(`tx ${res.status}`)
+  return res.json()
+}
+async function getRawHex (txid) {
+  const res = await fetch(`${BRIDGE}/api/tx/${txid}/hex`)
+  if (!res.ok) throw new Error(`hex ${res.status}`)
+  const ct = res.headers.get('content-type') || ''
+  const data = ct.includes('json') ? await res.json() : await res.text()
+  return (typeof data === 'string' ? data.replace(/"/g, '') : data.hex)
+}
+async function broadcast (hex) {
+  const res = await fetch(`${BRIDGE}/api/broadcast`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ rawTx: hex })
+  })
+  const text = await res.text()
+  if (!res.ok) throw new Error(`broadcast ${res.status}: ${text}`)
+  try {
+    const p = JSON.parse(text)
+    return p.txid || p.hash || text
+  } catch { return text.replace(/"/g, '').trim() }
+}
+
+// ── OP_RETURN ────────────────────────────────────────────────────
+function buildOpReturn (parts) {
+  let hex = '006a'
+  for (const part of parts) {
+    const len = part.length / 2
+    if (len < 76) {
+      hex += len.toString(16).padStart(2, '0')
+    } else if (len < 256) {
+      hex += '4c' + len.toString(16).padStart(2, '0')
+    } else if (len < 65536) {
+      hex += '4d' + (len & 0xff).toString(16).padStart(2, '0') + ((len >> 8) & 0xff).toString(16).padStart(2, '0')
+    } else {
+      hex += '4e'
+      hex += (len & 0xff).toString(16).padStart(2, '0')
+      hex += ((len >> 8) & 0xff).toString(16).padStart(2, '0')
+      hex += ((len >> 16) & 0xff).toString(16).padStart(2, '0')
+      hex += ((len >>> 24) & 0xff).toString(16).padStart(2, '0')
+    }
+    hex += part
+  }
+  return Script.fromHex(hex)
+}
+function extractParts (scriptHex) {
+  let pos = scriptHex.startsWith('006a') ? 4 : scriptHex.startsWith('6a') ? 2 : -1
+  if (pos < 0) return null
+  const parts = []
+  while (pos < scriptHex.length) {
+    const op = parseInt(scriptHex.substr(pos, 2), 16)
+    pos += 2
+    let len
+    if (op <= 75) { len = op }
+    else if (op === 0x4c) { len = parseInt(scriptHex.substr(pos, 2), 16); pos += 2 }
+    else if (op === 0x4d) { len = parseInt(scriptHex.substr(pos, 2), 16) | (parseInt(scriptHex.substr(pos + 2, 2), 16) << 8); pos += 4 }
+    else if (op === 0x4e) { len = parseInt(scriptHex.substr(pos, 2), 16) | (parseInt(scriptHex.substr(pos + 2, 2), 16) << 8) | (parseInt(scriptHex.substr(pos + 4, 2), 16) << 16) | (parseInt(scriptHex.substr(pos + 6, 2), 16) << 24); pos += 8 }
+    else break
+    parts.push(scriptHex.substr(pos, len * 2))
+    pos += len * 2
+  }
+  return parts
+}
+
+// ── commands ─────────────────────────────────────────────────────
+async function cmdInit () {
+  if (existsSync(WIF_PATH)) {
+    const key = PrivateKey.fromWif(readFileSync(WIF_PATH, 'utf8').trim())
+    console.log(`Already initialized.`)
+    console.log(`Address: ${key.toPublicKey().toAddress()}`)
+    console.log(`WIF: ${WIF_PATH}`)
+    console.log(`Fund this address with BSV to start saving.`)
+    return
+  }
+  mkdirSync(CONFIG_DIR, { recursive: true })
+  const key = PrivateKey.fromRandom()
+  writeFileSync(WIF_PATH, key.toWif() + '\n', { mode: 0o600 })
+  console.log(`Initialized!`)
+  console.log(`Address: ${key.toPublicKey().toAddress()}`)
+  console.log(`WIF saved to: ${WIF_PATH}`)
+  console.log(`Fund this address with BSV to start saving.`)
+  console.log(`\nGet BSV at keychat.pro or any BSV wallet.`)
+}
+
+async function cmdSave (label, body) {
+  if (!existsSync(WIF_PATH)) { console.error('Run: keychat-save init'); process.exit(1) }
+  const key = PrivateKey.fromWif(readFileSync(WIF_PATH, 'utf8').trim())
+  const address = key.toPublicKey().toAddress()
+  const pubHex = key.toPublicKey().toString()
+
+  const envelope = JSON.stringify({ kv: 1, kind: 'save', label, body })
+  const encrypted = encrypt(envelope, key, pubHex)
+  const cipherHex = bytesToHex(encrypted)
+  const timestamp = Math.floor(Date.now() / 1000).toString(16).padStart(8, '0')
+  const opReturn = buildOpReturn([SAVE_PREFIX, VERSION, pubHex, cipherHex, timestamp])
+
+  const utxos = await getUnspent(address)
+  const usable = utxos.filter(u => u.satoshis >= 125 && u.satoshis <= 500).sort((a, b) => b.satoshis - a.satoshis)
+  if (!usable.length) throw new Error('No Compute UTXOs. Fund your address at keychat.pro and wait for packaging.')
+
+  const estBytes = 150 + cipherHex.length / 2 + 50
+  const rawFee = Math.ceil(estBytes * 100 / 1000)
+  const totalCost = Math.ceil(rawFee / SUB_UNIT_SATS) * SUB_UNIT_SATS
+  console.log(`  Cost: ${totalCost / 500} Compute (${totalCost} sats)`)
+
+  const picked = []
+  let sum = 0
+  for (const u of usable) {
+    picked.push(u)
+    sum += u.satoshis
+    if (sum >= totalCost) break
+  }
+  if (sum < totalCost) throw new Error(`Insufficient Compute. Need ${totalCost / 500}, have ${sum / 500}.`)
+
+  const tx = new Transaction()
+  for (const u of picked) {
+    tx.addInput({
+      sourceTransaction: Transaction.fromHex(await getRawHex(u.txid)),
+      sourceOutputIndex: u.vout,
+      unlockingScriptTemplate: new P2PKH().unlock(key)
+    })
+  }
+  tx.addOutput({ lockingScript: opReturn, satoshis: 0 })
+  const changeSats = sum - totalCost
+  if (changeSats > 0) {
+    tx.addOutput({ lockingScript: new P2PKH().lock(address), satoshis: changeSats })
+  }
+  await tx.sign()
+
+  const txid = await broadcast(tx.toHex())
+  console.log(`Saved to chain!`)
+  console.log(`  Label: ${label}`)
+  console.log(`  Size:  ${tx.toHex().length / 2} bytes`)
+  console.log(`  Tx:    ${txid}`)
+}
+
+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())
+  const address = key.toPublicKey().toAddress()
+  const pubHex = key.toPublicKey().toString()
+
+  const utxos = await getUnspent(address)
+  const seenTxids = new Set()
+  const saves = []
+
+  for (const u of utxos) {
+    if (seenTxids.has(u.txid)) continue
+    seenTxids.add(u.txid)
+    try {
+      const txData = await getTx(u.txid)
+      let opReturnHex = null
+      for (const out of (txData.outputs || [])) {
+        const script = out.script || out.scriptPubKey?.hex || ''
+        if (script.startsWith('006a') || script.startsWith('6a') || out.satoshis === 0) {
+          opReturnHex = script; break
+        }
+      }
+      if (!opReturnHex) continue
+      const parts = extractParts(opReturnHex)
+      if (!parts || parts.length < 5 || parts[0] !== SAVE_PREFIX || parts[1] !== VERSION) continue
+      const [,, senderPub, cipherHex, tsHex] = parts
+      if (senderPub !== pubHex) continue
+      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 {}
+      saves.push({ txid: u.txid, label, body, timestamp: parseInt(tsHex, 16) })
+    } catch {}
+  }
+
+  saves.sort((a, b) => b.timestamp - a.timestamp)
+  if (!saves.length) { console.log('No saves found.'); return }
+
+  if (opts.last) {
+    const s = saves[0]
+    console.log(`[${s.label}] — ${new Date(s.timestamp * 1000).toLocaleString()}`)
+    console.log(s.body)
+    return
+  }
+  if (opts.search) {
+    const q = opts.search.toLowerCase()
+    const matches = saves.filter(s => s.label.toLowerCase().includes(q) || s.body.toLowerCase().includes(q))
+    if (!matches.length) { console.log(`No saves matching "${opts.search}".`); return }
+    for (const s of matches) {
+      console.log(`\n--- ${s.label} (${new Date(s.timestamp * 1000).toLocaleString()}) [${s.txid.slice(0, 12)}…] ---`)
+      console.log(s.body.length > 500 ? s.body.slice(0, 500) + '…' : s.body)
+    }
+    return
+  }
+  for (const s of saves) {
+    console.log(`\n--- ${s.label} (${new Date(s.timestamp * 1000).toLocaleString()}) [${s.txid.slice(0, 12)}…] ---`)
+    console.log(s.body.length > 500 ? s.body.slice(0, 500) + '…' : s.body)
+  }
+}
+
+// ── main ─────────────────────────────────────────────────────────
+const [,, cmd, ...args] = process.argv
+
+if (cmd === 'init') {
+  await cmdInit()
+} else if (cmd === 'save') {
+  let label = args[0] || 'Untitled'
+  let body
+  if (args[1] === '--file') { body = readFileSync(args[2], 'utf8') }
+  else if (args[1] === '--stdin') { body = readFileSync(0, 'utf8') }
+  else { body = args.slice(1).join(' ') }
+  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)
+} else {
+  console.log(`keychat-save — Save to BSV blockchain via KeyChat (keychat.pro)
+
+Commands:
+  init                          Create identity (~/.keychat/identity.wif)
+  save "label" "content"        Save content to chain
+  save "label" --file path      Save file to chain
+  save "label" --stdin          Pipe content in
+  load                          List all saves
+  load --last                   Most recent save
+  load --search "keyword"       Search saves
+
+Your data. Your key. Permanent on BSV.`)
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "keychat-save",
+  "version": "1.0.0",
+  "description": "Save and load files to BSV blockchain via KeyChat",
+  "type": "module",
+  "bin": {
+    "keychat-save": "./index.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@bsv/sdk": "^1.0.0"
+  },
+  "keywords": ["bsv", "blockchain", "keychat", "save", "encrypt", "bitcoin"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/avaziri93/keychat-save"
+  },
+  "homepage": "https://keychat.pro"
+}