@coinlist-co/react 0.10.1 → 0.11.0

package/dist/shared/index.d.ts

@@ -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.js';
-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.js';
+import { a5 as PaginationParams, a6 as PaginatedResponse, m as Bps, a7 as Uint256, a as EthereumChain, M as AssetDecimals, i as AssetSymbol, B as BlockchainAmount, E as EvmWalletAddress, a8 as KnownAssetSymbol, u as Erc20Asset, c as EvmContractAddress, w as StablecoinSymbol, a9 as DecimalString, j as OndoSwapTransaction, aa as SwapStatus, ab as Newtype } from '../config-B5mwS_2l.js';
+export { ac as AllowWalletParams, ad as AllowWalletResponse, ae as Asset, af as AssetCode, f as AssetId, A as AuthorizationCode, ag as Blockchain, V as BuildOndoSwapTransactionParams, ah as Chain, a2 as ClientCredentialsOAuth, ai as ClientId, a3 as ClientSecret, aj as CodeChallenge, C as CodeVerifier, d as CoinListTokenSaleNamespace, g as CoinListTokenSaleNamespaceImpl, q as Config, ak as ConnectExternalWalletParams, al as CreateKycTokenParams, am as CreateParticipationParams, an as CreateWalletOwnershipChallengeParams, ao as Cursor, ap as DocumentFormType, J as DocumentSubmission, aq as DocumentSubmissionStatus, ar as DocumentType, as as ETHEREUM_CHAINS, b as Erc20Namespace, at as Erc20NamespaceImpl, au as FaqItem, av as GetOndoQuoteParams, aw as GetOndoTradingStatusParams, ax as GetSwapAuthorizationParams, ay as GetSwapPreviewParams, az as GetTokenAllowanceParams, aA as GetTokenBalanceParams, aB as HexEncodedTransactionData, _ as HttpError, $ as HttpResponse, aC as Iso2CountryCode, K as KycLevelName, a0 as KycToken, aD as Link, aE as ListOptionAddressesParams, aF as MAX_ASSET_DECIMALS, aG as MAX_UINT_256, aH as Milestone, r as OAuthAccessToken, aI as OAuthRefreshToken, a1 as OAuthSession, y as Offer, v as OfferDetail, O as OfferId, aJ as OfferOption, G as OfferOptionAddress, X as OfferOptionAddressId, e as OfferOptionId, aK as OfferOptionSlug, aL as OfferSlug, aM as OfferToken, x as OfferType, s as OffersNamespace, aN as OffersNamespaceImpl, h as OndoNamespace, k as OndoNamespaceImpl, N as OndoQuote, aO as OndoQuoteDuration, U as OndoQuoteSize, L as OndoTradingStatus, Q as OrderBookSide, aP as PKCEState, aQ as PaginatedResponseDto, P as Participation, aR as ParticipationId, aS as ParticipationStatus, aT as ParticipationsPaginationParams, aU as Pii, aV as PiiAddress, aW as PiiJurisdiction, aX as PiiKind, aY as QueryParamValue, aZ as QueryParamValues, a_ as RedirectUri, a$ as RemoveOptionAddressParams, o as Requirement, b0 as RequirementActionNeededReason, H as RequirementId, z as RequirementStatusInfo, F as RequirementStatusValue, D as RequirementType, R as RequirementsNamespace, p as RequirementsNamespaceImpl, b1 as SOLANA_CHAINS, b2 as STABLE_DECIMALS, b3 as SolanaChain, b4 as SubmitDocumentParams, l as SuperstateSwapNamespace, n as SuperstateSwapNamespaceImpl, b5 as SwapAuthorization, b6 as SwapContractRef, b7 as SwapPreview, b8 as TermItem, b9 as Ticker, ba as TokenAllowance, bb as TokenBalance, Z as TokenIdentifier, bc as TokenLogo, bd as TokenLogoImage, be as TokenLogoUrl, Y as TokenMetadata, bf as TokenRole, t as TokensNamespace, bg as TokensNamespaceImpl, T as Tx, bh as WalletAddress, I as WalletChallengeType, bi as WalletOwnershipChallenge, bj as WalletProtocol, W as WalletsNamespace, bk as WalletsNamespaceImpl, bl as apiErrorCode, bm as assertUint256 } from '../config-B5mwS_2l.js';
+import { T as TxExplorerUrl, F as FormattedAmountAssetUi, c as FormattedAmountUi, b as FormattedPercentUi, a as ShortenedWalletAddress, N as NonEmptyArray, S as SwapQuote } from '../collections-CZhHoQHr.js';
+export { A as AssetIconUrl, P as PKCEConfig, d as PKCEParams, g as generatePKCEParams } from '../collections-CZhHoQHr.js';
 import { Hash, TransactionReceipt } from 'viem';
-import { S as SwapQuote } from '../collections-Bv1Oxzu_.js';
-export { N as NonEmptyArray } from '../collections-Bv1Oxzu_.js';
+
+/**
+ * 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,165 @@ 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;
+    contractAddress: (symbol: KnownAssetSymbol, chain: EthereumChain) => EvmContractAddress;
+};
+
+/** 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 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 an Ondo swap transaction, in the
+ * funding token's units.
+ *
+ * `POST /v1/ondo/swap/transaction` publishes no 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 `payInputAmount / 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.
+ *
+ * Denominated in the *funding* token's decimals, so it pairs with
+ * `formattedUsdPrice` and with the fee and total rendered beside it.
+ */
+declare function computeOndoPrice(transaction: Pick<OndoSwapTransaction, 'notionalValue' | 'receiveOutputAmount'>): BlockchainAmount;
+
 declare const SUPERSTATE_SWAP_ABI: readonly [{
     readonly type: "function";
     readonly name: "authorized";
@@ -473,107 +664,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 +702,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 +763,9 @@ declare class NotImplementedError extends Error {
 declare class NotAuthenticatedError extends Error {
     constructor(message?: string);
 }
+declare class ValidationError extends Error {
+    constructor(message: string);
+}
 
 type UserDto = {
     id: string;
@@ -673,4 +784,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_SLIPPAGE_BPS, DecimalString, ERC20_ABI, Erc20Asset, EthereumChain, EvmContractAddress, EvmWalletAddress, type FormatAmountOptions, FormattedAmountAssetUi, FormattedAmountUi, FormattedPercentUi, KnownAssetSymbol, NA_AMOUNT_ASSET_UI, NonEmptyArray, NotAuthenticatedError, NotImplementedError, ONDO_POLL_INTERVAL_MS, ONDO_QUOTE_EXPIRY_THRESHOLD_MS, ONDO_SUPPORTED_INPUT_ASSETS, OndoSwapTransaction, 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, computeOndoPrice, computePrice, computeSlip, decodeSwappedOutputAmount, fetchAllPages, formatAmount, formatBpsAsPercent, formatCompactAmount, formatRawAmount, formattedPricePerShare, formattedUsdPrice, getChainId, getNetworkName, isStopped, ondoSwapContractAddress, parseBlockchainAmount, shortenAddress, superstateSwapContractAddress, txExplorerUrl, usdAmount };