@dvmkit/sdk 0.0.0 → 0.1.0-rc.2

package/dist/chunk-AT6V3SY7.js

@@ -0,0 +1,102 @@
+// 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"
+};
+
+export {
+  InvalidFxRateError,
+  fiatToSatsCeil,
+  satsToFiat,
+  InvalidUsdPriceError,
+  parseUsdPrice,
+  roundUsd,
+  formatUsd,
+  formatFiat
+};