@coinlist-co/react 0.12.1-rc.14ac67e → 0.12.1-rc.c2b6ba5

package/dist/{chunk-3ATIDGVR.js → chunk-6CQHDASY.js}

@@ -1,4 +1,4 @@
-// src/shared/api/http-attributes.ts
+// src/universal/api/http-attributes.ts
 var empty = {};
 var concat = (left, right) => ({
   ...left,
@@ -53,7 +53,7 @@ var Attributes = {
   getRequestId
 };
 
-// src/shared/api/http.ts
+// src/universal/api/http.ts
 var HttpError = class extends Error {
   constructor(response) {
     super(`Request failed with ${response.status} status`);
@@ -177,7 +177,7 @@ var Request = {
   concatAttributes
 };
 
-// src/shared/types/errors.ts
+// src/universal/types/errors.ts
 var NotImplementedError = class extends Error {
   constructor(message = "Not implemented yet") {
     super(message);
@@ -209,7 +209,7 @@ var MathError = class extends Error {
   }
 };
 
-// src/shared/api/pagination.ts
+// src/universal/api/pagination.ts
 async function fetchAllPages(fetchPage, baseParams) {
   const items = [];
   let cursor = null;
@@ -225,7 +225,44 @@ async function fetchAllPages(fetchPage, baseParams) {
   return items;
 }
 
-// src/shared/types/blockchain/core.ts
+// src/universal/types/pagination.ts
+var Cursor = (value) => value;
+var PaginatedResponse = {
+  fromDto: (dto, itemMapper) => ({
+    data: dto.data.map(itemMapper),
+    startingAfter: dto.starting_after ? Cursor(dto.starting_after) : null,
+    startingBefore: dto.starting_before ? Cursor(dto.starting_before) : null
+  })
+};
+var PaginationParams = {
+  toQueryParams: (params) => {
+    const queryParams = {};
+    if (params.after) {
+      queryParams.starting_after = params.after;
+    }
+    if (params.before) {
+      queryParams.starting_before = params.before;
+    }
+    if (params.limit) {
+      queryParams.limit = params.limit;
+    }
+    return queryParams;
+  }
+};
+
+// src/universal/types/asset.ts
+var AssetId = (value) => value;
+var AssetCode = (value) => value;
+var Asset = {
+  fromDto: (dto) => ({
+    id: AssetId(dto.id),
+    code: AssetCode(dto.code),
+    name: dto.name,
+    fractionalDigits: dto.fractional_digits
+  })
+};
+
+// src/universal/types/blockchain/core.ts
 var ETHEREUM_CHAINS = {
   ethereum_mainnet: true,
   ethereum_sepolia: true,
@@ -248,8 +285,9 @@ var SolanaChain = (value) => {
   }
   return value;
 };
+var isChain = (value) => Object.keys(ETHEREUM_CHAINS).includes(value) || Object.keys(SOLANA_CHAINS).includes(value);
 var Chain = (value) => {
-  if (!Object.keys(ETHEREUM_CHAINS).includes(value) && !Object.keys(SOLANA_CHAINS).includes(value)) {
+  if (!isChain(value)) {
     throw new ValidationError(`Unsupported chain: "${value}"`);
   }
   return value;
@@ -321,226 +359,295 @@ var StablecoinSymbol = (value) => value;
 var KnownAssetSymbol = StablecoinSymbol;
 var Bps = (value) => value;
 
-// 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
-var CHAIN_IDS = {
-  ethereum_mainnet: 1,
-  ethereum_sepolia: 11155111,
-  base_mainnet: 8453,
-  base_sepolia: 84532
+// src/universal/types/offer.ts
+var OfferId = (value) => value;
+var OfferSlug = (value) => value;
+var Offer = {
+  fromDto: (dto) => {
+    if (!Array.isArray(dto.tokens)) {
+      throw new ValidationError(
+        `Offer.tokens: expected an array, got ${typeof dto.tokens}`
+      );
+    }
+    return {
+      id: OfferId(dto.id),
+      slug: OfferSlug(dto.slug),
+      type: dto.type,
+      tagline: dto.tagline,
+      bannerUrl: dto.banner_url,
+      logoUrl: dto.logo_url,
+      startsAt: new Date(dto.starts_at),
+      endsAt: dto.ends_at ? new Date(dto.ends_at) : null,
+      tokens: OfferToken.listFromDto(dto.tokens)
+    };
+  }
 };
-function getChainId(chain) {
-  return CHAIN_IDS[chain];
+var OfferToken = {
+  fromDto: (dto) => ({
+    role: dto.role,
+    chain: Chain(dto.chain),
+    address: EvmContractAddress(dto.address)
+  }),
+  /**
+   * Maps an offer's token list, dropping every token on a chain this SDK does
+   * not name. Frontline's chain registry runs ahead of {@link Chain}, and a
+   * plain `.map` would throw out of `Offer.fromDto` and, through
+   * `PaginatedResponse.fromDto`, reject the whole offers page - which is how
+   * one Base token blanked production's offers list. Dropping costs that
+   * token's metadata alone: `coinlist.tokens.get` takes an `EthereumChain`,
+   * so nobody could have looked it up anyway.
+   *
+   * Same shape as `TokenMetadata.fromRegistryDto`.
+   */
+  listFromDto: (dtos) => dtos.filter((dto) => isChain(dto.chain)).map(OfferToken.fromDto)
+};
+
+// src/universal/core/shared/utils/crypto.ts
+async function sha256(data) {
+  const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
+  const buffer = bytes.buffer.slice(
+    bytes.byteOffset,
+    bytes.byteOffset + bytes.byteLength
+  );
+  return crypto.subtle.digest("SHA-256", buffer);
 }
-function chainFromId(chainId) {
-  const chains = Object.keys(CHAIN_IDS);
-  const chain = chains.find((c) => String(CHAIN_IDS[c]) === chainId);
-  if (!chain) {
-    throw new ValidationError(`Unsupported EIP-155 chain id: "${chainId}"`);
+function arrayBufferToBase64Url(buffer, padding = true) {
+  const bytes = new Uint8Array(buffer);
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) {
+    binary += String.fromCharCode(bytes[i]);
   }
-  return chain;
-}
-function getNetworkName(chain) {
-  switch (chain) {
-    case "ethereum_mainnet":
-      return "Ethereum";
-    case "ethereum_sepolia":
-      return "Ethereum Sepolia";
-    case "base_mainnet":
-      return "Base";
-    case "base_sepolia":
-      return "Base Sepolia";
-    default: {
-      const _exhaustive = chain;
-      return _exhaustive;
-    }
+  let base64 = btoa(binary);
+  base64 = base64.replace(/\+/g, "-").replace(/\//g, "_");
+  if (!padding) {
+    base64 = base64.replace(/=+$/, "");
   }
+  return base64;
 }
-function txExplorerUrl(chain, txHash) {
-  return TxExplorerUrl(`${explorerBaseUrl(chain)}/tx/${txHash}`);
+function generateSecureRandomBase64Url(byteLength) {
+  const bytes = new Uint8Array(byteLength);
+  crypto.getRandomValues(bytes);
+  const buffer = bytes.buffer;
+  return arrayBufferToBase64Url(buffer, false);
 }
-function explorerBaseUrl(chain) {
-  switch (chain) {
-    case "ethereum_mainnet":
-      return "https://etherscan.io";
-    case "ethereum_sepolia":
-      return "https://sepolia.etherscan.io";
-    case "base_mainnet":
-      return "https://basescan.org";
-    case "base_sepolia":
-      return "https://sepolia-explorer.base.org";
-    default: {
-      const _exhaustive = chain;
-      return _exhaustive;
-    }
+function getUUIDv4() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    bytes[6] = bytes[6] & 15 | 64;
+    bytes[8] = bytes[8] & 63 | 128;
+    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0"));
+    return `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(6, 8).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10, 16).join("")}`;
+  }
+  return `${Date.now()}-${Math.random().toString(36).slice(2, 12)}`;
+}
+function notBlankStringOrNull(value) {
+  if (value?.trim()) {
+    return value;
+  } else {
+    return null;
   }
 }
 
-// src/shared/types/providers/superstate/swap.ts
-var SwapAuthorization = {
+// src/universal/types/offer-detail.ts
+var OfferOptionId = (value) => value;
+var OfferOptionSlug = (value) => value;
+var OfferSwapContract = {
   fromDto: (dto) => ({
-    authorized: dto.authorized
+    chain: Chain(dto.chain),
+    address: EvmContractAddress(dto.address)
   })
 };
-var SwapPreview = {
+var OfferDetail = {
+  fromDto: (dto) => {
+    if (!Array.isArray(dto.funding_assets)) {
+      throw new ValidationError(
+        `OfferDetail.funding_assets: expected an array, got ${typeof dto.funding_assets}`
+      );
+    }
+    if (!Array.isArray(dto.options)) {
+      throw new ValidationError(
+        `OfferDetail.options: expected an array, got ${typeof dto.options}`
+      );
+    }
+    if (!Array.isArray(dto.terms)) {
+      throw new ValidationError(
+        `OfferDetail.terms: expected an array, got ${typeof dto.terms}`
+      );
+    }
+    if (!Array.isArray(dto.links)) {
+      throw new ValidationError(
+        `OfferDetail.links: expected an array, got ${typeof dto.links}`
+      );
+    }
+    if (!Array.isArray(dto.faqs)) {
+      throw new ValidationError(
+        `OfferDetail.faqs: expected an array, got ${typeof dto.faqs}`
+      );
+    }
+    if (!Array.isArray(dto.milestones)) {
+      throw new ValidationError(
+        `OfferDetail.milestones: expected an array, got ${typeof dto.milestones}`
+      );
+    }
+    if (!Array.isArray(dto.tokens)) {
+      throw new ValidationError(
+        `OfferDetail.tokens: expected an array, got ${typeof dto.tokens}`
+      );
+    }
+    const swapContracts = dto.swap_contracts === void 0 ? [] : dto.swap_contracts;
+    if (!Array.isArray(swapContracts)) {
+      throw new ValidationError(
+        `OfferDetail.swap_contracts: expected an array, got ${typeof swapContracts}`
+      );
+    }
+    return {
+      id: OfferId(dto.id),
+      slug: OfferSlug(dto.slug),
+      type: dto.type,
+      name: dto.name,
+      asset: Asset.fromDto(dto.asset),
+      fundingAssets: dto.funding_assets.map(Asset.fromDto),
+      tokens: OfferToken.listFromDto(dto.tokens),
+      swapContracts: swapContracts.map(OfferSwapContract.fromDto),
+      about: notBlankStringOrNull(dto.about),
+      tagline: dto.tagline,
+      bannerUrl: dto.banner_url,
+      logoUrl: dto.logo_url,
+      category: dto.category,
+      startsAt: new Date(dto.starts_at),
+      endsAt: dto.ends_at ? new Date(dto.ends_at) : null,
+      faqs: dto.faqs.map(FaqItem.fromDto),
+      links: dto.links.map(Link.fromDto),
+      milestones: dto.milestones.map(Milestone.fromDto),
+      options: dto.options.map(OfferOption.fromDto),
+      terms: dto.terms.map(TermItem.fromDto)
+    };
+  }
+};
+var OfferOption = {
   fromDto: (dto) => ({
-    inputAmount: parseUint256(
-      BigInt(dto.pay_input_amount),
-      "SwapPreview.pay_input_amount"
-    ),
-    fee: parseUint256(BigInt(dto.fee), "SwapPreview.fee"),
-    outputAmount: parseUint256(
-      BigInt(dto.receive_output_amount),
-      "SwapPreview.receive_output_amount"
-    )
+    id: OfferOptionId(dto.id),
+    slug: OfferOptionSlug(dto.slug),
+    bidIncrement: dto.bid_increment,
+    floorPriceUsd: dto.floor_price_usd,
+    minimumPurchaseUsd: dto.minimum_purchase_usd,
+    priceUsd: dto.price_usd,
+    saleAgreementUrl: notBlankStringOrNull(dto.sale_agreement_url),
+    totalTokenSupply: dto.total_token_supply
   })
 };
-var SwapStatus = {
+var FaqItem = {
   fromDto: (dto) => ({
-    stopped: parseUint256(BigInt(dto.stopped), "SwapStatus.stopped"),
-    swapLevel: parseUint256(BigInt(dto.swap_level), "SwapStatus.swap_level")
+    question: notBlankStringOrNull(dto.question),
+    answer: notBlankStringOrNull(dto.answer)
   })
 };
-var TokenAllowance = {
+var Link = {
   fromDto: (dto) => ({
-    allowance: parseUint256(BigInt(dto.allowance), "TokenAllowance.allowance")
+    label: notBlankStringOrNull(dto.label),
+    url: notBlankStringOrNull(dto.url)
   })
 };
-var TokenBalance = {
+var TermItem = {
   fromDto: (dto) => ({
-    balance: parseUint256(BigInt(dto.balance), "TokenBalance.balance")
+    key: notBlankStringOrNull(dto.key),
+    value: notBlankStringOrNull(dto.value)
   })
 };
-var AllowWalletResponse = {
-  fromDto: (dto) => {
-    switch (dto.action) {
-      case "broadcast_transaction":
-        return {
-          action: "broadcast_transaction",
-          to: EvmContractAddress(dto.to),
-          data: HexEncodedTransactionData(dto.data)
-        };
-      case "none":
-        return {
-          action: "none",
-          alreadyAllowed: dto.already_allowed
-        };
-      default: {
-        const _exhaustive = dto;
-        return _exhaustive;
-      }
+var Milestone = {
+  fromDto: (dto) => ({
+    name: notBlankStringOrNull(dto.name),
+    schedule: notBlankStringOrNull(dto.schedule),
+    status: dto.status
+  })
+};
+
+// src/universal/types/providers/coin-list/token-sale.ts
+var ParticipationId = (value) => value;
+var Blockchain = (value) => value;
+var WalletAddress = (value) => value;
+var ParticipationsPaginationParams = {
+  toQueryParams: (params) => {
+    const queryParams = PaginationParams.toQueryParams(params);
+    if (params.offerId) {
+      queryParams["filters[0][field]"] = "offer_id";
+      queryParams["filters[0][op]"] = "==";
+      queryParams["filters[0][value]"] = params.offerId;
     }
+    return queryParams;
+  }
+};
+var Participation = {
+  /** Maps API DTO shape into the SDK participation domain model. */
+  fromDto: (dto) => {
+    const walletAddress = notBlankStringOrNull(dto.wallet_address);
+    return {
+      id: ParticipationId(dto.id),
+      offerId: OfferId(dto.offer_id),
+      offerOptionId: OfferOptionId(dto.offer_option_id),
+      status: dto.status,
+      amount: dto.amount,
+      displayAmount: dto.amount_string,
+      asset: Asset.fromDto(dto.asset),
+      chain: Blockchain(dto.chain),
+      insertedAt: dto.inserted_at ? new Date(dto.inserted_at) : null,
+      updatedAt: dto.updated_at ? new Date(dto.updated_at) : null,
+      walletAddress: walletAddress ? WalletAddress(walletAddress) : null
+    };
   }
 };
+var CreateParticipationParams = {
+  /** Maps participation creation params into API DTO payload. */
+  toDto: (params) => ({
+    offer_id: params.offerId,
+    offer_option_id: params.offerOptionId,
+    chain: params.chain,
+    wallet_address: params.walletAddress,
+    amount: params.amount,
+    asset_id: params.assetId,
+    approval_transaction_hash: params.approvalTransactionHash
+  })
+};
 
-// src/shared/api/frontline/providers/superstate/swap.ts
-async function getSwapAuthorization(api, params) {
-  const dto = await api.send({
-    method: "GET",
-    url: "/v1/wallet/authorized",
-    queryParams: {
-      chain: params.chain,
-      contract_address: params.contractAddress,
-      wallet_address: params.walletAddress
-    },
-    attributes: Attributes.protected()
-  });
-  return SwapAuthorization.fromDto(dto);
-}
-async function getSwapOutputToken(api, params) {
-  const dto = await api.send({
-    method: "GET",
-    url: "/v1/swap/output-token",
-    queryParams: {
-      chain: params.chain,
-      contract_address: params.contractAddress
-    },
-    attributes: Attributes.protected()
-  });
-  return toErc20Asset(dto);
-}
-async function getSwapPreview(api, params) {
-  const dto = await api.send({
-    method: "GET",
-    url: "/v1/swap/preview",
-    queryParams: {
-      chain: params.chain,
-      contract_address: params.contractAddress,
-      input_token: params.inputToken,
-      amount: params.amount.toString()
-    },
-    attributes: Attributes.protected()
-  });
-  return SwapPreview.fromDto(dto);
-}
-async function getSwapStatus(api, params) {
-  const dto = await api.send({
-    method: "GET",
-    url: "/v1/swap/status",
-    queryParams: {
-      chain: params.chain,
-      contract_address: params.contractAddress
-    },
-    attributes: Attributes.protected()
-  });
-  return SwapStatus.fromDto(dto);
+// src/universal/api/frontline/providers/coin-list/token-sale.ts
+async function fetchParticipations(api, offerId) {
+  return fetchAllPages(
+    (params) => fetchParticipationsPage(api, params),
+    { offerId }
+  );
 }
-async function getTokenAllowance(api, params) {
-  const dto = await api.send({
+async function fetchParticipationsPage(api, params) {
+  const pageDto = await api.send({
     method: "GET",
-    url: "/v1/token/allowance",
-    queryParams: {
-      chain: params.chain,
-      token_address: params.tokenAddress,
-      owner: params.owner,
-      spender: params.spender
-    },
+    url: "/v1/participations",
+    queryParams: ParticipationsPaginationParams.toQueryParams(params),
     attributes: Attributes.protected()
   });
-  return TokenAllowance.fromDto(dto);
+  return PaginatedResponse.fromDto(pageDto, Participation.fromDto);
 }
-async function getTokenBalance(api, params) {
+async function fetchParticipation(api, id) {
   const dto = await api.send({
     method: "GET",
-    url: "/v1/token/balance",
-    queryParams: {
-      chain: params.chain,
-      token_address: params.tokenAddress,
-      owner: params.owner
-    },
+    url: `/v1/participations/${id}`,
     attributes: Attributes.protected()
   });
-  return TokenBalance.fromDto(dto);
+  return Participation.fromDto(dto);
 }
-async function allowWallet(api, params) {
+async function createParticipation(api, params) {
   const dto = await api.send({
     method: "POST",
-    url: `/v1/offers/${encodeURIComponent(params.offerId)}/allow-wallet`,
-    body: {
-      wallet_address: params.walletAddress,
-      chain: params.chain,
-      signature: params.signature
-    },
+    url: "/v1/participations",
+    body: CreateParticipationParams.toDto(params),
     attributes: Attributes.protected()
   });
-  return AllowWalletResponse.fromDto(dto);
-}
-function toErc20Asset(dto) {
-  return {
-    name: dto.name,
-    symbol: AssetSymbol(dto.symbol),
-    decimals: AssetDecimals(dto.decimals)
-  };
+  return Participation.fromDto(dto);
 }
 
-// src/shared/core/observability/log-cause.ts
+// src/universal/core/shared/observability/log-cause.ts
 function classifyLogCause(error) {
   if (error instanceof HttpError) {
     return httpCause(error);
@@ -606,7 +713,7 @@ function apiErrorEventId(error) {
   return typeof eventId === "string" ? eventId : null;
 }
 
-// src/shared/core/observability/internal-logger.ts
+// src/universal/core/shared/observability/internal-logger.ts
 function internalLogger(logger, scope) {
   return logger ? scopedLogger(logger, scope, {}) : noopInternalLogger;
 }
@@ -689,27 +796,47 @@ var noopInternalLogger = {
   wrap: (_op, _params, run) => run()
 };
 
-// src/shared/core/blockchain/erc20/erc20-namespace.ts
-var Erc20NamespaceImpl = class {
+// src/universal/core/checkout/coin-list/token-sale-namespace.ts
+var CoinListTokenSaleNamespaceImpl = class {
   constructor(ctx) {
     this.ctx = ctx;
-    this.log = internalLogger(ctx.logger, "ERC20");
+    this.log = internalLogger(ctx.logger, "TOKEN_SALE");
   }
-  async getAllowance(params) {
-    return this.log.wrap("getAllowance", params, async () => {
+  async list(offerId) {
+    return this.log.wrap("list", offerId, async () => {
       await this.ctx.ensureUserAuthenticated();
-      return getTokenAllowance(this.ctx.api, params);
+      return fetchParticipations(this.ctx.api, offerId);
     });
   }
-  async getBalance(params) {
-    return this.log.wrap("getBalance", params, async () => {
+  async listPage(params) {
+    return this.log.wrap("listPage", params, async () => {
       await this.ctx.ensureUserAuthenticated();
-      return getTokenBalance(this.ctx.api, params);
+      return fetchParticipationsPage(this.ctx.api, params);
+    });
+  }
+  async get(id) {
+    return this.log.wrap("get", id, async () => {
+      await this.ctx.ensureUserAuthenticated();
+      return fetchParticipation(this.ctx.api, id);
+    });
+  }
+  async createParticipation(params) {
+    return this.log.wrap("createParticipation", params, async () => {
+      await this.ctx.ensureUserAuthenticated();
+      return createParticipation(this.ctx.api, params);
     });
   }
 };
 
-// src/shared/core/blockchain/formatters.ts
+// src/universal/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/universal/core/shared/blockchain/formatters.ts
 import { formatUnits } from "viem";
 function shortenAddress(address) {
   const short = address.length > 10 ? `${address.slice(0, 6)}\u2026${address.slice(-4)}` : address;
@@ -804,411 +931,120 @@ function formattedUsdPrice(amount, locale) {
   );
 }
 
-// src/shared/core/blockchain/math.ts
-import { parseUnits } from "viem";
-function blockchainAmountFromRawOrThrow({
-  label,
-  raw,
-  decimals
-}) {
-  const trimmed = raw.trim();
-  if (trimmed === "") {
-    throw new ValidationError(`${label}: not a uint256 integer ("${raw}")`);
-  }
-  let value;
-  try {
-    value = BigInt(trimmed);
-  } catch {
-    throw new ValidationError(`${label}: not a uint256 integer ("${raw}")`);
-  }
-  try {
-    return BlockchainAmount({ raw: assertUint256(value), decimals });
-  } catch {
-    throw new ValidationError(`${label}: out of uint256 bounds (${value})`);
-  }
+// src/universal/core/shared/blockchain/chain.ts
+var CHAIN_IDS = {
+  ethereum_mainnet: 1,
+  ethereum_sepolia: 11155111,
+  base_mainnet: 8453,
+  base_sepolia: 84532
+};
+function getChainId(chain) {
+  return CHAIN_IDS[chain];
 }
-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 {
-    const raw = parseUnits(trimmed, decimals);
-    if (raw > MAX_UINT_256) {
-      return { valid: false, reason: { type: "overflow" } };
-    }
-    return {
-      valid: true,
-      amount: BlockchainAmount({ raw, decimals })
-    };
-  } catch {
-    return { valid: false, reason: { type: "invalid-format" } };
+function chainFromId(chainId) {
+  const chains = Object.keys(CHAIN_IDS);
+  const chain = chains.find((c) => String(CHAIN_IDS[c]) === chainId);
+  if (!chain) {
+    throw new ValidationError(`Unsupported EIP-155 chain id: "${chainId}"`);
   }
+  return chain;
 }
-
-// src/shared/types/pagination.ts
-var Cursor = (value) => value;
-var PaginatedResponse = {
-  fromDto: (dto, itemMapper) => ({
-    data: dto.data.map(itemMapper),
-    startingAfter: dto.starting_after ? Cursor(dto.starting_after) : null,
-    startingBefore: dto.starting_before ? Cursor(dto.starting_before) : null
-  })
-};
-var PaginationParams = {
-  toQueryParams: (params) => {
-    const queryParams = {};
-    if (params.after) {
-      queryParams.starting_after = params.after;
-    }
-    if (params.before) {
-      queryParams.starting_before = params.before;
-    }
-    if (params.limit) {
-      queryParams.limit = params.limit;
-    }
-    return queryParams;
-  }
-};
-
-// src/shared/types/asset.ts
-var AssetId = (value) => value;
-var AssetCode = (value) => value;
-var Asset = {
-  fromDto: (dto) => ({
-    id: AssetId(dto.id),
-    code: AssetCode(dto.code),
-    name: dto.name,
-    fractionalDigits: dto.fractional_digits
-  })
-};
-
-// src/shared/types/offer.ts
-var OfferId = (value) => value;
-var OfferSlug = (value) => value;
-var Offer = {
-  fromDto: (dto) => {
-    if (!Array.isArray(dto.tokens)) {
-      throw new ValidationError(
-        `Offer.tokens: expected an array, got ${typeof dto.tokens}`
-      );
+function getNetworkName(chain) {
+  switch (chain) {
+    case "ethereum_mainnet":
+      return "Ethereum";
+    case "ethereum_sepolia":
+      return "Ethereum Sepolia";
+    case "base_mainnet":
+      return "Base";
+    case "base_sepolia":
+      return "Base Sepolia";
+    default: {
+      const _exhaustive = chain;
+      return _exhaustive;
     }
-    return {
-      id: OfferId(dto.id),
-      slug: OfferSlug(dto.slug),
-      type: dto.type,
-      tagline: dto.tagline,
-      bannerUrl: dto.banner_url,
-      logoUrl: dto.logo_url,
-      startsAt: new Date(dto.starts_at),
-      endsAt: dto.ends_at ? new Date(dto.ends_at) : null,
-      tokens: dto.tokens.map(OfferToken.fromDto)
-    };
   }
-};
-var OfferToken = {
-  fromDto: (dto) => ({
-    role: dto.role,
-    chain: Chain(dto.chain),
-    address: EvmContractAddress(dto.address)
-  })
-};
-
-// src/shared/core/utils/crypto.ts
-async function sha256(data) {
-  const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
-  const buffer = bytes.buffer.slice(
-    bytes.byteOffset,
-    bytes.byteOffset + bytes.byteLength
-  );
-  return crypto.subtle.digest("SHA-256", buffer);
 }
-function arrayBufferToBase64Url(buffer, padding = true) {
-  const bytes = new Uint8Array(buffer);
-  let binary = "";
-  for (let i = 0; i < bytes.length; i++) {
-    binary += String.fromCharCode(bytes[i]);
-  }
-  let base64 = btoa(binary);
-  base64 = base64.replace(/\+/g, "-").replace(/\//g, "_");
-  if (!padding) {
-    base64 = base64.replace(/=+$/, "");
-  }
-  return base64;
-}
-function generateSecureRandomBase64Url(byteLength) {
-  const bytes = new Uint8Array(byteLength);
-  crypto.getRandomValues(bytes);
-  const buffer = bytes.buffer;
-  return arrayBufferToBase64Url(buffer, false);
-}
-function getUUIDv4() {
-  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
-    return crypto.randomUUID();
-  }
-  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
-    const bytes = new Uint8Array(16);
-    crypto.getRandomValues(bytes);
-    bytes[6] = bytes[6] & 15 | 64;
-    bytes[8] = bytes[8] & 63 | 128;
-    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0"));
-    return `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(6, 8).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10, 16).join("")}`;
-  }
-  return `${Date.now()}-${Math.random().toString(36).slice(2, 12)}`;
+function txExplorerUrl(chain, txHash) {
+  return TxExplorerUrl(`${explorerBaseUrl(chain)}/tx/${txHash}`);
 }
-function notBlankStringOrNull(value) {
-  if (value?.trim()) {
-    return value;
-  } else {
-    return null;
+function explorerBaseUrl(chain) {
+  switch (chain) {
+    case "ethereum_mainnet":
+      return "https://etherscan.io";
+    case "ethereum_sepolia":
+      return "https://sepolia.etherscan.io";
+    case "base_mainnet":
+      return "https://basescan.org";
+    case "base_sepolia":
+      return "https://sepolia-explorer.base.org";
+    default: {
+      const _exhaustive = chain;
+      return _exhaustive;
+    }
   }
 }
 
-// src/shared/types/offer-detail.ts
-var OfferOptionId = (value) => value;
-var OfferOptionSlug = (value) => value;
-var OfferSwapContract = {
-  fromDto: (dto) => ({
-    chain: Chain(dto.chain),
-    address: EvmContractAddress(dto.address)
-  })
-};
-var OfferDetail = {
-  fromDto: (dto) => {
-    if (!Array.isArray(dto.funding_assets)) {
-      throw new ValidationError(
-        `OfferDetail.funding_assets: expected an array, got ${typeof dto.funding_assets}`
-      );
-    }
-    if (!Array.isArray(dto.options)) {
-      throw new ValidationError(
-        `OfferDetail.options: expected an array, got ${typeof dto.options}`
-      );
-    }
-    if (!Array.isArray(dto.terms)) {
-      throw new ValidationError(
-        `OfferDetail.terms: expected an array, got ${typeof dto.terms}`
-      );
-    }
-    if (!Array.isArray(dto.links)) {
-      throw new ValidationError(
-        `OfferDetail.links: expected an array, got ${typeof dto.links}`
-      );
-    }
-    if (!Array.isArray(dto.faqs)) {
-      throw new ValidationError(
-        `OfferDetail.faqs: expected an array, got ${typeof dto.faqs}`
-      );
-    }
-    if (!Array.isArray(dto.milestones)) {
-      throw new ValidationError(
-        `OfferDetail.milestones: expected an array, got ${typeof dto.milestones}`
-      );
-    }
-    if (!Array.isArray(dto.tokens)) {
-      throw new ValidationError(
-        `OfferDetail.tokens: expected an array, got ${typeof dto.tokens}`
-      );
-    }
-    const swapContracts = dto.swap_contracts === void 0 ? [] : dto.swap_contracts;
-    if (!Array.isArray(swapContracts)) {
-      throw new ValidationError(
-        `OfferDetail.swap_contracts: expected an array, got ${typeof swapContracts}`
-      );
-    }
-    return {
-      id: OfferId(dto.id),
-      slug: OfferSlug(dto.slug),
-      type: dto.type,
-      name: dto.name,
-      asset: Asset.fromDto(dto.asset),
-      fundingAssets: dto.funding_assets.map(Asset.fromDto),
-      tokens: dto.tokens.map(OfferToken.fromDto),
-      swapContracts: swapContracts.map(OfferSwapContract.fromDto),
-      about: notBlankStringOrNull(dto.about),
-      tagline: dto.tagline,
-      bannerUrl: dto.banner_url,
-      logoUrl: dto.logo_url,
-      category: dto.category,
-      startsAt: new Date(dto.starts_at),
-      endsAt: dto.ends_at ? new Date(dto.ends_at) : null,
-      faqs: dto.faqs.map(FaqItem.fromDto),
-      links: dto.links.map(Link.fromDto),
-      milestones: dto.milestones.map(Milestone.fromDto),
-      options: dto.options.map(OfferOption.fromDto),
-      terms: dto.terms.map(TermItem.fromDto)
-    };
+// src/universal/core/shared/blockchain/math.ts
+import { parseUnits } from "viem";
+function blockchainAmountFromRawOrThrow({
+  label,
+  raw,
+  decimals
+}) {
+  const trimmed = raw.trim();
+  if (trimmed === "") {
+    throw new ValidationError(`${label}: not a uint256 integer ("${raw}")`);
   }
-};
-var OfferOption = {
-  fromDto: (dto) => ({
-    id: OfferOptionId(dto.id),
-    slug: OfferOptionSlug(dto.slug),
-    bidIncrement: dto.bid_increment,
-    floorPriceUsd: dto.floor_price_usd,
-    minimumPurchaseUsd: dto.minimum_purchase_usd,
-    priceUsd: dto.price_usd,
-    saleAgreementUrl: notBlankStringOrNull(dto.sale_agreement_url),
-    totalTokenSupply: dto.total_token_supply
-  })
-};
-var FaqItem = {
-  fromDto: (dto) => ({
-    question: notBlankStringOrNull(dto.question),
-    answer: notBlankStringOrNull(dto.answer)
-  })
-};
-var Link = {
-  fromDto: (dto) => ({
-    label: notBlankStringOrNull(dto.label),
-    url: notBlankStringOrNull(dto.url)
-  })
-};
-var TermItem = {
-  fromDto: (dto) => ({
-    key: notBlankStringOrNull(dto.key),
-    value: notBlankStringOrNull(dto.value)
-  })
-};
-var Milestone = {
-  fromDto: (dto) => ({
-    name: notBlankStringOrNull(dto.name),
-    schedule: notBlankStringOrNull(dto.schedule),
-    status: dto.status
-  })
-};
-
-// src/shared/types/providers/coin-list/token-sale.ts
-var ParticipationId = (value) => value;
-var Blockchain = (value) => value;
-var WalletAddress = (value) => value;
-var ParticipationsPaginationParams = {
-  toQueryParams: (params) => {
-    const queryParams = PaginationParams.toQueryParams(params);
-    if (params.offerId) {
-      queryParams["filters[0][field]"] = "offer_id";
-      queryParams["filters[0][op]"] = "==";
-      queryParams["filters[0][value]"] = params.offerId;
-    }
-    return queryParams;
+  let value;
+  try {
+    value = BigInt(trimmed);
+  } catch {
+    throw new ValidationError(`${label}: not a uint256 integer ("${raw}")`);
   }
-};
-var Participation = {
-  /** Maps API DTO shape into the SDK participation domain model. */
-  fromDto: (dto) => {
-    const walletAddress = notBlankStringOrNull(dto.wallet_address);
-    return {
-      id: ParticipationId(dto.id),
-      offerId: OfferId(dto.offer_id),
-      offerOptionId: OfferOptionId(dto.offer_option_id),
-      status: dto.status,
-      amount: dto.amount,
-      displayAmount: dto.amount_string,
-      asset: Asset.fromDto(dto.asset),
-      chain: Blockchain(dto.chain),
-      insertedAt: dto.inserted_at ? new Date(dto.inserted_at) : null,
-      updatedAt: dto.updated_at ? new Date(dto.updated_at) : null,
-      walletAddress: walletAddress ? WalletAddress(walletAddress) : null
-    };
+  try {
+    return BlockchainAmount({ raw: assertUint256(value), decimals });
+  } catch {
+    throw new ValidationError(`${label}: out of uint256 bounds (${value})`);
   }
-};
-var CreateParticipationParams = {
-  /** Maps participation creation params into API DTO payload. */
-  toDto: (params) => ({
-    offer_id: params.offerId,
-    offer_option_id: params.offerOptionId,
-    chain: params.chain,
-    wallet_address: params.walletAddress,
-    amount: params.amount,
-    asset_id: params.assetId,
-    approval_transaction_hash: params.approvalTransactionHash
-  })
-};
-
-// src/shared/api/frontline/providers/coin-list/token-sale.ts
-async function fetchParticipations(api, offerId) {
-  return fetchAllPages(
-    (params) => fetchParticipationsPage(api, params),
-    { offerId }
-  );
-}
-async function fetchParticipationsPage(api, params) {
-  const pageDto = await api.send({
-    method: "GET",
-    url: "/v1/participations",
-    queryParams: ParticipationsPaginationParams.toQueryParams(params),
-    attributes: Attributes.protected()
-  });
-  return PaginatedResponse.fromDto(pageDto, Participation.fromDto);
-}
-async function fetchParticipation(api, id) {
-  const dto = await api.send({
-    method: "GET",
-    url: `/v1/participations/${id}`,
-    attributes: Attributes.protected()
-  });
-  return Participation.fromDto(dto);
 }
-async function createParticipation(api, params) {
-  const dto = await api.send({
-    method: "POST",
-    url: "/v1/participations",
-    body: CreateParticipationParams.toDto(params),
-    attributes: Attributes.protected()
-  });
-  return Participation.fromDto(dto);
-}
-
-// src/shared/core/checkout/coin-list/token-sale-namespace.ts
-var CoinListTokenSaleNamespaceImpl = class {
-  constructor(ctx) {
-    this.ctx = ctx;
-    this.log = internalLogger(ctx.logger, "TOKEN_SALE");
-  }
-  async list(offerId) {
-    return this.log.wrap("list", offerId, async () => {
-      await this.ctx.ensureUserAuthenticated();
-      return fetchParticipations(this.ctx.api, offerId);
-    });
+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" } };
   }
-  async listPage(params) {
-    return this.log.wrap("listPage", params, async () => {
-      await this.ctx.ensureUserAuthenticated();
-      return fetchParticipationsPage(this.ctx.api, params);
-    });
+  if (/[eE]/.test(trimmed)) {
+    return { valid: false, reason: { type: "invalid-format" } };
   }
-  async get(id) {
-    return this.log.wrap("get", id, async () => {
-      await this.ctx.ensureUserAuthenticated();
-      return fetchParticipation(this.ctx.api, id);
-    });
+  if (!/^\d+(\.\d+)?$/.test(trimmed)) {
+    return { valid: false, reason: { type: "invalid-format" } };
   }
-  async createParticipation(params) {
-    return this.log.wrap("createParticipation", params, async () => {
-      await this.ctx.ensureUserAuthenticated();
-      return createParticipation(this.ctx.api, params);
-    });
+  const [, fraction = ""] = trimmed.split(".");
+  if (fraction.length > decimals) {
+    return {
+      valid: false,
+      reason: { type: "too-many-decimals", maxDecimals: decimals }
+    };
   }
-};
+  try {
+    const raw = parseUnits(trimmed, decimals);
+    if (raw > MAX_UINT_256) {
+      return { valid: false, reason: { type: "overflow" } };
+    }
+    return {
+      valid: true,
+      amount: BlockchainAmount({ raw, decimals })
+    };
+  } catch {
+    return { valid: false, reason: { type: "invalid-format" } };
+  }
+}
 
-// src/shared/types/trading.ts
+// src/universal/types/trading.ts
 var Ticker = (value) => value;
 
-// src/shared/types/providers/ondo/ondo.ts
+// src/universal/types/providers/ondo/ondo.ts
 var OndoTradingStatus = {
   fromDto: (dto) => {
     if (!dto.tradable) return { type: "not-tradable", side: dto.side };
@@ -1374,7 +1210,7 @@ function parseExpiresAt(value) {
   return date;
 }
 
-// src/shared/api/frontline/providers/ondo/ondo.ts
+// src/universal/api/frontline/providers/ondo/ondo.ts
 async function getOndoTradingStatus(api, params) {
   const dto = await api.send({
     method: "GET",
@@ -1469,7 +1305,7 @@ function sizeParam(params) {
   return { notional_value: notionalValue };
 }
 
-// src/shared/core/checkout/ondo/ondo-namespace.ts
+// src/universal/core/checkout/ondo/ondo-namespace.ts
 var OndoNamespaceImpl = class {
   constructor(ctx) {
     this.ctx = ctx;
@@ -1501,7 +1337,164 @@ var OndoNamespaceImpl = class {
   }
 };
 
-// src/shared/core/checkout/superstate/swap-namespace.ts
+// src/universal/types/providers/superstate/swap.ts
+var SwapAuthorization = {
+  fromDto: (dto) => ({
+    authorized: dto.authorized
+  })
+};
+var SwapPreview = {
+  fromDto: (dto) => ({
+    inputAmount: parseUint256(
+      BigInt(dto.pay_input_amount),
+      "SwapPreview.pay_input_amount"
+    ),
+    fee: parseUint256(BigInt(dto.fee), "SwapPreview.fee"),
+    outputAmount: parseUint256(
+      BigInt(dto.receive_output_amount),
+      "SwapPreview.receive_output_amount"
+    )
+  })
+};
+var SwapStatus = {
+  fromDto: (dto) => ({
+    stopped: parseUint256(BigInt(dto.stopped), "SwapStatus.stopped"),
+    swapLevel: parseUint256(BigInt(dto.swap_level), "SwapStatus.swap_level")
+  })
+};
+var TokenAllowance = {
+  fromDto: (dto) => ({
+    allowance: parseUint256(BigInt(dto.allowance), "TokenAllowance.allowance")
+  })
+};
+var TokenBalance = {
+  fromDto: (dto) => ({
+    balance: parseUint256(BigInt(dto.balance), "TokenBalance.balance")
+  })
+};
+var AllowWalletResponse = {
+  fromDto: (dto) => {
+    switch (dto.action) {
+      case "broadcast_transaction":
+        return {
+          action: "broadcast_transaction",
+          to: EvmContractAddress(dto.to),
+          data: HexEncodedTransactionData(dto.data)
+        };
+      case "none":
+        return {
+          action: "none",
+          alreadyAllowed: dto.already_allowed
+        };
+      default: {
+        const _exhaustive = dto;
+        return _exhaustive;
+      }
+    }
+  }
+};
+
+// src/universal/api/frontline/providers/superstate/swap.ts
+async function getSwapAuthorization(api, params) {
+  const dto = await api.send({
+    method: "GET",
+    url: "/v1/wallet/authorized",
+    queryParams: {
+      chain: params.chain,
+      contract_address: params.contractAddress,
+      wallet_address: params.walletAddress
+    },
+    attributes: Attributes.protected()
+  });
+  return SwapAuthorization.fromDto(dto);
+}
+async function getSwapOutputToken(api, params) {
+  const dto = await api.send({
+    method: "GET",
+    url: "/v1/swap/output-token",
+    queryParams: {
+      chain: params.chain,
+      contract_address: params.contractAddress
+    },
+    attributes: Attributes.protected()
+  });
+  return toErc20Asset(dto);
+}
+async function getSwapPreview(api, params) {
+  const dto = await api.send({
+    method: "GET",
+    url: "/v1/swap/preview",
+    queryParams: {
+      chain: params.chain,
+      contract_address: params.contractAddress,
+      input_token: params.inputToken,
+      amount: params.amount.toString()
+    },
+    attributes: Attributes.protected()
+  });
+  return SwapPreview.fromDto(dto);
+}
+async function getSwapStatus(api, params) {
+  const dto = await api.send({
+    method: "GET",
+    url: "/v1/swap/status",
+    queryParams: {
+      chain: params.chain,
+      contract_address: params.contractAddress
+    },
+    attributes: Attributes.protected()
+  });
+  return SwapStatus.fromDto(dto);
+}
+async function getTokenAllowance(api, params) {
+  const dto = await api.send({
+    method: "GET",
+    url: "/v1/token/allowance",
+    queryParams: {
+      chain: params.chain,
+      token_address: params.tokenAddress,
+      owner: params.owner,
+      spender: params.spender
+    },
+    attributes: Attributes.protected()
+  });
+  return TokenAllowance.fromDto(dto);
+}
+async function getTokenBalance(api, params) {
+  const dto = await api.send({
+    method: "GET",
+    url: "/v1/token/balance",
+    queryParams: {
+      chain: params.chain,
+      token_address: params.tokenAddress,
+      owner: params.owner
+    },
+    attributes: Attributes.protected()
+  });
+  return TokenBalance.fromDto(dto);
+}
+async function allowWallet(api, params) {
+  const dto = await api.send({
+    method: "POST",
+    url: `/v1/offers/${encodeURIComponent(params.offerId)}/allow-wallet`,
+    body: {
+      wallet_address: params.walletAddress,
+      chain: params.chain,
+      signature: params.signature
+    },
+    attributes: Attributes.protected()
+  });
+  return AllowWalletResponse.fromDto(dto);
+}
+function toErc20Asset(dto) {
+  return {
+    name: dto.name,
+    symbol: AssetSymbol(dto.symbol),
+    decimals: AssetDecimals(dto.decimals)
+  };
+}
+
+// src/universal/core/checkout/superstate/swap-namespace.ts
 var SuperstateSwapNamespaceImpl = class {
   constructor(ctx) {
     this.ctx = ctx;
@@ -1539,7 +1532,7 @@ var SuperstateSwapNamespaceImpl = class {
   }
 };
 
-// src/shared/types/document-submission.ts
+// src/universal/types/document-submission.ts
 var DocumentSubmission = {
   fromDto: (dto) => ({
     status: dto.status,
@@ -1547,14 +1540,14 @@ var DocumentSubmission = {
   })
 };
 
-// src/shared/types/kyc.ts
+// src/universal/types/kyc.ts
 var KycToken = {
   fromDto: (dto) => ({
     token: dto.token
   })
 };
 
-// src/shared/types/pii.ts
+// src/universal/types/pii.ts
 var Iso2CountryCode = (value) => value;
 var PiiJurisdiction = {
   fromDto: (dto) => ({
@@ -1582,7 +1575,7 @@ var Pii = {
   })
 };
 
-// src/shared/types/requirement.ts
+// src/universal/types/requirement.ts
 var RequirementId = (value) => value;
 var Requirement = {
   fromDto: (dto) => ({
@@ -1603,7 +1596,7 @@ var RequirementStatusInfo = {
   )
 };
 
-// src/shared/api/frontline/documents.ts
+// src/universal/api/frontline/documents.ts
 async function submitDocument(api, documentType, fields) {
   const dto = await api.send({
     method: "POST",
@@ -1614,7 +1607,7 @@ async function submitDocument(api, documentType, fields) {
   return DocumentSubmission.fromDto(dto);
 }
 
-// src/shared/api/frontline/kyc.ts
+// src/universal/api/frontline/kyc.ts
 async function createKycToken(api, levelName, reset) {
   const dto = await api.send({
     method: "POST",
@@ -1628,7 +1621,7 @@ async function createKycToken(api, levelName, reset) {
   return KycToken.fromDto(dto);
 }
 
-// src/shared/api/frontline/pii.ts
+// src/universal/api/frontline/pii.ts
 async function fetchPii(api) {
   const dto = await api.send({
     method: "GET",
@@ -1638,7 +1631,7 @@ async function fetchPii(api) {
   return Pii.fromDto(dto);
 }
 
-// src/shared/api/frontline/requirements.ts
+// src/universal/api/frontline/requirements.ts
 async function fetchOfferRequirements(api, offerId, clientCreds) {
   const response = await api.send({
     method: "GET",
@@ -1664,7 +1657,7 @@ async function fetchRequirementStatuses(api, offerId) {
   return RequirementStatusInfo.fromStatusesDto(response);
 }
 
-// src/shared/core/requirements/requirements-namespace.ts
+// src/universal/core/requirements/requirements-namespace.ts
 var RequirementsNamespaceImpl = class {
   constructor(ctx) {
     this.ctx = ctx;
@@ -1714,7 +1707,27 @@ var RequirementsNamespaceImpl = class {
   }
 };
 
-// src/shared/types/token-metadata.ts
+// src/universal/core/shared/blockchain/erc20/erc20-namespace.ts
+var Erc20NamespaceImpl = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+    this.log = internalLogger(ctx.logger, "ERC20");
+  }
+  async getAllowance(params) {
+    return this.log.wrap("getAllowance", params, async () => {
+      await this.ctx.ensureUserAuthenticated();
+      return getTokenAllowance(this.ctx.api, params);
+    });
+  }
+  async getBalance(params) {
+    return this.log.wrap("getBalance", params, async () => {
+      await this.ctx.ensureUserAuthenticated();
+      return getTokenBalance(this.ctx.api, params);
+    });
+  }
+};
+
+// src/universal/types/token-metadata.ts
 var TokenLogoUrl = (value) => value;
 var TokenLogo = {
   /** `baseUrl` is the registry origin; registry URLs are root-relative. */
@@ -1797,10 +1810,10 @@ var resolveLogoUrl = (url, baseUrl) => TokenLogoUrl(
   url.startsWith("http") ? url : `${baseUrl.replace(/\/$/, "")}${url}`
 );
 
-// src/shared/api/nabu/tokens.ts
+// src/universal/api/nabu/tokens.ts
 import { getAddress } from "viem";
 
-// src/shared/api/frontline/config.ts
+// src/universal/api/frontline/config.ts
 var PUBLIC_API_BASE_URL = "https://api.coinlist.co";
 var HEADER_API_VERSION = "X-API-Version";
 var HEADER_USER_AGENT = "User-Agent";
@@ -1813,7 +1826,7 @@ var VERIFY_IDENTITY_PATH = "/verify-identity";
 var VERIFY_IDENTITY_ACCREDITATION_PATH = "/verify-identity/accreditation_full";
 var WALLET_PATH = "/wallet";
 
-// src/shared/api/http-client.ts
+// src/universal/api/http-client.ts
 var HttpClient = class {
   constructor(config, middleware = {}, logger = null, options = {}) {
     this.config = config;
@@ -1969,7 +1982,7 @@ function describeRequestUnredacted(request) {
   };
 }
 
-// src/shared/api/nabu/tokens.ts
+// src/universal/api/nabu/tokens.ts
 function createNabuApiClient(baseUrl, logger = null) {
   return new HttpClient({ baseUrl }, {}, logger);
 }
@@ -2060,10 +2073,10 @@ function checksummed(address) {
   }
 }
 
-// src/shared/core/tokens/tokens-namespace.ts
+// src/universal/core/tokens/tokens-namespace.ts
 var TokensNamespaceImpl = class {
   /**
-   * Takes the registry origin rather than a `SharedNamespaceContext`: the
+   * Takes the registry origin rather than a `UniversalNamespaceContext`: the
    * registry is unauthenticated and on its own host, so the frontline sender
    * and the auth check would both be dead weight here.
    */
@@ -2087,7 +2100,7 @@ var TokensNamespaceImpl = class {
   }
 };
 
-// src/shared/types/offer-option-address.ts
+// src/universal/types/offer-option-address.ts
 var OfferOptionAddressId = (value) => value;
 var OfferOptionAddress = {
   /** Maps the API DTO into the SDK offer-option-address domain model. */
@@ -2109,7 +2122,7 @@ var ConnectExternalWalletParams = {
   })
 };
 
-// src/shared/types/wallet-ownership-challenge.ts
+// src/universal/types/wallet-ownership-challenge.ts
 var WalletOwnershipChallenge = {
   /** Maps the API DTO into the SDK wallet-ownership-challenge domain model. */
   fromDto: (dto) => ({
@@ -2148,7 +2161,7 @@ var CreateWalletOwnershipChallengeParams = {
   }
 };
 
-// src/shared/api/frontline/wallet-connect.ts
+// src/universal/api/frontline/wallet-connect.ts
 async function createWalletOwnershipChallenge(api, params) {
   const dto = await api.send({
     method: "POST",
@@ -2185,7 +2198,7 @@ async function removeOptionAddress(api, offerId, addressId) {
   return OfferOptionAddress.fromDto(dto);
 }
 
-// src/shared/core/wallets/wallets-namespace.ts
+// src/universal/core/wallets/wallets-namespace.ts
 var WalletsNamespaceImpl = class {
   constructor(ctx) {
     this.ctx = ctx;
@@ -2228,7 +2241,7 @@ var WalletsNamespaceImpl = class {
   }
 };
 
-// src/shared/types/oauth-session.ts
+// src/universal/types/oauth-session.ts
 var ClientCredentialsOAuth = (value) => value;
 var OAuthRefreshToken = (value) => value;
 var OAuthSession = {
@@ -2244,7 +2257,7 @@ var OAuthSession = {
   }
 };
 
-// src/shared/api/frontline/offers.ts
+// src/universal/api/frontline/offers.ts
 async function fetchOffers(api, clientCreds) {
   return fetchAllPages((params) => fetchOffersPage(api, params, clientCreds));
 }
@@ -2301,10 +2314,17 @@ export {
   internalLogger,
   HttpClient,
   fetchAllPages,
+  Cursor,
+  PaginatedResponse,
+  PaginationParams,
+  AssetId,
+  AssetCode,
+  Asset,
   ETHEREUM_CHAINS,
   EthereumChain,
   SOLANA_CHAINS,
   SolanaChain,
+  isChain,
   Chain,
   EvmWalletAddress,
   EvmContractAddress,
@@ -2321,40 +2341,6 @@ export {
   StablecoinSymbol,
   KnownAssetSymbol,
   Bps,
-  FormattedAmountUi,
-  FormattedPercentUi,
-  TxExplorerUrl,
-  ShortenedWalletAddress,
-  FormattedAmountAssetUi,
-  AssetIconUrl,
-  getChainId,
-  chainFromId,
-  getNetworkName,
-  txExplorerUrl,
-  SwapAuthorization,
-  SwapPreview,
-  SwapStatus,
-  TokenAllowance,
-  TokenBalance,
-  AllowWalletResponse,
-  Erc20NamespaceImpl,
-  shortenAddress,
-  formatAmount,
-  formatRawAmount,
-  formatCompactAmount,
-  formatBpsAsPercent,
-  usdAmount,
-  assetAmount,
-  NA_AMOUNT_ASSET_UI,
-  formattedUsdPrice,
-  blockchainAmountFromRawOrThrow,
-  parseBlockchainAmount,
-  Cursor,
-  PaginatedResponse,
-  PaginationParams,
-  AssetId,
-  AssetCode,
-  Asset,
   OfferId,
   OfferSlug,
   Offer,
@@ -2375,12 +2361,39 @@ export {
   Participation,
   CreateParticipationParams,
   CoinListTokenSaleNamespaceImpl,
+  FormattedAmountUi,
+  FormattedPercentUi,
+  TxExplorerUrl,
+  ShortenedWalletAddress,
+  FormattedAmountAssetUi,
+  AssetIconUrl,
+  shortenAddress,
+  formatAmount,
+  formatRawAmount,
+  formatCompactAmount,
+  formatBpsAsPercent,
+  usdAmount,
+  assetAmount,
+  NA_AMOUNT_ASSET_UI,
+  formattedUsdPrice,
+  getChainId,
+  chainFromId,
+  getNetworkName,
+  txExplorerUrl,
+  blockchainAmountFromRawOrThrow,
+  parseBlockchainAmount,
   Ticker,
   OndoTradingStatus,
   OndoQuote,
   OndoBuyTransaction,
   OndoSellTransaction,
   OndoNamespaceImpl,
+  SwapAuthorization,
+  SwapPreview,
+  SwapStatus,
+  TokenAllowance,
+  TokenBalance,
+  AllowWalletResponse,
   SuperstateSwapNamespaceImpl,
   fetchOffers,
   fetchOffersPage,
@@ -2396,6 +2409,7 @@ export {
   RequirementStatusInfo,
   fetchOfferRequirements,
   RequirementsNamespaceImpl,
+  Erc20NamespaceImpl,
   TokenLogoUrl,
   TokenLogo,
   TokenMetadata,
@@ -2410,4 +2424,4 @@ export {
   OAuthRefreshToken,
   OAuthSession
 };
-//# sourceMappingURL=chunk-3ATIDGVR.js.map
+//# sourceMappingURL=chunk-6CQHDASY.js.map