@1sat/cli 0.0.71 → 0.0.73

package/package.json

@@ -1,49 +1,49 @@
 {
-  "name": "@1sat/cli",
-  "version": "0.0.71",
-  "description": "CLI for 1Sat Ordinals SDK",
-  "type": "module",
-  "main": "./src/cli.ts",
-  "bin": {
-    "1sat": "./src/cli.ts"
-  },
-  "files": [
-    "src",
-    "scripts"
-  ],
-  "scripts": {
-    "preinstall": "node scripts/check-bun.cjs",
-    "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 --external mariadb --external 'mariadb/*'",
-    "dev": "bun run src/cli.ts",
-    "lint": "biome check src",
-    "test": "bun test"
-  },
-  "keywords": [
-    "1sat",
-    "bsv",
-    "ordinals",
-    "cli"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "@1sat/actions": "0.0.167",
-    "@1sat/client": "0.0.39",
-    "@1sat/types": "0.0.32",
-    "@1sat/wallet-node": "0.0.53",
-    "@1sat/wallet-server": "0.0.22",
-    "@bsv/sdk": "^2.0.13",
-    "@bsv/wallet-toolbox": "npm:@bopen-io/wallet-toolbox@2.1.21-parity-fix.2",
-    "chalk": "^5.0.0",
-    "@clack/prompts": "^0.8.0",
-    "bitcoin-backup": "^0.0.11",
-    "dotenv": "^17.0.0",
-    "evlog": "^2.10.0",
-    "knex": "^3.1.0",
-    "@bopen-io/messagebox-server": "^1.1.5",
-    "pg": "^8.11.3"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.3.9",
-    "typescript": "^5.9.3"
-  }
+	"name": "@1sat/cli",
+	"version": "0.0.73",
+	"description": "CLI for 1Sat Ordinals SDK",
+	"type": "module",
+	"main": "./src/cli.ts",
+	"bin": {
+		"1sat": "./src/cli.ts"
+	},
+	"files": [
+		"src",
+		"scripts"
+	],
+	"scripts": {
+		"preinstall": "node scripts/check-bun.cjs",
+		"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 --external mariadb --external 'mariadb/*'",
+		"dev": "bun run src/cli.ts",
+		"lint": "biome check src",
+		"test": "bun test"
+	},
+	"keywords": [
+		"1sat",
+		"bsv",
+		"ordinals",
+		"cli"
+	],
+	"license": "MIT",
+	"dependencies": {
+		"@1sat/actions": "0.0.169",
+		"@1sat/client": "0.0.40",
+		"@1sat/types": "0.0.33",
+		"@1sat/wallet-node": "0.0.54",
+		"@1sat/wallet-server": "0.0.23",
+		"@bsv/sdk": "^2.0.13",
+		"@bsv/wallet-toolbox": "npm:@bopen-io/wallet-toolbox@2.1.21-parity-fix.2",
+		"chalk": "^5.0.0",
+		"@clack/prompts": "^0.8.0",
+		"bitcoin-backup": "^0.0.11",
+		"dotenv": "^17.0.0",
+		"evlog": "^2.10.0",
+		"knex": "^3.1.0",
+		"@bopen-io/messagebox-server": "^1.1.5",
+		"pg": "^8.11.3"
+	},
+	"devDependencies": {
+		"@types/bun": "^1.3.9",
+		"typescript": "^5.9.3"
+	}
 }

package/src/commands/opns.ts

@@ -1,13 +1,16 @@
 /**
- * OpNS commands - register, deregister, lookup.
+ * OpNS commands - register, deregister, lookup, mine.
  *
- * Manage OpNS name identity bindings.
+ * Manage OpNS name identity bindings and paid mining jobs.
  */
 
 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'
@@ -31,6 +34,12 @@ 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') {
@@ -126,6 +135,113 @@ 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

@@ -503,6 +503,32 @@ 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 },
+				],
+			},
 		],
 	},