@1sat/cli 0.0.111 → 0.0.113

package/dist/cli.js

@@ -1,15 +1,7 @@
 #!/usr/bin/env node
-var __esm = (fn, res, err) => () => {
-  if (fn)
-    try {
-      res = fn(fn = 0);
-    } catch (e) {
-      err = [e];
-    }
-  if (err)
-    throw err[0];
-  return res;
-};
+import { createRequire } from "node:module";
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/args.ts
 function parseGlobalFlags(args) {
@@ -513,11 +505,11 @@ async function handleActionCommand(args, opts) {
 Registered actions:
 `);
     const grouped = new Map;
-    for (const action of actions) {
-      const cat = action.meta.category;
+    for (const action2 of actions) {
+      const cat = action2.meta.category;
       if (!grouped.has(cat))
         grouped.set(cat, []);
-      grouped.get(cat).push(action);
+      grouped.get(cat).push(action2);
     }
     for (const [category, categoryActions] of grouped) {
       console.log(`  ${category}:`);
@@ -549,6 +541,9 @@ Run '1sat action' to list available actions.`);
   try {
     const result = await action.execute(ctx, input);
     output(result, opts);
+    if (actionName === "cancelOwnedListings" && result !== null && typeof result === "object" && "errors" in result && Array.isArray(result.errors) && result.errors.length > 0) {
+      process.exitCode = 1;
+    }
   } finally {
     await destroy();
   }
@@ -1048,6 +1043,8 @@ var init_help = __esm(() => {
         {
           name: "sell",
           description: "List an ordinal for sale (OrdLock)",
+          unavailable: true,
+          notes: "OrdLock listing create is disabled. Buy and cancel of existing listings remain available.",
           args: [
             { flag: "--id", values: "<tracking-id>", required: true },
             { flag: "--price", values: "<sats>", required: true },
@@ -1260,6 +1257,8 @@ var init_help = __esm(() => {
         {
           name: "sell",
           description: "List an OpNS name for sale",
+          unavailable: true,
+          notes: "OrdLock listing create is disabled. Buy and cancel of existing listings remain available.",
           args: [
             { flag: "--id", values: "<tracking-id>", required: true },
             { flag: "--price", values: "<satoshis>", required: true },
@@ -1441,7 +1440,7 @@ function createApprovalAuth(wallet) {
     get(target, property) {
       if (property === "createAction")
         return async (...args) => {
-          const satoshis = args[0].outputs?.reduce((sum, output) => sum + output.satoshis, 0) ?? 0;
+          const satoshis = args[0].outputs?.reduce((sum, output2) => sum + output2.satoshis, 0) ?? 0;
           if (!Number.isSafeInteger(satoshis) || satoshis <= 0)
             throw new Error("Invalid HTTP payment amount");
           if (approved === false)
@@ -1965,15 +1964,15 @@ async function handleInitCommand(_args, opts) {
   }
   let wif;
   if (keySource === "generate") {
-    const pk = PrivateKey2.fromRandom();
-    wif = pk.toWif();
-    const address = pk.toPublicKey().toAddress();
+    const pk2 = PrivateKey2.fromRandom();
+    wif = pk2.toWif();
+    const address2 = pk2.toPublicKey().toAddress();
     console.log();
     console.log(formatWarning("  IMPORTANT: Back up your private key!"));
     console.log(formatWarning("  If you lose it, your funds are gone forever."));
     console.log();
     console.log(`  ${formatValue("WIF:")}    ${wif}`);
-    console.log(`  ${formatValue("Address:")} ${address}`);
+    console.log(`  ${formatValue("Address:")} ${address2}`);
     console.log();
     const confirmed = await confirm2({
       message: "Have you saved your private key somewhere safe?"
@@ -2442,10 +2441,9 @@ import {
   internalizeOpns,
   listOpns,
   registerOpns,
-  sellOpns,
   sendOpns
 } from "@1sat/actions";
-import { P1SAT_PROTOCOL } from "@1sat/types";
+import { ORDLOCK_LISTING_CREATE_DISABLED, P1SAT_PROTOCOL } from "@1sat/types";
 import { confirm as confirm4, isCancel as isCancel5 } from "@clack/prompts";
 async function handleOpnsCommand(args, opts) {
   const [subcommand, ...rest] = args;
@@ -2582,37 +2580,8 @@ async function opnsCancelListingCmd(args, opts) {
     await destroy();
   }
 }
-async function opnsSell(args, opts) {
-  const id = requireId(args);
-  const priceStr = extractFlag(args, "--price");
-  const payAddress = extractFlag(args, "--pay-address");
-  if (!priceStr)
-    fatal("Missing --price <satoshis>");
-  const price = Number(priceStr);
-  if (!Number.isFinite(price) || price <= 0) {
-    fatal("--price must be a positive number");
-  }
-  if (!opts.yes) {
-    const ok = await confirm4({
-      message: `List OpNS id ${id} for sale at ${price} satoshis?`
-    });
-    if (isCancel5(ok) || !ok)
-      fatal("Listing cancelled.");
-  }
-  const privateKey = await loadKey();
-  const { ctx, destroy } = await loadContext(privateKey, { chain: opts.chain });
-  try {
-    const result = await sellOpns.execute(ctx, {
-      id,
-      price,
-      ...payAddress && { payAddress }
-    });
-    if (result.error)
-      fatal(result.error);
-    output(opts.json ? result : { txid: result.txid }, opts);
-  } finally {
-    await destroy();
-  }
+async function opnsSell(_args, _opts) {
+  fatal(ORDLOCK_LISTING_CREATE_DISABLED);
 }
 async function opnsSend(args, opts) {
   const id = requireId(args);
@@ -2713,9 +2682,9 @@ import {
   getDisplayValue as getDisplayValue2,
   inscribe,
   listOrdinals,
-  sellOrdinal,
   sendOrdinals
 } from "@1sat/actions";
+import { ORDLOCK_LISTING_CREATE_DISABLED as ORDLOCK_LISTING_CREATE_DISABLED2 } from "@1sat/types";
 import { Utils as Utils3 } from "@bsv/sdk";
 import { confirm as confirm5, isCancel as isCancel6 } from "@clack/prompts";
 async function handleOrdinalsCommand(args, opts) {
@@ -2878,37 +2847,8 @@ async function ordinalsSend(args, opts) {
     await destroy();
   }
 }
-async function ordinalsSell(args, opts) {
-  const id = requireId2(args);
-  const priceStr = extractFlag(args, "--price");
-  const payAddress = extractFlag(args, "--pay-address");
-  if (!priceStr)
-    fatal("Missing --price <satoshis>");
-  const price = Number(priceStr);
-  if (!Number.isFinite(price) || price <= 0) {
-    fatal("--price must be a positive number");
-  }
-  if (!opts.yes) {
-    const ok = await confirm5({
-      message: `List ordinal id ${id} for sale at ${price} satoshis?`
-    });
-    if (isCancel6(ok) || !ok)
-      fatal("Listing cancelled.");
-  }
-  const privateKey = await loadKey();
-  const { ctx, destroy } = await loadContext(privateKey, { chain: opts.chain });
-  try {
-    const result = await sellOrdinal.execute(ctx, {
-      id,
-      price,
-      ...payAddress && { payAddress }
-    });
-    if (result.error)
-      fatal(result.error);
-    output(opts.json ? result : { txid: result.txid }, opts);
-  } finally {
-    await destroy();
-  }
+async function ordinalsSell(_args, _opts) {
+  fatal(ORDLOCK_LISTING_CREATE_DISABLED2);
 }
 async function ordinalsCancel(args, opts) {
   const id = requireId2(args);
@@ -3389,7 +3329,7 @@ function buildPriceUpdateTask(options) {
     lastRunMsecsSinceEpoch: 0,
     async asyncSetup() {},
     trigger(now) {
-      if (targets.length === 0)
+      if (targets.length === 0 && !options.onQuote)
         return { run: false };
       if (now - this.lastRunMsecsSinceEpoch < intervalMs)
         return { run: false };
@@ -3402,6 +3342,13 @@ function buildPriceUpdateTask(options) {
       } catch (err) {
         return `rate fetch failed: ${err.message}`;
       }
+      if (options.onQuote) {
+        try {
+          await options.onQuote(quote);
+        } catch (err) {
+          return `quote persist failed: ${err.message}`;
+        }
+      }
       const parts = [];
       for (const target of targets) {
         const currentSats = target.readCurrentSats();
@@ -3498,6 +3445,7 @@ import {
 } from "@1sat/wallet-node";
 import {
   KnexAccountStore,
+  KnexHandleCertStore,
   KnexPendingStore,
   createHostServer,
   createWalletServer
@@ -3644,7 +3592,7 @@ async function runWithStorage(resolved, mode) {
         }
       });
     }
-    if (r?.enabled && targets.length > 0) {
+    if (r?.enabled) {
       walletResult.monitor.addTask(buildPriceUpdateTask({
         monitor: walletResult.monitor,
         rateProvider: resolveRateProvider(r.provider ?? "whatsonchain", {
@@ -3655,9 +3603,13 @@ async function runWithStorage(resolved, mode) {
           maxMovePct: r.maxMovePct ?? 25,
           minSats: r.minSats ?? 1
         },
-        targets
+        targets,
+        onQuote: async (quote) => {
+          setConfigPath("server.exchangeRate", quote);
+        }
       }));
-      console.log(`[repricer] enabled — ${targets.map((t) => `${t.name} $${t.targetUsd}`).join(", ")} every ${Math.round((r.intervalMs ?? 900000) / 1000)}s via ${r.provider ?? "whatsonchain"}`);
+      const targetNote = targets.map((t) => `${t.name} $${t.targetUsd}`).join(", ") || "quote only";
+      console.log(`[repricer] enabled — ${targetNote} every ${Math.round((r.intervalMs ?? 900000) / 1000)}s via ${r.provider ?? "whatsonchain"}`);
     }
   }
   if (runMonitor) {
@@ -3687,7 +3639,7 @@ async function startWalletServer(resolved, walletResult, accounts, mode) {
     ttlSeconds: sessionStoreCfg.ttlSeconds
   } : undefined;
   if (mode === "wallet") {
-    const handle = createWalletServer({
+    const handle2 = createWalletServer({
       wallet: walletResult.wallet,
       storage: walletResult.getActiveStorage(),
       serverIdentityKey: walletResult.wallet.identityKey,
@@ -3697,10 +3649,10 @@ async function startWalletServer(resolved, walletResult, accounts, mode) {
       accounts: accounts?.walletServerAccounts,
       sessionStore
     });
-    const port = await handle.start();
-    const notes = [resolved.accounts.enabled ? "accounts: on" : ""].filter(Boolean).join(", ");
-    console.log(`[wallet] listening on ${resolved.host}:${port}${notes ? ` (${notes})` : ""}`);
-    return { stop: () => handle.stop() };
+    const port2 = await handle2.start();
+    const notes2 = [resolved.accounts.enabled ? "accounts: on" : ""].filter(Boolean).join(", ");
+    console.log(`[wallet] listening on ${resolved.host}:${port2}${notes2 ? ` (${notes2})` : ""}`);
+    return { stop: () => handle2.stop() };
   }
   const serverCfg = config.server ?? {};
   const paymailCfg = serverCfg.paymail;
@@ -3710,6 +3662,8 @@ async function startWalletServer(resolved, walletResult, accounts, mode) {
   await pendingStore.init();
   const accountStore = new KnexAccountStore(knex);
   await accountStore.init();
+  const handleCertStore = new KnexHandleCertStore(knex);
+  await handleCertStore.init();
   const handle = await createHostServer({
     wallet: walletResult.wallet,
     sessionStore,
@@ -3718,12 +3672,16 @@ async function startWalletServer(resolved, walletResult, accounts, mode) {
     listen: { port: resolved.port, host: resolved.host },
     accounts: accounts?.walletServerAccounts,
     accountStore,
+    handleCertStore,
+    getExchangeRate: () => loadConfig().server?.exchangeRate ?? null,
     paymail: {
       baseUrl: paymailCfg?.baseUrl ?? `http://${resolved.host}:${resolved.port}`,
       stackUrl: paymailCfg?.stackUrl ?? resolved.stackUrl,
       pendingStore,
       accountStore,
+      certStore: handleCertStore,
       ...paymailCfg?.userDomain && { userDomain: paymailCfg.userDomain },
+      ...paymailCfg?.verifySignature && { verifySignature: true },
       messageboxUrl: `http://127.0.0.1:${resolved.port}/messagebox`,
       hostPrivateKey: resolved.privateKey
     },
@@ -4867,8 +4825,8 @@ async function walletListOutputs(args, opts) {
 ${result.totalOutputs} total outputs in basket '${basket}':
 `);
       for (const out of result.outputs) {
-        const tags = out.tags?.join(", ") || "none";
-        console.log(`  ${out.outpoint} | ${out.satoshis} sats | tags: ${tags}`);
+        const tags2 = out.tags?.join(", ") || "none";
+        console.log(`  ${out.outpoint} | ${out.satoshis} sats | tags: ${tags2}`);
       }
       console.log();
     }
@@ -5126,6 +5084,7 @@ var init_wallet = __esm(() => {
 });
 
 // src/main.ts
+var exports_main = {};
 import { existsSync as existsSync4 } from "node:fs";
 import { resolve } from "node:path";
 import { config as loadEnv } from "dotenv";
@@ -5265,4 +5224,4 @@ var init_main = __esm(() => {
 
 // src/cli.ts
 process.env.DOTENV_CONFIG_QUIET = "true";
-await Promise.resolve().then(() => (init_main(), {}));
+await Promise.resolve().then(() => (init_main(), exports_main));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1sat/cli",
-  "version": "0.0.111",
+  "version": "0.0.113",
   "description": "CLI for 1Sat Ordinals SDK",
   "type": "module",
   "main": "./dist/cli.js",
@@ -27,20 +27,20 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@1sat/actions": "0.0.208",
-    "@1sat/client": "0.0.51",
-    "@1sat/types": "0.0.41",
-    "@1sat/wallet-node": "0.0.73",
-    "@1sat/wallet-server": "0.0.48",
-    "@bsv/sdk": "^2.1.9",
+    "@1sat/actions": "0.0.214",
+    "@1sat/client": "0.0.52",
+    "@1sat/types": "0.0.44",
+    "@1sat/wallet-node": "0.0.74",
+    "@1sat/wallet-server": "0.0.50",
+    "@bopen-io/messagebox-server": "^1.3.2",
+    "@bsv/sdk": "^2.5.0",
     "@bsv/wallet-toolbox": "npm:@bopen-io/wallet-toolbox@2.6.2-brc153.5",
-    "chalk": "^5.0.0",
     "@clack/prompts": "^0.8.0",
     "bitcoin-backup": "^0.0.11",
+    "chalk": "^5.0.0",
     "dotenv": "^17.0.0",
     "evlog": "^2.10.0",
     "knex": "^3.1.0",
-    "@bopen-io/messagebox-server": "^1.3.2",
     "pg": "^8.11.3",
     "sqlite3": "^6.0.1"
   },

package/src/commands/action.ts

@@ -73,6 +73,16 @@ export async function handleActionCommand(
 	try {
 		const result = await action.execute(ctx, input)
 		output(result, opts)
+		if (
+			actionName === 'cancelOwnedListings' &&
+			result !== null &&
+			typeof result === 'object' &&
+			'errors' in result &&
+			Array.isArray(result.errors) &&
+			result.errors.length > 0
+		) {
+			process.exitCode = 1
+		}
 	} finally {
 		await destroy()
 	}

package/src/commands/opns.ts

@@ -10,10 +10,9 @@ import {
 	internalizeOpns,
 	listOpns,
 	registerOpns,
-	sellOpns,
 	sendOpns,
 } from '@1sat/actions'
-import { P1SAT_PROTOCOL } from '@1sat/types'
+import { ORDLOCK_LISTING_CREATE_DISABLED, P1SAT_PROTOCOL } from '@1sat/types'
 import { confirm, isCancel } from '@clack/prompts'
 import type { GlobalFlags } from '../args.js'
 import { extractFlag } from '../args.js'
@@ -194,38 +193,8 @@ async function opnsCancelListingCmd(
 	}
 }
 
-async function opnsSell(args: string[], opts: GlobalFlags): Promise<void> {
-	const id = requireId(args)
-	const priceStr = extractFlag(args, '--price')
-	const payAddress = extractFlag(args, '--pay-address')
-
-	if (!priceStr) fatal('Missing --price <satoshis>')
-	const price = Number(priceStr)
-	if (!Number.isFinite(price) || price <= 0) {
-		fatal('--price must be a positive number')
-	}
-
-	if (!opts.yes) {
-		const ok = await confirm({
-			message: `List OpNS id ${id} for sale at ${price} satoshis?`,
-		})
-		if (isCancel(ok) || !ok) fatal('Listing cancelled.')
-	}
-
-	const privateKey = await loadKey()
-	const { ctx, destroy } = await loadContext(privateKey, { chain: opts.chain })
-
-	try {
-		const result = await sellOpns.execute(ctx, {
-			id,
-			price,
-			...(payAddress && { payAddress }),
-		})
-		if (result.error) fatal(result.error)
-		output(opts.json ? result : { txid: result.txid }, opts)
-	} finally {
-		await destroy()
-	}
+async function opnsSell(_args: string[], _opts: GlobalFlags): Promise<void> {
+	fatal(ORDLOCK_LISTING_CREATE_DISABLED)
 }
 
 async function opnsSend(args: string[], opts: GlobalFlags): Promise<void> {

package/src/commands/ordinals.ts

@@ -11,9 +11,9 @@ import {
 	getDisplayValue,
 	inscribe,
 	listOrdinals,
-	sellOrdinal,
 	sendOrdinals,
 } from '@1sat/actions'
+import { ORDLOCK_LISTING_CREATE_DISABLED } from '@1sat/types'
 import { Utils } from '@bsv/sdk'
 import { confirm, isCancel } from '@clack/prompts'
 import type { GlobalFlags } from '../args.js'
@@ -245,38 +245,11 @@ async function ordinalsSend(args: string[], opts: GlobalFlags): Promise<void> {
 	}
 }
 
-async function ordinalsSell(args: string[], opts: GlobalFlags): Promise<void> {
-	const id = requireId(args)
-	const priceStr = extractFlag(args, '--price')
-	const payAddress = extractFlag(args, '--pay-address')
-
-	if (!priceStr) fatal('Missing --price <satoshis>')
-	const price = Number(priceStr)
-	if (!Number.isFinite(price) || price <= 0) {
-		fatal('--price must be a positive number')
-	}
-
-	if (!opts.yes) {
-		const ok = await confirm({
-			message: `List ordinal id ${id} for sale at ${price} satoshis?`,
-		})
-		if (isCancel(ok) || !ok) fatal('Listing cancelled.')
-	}
-
-	const privateKey = await loadKey()
-	const { ctx, destroy } = await loadContext(privateKey, { chain: opts.chain })
-
-	try {
-		const result = await sellOrdinal.execute(ctx, {
-			id,
-			price,
-			...(payAddress && { payAddress }),
-		})
-		if (result.error) fatal(result.error)
-		output(opts.json ? result : { txid: result.txid }, opts)
-	} finally {
-		await destroy()
-	}
+async function ordinalsSell(
+	_args: string[],
+	_opts: GlobalFlags,
+): Promise<void> {
+	fatal(ORDLOCK_LISTING_CREATE_DISABLED)
 }
 
 async function ordinalsCancel(

package/src/commands/serve.ts

@@ -26,6 +26,7 @@ import {
 } from '@1sat/wallet-node'
 import {
 	KnexAccountStore,
+	KnexHandleCertStore,
 	KnexPendingStore,
 	createHostServer,
 	createWalletServer,
@@ -298,7 +299,7 @@ async function runWithStorage(
 				},
 			})
 		}
-		if (r?.enabled && targets.length > 0) {
+		if (r?.enabled) {
 			walletResult.monitor.addTask(
 				buildPriceUpdateTask({
 					monitor: walletResult.monitor,
@@ -311,12 +312,16 @@ async function runWithStorage(
 						minSats: r.minSats ?? 1,
 					},
 					targets,
+					onQuote: async (quote) => {
+						setConfigPath('server.exchangeRate', quote)
+					},
 				}),
 			)
+			const targetNote =
+				targets.map((t) => `${t.name} $${t.targetUsd}`).join(', ') ||
+				'quote only'
 			console.log(
-				`[repricer] enabled — ${targets
-					.map((t) => `${t.name} $${t.targetUsd}`)
-					.join(', ')} every ${Math.round(
+				`[repricer] enabled — ${targetNote} every ${Math.round(
 					(r.intervalMs ?? 900_000) / 1000,
 				)}s via ${r.provider ?? 'whatsonchain'}`,
 			)
@@ -401,6 +406,8 @@ async function startWalletServer(
 	await pendingStore.init()
 	const accountStore = new KnexAccountStore(knex)
 	await accountStore.init()
+	const handleCertStore = new KnexHandleCertStore(knex)
+	await handleCertStore.init()
 
 	const handle = await createHostServer({
 		wallet: walletResult.wallet,
@@ -410,13 +417,17 @@ async function startWalletServer(
 		listen: { port: resolved.port, host: resolved.host },
 		accounts: accounts?.walletServerAccounts,
 		accountStore,
+		handleCertStore,
+		getExchangeRate: () => loadConfig().server?.exchangeRate ?? null,
 		paymail: {
 			baseUrl:
 				paymailCfg?.baseUrl ?? `http://${resolved.host}:${resolved.port}`,
 			stackUrl: paymailCfg?.stackUrl ?? resolved.stackUrl,
 			pendingStore,
 			accountStore,
+			certStore: handleCertStore,
 			...(paymailCfg?.userDomain && { userDomain: paymailCfg.userDomain }),
+			...(paymailCfg?.verifySignature && { verifySignature: true }),
 			messageboxUrl: `http://127.0.0.1:${resolved.port}/messagebox`,
 			hostPrivateKey: resolved.privateKey,
 		},

package/src/config.ts

@@ -118,6 +118,11 @@ export interface ServerPaymailConfig {
 	 * only resolves when its identity holds an account on this host.
 	 */
 	userDomain?: string
+	/**
+	 * Require signed P2P metadata on receive-beef / receive-transaction.
+	 * Advertised as Request Sender Validation on well-known. Default false.
+	 */
+	verifySignature?: boolean
 }
 
 export interface ServerSessionStoreConfig {
@@ -153,6 +158,12 @@ export interface ServerConfig {
 	paymail?: ServerPaymailConfig
 	/** Shared BSV/USD repricer engine for the accounts storage price. */
 	repricer?: RepricerConfig
+	/** Last successful BSV/USD quote from the repricer. Served at GET /exchange-rate. */
+	exchangeRate?: {
+		bsvUsd: number
+		timestamp: number
+		source: string
+	}
 	/**
 	 * Redis-shared BRC-104 sessions. Required when multiple serve instances
 	 * run behind one load balancer; unset keeps sessions in-memory.

package/src/help.ts

@@ -393,6 +393,9 @@ export const COMMANDS: CommandSpec[] = [
 			{
 				name: 'sell',
 				description: 'List an ordinal for sale (OrdLock)',
+				unavailable: true,
+				notes:
+					'OrdLock listing create is disabled. Buy and cancel of existing listings remain available.',
 				args: [
 					{ flag: '--id', values: '<tracking-id>', required: true },
 					{ flag: '--price', values: '<sats>', required: true },
@@ -617,6 +620,9 @@ export const COMMANDS: CommandSpec[] = [
 			{
 				name: 'sell',
 				description: 'List an OpNS name for sale',
+				unavailable: true,
+				notes:
+					'OrdLock listing create is disabled. Buy and cancel of existing listings remain available.',
 				args: [
 					{ flag: '--id', values: '<tracking-id>', required: true },
 					{ flag: '--price', values: '<satoshis>', required: true },

package/src/repricer/buildPriceUpdateTask.ts

@@ -1,5 +1,5 @@
 import { computeReprice } from './computeReprice.js'
-import type { RateProvider, RepricerBounds } from './types.js'
+import type { BsvUsdQuote, RateProvider, RepricerBounds } from './types.js'
 
 /** One price the repricer maintains from the shared BSV/USD quote. */
 export interface RepriceTarget {
@@ -20,6 +20,8 @@ export interface PriceUpdateTaskOptions {
 	intervalMs: number
 	bounds: RepricerBounds
 	targets: RepriceTarget[]
+	/** Called after a successful rate fetch, even when every target is skipped. */
+	onQuote?: (quote: BsvUsdQuote) => Promise<void>
 }
 
 export interface PriceUpdateTask {
@@ -47,7 +49,7 @@ export function buildPriceUpdateTask(
 		lastRunMsecsSinceEpoch: 0,
 		async asyncSetup() {},
 		trigger(now: number): { run: boolean } {
-			if (targets.length === 0) return { run: false }
+			if (targets.length === 0 && !options.onQuote) return { run: false }
 			if (now - this.lastRunMsecsSinceEpoch < intervalMs) return { run: false }
 			return { run: true }
 		},
@@ -59,6 +61,14 @@ export function buildPriceUpdateTask(
 				return `rate fetch failed: ${(err as Error).message}`
 			}
 
+			if (options.onQuote) {
+				try {
+					await options.onQuote(quote)
+				} catch (err) {
+					return `quote persist failed: ${(err as Error).message}`
+				}
+			}
+
 			const parts: string[] = []
 			for (const target of targets) {
 				const currentSats = target.readCurrentSats()