@1sat/cli 0.0.75 → 0.0.77

package/README.md

@@ -72,6 +72,12 @@ export PRIVATE_KEY_WIF="<your WIF key>"
 1sat wallet balance
 ```
 
+**Env file** (same keys as above; file values override the process environment for this run):
+
+```bash
+1sat --env-file mint.env wallet balance
+```
+
 **Encrypted keyfile (interactive use):**
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@1sat/cli",
-	"version": "0.0.75",
+	"version": "0.0.77",
 	"description": "CLI for 1Sat Ordinals SDK",
 	"type": "module",
 	"main": "./src/cli.ts",
@@ -26,12 +26,12 @@
 	],
 	"license": "MIT",
 	"dependencies": {
-		"@1sat/actions": "0.0.173",
+		"@1sat/actions": "0.0.184",
 		"@1sat/client": "0.0.42",
-		"@1sat/types": "0.0.33",
-		"@1sat/wallet-node": "0.0.56",
-		"@1sat/wallet-server": "0.0.25",
-		"@bsv/sdk": "^2.0.13",
+		"@1sat/types": "0.0.34",
+		"@1sat/wallet-node": "0.0.57",
+		"@1sat/wallet-server": "0.0.26",
+		"@bsv/sdk": "^2.1.6",
 		"@bsv/wallet-toolbox": "2.1.24",
 		"chalk": "^5.0.0",
 		"@clack/prompts": "^0.8.0",

package/src/args.ts

@@ -9,6 +9,8 @@ export interface GlobalFlags {
 	quiet: boolean
 	yes: boolean
 	chain: 'main' | 'test'
+	/** Paths from `--env-file` / `--env-file=path` (may be empty). */
+	envFiles: string[]
 	help: boolean
 	version: boolean
 	rest: string[]
@@ -24,6 +26,7 @@ export function parseGlobalFlags(args: string[]): GlobalFlags {
 	let chain: 'main' | 'test' = 'main'
 	let help = false
 	let version = false
+	const envFiles: string[] = []
 	const rest: string[] = []
 	const skip = new Set<number>()
 
@@ -56,6 +59,15 @@ export function parseGlobalFlags(args: string[]): GlobalFlags {
 				}
 				break
 			}
+			case '--env-file': {
+				const value = args[i + 1]
+				if (!value || value.startsWith('-')) {
+					throw new Error('--env-file requires a path')
+				}
+				envFiles.push(value)
+				skip.add(i + 1)
+				break
+			}
 			case '--help':
 			case '-h':
 				help = true
@@ -65,11 +77,19 @@ export function parseGlobalFlags(args: string[]): GlobalFlags {
 				version = true
 				break
 			default:
-				rest.push(arg)
+				if (arg.startsWith('--env-file=')) {
+					const value = arg.slice('--env-file='.length)
+					if (!value) {
+						throw new Error('--env-file requires a path')
+					}
+					envFiles.push(value)
+				} else {
+					rest.push(arg)
+				}
 		}
 	}
 
-	return { json, quiet, yes, chain, help, version, rest }
+	return { json, quiet, yes, chain, envFiles, help, version, rest }
 }
 
 /**

package/src/cli.ts

@@ -6,6 +6,9 @@
  * Pure Bun CLI with manual arg parsing. No frameworks.
  */
 
+import { existsSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { config as loadEnv } from 'dotenv'
 import { parseGlobalFlags } from './args'
 import { handleActionCommand } from './commands/action'
 import { handleConfigCommand } from './commands/config'
@@ -27,8 +30,25 @@ import { formatError } from './output'
 
 const rawArgs = process.argv.slice(2)
 
+/** Load `--env-file` paths into process.env. File values win over existing env. */
+function applyEnvFiles(paths: string[]): void {
+	for (const p of paths) {
+		const abs = resolve(p)
+		if (!existsSync(abs)) {
+			throw new Error(`Env file not found: ${p}`)
+		}
+		const result = loadEnv({ path: abs, quiet: true, override: true })
+		if (result.error) {
+			throw result.error
+		}
+	}
+}
+
 async function main(): Promise<void> {
 	const flags = parseGlobalFlags(rawArgs)
+	if (flags.envFiles.length > 0) {
+		applyEnvFiles(flags.envFiles)
+	}
 
 	if (flags.version) {
 		printVersion()

package/src/commands/opns.ts

@@ -1,16 +1,13 @@
 /**
- * OpNS commands - register, deregister, lookup, mine.
+ * OpNS commands - register, deregister, lookup.
  *
- * Manage OpNS name identity bindings and paid mining jobs.
+ * Manage OpNS name identity bindings. Paid mining is product code on 1sat.name.
  */
 
 import {
 	getDisplayValue,
 	getOpnsNames,
 	opnsDeregister as opnsDeregisterAction,
-	opnsMine as opnsMineAction,
-	opnsMineRefund as opnsMineRefundAction,
-	opnsMineStatus as opnsMineStatusAction,
 	opnsRegister as opnsRegisterAction,
 } from '@1sat/actions'
 import { confirm, isCancel } from '@clack/prompts'
@@ -34,12 +31,6 @@ export async function handleOpnsCommand(
 			return opnsDeregister(rest, opts)
 		case 'lookup':
 			return opnsLookup(rest, opts)
-		case 'mine':
-			return opnsMine(rest, opts)
-		case 'mine-status':
-			return opnsMineStatus(rest, opts)
-		case 'mine-refund':
-			return opnsMineRefund(rest, opts)
 		default:
 			printCommandHelp('opns', opts.json)
 			if (subcommand && subcommand !== 'help') {
@@ -135,113 +126,6 @@ async function opnsDeregister(
 	}
 }
 
-async function opnsMine(args: string[], opts: GlobalFlags): Promise<void> {
-	const name = extractFlag(args, '--name')
-	const serviceUrl = extractFlag(args, '--service')
-	const receiveAddress = extractFlag(args, '--receive-address')
-	const timeout = extractFlag(args, '--timeout')
-
-	if (!name) fatal('Missing --name <name>')
-	if (!serviceUrl) fatal('Missing --service <url>')
-
-	if (!opts.yes) {
-		const ok = await confirm({
-			message: `Pay ${serviceUrl} to mine "${name}"? The full price is charged upfront.`,
-		})
-		if (isCancel(ok) || !ok) {
-			fatal('Mine cancelled.')
-		}
-	}
-
-	const privateKey = await loadKey()
-	const { ctx, destroy } = await loadContext(privateKey, {
-		chain: opts.chain,
-	})
-
-	try {
-		const result = await opnsMineAction.execute(ctx, {
-			name,
-			serviceUrl,
-			receiveAddress: receiveAddress ?? undefined,
-			timeoutMs: timeout ? Number.parseInt(timeout, 10) : undefined,
-		})
-		if (result.error && !result.jobId) {
-			fatal(result.error)
-		}
-		output(
-			opts.json
-				? result
-				: {
-						jobId: result.jobId,
-						state: result.state,
-						txid: result.txid,
-						...(result.error ? { error: result.error } : {}),
-					},
-			opts,
-		)
-	} finally {
-		await destroy()
-	}
-}
-
-async function opnsMineStatus(
-	args: string[],
-	opts: GlobalFlags,
-): Promise<void> {
-	const jobId = extractFlag(args, '--job')
-	const serviceUrl = extractFlag(args, '--service')
-
-	if (!jobId) fatal('Missing --job <paymentTxid>')
-	if (!serviceUrl) fatal('Missing --service <url>')
-
-	const privateKey = await loadKey()
-	const { ctx, destroy } = await loadContext(privateKey, {
-		chain: opts.chain,
-	})
-
-	try {
-		const result = await opnsMineStatusAction.execute(ctx, {
-			jobId,
-			serviceUrl,
-		})
-		if (result.error && !result.state) {
-			fatal(result.error)
-		}
-		output(result, opts)
-	} finally {
-		await destroy()
-	}
-}
-
-async function opnsMineRefund(
-	args: string[],
-	opts: GlobalFlags,
-): Promise<void> {
-	const jobId = extractFlag(args, '--job')
-	const serviceUrl = extractFlag(args, '--service')
-
-	if (!jobId) fatal('Missing --job <paymentTxid>')
-	if (!serviceUrl) fatal('Missing --service <url>')
-
-	const privateKey = await loadKey()
-	const { ctx, destroy } = await loadContext(privateKey, {
-		chain: opts.chain,
-	})
-
-	try {
-		const result = await opnsMineRefundAction.execute(ctx, {
-			jobId,
-			serviceUrl,
-		})
-		if (result.error) {
-			fatal(result.error)
-		}
-		output(result, opts)
-	} finally {
-		await destroy()
-	}
-}
-
 async function opnsLookup(_args: string[], opts: GlobalFlags): Promise<void> {
 	const privateKey = await loadKey()
 	const { ctx, destroy } = await loadContext(privateKey, {

package/src/help.ts

@@ -62,6 +62,12 @@ export const GLOBAL_OPTIONS: ArgSpec[] = [
 		values: '<main|test>',
 		description: 'Network (default: main)',
 	},
+	{
+		flag: '--env-file',
+		values: '<path>',
+		description:
+			'Load env vars from a file (repeatable; file values override existing env)',
+	},
 	{ flag: '--help', description: 'Show help (also -h)' },
 	{ flag: '--version', description: 'Show version (also -v)' },
 ]
@@ -503,32 +509,6 @@ export const COMMANDS: CommandSpec[] = [
 				args: [{ flag: '--outpoint', values: '<txid.vout>', required: true }],
 			},
 			{ name: 'lookup', description: 'List OpNS names from wallet' },
-			{
-				name: 'mine',
-				description: 'Pay a mine service to mine a name into this wallet',
-				args: [
-					{ flag: '--name', values: '<name>', required: true },
-					{ flag: '--service', values: '<url>', required: true },
-					{ flag: '--receive-address', values: '<addr>' },
-					{ flag: '--timeout', values: '<ms>' },
-				],
-			},
-			{
-				name: 'mine-status',
-				description: 'Check a mine job; internalize the name if complete',
-				args: [
-					{ flag: '--job', values: '<paymentTxid>', required: true },
-					{ flag: '--service', values: '<url>', required: true },
-				],
-			},
-			{
-				name: 'mine-refund',
-				description: 'Claim the remaining funds of a failed mine job',
-				args: [
-					{ flag: '--job', values: '<paymentTxid>', required: true },
-					{ flag: '--service', values: '<url>', required: true },
-				],
-			},
 		],
 	},