@coinlist-co/react 0.11.1-rc.e102bdb → 0.12.0

package/dist/server/index.cjs

@@ -30,7 +30,7 @@ __export(server_exports, {
 });
 module.exports = __toCommonJS(server_exports);
 
-// src/shared/api/http-attributes.ts
+// src/universal/api/http-attributes.ts
 var empty = {};
 var concat = (left, right) => ({
   ...left,
@@ -85,7 +85,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`);
@@ -209,13 +209,13 @@ var Request = {
   concatAttributes
 };
 
-// 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_IDEMPOTENCY_KEY = "Idempotency-Key";
 var API_VERSION = "2025-10-17";
 
-// src/shared/types/errors.ts
+// src/universal/types/errors.ts
 var NotImplementedError = class extends Error {
   constructor(message = "Not implemented yet") {
     super(message);
@@ -247,7 +247,7 @@ var MathError = class extends Error {
   }
 };
 
-// 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);
@@ -313,7 +313,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;
 }
@@ -396,7 +396,7 @@ var noopInternalLogger = {
   wrap: (_op, _params, run) => run()
 };
 
-// src/shared/api/http-client.ts
+// src/universal/api/http-client.ts
 var HttpClient = class {
   constructor(config, middleware = {}, logger = null, options = {}) {
     this.config = config;
@@ -552,7 +552,7 @@ function describeRequestUnredacted(request) {
   };
 }
 
-// src/shared/api/middleware/attach-session-middleware.ts
+// src/universal/api/middleware/attach-session-middleware.ts
 function attachSessionMiddleware(fetchAccessToken) {
   return async (request) => {
     if (!Attributes.isProtected(request.attributes)) {
@@ -578,7 +578,7 @@ function attachSessionMiddleware(fetchAccessToken) {
   };
 }
 
-// src/shared/core/utils/crypto.ts
+// src/universal/core/shared/utils/crypto.ts
 function getUUIDv4() {
   if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
     return crypto.randomUUID();
@@ -601,7 +601,7 @@ function notBlankStringOrNull(value) {
   }
 }
 
-// src/shared/api/middleware/idempotency-key.ts
+// src/universal/api/middleware/idempotency-key.ts
 var idempotencyKeyMiddleware = async (request) => {
   if (!Attributes.isIdempotent(request.attributes)) {
     return request;
@@ -619,7 +619,7 @@ var idempotencyKeyMiddleware = async (request) => {
   };
 };
 
-// src/shared/api/middleware/request-retry.ts
+// src/universal/api/middleware/request-retry.ts
 var MAX_ATTEMPTS = 3;
 var INITIAL_DELAY_MS = 300;
 var MAX_DELAY_MS = 2e3;
@@ -654,7 +654,7 @@ function defaultDelay(ms) {
 }
 var requestRetryMiddleware = createRequestRetryMiddleware();
 
-// src/shared/api/middleware/session-renewal.ts
+// src/universal/api/middleware/session-renewal.ts
 function renewSessionMiddleware(fetchAccessToken) {
   return async ({ request, response, retry }) => {
     if (response.status !== 401) {
@@ -679,7 +679,7 @@ function renewSessionMiddleware(fetchAccessToken) {
   };
 }
 
-// src/shared/api/authenticated-api-client.ts
+// src/universal/api/authenticated-api-client.ts
 var AuthenticatedApiClient = class {
   constructor(config, fetchAccessToken, additionalBeforeRequest = [], logger = null) {
     this.httpClient = new HttpClient(
@@ -723,7 +723,7 @@ var ApiClient = class {
   }
 };
 
-// src/server/errors.ts
+// src/server/shared/errors.ts
 var WritableSessionStoreRequiredError = class extends Error {
   constructor(message = "This operation requires a writable SessionStore. Provide a `setSession` implementation in your SessionStore to persist or clear OAuth sessions.") {
     super(message);
@@ -731,7 +731,7 @@ var WritableSessionStoreRequiredError = class extends Error {
   }
 };
 
-// src/shared/types/oauth-session.ts
+// src/universal/types/oauth-session.ts
 var ClientCredentialsOAuth = (value) => value;
 var OAuthRefreshToken = (value) => value;
 var OAuthSession = {
@@ -892,7 +892,7 @@ var ServerAuthNamespaceImpl = class {
   }
 };
 
-// src/shared/api/pagination.ts
+// src/universal/api/pagination.ts
 async function fetchAllPages(fetchPage, baseParams) {
   const items = [];
   let cursor = null;
@@ -908,7 +908,7 @@ async function fetchAllPages(fetchPage, baseParams) {
   return items;
 }
 
-// src/shared/types/blockchain/core.ts
+// src/universal/types/blockchain/core.ts
 var ETHEREUM_CHAINS = {
   ethereum_mainnet: true,
   ethereum_sepolia: true,
@@ -925,8 +925,9 @@ var SOLANA_CHAINS = {
   solana_mainnet: true,
   solana_devnet: true
 };
+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;
@@ -995,7 +996,7 @@ function combineAmounts(a, b, op) {
 }
 var AssetSymbol = (value) => value;
 
-// src/shared/types/offer.ts
+// src/universal/types/offer.ts
 var OfferId = (value) => value;
 var OfferSlug = (value) => value;
 var Offer = {
@@ -1014,7 +1015,7 @@ var Offer = {
       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)
+      tokens: OfferToken.listFromDto(dto.tokens)
     };
   }
 };
@@ -1023,10 +1024,22 @@ var OfferToken = {
     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/shared/types/asset.ts
+// src/universal/types/asset.ts
 var AssetId = (value) => value;
 var AssetCode = (value) => value;
 var Asset = {
@@ -1038,9 +1051,15 @@ var Asset = {
   })
 };
 
-// src/shared/types/offer-detail.ts
+// src/universal/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)) {
@@ -1078,6 +1097,12 @@ var OfferDetail = {
         `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),
@@ -1085,7 +1110,8 @@ var OfferDetail = {
       name: dto.name,
       asset: Asset.fromDto(dto.asset),
       fundingAssets: dto.funding_assets.map(Asset.fromDto),
-      tokens: dto.tokens.map(OfferToken.fromDto),
+      tokens: OfferToken.listFromDto(dto.tokens),
+      swapContracts: swapContracts.map(OfferSwapContract.fromDto),
       about: notBlankStringOrNull(dto.about),
       tagline: dto.tagline,
       bannerUrl: dto.banner_url,
@@ -1139,7 +1165,7 @@ var Milestone = {
   })
 };
 
-// src/shared/types/pagination.ts
+// src/universal/types/pagination.ts
 var Cursor = (value) => value;
 var PaginatedResponse = {
   fromDto: (dto, itemMapper) => ({
@@ -1164,7 +1190,7 @@ var PaginationParams = {
   }
 };
 
-// src/shared/api/frontline/offers.ts
+// src/universal/api/frontline/offers.ts
 async function fetchOffers(api, clientCreds) {
   return fetchAllPages((params) => fetchOffersPage(api, params, clientCreds));
 }
@@ -1219,7 +1245,7 @@ var ServerOffersNamespaceImpl = class {
   }
 };
 
-// src/shared/types/requirement.ts
+// src/universal/types/requirement.ts
 var RequirementId = (value) => value;
 var Requirement = {
   fromDto: (dto) => ({
@@ -1240,7 +1266,7 @@ var RequirementStatusInfo = {
   )
 };
 
-// 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",
@@ -1266,7 +1292,7 @@ async function fetchRequirementStatuses(api, offerId) {
   return RequirementStatusInfo.fromStatusesDto(response);
 }
 
-// src/shared/types/document-submission.ts
+// src/universal/types/document-submission.ts
 var DocumentSubmission = {
   fromDto: (dto) => ({
     status: dto.status,
@@ -1274,7 +1300,7 @@ var DocumentSubmission = {
   })
 };
 
-// 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",
@@ -1285,14 +1311,14 @@ async function submitDocument(api, documentType, fields) {
   return DocumentSubmission.fromDto(dto);
 }
 
-// src/shared/types/kyc.ts
+// src/universal/types/kyc.ts
 var KycToken = {
   fromDto: (dto) => ({
     token: dto.token
   })
 };
 
-// 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",
@@ -1306,7 +1332,7 @@ async function createKycToken(api, levelName, reset) {
   return KycToken.fromDto(dto);
 }
 
-// src/shared/types/pii.ts
+// src/universal/types/pii.ts
 var Iso2CountryCode = (value) => value;
 var PiiJurisdiction = {
   fromDto: (dto) => ({
@@ -1334,7 +1360,7 @@ var Pii = {
   })
 };
 
-// src/shared/api/frontline/pii.ts
+// src/universal/api/frontline/pii.ts
 async function fetchPii(api) {
   const dto = await api.send({
     method: "GET",
@@ -1344,7 +1370,7 @@ async function fetchPii(api) {
   return Pii.fromDto(dto);
 }
 
-// src/shared/core/requirements/requirements-namespace.ts
+// src/universal/core/requirements/requirements-namespace.ts
 var RequirementsNamespaceImpl = class {
   constructor(ctx) {
     this.ctx = ctx;
@@ -1412,187 +1438,10 @@ var ServerRequirementsNamespaceImpl = class extends RequirementsNamespaceImpl {
   }
 };
 
-// src/shared/api/nabu/config.ts
+// src/universal/api/nabu/config.ts
 var NABU_BASE_URL = "https://asset.coinlist.co";
 
-// src/shared/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/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);
-}
-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/shared/core/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/shared/types/providers/coin-list/token-sale.ts
+// src/universal/types/providers/coin-list/token-sale.ts
 var ParticipationId = (value) => value;
 var Blockchain = (value) => value;
 var WalletAddress = (value) => value;
@@ -1639,7 +1488,7 @@ var CreateParticipationParams = {
   })
 };
 
-// src/shared/api/frontline/providers/coin-list/token-sale.ts
+// src/universal/api/frontline/providers/coin-list/token-sale.ts
 async function fetchParticipations(api, offerId) {
   return fetchAllPages(
     (params) => fetchParticipationsPage(api, params),
@@ -1673,7 +1522,7 @@ async function createParticipation(api, params) {
   return Participation.fromDto(dto);
 }
 
-// src/shared/core/checkout/coin-list/token-sale-namespace.ts
+// src/universal/core/checkout/coin-list/token-sale-namespace.ts
 var CoinListTokenSaleNamespaceImpl = class {
   constructor(ctx) {
     this.ctx = ctx;
@@ -1705,20 +1554,20 @@ var CoinListTokenSaleNamespaceImpl = class {
   }
 };
 
-// src/shared/core/blockchain/formatters.ts
+// src/universal/core/shared/blockchain/formatters.ts
 var import_viem = require("viem");
 
-// src/shared/types/blockchain/ui.ts
+// src/universal/types/blockchain/ui.ts
 var FormattedAmountAssetUi = (value) => value;
 
-// src/shared/core/blockchain/formatters.ts
+// src/universal/core/shared/blockchain/formatters.ts
 function formatRawAmount(amount) {
   return (0, import_viem.formatUnits)(amount.raw, amount.decimals);
 }
 var NA_AMOUNT_ASSET_UI = FormattedAmountAssetUi("-");
 var USD_FRACTION_DIGITS = AssetDecimals(2);
 
-// src/shared/core/blockchain/chain.ts
+// src/universal/core/shared/blockchain/chain.ts
 var CHAIN_IDS = {
   ethereum_mainnet: 1,
   ethereum_sepolia: 11155111,
@@ -1734,7 +1583,7 @@ function chainFromId(chainId) {
   return chain;
 }
 
-// src/shared/core/blockchain/math.ts
+// src/universal/core/shared/blockchain/math.ts
 var import_viem2 = require("viem");
 function blockchainAmountFromRawOrThrow({
   label,
@@ -1758,10 +1607,10 @@ function blockchainAmountFromRawOrThrow({
   }
 }
 
-// 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 };
@@ -1927,7 +1776,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",
@@ -2022,7 +1871,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;
@@ -2054,7 +1903,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;
@@ -2092,10 +2098,30 @@ var SuperstateSwapNamespaceImpl = class {
   }
 };
 
-// src/shared/api/nabu/tokens.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/api/nabu/tokens.ts
 var import_viem3 = require("viem");
 
-// src/shared/types/token-metadata.ts
+// src/universal/types/token-metadata.ts
 var TokenLogoUrl = (value) => value;
 var TokenLogo = {
   /** `baseUrl` is the registry origin; registry URLs are root-relative. */
@@ -2178,7 +2204,7 @@ var resolveLogoUrl = (url, baseUrl) => TokenLogoUrl(
   url.startsWith("http") ? url : `${baseUrl.replace(/\/$/, "")}${url}`
 );
 
-// src/shared/api/nabu/tokens.ts
+// src/universal/api/nabu/tokens.ts
 function createNabuApiClient(baseUrl, logger = null) {
   return new HttpClient({ baseUrl }, {}, logger);
 }
@@ -2269,10 +2295,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.
    */
@@ -2296,7 +2322,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. */
@@ -2318,7 +2344,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) => ({
@@ -2357,7 +2383,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",
@@ -2394,7 +2420,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;
@@ -2497,7 +2523,7 @@ function createCoinListServer(config) {
 // src/server/core/observability/pino-server-logger.ts
 var import_pino = require("pino");
 
-// src/shared/core/observability/pino-logger.ts
+// src/universal/core/shared/observability/pino-logger.ts
 function toPinoRecord(event) {
   try {
     const record = {};