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

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

@@ -1,6 +1,6 @@
 import {
   diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
+} from "./chunk-LAKP6FUI.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(",")}`;
@@ -268,20 +360,18 @@ 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,
@@ -290,6 +380,5 @@ export {
   createFxFetcher,
   warmFxSnapshot,
   fxRateFor,
-  resolveFxSourceFromEnv,
-  buildUpfront
+  resolveFxSourceFromEnv
 };

package/dist/{chunk-GAOAYHZA.js → chunk-DNG4KGSC.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/payout-reporter.ts
 import { createHash, randomUUID } from "crypto";

package/dist/{chunk-Z4ZT5LNT.js → chunk-GSLS4464.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/revenue-reporter.ts
 import { randomUUID } from "crypto";

package/dist/{chunk-7ZUKL4IV.js → chunk-H5FVVEEN.js}

@@ -2,19 +2,20 @@ import {
   createX402FacilitatorAuthHeaders,
   settleWithFacilitator,
   verifyWithFacilitator
-} from "./chunk-PLG4XER6.js";
+} from "./chunk-26W6GPCD.js";
 import {
   buildPaymentRequirements,
   decodePayment,
   encodeSettleResponseHeader,
-  exactEvmAuthorization
-} from "./chunk-IWQHUSMO.js";
-import {
+  exactEvmAuthorization,
   usdcToMsats
-} from "./chunk-PAIM66YA.js";
+} from "./chunk-62FI3NJF.js";
 import {
   callerLoggers
-} from "./chunk-66HGCPBU.js";
+} from "./chunk-KXWROQGK.js";
+import {
+  diagnosticConsole
+} from "./chunk-LAKP6FUI.js";
 
 // src/lib/x402/verify.ts
 async function verifyX402Payment(paymentHeader, config, requiredUsdcMicro, resource, btcUsdRate, exactVersions = { v1: true, v2: true }) {
@@ -30,9 +31,11 @@ async function verifyX402Payment(paymentHeader, config, requiredUsdcMicro, resou
       try {
         payload = decodePayment(paymentHeader);
       } catch {
+        logRejected("malformed_credential", "verifier");
         return { verified: false, amountMsats: 0, invalidReason: "decode_failed" };
       }
       if (payload.x402Version === 1 && !exactVersions.v1 || payload.x402Version === 2 && !exactVersions.v2) {
+        logRejected("unsupported_version", "verifier");
         return { verified: false, amountMsats: 0, invalidReason: "unsupported_version" };
       }
       const requirementOpts = { x402Config: config, requiredUsdcMicro, resource };
@@ -81,6 +84,14 @@ async function verifyX402Payment(paymentHeader, config, requiredUsdcMicro, resou
     }
   );
 }
+function logRejected(category, stage) {
+  diagnosticConsole.warn({
+    event: "x402_credential_rejected",
+    rail: "x402",
+    failure_category: category,
+    failure_stage: stage
+  });
+}
 
 export {
   verifyX402Payment

package/dist/{chunk-IXR5RFK7.js → chunk-HCE4MPZ5.js}

@@ -1,6 +1,6 @@
 import {
   diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
+} from "./chunk-LAKP6FUI.js";
 
 // src/sdk/server/mpp-setup.ts
 import { createHash, randomUUID } from "crypto";

package/dist/{chunk-FYRR2UEZ.js → chunk-I555L2WK.js}

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

package/dist/{chunk-EQLA4FFY.js → chunk-IIZQNDQU.js}

@@ -2,12 +2,12 @@ import {
   ContentHoldError,
   applyContentHoldMutation
 } from "./chunk-AFV77S4C.js";
+import {
+  diagnosticConsole
+} from "./chunk-LAKP6FUI.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";
-import {
-  diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
 
 // src/sdk/server/postgres-job-store.ts
 import { createHash } from "crypto";

package/dist/{chunk-FUJ36YDV.js → chunk-KXWROQGK.js}

@@ -45,7 +45,30 @@ function isOpaqueToken(segment) {
   return false;
 }
 
+// src/lib/caller-loggers.ts
+var callerLoggers = buildNoopLoggers();
+function initCallerLoggers(nextLoggers) {
+  callerLoggers = nextLoggers;
+}
+function buildNoopLoggers() {
+  const noopLogger = {
+    // eslint-disable-next-line @typescript-eslint/no-empty-function -- standalone caller has no exporter
+    info() {
+    },
+    async span(_name, _attrs, fn) {
+      return fn();
+    }
+  };
+  return {
+    cashu: noopLogger,
+    lightning: noopLogger,
+    x402: noopLogger
+  };
+}
+
 export {
   redactUrl,
-  redactUrlsInText
+  redactUrlsInText,
+  callerLoggers,
+  initCallerLoggers
 };

package/dist/{chunk-ETXDTUJO.js → chunk-LAKP6FUI.js}

@@ -998,11 +998,63 @@ var diagnostic_catalogue_v1_default = {
   ],
   clientVersionFields: [
     "client.version"
+  ],
+  paymentSkipReasons: [
+    "credit_or_draw_missing",
+    "draw_not_pending",
+    "draw_job_mismatch",
+    "rail_mismatch",
+    "channel_binding_mismatch",
+    "denomination_unavailable",
+    "topup_cap_unavailable",
+    "topup_cap_currency_mismatch",
+    "unknown"
+  ],
+  denominationCauses: [
+    "no_msats",
+    "sub_micro",
+    "unsupported_currency",
+    "rate_unavailable",
+    "rate_stale_refused",
+    "unknown"
+  ],
+  paymentFailureCategories: [
+    "invalid_challenge",
+    "malformed_credential",
+    "payment_expired",
+    "verification_failed",
+    "insufficient_funds",
+    "invalid_signature",
+    "unsupported_method",
+    "replay_detected",
+    "ledger_refused",
+    "settlement_failed",
+    "unsupported_version",
+    "unknown"
+  ],
+  paymentFailureStages: [
+    "verifier",
+    "broadcast",
+    "verifier_broadcast",
+    "replay_store",
+    "funding_ledger",
+    "unknown"
+  ],
+  paymentPhases: [
+    "upfront",
+    "mid-job"
   ]
 };
 
 // src/observability/projection.ts
 var DIAGNOSTIC_CATALOGUE_VERSION = diagnostic_catalogue_v1_default.version;
+var PAYMENT_ENUMS = {
+  reason: new Set(diagnostic_catalogue_v1_default.paymentSkipReasons),
+  cause: new Set(diagnostic_catalogue_v1_default.denominationCauses),
+  failure_category: new Set(diagnostic_catalogue_v1_default.paymentFailureCategories),
+  failure_stage: new Set(diagnostic_catalogue_v1_default.paymentFailureStages),
+  phase: new Set(diagnostic_catalogue_v1_default.paymentPhases)
+};
 var EVENTS = new Set(diagnostic_catalogue_v1_default.events);
 var ROUTE_TEMPLATES = [...diagnostic_catalogue_v1_default.routeTemplates].sort(
   compareRouteTemplates
@@ -1202,6 +1254,9 @@ function projectFields(input, dataset, authority, identityAuthority) {
   return output;
 }
 function projectField(key, value, dataset, authority, identityAuthority) {
+  const paymentEnum = Object.hasOwn(PAYMENT_ENUMS, key) ? PAYMENT_ENUMS[key] : void 0;
+  if (paymentEnum)
+    return typeof value === "string" && paymentEnum.has(value) ? value : void 0;
   if (BOOLEAN_FIELDS.has(key))
     return typeof value === "boolean" ? value : void 0;
   if (INTEGER_FIELDS.has(key))

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

@@ -2,12 +2,12 @@ import {
   parseStoreValue,
   stringifyStoreValue
 } from "./chunk-YG7G4DPZ.js";
+import {
+  withPostgresTransactionRecovery
+} from "./chunk-TRNMTTPX.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-OFSOLHRX.js

@@ -0,0 +1,120 @@
+import {
+  X402_DEFAULT_NETWORK,
+  resolveRpcHttpTransportOptions,
+  resolveRpcOverride
+} from "./chunk-62FI3NJF.js";
+import {
+  redactUrl,
+  redactUrlsInText
+} from "./chunk-KXWROQGK.js";
+import {
+  DvmError,
+  x402NetworkByCaip2,
+  x402SupportedNetworksHint
+} from "./chunk-BPYMEMQX.js";
+
+// src/lib/x402/asset.ts
+function resolveX402Asset(network = X402_DEFAULT_NETWORK) {
+  const spec = x402NetworkByCaip2(network);
+  if (!spec) return null;
+  return {
+    address: spec.usdc,
+    symbol: "USDC",
+    // "native" is the load-bearing word: every contract in the table is
+    // Circle's own USDC, and the dollars that read as zero here are the
+    // bridged ones.
+    label: "native USDC",
+    unit: "USDC",
+    networkLabel: spec.label,
+    confusable: spec.confusable
+  };
+}
+
+// src/lib/evm-private-key.ts
+import { secp256k1 } from "@noble/curves/secp256k1.js";
+import { hexToBytes } from "@noble/hashes/utils.js";
+var EVM_PRIVATE_KEY_RE = /^0x[0-9a-fA-F]{64}$/;
+function isValidEvmPrivateKey(value) {
+  return EVM_PRIVATE_KEY_RE.test(value) && secp256k1.utils.isValidSecretKey(hexToBytes(value.slice(2)));
+}
+
+// src/lib/x402/wallet.ts
+async function ensureAddress(wallet) {
+  if (!isValidEvmPrivateKey(wallet.privateKey)) throw invalidX402PrivateKey();
+  if (wallet.address) return wallet;
+  const { privateKeyToAccount } = await import("viem/accounts");
+  const account = privateKeyToAccount(wallet.privateKey);
+  return { ...wallet, address: account.address };
+}
+async function generateX402PrivateKey() {
+  const { generatePrivateKey } = await import("viem/accounts");
+  return generatePrivateKey();
+}
+function invalidX402PrivateKey() {
+  return new DvmError(
+    "invalid_key",
+    "Invalid secp256k1 private key.",
+    "Reconnect with `dvm wallet x402-connect --key-file <path>`, set DVM_X402_KEY, or pipe a valid 0x-prefixed 32-byte secp256k1 private key through stdin."
+  );
+}
+async function getX402Balance(wallet) {
+  const w = await ensureAddress(wallet);
+  const spec = x402NetworkByCaip2(w.network);
+  if (!spec) {
+    throw new DvmError(
+      "x402_unsupported_network",
+      `The x402 wallet is configured for ${w.network}, a chain this rail can't settle on.`,
+      `${x402SupportedNetworksHint()} Re-pin the connected wallet without handling its key: 'dvm wallet x402-network ${X402_DEFAULT_NETWORK}'.`
+    );
+  }
+  const chains = await import("viem/chains");
+  const { createPublicClient, http, erc20Abi } = await import("viem");
+  const chain = chains[spec.viemChain];
+  const { url: rpcUrl, source: rpcSource } = resolveRpcOverride(
+    process.env.DVM_X402_RPC_URL,
+    chain?.rpcUrls.default.http[0]
+  );
+  try {
+    const transportOptions = resolveRpcHttpTransportOptions(
+      rpcSource,
+      process.env.DVM_X402_RPC_HEADERS_JSON
+    );
+    const client = createPublicClient({
+      chain,
+      transport: transportOptions ? http(rpcUrl, transportOptions) : http(rpcUrl)
+    });
+    const balance = await client.readContract({
+      address: spec.usdc,
+      abi: erc20Abi,
+      functionName: "balanceOf",
+      args: [w.address]
+    });
+    return {
+      address: w.address,
+      usdc: Number(balance) / 1e6,
+      network: w.network,
+      tokenAddress: spec.usdc,
+      // redacted here rather than at a display surface, so the clear
+      // endpoint never leaves this function on the success path either.
+      rpcUrlRedacted: rpcUrl ? redactUrl(rpcUrl) : void 0,
+      rpcSource
+    };
+  } catch (err) {
+    const cause = redactUrlsInText(err instanceof Error ? err.message : String(err));
+    throw new DvmError(
+      "x402_rpc_error",
+      `x402 USDC balance lookup on ${spec.label} failed: ${cause}`,
+      // A caller who set the override doesn't need to be told to set it. Which
+      // knob is theirs to turn depends on whose endpoint this was.
+      rpcSource === "override" ? `DVM_X402_RPC_URL sent this read to ${redactUrl(rpcUrl)}. Correct it, or unset it to fall back to ${spec.label}'s bundled endpoint.` : `Verify connectivity to ${spec.label}'s bundled endpoint${rpcUrl ? ` (${redactUrl(rpcUrl)})` : ""}, or send the read somewhere else with DVM_X402_RPC_URL.`
+    );
+  }
+}
+
+export {
+  resolveX402Asset,
+  isValidEvmPrivateKey,
+  ensureAddress,
+  generateX402PrivateKey,
+  getX402Balance
+};

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

@@ -5,10 +5,10 @@ import {
 } from "./chunk-AFV77S4C.js";
 import {
   loggers
-} from "./chunk-QR2EF2NI.js";
+} from "./chunk-AQ7OX5NX.js";
 import {
   redactUrl
-} from "./chunk-FUJ36YDV.js";
+} from "./chunk-KXWROQGK.js";
 
 // src/sdk/server/job-store.ts
 function accumulateAskedTopUp(prior, ask) {

package/dist/{chunk-KA6VN5FK.js → chunk-RXPHMS4C.js}

@@ -2,12 +2,12 @@ import {
   parseStoreValue,
   stringifyStoreValue
 } from "./chunk-YG7G4DPZ.js";
+import {
+  diagnosticConsole
+} from "./chunk-LAKP6FUI.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";
-import {
-  diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
 
 // src/sdk/server/tempo-charge-store.ts
 import { Credential } from "mppx";

package/dist/{chunk-JH3SX3LY.js → chunk-SPYEJXI7.js}

@@ -1,15 +1,15 @@
-import {
-  withSdkInitLock
-} from "./chunk-COYKJRMM.js";
 import {
   applyRetryToPool
-} from "./chunk-P6QON7ER.js";
+} from "./chunk-TRNMTTPX.js";
 import {
   x402NetworkByCaip2
-} from "./chunk-RLTSCKRI.js";
+} from "./chunk-BPYMEMQX.js";
 import {
   diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
+} from "./chunk-LAKP6FUI.js";
+import {
+  withSdkInitLock
+} from "./chunk-COYKJRMM.js";
 
 // src/sdk/server/credit-ledger.ts
 import { randomUUID } from "crypto";

package/dist/{chunk-P6QON7ER.js → chunk-TRNMTTPX.js}

@@ -1,6 +1,6 @@
 import {
   diagnosticConsole
-} from "./chunk-ETXDTUJO.js";
+} from "./chunk-LAKP6FUI.js";
 
 // src/lib/pg-retry.ts
 import { AsyncLocalStorage } from "async_hooks";

package/dist/{chunk-RCM3P2HE.js → chunk-UKD3R2KU.js}

@@ -1,7 +1,3 @@
-import {
-  canonicaliseForSigning
-} from "./chunk-OFVV37XC.js";
-
 // src/sdk/types.ts
 function isZodSchema(value) {
   return typeof value === "object" && value !== null && "_zod" in value && "parse" in value && "safeParse" in value;
@@ -16,6 +12,58 @@ var DEFAULT_CREDIT_MAX = "$5.00";
 var DEFAULT_CREDIT_TTL_SECONDS = 30 * 24 * 60 * 60;
 var DEFAULT_JOB_RETENTION_DAYS = 730;
 
+// src/lib/cast-auth/canonical-json.ts
+function canonicalize(value) {
+  return JSON.stringify(sortDeep(value));
+}
+function canonicaliseForSigning(value) {
+  return new TextEncoder().encode(canonicalize(value));
+}
+function sortDeep(value) {
+  if (value === null) return null;
+  if (typeof value === "string" || typeof value === "boolean") return value;
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) {
+      throw new TypeError(`canonicalize: non-finite number is not JSON-serialisable`);
+    }
+    return value;
+  }
+  if (Array.isArray(value)) return value.map(sortDeep);
+  if (typeof value === "object") {
+    const sorted = {};
+    for (const key of Object.keys(value).sort()) {
+      const v = value[key];
+      if (v === void 0) continue;
+      sorted[key] = sortDeep(v);
+    }
+    return sorted;
+  }
+  throw new TypeError(`canonicalize: unsupported value of type ${typeof value}`);
+}
+
+// src/lib/cast-auth/verify.ts
+import { schnorr } from "@noble/curves/secp256k1.js";
+function verifyCanonicalSignedRequest(payload, signatureHex, pubkeyHex) {
+  if (!/^[0-9a-f]{64}$/i.test(pubkeyHex) || !/^[0-9a-f]{128}$/i.test(signatureHex)) {
+    return false;
+  }
+  const data = canonicaliseForSigning(payload);
+  const signature = hexToBytes(signatureHex);
+  const pubkey = hexToBytes(pubkeyHex);
+  try {
+    return schnorr.verify(signature, data, pubkey);
+  } catch {
+    return false;
+  }
+}
+function hexToBytes(hex) {
+  const out = new Uint8Array(hex.length / 2);
+  for (let i = 0; i < out.length; i++) {
+    out[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+  }
+  return out;
+}
+
 // src/lib/signed-request-statement.ts
 var SIGNED_REQUEST_AUTH_ID = "secp256k1-schnorr-v2";
 var SIGNED_REQUEST_STATEMENT_VERSION = 2;
@@ -81,6 +129,9 @@ export {
   DEFAULT_CREDIT_MAX,
   DEFAULT_CREDIT_TTL_SECONDS,
   DEFAULT_JOB_RETENTION_DAYS,
+  canonicalize,
+  canonicaliseForSigning,
+  verifyCanonicalSignedRequest,
   SIGNED_REQUEST_AUTH_ID,
   SIGNED_REQUEST_STATEMENT_VERSION,
   signedRequestStatementHeader,

package/dist/chunk-USL7ZEXN.js

@@ -0,0 +1,17 @@
+import {
+  validateCurrency
+} from "./chunk-CLIAFTUR.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
+};