@1sat/cli 0.0.22 → 0.0.24

package/package.json

@@ -1,34 +1,41 @@
 {
-	"name": "@1sat/cli",
-	"version": "0.0.22",
-	"description": "CLI for 1Sat Ordinals SDK",
-	"type": "module",
-	"main": "./src/cli.ts",
-	"bin": {
-		"1sat": "./src/cli.ts"
-	},
-	"files": ["src"],
-	"scripts": {
-		"build": "bun build ./src/cli.ts --compile --outfile=bin/1sat --external pg --external pg-native --external pg-query-stream --external tedious --external oracledb --external mysql",
-		"dev": "bun run src/cli.ts",
-		"lint": "biome check src"
-	},
-	"keywords": ["1sat", "bsv", "ordinals", "cli"],
-	"license": "MIT",
-	"dependencies": {
-		"@1sat/actions": "0.0.82",
-		"@1sat/client": "0.0.20",
-		"@1sat/types": "0.0.14",
-		"@1sat/wallet-node": ">=0.0.13",
-		"@bsv/sdk": "^2.0.6",
-		"chalk": "^5.0.0",
-		"@clack/prompts": "^0.8.0",
-		"bitcoin-backup": "^0.0.11",
-		"dotenv": "^17.0.0",
-		"evlog": "^2.10.0"
-	},
-	"devDependencies": {
-		"@types/bun": "^1.3.9",
-		"typescript": "^5.9.3"
-	}
-}
+  "name": "@1sat/cli",
+  "version": "0.0.24",
+  "description": "CLI for 1Sat Ordinals SDK",
+  "type": "module",
+  "main": "./src/cli.ts",
+  "bin": {
+    "1sat": "./src/cli.ts"
+  },
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "build": "bun build ./src/cli.ts --compile --outfile=bin/1sat --external pg --external pg-native --external pg-query-stream --external tedious --external oracledb --external mysql",
+    "dev": "bun run src/cli.ts",
+    "lint": "biome check src"
+  },
+  "keywords": [
+    "1sat",
+    "bsv",
+    "ordinals",
+    "cli"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@1sat/actions": "0.0.85",
+    "@1sat/client": "0.0.20",
+    "@1sat/types": "0.0.16",
+    "@1sat/wallet-node": "0.0.23",
+    "@bsv/sdk": "^2.0.6",
+    "chalk": "^5.0.0",
+    "@clack/prompts": "^0.8.0",
+    "bitcoin-backup": "^0.0.11",
+    "dotenv": "^17.0.0",
+    "evlog": "^2.10.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.9",
+    "typescript": "^5.9.3"
+  }
+}

package/src/args.ts

@@ -93,7 +93,7 @@ export function extractFlags(args: string[], flag: string): string[] {
 			const value = args[i + 1]
 			if (value && !value.startsWith('--')) {
 				// Split comma-delimited values
-				values.push(...value.split(',').filter(v => v.length > 0))
+				values.push(...value.split(',').filter((v) => v.length > 0))
 			}
 		}
 	}

package/src/commands/config.ts

@@ -105,7 +105,9 @@ function configSet(args: string[], opts: GlobalFlags): void {
 	if (key === 'monitorIntervalMinutes') {
 		const n = Number(value)
 		if (!Number.isFinite(n) || n < 0) {
-			fatal('monitorIntervalMinutes must be a non-negative number (0 to disable)')
+			fatal(
+				'monitorIntervalMinutes must be a non-negative number (0 to disable)',
+			)
 		}
 	}
 

package/src/commands/identity.ts

@@ -4,7 +4,7 @@
  * BAP (Bitcoin Attestation Protocol) identity management.
  */
 
-import { publishIdentity, signBsm } from '@1sat/actions'
+import { publishIdentity, signBsm, updateProfile } from '@1sat/actions'
 import type { GlobalFlags } from '../args'
 import { extractFlag } from '../args'
 import { loadContext } from '../context'
@@ -21,6 +21,8 @@ export async function handleIdentityCommand(
 	switch (subcommand) {
 		case 'create':
 			return identityCreate(rest, opts)
+		case 'update-profile':
+			return identityUpdateProfile(rest, opts)
 		case 'info':
 			return identityInfo(rest, opts)
 		case 'sign':
@@ -30,6 +32,7 @@ export async function handleIdentityCommand(
 		default:
 			printCommandHelp('identity', {
 				create: 'Create/publish a BAP identity',
+				'update-profile': 'Update BAP identity profile (--profile <json>)',
 				info: 'Show BAP identity information',
 				sign: 'Sign a message with identity key (--message <text>)',
 				verify:
@@ -128,3 +131,36 @@ async function identityVerify(
 		'identity verify is not yet implemented (needs direct BSM.verify integration)',
 	)
 }
+
+async function identityUpdateProfile(
+	args: string[],
+	opts: GlobalFlags,
+): Promise<void> {
+	const profileStr = extractFlag(args, '--profile')
+
+	if (!profileStr) fatal('Missing --profile <json>')
+
+	let profile: Record<string, unknown>
+	try {
+		profile = JSON.parse(profileStr)
+	} catch {
+		fatal(`Invalid JSON in --profile: ${profileStr}`)
+	}
+
+	const privateKey = await loadKey(resolvePassword())
+	const { ctx, destroy } = await loadContext(privateKey, {
+		chain: opts.chain,
+	})
+
+	try {
+		const result = await updateProfile.execute(ctx, { profile })
+
+		if (result.error) {
+			fatal(result.error)
+		}
+
+		output(result, opts)
+	} finally {
+		await destroy()
+	}
+}

package/src/commands/mcp-proxy.ts

@@ -61,33 +61,54 @@ async function handshake(key: PrivateKey): Promise<Session> {
 	if (!res.ok) throw new Error(`Handshake failed: HTTP ${res.status}`)
 
 	const data = await res.json()
-	if (data.messageType !== 'initialResponse') throw new Error(`Unexpected: ${data.messageType}`)
+	if (data.messageType !== 'initialResponse')
+		throw new Error(`Unexpected: ${data.messageType}`)
 
 	const serverNonce = data.nonce as string
 	const deriver = new KeyDeriver(key)
 	const serverPub = deriver.derivePublicKey(
-		AUTH_PROTOCOL_ID, `${serverNonce} ${clientNonce}`, data.identityKey as string, false,
+		AUTH_PROTOCOL_ID,
+		`${serverNonce} ${clientNonce}`,
+		data.identityKey as string,
+		false,
 	)
 
 	const clientNonceBytes = toArray(clientNonce, 'base64')
 	const serverNonceBytes = toArray(serverNonce, 'base64')
-	const msgHash = Hash.sha256(Array.from(new Uint8Array([...clientNonceBytes, ...serverNonceBytes])))
+	const msgHash = Hash.sha256(
+		Array.from(new Uint8Array([...clientNonceBytes, ...serverNonceBytes])),
+	)
 
 	const sig = Signature.fromDER(data.signature as string, 'hex')
-	if (!serverPub.verify(Array.from(msgHash), sig)) throw new Error('Server signature verification failed')
+	if (!serverPub.verify(Array.from(msgHash), sig))
+		throw new Error('Server signature verification failed')
 
 	const log = createLogger({ context: 'auth' })
-	log.set({ event: 'handshake_complete', serverIdentityKey: (data.identityKey as string).slice(0, 16) })
+	log.set({
+		event: 'handshake_complete',
+		serverIdentityKey: (data.identityKey as string).slice(0, 16),
+	})
 	log.emit()
 
-	return { serverIdentityKey: data.identityKey as string, serverNonce, clientKey: key }
+	return {
+		serverIdentityKey: data.identityKey as string,
+		serverNonce,
+		clientKey: key,
+	}
 }
 
-function signHeaders(session: Session, pathname: string): Record<string, string> {
+function signHeaders(
+	session: Session,
+	pathname: string,
+): Record<string, string> {
 	const { serverIdentityKey, serverNonce, clientKey: key } = session
 	const nonce = generateNonce()
 	const deriver = new KeyDeriver(key)
-	const derivedKey = deriver.derivePrivateKey(AUTH_PROTOCOL_ID, `${nonce} ${serverNonce}`, serverIdentityKey)
+	const derivedKey = deriver.derivePrivateKey(
+		AUTH_PROTOCOL_ID,
+		`${nonce} ${serverNonce}`,
+		serverIdentityKey,
+	)
 	const payload = new TextEncoder().encode(pathname)
 	const msgHash = Hash.sha256(Array.from(payload))
 	const sig = derivedKey.sign(Array.from(msgHash))
@@ -109,7 +130,9 @@ export async function handleMcpProxyCommand(): Promise<void> {
 	} catch {
 		startLog.set({ event: 'server_unreachable', url: MCP_URL })
 		startLog.emit()
-		process.stderr.write(`[1sat mcp-proxy] Server not reachable at ${MCP_URL} — is 1Sat wallet running?\n`)
+		process.stderr.write(
+			`[1sat mcp-proxy] Server not reachable at ${MCP_URL} — is 1Sat wallet running?\n`,
+		)
 		process.exit(1)
 	}
 
@@ -156,7 +179,11 @@ export async function handleMcpProxyCommand(): Promise<void> {
 					method = JSON.parse(line).method
 				} catch {}
 
-				const res = await fetch(`${MCP_URL}/mcp`, { method: 'POST', headers, body: line })
+				const res = await fetch(`${MCP_URL}/mcp`, {
+					method: 'POST',
+					headers,
+					body: line,
+				})
 
 				const sessionHeader = res.headers.get('mcp-session-id')
 				if (sessionHeader) mcpSessionId = sessionHeader
@@ -202,13 +229,19 @@ export async function handleMcpProxyCommand(): Promise<void> {
 				}
 			} catch (err) {
 				const msg = err instanceof Error ? err.message : String(err)
-				reqLog.set({ event: 'request_failed', requestNum: requestCount, error: msg })
+				reqLog.set({
+					event: 'request_failed',
+					requestNum: requestCount,
+					error: msg,
+				})
 				reqLog.emit()
-				process.stdout.write(`${JSON.stringify({
-					jsonrpc: '2.0',
-					error: { code: -32000, message: `MCP proxy error: ${msg}` },
-					id: null,
-				})}\n`)
+				process.stdout.write(
+					`${JSON.stringify({
+						jsonrpc: '2.0',
+						error: { code: -32000, message: `MCP proxy error: ${msg}` },
+						id: null,
+					})}\n`,
+				)
 			}
 		}
 	}

package/src/commands/remote.ts

@@ -133,9 +133,11 @@ async function remoteList(_args: string[], opts: GlobalFlags): Promise<void> {
 	})
 
 	try {
-		const backups = walletResult.storage.getBackupStores?.() ?? []
 		const config = loadConfig()
 
+		// Use config.backups for display (remoteClients only populated for active connections)
+		const backupUrls = config.backups ?? []
+
 		// Use config for active determination — WalletStorageManager internal state
 		// can be misleading (a backup may appear as active after addWalletStorageProvider)
 		const isRemoteActive = Boolean(config.activeRemote)
@@ -144,7 +146,7 @@ async function remoteList(_args: string[], opts: GlobalFlags): Promise<void> {
 			output(
 				{
 					activeStorage: isRemoteActive ? 'remote' : 'local',
-					backups: walletResult.storage.getAllStores?.() ?? [],
+					backups: backupUrls,
 					config: {
 						activeRemote: config.activeRemote ?? null,
 						backups: config.backups ?? [],
@@ -156,27 +158,19 @@ async function remoteList(_args: string[], opts: GlobalFlags): Promise<void> {
 		}
 
 		console.log()
-		console.log(`  ${bold('Active Storage:')} ${isRemoteActive ? 'remote' : 'local'}`)
+		console.log(
+			`  ${bold('Active Storage:')} ${isRemoteActive ? 'remote' : 'local'}`,
+		)
 		if (isRemoteActive) {
-			console.log(
-				`  ${bold('Active Remote:')} ${config.activeRemote}`,
-			)
+			console.log(`  ${bold('Active Remote:')} ${config.activeRemote}`)
 		}
 		console.log()
-		if (backups.length === 0 && !config.backups?.length) {
+		if (backupUrls.length === 0 && !config.backups?.length) {
 			console.log('  No remote storages configured')
 		} else {
 			console.log(`  ${bold('Backups:')}`)
-			const known = new Set(config.backups ?? [])
-			for (const b of backups) {
-				const isKnown = known.has(b)
-				console.log(`    ${isKnown ? '●' : '○'} ${b}`)
-			}
-			// Show configured but not yet connected
-			for (const url of config.backups ?? []) {
-				if (!backups.includes(url)) {
-					console.log(`    ? ${url} (not connected)`)
-				}
+			for (const url of backupUrls) {
+				console.log(`    ● ${url}`)
 			}
 		}
 		console.log()

package/src/commands/sweep.ts

@@ -106,9 +106,7 @@ async function sweepScan(args: string[], opts: GlobalFlags): Promise<void> {
 			}
 		}
 
-		console.log(
-			`\n  ${formatLabel('RUN Tokens:')} ${result.run.length}`,
-		)
+		console.log(`\n  ${formatLabel('RUN Tokens:')} ${result.run.length}`)
 		if (result.run.length > 0) {
 			const runSats = result.run.reduce((sum, r) => sum + (r.satoshis ?? 0), 0)
 			console.log(
@@ -161,11 +159,15 @@ async function sweepImport(args: string[], opts: GlobalFlags): Promise<void> {
 
 		const hasFunding = scan.funding.length > 0
 		const hasOrdinals = scan.ordinals.length > 0
-		const hasTokens = scan.bsv21Tokens.some((t) => t.isActive && t.outputs.length > 0)
+		const hasTokens = scan.bsv21Tokens.some(
+			(t) => t.isActive && t.outputs.length > 0,
+		)
 
 		if (!hasFunding && !hasOrdinals && !hasTokens) {
 			if (scan.run.length > 0) {
-				fatal(`No sweepable UTXOs found at ${address} (${scan.run.length} RUN token output(s) excluded)`)
+				fatal(
+					`No sweepable UTXOs found at ${address} (${scan.run.length} RUN token output(s) excluded)`,
+				)
 			}
 			fatal(`No UTXOs found at ${address}`)
 		}

package/src/commands/wallet.ts

@@ -52,14 +52,17 @@ export async function handleWalletCommand(
 				send: 'Send BSV to an address (--to <addr> --sats <amount>)',
 				'send-all': 'Send all BSV to an address (--to <addr>)',
 				info: 'Show wallet info (address, balance, network)',
-				'list-outputs': 'List wallet outputs (--basket <name> [--tags <t1,t2>] [--limit N])',
-				'relinquish-output': 'Remove output from basket (--basket <name> --output <txid.vout>)',
+				'list-outputs':
+					'List wallet outputs (--basket <name> [--tags <t1,t2>] [--limit N] [--include-tags] [--include <val>])',
+				'relinquish-output':
+					'Remove output from basket (--basket <name> --output <txid.vout>)',
 				'list-actions': 'List wallet actions [--labels <l1,l2>] [--limit N]',
 				'create-action': 'Create action (JSON args)',
 				'sign-action': 'Sign action (JSON args)',
 				'abort-action': 'Abort action (--reference <ref>)',
 				'list-certificates': 'List certificates',
-				'relinquish-certificate': 'Relinquish certificate (--type <t> --serialNumber <s> --certifier <c>)',
+				'relinquish-certificate':
+					'Relinquish certificate (--type <t> --serialNumber <s> --certifier <c>)',
 			})
 			if (subcommand && subcommand !== 'help') {
 				process.exit(1)
@@ -244,17 +247,23 @@ async function walletInfo(_args: string[], opts: GlobalFlags): Promise<void> {
 
 // BRC-100 Interface Commands
 
-async function walletListOutputs(args: string[], opts: GlobalFlags): Promise<void> {
+async function walletListOutputs(
+	args: string[],
+	opts: GlobalFlags,
+): Promise<void> {
 	const basket = extractFlag(args, '--basket')
 	if (!basket) fatal('Missing required --basket <name>')
 
 	const tags = extractFlags(args, '--tags')
 	const limitStr = extractFlag(args, '--limit')
-	const limit = limitStr ? parseInt(limitStr, 10) : 10
+	const limit = limitStr ? Number.parseInt(limitStr, 10) : 10
 	if (!Number.isFinite(limit) || limit < 1 || limit > 10000) {
 		fatal('--limit must be between 1 and 10000')
 	}
 
+	const includeTags = args.includes('--include-tags')
+	const include = extractFlag(args, '--include')
+
 	const privateKey = await loadKey(resolvePassword())
 	const { ctx, destroy } = await loadContext(privateKey, {
 		chain: opts.chain,
@@ -264,6 +273,8 @@ async function walletListOutputs(args: string[], opts: GlobalFlags): Promise<voi
 		const listArgs: Parameters<typeof ctx.wallet.listOutputs>[0] = {
 			basket,
 			limit,
+			includeTags,
+			include,
 		}
 		if (tags.length > 0) {
 			listArgs.tags = tags
@@ -274,7 +285,9 @@ async function walletListOutputs(args: string[], opts: GlobalFlags): Promise<voi
 		if (opts.json) {
 			output(result, opts)
 		} else {
-			console.log(`\n${result.totalOutputs} total outputs in basket '${basket}':\n`)
+			console.log(
+				`\n${result.totalOutputs} total outputs in basket '${basket}':\n`,
+			)
 			for (const out of result.outputs) {
 				const tags = out.tags?.join(', ') || 'none'
 				console.log(`  ${out.outpoint} | ${out.satoshis} sats | tags: ${tags}`)
@@ -307,7 +320,10 @@ async function walletRelinquishOutput(
 	})
 
 	try {
-		const result = await ctx.wallet.relinquishOutput({ basket, output: outpoint })
+		const result = await ctx.wallet.relinquishOutput({
+			basket,
+			output: outpoint,
+		})
 
 		if (opts.json) {
 			output(result, opts)
@@ -319,10 +335,13 @@ async function walletRelinquishOutput(
 	}
 }
 
-async function walletListActions(args: string[], opts: GlobalFlags): Promise<void> {
+async function walletListActions(
+	args: string[],
+	opts: GlobalFlags,
+): Promise<void> {
 	const labels = extractFlags(args, '--labels')
 	const limitStr = extractFlag(args, '--limit')
-	const limit = limitStr ? parseInt(limitStr, 10) : 10
+	const limit = limitStr ? Number.parseInt(limitStr, 10) : 10
 	if (!Number.isFinite(limit) || limit < 1 || limit > 10000) {
 		fatal('--limit must be between 1 and 10000')
 	}
@@ -354,10 +373,14 @@ async function walletListActions(args: string[], opts: GlobalFlags): Promise<voi
 	}
 }
 
-async function walletCreateAction(args: string[], opts: GlobalFlags): Promise<void> {
+async function walletCreateAction(
+	args: string[],
+	opts: GlobalFlags,
+): Promise<void> {
 	const jsonInput = args[0]
 
-	if (!jsonInput) fatal('Missing JSON arguments. Usage: wallet create-action \'{...}\'')
+	if (!jsonInput)
+		fatal("Missing JSON arguments. Usage: wallet create-action '{...}'")
 
 	let actionArgs: Parameters<typeof ctx.wallet.createAction>[0]
 	try {
@@ -379,10 +402,14 @@ async function walletCreateAction(args: string[], opts: GlobalFlags): Promise<vo
 	}
 }
 
-async function walletSignAction(args: string[], opts: GlobalFlags): Promise<void> {
+async function walletSignAction(
+	args: string[],
+	opts: GlobalFlags,
+): Promise<void> {
 	const jsonInput = args[0]
 
-	if (!jsonInput) fatal('Missing JSON arguments. Usage: wallet sign-action \'{...}\'') 
+	if (!jsonInput)
+		fatal("Missing JSON arguments. Usage: wallet sign-action '{...}'")
 
 	let signArgs: Parameters<typeof ctx.wallet.signAction>[0]
 	try {
@@ -404,7 +431,10 @@ async function walletSignAction(args: string[], opts: GlobalFlags): Promise<void
 	}
 }
 
-async function walletAbortAction(args: string[], opts: GlobalFlags): Promise<void> {
+async function walletAbortAction(
+	args: string[],
+	opts: GlobalFlags,
+): Promise<void> {
 	const reference = extractFlag(args, '--reference')
 
 	if (!reference) fatal('Missing required --reference <ref>')
@@ -429,7 +459,7 @@ async function walletListCertificates(
 	const certifiers = extractFlags(args, '--certifiers')
 	const types = extractFlags(args, '--types')
 	const limitStr = extractFlag(args, '--limit')
-	const limit = limitStr ? parseInt(limitStr, 10) : 10
+	const limit = limitStr ? Number.parseInt(limitStr, 10) : 10
 
 	if (!Number.isFinite(limit) || limit < 1 || limit > 10000) {
 		fatal('--limit must be between 1 and 10000')

package/src/context.ts

@@ -38,7 +38,20 @@ async function runMonitorIfStale(
 	const intervalMs = intervalMinutes * 60 * 1000
 
 	if (elapsed >= intervalMs) {
-		await walletResult.monitor.runOnce()
+		const originalLog = console.log
+		const originalInfo = console.info
+		const originalWarn = console.warn
+		console.log = () => {}
+		console.info = () => {}
+		console.warn = () => {}
+
+		try {
+			await walletResult.monitor.runOnce()
+		} finally {
+			console.log = originalLog
+			console.info = originalInfo
+			console.warn = originalWarn
+		}
 		saveMonitorState({ lastMonitorRun: Date.now() })
 	}
 }

package/src/help.ts

@@ -85,6 +85,7 @@ ${bold('Locks:')}
 
 ${bold('Identity (BAP):')}
   ${cyan('identity create')}          Create a new BAP identity
+  ${cyan('identity update-profile')}  Update BAP identity profile (--profile <json>)
   ${cyan('identity info')}            Show identity information
   ${cyan('identity sign')}            Sign a message with identity key
   ${cyan('identity verify')}          Verify a signed message