@dvmkit/sdk 0.6.0-rc.1 → 0.7.0-rc.2

package/dist/{chunk-HHBDBMEO.js → chunk-A6CXKAQV.js}

@@ -1,20 +1,28 @@
 import {
-  MemoryProcessedPaymentStore,
-  PostgresProcessedPaymentStore,
-  ProcessedPaymentReplayError
-} from "./chunk-XRLKGCAW.js";
+  TEMPO_MODERATO_CHAIN_ID,
+  TEMPO_MODERATO_RPC,
+  advertisedMethods,
+  challengeMeta,
+  installHostedTempoChargeGuard,
+  installHostedTempoCloseGuard,
+  isTempoInsufficientFundsError,
+  resolveTempoNetwork
+} from "./chunk-HCE4MPZ5.js";
 import {
   createX402FacilitatorAuthHeaders,
   createX402FacilitatorClient,
+  paymentFailureStage,
   settleWithFacilitator,
-  verifyWithFacilitator
-} from "./chunk-PLG4XER6.js";
+  verifyWithFacilitator,
+  withPaymentDiagnostics,
+  withPaymentStage
+} from "./chunk-26W6GPCD.js";
 import {
   MemoryCreditLedger
-} from "./chunk-FYRR2UEZ.js";
+} from "./chunk-I555L2WK.js";
 import {
   PostgresJobStore
-} from "./chunk-EQLA4FFY.js";
+} from "./chunk-IIZQNDQU.js";
 import {
   parseStoreValue
 } from "./chunk-YG7G4DPZ.js";
@@ -25,7 +33,7 @@ import {
   humanizeZodIssues,
   signedRequestInput,
   zodIssuesOf
-} from "./chunk-N5RZ5HVB.js";
+} from "./chunk-72V5DTEC.js";
 import {
   MemoryJobStore,
   UNCAPPABLE_ASK_TOTAL,
@@ -34,7 +42,7 @@ import {
   isJobRetentionStore,
   isReceiptIssuingStore,
   isStreamableJobStore
-} from "./chunk-IV6Q7NRW.js";
+} from "./chunk-RAGX6VG7.js";
 import {
   ContentHoldError,
   JobCancelledError,
@@ -53,23 +61,26 @@ import {
   ADMIN_AUTH_CLOCK_SKEW_SECONDS,
   ADMIN_AUTH_NONCE_TTL_SECONDS,
   ADMIN_STATE_UNAVAILABLE,
+  IMPLICIT_CREDIT_TTL_MS,
   TEMPO_SESSION_UPDATED_REASON,
   X402_BATCH_CHANNEL_ABI,
   attestedDvmIdentity,
   buildAdminChallenge,
   checkMintHealth,
+  computeResultHash,
   createMonotonicClock,
+  formatStaleness,
   getWallet,
   isPublicRequestId,
-  isTestMintUrl,
   isX402SettlementReconciliationReason,
-  normaliseMintUrl,
   parseTraceparent,
   receiptPubkeyFromSecret,
+  signDrainReceipt,
+  signFundingReceipt,
+  signReceipt,
   toLockPubkey,
-  verifyCashuToken,
   verifyChallenge
-} from "./chunk-OQA7IHI4.js";
+} from "./chunk-VB5OLOZH.js";
 import {
   X402_BATCH_SETTLEMENT_SCHEME,
   X402_DEFAULT_FACILITATOR,
@@ -82,38 +93,26 @@ import {
   encodePaymentRequiredHeader,
   encodeSettleResponseHeader,
   exactEvmAuthorization,
-  paymentRequiredV2FromV1,
-  x402NetworkToCaip2
-} from "./chunk-IWQHUSMO.js";
-import {
-  IMPLICIT_CREDIT_TTL_MS,
-  computeResultHash,
-  formatStaleness,
   msatsToUsd,
   msatsToUsdc,
-  signDrainReceipt,
-  signFundingReceipt,
-  signReceipt,
-  usdcToMsats
-} from "./chunk-PAIM66YA.js";
-import {
-  resolveRpcOverride
-} from "./chunk-CZULM42S.js";
+  paymentRequiredV2FromV1,
+  resolveRpcOverride,
+  usdcToMsats,
+  x402NetworkToCaip2
+} from "./chunk-62FI3NJF.js";
 import {
   RAIL_REFUNDABLE,
   canonicalRequestPath,
+  canonicalize,
   isZodSchema
-} from "./chunk-RCM3P2HE.js";
-import {
-  canonicalize
-} from "./chunk-OFVV37XC.js";
+} from "./chunk-UKD3R2KU.js";
 import {
   createConsoleLogger,
   loggers,
   pinDimension,
   withSpan,
   withTraceContext
-} from "./chunk-QR2EF2NI.js";
+} from "./chunk-AQ7OX5NX.js";
 import {
   StepCache
 } from "./chunk-BQJIFRAZ.js";
@@ -122,16 +121,14 @@ import {
   InvalidCurrencyError,
   UnsupportedCurrencyError,
   createFxFetcher,
-  fxRateFor,
-  resolveFxSourceFromEnv,
-  validateCurrency
-} from "./chunk-BYCEKO65.js";
-import {
   fiatToSatsCeil,
+  fxRateFor,
   parseUsdPrice,
+  resolveFxSourceFromEnv,
   roundUsd,
-  satsToFiat
-} from "./chunk-AT6V3SY7.js";
+  satsToFiat,
+  validateCurrency
+} from "./chunk-CLIAFTUR.js";
 import {
   CreditLedger,
   CreditLedgerError,
@@ -147,30 +144,26 @@ import {
   isNonChannelBitcoinRail,
   netOwedSats,
   x402SettlementPending
-} from "./chunk-JH3SX3LY.js";
-import {
-  withSdkInitLock
-} from "./chunk-COYKJRMM.js";
+} from "./chunk-SPYEJXI7.js";
 import {
   withPostgresRecoveryContext
-} from "./chunk-P6QON7ER.js";
+} from "./chunk-TRNMTTPX.js";
 import {
+  DvmError,
   x402NetworkByCaip2
-} from "./chunk-RLTSCKRI.js";
-import {
-  TEMPO_MODERATO_CHAIN_ID,
-  TEMPO_MODERATO_RPC,
-  advertisedMethods,
-  challengeMeta,
-  installHostedTempoChargeGuard,
-  installHostedTempoCloseGuard,
-  isTempoInsufficientFundsError,
-  resolveTempoNetwork
-} from "./chunk-IXR5RFK7.js";
+} from "./chunk-BPYMEMQX.js";
 import {
   createDiagnosticCapabilityAuthority,
   diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
+} from "./chunk-LAKP6FUI.js";
+import {
+  MemoryProcessedPaymentStore,
+  PostgresProcessedPaymentStore,
+  ProcessedPaymentReplayError
+} from "./chunk-XRLKGCAW.js";
+import {
+  withSdkInitLock
+} from "./chunk-COYKJRMM.js";
 
 // src/sdk/server/lock-pubkey-store.ts
 async function initLockPubkeyTable(db) {
@@ -3163,10 +3156,66 @@ function isRecord(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
 
+// src/sdk/server/payment-diagnostics.ts
+import { Errors } from "mppx";
+function paymentFailureFields(error) {
+  let category = "unknown";
+  try {
+    if (error instanceof ProcessedPaymentReplayError) category = "replay_detected";
+    else if (error instanceof CreditLedgerError) category = "ledger_refused";
+    else if (error instanceof Errors.InvalidChallengeError) category = "invalid_challenge";
+    else if (error instanceof Errors.MalformedCredentialError || error instanceof Errors.InvalidPayloadError) category = "malformed_credential";
+    else if (error instanceof Errors.PaymentExpiredError) category = "payment_expired";
+    else if (error instanceof Errors.VerificationFailedError) category = "verification_failed";
+    else if (error instanceof Errors.PaymentInsufficientError || error instanceof Errors.InsufficientBalanceError) category = "insufficient_funds";
+    else if (error instanceof Errors.InvalidSignatureError) category = "invalid_signature";
+    else if (error instanceof Errors.PaymentMethodUnsupportedError) category = "unsupported_method";
+  } catch {
+  }
+  return { failure_category: category, failure_stage: paymentFailureStage(error) };
+}
+
 // src/sdk/server/payment.ts
 import { randomBytes, randomUUID as randomUUID2 } from "crypto";
 import { Challenge } from "mppx";
 
+// src/lib/cashu/verify.ts
+import { getTokenMetadata } from "@cashu/cashu-ts";
+function verifyCashuToken(token, acceptedMints) {
+  let mint, unit, totalMsats;
+  try {
+    const meta = getTokenMetadata(token);
+    mint = meta.mint;
+    unit = meta.unit;
+    totalMsats = meta.amount.toNumber() * 1e3;
+  } catch {
+    throw new DvmError(
+      "cashu_invalid_token",
+      "The Cashu token could not be decoded.",
+      "Ensure the token is a valid cashuA... or cashuB... string."
+    );
+  }
+  const normalised = acceptedMints.map(normaliseMintUrl);
+  if (!normalised.includes(normaliseMintUrl(mint))) {
+    throw new DvmError(
+      "cashu_mint_not_accepted",
+      `Mint ${mint} is not accepted by this provider.`,
+      `Accepted mints: ${acceptedMints.join(", ")}`
+    );
+  }
+  return { mint, totalMsats, unit };
+}
+function normaliseMintUrl(url) {
+  try {
+    const u = new URL(url);
+    u.hostname = u.hostname.toLowerCase();
+    u.pathname = u.pathname.replace(/\/+/g, "/").replace(/\/+$/, "") || "/";
+    return u.toString().replace(/\/$/, "");
+  } catch {
+    return url.toLowerCase().replace(/\/+$/, "");
+  }
+}
+
 // src/sdk/server/mpp-units.ts
 function decimalsFor(methodName) {
   switch (methodName) {
@@ -3221,6 +3270,22 @@ function methodNativeAmountToDecimal(amount, methodName) {
   return `${nativeAmount2 / scale}.${(nativeAmount2 % scale).toString().padStart(decimals, "0")}`;
 }
 
+// src/lib/mints.ts
+function isTestMintUrl(url) {
+  let host;
+  try {
+    host = new URL(url).hostname.toLowerCase();
+  } catch {
+    return false;
+  }
+  if (host.startsWith("[") && host.endsWith("]")) host = host.slice(1, -1);
+  if (LOOPBACK_HOSTS.has(host)) return true;
+  if (host.endsWith(".localhost")) return true;
+  return TEST_MINT_HOSTS.has(host);
+}
+var LOOPBACK_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "0.0.0.0", "::1"]);
+var TEST_MINT_HOSTS = /* @__PURE__ */ new Set(["testnut.cashu.space", "dvmkit-testmint.fly.dev"]);
+
 // src/sdk/server/wallet-accumulator-receive.ts
 import {
   Amount as Amount2,
@@ -3470,6 +3535,9 @@ async function issueUpfrontChallenges(mpp, requiredMsats, resourcePath, btcUsdRa
   );
 }
 async function verifyUpfrontPayment(opts) {
+  return withPaymentDiagnostics(() => verifyUpfrontPaymentInScope(opts));
+}
+async function verifyUpfrontPaymentInScope(opts) {
   const {
     cashuToken,
     requiredMsats,
@@ -3735,7 +3803,10 @@ async function verifyUpfrontPayment(opts) {
       );
     } catch (err) {
       const mapped = mapLedgerCommitError(err, x402Requirements);
-      if (mapped) return mapped;
+      if (mapped) {
+        logCredentialRejected("x402", "upfront", err);
+        return mapped;
+      }
       logCredentialRejected("x402", "upfront", err);
       return {
         paidMsats: 0,
@@ -3796,15 +3867,15 @@ async function verifyUpfrontPayment(opts) {
           x402Requirements
         });
       }
-      const { verifyX402Payment } = await import("./x402-R6HPBY5D.js");
-      const receipt = await verifyX402Payment(
+      const { verifyX402Payment } = await import("./x402-ZU4GML7Z.js");
+      const receipt = await withPaymentStage("verifier_broadcast", () => verifyX402Payment(
         x402Payment,
         x402Config,
         requiredUsdcMicro,
         x402Resource ?? "/v1/job",
         rate ?? 0,
         x402ExactVersions
-      );
+      ));
       if (receipt.verified) {
         const settledUsdcMicro = receipt.amountUsdcMicro;
         const paidMsats = settledUsdcMicro === void 0 ? receipt.amountMsats : x402SettledShare(requiredMsats, Number(requiredUsdcMicro), settledUsdcMicro);
@@ -3848,7 +3919,10 @@ async function verifyUpfrontPayment(opts) {
             });
           } catch (err) {
             const mapped = mapLedgerCommitError(err, x402Requirements, true);
-            if (mapped) return mapped;
+            if (mapped) {
+              logCredentialRejected("x402", "upfront", err);
+              return mapped;
+            }
             throw err;
           }
         }
@@ -3965,7 +4039,7 @@ async function verifyUpfrontPayment(opts) {
             challenge_id: cred.challenge.id,
             amount: expectedAmount
           },
-          () => mpp.broadcastCredential(mppCredential, {
+          () => withPaymentStage("verifier_broadcast", () => mpp.broadcastCredential(mppCredential, {
             request: { amount: expectedAmount },
             ...opts.hostingAdmissionId && {
               hostedPaymentIntent: {
@@ -3984,7 +4058,8 @@ async function verifyUpfrontPayment(opts) {
               path: resourcePath ?? "/v1/job",
               nonce: challengeMeta(cred.challenge)?.nonce ?? ""
             }
-          })
+          })),
+          { onError: paymentFailureFields }
         );
         tempoReceipt = receipt;
         return receipt;
@@ -4041,7 +4116,10 @@ async function verifyUpfrontPayment(opts) {
           credited = accepted.result;
         } catch (err) {
           const mapped = mapLedgerCommitError(err, x402Requirements, true);
-          if (mapped) return mapped;
+          if (mapped) {
+            logCredentialRejected("tempo", "upfront", err);
+            return mapped;
+          }
           throw err;
         }
       } else {
@@ -4072,7 +4150,7 @@ async function verifyUpfrontPayment(opts) {
       if (consumedCredentialStore) {
         const realm = mpp.realm;
         const id = cred.challenge.id;
-        if (await consumedCredentialStore.has(realm, id)) {
+        if (await withPaymentStage("replay_store", () => consumedCredentialStore.has(realm, id))) {
           const mppChallenges = await issueUpfrontChallenges(
             mpp,
             requiredMsats,
@@ -4096,7 +4174,7 @@ async function verifyUpfrontPayment(opts) {
           };
         }
         if (!sessionBasis) {
-          await consumedCredentialStore.mark(realm, id, CONSUMED_CREDENTIAL_TTL_MS / 1e3);
+          await withPaymentStage("replay_store", () => consumedCredentialStore.mark(realm, id, CONSUMED_CREDENTIAL_TTL_MS / 1e3));
         }
       }
       if (ledgerCtx) {
@@ -4111,16 +4189,19 @@ async function verifyUpfrontPayment(opts) {
           });
         } catch (err) {
           const mapped = mapLedgerCommitError(err, x402Requirements, true);
-          if (mapped) return mapped;
+          if (mapped) {
+            logCredentialRejected("tempo", "upfront", err);
+            return mapped;
+          }
           throw err;
         }
       }
       if (sessionBasis && consumedCredentialStore) {
-        await consumedCredentialStore.mark(
+        await withPaymentStage("replay_store", () => consumedCredentialStore.mark(
           mpp.realm,
           cred.challenge.id,
           CONSUMED_CREDENTIAL_TTL_MS / 1e3
-        );
+        ));
       }
       if (credited) {
         await mpp.completeHostedTempoCharge?.(cred.challenge.id).catch((error) => {
@@ -4689,6 +4770,9 @@ function buildPaymentErrorResponse(body, challenges, x402Requirements, status, x
   return new Response(JSON.stringify(mergedBody), { status: status ?? 402, headers });
 }
 async function verifyIncomingPayment(body, opts, snapshot) {
+  return withPaymentDiagnostics(() => verifyIncomingPaymentInScope(body, opts, snapshot));
+}
+async function verifyIncomingPaymentInScope(body, opts, snapshot) {
   if (body.type !== "payment") return {};
   if (body.content.cashu_token) {
     if (opts.cashuMode === "p2pk-accumulator" && (opts.accumulatorDb || opts.disposableCashu) && opts.dvmId && opts.lockPubkeys && opts.lockPubkeys.length > 0) {
@@ -4771,15 +4855,15 @@ async function verifyIncomingPayment(body, opts, snapshot) {
           snapshot
         });
       }
-      const { verifyX402Payment } = await import("./x402-R6HPBY5D.js");
-      const receipt = await verifyX402Payment(
+      const { verifyX402Payment } = await import("./x402-ZU4GML7Z.js");
+      const receipt = await withPaymentStage("verifier_broadcast", () => verifyX402Payment(
         body.content.x402_payment,
         opts.x402Config,
         requiredUsdcMicro,
         opts.resourcePath ?? "/v1/job",
         rate,
         opts.x402ExactVersions
-      );
+      ));
       if (!receipt.verified) {
         return {
           error: {
@@ -4828,6 +4912,7 @@ async function verifyIncomingPayment(body, opts, snapshot) {
         } catch (err) {
           const mapped = mapLedgerCommitError(err, void 0, true);
           if (mapped?.error) {
+            logCredentialRejected("x402", "mid-job", err);
             return { error: { body: mapped.error.body, status: mapped.error.status } };
           }
           throw err;
@@ -4935,13 +5020,14 @@ async function verifyIncomingPayment(body, opts, snapshot) {
           challenge_id: credential.challenge.id,
           amount: expectedAmount
         },
-        () => mppServer.broadcastCredential(credential, {
+        () => withPaymentStage("verifier_broadcast", () => mppServer.broadcastCredential(credential, {
           request: { amount: expectedAmount },
           ...opts.hostingPaymentSeq !== void 0 && {
             hostedPaymentIntent: { jobId: opts.jobId, paymentSeq: opts.hostingPaymentSeq }
           },
           ...expectedMeta && { meta: expectedMeta }
-        })
+        })),
+        { onError: paymentFailureFields }
       );
       let credited;
       if (ledgerCtx) {
@@ -4950,6 +5036,7 @@ async function verifyIncomingPayment(body, opts, snapshot) {
         } catch (err) {
           const mapped = mapLedgerCommitError(err, void 0, true);
           if (mapped?.error) {
+            logCredentialRejected("tempo", "mid-job", err);
             return { error: { body: mapped.error.body, status: mapped.error.status } };
           }
           throw err;
@@ -5144,6 +5231,9 @@ function applyPaymentInfoToJob(job, info) {
   creditPendingPayment(job);
 }
 async function processIncomingPayment(job, body, opts) {
+  return withPaymentDiagnostics(() => processIncomingPaymentInScope(job, body, opts));
+}
+async function processIncomingPaymentInScope(job, body, opts) {
   if (body.type !== "payment") return null;
   if (body.content.cashu_token) {
     if (opts.cashuMode === "p2pk-accumulator" && (opts.accumulatorDb || opts.disposableCashu) && opts.dvmId && opts.lockPubkeys && opts.lockPubkeys.length > 0) {
@@ -5196,15 +5286,15 @@ async function processIncomingPayment(job, body, opts) {
     try {
       const requiredMsats = job.pendingPaymentMsats ?? 0;
       const requiredUsdcMicro = job.pendingX402AmountUsdcMicro !== void 0 ? BigInt(job.pendingX402AmountUsdcMicro) : BigInt(msatsToUsdc(requiredMsats, rate));
-      const { verifyX402Payment } = await import("./x402-R6HPBY5D.js");
-      const receipt = await verifyX402Payment(
+      const { verifyX402Payment } = await import("./x402-ZU4GML7Z.js");
+      const receipt = await withPaymentStage("verifier_broadcast", () => verifyX402Payment(
         body.content.x402_payment,
         opts.x402Config,
         requiredUsdcMicro,
         opts.resourcePath ?? "/v1/job",
         rate,
         opts.x402ExactVersions
-      );
+      ));
       if (receipt.verified) {
         if (job.pendingX402Nonce !== void 0) {
           const incomingNonce = decodePayment(body.content.x402_payment).payload.authorization.nonce;
@@ -5271,13 +5361,14 @@ async function processIncomingPayment(job, body, opts) {
           challenge_id: credential.challenge.id,
           amount: expectedAmount
         },
-        () => mppHandle.broadcastCredential(credential, {
+        () => withPaymentStage("verifier_broadcast", () => mppHandle.broadcastCredential(credential, {
           request: { amount: expectedAmount },
           ...opts.hostingPaymentSeq !== void 0 && {
             hostedPaymentIntent: { jobId: opts.jobId, paymentSeq: opts.hostingPaymentSeq }
           },
           ...expectedMeta && { meta: expectedMeta }
-        })
+        })),
+        { onError: paymentFailureFields }
       );
       if (!job.pendingMppChallengeIds?.includes(credential.challenge.id)) {
         return {
@@ -5645,8 +5736,7 @@ async function resolveTopUpLedgerContext(opts, snapshot, binding) {
   if (!denomination.ok) {
     logSkip("denomination_unavailable", {
       currency,
-      cause: denomination.reason,
-      ...denomination.detail !== void 0 && { detail: denomination.detail }
+      cause: denomination.reason
     });
     return void 0;
   }
@@ -5795,6 +5885,9 @@ function withDrawBasis(info, ctx, committed) {
   };
 }
 async function fundAndDraw(ctx, funding, tx) {
+  return withPaymentStage("funding_ledger", () => fundAndDrawInScope(ctx, funding, tx));
+}
+async function fundAndDrawInScope(ctx, funding, tx) {
   const env = ctx.creditEnvelope;
   const fundedMicro = funding.fundedMicro ?? fundedMicroFor(ctx.priceFiat, funding.paidMsats, ctx.requiredMsats);
   const shortMidJob = ctx.midJob === true && funding.paidMsats < ctx.requiredMsats;
@@ -6221,7 +6314,7 @@ async function commitMarkedFunding(ctx, funding, outerTx) {
     const env = ctx.creditEnvelope;
     const creditId = ctx.fundOnly?.creditId ?? ctx.topUp?.creditId ?? env?.creditId ?? implicitCreditId(funding.rail, funding.paymentId);
     const drawId = ctx.fundOnly?.fundId ?? ctx.topUp?.drawId ?? env?.drawId ?? funding.paymentId;
-    await store.record({
+    await withPaymentStage("replay_store", () => store.record({
       dvmId: ctx.dvmId,
       rail: funding.rail,
       paymentId: funding.paymentId,
@@ -6229,10 +6322,10 @@ async function commitMarkedFunding(ctx, funding, outerTx) {
       drawId,
       jobId: ctx.jobId,
       tx
-    });
+    }));
     return fundAndDraw(ctx, funding, tx);
   };
-  return outerTx ? commit(outerTx) : store.withTx(commit);
+  return outerTx ? commit(outerTx) : withPaymentStage("replay_store", () => store.withTx(commit));
 }
 async function commitMppFunding(ctx, credential, funding) {
   const session = mppSessionBasis(credential);
@@ -6594,15 +6687,14 @@ function x402NotOfferedResult(currency) {
     error: x402NotOfferedPaymentError(currency)
   };
 }
-function logCredentialRejected(rail, phase, _err) {
+function logCredentialRejected(rail, phase, err) {
   diagnosticConsole.warn(
     {
       level: "warn",
       event: `${rail}_credential_rejected`,
       phase,
       rail,
-      error_name: void 0,
-      error_message: void 0
+      ...paymentFailureFields(err)
     }
   );
 }
@@ -16526,7 +16618,7 @@ import {
   Amount as Amount3,
   CheckStateEnum as CheckStateEnum3,
   getP2PKExpectedWitnessPubkeys as getP2PKExpectedWitnessPubkeys2,
-  getTokenMetadata
+  getTokenMetadata as getTokenMetadata2
 } from "@cashu/cashu-ts";
 function installAdminCreditRoutes(app, opts) {
   app.get("/admin/credit/pending-drains", (c) => handlePendingDrains(c, opts));
@@ -16887,7 +16979,7 @@ async function handleParkDrain(c, opts) {
   }
   let parsed;
   try {
-    const meta = getTokenMetadata(token);
+    const meta = getTokenMetadata2(token);
     parsed = {
       mint: meta.mint,
       faceSats: Amount3.from(meta.amount).toNumber(),
@@ -19424,7 +19516,7 @@ async function createDVMServer(descriptor, opts) {
       }
     }
     if (!opts.onJobCompleted && platformToken && platformUrl && dvmId && opts.db) {
-      const { RevenueReporter } = await import("./revenue-reporter-MAERPYGK.js");
+      const { RevenueReporter } = await import("./revenue-reporter-7UR3W2SD.js");
       const reporter = new RevenueReporter(
         opts.db,
         platformUrl,
@@ -19434,7 +19526,7 @@ async function createDVMServer(descriptor, opts) {
       revenueReporter = reporter;
       await reporter.init();
       reporter.startRetryLoop();
-      const { MemoryX402BatchStore, PayoutReporter } = await import("./payout-reporter-3Y2U55ZX.js");
+      const { MemoryX402BatchStore, PayoutReporter } = await import("./payout-reporter-WT7XYW42.js");
       payoutReporter = new PayoutReporter({
         dvmId,
         db: opts.db,
@@ -22850,6 +22942,7 @@ export {
   derivedFundCreditId,
   drawSettlementRef,
   rateUnavailablePaymentError,
+  isTestMintUrl,
   X402_BATCH_SETTLEMENT_NETWORK,
   X402_BATCH_SETTLEMENT_MAINNET_NETWORK,
   X402_BATCH_MIN_WITHDRAW_DELAY_SECONDS,

package/dist/{chunk-QR2EF2NI.js → chunk-AQ7OX5NX.js}

@@ -1,6 +1,6 @@
 import {
   initCallerLoggers
-} from "./chunk-66HGCPBU.js";
+} from "./chunk-KXWROQGK.js";
 import {
   bindDiagnosticCapabilityAuthority,
   bindDiagnosticIdentityAuthority,
@@ -8,7 +8,7 @@ import {
   extendDiagnosticIdentityAuthority,
   projectDiagnosticFields,
   projectSpanRow
-} from "./chunk-ETXDTUJO.js";
+} from "./chunk-LAKP6FUI.js";
 
 // src/sdk/logger.ts
 function createConsoleLogger(_jobId) {

package/dist/{chunk-RLTSCKRI.js → chunk-BPYMEMQX.js}

@@ -1,6 +1,49 @@
-import {
-  DvmError
-} from "./chunk-LIRAHP7B.js";
+// src/lib/errors.ts
+var DvmError = class extends Error {
+  constructor(code, message, hint, data, display, proseSources) {
+    super(message);
+    this.code = code;
+    this.hint = hint;
+    this.data = data;
+    this.display = display;
+    this.proseSources = proseSources;
+    this.name = "DvmError";
+  }
+  code;
+  hint;
+  data;
+  display;
+  proseSources;
+};
+function providerProseSources(...sources) {
+  const provenance = {};
+  for (const source of sources) {
+    if (!source) continue;
+    for (const field of ["message", "hint", "display"]) {
+      if (typeof source[field] === "string") provenance[field] = "provider";
+    }
+  }
+  return Object.keys(provenance).length > 0 ? provenance : void 0;
+}
+function isAbortError(err) {
+  return err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError");
+}
+function transportErrorCode(err) {
+  let current = err;
+  const seen = /* @__PURE__ */ new Set();
+  for (let depth = 0; depth < 5 && isErrorLike(current) && !seen.has(current); depth++) {
+    seen.add(current);
+    const code = current.code;
+    if (typeof code === "string" && /^(?:E[A-Z0-9_]{1,63}|UND_ERR_[A-Z0-9_]{1,63})$/.test(code)) {
+      return code;
+    }
+    current = current.cause;
+  }
+  return void 0;
+}
+function isErrorLike(value) {
+  return (typeof value === "object" || typeof value === "function") && value !== null;
+}
 
 // src/lib/x402/networks.ts
 var X402_NETWORKS = [
@@ -99,6 +142,10 @@ var BY_CAIP2 = new Map(X402_NETWORKS.map((n) => [n.caip2, n]));
 var BY_SLUG = new Map(X402_NETWORKS.map((n) => [n.slug, n]));
 
 export {
+  DvmError,
+  providerProseSources,
+  isAbortError,
+  transportErrorCode,
   X402_NETWORKS,
   x402NetworkByCaip2,
   x402NetworkBySlug,