@agent-score/commerce 2.3.0 → 2.4.0

package/dist/discovery/index.mjs

@@ -1,3 +1,42 @@
+// src/payment/amounts.ts
+function usdToAtomic(usd, opts) {
+  const { decimals } = opts;
+  if (!Number.isInteger(decimals) || decimals < 0) {
+    throw new RangeError(`decimals must be a non-negative integer, got ${decimals}`);
+  }
+  if (typeof usd === "number") {
+    if (!Number.isFinite(usd)) {
+      throw new RangeError(`usd must be finite, got ${usd}`);
+    }
+    if (usd < 0) {
+      throw new RangeError(`usd must be non-negative, got ${usd}`);
+    }
+  }
+  const s = (typeof usd === "number" ? usd.toString() : usd).trim();
+  if (s.startsWith("-")) {
+    throw new RangeError(`usd must be non-negative, got ${s}`);
+  }
+  if (s === "NaN" || s === "Infinity") {
+    throw new RangeError(`usd must be finite, got ${s}`);
+  }
+  const match = /^(\d*)(?:\.(\d*))?$/.exec(s);
+  if (!match || match[1] === "" && (match[2] === void 0 || match[2] === "")) {
+    throw new SyntaxError(`invalid usd value: ${JSON.stringify(usd)}`);
+  }
+  const intPart = match[1] || "0";
+  const fracPart = match[2] ?? "";
+  if (fracPart.length <= decimals) {
+    return BigInt(intPart + fracPart.padEnd(decimals, "0"));
+  }
+  const kept = fracPart.slice(0, decimals);
+  const roundDigit = fracPart[decimals];
+  let result = BigInt(intPart + kept);
+  if (roundDigit >= "5") {
+    result += 1n;
+  }
+  return result;
+}
+
 // src/payment/networks.ts
 var networks = {
   base: {
@@ -121,8 +160,7 @@ function buildPaymentRequestBlob({
   const decimalsResolved = decimals ?? railDef?.decimals ?? 6;
   const currencyResolved = currency ?? railDef?.currency ?? "usd";
   const chainIdResolved = chainId ?? railDef?.chainId;
-  const amountNum = typeof amountUsd === "string" ? Number(amountUsd) : amountUsd;
-  const amountRaw = BigInt(Math.round(amountNum * 10 ** decimalsResolved)).toString();
+  const amountRaw = usdToAtomic(amountUsd, { decimals: decimalsResolved }).toString();
   const blob = { amount: amountRaw, currency: currencyResolved, decimals: decimalsResolved };
   if (recipient) blob.recipient = recipient;
   const methodDetails = {};
@@ -1428,19 +1466,19 @@ function stableStringify(value) {
     }
     if (!Number.isInteger(value)) {
       throw new Error(
-        `UCP profile canonicalization rejects non-integer Number ${value}. Use a decimal string (e.g. "9.99") for monetary or fractional fields to preserve cross-language byte-parity.`
+        `UCP profile canonicalization rejects non-integer Number ${value}. Use a decimal string (e.g. "9.99") for monetary or fractional fields so the signed canonical bytes stay stable for any verifier.`
       );
     }
     if (!Number.isSafeInteger(value)) {
       throw new Error(
-        `stableStringify: integer ${value} exceeds Number.MAX_SAFE_INTEGER. For values >2^53, use a decimal string to preserve cross-language byte parity.`
+        `stableStringify: integer ${value} exceeds Number.MAX_SAFE_INTEGER. For values >2^53, use a decimal string to keep the signed bytes stable across implementations.`
       );
     }
   }
   if (typeof value === "string") {
     if (value.includes("\u2028") || value.includes("\u2029")) {
       throw new Error(
-        "stableStringify: strings containing U+2028 (LINE SEPARATOR) or U+2029 (PARAGRAPH SEPARATOR) are not allowed; cross-language byte parity requires neither be present (Node JSON.stringify on older V8 escapes them; Python json.dumps with ensure_ascii=False does not)."
+        "stableStringify: strings containing U+2028 (LINE SEPARATOR) or U+2029 (PARAGRAPH SEPARATOR) are not allowed; stable canonical bytes require neither be present (some JSON encoders escape them, others emit them raw)."
       );
     }
     return JSON.stringify(value);
@@ -1460,7 +1498,7 @@ function stableStringify(value) {
   for (const k of keys) {
     if (k.includes("\u2028") || k.includes("\u2029")) {
       throw new Error(
-        "stableStringify: object keys containing U+2028 (LINE SEPARATOR) or U+2029 (PARAGRAPH SEPARATOR) are not allowed; cross-language byte parity (Node JSON.stringify on older V8 escapes them; Python json.dumps with ensure_ascii=False does not)."
+        "stableStringify: object keys containing U+2028 (LINE SEPARATOR) or U+2029 (PARAGRAPH SEPARATOR) are not allowed; stable canonical bytes require neither be present (some JSON encoders escape them, others emit them raw)."
       );
     }
   }