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

package/README.md

@@ -98,6 +98,8 @@ The public [SDK guide](https://dvmkit.com/docs/sdk) covers signed requests, cust
 
 ## Diagnostic retention
 
+[Payment diagnostics](./docs/DIAGNOSTICS.md) documents the closed failure categories, stages, and top-up causes retained by safe logging sinks.
+
 The SDK advertises 730 days of retention for sanitized diagnostics in every existing span dataset: `platform`, `cashu`, `lightning`, `stripe`, `x402`, `tempo`, `isolate`, `audit`, and `cron`. Dataset names, producer permissions, and query semantics remain unchanged; only operator services may write to `audit`.
 
 This metadata describes the retention schedule. The SDK does not automatically delete diagnostics or override platform destruction or case controls. The platform must enforce the schedule and those controls.

package/dist/{chunk-S3OY533W.js → chunk-26W6GPCD.js}

@@ -1,9 +1,34 @@
 import {
   X402_DEFAULT_FACILITATOR
-} from "./chunk-CXCQLOOK.js";
+} from "./chunk-62FI3NJF.js";
 import {
   callerLoggers
-} from "./chunk-66HGCPBU.js";
+} from "./chunk-KXWROQGK.js";
+import {
+  diagnosticConsole
+} from "./chunk-LAKP6FUI.js";
+
+// src/observability/payment-diagnostics.ts
+import { AsyncLocalStorage } from "async_hooks";
+var scopes = new AsyncLocalStorage();
+function withPaymentDiagnostics(fn) {
+  return scopes.run({}, fn);
+}
+async function withPaymentStage(stage, fn) {
+  try {
+    return await fn();
+  } catch (error) {
+    const scope = scopes.getStore();
+    if (scope && (!scope.failure || !Object.is(scope.failure.error, error))) {
+      scope.failure = { error, stage };
+    }
+    throw error;
+  }
+}
+function paymentFailureStage(error) {
+  const failure = scopes.getStore()?.failure;
+  return failure && Object.is(failure.error, error) ? failure.stage : "unknown";
+}
 
 // src/lib/x402/facilitator.ts
 import { createPrivateKey, randomBytes } from "crypto";
@@ -82,7 +107,7 @@ async function verifyWithFacilitator(payload, requirements, config = {}, createA
   return callerLoggers.x402.span(
     "x402.verify_with_facilitator",
     { facilitator_url: url },
-    async () => {
+    () => withPaymentStage("verifier", async () => {
       const authHeaders = (await createAuthHeaders?.())?.verify ?? {};
       const res = await fetch(url, {
         method: "POST",
@@ -96,14 +121,17 @@ async function verifyWithFacilitator(payload, requirements, config = {}, createA
       if (!res.ok) {
         const rejection = await readFacilitatorRejection(res);
         if (rejection?.isValid === false && typeof rejection.invalidReason === "string" && rejection.invalidReason.length > 0) {
+          logRejected("verifier");
           return rejection;
         }
+        logRejected("verifier");
         return { isValid: false, invalidReason: `facilitator_status_${res.status}` };
       }
       const data = await res.json();
+      if (!data.isValid) logRejected("verifier");
       callerLoggers.x402.info("x402.verify_with_facilitator.result", { is_valid: data.isValid });
       return data;
-    }
+    })
   );
 }
 async function settleWithFacilitator(payload, requirements, config = {}, createAuthHeaders = createX402FacilitatorAuthHeaders(config)) {
@@ -112,7 +140,7 @@ async function settleWithFacilitator(payload, requirements, config = {}, createA
   return callerLoggers.x402.span(
     "x402.settle_with_facilitator",
     { facilitator_url: url },
-    async () => {
+    () => withPaymentStage("broadcast", async () => {
       const authHeaders = (await createAuthHeaders?.())?.settle ?? {};
       const res = await fetch(url, {
         method: "POST",
@@ -126,17 +154,20 @@ async function settleWithFacilitator(payload, requirements, config = {}, createA
       if (!res.ok) {
         const rejection = await readFacilitatorRejection(res);
         if (rejection?.success === false && typeof rejection.errorReason === "string" && rejection.errorReason.length > 0) {
+          logRejected("broadcast");
           return rejection;
         }
+        logRejected("broadcast");
         return { success: false, errorReason: `facilitator_status_${res.status}` };
       }
       const data = await res.json();
+      if (!data.success) logRejected("broadcast");
       callerLoggers.x402.info("x402.settle_with_facilitator.result", {
         success: data.success,
         tx_hash: data.transaction
       });
       return data;
-    }
+    })
   );
 }
 async function readFacilitatorRejection(res) {
@@ -151,8 +182,19 @@ async function readFacilitatorRejection(res) {
 function isRecord(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
+function logRejected(stage) {
+  diagnosticConsole.warn({
+    event: "x402_credential_rejected",
+    rail: "x402",
+    failure_category: stage === "verifier" ? "verification_failed" : "settlement_failed",
+    failure_stage: stage
+  });
+}
 
 export {
+  withPaymentDiagnostics,
+  withPaymentStage,
+  paymentFailureStage,
   createX402FacilitatorAuthHeaders,
   createX402FacilitatorClient,
   verifyWithFacilitator,

package/dist/{chunk-FWGWLPXF.js → chunk-2OM2QPBE.js}

@@ -1,10 +1,10 @@
 import {
   callerLoggers
-} from "./chunk-66HGCPBU.js";
+} from "./chunk-KXWROQGK.js";
 import {
   diagnosticConsole,
   projectSpanRow
-} from "./chunk-ETXDTUJO.js";
+} from "./chunk-LAKP6FUI.js";
 
 // src/lib/x402/env.ts
 import { isAddress } from "viem";

package/dist/{chunk-CXCQLOOK.js → chunk-62FI3NJF.js}

@@ -204,90 +204,45 @@ function isOptionalRecord(value) {
   return value === void 0 || value === null || isRecord(value);
 }
 
-// src/defaults.ts
-import { homedir } from "os";
-import { join } from "path";
-var CONFIG_DIR = process.env.DVM_CONFIG_DIR ?? join(homedir(), ".dvm");
-var CONFIG_FILE = join(CONFIG_DIR, "config.json");
-var CONFIG_BACKUP_FILE = join(CONFIG_DIR, "config.json.bak");
-var CONFIG_AUDIT_FILE = join(CONFIG_DIR, "config-audit.jsonl");
-var CONFIG_PINNED_FILE = join(CONFIG_DIR, "config.json.pinned");
-var JOBS_FILE = join(CONFIG_DIR, "jobs.json");
-var REQUEST_INTENTS_DIR = join(CONFIG_DIR, "request-intents");
-var FAVORITES_FILE = join(CONFIG_DIR, "favorites.json");
-var MESSAGES_DIR = join(CONFIG_DIR, "messages");
-var RECEIPTS_FILE = join(CONFIG_DIR, "receipts.jsonl");
-var CREDITS_FILE = join(CONFIG_DIR, "credits.json");
-var X402_CHANNELS_FILE = join(CONFIG_DIR, "x402-channels.json");
-var TEMPO_CHANNELS_FILE = join(CONFIG_DIR, "tempo-channels.json");
-var FEEDBACK_NUDGES_FILE = join(CONFIG_DIR, "feedback-nudges.json");
-var RECOVERY_MNEMONIC_FILE = join(CONFIG_DIR, "recovery.mnemonic");
-var WALLET_FILE = join(CONFIG_DIR, "wallet.json");
-var AGENT_MNEMONIC_FILE = join(CONFIG_DIR, "wallet.mnemonic");
-var IDENTITIES_FILE = join(CONFIG_DIR, "identities.json");
-var PAIRINGS_DIR = join(CONFIG_DIR, "pairings");
-var BUDGET_FILE = join(CONFIG_DIR, "budget.json");
-var BTC_RATE_FILE = join(CONFIG_DIR, "btc-rate.json");
-var ADMIN_DIR = join(CONFIG_DIR, "admin");
-var PROXY_STATE_FILE = join(ADMIN_DIR, "proxy.json");
-var BUILDER_CONFIG_DIR = process.env.DVMKIT_CONFIG_DIR ?? join(homedir(), ".dvmkit");
-var BUILDER_FILE = join(BUILDER_CONFIG_DIR, "builder.json");
-var BUILDER_MNEMONIC_FILE = join(BUILDER_CONFIG_DIR, "recovery.mnemonic");
-var BUILDER_KEY_FILE = join(BUILDER_CONFIG_DIR, "builder.key");
-var MELT_PENDING_LOG_FILE = join(BUILDER_CONFIG_DIR, "melt-pending.log");
-var DRAIN_PARK_LOG_FILE = join(BUILDER_CONFIG_DIR, "drain-park.log");
-var DRAIN_HOLD_STATE_FILE = join(BUILDER_CONFIG_DIR, "drain-hold.json");
-var MELT_SUCCESS_FILE = join(BUILDER_CONFIG_DIR, "melt-success.json");
-
-// src/lib/config-dir.ts
-import { chmodSync, mkdirSync, statSync } from "fs";
-var CONFIG_DIR_MODE = 448;
-function ensureConfigDir() {
-  ensureConfigSubdir(CONFIG_DIR);
-}
-function ensureConfigSubdir(path) {
-  mkdirSync(path, { recursive: true, mode: CONFIG_DIR_MODE });
-}
-function repairConfigDirMode() {
-  const base = {
-    path: CONFIG_DIR,
-    exists: false,
-    modeOctal: null,
-    repaired: false,
-    skippedNonPosix: process.platform === "win32"
-  };
-  if (base.skippedNonPosix) return base;
-  let mode;
-  try {
-    mode = statSync(CONFIG_DIR).mode & 511;
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    const missing = err.code === "ENOENT";
-    return missing ? base : { ...base, error: message };
+// src/lib/payment-amounts.ts
+function msatsToUsd(msats, rate) {
+  return msats / 1e11 * rate;
+}
+function usdToMsats(usd, rate) {
+  return Math.round(usd / rate * 1e11);
+}
+function msatsToUsdCents(msats, btcPriceUsd) {
+  const usd = msatsToUsd(msats, btcPriceUsd);
+  return Math.round(usd * 100);
+}
+function msatsToUsdc(msats, btcUsdRate) {
+  if (!Number.isSafeInteger(msats) || msats < 0) {
+    throw new RangeError("msats must be a non-negative safe integer");
   }
-  if ((mode & 63) === 0) {
-    return { ...base, exists: true, modeOctal: toOctal(mode) };
+  if (!Number.isFinite(btcUsdRate) || btcUsdRate <= 0) {
+    throw new RangeError("BTC/USD rate must be finite and positive");
   }
-  try {
-    chmodSync(CONFIG_DIR, CONFIG_DIR_MODE);
-  } catch (err) {
-    return {
-      ...base,
-      exists: true,
-      modeOctal: toOctal(mode),
-      error: err instanceof Error ? err.message : String(err)
-    };
+  const [mantissa, exponent = "0"] = btcUsdRate.toString().split("e");
+  const decimalPlaces = mantissa.split(".")[1]?.length ?? 0;
+  const shift = Number(exponent) - decimalPlaces;
+  let numerator = BigInt(msats) * BigInt(mantissa.replace(".", ""));
+  let denominator = 100000n;
+  if (shift > 0) numerator *= 10n ** BigInt(shift);
+  else if (shift < 0) denominator *= 10n ** BigInt(-shift);
+  const micro = (numerator + denominator - 1n) / denominator;
+  if (micro > BigInt(Number.MAX_SAFE_INTEGER)) {
+    throw new RangeError("USDC micro-unit amount exceeds the safe integer range");
   }
-  return {
-    ...base,
-    exists: true,
-    modeOctal: toOctal(CONFIG_DIR_MODE),
-    previousModeOctal: toOctal(mode),
-    repaired: true
-  };
+  return Number(micro);
+}
+function usdcToMsats(usdc, btcUsdRate) {
+  return usdToMsats(usdc, btcUsdRate);
+}
+function msatsToMicro(msats, btcRate) {
+  return Math.round(msatsToUsd(msats, btcRate) * 1e6);
 }
-function toOctal(mode) {
-  return "0" + mode.toString(8).padStart(3, "0");
+function microToSats(micro, btcRate) {
+  return Math.ceil(usdToMsats(micro / 1e6, btcRate) / 1e3);
 }
 
 // src/lib/payment-rails/rpc.ts
@@ -339,33 +294,13 @@ export {
   decodePaymentRequiredHeader,
   exactEvmAuthorization,
   encodeSettleResponseHeader,
-  CONFIG_DIR,
-  CONFIG_FILE,
-  CONFIG_BACKUP_FILE,
-  CONFIG_AUDIT_FILE,
-  CONFIG_PINNED_FILE,
-  JOBS_FILE,
-  REQUEST_INTENTS_DIR,
-  FAVORITES_FILE,
-  MESSAGES_DIR,
-  RECEIPTS_FILE,
-  CREDITS_FILE,
-  X402_CHANNELS_FILE,
-  TEMPO_CHANNELS_FILE,
-  FEEDBACK_NUDGES_FILE,
-  RECOVERY_MNEMONIC_FILE,
-  WALLET_FILE,
-  AGENT_MNEMONIC_FILE,
-  IDENTITIES_FILE,
-  PAIRINGS_DIR,
-  BUDGET_FILE,
-  BTC_RATE_FILE,
-  BUILDER_CONFIG_DIR,
-  BUILDER_FILE,
-  BUILDER_KEY_FILE,
-  ensureConfigDir,
-  ensureConfigSubdir,
-  repairConfigDirMode,
+  msatsToUsd,
+  usdToMsats,
+  msatsToUsdCents,
+  msatsToUsdc,
+  usdcToMsats,
+  msatsToMicro,
+  microToSats,
   resolveRpcOverride,
   resolveRpcHttpTransportOptions
 };

package/dist/{chunk-VHNPVGSA.js → chunk-6STC5TCP.js}

@@ -1,9 +1,9 @@
+import {
+  diagnosticConsole
+} from "./chunk-LAKP6FUI.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";
-import {
-  diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
 
 // src/sdk/server/postgres-replay-store.ts
 var DEFAULT_TABLE_NAME = "signed_request_replays";

package/dist/{chunk-N5RZ5HVB.js → chunk-72V5DTEC.js}

@@ -4,10 +4,10 @@ import {
   signedRequestHeaderMatchesDomain,
   signedRequestStatementHeader,
   testOnlySignedRequestDomain
-} from "./chunk-RCM3P2HE.js";
+} from "./chunk-UKD3R2KU.js";
 import {
   diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
+} from "./chunk-LAKP6FUI.js";
 
 // src/sdk/server/zod-error.ts
 function humanizeZodError(err, opts) {

package/dist/chunk-A262WVYX.js

@@ -0,0 +1,6 @@
+// src/lib/wire-schema.ts
+var CAPABILITY_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;
+
+export {
+  CAPABILITY_NAME_RE
+};