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

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-6HJEVCVI.js

@@ -0,0 +1,17 @@
+import {
+  validateCurrency
+} from "./chunk-HPCXF3DV.js";
+
+// src/sdk/pricing/upfront.ts
+function buildUpfront(input) {
+  const currency = validateCurrency(input.currency);
+  const amount = input.amount;
+  if (!Number.isFinite(amount) || amount < 0) {
+    throw new Error(`invalid upfront amount: ${String(amount)} (must be a non-negative number)`);
+  }
+  return { amount, currency };
+}
+
+export {
+  buildUpfront
+};

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
+};

package/dist/{chunk-IV6Q7NRW.js → chunk-C5RIQWG4.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-AFV77S4C.js";
 import {
   loggers
-} from "./chunk-QR2EF2NI.js";
+} from "./chunk-KCQDXIJU.js";
 import {
   redactUrl
 } from "./chunk-FUJ36YDV.js";

package/dist/{chunk-GAOAYHZA.js → chunk-FBQVOOYF.js}

@@ -1,12 +1,24 @@
+import {
+  diagnosticConsole
+} from "./chunk-ZCNPIILZ.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";
-import {
-  diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
 
 // src/sdk/server/payout-reporter.ts
 import { createHash, randomUUID } from "crypto";
+async function x402EarnedCeiling(channel, earnedNative) {
+  let earned;
+  try {
+    earned = await earnedNative(channel.channelId.toLowerCase());
+  } catch (error) {
+    return { kind: "unresolved", error };
+  }
+  if (earned === void 0) return { kind: "unbound" };
+  const charged = BigInt(channel.chargedCumulativeAmount);
+  const wanted = BigInt(earned);
+  return { kind: "ceiling", ceiling: wanted < charged ? wanted : charged };
+}
 var MemoryX402BatchStore = class {
   batches = /* @__PURE__ */ new Map();
   get(scope) {
@@ -719,7 +731,8 @@ var PayoutReporter = class {
   }
   /**
    * x402: the open batch (claimed, not yet transferred) plus every channel's
-   * unclaimed voucher value; wedged when the settle keeps failing, and the
+   * earned value not yet claimed — a channel whose earned figure cannot be
+   * read contributes nothing; wedged when the settle keeps failing, and the
    * refund settlements stuck between chain and ledger beside it.
    */
   async snapshotX402() {
@@ -751,12 +764,29 @@ var PayoutReporter = class {
       }
       const unclaimed = [];
       for (const channel of await ctx.storage.list()) {
-        const owed = BigInt(channel.chargedCumulativeAmount) - BigInt(channel.totalClaimed);
+        const claimed = BigInt(channel.totalClaimed);
+        if (BigInt(channel.chargedCumulativeAmount) <= claimed) continue;
+        let resolved;
+        try {
+          resolved = await x402EarnedCeiling(channel, ctx.earnedNative);
+        } catch (err) {
+          resolved = { kind: "unresolved", error: err };
+        }
+        if (resolved.kind === "unresolved") {
+          warn("payout_pending_snapshot_failed", {
+            rail: "x402",
+            "channel.id": channel.channelId,
+            error: message(resolved.error)
+          });
+          continue;
+        }
+        if (resolved.kind === "unbound") continue;
+        const owed = resolved.ceiling - claimed;
         if (owed > 0n) {
           unclaimed.push({
             id: channel.channelId,
             native: Number(owed),
-            label: "unclaimed vouchers"
+            label: "earned, awaiting claim"
           });
         }
       }
@@ -902,6 +932,7 @@ function warn(level, fields) {
 }
 
 export {
+  x402EarnedCeiling,
   MemoryX402BatchStore,
   PostgresX402BatchStore,
   PAYOUT_SNAPSHOT_INTERVAL_MS,

package/dist/{chunk-Z4ZT5LNT.js → chunk-GEI4MAXE.js}

@@ -1,9 +1,9 @@
+import {
+  diagnosticConsole
+} from "./chunk-ZCNPIILZ.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";
-import {
-  diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
 
 // src/sdk/server/revenue-reporter.ts
 import { randomUUID } from "crypto";

package/dist/{chunk-OML32F6I.js → chunk-GLIAR7RN.js}

@@ -15,7 +15,7 @@ import {
   lotOwedSats,
   netOwedSats,
   x402SettlementPending
-} from "./chunk-6XF3RVVX.js";
+} from "./chunk-IRXIH775.js";
 
 // src/sdk/server/memory-credit-ledger.ts
 import { randomUUID } from "crypto";

package/dist/{chunk-X7EZ5CLI.js → chunk-HCATFJDD.js}

@@ -2,12 +2,12 @@ import {
   parseStoreValue,
   stringifyStoreValue
 } from "./chunk-YG7G4DPZ.js";
+import {
+  withPostgresTransactionRecovery
+} from "./chunk-NV7Z7377.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";
-import {
-  withPostgresTransactionRecovery
-} from "./chunk-P6QON7ER.js";
 
 // src/sdk/server/tempo-session-store.ts
 import { AsyncLocalStorage } from "async_hooks";

package/dist/{chunk-BYCEKO65.js → chunk-HPCXF3DV.js}

@@ -1,6 +1,6 @@
 import {
   diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
+} from "./chunk-ZCNPIILZ.js";
 
 // src/sdk/pricing/currency.ts
 var InvalidCurrencyError = class extends Error {
@@ -35,6 +35,98 @@ function validateCurrency(raw) {
   return raw;
 }
 
+// src/sdk/pricing/usd.ts
+var InvalidFxRateError = class extends Error {
+  code = "invalid_fx_rate";
+  ratePerBtc;
+  constructor(ratePerBtc) {
+    super(
+      `invalid fx rate ${String(ratePerBtc)} \u2014 expected a finite positive number of fiat per BTC`
+    );
+    this.ratePerBtc = ratePerBtc;
+  }
+};
+function fiatToSatsCeil(amount, ratePerBtc) {
+  if (!Number.isFinite(ratePerBtc) || ratePerBtc <= 0) {
+    throw new InvalidFxRateError(ratePerBtc);
+  }
+  if (!Number.isFinite(amount) || amount < 0) return 0;
+  return Math.ceil(amount * 1e8 / ratePerBtc);
+}
+function satsToFiat(sats, ratePerBtc) {
+  if (!Number.isFinite(ratePerBtc) || ratePerBtc <= 0) {
+    throw new InvalidFxRateError(ratePerBtc);
+  }
+  return sats / 1e8 * ratePerBtc;
+}
+var InvalidUsdPriceError = class extends Error {
+  constructor(field, value, detail) {
+    super(`${field}: ${detail}`);
+    this.field = field;
+    this.value = value;
+    this.name = "InvalidUsdPriceError";
+  }
+  field;
+  value;
+  code = "invalid_usd_price";
+};
+function parseUsdPrice(value, field) {
+  if (!USD_PRICE_RE.test(value)) {
+    throw new InvalidUsdPriceError(
+      field,
+      value,
+      `${JSON.stringify(value)} is not a USD price literal. Use a "$X.XX" string, e.g. "$0.05".`
+    );
+  }
+  const usd = parseFloat(value.slice(1));
+  if (!Number.isFinite(usd) || usd < MIN_USD_PRICE) {
+    throw new InvalidUsdPriceError(
+      field,
+      value,
+      `${JSON.stringify(value)} is below ${MIN_USD_PRICE_LITERAL}, the smallest price the wire can carry \u2014 every price surface rounds to four decimals, so this would advertise as $0 and then charge anyway. Charge at least ${MIN_USD_PRICE_LITERAL}, or omit the price for a free capability.`
+    );
+  }
+  if (roundUsd(usd) !== usd) {
+    throw new InvalidUsdPriceError(
+      field,
+      value,
+      `${JSON.stringify(value)} carries more than four decimal places. Every price surface rounds to four, so this would advertise ${formatUsd(roundUsd(usd))} and charge something else. Use at most four decimals.`
+    );
+  }
+  if (!Number.isSafeInteger(Math.round(usd * 1e6))) {
+    throw new InvalidUsdPriceError(
+      field,
+      value,
+      `${JSON.stringify(value)} is too large to denominate. Use an amount under $9,007,199,254.`
+    );
+  }
+  return usd;
+}
+function roundUsd(usd) {
+  return Math.round(usd * 1e4) / 1e4;
+}
+function formatUsd(usd) {
+  if (usd === 0) return "$0.00";
+  if (usd >= 0.01) return `$${usd.toFixed(2)}`;
+  return `$${usd.toFixed(4)}`;
+}
+function formatFiat(amount, currency) {
+  const code = currency.toUpperCase();
+  const symbol = FIAT_SYMBOLS[currency] ?? "";
+  const digits = currency === "jpy" ? 0 : amount >= 0.01 || amount === 0 ? 2 : 4;
+  const body = `${amount.toFixed(digits)} ${code}`;
+  return symbol ? `${symbol}${body}` : body;
+}
+var USD_PRICE_RE = /^\$\d+(\.\d+)?$/;
+var MIN_USD_PRICE = 1e-4;
+var MIN_USD_PRICE_LITERAL = '"$0.0001"';
+var FIAT_SYMBOLS = {
+  usd: "$",
+  eur: "\u20AC",
+  gbp: "\xA3",
+  jpy: "\xA5"
+};
+
 // src/sdk/pricing/fx.ts
 var DEFAULT_FX_CURRENCIES = ["usd", "eur", "gbp", "jpy"];
 var DEFAULT_FX_RATE_SOURCE = `https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=${DEFAULT_FX_CURRENCIES.join(",")}`;
@@ -52,14 +144,53 @@ var FxRateUnavailableError = class extends Error {
    * the last-known rate without it. See {@link FxKnownStale}.
    */
   knownStale;
-  constructor(message, copy, knownStale) {
+  sourceFailure;
+  constructor(message, copy, knownStale, sourceFailure) {
     super(message);
     this.name = "FxRateUnavailableError";
     this.display = copy?.display ?? "Couldn't fetch the BTC reference rate to lock pricing";
     this.hint = copy?.hint ?? "transient \u2014 try the quote again in a few seconds";
     this.knownStale = knownStale;
+    this.sourceFailure = normalizeFxSourceFailure(sourceFailure);
   }
 };
+var FX_SOURCE_FAILURE_CATEGORIES = /* @__PURE__ */ new Set([
+  "network_error",
+  "http_error",
+  "invalid_body",
+  "no_usable_rate",
+  "missing_currency",
+  "unknown"
+]);
+function normalizeFxSourceFailure(input) {
+  if (input === void 0) return void 0;
+  try {
+    if (typeof input !== "object" || input === null) return { category: "unknown" };
+    const categoryDescriptor = Object.getOwnPropertyDescriptor(input, "category");
+    const category = categoryDescriptor && "value" in categoryDescriptor ? categoryDescriptor.value : void 0;
+    if (typeof category !== "string" || !FX_SOURCE_FAILURE_CATEGORIES.has(category)) {
+      return { category: "unknown" };
+    }
+    const statusDescriptor = Object.getOwnPropertyDescriptor(input, "httpStatus");
+    const status = statusDescriptor && "value" in statusDescriptor ? statusDescriptor.value : void 0;
+    return {
+      category,
+      ...category === "http_error" && typeof status === "number" && Number.isInteger(status) && status >= 100 && status <= 599 && { httpStatus: status }
+    };
+  } catch {
+    return { category: "unknown" };
+  }
+}
+function readFxSourceFailure(error) {
+  try {
+    const descriptor = Object.getOwnPropertyDescriptor(error, "sourceFailure");
+    if (!descriptor) return void 0;
+    if (!("value" in descriptor)) return { category: "unknown" };
+    return normalizeFxSourceFailure(descriptor.value);
+  } catch {
+    return { category: "unknown" };
+  }
+}
 function createFxFetcher(opts) {
   const currencies = opts?.currencies ?? DEFAULT_FX_CURRENCIES;
   const source = opts?.source ?? DEFAULT_FX_RATE_SOURCE;
@@ -100,7 +231,10 @@ function createFxFetcher(opts) {
           }
         }
         throw new FxRateUnavailableError(
-          lastErr instanceof Error ? lastErr.message : String(lastErr)
+          lastErr instanceof Error ? lastErr.message : String(lastErr),
+          void 0,
+          void 0,
+          lastErr instanceof FxRateUnavailableError ? readFxSourceFailure(lastErr) : { category: "unknown" }
         );
       })();
       inFlight = promise;
@@ -127,7 +261,9 @@ function fxRateFor(snapshot, currency) {
         {
           display: `The ${currency.toUpperCase()} reference rate is unavailable right now.`,
           hint: `The rate source stopped carrying ${currency.toUpperCase()}. Retry in a minute; if it persists the source needs to be reconfigured.`
-        }
+        },
+        void 0,
+        { category: "missing_currency" }
       );
     }
     throw new UnsupportedCurrencyError(currency, Object.keys(snapshot.rates));
@@ -139,19 +275,32 @@ async function fetchOnce(source, currencies, fetchFn) {
   return fetchPlatformShape(source, currencies, fetchFn);
 }
 async function fetchCoinGeckoShape(source, currencies, fetchFn) {
-  const res = await fetchFn(source);
+  const res = await fetchSource(fetchFn, source);
   if (!res.ok) {
-    throw new Error(`fx source ${source} returned ${res.status.toString()}`);
+    throw new FxRateUnavailableError(
+      `fx source ${source} returned ${res.status.toString()}`,
+      void 0,
+      void 0,
+      { category: "http_error", httpStatus: res.status }
+    );
   }
-  const body = await res.json();
-  const bitcoin = body.bitcoin;
-  if (!bitcoin || typeof bitcoin !== "object") {
-    throw new Error(`fx source ${source} returned an unparsable rate body`);
+  const body = await parseRateBody(res);
+  const bitcoin = body?.bitcoin;
+  if (!bitcoin || typeof bitcoin !== "object" || Array.isArray(bitcoin)) {
+    throw new FxRateUnavailableError(
+      `fx source ${source} returned an unparsable rate body`,
+      void 0,
+      void 0,
+      { category: "invalid_body" }
+    );
   }
-  return { rates: collectRates(source, bitcoin, currencies), as_of: (/* @__PURE__ */ new Date()).toISOString() };
+  return {
+    rates: collectRates(source, bitcoin, currencies),
+    as_of: (/* @__PURE__ */ new Date()).toISOString()
+  };
 }
 async function fetchPlatformShape(source, currencies, fetchFn) {
-  const res = await fetchFn(source.url, {
+  const res = await fetchSource(fetchFn, source.url, {
     headers: { Authorization: `Bearer ${source.token}`, Accept: "application/json" }
   });
   if (!res.ok) {
@@ -160,20 +309,57 @@ async function fetchPlatformShape(source, currencies, fetchFn) {
       throw new FxRateUnavailableError(
         `fx source ${source.url} refused: rate ${knownStale.staleDays.toString()}d stale` + (knownStale.thresholdDays !== void 0 ? ` (threshold ${knownStale.thresholdDays.toString()}d)` : ""),
         void 0,
-        knownStale
+        knownStale,
+        { category: "http_error", httpStatus: res.status }
       );
     }
-    throw new Error(`fx source ${source.url} returned ${res.status.toString()}`);
+    throw new FxRateUnavailableError(
+      `fx source ${source.url} returned ${res.status.toString()}`,
+      void 0,
+      void 0,
+      { category: "http_error", httpStatus: res.status }
+    );
   }
-  const body = await res.json();
-  const raw = body.rates;
-  if (!raw || typeof raw !== "object") {
-    throw new Error(`fx source ${source.url} returned an unparsable rate body`);
+  const body = await parseRateBody(res);
+  const raw = body?.rates;
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    throw new FxRateUnavailableError(
+      `fx source ${source.url} returned an unparsable rate body`,
+      void 0,
+      void 0,
+      { category: "invalid_body" }
+    );
   }
   const rates = collectRates(source.url, raw, currencies);
   const as_of = typeof body.as_of === "string" ? body.as_of : (/* @__PURE__ */ new Date()).toISOString();
   return { rates, as_of };
 }
+async function fetchSource(fetchFn, url, init) {
+  try {
+    return await fetchFn(url, init);
+  } catch (err) {
+    if (err instanceof FxRateUnavailableError) throw err;
+    throw new FxRateUnavailableError(
+      err instanceof Error ? err.message : String(err),
+      void 0,
+      void 0,
+      { category: "network_error" }
+    );
+  }
+}
+async function parseRateBody(res) {
+  try {
+    const body = await res.json();
+    return typeof body === "object" && body !== null && !Array.isArray(body) ? body : null;
+  } catch {
+    throw new FxRateUnavailableError(
+      "fx source returned an unparsable rate body",
+      void 0,
+      void 0,
+      { category: "invalid_body" }
+    );
+  }
+}
 function collectRates(source, raw, currencies) {
   const rates = {};
   for (const currency of currencies) {
@@ -182,8 +368,11 @@ function collectRates(source, raw, currencies) {
     rates[currency] = value;
   }
   if (Object.keys(rates).length === 0) {
-    throw new Error(
-      `fx source ${source} returned no usable rate for any of [${currencies.join(", ")}]`
+    throw new FxRateUnavailableError(
+      `fx source ${source} returned no usable rate for any of [${currencies.join(", ")}]`,
+      void 0,
+      void 0,
+      { category: "no_usable_rate" }
     );
   }
   return rates;
@@ -240,6 +429,7 @@ async function parsePlatformStaleRefusal(res) {
   } catch {
     return null;
   }
+  if (typeof body !== "object" || body === null) return null;
   const error = body.error;
   if (!error || typeof error !== "object") return null;
   const { code, detail } = error;
@@ -268,28 +458,26 @@ function resolveFxSourceFromEnv(env) {
   return raw;
 }
 
-// src/sdk/pricing/upfront.ts
-function buildUpfront(input) {
-  const currency = validateCurrency(input.currency);
-  const amount = input.amount;
-  if (!Number.isFinite(amount) || amount < 0) {
-    throw new Error(`invalid upfront amount: ${String(amount)} (must be a non-negative number)`);
-  }
-  return { amount, currency };
-}
-
 export {
   InvalidCurrencyError,
   UnsupportedCurrencyError,
   validateCurrency,
+  InvalidFxRateError,
+  fiatToSatsCeil,
+  satsToFiat,
+  InvalidUsdPriceError,
+  parseUsdPrice,
+  roundUsd,
+  formatUsd,
+  formatFiat,
   DEFAULT_FX_CURRENCIES,
   DEFAULT_FX_RATE_SOURCE,
   FX_CACHE_TTL_MS,
   FX_RETRY_COUNT,
   FxRateUnavailableError,
+  readFxSourceFailure,
   createFxFetcher,
   warmFxSnapshot,
   fxRateFor,
-  resolveFxSourceFromEnv,
-  buildUpfront
+  resolveFxSourceFromEnv
 };