@coinlist-co/react 0.10.1 → 0.11.0

package/README.md

@@ -5,3 +5,35 @@ This package is documented at:
 https://docs.coinlist.co/
 
 Please refer to the docs site for installation, configuration, and integration guides.
+
+## Local development
+
+The toolchain (Node 24, TypeScript) is pinned by `flake.nix` and frozen by `flake.lock`.
+
+Prerequisites:
+
+1. Nix — install with the [Determinate Systems installer](https://github.com/DeterminateSystems/nix-installer),
+   which enables flakes out of the box and supports clean uninstalls:
+
+   ```bash
+   curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
+   ```
+
+2. [direnv](https://direnv.net/) and [nix-direnv](https://github.com/nix-community/nix-direnv)
+   (direnv on its own does not provide `use flake`).
+
+```bash
+direnv allow   # activates the dev shell on every cd into the repo
+```
+
+Without direnv, enter the same shell manually:
+
+```bash
+nix develop
+```
+
+The flake provides the toolchain, not `node_modules` — install JS dependencies as usual:
+
+```bash
+npm ci
+```

package/dist/{chunk-AQVCOWOV.js → chunk-B2HCVPCQ.js}

@@ -2,16 +2,55 @@ import {
   AssetDecimals,
   BlockchainAmount,
   Bps,
+  DecimalString,
   EvmContractAddress,
   MAX_UINT_256,
+  NA_AMOUNT_ASSET_UI,
   StablecoinSymbol,
+  ValidationError,
   arrayBufferToBase64Url,
   assertUint256,
+  fetchOfferDetails,
+  fetchOffers,
+  fetchOffersPage,
+  formattedUsdPrice,
   generateSecureRandomBase64Url,
   sha256
-} from "./chunk-UOHD7US2.js";
+} from "./chunk-UIIXXLA7.js";
+
+// src/shared/types/oauth.ts
+var AuthorizationCode = (value) => value;
+var CodeVerifier = (value) => value;
+var CodeChallenge = (value) => value;
+var PKCEState = (value) => value;
+var RedirectUri = (value) => value;
+var ClientId = (value) => value;
+var ClientSecret = (value) => value;
+
+// src/shared/core/auth/pkce.ts
+async function generatePKCEParams(config) {
+  const state = generateSecureRandomBase64Url(32);
+  const codeVerifier = generateSecureRandomBase64Url(32);
+  const codeChallengeRaw = await sha256(codeVerifier);
+  const codeChallenge = arrayBufferToBase64Url(codeChallengeRaw, false);
+  return {
+    clientId: config.clientId,
+    responseType: "code",
+    redirectUri: config.redirectUri,
+    codeChallenge: CodeChallenge(codeChallenge),
+    codeChallengeMethod: "S256",
+    state: PKCEState(state),
+    codeVerifier: CodeVerifier(codeVerifier)
+  };
+}
 
-// src/shared/core/blockchain/abis/erc20.ts
+// src/shared/core/blockchain/bps.ts
+var BPS_DENOM = Bps(10000n);
+function applyBps(amount, bps) {
+  return assertUint256(amount * bps / BPS_DENOM);
+}
+
+// src/shared/core/blockchain/erc20/abi.ts
 var ERC20_ABI = [
   {
     type: "function",
@@ -111,7 +150,98 @@ var ERC20_ABI = [
   }
 ];
 
-// src/shared/core/blockchain/abis/superstate-swap.ts
+// src/shared/core/blockchain/token-registry.ts
+var USDC_SYMBOL = StablecoinSymbol("USDC");
+var USDC = {
+  name: "USD Coin",
+  symbol: USDC_SYMBOL,
+  decimals: AssetDecimals(6)
+};
+var USDT_SYMBOL = StablecoinSymbol("USDT");
+var USDT = {
+  name: "Tether USD",
+  symbol: USDT_SYMBOL,
+  decimals: AssetDecimals(6)
+};
+var USDC_ADDRESSES = {
+  ethereum_mainnet: EvmContractAddress(
+    "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
+  ),
+  ethereum_sepolia: EvmContractAddress(
+    "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238"
+  )
+};
+var USDT_ADDRESSES = {
+  ethereum_mainnet: EvmContractAddress(
+    "0xdac17f958d2ee523a2206206994597c13d831ec7"
+  ),
+  ethereum_sepolia: EvmContractAddress(
+    "0x7169D38820dfd117C3FA1f22a697dBA58d90BA06"
+  )
+};
+var TOKEN_REGISTRY = {
+  erc20: (symbol) => {
+    switch (symbol) {
+      case "USDC":
+        return USDC;
+      case "USDT":
+        return USDT;
+      default:
+        throw new Error(`Unknown asset symbol: ${symbol}`);
+    }
+  },
+  contractAddress: (symbol, chain) => {
+    switch (symbol) {
+      case "USDC":
+        return USDC_ADDRESSES[chain];
+      case "USDT":
+        return USDT_ADDRESSES[chain];
+      default:
+        throw new Error(`Unknown asset symbol: ${symbol}`);
+    }
+  }
+};
+
+// src/shared/core/checkout/ondo/constants.ts
+var ONDO_SWAP_CONTRACT_ADDRESSES = {
+  ethereum_sepolia: EvmContractAddress(
+    "0xFF9c5Ade32d9B4102469Bd5F3817CB0061b25feC"
+  )
+};
+function ondoSwapContractAddress(chain) {
+  return ONDO_SWAP_CONTRACT_ADDRESSES[chain] ?? null;
+}
+var ONDO_POLL_INTERVAL_MS = 15e3;
+var ONDO_QUOTE_EXPIRY_THRESHOLD_MS = 5e3;
+var DEFAULT_ONDO_AMOUNT_TO_COMPUTE_PRICE = DecimalString("1000");
+var ONDO_SUPPORTED_INPUT_ASSETS = [
+  USDC_SYMBOL
+];
+
+// src/shared/core/checkout/ondo/math.ts
+function computeOndoPrice(transaction) {
+  const { notionalValue, receiveOutputAmount } = transaction;
+  if (receiveOutputAmount.raw <= 0n) {
+    throw new ValidationError(
+      "Ondo price: receiveOutputAmount must be greater than zero"
+    );
+  }
+  const scaled = notionalValue.raw * 10n ** BigInt(receiveOutputAmount.decimals);
+  const raw = scaled / receiveOutputAmount.raw;
+  return BlockchainAmount({
+    raw: assertPriceFits(raw),
+    decimals: notionalValue.decimals
+  });
+}
+function assertPriceFits(raw) {
+  try {
+    return assertUint256(raw);
+  } catch {
+    throw new ValidationError(`Ondo price: out of uint256 bounds (${raw})`);
+  }
+}
+
+// src/shared/core/checkout/superstate/blockchain/abi.ts
 var SUPERSTATE_SWAP_ABI = [
   {
     type: "function",
@@ -333,65 +463,7 @@ var SUPERSTATE_SWAP_ABI = [
   }
 ];
 
-// src/shared/core/blockchain/bps.ts
-var BPS_DENOM = Bps(10000n);
-function applyBps(amount, bps) {
-  return assertUint256(amount * bps / BPS_DENOM);
-}
-
-// src/shared/types/blockchain/ui.ts
-var FormattedAmountUi = (value) => value;
-var FormattedPercentUi = (value) => value;
-var TxExplorerUrl = (value) => value;
-var ShortenedWalletAddress = (value) => value;
-var FormattedAmountAssetUi = (value) => value;
-var AssetIconUrl = (value) => value;
-
-// src/shared/core/blockchain/chain.ts
-function getChainId(chain) {
-  switch (chain) {
-    case "ethereum_mainnet":
-      return 1;
-    case "ethereum_sepolia":
-      return 11155111;
-    default: {
-      const _exhaustive = chain;
-      return _exhaustive;
-    }
-  }
-}
-function getNetworkName(chain) {
-  switch (chain) {
-    case "ethereum_mainnet":
-      return "Ethereum";
-    case "ethereum_sepolia":
-      return "Ethereum Sepolia";
-    default: {
-      const _exhaustive = chain;
-      return _exhaustive;
-    }
-  }
-}
-function txExplorerUrl(chain, txHash) {
-  return TxExplorerUrl(`${explorerBaseUrl(chain)}/tx/${txHash}`);
-}
-function explorerBaseUrl(chain) {
-  switch (chain) {
-    case "ethereum_mainnet":
-      return "https://etherscan.io";
-    case "ethereum_sepolia":
-      return "https://sepolia.etherscan.io";
-    default: {
-      const _exhaustive = chain;
-      return _exhaustive;
-    }
-  }
-}
-
-// src/shared/core/blockchain/formatters.ts
-import { formatUnits } from "viem";
-
-// src/shared/core/blockchain/swap/math.ts
+// src/shared/core/checkout/superstate/blockchain/math.ts
 function computePrice({
   inputTokenAmount,
   outputTokenAmount
@@ -409,149 +481,7 @@ function computeSlip(amount, slippage) {
   return BlockchainAmount({ raw: slipRaw, decimals: amount.decimals });
 }
 
-// src/shared/core/blockchain/formatters.ts
-function shortenAddress(address) {
-  const short = address.length > 10 ? `${address.slice(0, 6)}\u2026${address.slice(-4)}` : address;
-  return ShortenedWalletAddress(short);
-}
-function formatAmount(amount, locale, options) {
-  const decimal = formatRawAmount(amount);
-  let [integerPart, fractionPart = ""] = decimal.split(".");
-  const maxFractionDigits = options?.maxFractionDigits;
-  const minFractionDigits = maxFractionDigits !== void 0 ? Math.min(maxFractionDigits, amount.decimals) : Math.min(2, amount.decimals);
-  if (maxFractionDigits !== void 0 && fractionPart.length > maxFractionDigits) {
-    ({ integerPart, fractionPart } = roundFractionHalfUp(
-      integerPart,
-      fractionPart,
-      maxFractionDigits
-    ));
-  }
-  const fraction = minFractionDigits === 0 ? "" : fractionPart.padEnd(minFractionDigits, "0");
-  const integerFormatted = BigInt(integerPart).toLocaleString(locale);
-  if (minFractionDigits === 0 && fraction === "") {
-    return FormattedAmountUi(integerFormatted);
-  }
-  const decimalSeparator = new Intl.NumberFormat(locale).formatToParts(1.1).find((p) => p.type === "decimal")?.value ?? ".";
-  return FormattedAmountUi(`${integerFormatted}${decimalSeparator}${fraction}`);
-}
-function roundFractionHalfUp(integerPart, fractionPart, maxFractionDigits) {
-  if (fractionPart.length <= maxFractionDigits) {
-    return { integerPart, fractionPart };
-  }
-  if (maxFractionDigits === 0) {
-    const roundUp = fractionPart[0] >= "5";
-    const integer = BigInt(integerPart) + (roundUp ? 1n : 0n);
-    return { integerPart: integer.toString(), fractionPart: "" };
-  }
-  const trimmed = fractionPart.slice(0, maxFractionDigits);
-  if (fractionPart[maxFractionDigits] < "5") {
-    return { integerPart, fractionPart: trimmed };
-  }
-  const digits = trimmed.split("").map((digit) => Number.parseInt(digit, 10));
-  let carry = 1;
-  for (let i = digits.length - 1; i >= 0 && carry > 0; i -= 1) {
-    const sum = digits[i] + carry;
-    if (sum === 10) {
-      digits[i] = 0;
-      carry = 1;
-    } else {
-      digits[i] = sum;
-      carry = 0;
-    }
-  }
-  return {
-    integerPart: carry > 0 ? (BigInt(integerPart) + 1n).toString() : integerPart,
-    fractionPart: digits.join("")
-  };
-}
-function formatRawAmount(amount) {
-  return formatUnits(amount.raw, amount.decimals);
-}
-function formatCompactAmount(amount, locale) {
-  const value = Number(formatRawAmount(amount));
-  const formatted = new Intl.NumberFormat(locale, {
-    notation: "compact",
-    maximumFractionDigits: 2
-  }).format(value);
-  return FormattedAmountUi(formatted);
-}
-function formatBpsAsPercent(bps, locale) {
-  const whole = bps / 100n;
-  const fraction = bps % 100n;
-  const wholeFormatted = whole.toLocaleString(locale);
-  const decimalSeparator = new Intl.NumberFormat(locale).formatToParts(1.1).find((p) => p.type === "decimal")?.value ?? ".";
-  if (fraction === 0n) {
-    return FormattedPercentUi(`${wholeFormatted}%`);
-  }
-  const fractionFormatted = fraction.toString().padStart(2, "0").replace(/0+$/, "");
-  return FormattedPercentUi(
-    `${wholeFormatted}${decimalSeparator}${fractionFormatted}%`
-  );
-}
-function usdAmount(amount) {
-  return FormattedAmountAssetUi(`$${amount}`);
-}
-function assetAmount(amount, symbol) {
-  return FormattedAmountAssetUi(`${amount} ${symbol}`);
-}
-var NA_AMOUNT_ASSET_UI = FormattedAmountAssetUi("-");
-var USD_FRACTION_DIGITS = AssetDecimals(2);
-function formattedUsdPrice(amount, locale) {
-  if (!amount) return NA_AMOUNT_ASSET_UI;
-  return usdAmount(
-    formatAmount(amount, locale, { maxFractionDigits: USD_FRACTION_DIGITS })
-  );
-}
-function formattedPricePerShare(quote, locale) {
-  if (!quote) return NA_AMOUNT_ASSET_UI;
-  return formattedUsdPrice(computePrice(quote), locale);
-}
-
-// src/shared/core/blockchain/math.ts
-import { parseUnits } from "viem";
-function parseBlockchainAmount(amount, decimals) {
-  const trimmed = amount.trim();
-  if (trimmed === "") return { valid: false, reason: { type: "empty" } };
-  if (trimmed.startsWith("-")) {
-    return { valid: false, reason: { type: "negative" } };
-  }
-  if (/[eE]/.test(trimmed)) {
-    return { valid: false, reason: { type: "invalid-format" } };
-  }
-  if (!/^\d+(\.\d+)?$/.test(trimmed)) {
-    return { valid: false, reason: { type: "invalid-format" } };
-  }
-  const [, fraction = ""] = trimmed.split(".");
-  if (fraction.length > decimals) {
-    return {
-      valid: false,
-      reason: { type: "too-many-decimals", maxDecimals: decimals }
-    };
-  }
-  try {
-    return {
-      valid: true,
-      amount: BlockchainAmount({
-        raw: parseUnits(trimmed, decimals),
-        decimals
-      })
-    };
-  } catch {
-    return { valid: false, reason: { type: "invalid-format" } };
-  }
-}
-
-// src/shared/core/blockchain/swap/constants.ts
-var SUPERSTATE_TOS_URL = "https://superstate.com/terms";
-var SWAP_POLL_INTERVAL_MS = 15e3;
-var DEFAULT_AMOUNT_TO_COMPUTE_PRICE = 1000000n;
-var SLIPPAGE_OPTIONS_BPS = [25n, 50n, 100n, 200n, 500n].map(
-  (n) => Bps(n)
-);
-var DEFAULT_SLIPPAGE_BPS = Bps(50n);
-var SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA = EvmContractAddress("0x84f8e9a6C9Cc12fe911259372EfCa5582C4ae557");
-
-// src/shared/core/blockchain/swap/quote.ts
+// src/shared/core/checkout/superstate/blockchain/quote.ts
 var SwapQuote = {
   /**
    * Assembles a {@link SwapQuote} from a raw contract {@link SwapPreview}. The
@@ -571,12 +501,12 @@ var SwapQuote = {
   })
 };
 
-// src/shared/core/blockchain/swap/status.ts
+// src/shared/core/checkout/superstate/blockchain/status.ts
 function isStopped(status) {
   return (status.stopped & status.swapLevel) !== 0n;
 }
 
-// src/shared/core/blockchain/swap/swapped-event.ts
+// src/shared/core/checkout/superstate/blockchain/swapped-event.ts
 import { parseEventLogs } from "viem";
 function decodeSwappedOutputAmount(receipt, outputDecimals) {
   try {
@@ -594,84 +524,48 @@ function decodeSwappedOutputAmount(receipt, outputDecimals) {
   }
 }
 
-// src/shared/core/blockchain/token-registry.ts
-var USDC_SYMBOL = StablecoinSymbol("USDC");
-var USDC = {
-  name: "USD Coin",
-  symbol: USDC_SYMBOL,
-  decimals: AssetDecimals(6)
-};
-var USDT_SYMBOL = StablecoinSymbol("USDT");
-var USDT = {
-  name: "Tether USD",
-  symbol: USDT_SYMBOL,
-  decimals: AssetDecimals(6)
-};
-var USDC_ADDRESSES = {
-  ethereum_mainnet: EvmContractAddress(
-    "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
-  ),
-  ethereum_sepolia: EvmContractAddress(
-    "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238"
-  )
-};
-var USDT_ADDRESSES = {
-  ethereum_mainnet: EvmContractAddress(
-    "0xdac17f958d2ee523a2206206994597c13d831ec7"
-  ),
-  ethereum_sepolia: EvmContractAddress(
-    "0x7169D38820dfd117C3FA1f22a697dBA58d90BA06"
-  )
-};
-var TOKEN_REGISTRY = {
-  erc20: (symbol) => {
-    switch (symbol) {
-      case "USDC":
-        return USDC;
-      case "USDT":
-        return USDT;
-      default:
-        throw new Error(`Unknown asset symbol: ${symbol}`);
-    }
-  },
-  contractAddress: (symbol, chain) => {
-    switch (symbol) {
-      case "USDC":
-        return USDC_ADDRESSES[chain];
-      case "USDT":
-        return USDT_ADDRESSES[chain];
-      default:
-        throw new Error(`Unknown asset symbol: ${symbol}`);
-    }
-  }
+// src/shared/core/checkout/superstate/constants.ts
+var SUPERSTATE_ISSUER_NAME = "Superstate";
+var SUPERSTATE_SUPPORTED_INPUT_ASSETS = [USDC_SYMBOL];
+var SWAP_POLL_INTERVAL_MS = 15e3;
+var DEFAULT_AMOUNT_TO_COMPUTE_PRICE = 1000000n;
+var SLIPPAGE_OPTIONS_BPS = [25n, 50n, 100n, 200n, 500n].map(
+  (n) => Bps(n)
+);
+var DEFAULT_SLIPPAGE_BPS = Bps(50n);
+var SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA = EvmContractAddress("0x84f8e9a6C9Cc12fe911259372EfCa5582C4ae557");
+var SUPERSTATE_SWAP_CONTRACT_ADDRESSES = {
+  ethereum_sepolia: SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA
 };
+function superstateSwapContractAddress(chain) {
+  return SUPERSTATE_SWAP_CONTRACT_ADDRESSES[chain] ?? null;
+}
 
-// src/shared/types/oauth.ts
-var AuthorizationCode = (value) => value;
-var CodeVerifier = (value) => value;
-var CodeChallenge = (value) => value;
-var PKCEState = (value) => value;
-var RedirectUri = (value) => value;
-var ClientId = (value) => value;
-var ClientSecret = (value) => value;
-
-// src/shared/pkce.ts
-async function generatePKCEParams(config) {
-  const state = generateSecureRandomBase64Url(32);
-  const codeVerifier = generateSecureRandomBase64Url(32);
-  const codeChallengeRaw = await sha256(codeVerifier);
-  const codeChallenge = arrayBufferToBase64Url(codeChallengeRaw, false);
-  return {
-    clientId: config.clientId,
-    responseType: "code",
-    redirectUri: config.redirectUri,
-    codeChallenge: CodeChallenge(codeChallenge),
-    codeChallengeMethod: "S256",
-    state: PKCEState(state),
-    codeVerifier: CodeVerifier(codeVerifier)
-  };
+// src/shared/core/checkout/superstate/formatters.ts
+function formattedPricePerShare(quote, locale) {
+  if (!quote) return NA_AMOUNT_ASSET_UI;
+  return formattedUsdPrice(computePrice(quote), locale);
 }
 
+// src/shared/core/offers/offers-namespace.ts
+var OffersNamespaceImpl = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  async list() {
+    await this.ctx.ensureUserAuthenticated();
+    return fetchOffers(this.ctx.api, void 0);
+  }
+  async listPage(params) {
+    await this.ctx.ensureUserAuthenticated();
+    return fetchOffersPage(this.ctx.api, params, void 0);
+  }
+  async get(id) {
+    await this.ctx.ensureUserAuthenticated();
+    return fetchOfferDetails(this.ctx.api, id, void 0);
+  }
+};
+
 // src/shared/types/user.ts
 var UserId = (value) => value;
 var UserEmail = (value) => value;
@@ -683,56 +577,46 @@ var User = {
 };
 
 export {
+  AuthorizationCode,
+  CodeVerifier,
+  CodeChallenge,
+  PKCEState,
+  RedirectUri,
+  ClientId,
+  ClientSecret,
+  generatePKCEParams,
   ERC20_ABI,
-  SUPERSTATE_SWAP_ABI,
   BPS_DENOM,
   applyBps,
+  USDC_SYMBOL,
+  USDC,
+  USDT_SYMBOL,
+  USDT,
+  TOKEN_REGISTRY,
+  ondoSwapContractAddress,
+  ONDO_POLL_INTERVAL_MS,
+  ONDO_QUOTE_EXPIRY_THRESHOLD_MS,
+  DEFAULT_ONDO_AMOUNT_TO_COMPUTE_PRICE,
+  ONDO_SUPPORTED_INPUT_ASSETS,
+  computeOndoPrice,
+  SUPERSTATE_SWAP_ABI,
   computePrice,
   computeSlip,
+  SwapQuote,
   isStopped,
   decodeSwappedOutputAmount,
-  FormattedAmountUi,
-  FormattedPercentUi,
-  TxExplorerUrl,
-  ShortenedWalletAddress,
-  FormattedAmountAssetUi,
-  AssetIconUrl,
-  getChainId,
-  getNetworkName,
-  txExplorerUrl,
-  shortenAddress,
-  formatAmount,
-  formatRawAmount,
-  formatCompactAmount,
-  formatBpsAsPercent,
-  usdAmount,
-  assetAmount,
-  NA_AMOUNT_ASSET_UI,
-  formattedUsdPrice,
-  formattedPricePerShare,
-  parseBlockchainAmount,
-  SUPERSTATE_TOS_URL,
+  SUPERSTATE_ISSUER_NAME,
+  SUPERSTATE_SUPPORTED_INPUT_ASSETS,
   SWAP_POLL_INTERVAL_MS,
   DEFAULT_AMOUNT_TO_COMPUTE_PRICE,
   SLIPPAGE_OPTIONS_BPS,
   DEFAULT_SLIPPAGE_BPS,
   SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA,
-  SwapQuote,
-  USDC_SYMBOL,
-  USDC,
-  USDT_SYMBOL,
-  USDT,
-  TOKEN_REGISTRY,
-  AuthorizationCode,
-  CodeVerifier,
-  CodeChallenge,
-  PKCEState,
-  RedirectUri,
-  ClientId,
-  ClientSecret,
-  generatePKCEParams,
+  superstateSwapContractAddress,
+  formattedPricePerShare,
+  OffersNamespaceImpl,
   UserId,
   UserEmail,
   User
 };
-//# sourceMappingURL=chunk-AQVCOWOV.js.map
+//# sourceMappingURL=chunk-B2HCVPCQ.js.map