0.0.3: Add Bitcoin anchor support (--anchor flag)

Author: melvincarvalho

package.json

@@ -1,7 +1,7 @@
 {
   "name": "nostr-git-sync",
-  "version": "0.0.2",
-  "description": "Decentralized git sync daemon using Nostr (NIP-34)",
+  "version": "0.0.3",
+  "description": "Decentralized git sync daemon using Nostr (NIP-34) with optional Bitcoin anchoring",
   "type": "module",
   "main": "src/daemon.js",
   "bin": {
@@ -15,6 +15,9 @@
     "nostr-tools": "^2.19.4",
     "ws": "^8.18.0"
   },
+  "optionalDependencies": {
+    "blocktrails": "^0.0.10"
+  },
   "engines": {
     "node": ">=18.0.0"
   },
@@ -23,7 +26,10 @@
     "git",
     "sync",
     "decentralized",
-    "nip-34"
+    "nip-34",
+    "bitcoin",
+    "anchor",
+    "blocktrails"
   ],
   "license": "MIT"
 }

src/publish.js

@@ -8,10 +8,45 @@ const DEFAULT_RELAYS = [
   'wss://relay.nostr.band'
 ]
 
+/**
+ * Create Bitcoin anchor for commit using blocktrails
+ * Returns txo URI or null if anchoring fails/skipped
+ */
+async function createAnchor(commit, repoPath, options = {}) {
+  const { network = 'tbtc4', dryRun = false } = options
+
+  try {
+    const args = ['mark', commit]
+    if (dryRun) args.push('--dry')
+
+    const output = execSync(`blocktrails ${args.join(' ')}`, {
+      cwd: repoPath,
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    })
+
+    // Parse TXID from output: "TXID: <txid>"
+    const txidMatch = output.match(/TXID:\s*([a-f0-9]{64})/i)
+    if (txidMatch) {
+      const txid = txidMatch[1]
+      // Output is always vout 0 for mark command
+      return `txo:${network}:${txid}:0`
+    }
+
+    console.log('[anchor] Could not parse TXID from blocktrails output')
+    return null
+  } catch (err) {
+    console.log(`[anchor] Blocktrails not available or failed: ${err.message}`)
+    return null
+  }
+}
+
 /**
  * Publish a 30618 repo state event
  */
-export async function publishState(privateKeyHex, relays, repoId, repoPath) {
+export async function publishState(privateKeyHex, relays, repoId, repoPath, options = {}) {
+  const { anchor = false, network = 'tbtc4', dryRun = false } = options
+
   // Get current branch and commit
   const branch = execSync('git rev-parse --abbrev-ref HEAD', {
     cwd: repoPath,
@@ -23,14 +58,27 @@ export async function publishState(privateKeyHex, relays, repoId, repoPath) {
     encoding: 'utf-8'
   }).trim()
 
+  // Build tags
+  const tags = [
+    ['d', repoId],
+    [`refs/heads/${branch}`, commit]
+  ]
+
+  // Create Bitcoin anchor if requested
+  if (anchor) {
+    console.log(`[anchor] Creating Bitcoin anchor for ${commit.slice(0, 7)}...`)
+    const txoUri = await createAnchor(commit, repoPath, { network, dryRun })
+    if (txoUri) {
+      tags.push(['c', txoUri])
+      console.log(`[anchor] ✓ Anchored: ${txoUri}`)
+    }
+  }
+
   // Create and sign event
   const event = finalizeEvent({
     kind: 30618,
     created_at: Math.floor(Date.now() / 1000),
-    tags: [
-      ['d', repoId],
-      [`refs/heads/${branch}`, commit]
-    ],
+    tags,
     content: ''
   }, hexToBytes(privateKeyHex))
 
@@ -102,14 +150,43 @@ function hexToBytes(hex) {
 
 // CLI usage
 if (process.argv[1].endsWith('publish.js')) {
+  const args = process.argv.slice(2)
+  const flags = args.filter(a => a.startsWith('-'))
+  const positional = args.filter(a => !a.startsWith('-'))
+
+  const anchor = flags.includes('--anchor') || flags.includes('-a')
+  const help = flags.includes('--help') || flags.includes('-h')
+
+  if (help) {
+    console.log(`
+nostr-git-sync publish - Publish 30618 repo state event
+
+Usage:
+  node src/publish.js [options] [privkey] [repo-id] [repo-path]
+
+Options:
+  -a, --anchor    Create Bitcoin anchor (requires blocktrails CLI)
+  -h, --help      Show this help
+
+If no arguments provided, reads from git config:
+  git config nostr.privkey <hex>
+  git config nostr.repoid <id>  (optional, defaults to directory name)
+
+Examples:
+  node src/publish.js                      # Use git config
+  node src/publish.js --anchor             # With Bitcoin anchor
+  node src/publish.js <key> my-repo .      # Explicit args
+`)
+    process.exit(0)
+  }
+
   let privkey, repoId, repoPath = '.'
 
-  // Check args
-  if (process.argv[2] && !process.argv[2].startsWith('-')) {
+  if (positional.length > 0) {
     // Args provided: privkey repoId [repoPath]
-    privkey = process.argv[2]
-    repoId = process.argv[3]
-    repoPath = process.argv[4] || '.'
+    privkey = positional[0]
+    repoId = positional[1]
+    repoPath = positional[2] || '.'
   } else {
     // Read from git config
     try {
@@ -124,12 +201,12 @@ if (process.argv[1].endsWith('publish.js')) {
   }
 
   if (!privkey) {
-    console.log('Usage: node src/publish.js <privkey-hex> <repo-id> [repo-path]')
-    console.log('   or: git config nostr.privkey <hex> && node src/publish.js')
+    console.log('Usage: node src/publish.js [--anchor] <privkey-hex> <repo-id> [repo-path]')
+    console.log('   or: git config nostr.privkey <hex> && node src/publish.js [--anchor]')
     process.exit(1)
   }
 
-  publishState(privkey, DEFAULT_RELAYS, repoId, repoPath)
+  publishState(privkey, DEFAULT_RELAYS, repoId, repoPath, { anchor })
     .then(() => process.exit(0))
     .catch(err => {
       console.error('Error:', err.message)