@1sat/cli 0.0.76 → 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.76",
+	"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.174",
+		"@1sat/actions": "0.0.184",
 		"@1sat/client": "0.0.42",
-		"@1sat/types": "0.0.33",
+		"@1sat/types": "0.0.34",
 		"@1sat/wallet-node": "0.0.57",
 		"@1sat/wallet-server": "0.0.26",
-		"@bsv/sdk": "^2.0.13",
+		"@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/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)' },
 ]