@coinlist-co/react 0.10.0 → 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-GSSAB4K5.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-TUZKKFNW.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,13 +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/core/blockchain/swap/math.ts
+// src/shared/core/checkout/superstate/blockchain/math.ts
 function computePrice({
   inputTokenAmount,
   outputTokenAmount
@@ -357,12 +481,32 @@ function computeSlip(amount, slippage) {
   return BlockchainAmount({ raw: slipRaw, decimals: amount.decimals });
 }
 
-// src/shared/core/blockchain/swap/status.ts
+// src/shared/core/checkout/superstate/blockchain/quote.ts
+var SwapQuote = {
+  /**
+   * Assembles a {@link SwapQuote} from a raw contract {@link SwapPreview}. The
+   * input and fee are denominated in the input token; the output in the output
+   * token.
+   */
+  fromPreview: (preview, inputDecimals, outputDecimals) => ({
+    inputTokenAmount: BlockchainAmount({
+      raw: preview.inputAmount,
+      decimals: inputDecimals
+    }),
+    fee: BlockchainAmount({ raw: preview.fee, decimals: inputDecimals }),
+    outputTokenAmount: BlockchainAmount({
+      raw: preview.outputAmount,
+      decimals: outputDecimals
+    })
+  })
+};
+
+// 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 {
@@ -380,141 +524,9 @@ function decodeSwappedOutputAmount(receipt, outputDecimals) {
   }
 }
 
-// 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/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/formatters.ts
-import { formatUnits } from "viem";
-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/swap/constants.ts
-var SUPERSTATE_TOS_URL = "https://superstate.com/terms";
+// 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(
@@ -522,88 +534,49 @@ var SLIPPAGE_OPTIONS_BPS = [25n, 50n, 100n, 200n, 500n].map(
 );
 var DEFAULT_SLIPPAGE_BPS = Bps(50n);
 var SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA = EvmContractAddress("0x84f8e9a6C9Cc12fe911259372EfCa5582C4ae557");
-
-// src/shared/core/blockchain/swap/quote.ts
-var SwapQuote = {
-  /**
-   * Assembles a {@link SwapQuote} from a raw contract {@link SwapPreview}. The
-   * input and fee are denominated in the input token; the output in the output
-   * token.
-   */
-  fromPreview: (preview, inputDecimals, outputDecimals) => ({
-    inputTokenAmount: BlockchainAmount({
-      raw: preview.inputAmount,
-      decimals: inputDecimals
-    }),
-    fee: BlockchainAmount({ raw: preview.fee, decimals: inputDecimals }),
-    outputTokenAmount: BlockchainAmount({
-      raw: preview.outputAmount,
-      decimals: outputDecimals
-    })
-  })
+var SUPERSTATE_SWAP_CONTRACT_ADDRESSES = {
+  ethereum_sepolia: SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA
 };
+function superstateSwapContractAddress(chain) {
+  return SUPERSTATE_SWAP_CONTRACT_ADDRESSES[chain] ?? null;
+}
 
-// 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/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;
+var User = {
+  fromDto: (dto) => ({
+    id: UserId(dto.id),
+    email: UserEmail(dto.email)
+  })
 };
 
 export {
-  ERC20_ABI,
-  SUPERSTATE_SWAP_ABI,
-  BPS_DENOM,
-  applyBps,
-  computePrice,
-  computeSlip,
-  isStopped,
-  decodeSwappedOutputAmount,
   AuthorizationCode,
   CodeVerifier,
   CodeChallenge,
@@ -612,33 +585,38 @@ export {
   ClientId,
   ClientSecret,
   generatePKCEParams,
-  FormattedAmountUi,
-  FormattedPercentUi,
-  TxExplorerUrl,
-  ShortenedWalletAddress,
-  FormattedAmountAssetUi,
-  AssetIconUrl,
-  shortenAddress,
-  formatAmount,
-  formatRawAmount,
-  formatCompactAmount,
-  formatBpsAsPercent,
-  usdAmount,
-  assetAmount,
-  NA_AMOUNT_ASSET_UI,
-  formattedUsdPrice,
-  formattedPricePerShare,
-  SUPERSTATE_TOS_URL,
+  ERC20_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,
+  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
+  superstateSwapContractAddress,
+  formattedPricePerShare,
+  OffersNamespaceImpl,
+  UserId,
+  UserEmail,
+  User
 };
-//# sourceMappingURL=chunk-GSSAB4K5.js.map
+//# sourceMappingURL=chunk-B2HCVPCQ.js.map