@coinlist-co/react 0.10.1 → 0.11.1-rc.10770e8

package/dist/shared/index.d.cts

@@ -1,8 +1,40 @@
-import { B as Bps, U as Uint256, N as Newtype, a as EthereumChain, G as AssetDecimals, M as AssetSymbol, d as BlockchainAmount, E as EvmWalletAddress, b as EvmContractAddress, Q as SwapStatus, V as KnownAssetSymbol, F as Erc20Asset, H as StablecoinSymbol, X as ClientId, Y as RedirectUri, Z as CodeChallenge, _ as PKCEState, i as CodeVerifier } from '../requirement-oVZA1INj.cjs';
-export { $ as AllowWalletParams, a0 as AllowWalletResponse, a1 as Asset, a2 as AssetCode, A as AssetId, h as AuthorizationCode, a3 as Blockchain, J as ClientCredentialsOAuth, L as ClientSecret, c as CoinListErc20Namespace, C as CoinListSwapNamespace, f as CoinListTokenSaleNamespace, j as Config, q as ConnectExternalWalletParams, a4 as CreateParticipationParams, p as CreateWalletOwnershipChallengeParams, a5 as Cursor, a6 as DocumentFormType, v as DocumentSubmission, a7 as DocumentSubmissionStatus, D as DocumentType, a8 as Erc20NamespaceImpl, a9 as FaqItem, aa as GetSwapAuthorizationParams, ab as GetSwapPreviewParams, ac as GetTokenAllowanceParams, ad as GetTokenBalanceParams, ae as HexEncodedTransactionData, af as Iso2CountryCode, K as KycLevelName, w as KycToken, ag as Link, ah as MAX_UINT_256, ai as Milestone, k as OAuthAccessToken, aj as OAuthRefreshToken, I as OAuthSession, l as Offer, o as OfferDetail, O as OfferId, ak as OfferOption, r as OfferOptionAddress, s as OfferOptionAddressId, g as OfferOptionId, al as OfferOptionSlug, am as OfferSlug, an as OfferType, n as PaginatedResponse, ao as PaginatedResponseDto, m as PaginationParams, P as Participation, ap as ParticipationId, aq as ParticipationStatus, ar as ParticipationsPaginationParams, u as Pii, as as PiiAddress, at as PiiJurisdiction, au as PiiKind, R as Requirement, av as RequirementActionNeededReason, aw as RequirementId, t as RequirementStatusInfo, z as RequirementStatusValue, y as RequirementType, ax as SwapAuthorization, ay as SwapContractRef, S as SwapNamespaceImpl, az as SwapPreview, aA as TermItem, aB as TokenAllowance, aC as TokenBalance, T as TokenSaleNamespaceImpl, aD as WalletAddress, x as WalletChallengeType, W as WalletOwnershipChallenge, aE as WalletProtocol, aF as assertUint256, aG as fetchAllPages } from '../requirement-oVZA1INj.cjs';
+import { ao as PaginationParams, ap as PaginatedResponse, p as Bps, aq as Uint256, a as EthereumChain, X as AssetDecimals, h as AssetSymbol, B as BlockchainAmount, q as EvmWalletAddress, ar as KnownAssetSymbol, y as Erc20Asset, b as EvmContractAddress, x as StablecoinSymbol, as as DecimalString, i as OndoBuyTransaction, j as OndoSellTransaction, at as SwapStatus, au as Newtype } from '../config-CMl1bR3F.cjs';
+export { av as AllowWalletParams, aw as AllowWalletResponse, ax as Asset, ay as AssetCode, e as AssetId, A as AuthorizationCode, az as Blockchain, Y as BuildOndoBuyParams, Z as BuildOndoSellParams, aA as BuildOndoSwapParamsCore, aB as Chain, al as ClientCredentialsOAuth, aC as ClientId, am as ClientSecret, aD as CodeChallenge, C as CodeVerifier, c as CoinListTokenSaleNamespace, f as CoinListTokenSaleNamespaceImpl, u as Config, aE as ConnectExternalWalletParams, aF as CreateKycTokenParams, aG as CreateParticipationParams, aH as CreateWalletOwnershipChallengeParams, aI as Cursor, a3 as DebugEvent, aJ as DocumentFormType, N as DocumentSubmission, aK as DocumentSubmissionStatus, aL as DocumentType, aM as ETHEREUM_CHAINS, E as Erc20Namespace, aN as Erc20NamespaceImpl, aO as FaqItem, a4 as FrontlineEventId, aP as GetOndoQuoteParams, aQ as GetOndoTradingStatusParams, aR as GetSwapAuthorizationParams, aS as GetSwapPreviewParams, aT as GetTokenAllowanceParams, aU as GetTokenBalanceParams, aV as HexEncodedTransactionData, a5 as HttpError, a6 as HttpResponse, aW as Iso2CountryCode, M as KycLevelName, a7 as KycToken, aX as Link, aY as ListOptionAddressesParams, a8 as LogBinding, a9 as LogBindings, aa as LogCause, ab as LogLevel, ac as LogScope, ad as LogValue, L as Logger, aZ as MAX_ASSET_DECIMALS, a_ as MAX_UINT_256, a$ as Milestone, v as OAuthAccessToken, b0 as OAuthRefreshToken, ak as OAuthSession, F as Offer, z as OfferDetail, O as OfferId, b1 as OfferOption, J as OfferOptionAddress, a0 as OfferOptionAddressId, d as OfferOptionId, b2 as OfferOptionSlug, b3 as OfferSlug, b4 as OfferToken, D as OfferType, w as OffersNamespace, b5 as OffersNamespaceImpl, g as OndoNamespace, m as OndoNamespaceImpl, _ as OndoQuote, b6 as OndoQuoteDuration, $ as OndoQuoteSize, b7 as OndoSellOutcome, k as OndoSwapTransactionCore, V as OndoTradingStatus, l as OrderBookSide, b8 as PKCEState, b9 as PaginatedResponseDto, P as Participation, ba as ParticipationId, bb as ParticipationStatus, bc as ParticipationsPaginationParams, bd as Pii, be as PiiAddress, bf as PiiJurisdiction, bg as PiiKind, U as PinoLoggerOptions, ae as ProductionLogLevel, bh as QueryParamValue, bi as QueryParamValues, af as RedactedWalletError, bj as RedirectUri, bk as RemoveOptionAddressParams, ag as RequestId, s as Requirement, bl as RequirementActionNeededReason, K as RequirementId, G as RequirementStatusInfo, I as RequirementStatusValue, H as RequirementType, R as RequirementsNamespace, t as RequirementsNamespaceImpl, bm as SOLANA_CHAINS, bn as STABLE_DECIMALS, ah as SafeEvent, ai as SafeFields, bo as SolanaChain, bp as SubmitDocumentParams, n as SuperstateSwapNamespace, r as SuperstateSwapNamespaceImpl, bq as SwapAuthorization, br as SwapContractRef, bs as SwapPreview, bt as TermItem, bu as Ticker, bv as TokenAllowance, bw as TokenBalance, a2 as TokenIdentifier, bx as TokenLogo, by as TokenLogoImage, bz as TokenLogoUrl, a1 as TokenMetadata, bA as TokenRole, T as TokensNamespace, bB as TokensNamespaceImpl, bC as Tx, aj as UnredactedFields, bD as WalletAddress, Q as WalletChallengeType, W as WalletError, bE as WalletOwnershipChallenge, bF as WalletProtocol, o as WalletsNamespace, bG as WalletsNamespaceImpl, bH as apiErrorCode, bI as assertUint256, bJ as parseUint256 } from '../config-CMl1bR3F.cjs';
+import { T as TxExplorerUrl, F as FormattedAmountAssetUi, d as FormattedAmountUi, b as FormattedPercentUi, a as ShortenedWalletAddress, N as NonEmptyArray, S as SwapQuote } from '../collections-BBI_XydI.cjs';
+export { A as AssetIconUrl, B as BroadcastTxParams, C as ConnectWallet, c as EvmSigner, E as EvmWallet, P as PKCEConfig, e as PKCEParams, W as WriteContractParams, g as generatePKCEParams } from '../collections-BBI_XydI.cjs';
 import { Hash, TransactionReceipt } from 'viem';
-import { S as SwapQuote } from '../collections-DDyxbOPZ.cjs';
-export { N as NonEmptyArray } from '../collections-DDyxbOPZ.cjs';
+
+/**
+ * Walks every page of a cursor-paginated endpoint and returns the flattened
+ * result.
+ *
+ * Lives in the API layer rather than beside `PaginationParams` because it
+ * drives requests: it is the auto-paginating half that `list()` is built on,
+ * while the params and the response envelope are domain models the client and
+ * the server both name.
+ */
+declare function fetchAllPages<A, P extends PaginationParams = PaginationParams>(fetchPage: (params: P) => Promise<PaginatedResponse<A>>, baseParams?: Omit<P, keyof PaginationParams>): Promise<A[]>;
+
+/** Basis-point denominator: 10_000 bps = 100%. */
+declare const BPS_DENOM: Bps;
+/**
+ * Applies a basis-point fraction to an amount, flooring the result.
+ * `floor((amount × bps) / BPS_DENOM)`. The result is bounds-checked, so an
+ * overflow (bps far above BPS_DENOM) or a negative product is rejected.
+ */
+declare function applyBps(amount: Uint256, bps: Bps): Uint256;
+
+declare function getChainId(chain: EthereumChain): number;
+/**
+ * Resolves an EIP-155 chain id to the chain the SDK names it by — the inverse
+ * of {@link getChainId}, for backends that report a bare `chain_id`.
+ *
+ * @throws ValidationError on an unrecognised id. Defaulting to mainnet would
+ * let a testnet response read as a live one.
+ */
+declare function chainFromId(chainId: string): EthereumChain;
+declare function getNetworkName(chain: EthereumChain): string;
+declare function txExplorerUrl(chain: EthereumChain, txHash: Hash): TxExplorerUrl;
 
 /**
  * Minimal ERC-20 ABI the SDK writes against (mirrors viem's `erc20Abi`). The
@@ -156,6 +188,222 @@ declare const ERC20_ABI: readonly [{
     readonly anonymous: false;
 }];
 
+declare function shortenAddress(address: EvmWalletAddress): ShortenedWalletAddress;
+type FormatAmountOptions = {
+    maxFractionDigits?: AssetDecimals;
+};
+declare function formatAmount(amount: BlockchainAmount, locale: string, options?: FormatAmountOptions): FormattedAmountUi;
+declare function formatRawAmount(amount: BlockchainAmount): string;
+/**
+ * Formats a {@link BlockchainAmount} using compact notation (e.g. `1.37B`,
+ * `5M`). Compact notation only surfaces a couple of significant decimals, so
+ * the bigint → number narrowing here is intentional and safe: full precision
+ * is deliberately dropped in favour of a human-readable summary value.
+ */
+declare function formatCompactAmount(amount: BlockchainAmount, locale: string): FormattedAmountUi;
+declare function formatBpsAsPercent(bps: Bps, locale: string): FormattedPercentUi;
+declare function usdAmount(amount: FormattedAmountUi): FormattedAmountAssetUi;
+declare function assetAmount(amount: FormattedAmountUi, symbol: AssetSymbol): FormattedAmountAssetUi;
+/** Placeholder shown when an amount is unavailable (e.g. a loading quote). */
+declare const NA_AMOUNT_ASSET_UI: FormattedAmountAssetUi;
+/**
+ * Formats a USD amount capped at 2 fractional digits, falling back to the
+ * {@link NA_AMOUNT_ASSET_UI} placeholder when the amount is absent.
+ */
+declare function formattedUsdPrice(amount: BlockchainAmount | null, locale: string): FormattedAmountAssetUi;
+
+/** A typed, i18n-agnostic reason a raw amount string failed to parse. */
+type AmountParseErrorReason = {
+    type: 'empty';
+} | {
+    type: 'negative';
+} | {
+    type: 'invalid-format';
+} | {
+    type: 'too-many-decimals';
+    maxDecimals: AssetDecimals;
+}
+/** Scaled up by `decimals`, the amount no longer fits a uint256. */
+ | {
+    type: 'overflow';
+};
+type AmountParseResult = {
+    valid: true;
+    amount: BlockchainAmount;
+} | {
+    valid: false;
+    reason: AmountParseErrorReason;
+};
+/**
+ * Wraps a raw uint256 base-unit string — what Ondo and the on-chain reads
+ * return ("100000000" is 100 USDC, not 100 wei-of-nothing) — in a
+ * {@link BlockchainAmount} at the given decimals. The value is already scaled,
+ * so `decimals` is only the unit tag that travels with it.
+ *
+ * Distinct from {@link parseBlockchainAmount}, which takes a *human decimal*
+ * string and scales it up. Feeding a raw amount to that one silently
+ * multiplies it by 10^decimals — pick by what the backend sends, not by which
+ * one is closer at hand.
+ *
+ * @throws ValidationError when the string is not a non-negative uint256
+ * integer. A backend that regresses to decimal strings fails loudly here
+ * rather than truncating.
+ */
+declare function blockchainAmountFromRawOrThrow({ label, raw, decimals, }: {
+    label: string;
+    raw: string;
+    decimals: AssetDecimals;
+}): BlockchainAmount;
+/**
+ * Parses a user-entered decimal string into a {@link BlockchainAmount} at the
+ * given token decimals. Rejects scientific notation, negatives, malformed
+ * input, more fractional digits than the token supports, and amounts that
+ * scale past uint256 — surfacing a typed {@link AmountParseErrorReason} so
+ * callers own the display copy.
+ */
+declare function parseBlockchainAmount(amount: string, decimals: AssetDecimals): AmountParseResult;
+
+declare const USDC_SYMBOL: StablecoinSymbol;
+declare const USDC: Erc20Asset;
+declare const USDT_SYMBOL: StablecoinSymbol;
+declare const USDT: Erc20Asset;
+/** Lookups for the stablecoins the SDK's swap flows support out of the box. */
+declare const TOKEN_REGISTRY: {
+    erc20: (symbol: KnownAssetSymbol) => Erc20Asset;
+    /**
+     * USDC's contract on `chain`. USDC is deployed on every chain the SDK
+     * models, so the table is total and the answer is never `null`.
+     */
+    usdcAddress: (chain: EthereumChain) => EvmContractAddress;
+    /**
+     * USDT's contract on `chain`, or `null` where Tether publishes none —
+     * Base Sepolia today. The honest answer, never a fake address a balance
+     * read would call.
+     */
+    usdtAddress: (chain: EthereumChain) => EvmContractAddress | null;
+};
+
+/** The Ondo integration contract on `chain`, or `null` where none is deployed. */
+declare function ondoSwapContractAddress(chain: EthereumChain): EvmContractAddress | null;
+/**
+ * How often the Ondo checkout refreshes what it is allowed to poll: the market
+ * status and the indicative price. Both are free - neither spends an
+ * attestation - so this is paced for a price the user can trust rather than
+ * for cost.
+ *
+ * A built transaction is deliberately not on this timer. Building spends an
+ * attestation, so it happens once per order and once per refresh the user
+ * asks for.
+ */
+declare const ONDO_POLL_INTERVAL_MS = 15000;
+/**
+ * How close to its deadline a built transaction stops being offerable.
+ *
+ * Placing an order is not instant - the wallet has to prompt, the user has to
+ * confirm, and the transaction has to reach a node - so calldata with a second
+ * left is one the contract will reject. Treating the last few seconds as
+ * already expired turns a paid-for revert into a refresh button.
+ */
+declare const ONDO_QUOTE_EXPIRY_THRESHOLD_MS = 5000;
+/**
+ * The order size the sidebar prices against before the user names one.
+ *
+ * Ondo prices by size, so some amount has to be sent. $1,000 is a plausible
+ * order rather than a token one: a size so small that Ondo's minimum rejects
+ * it would leave the panel permanently blank.
+ *
+ * Named distinctly from `DEFAULT_AMOUNT_TO_COMPUTE_PRICE` in the swap
+ * constants, which is a raw `bigint` of USDC base units for a different
+ * endpoint. Both barrels are flat, so two constants of the same name could not
+ * coexist - and they mean different things anyway.
+ */
+declare const DEFAULT_ONDO_AMOUNT_TO_COMPUTE_PRICE: DecimalString;
+/**
+ * The coin an Ondo sell settles into, for display only.
+ *
+ * The scale of every amount on a built transaction comes off the response, so
+ * this names the token and never sizes it - `receive_output_decimals` is the
+ * only authority on how many decimals the proceeds are counted in, and the two
+ * are allowed to disagree.
+ *
+ * Named apart from {@link ONDO_SUPPORTED_INPUT_ASSETS} rather than read out of
+ * it, though both are USDC today. On a buy USDC is what the user funds with
+ * and one of a list that may grow; on a sell it is what they settle into and
+ * there is one of it. Reading `ONDO_SUPPORTED_INPUT_ASSETS[0]` here would make
+ * the sell screen quietly follow whichever funding coin happened to be listed
+ * first.
+ */
+declare const ONDO_SETTLEMENT_ASSET: StablecoinSymbol;
+/**
+ * The order size the sidebar prices a sell against before the user names one.
+ *
+ * Sells are quoted by token amount rather than by notional: the fee comes out
+ * of dollars, and Ondo's price is size-aware, so a buy's quantity depends on
+ * the quote being asked for while a sell is sized by what the user already
+ * holds. One whole share is a size Ondo will price - small enough to be
+ * plausible for any asset, large enough that Ondo's minimum does not reject it
+ * and leave the panel permanently blank.
+ *
+ * The buy counterpart is {@link DEFAULT_ONDO_AMOUNT_TO_COMPUTE_PRICE}, which
+ * is a dollar figure for the same reason in reverse.
+ */
+declare const DEFAULT_ONDO_SELL_TOKENS_TO_COMPUTE_PRICE = 1;
+/**
+ * The coins an Ondo buy can be funded with, in display order, with the first
+ * preselected.
+ *
+ * USDC alone today: it is what the Sepolia integration contract accepts. The
+ * amount step renders a single entry as a plain card and two or more as a
+ * picker, so adding one here is all it takes.
+ */
+declare const ONDO_SUPPORTED_INPUT_ASSETS: NonEmptyArray<StablecoinSymbol>;
+
+/**
+ * The price of one whole asset token in a built Ondo purchase, in the funding
+ * token's units - USD per share.
+ *
+ * Neither builder publishes a price. Frontline drops Ninshubur's deliberately,
+ * because `GET /v1/ondo/swap/quote` already serves one under that name at a
+ * different scale, and echoing both would leave a caller to guess which was
+ * which.
+ *
+ * Dividing the two amounts the response *does* carry is better than reading
+ * the indicative one anyway: it is the price this transaction fills at, rather
+ * than a poll that has since moved and was struck against a different size.
+ *
+ * **Fee-exclusive.** `notionalValue` is the deposit after CoinList's fee comes
+ * off, so this is the price Ondo filled at, not the buyer's all-in cost per
+ * token - that would be `spendInputAmount / receiveOutputAmount`, and it is
+ * higher. Fee-exclusive is what the review screen wants, because it renders
+ * the fee on its own line: price x quantity, plus fee, comes to the total.
+ * Making this all-in would double-count the fee against that breakdown.
+ *
+ * The two are equal until ENG-1718 turns a fee on, which frontline rejects
+ * today. They diverge the moment it does, so the choice is load-bearing rather
+ * than academic.
+ */
+declare function computeOndoBuyPrice(transaction: OndoBuyTransaction): BlockchainAmount;
+/**
+ * The price of one whole asset token in a built Ondo sale, in the settlement
+ * token's units - USD per share, the same thing
+ * {@link computeOndoBuyPrice} answers with the ratio inverted.
+ *
+ * **Fee-exclusive, and it takes arithmetic to be so.** `expected.quantity` is
+ * published already net of `expected.fee`, so the proceeds are added back
+ * before dividing: what comes out is the price Ondo filled at, which is the
+ * buy arm's meaning rather than a second one. That is what lets one review row
+ * render on either screen, and what keeps the sell breakdown honest - the fee
+ * sits on its own line beside this, and a net price would count it twice.
+ *
+ * Read against {@link OndoSellTransaction.expected} alone. The `minimum` arm
+ * describes the same trade at a different outcome, and pricing that one would
+ * answer "the worst price this could fill at", which no screen asks for.
+ *
+ * The two readings coincide while frontline forces the fee to zero, which it
+ * does today. They diverge the day ENG-1718 lands.
+ */
+declare function computeOndoSellPrice(transaction: OndoSellTransaction): BlockchainAmount;
+
 declare const SUPERSTATE_SWAP_ABI: readonly [{
     readonly type: "function";
     readonly name: "authorized";
@@ -473,107 +721,6 @@ declare const SUPERSTATE_SWAP_ABI: readonly [{
     }];
 }];
 
-/** Basis-point denominator: 10_000 bps = 100%. */
-declare const BPS_DENOM: Bps;
-/**
- * Applies a basis-point fraction to an amount, flooring the result.
- * `floor((amount × bps) / BPS_DENOM)`. The result is bounds-checked, so an
- * overflow (bps far above BPS_DENOM) or a negative product is rejected.
- */
-declare function applyBps(amount: Uint256, bps: Bps): Uint256;
-
-type FormattedAmountUi = Newtype<string, 'FormattedAmountUi'>;
-declare const FormattedAmountUi: (value: string) => FormattedAmountUi;
-type FormattedPercentUi = Newtype<string, 'FormattedPercentUi'>;
-declare const FormattedPercentUi: (value: string) => FormattedPercentUi;
-type TxExplorerUrl = Newtype<string, 'TxExplorerUrl'>;
-declare const TxExplorerUrl: (value: string) => TxExplorerUrl;
-/**
- * A wallet address shortened for display (e.g. `0x1234…5678`). Keeps a
- * `0x${string}` base but drops the runtime `0x` narrowing.
- */
-type ShortenedWalletAddress = Newtype<`0x${string}`, 'ShortenedWalletAddress'>;
-declare const ShortenedWalletAddress: (value: string) => ShortenedWalletAddress;
-type FormattedAmountAssetUi = Newtype<string, 'FormattedAmountAssetUi'>;
-declare const FormattedAmountAssetUi: (value: string) => FormattedAmountAssetUi;
-type AssetIconUrl = Newtype<string, 'AssetIconUrl'>;
-declare const AssetIconUrl: (value: string) => AssetIconUrl;
-
-declare function getChainId(chain: EthereumChain): number;
-declare function getNetworkName(chain: EthereumChain): string;
-declare function txExplorerUrl(chain: EthereumChain, txHash: Hash): TxExplorerUrl;
-
-declare function shortenAddress(address: EvmWalletAddress): ShortenedWalletAddress;
-type FormatAmountOptions = {
-    maxFractionDigits?: AssetDecimals;
-};
-declare function formatAmount(amount: BlockchainAmount, locale: string, options?: FormatAmountOptions): FormattedAmountUi;
-declare function formatRawAmount(amount: BlockchainAmount): string;
-/**
- * Formats a {@link BlockchainAmount} using compact notation (e.g. `1.37B`,
- * `5M`). Compact notation only surfaces a couple of significant decimals, so
- * the bigint → number narrowing here is intentional and safe: full precision
- * is deliberately dropped in favour of a human-readable summary value.
- */
-declare function formatCompactAmount(amount: BlockchainAmount, locale: string): FormattedAmountUi;
-declare function formatBpsAsPercent(bps: Bps, locale: string): FormattedPercentUi;
-declare function usdAmount(amount: FormattedAmountUi): FormattedAmountAssetUi;
-declare function assetAmount(amount: FormattedAmountUi, symbol: AssetSymbol): FormattedAmountAssetUi;
-/** Placeholder shown when an amount is unavailable (e.g. a loading quote). */
-declare const NA_AMOUNT_ASSET_UI: FormattedAmountAssetUi;
-/**
- * Formats a USD amount capped at 2 fractional digits, falling back to the
- * {@link NA_AMOUNT_ASSET_UI} placeholder when the amount is absent.
- */
-declare function formattedUsdPrice(amount: BlockchainAmount | null, locale: string): FormattedAmountAssetUi;
-/** Formats a quote's implied price per output token as a USD amount. */
-declare function formattedPricePerShare(quote: SwapQuote | null, locale: string): FormattedAmountAssetUi;
-
-/** A typed, i18n-agnostic reason a raw amount string failed to parse. */
-type AmountParseErrorReason = {
-    type: 'empty';
-} | {
-    type: 'negative';
-} | {
-    type: 'invalid-format';
-} | {
-    type: 'too-many-decimals';
-    maxDecimals: AssetDecimals;
-};
-type AmountParseResult = {
-    valid: true;
-    amount: BlockchainAmount;
-} | {
-    valid: false;
-    reason: AmountParseErrorReason;
-};
-/**
- * Parses a user-entered decimal string into a {@link BlockchainAmount} at the
- * given token decimals. Rejects scientific notation, negatives, malformed
- * input, and more fractional digits than the token supports — surfacing a
- * typed {@link AmountParseErrorReason} so callers own the display copy.
- */
-declare function parseBlockchainAmount(amount: string, decimals: AssetDecimals): AmountParseResult;
-
-declare const SUPERSTATE_TOS_URL = "https://superstate.com/terms";
-/** Poll interval for refreshing on-chain swap quotes and balances. */
-declare const SWAP_POLL_INTERVAL_MS = 15000;
-/**
- * Notional input used to derive a display price-per-share when the user has
- * not yet entered an amount (1 USDC at 6 decimals).
- */
-declare const DEFAULT_AMOUNT_TO_COMPUTE_PRICE = 1000000n;
-/** Slippage tolerances offered in the review step, in basis points. */
-declare const SLIPPAGE_OPTIONS_BPS: Bps[];
-/** Default slippage tolerance (0.5%). */
-declare const DEFAULT_SLIPPAGE_BPS: Bps;
-/**
- * The Superstate swap contract on Ethereum Sepolia. The mainnet address is not
- * yet finalized upstream, so it is intentionally not exported — callers pass
- * the contract address explicitly.
- */
-declare const SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA: EvmContractAddress;
-
 /**
  * Price of 1 output token in USD, assuming the input token is a $1 stablecoin.
  *
@@ -612,35 +759,53 @@ declare function isStopped(status: SwapStatus): boolean;
  */
 declare function decodeSwappedOutputAmount(receipt: TransactionReceipt, outputDecimals: AssetDecimals): BlockchainAmount | null;
 
-declare const USDC_SYMBOL: StablecoinSymbol;
-declare const USDC: Erc20Asset;
-declare const USDT_SYMBOL: StablecoinSymbol;
-declare const USDT: Erc20Asset;
-/** Lookups for the stablecoins the SDK's swap flows support out of the box. */
-declare const TOKEN_REGISTRY: {
-    erc20: (symbol: KnownAssetSymbol) => Erc20Asset;
-    contractAddress: (symbol: KnownAssetSymbol, chain: EthereumChain) => EvmContractAddress;
-};
+/**
+ * Who issues the asset a Superstate swap pays out.
+ *
+ * A constant rather than a field off the offer: no frontline endpoint carries
+ * an issuer, and every offer this checkout serves is Superstate's by
+ * definition — `CheckoutContainer` routes here on `superstate::swap` alone.
+ */
+declare const SUPERSTATE_ISSUER_NAME = "Superstate";
+/**
+ * The coins a Superstate swap can be funded with, in display order, with the
+ * first preselected.
+ *
+ * USDC alone today: it is what the deployed swap contract accepts. The amount
+ * step renders a single entry as a plain card and two or more as a picker, so
+ * adding one here is all it takes.
+ */
+declare const SUPERSTATE_SUPPORTED_INPUT_ASSETS: NonEmptyArray<StablecoinSymbol>;
+/** Poll interval for refreshing on-chain swap quotes and balances. */
+declare const SWAP_POLL_INTERVAL_MS = 15000;
+/**
+ * Notional input used to derive a display price-per-share when the user has
+ * not yet entered an amount (1 USDC at 6 decimals).
+ */
+declare const DEFAULT_AMOUNT_TO_COMPUTE_PRICE = 1000000n;
+/** Slippage tolerances offered in the review step, in basis points. */
+declare const SLIPPAGE_OPTIONS_BPS: Bps[];
+/** Default slippage tolerance (0.5%). */
+declare const DEFAULT_SLIPPAGE_BPS: Bps;
+/**
+ * The Superstate swap contract on Ethereum Sepolia, and therefore the ERC-20
+ * spender the user approves there.
+ *
+ * Exported in its own right for a partner driving `coinlist.superstate.execute`
+ * at Level 1, where the contract is an explicit parameter.
+ */
+declare const SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA: EvmContractAddress;
+/** The Superstate swap contract on `chain`, or `null` where none is deployed. */
+declare function superstateSwapContractAddress(chain: EthereumChain): EvmContractAddress | null;
 
-type PKCEParams = {
-    clientId: ClientId;
-    responseType: 'code';
-    redirectUri: RedirectUri;
-    codeChallenge: CodeChallenge;
-    codeChallengeMethod: 'S256';
-    state: PKCEState;
-    codeVerifier: CodeVerifier;
-};
-type PKCEConfig = {
-    clientId: ClientId;
-    redirectUri: RedirectUri;
-};
 /**
- * Generates PKCE parameters for an OAuth2 authorization code flow.
- * Pure crypto — no React, no DOM beyond Web Crypto API. Safe to use
- * in server-side code and Next.js middleware.
+ * Formats a quote's implied price per output token as a USD amount.
+ *
+ * Lives with the provider rather than in `@/shared/core/blockchain/formatters`
+ * because {@link SwapQuote} and {@link computePrice} are Superstate's: the
+ * shared formatters stay provider-agnostic.
  */
-declare function generatePKCEParams(config: PKCEConfig): Promise<PKCEParams>;
+declare function formattedPricePerShare(quote: SwapQuote | null, locale: string): FormattedAmountAssetUi;
 
 /**
  * Error thrown when a feature or code path is not yet implemented.
@@ -655,6 +820,34 @@ declare class NotImplementedError extends Error {
 declare class NotAuthenticatedError extends Error {
     constructor(message?: string);
 }
+declare class ValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when the SDK computes something impossible: a value outside
+ * uint256 after its own arithmetic, a symbol missing from a registry the SDK
+ * itself ships. Distinct from {@link ValidationError}, which means the backend
+ * sent a shape the SDK does not understand.
+ *
+ * The two have different remedies, which is the whole reason they are separate
+ * types: a {@link ValidationError} is worth reporting to CoinList, an
+ * `InvariantError` is an SDK bug worth reporting against the SDK.
+ */
+declare class InvariantError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when an arithmetic operation has no answer to give: a division
+ * by zero, or a result that falls outside the range its type can represent.
+ *
+ * Distinct from {@link ValidationError}, which says a value arrived malformed.
+ * A `MathError` says every operand was well-formed and the operation on them
+ * still has no result, so the two are worth catching apart: one points at the
+ * response, the other at the arithmetic we asked for.
+ */
+declare class MathError extends Error {
+    constructor(message: string);
+}
 
 type UserDto = {
     id: string;
@@ -673,4 +866,4 @@ declare const User: {
     fromDto: (dto: UserDto) => User;
 };
 
-export { type AmountParseErrorReason, type AmountParseResult, AssetDecimals, AssetIconUrl, AssetSymbol, BPS_DENOM, BlockchainAmount, Bps, ClientId, CodeChallenge, CodeVerifier, DEFAULT_AMOUNT_TO_COMPUTE_PRICE, DEFAULT_SLIPPAGE_BPS, ERC20_ABI, Erc20Asset, EthereumChain, EvmContractAddress, EvmWalletAddress, type FormatAmountOptions, FormattedAmountAssetUi, FormattedAmountUi, FormattedPercentUi, KnownAssetSymbol, NA_AMOUNT_ASSET_UI, NotAuthenticatedError, NotImplementedError, type PKCEConfig, type PKCEParams, PKCEState, RedirectUri, SLIPPAGE_OPTIONS_BPS, SUPERSTATE_SWAP_ABI, SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA, SUPERSTATE_TOS_URL, SWAP_POLL_INTERVAL_MS, ShortenedWalletAddress, StablecoinSymbol, SwapQuote, SwapStatus, TOKEN_REGISTRY, TxExplorerUrl, USDC, USDC_SYMBOL, USDT, USDT_SYMBOL, Uint256, User, UserEmail, UserId, applyBps, assetAmount, computePrice, computeSlip, decodeSwappedOutputAmount, formatAmount, formatBpsAsPercent, formatCompactAmount, formatRawAmount, formattedPricePerShare, formattedUsdPrice, generatePKCEParams, getChainId, getNetworkName, isStopped, parseBlockchainAmount, shortenAddress, txExplorerUrl, usdAmount };
+export { type AmountParseErrorReason, type AmountParseResult, AssetDecimals, AssetSymbol, BPS_DENOM, BlockchainAmount, Bps, DEFAULT_AMOUNT_TO_COMPUTE_PRICE, DEFAULT_ONDO_AMOUNT_TO_COMPUTE_PRICE, DEFAULT_ONDO_SELL_TOKENS_TO_COMPUTE_PRICE, DEFAULT_SLIPPAGE_BPS, DecimalString, ERC20_ABI, Erc20Asset, EthereumChain, EvmContractAddress, EvmWalletAddress, type FormatAmountOptions, FormattedAmountAssetUi, FormattedAmountUi, FormattedPercentUi, InvariantError, KnownAssetSymbol, MathError, NA_AMOUNT_ASSET_UI, NonEmptyArray, NotAuthenticatedError, NotImplementedError, ONDO_POLL_INTERVAL_MS, ONDO_QUOTE_EXPIRY_THRESHOLD_MS, ONDO_SETTLEMENT_ASSET, ONDO_SUPPORTED_INPUT_ASSETS, OndoBuyTransaction, OndoSellTransaction, PaginatedResponse, PaginationParams, SLIPPAGE_OPTIONS_BPS, SUPERSTATE_ISSUER_NAME, SUPERSTATE_SUPPORTED_INPUT_ASSETS, SUPERSTATE_SWAP_ABI, SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA, SWAP_POLL_INTERVAL_MS, ShortenedWalletAddress, StablecoinSymbol, SwapQuote, SwapStatus, TOKEN_REGISTRY, TxExplorerUrl, USDC, USDC_SYMBOL, USDT, USDT_SYMBOL, Uint256, User, UserEmail, UserId, ValidationError, applyBps, assetAmount, blockchainAmountFromRawOrThrow, chainFromId, computeOndoBuyPrice, computeOndoSellPrice, computePrice, computeSlip, decodeSwappedOutputAmount, fetchAllPages, formatAmount, formatBpsAsPercent, formatCompactAmount, formatRawAmount, formattedPricePerShare, formattedUsdPrice, getChainId, getNetworkName, isStopped, ondoSwapContractAddress, parseBlockchainAmount, shortenAddress, superstateSwapContractAddress, txExplorerUrl, usdAmount };