@dvmkit/sdk 0.1.3-rc.7 → 0.1.4-rc.7

package/dist/internal/caller.js

@@ -206,7 +206,7 @@ import {
   sha256hex,
   validateX402Env,
   withNwcPool
-} from "../chunk-EPNDZ5DH.js";
+} from "../chunk-EDDYHZ6W.js";
 import {
   MemoryKVStore
 } from "../chunk-RW5LP57K.js";
@@ -285,7 +285,7 @@ import {
   withWalletLock,
   writeAgentMnemonic,
   writeIdentity
-} from "../chunk-2K7E3N2D.js";
+} from "../chunk-VRQDX5P4.js";
 import {
   X402_BATCH_SETTLEMENT_SCHEME,
   X402_DEFAULT_FACILITATOR,
@@ -394,7 +394,7 @@ import {
   randomTraceId,
   setEmitter,
   withTraceContext
-} from "../chunk-YDIYXGYL.js";
+} from "../chunk-E4EVGPDX.js";
 import "../chunk-66HGCPBU.js";
 import {
   redactUrl,
@@ -2469,6 +2469,80 @@ function normalizeCap(raw2) {
 
 // src/lib/wallet-agent/fund.ts
 import { MintQuoteState } from "@cashu/cashu-ts";
+
+// src/lib/wallet-agent/mint-quote-retry.ts
+var MINT_QUOTE_RETRY_BASE_DELAY_MS = 2e3;
+var MINT_QUOTE_RETRY_MAX_DELAY_MS = 6e4;
+var MINT_QUOTE_RETRY_DECAY_FACTOR = 4;
+function createMintQuoteRetryState() {
+  return { backoffMs: 0 };
+}
+async function retryMintQuoteOperation(operation, opts) {
+  const now = opts.now ?? (() => Date.now());
+  const sleep2 = opts.sleep ?? defaultSleep;
+  const state = opts.state ?? createMintQuoteRetryState();
+  for (; ; ) {
+    try {
+      return await operation();
+    } catch (err) {
+      const cause = classifyMintQuoteError(err);
+      if (cause === void 0) throw err;
+      const failedAt = now();
+      if (state.lastRetryAt !== void 0 && failedAt - state.lastRetryAt >= state.backoffMs * MINT_QUOTE_RETRY_DECAY_FACTOR) {
+        state.backoffMs = 0;
+      }
+      const grownDelay = Math.min(
+        Math.max(state.backoffMs * 2, MINT_QUOTE_RETRY_BASE_DELAY_MS),
+        MINT_QUOTE_RETRY_MAX_DELAY_MS
+      );
+      const retryAfterMs = mintRetryAfterMs(err);
+      const delayMs = Math.min(
+        Math.max(retryAfterMs ?? grownDelay, MINT_QUOTE_RETRY_BASE_DELAY_MS),
+        MINT_QUOTE_RETRY_MAX_DELAY_MS
+      );
+      const remainingMs = Math.max(0, opts.deadlineMs - failedAt);
+      state.backoffMs = delayMs;
+      if (remainingMs > 0) {
+        await sleep2(Math.min(delayMs, remainingMs));
+        state.lastRetryAt = now();
+      }
+      if (now() >= opts.deadlineMs) {
+        throw mintQuoteUnavailableError(opts.quoteId, cause, delayMs);
+      }
+    }
+  }
+}
+function classifyMintQuoteError(err) {
+  if (typeof err !== "object" || err === null) return void 0;
+  const { name, status, code } = err;
+  if (name === "RateLimitError" || status === 429) return "rate_limited";
+  if (typeof status === "number" && status >= 500) return "mint_server_error";
+  if (name === "NetworkError" || code === "cashu_mint_unreachable") return "mint_unreachable";
+  return void 0;
+}
+function mintRetryAfterMs(err) {
+  if (typeof err !== "object" || err === null) return void 0;
+  const value = err.retryAfterMs;
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
+function mintQuoteUnavailableError(quoteId, cause, retryAfterMs) {
+  return new DvmError(
+    "mint_quote_poll_unavailable",
+    `The mint did not answer status checks for quote ${quoteId} before the wait ended.`,
+    "The quote may still settle. Reconcile the existing quote later instead of starting another payment.",
+    {
+      quote_id: quoteId,
+      cause,
+      retryable: true,
+      retry_after_ms: retryAfterMs
+    }
+  );
+}
+function defaultSleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/lib/wallet-agent/fund.ts
 var DEFAULT_POLL_INTERVAL_MS = 2e3;
 var DEFAULT_TIMEOUT_SEC = 600;
 async function fundAgentWallet(amountSats, opts) {
@@ -2494,7 +2568,8 @@ async function fundAgentWallet(amountSats, opts) {
     mint: opts.mintUrl,
     quote_id: quote.quote,
     amount_sats: sats,
-    requested_at: (/* @__PURE__ */ new Date()).toISOString()
+    requested_at: (/* @__PURE__ */ new Date()).toISOString(),
+    ...quote.expiry === null ? {} : { expires_at: quote.expiry }
   };
   await withWalletLock(() => {
     const fresh = loadAgentWallet() ?? initial;
@@ -2605,23 +2680,35 @@ function maxKeysetDenomination(cashuWallet) {
 }
 async function pollUntilPaidOrTimeout(cashuWallet, quoteId, opts) {
   const now = opts.now ?? (() => Date.now());
-  const sleep2 = opts.sleep ?? defaultSleep;
+  const sleep2 = opts.sleep ?? defaultSleep2;
   const intervalMs = opts.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
   const timeoutMs = opts.timeoutMs ?? fundTimeoutMs();
   const start = now();
+  const deadline = start + timeoutMs;
+  const retryState = createMintQuoteRetryState();
   let lastState = MintQuoteState.UNPAID;
-  while (now() - start < timeoutMs) {
-    const checked = await cashuWallet.checkMintQuoteBolt11(quoteId);
+  while (now() < deadline) {
+    const checked = await retryMintQuoteOperation(
+      () => cashuWallet.checkMintQuoteBolt11(quoteId),
+      {
+        deadlineMs: deadline,
+        quoteId,
+        state: retryState,
+        now,
+        sleep: sleep2
+      }
+    );
     lastState = checked.state;
     if (opts.onPoll) opts.onPoll(lastState, now() - start);
     if (lastState === MintQuoteState.PAID || lastState === MintQuoteState.ISSUED) {
       return lastState;
     }
-    await sleep2(intervalMs);
+    const remainingMs = deadline - now();
+    if (remainingMs > 0) await sleep2(Math.min(intervalMs, remainingMs));
   }
   return lastState;
 }
-function defaultSleep(ms) {
+function defaultSleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
@@ -2908,6 +2995,7 @@ async function receiveToAgentWallet(token, opts = {}) {
 
 // src/lib/wallet-agent/recovery.ts
 import { MintQuoteState as MintQuoteState2 } from "@cashu/cashu-ts";
+var DEFAULT_SWEEP_QUOTE_RETRY_TIMEOUT_MS = 1e4;
 async function sweepPendingMints(opts = {}) {
   const wallet = loadAgentWallet();
   if (!wallet || wallet.pending_mints.length === 0) {
@@ -2916,9 +3004,14 @@ async function sweepPendingMints(opts = {}) {
   const now = opts.now ?? (() => Date.now());
   const expirationMs = opts.expirationMs ?? fundTimeoutMs();
   const getWalletForMint = opts.getWalletForMint ?? getWallet;
+  const quoteRetryTimeoutMs = opts.quoteRetryTimeoutMs ?? DEFAULT_SWEEP_QUOTE_RETRY_TIMEOUT_MS;
   const outcomes = [];
   for (const entry of wallet.pending_mints) {
-    const outcome = await processEntry(wallet, entry, now(), expirationMs, getWalletForMint);
+    const outcome = await processEntry(wallet, entry, now(), expirationMs, getWalletForMint, {
+      now,
+      sleep: opts.sleep,
+      timeoutMs: quoteRetryTimeoutMs
+    });
     outcomes.push(outcome);
   }
   if (outcomes.some(
@@ -2941,21 +3034,27 @@ async function sweepPendingMints(opts = {}) {
     errors: outcomes.filter((o) => o.kind === "error").map((o) => ({ quote_id: o.entry.quote_id, error: o.error }))
   };
 }
-async function processEntry(wallet, entry, nowMs, expirationMs, getWalletForMint) {
+async function processEntry(wallet, entry, nowMs, expirationMs, getWalletForMint, retry) {
   let cashuWallet;
-  try {
-    cashuWallet = await getWalletForMint(entry.mint);
-  } catch (err) {
-    return { kind: "error", entry, error: errorMessage2(err) };
-  }
-  let state;
   let quoteResponse;
   try {
-    quoteResponse = await cashuWallet.checkMintQuoteBolt11(entry.quote_id);
-    state = quoteResponse.state;
+    ({ cashuWallet, quoteResponse } = await retryMintQuoteOperation(
+      async () => {
+        const candidate = await getWalletForMint(entry.mint);
+        const quote = await candidate.checkMintQuoteBolt11(entry.quote_id);
+        return { cashuWallet: candidate, quoteResponse: quote };
+      },
+      {
+        deadlineMs: retry.now() + retry.timeoutMs,
+        quoteId: entry.quote_id,
+        now: retry.now,
+        sleep: retry.sleep
+      }
+    ));
   } catch (err) {
     return { kind: "error", entry, error: errorMessage2(err) };
   }
+  const state = quoteResponse.state;
   if (state === MintQuoteState2.ISSUED) {
     if (!entry.minting) {
       return { kind: "already_issued", entry };
@@ -3009,6 +3108,13 @@ async function processEntry(wallet, entry, nowMs, expirationMs, getWalletForMint
       return { kind: "error", entry, error: errorMessage2(err) };
     }
   }
+  const quoteExpiry = entry.expires_at;
+  if (quoteExpiry !== void 0 && Number.isFinite(quoteExpiry)) {
+    if (nowMs > quoteExpiry * 1e3) {
+      return { kind: "expired", entry };
+    }
+    return { kind: "still_pending", entry };
+  }
   const requestedAtMs = Date.parse(entry.requested_at);
   const ageMs2 = Number.isFinite(requestedAtMs) ? nowMs - requestedAtMs : Infinity;
   if (ageMs2 > expirationMs) {
@@ -3038,6 +3144,7 @@ function errorMessage2(err) {
 }
 
 // src/lib/wallet-agent/recovery-melt.ts
+var DEFAULT_SWEEP_QUOTE_RETRY_TIMEOUT_MS2 = 1e4;
 async function sweepPendingMelts(opts = {}) {
   const wallet = loadAgentWallet();
   if (!wallet || wallet.pending_melts.length === 0) {
@@ -3046,9 +3153,16 @@ async function sweepPendingMelts(opts = {}) {
   const now = opts.now ?? (() => Date.now());
   const abandonAfterMs = opts.abandonAfterMs ?? meltInFlightTimeoutSeconds() * 1e3;
   const getWalletForMint = opts.getWalletForMint ?? getWallet;
+  const quoteRetryTimeoutMs = opts.quoteRetryTimeoutMs ?? DEFAULT_SWEEP_QUOTE_RETRY_TIMEOUT_MS2;
   const outcomes = [];
   for (const entry of wallet.pending_melts) {
-    outcomes.push(await processEntry2(wallet, entry, now(), abandonAfterMs, getWalletForMint));
+    outcomes.push(
+      await processEntry2(wallet, entry, now(), abandonAfterMs, getWalletForMint, {
+        now,
+        sleep: opts.sleep,
+        timeoutMs: quoteRetryTimeoutMs
+      })
+    );
   }
   if (outcomes.some((o) => o.kind === "settled" || o.kind === "reverted")) {
     await withWalletLock(() => {
@@ -3066,17 +3180,23 @@ async function sweepPendingMelts(opts = {}) {
     errors: outcomes.filter((o) => o.kind === "error").map((o) => ({ quote_id: o.entry.quote_id, error: o.error }))
   };
 }
-async function processEntry2(wallet, entry, nowMs, abandonAfterMs, getWalletForMint) {
+async function processEntry2(wallet, entry, nowMs, abandonAfterMs, getWalletForMint, retry) {
   let cashuWallet;
-  try {
-    cashuWallet = await getWalletForMint(entry.mint);
-  } catch (err) {
-    return { kind: "error", entry, error: errorMessage3(err) };
-  }
   let state;
   try {
-    const quote = await cashuWallet.checkMeltQuoteBolt11(entry.quote_id);
-    state = quote.state;
+    ({ cashuWallet, state } = await retryMintQuoteOperation(
+      async () => {
+        const candidate = await getWalletForMint(entry.mint);
+        const quote = await candidate.checkMeltQuoteBolt11(entry.quote_id);
+        return { cashuWallet: candidate, state: quote.state };
+      },
+      {
+        deadlineMs: retry.now() + retry.timeoutMs,
+        quoteId: entry.quote_id,
+        now: retry.now,
+        sleep: retry.sleep
+      }
+    ));
   } catch (err) {
     return { kind: "error", entry, error: errorMessage3(err) };
   }
@@ -5415,7 +5535,8 @@ async function reserveAgentWallet(amountSats, opts) {
     mint: opts.mintUrl,
     quote_id: quote.quote,
     amount_sats: sats,
-    requested_at: (/* @__PURE__ */ new Date()).toISOString()
+    requested_at: (/* @__PURE__ */ new Date()).toISOString(),
+    ...quote.expiry === null ? {} : { expires_at: quote.expiry }
   };
   await withWalletLock(() => {
     const fresh = loadAgentWallet() ?? initial;

package/dist/internal/server.d.ts

@@ -1,23 +1,23 @@
 import { FacilitatorConfig } from '@x402/core/server';
-import { ai as PaymentPayload, ao as PaymentRequirementsV1, ap as PaymentRequirementsV2, aD as X402Config, au as SettleResponse, aB as VerifyResponse, bh as X402ExactVersionSupport, bi as X402Receipt, bj as TransactionalPayoutHook, bk as CashuMeltCompleted } from '../step-cache-3cT4Shk0.js';
-export { bl as CreditDepositPayload, bm as CreditDrainPayload, bn as FundingLot, bo as LotDebit, bp as LotDepletion, bq as MppxServer, br as NON_CHANNEL_BITCOIN_RAILS, bs as NonChannelBitcoinRail, bt as PayoutReporter, bu as PostgresTempoSessionStore, bv as RevenueReporter, bw as SIGNED_ENVELOPE_FIELDS, bx as SIGNED_ENVELOPE_TYPES, by as X402TrackedChannel, bz as _testing, bA as createDefaultReplayStore, bB as depleteLots, bC as fifoOrder, bD as inKindDrawMsats, bE as isInKindDepletion, bF as isNonChannelBitcoinRail, bG as lotOwedSats, bH as netOwedSats, bI as wrapMppx } from '../step-cache-3cT4Shk0.js';
+import { aj as PaymentPayload, ap as PaymentRequirementsV1, aq as PaymentRequirementsV2, aE as X402Config, av as SettleResponse, aC as VerifyResponse, bi as X402ExactVersionSupport, bj as X402Receipt, bk as TransactionalPayoutHook, bl as CashuMeltCompleted } from '../step-cache-BLPZNizw.js';
+export { bm as CreditDepositPayload, bn as CreditDrainPayload, bo as FundingLot, bp as LotDebit, bq as LotDepletion, br as MppxServer, bs as NON_CHANNEL_BITCOIN_RAILS, bt as NonChannelBitcoinRail, bu as PayoutReporter, bv as PostgresTempoSessionStore, bw as RevenueReporter, bx as SIGNED_ENVELOPE_FIELDS, by as SIGNED_ENVELOPE_TYPES, bz as X402TrackedChannel, bA as _testing, bB as createDefaultReplayStore, bC as depleteLots, bD as fifoOrder, bE as inKindDrawMsats, bF as isInKindDepletion, bG as isNonChannelBitcoinRail, bH as lotOwedSats, bI as netOwedSats, bJ as wrapMppx } from '../step-cache-BLPZNizw.js';
 import { Hono } from 'hono';
 import { Env, BlankSchema } from 'hono/types';
 import { Pool } from 'pg';
 export { Pool } from 'pg';
 import { g as getWallet } from '../wallet-CJC8lwxx.js';
-import { A as AccumulatorPool, a as AccumulatorQuerier, C as ConsumedCredentialStore } from '../credit-menu-C7zAJElJ.js';
-export { b as AppEnv, c as CreditFundingReport, F as FiatDenomination, d as FiatDenominationFailure, e as FundOnlyRequest, I as IncomingPaymentOpts, J as JobCancelledError, M as MintHealthTracker, P as PAYMENT_PROOF_KEYS, f as PaymentErrorCode, g as PaymentErrorDetail, h as PaymentInfo, R as ReporterBannerOpts, i as ResolvedFx, j as RevenueBootCheckOpts, S as SDKServerOpts, k as ServerJob, l as ShortPayForfeit, T as TempoChannelReport, m as TempoObserverHealth, n as TempoSessionChannelMismatchError, U as UpfrontPaymentOpts, V as VerifiedIncomingPayment, o as VerifyIncomingSnapshot, X as X402BatchChannelObservation, p as X402FacilitatorHealth, q as X402SettlementEvidenceOutcome, r as X402SettlementRepair, s as X402SettlementRepairRefusal, t as X402SettlementRepaired, u as X402WedgedSettlement, v as X402WedgedSettlementPage, w as X402_BATCH_SETTLEMENT_MAINNET_NETWORK, x as abortJob, y as applyPaymentInfoToJob, z as assertRevenueReporterReady, B as buildPaymentErrorResponse, D as clearAccumulatorForDvm, E as createDVMServer, G as creditDepositPayload, H as derivedFundCreditId, K as devModeSkipsPaymentVerification, L as fromJobRecord, N as fundedMicroFor, O as hasPaymentProof, Q as hashLockKey, W as implicitCreditId, Y as initWalletAccumulatorTable, Z as insertAccumulatorRows, _ as isDerivedCreditId, $ as isTerminal, a0 as isYieldMessage, a1 as issueUpfrontChallenges, a2 as msatsToFiatMicro, a3 as paymentErrorBody, a4 as pinAskFiat, a5 as priceFiatMicro, a6 as processIncomingPayment, a7 as providerMessage, a8 as repairX402ExactSettlementEffect, a9 as resolveFxSnapshot, aa as resolvePriceFiat, ab as revenueReporterBannerState, ac as toCreditTerms, ad as toJobRecord, ae as unknownRouteNotFound, af as verifyIncomingPayment, ag as verifyTempoSessionManagementCredential, ah as verifyUpfrontPayment, ai as x402RequiredUsdcMicro, aj as x402SettledShare } from '../credit-menu-C7zAJElJ.js';
-import { g as LockPubkey } from '../lightning-backend-C04nH94l.js';
-export { t as lockPubkeyStoreToLockPubkey } from '../lightning-backend-C04nH94l.js';
-export { O as OutgoingMessage, S as StaleJobReapable, i as isStaleJobReapable } from '../job-store-Bn23V3QU.js';
+import { A as AccumulatorPool, a as AccumulatorQuerier, C as ConsumedCredentialStore } from '../credit-menu-C1ezIFlJ.js';
+export { b as AppEnv, c as CreditFundingReport, F as FiatDenomination, d as FiatDenominationFailure, e as FundOnlyRequest, I as IncomingPaymentOpts, J as JobCancelledError, M as MintHealthTracker, P as PAYMENT_PROOF_KEYS, f as PaymentErrorCode, g as PaymentErrorDetail, h as PaymentInfo, R as ReporterBannerOpts, i as ResolvedFx, j as RevenueBootCheckOpts, S as SDKServerOpts, k as ServerJob, l as ShortPayForfeit, T as TempoChannelReport, m as TempoObserverHealth, n as TempoSessionChannelMismatchError, U as UpfrontPaymentOpts, V as VerifiedIncomingPayment, o as VerifyIncomingSnapshot, X as X402BatchChannelObservation, p as X402FacilitatorHealth, q as X402SettlementEvidenceOutcome, r as X402SettlementRepair, s as X402SettlementRepairRefusal, t as X402SettlementRepaired, u as X402WedgedSettlement, v as X402WedgedSettlementPage, w as X402_BATCH_SETTLEMENT_MAINNET_NETWORK, x as abortJob, y as applyPaymentInfoToJob, z as assertRevenueReporterReady, B as buildPaymentErrorResponse, D as clearAccumulatorForDvm, E as createDVMServer, G as creditDepositPayload, H as derivedFundCreditId, K as devModeSkipsPaymentVerification, L as fromJobRecord, N as fundedMicroFor, O as hasPaymentProof, Q as hashLockKey, W as implicitCreditId, Y as initWalletAccumulatorTable, Z as insertAccumulatorRows, _ as isDerivedCreditId, $ as isTerminal, a0 as isYieldMessage, a1 as issueUpfrontChallenges, a2 as msatsToFiatMicro, a3 as paymentErrorBody, a4 as pinAskFiat, a5 as priceFiatMicro, a6 as processIncomingPayment, a7 as providerMessage, a8 as repairX402ExactSettlementEffect, a9 as resolveFxSnapshot, aa as resolvePriceFiat, ab as revenueReporterBannerState, ac as toCreditTerms, ad as toJobRecord, ae as unknownRouteNotFound, af as verifyIncomingPayment, ag as verifyTempoSessionManagementCredential, ah as verifyUpfrontPayment, ai as x402RequiredUsdcMicro, aj as x402SettledShare } from '../credit-menu-C1ezIFlJ.js';
+import { g as LockPubkey } from '../lightning-backend-Ci1nogk_.js';
+export { t as lockPubkeyStoreToLockPubkey } from '../lightning-backend-Ci1nogk_.js';
+export { O as OutgoingMessage, S as StaleJobReapable, i as isStaleJobReapable } from '../job-store-DHnW4Cg_.js';
 import { Store } from 'mppx';
 import { z } from 'zod';
 import '@x402/evm/batch-settlement/server';
 import 'viem';
 import '@x402/core/types';
 import '@cashu/cashu-ts';
-import '../fx-BF_SG2i0.js';
+import '../fx-C6dl2LVI.js';
 
 /** POST a verify request to the configured facilitator. */
 declare function verifyWithFacilitator(payload: PaymentPayload, requirements: PaymentRequirementsV1 | PaymentRequirementsV2, config?: Pick<X402Config, "facilitator" | "facilitatorAuth">, createAuthHeaders?: FacilitatorConfig["createAuthHeaders"] | undefined): Promise<VerifyResponse>;

package/dist/internal/server.js

@@ -6,7 +6,7 @@ import {
 } from "../chunk-BIFLRKMO.js";
 import {
   RevenueReporter
-} from "../chunk-NFRM5QYP.js";
+} from "../chunk-EVBK675R.js";
 import {
   PayoutReporter
 } from "../chunk-6BQM7TOW.js";
@@ -65,7 +65,7 @@ import {
   verifyUpfrontPayment,
   x402RequiredUsdcMicro,
   x402SettledShare
-} from "../chunk-3ZHMQCYP.js";
+} from "../chunk-QK3VJNCK.js";
 import "../chunk-DMNLFNTW.js";
 import {
   settleWithFacilitator,
@@ -88,15 +88,15 @@ import {
   isYieldMessage,
   providerMessage,
   toJobRecord
-} from "../chunk-4B56DEEV.js";
+} from "../chunk-U6M3ATSG.js";
 import {
   toLockPubkey
-} from "../chunk-2K7E3N2D.js";
+} from "../chunk-VRQDX5P4.js";
 import "../chunk-Z4BNLUZF.js";
 import "../chunk-5URG56JJ.js";
 import "../chunk-MKI6OVW4.js";
 import "../chunk-KXZUCCEY.js";
-import "../chunk-YDIYXGYL.js";
+import "../chunk-E4EVGPDX.js";
 import "../chunk-66HGCPBU.js";
 import "../chunk-FUJ36YDV.js";
 import "../chunk-27V2ILSR.js";

package/dist/{job-store-Bn23V3QU.d.ts → job-store-DHnW4Cg_.d.ts}

@@ -1,5 +1,5 @@
 import { ProofLike } from '@cashu/cashu-ts';
-import { a0 as Message, ag as FundingMethod, W as FundingReceipt, bN as CreditSnapshot, X as JobReceipt, aw as StepRecord, a1 as MessageType } from './step-cache-3cT4Shk0.js';
+import { a1 as Message, ah as FundingMethod, X as FundingReceipt, bO as CreditSnapshot, Y as JobReceipt, ax as StepRecord, a2 as MessageType } from './step-cache-BLPZNizw.js';
 
 /** Job status values that can be persisted. */
 type JobStatus = "processing" | "completed" | "failed" | "awaiting-input" | "cancelled" | "working";
@@ -81,6 +81,21 @@ interface JobRecord {
     nativeAsset?: "sats" | "usdc" | "usdc.e" | "usd-cents";
     /** Cashu flow discriminator written into `revenue_events.metadata.cashu_flow` (internal-review). */
     cashuFlow?: "p2pk_accumulator";
+    /**
+     * What this job cost the **builder** to serve, in 1e-6 of
+     * {@link JobRecord.costCurrency} (internal-review). Mirror of
+     * `ServerJob.costAmountMicro`; see that field. Absent means unreported,
+     * which the platform treats differently from a declared zero.
+     */
+    costAmountMicro?: number;
+    /** Currency {@link JobRecord.costAmountMicro} is 1e-6 of (lowercase ISO-4217). */
+    costCurrency?: string;
+    /**
+     * Number of `ctx.cost()` declarations incorporated into the current cost
+     * state. Lets the platform deterministically replace a stale persisted
+     * prefix with the handler owner's later cumulative value.
+     */
+    costRevision?: number;
     /**
      * Credit the upfront payment funded/drew (internal-review). The terminal funnel
      * settles the draw on success and releases it on failure/cancel, and the

package/dist/{lightning-backend-C04nH94l.d.ts → lightning-backend-Ci1nogk_.d.ts}

@@ -1,4 +1,4 @@
-import { V as JsonValue } from './step-cache-3cT4Shk0.js';
+import { W as JsonValue } from './step-cache-BLPZNizw.js';
 
 declare const lockPubkeyBrand: unique symbol;
 /**

package/dist/{postgres-job-store-TAONYLIF.js → postgres-job-store-3RAXMNSY.js}

@@ -1,6 +1,6 @@
 import {
   PostgresJobStore
-} from "./chunk-LLXV32HA.js";
+} from "./chunk-SSSZUVWM.js";
 import "./chunk-S3XAHZQY.js";
 export {
   PostgresJobStore

package/dist/{revenue-reporter-XXSU5KVB.js → revenue-reporter-ASZ7SHHH.js}

@@ -1,6 +1,6 @@
 import {
   RevenueReporter
-} from "./chunk-NFRM5QYP.js";
+} from "./chunk-EVBK675R.js";
 import "./chunk-S3XAHZQY.js";
 export {
   RevenueReporter

package/dist/server/index.d.ts

@@ -1,20 +1,20 @@
-import { aa as CashuMode, bJ as CreditDrainEnqueue, R as ResolvedCreditConfig, bK as DVMAuthScheme, z as SignedRequestDomain, bL as CreditLedgerLike, bM as X402RefundSettlementGate, bN as CreditSnapshot, bO as DrawResult, bP as X402SettlementStatus, bQ as X402UnresolvedRefund, bR as GrownDrawResult, bS as DrawResolution, bT as FundingRecord, W as FundingReceipt, bU as CreditInvoiceRecord, bV as InvoiceSettlement, bW as BlockedInvoiceCursor, bX as InvoiceReconciliation, bY as InvoiceWriteOff, bZ as DrawRecord, b_ as StalePendingDrawCursor, b$ as TempoCreditLossEvidence, c0 as CreditLedgerQuerier, c1 as TempoCreditLoss, c2 as X402CreditLossEvidence, c3 as X402CreditLoss, c4 as DrainMethod, c5 as DrainRequestResult, c6 as BitcoinDepositLiability, bn as FundingLot, c7 as CreditDrainRecord, c8 as ChannelDrainCursor, c9 as DrainWriteOff, ca as DrainReleaseResult, cb as DrainFulfilment, cc as DrainTransitionResult, X as JobReceipt, a0 as Message, K as KVStore, F as SignedRequestReplayStore, Z as ZodLike, a as DVMDescriptor } from '../step-cache-3cT4Shk0.js';
-export { cd as CLIENT_COMPATIBILITY_HEADERS, d as CanonicalEnvelope, ce as ClientCompatibility, cf as ClientCompatibilityEnv, cg as ClientCompatibilityGate, ch as ClientCompatibilityRequirement, ci as ClientSemVer, e as CreateSignedRequestVerifierOpts, cj as CreditFundingBasis, ck as CreditInvoiceStatus, cl as CreditLedger, cm as CreditLedgerError, cn as CreditLedgerErrorCode, co as CreditLedgerErrorDetails, cp as CreditLedgerPool, cq as CreditStatus, cr as DRAIN_DELIVERY_RESERVE_SATS, cs as DVM_PROTOCOL_VERSION, ct as DrainConflictReason, cu as DrawRailValue, cv as DrawStatus, cw as PostgresX402ChannelStorage, cx as ReplayStoreBackend, cy as RevenueSkippedNoRailPayload, cz as RevenueSkippedNoRailReason, w as SIGNED_REQUEST_AUTH_ID, x as SIGNED_REQUEST_STATEMENT_VERSION, cA as Secp256k1AuthOpts, y as SignedRequestAudience, B as SignedRequestError, E as SignedRequestFailure, G as SignedRequestSignOpts, H as SignedRequestStatementHeader, J as SignedRequestVerifier, cB as X402ChannelStorageOpts, cC as X402RelayLockHolder, cD as X402RelaySubmissionLock, cE as X402RelaySubmissionLockError, cF as allocateDrawValue, cG as clientCompatibilityAttributes, cH as clientCompatibilityMiddleware, cI as clientUpgradeRequired, M as createSignedRequestVerifier, cJ as parseClientCapabilities, cK as parseClientCompatibility, cL as parseDvmClient, cM as parseProtocolVersion, cN as requireClientCompatibility, cO as secp256k1Auth, cP as signedRequestInput, O as signedRequestStatementHeader } from '../step-cache-3cT4Shk0.js';
+import { ab as CashuMode, bK as CreditDrainEnqueue, R as ResolvedCreditConfig, bL as DVMAuthScheme, z as SignedRequestDomain, bM as CreditLedgerLike, bN as X402RefundSettlementGate, bO as CreditSnapshot, bP as DrawResult, bQ as X402SettlementStatus, bR as X402UnresolvedRefund, bS as GrownDrawResult, bT as DrawResolution, bU as FundingRecord, X as FundingReceipt, bV as CreditInvoiceRecord, bW as InvoiceSettlement, bX as BlockedInvoiceCursor, bY as InvoiceReconciliation, bZ as InvoiceWriteOff, b_ as DrawRecord, b$ as StalePendingDrawCursor, c0 as TempoCreditLossEvidence, c1 as CreditLedgerQuerier, c2 as TempoCreditLoss, c3 as X402CreditLossEvidence, c4 as X402CreditLoss, c5 as DrainMethod, c6 as DrainRequestResult, c7 as BitcoinDepositLiability, bo as FundingLot, c8 as CreditDrainRecord, c9 as ChannelDrainCursor, ca as DrainWriteOff, cb as DrainReleaseResult, cc as DrainFulfilment, cd as DrainTransitionResult, Y as JobReceipt, a1 as Message, K as KVStore, F as SignedRequestReplayStore, Z as ZodLike, a as DVMDescriptor } from '../step-cache-BLPZNizw.js';
+export { ce as CLIENT_COMPATIBILITY_HEADERS, d as CanonicalEnvelope, cf as ClientCompatibility, cg as ClientCompatibilityEnv, ch as ClientCompatibilityGate, ci as ClientCompatibilityRequirement, cj as ClientSemVer, e as CreateSignedRequestVerifierOpts, ck as CreditFundingBasis, cl as CreditInvoiceStatus, cm as CreditLedger, cn as CreditLedgerError, co as CreditLedgerErrorCode, cp as CreditLedgerErrorDetails, cq as CreditLedgerPool, cr as CreditStatus, cs as DRAIN_DELIVERY_RESERVE_SATS, ct as DVM_PROTOCOL_VERSION, cu as DrainConflictReason, cv as DrawRailValue, cw as DrawStatus, cx as JobCostReportPayload, cy as PostgresX402ChannelStorage, cz as ReplayStoreBackend, cA as RevenueSkippedNoRailPayload, cB as RevenueSkippedNoRailReason, w as SIGNED_REQUEST_AUTH_ID, x as SIGNED_REQUEST_STATEMENT_VERSION, cC as Secp256k1AuthOpts, y as SignedRequestAudience, B as SignedRequestError, E as SignedRequestFailure, G as SignedRequestSignOpts, H as SignedRequestStatementHeader, M as SignedRequestVerifier, cD as X402ChannelStorageOpts, cE as X402RelayLockHolder, cF as X402RelaySubmissionLock, cG as X402RelaySubmissionLockError, cH as allocateDrawValue, cI as clientCompatibilityAttributes, cJ as clientCompatibilityMiddleware, cK as clientUpgradeRequired, N as createSignedRequestVerifier, cL as parseClientCapabilities, cM as parseClientCompatibility, cN as parseDvmClient, cO as parseProtocolVersion, cP as requireClientCompatibility, cQ as secp256k1Auth, cR as signedRequestInput, T as signedRequestStatementHeader } from '../step-cache-BLPZNizw.js';
 import { Pool } from 'pg';
-import { ak as CreditMenu, b as AppEnv, U as UpfrontPaymentOpts, h as PaymentInfo, al as ReceiptIssuer, am as LightningReceive, an as TempoSettlementReadiness, ao as DVMHostOpts } from '../credit-menu-C7zAJElJ.js';
-export { ap as BuildCreditMenuArgs, aq as BuilderIdentity, ar as CREDIT_ENVELOPE_KEYS, C as ConsumedCredentialStore, as as CreateX402BatchSettlementServerOpts, at as CreditEnvelope, au as CreditEnvelopeError, av as CreditFundCommitment, aw as CreditTerms, ax as DEFAULT_INVOICE_TTL_SECONDS, ay as DVMHost, az as JobManager, aA as JobManagerOpts, aB as LightningReceiveConfig, aC as MIN_INVOICE_TTL_SECONDS, aD as MemoryConsumedCredentialStore, aE as MemoryConsumedCredentialStoreOpts, aF as MemoryProcessedPaymentStore, aG as MemoryX402ExactSettlementStore, aH as MountOpts, aI as OwnerDisplay, aJ as PlatformReporterOpts, aK as PostgresProcessedPaymentStore, aL as PostgresX402ExactSettlementStore, aM as PriceFiat, aN as ProcessedPaymentQuerier, aO as ProcessedPaymentRail, aP as ProcessedPaymentRecord, aQ as ProcessedPaymentReplayError, aR as ProcessedPaymentStore, aS as X402BatchAcceptance, aT as X402BatchFunding, aU as X402BatchRefusal, aV as X402BatchSettlementServer, aW as X402ExactAcceptance, aX as X402ExactIntentConflictError, aY as X402ExactSettlementAttempt, aZ as X402ExactSettlementChainEvidence, a_ as X402ExactSettlementEffect, a$ as X402ExactSettlementEvidenceMissingError, b0 as X402ExactSettlementEvidenceReader, b1 as X402ExactSettlementIntent, b2 as X402ExactSettlementNotReadyError, b3 as X402ExactSettlementServer, b4 as X402ExactSettlementServerOpts, b5 as X402ExactSettlementStatus, b6 as X402ExactSettlementStore, b7 as X402SettlementChainEvidence, b8 as X402SettlementEvidenceReader, b9 as X402SettlementSubmissionError, ba as X402_BATCH_AUTO_SETTLEMENT, bb as X402_BATCH_MIN_WITHDRAW_DELAY_SECONDS, bc as X402_BATCH_SETTLEMENT_NETWORK, bd as attachCreditMenu, be as buildCreditMenu, bf as createDVMHost, bg as createX402BatchSettlementServer, bh as creditEnvelopeIgnoreFields, bi as drawSettlementRef, bj as extractCreditEnvelope, bk as fundingCommitment, bl as selectPrimaryCredit, bm as stripCreditEnvelope, bn as toCreditView } from '../credit-menu-C7zAJElJ.js';
+import { ak as CreditMenu, b as AppEnv, U as UpfrontPaymentOpts, h as PaymentInfo, al as ReceiptIssuer, am as LightningReceive, an as TempoSettlementReadiness, ao as DVMHostOpts } from '../credit-menu-C1ezIFlJ.js';
+export { ap as BuildCreditMenuArgs, aq as BuilderIdentity, ar as CREDIT_ENVELOPE_KEYS, C as ConsumedCredentialStore, as as CreateX402BatchSettlementServerOpts, at as CreditEnvelope, au as CreditEnvelopeError, av as CreditFundCommitment, aw as CreditTerms, ax as DEFAULT_INVOICE_TTL_SECONDS, ay as DVMHost, az as JobManager, aA as JobManagerOpts, aB as LightningReceiveConfig, aC as MIN_INVOICE_TTL_SECONDS, aD as MemoryConsumedCredentialStore, aE as MemoryConsumedCredentialStoreOpts, aF as MemoryProcessedPaymentStore, aG as MemoryX402ExactSettlementStore, aH as MountOpts, aI as OwnerDisplay, aJ as PlatformReporterOpts, aK as PostgresProcessedPaymentStore, aL as PostgresX402ExactSettlementStore, aM as PriceFiat, aN as ProcessedPaymentQuerier, aO as ProcessedPaymentRail, aP as ProcessedPaymentRecord, aQ as ProcessedPaymentReplayError, aR as ProcessedPaymentStore, aS as X402BatchAcceptance, aT as X402BatchFunding, aU as X402BatchRefusal, aV as X402BatchSettlementServer, aW as X402ExactAcceptance, aX as X402ExactIntentConflictError, aY as X402ExactSettlementAttempt, aZ as X402ExactSettlementChainEvidence, a_ as X402ExactSettlementEffect, a$ as X402ExactSettlementEvidenceMissingError, b0 as X402ExactSettlementEvidenceReader, b1 as X402ExactSettlementIntent, b2 as X402ExactSettlementNotReadyError, b3 as X402ExactSettlementServer, b4 as X402ExactSettlementServerOpts, b5 as X402ExactSettlementStatus, b6 as X402ExactSettlementStore, b7 as X402SettlementChainEvidence, b8 as X402SettlementEvidenceReader, b9 as X402SettlementSubmissionError, ba as X402_BATCH_AUTO_SETTLEMENT, bb as X402_BATCH_MIN_WITHDRAW_DELAY_SECONDS, bc as X402_BATCH_SETTLEMENT_NETWORK, bd as attachCreditMenu, be as buildCreditMenu, bf as createDVMHost, bg as createX402BatchSettlementServer, bh as creditEnvelopeIgnoreFields, bi as drawSettlementRef, bj as extractCreditEnvelope, bk as fundingCommitment, bl as selectPrimaryCredit, bm as stripCreditEnvelope, bn as toCreditView } from '../credit-menu-C1ezIFlJ.js';
 import { Context } from 'hono';
 import { z } from 'zod';
-import { F as FxFetcher } from '../fx-BF_SG2i0.js';
-import { c as StreamableJobStore, R as ReceiptIssuingStore, J as JobRecord, d as RequestIdClaim, e as RequestIdClaimResult, f as JobRetentionCursor, O as OutgoingMessage, A as AppendOutgoingOptions, P as PaymentCreditDelta, V as VerifyAndCreditResult, g as JobCounters } from '../job-store-Bn23V3QU.js';
-export { a as JobStatus, b as JobStore, h as isStreamableJobStore } from '../job-store-Bn23V3QU.js';
+import { F as FxFetcher } from '../fx-C6dl2LVI.js';
+import { c as StreamableJobStore, R as ReceiptIssuingStore, J as JobRecord, d as RequestIdClaim, e as RequestIdClaimResult, f as JobRetentionCursor, O as OutgoingMessage, A as AppendOutgoingOptions, P as PaymentCreditDelta, V as VerifyAndCreditResult, g as JobCounters } from '../job-store-DHnW4Cg_.js';
+export { a as JobStatus, b as JobStore, h as isStreamableJobStore } from '../job-store-DHnW4Cg_.js';
 export { P as PinnedFetch, S as SSRFError, a as SSRFGuardOpts, b as SSRFReason, c as SSRFResolver, d as assertSafeUrl, e as createPinnedFetch } from '../ssrf-DbFkpDv0.js';
 import 'mppx';
 import '@x402/core/server';
 import '@x402/evm/batch-settlement/server';
 import 'viem';
 import '@x402/core/types';
-import '../lightning-backend-C04nH94l.js';
+import '../lightning-backend-Ci1nogk_.js';
 import '@cashu/cashu-ts';
 
 /** Lifetime of a per-call implicit credit before the ledger refuses new draws. */
@@ -450,6 +450,20 @@ declare class PostgresJobStore implements StreamableJobStore, ReceiptIssuingStor
     private acquireRequestIdClaim;
     releaseRequestIdClaim(claim: RequestIdClaim): Promise<void>;
     save(record: JobRecord): Promise<void>;
+    /** Persist a job while retaining its mount identity for cost-report recovery. */
+    saveForDvm(record: JobRecord, dvmId: string): Promise<void>;
+    private saveRecord;
+    /**
+     * Read terminal zero-revenue jobs whose latest declared-cost revision has
+     * not yet reached the durable reporter outbox.
+     */
+    listUnreportedTerminalCosts(args: {
+        dvmId: string;
+        limit: number;
+        afterJobId?: string;
+    }): Promise<JobRecord[]>;
+    /** Mark one revision only after its report has reached durable enqueue. */
+    markTerminalCostReported(jobId: string, costRevision: number): Promise<boolean>;
     delete(id: string): Promise<void>;
     listJobsForRetention(args: {
         lastActivityBeforeMs: number;

package/dist/server/index.js

@@ -3,7 +3,7 @@ import {
 } from "../chunk-L4OYF4DQ.js";
 import {
   PostgresJobStore
-} from "../chunk-LLXV32HA.js";
+} from "../chunk-SSSZUVWM.js";
 import {
   PostgresKVStore
 } from "../chunk-FROTD5XQ.js";
@@ -22,7 +22,7 @@ import {
   parseNwcUri,
   validateX402Env,
   withNwcPool
-} from "../chunk-EPNDZ5DH.js";
+} from "../chunk-EDDYHZ6W.js";
 import {
   MemoryKVStore
 } from "../chunk-RW5LP57K.js";
@@ -77,7 +77,7 @@ import {
   stripProtocolEnvelope,
   toCreditView,
   unknownRouteNotFound
-} from "../chunk-3ZHMQCYP.js";
+} from "../chunk-QK3VJNCK.js";
 import {
   MemoryProcessedPaymentStore,
   PostgresProcessedPaymentStore,
@@ -95,11 +95,11 @@ import {
 } from "../chunk-H2MEFVH6.js";
 import {
   isStreamableJobStore
-} from "../chunk-4B56DEEV.js";
+} from "../chunk-U6M3ATSG.js";
 import {
   generateEphemeralReceiptKey,
   receiptPubkeyFromSecret
-} from "../chunk-2K7E3N2D.js";
+} from "../chunk-VRQDX5P4.js";
 import {
   X402_DEFAULT_FACILITATOR,
   X402_DEFAULT_NETWORK,
@@ -119,7 +119,7 @@ import {
 } from "../chunk-KXZUCCEY.js";
 import {
   initLoggers
-} from "../chunk-YDIYXGYL.js";
+} from "../chunk-E4EVGPDX.js";
 import "../chunk-66HGCPBU.js";
 import "../chunk-FUJ36YDV.js";
 import "../chunk-27V2ILSR.js";
@@ -1130,7 +1130,7 @@ function createDVMHost(opts = {}) {
       });
       applyRetryToPool(pool, "dvm-host");
       pgPool = pool;
-      const { PostgresJobStore: PostgresJobStore2 } = await import("../postgres-job-store-TAONYLIF.js");
+      const { PostgresJobStore: PostgresJobStore2 } = await import("../postgres-job-store-3RAXMNSY.js");
       const pgJobStore = new PostgresJobStore2(pool);
       pendingInits.push(pgJobStore.init(), pgJobStore.initStreaming());
       jobStore = pgJobStore;