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

package/dist/{shared → universal}/index.d.cts

@@ -1,8 +1,8 @@
-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 { aq as PaginationParams, ar as PaginatedResponse, as as DecimalString, x as StablecoinSymbol, j as OndoBuyTransaction, B as BlockchainAmount, k as OndoSellTransaction, p as Bps, at as SwapStatus, Z as AssetDecimals, b as EvmContractAddress, a as EthereumChain, i as OfferSwapContract, au as Uint256, h as AssetSymbol, q as EvmWalletAddress, av as KnownAssetSymbol, y as Erc20Asset, aw as Newtype } from '../config-DIaFzrMW.cjs';
+export { ax as AllowWalletParams, ay as AllowWalletResponse, az as Asset, aA as AssetCode, e as AssetId, A as AuthorizationCode, aB as Blockchain, _ as BuildOndoBuyParams, $ as BuildOndoSellParams, aC as BuildOndoSwapParamsCore, aD as Chain, an as ClientCredentialsOAuth, aE as ClientId, ao as ClientSecret, aF as CodeChallenge, C as CodeVerifier, c as CoinListTokenSaleNamespace, f as CoinListTokenSaleNamespaceImpl, u as Config, aG as ConnectExternalWalletParams, aH as CreateKycTokenParams, aI as CreateParticipationParams, aJ as CreateWalletOwnershipChallengeParams, aK as Cursor, a5 as DebugEvent, aL as DocumentFormType, Q as DocumentSubmission, aM as DocumentSubmissionStatus, aN as DocumentType, aO as ETHEREUM_CHAINS, E as Erc20Namespace, aP as Erc20NamespaceImpl, aQ as FaqItem, a6 as FrontlineEventId, aR as GetOndoQuoteParams, aS as GetOndoTradingStatusParams, aT as GetSwapAuthorizationParams, aU as GetSwapPreviewParams, aV as GetTokenAllowanceParams, aW as GetTokenBalanceParams, aX as HexEncodedTransactionData, a7 as HttpError, a8 as HttpResponse, aY as Iso2CountryCode, N as KycLevelName, a9 as KycToken, aZ as Link, a_ as ListOptionAddressesParams, aa as LogBinding, ab as LogBindings, ac as LogCause, ad as LogLevel, ae as LogScope, af as LogValue, L as Logger, a$ as MAX_ASSET_DECIMALS, b0 as MAX_UINT_256, b1 as Milestone, v as OAuthAccessToken, b2 as OAuthRefreshToken, am as OAuthSession, G as Offer, z as OfferDetail, O as OfferId, b3 as OfferOption, K as OfferOptionAddress, a3 as OfferOptionAddressId, d as OfferOptionId, b4 as OfferOptionSlug, b5 as OfferSlug, b6 as OfferToken, F as OfferType, w as OffersNamespace, b7 as OffersNamespaceImpl, g as OndoNamespace, n as OndoNamespaceImpl, a0 as OndoQuote, b8 as OndoQuoteDuration, a1 as OndoQuoteSize, b9 as OndoSellOutcome, l as OndoSwapTransactionCore, Y as OndoTradingStatus, m as OrderBookSide, ba as PKCEState, bb as PaginatedResponseDto, P as Participation, bc as ParticipationId, bd as ParticipationStatus, be as ParticipationsPaginationParams, bf as Pii, bg as PiiAddress, bh as PiiJurisdiction, bi as PiiKind, X as PinoLoggerOptions, ag as ProductionLogLevel, bj as QueryParamValue, bk as QueryParamValues, ah as RedactedWalletError, bl as RedirectUri, bm as RemoveOptionAddressParams, ai as RequestId, s as Requirement, bn as RequirementActionNeededReason, M as RequirementId, H as RequirementStatusInfo, J as RequirementStatusValue, I as RequirementType, R as RequirementsNamespace, t as RequirementsNamespaceImpl, bo as SOLANA_CHAINS, bp as STABLE_DECIMALS, aj as SafeEvent, ak as SafeFields, bq as SolanaChain, br as SubmitDocumentParams, S as SuperstateSwapNamespace, r as SuperstateSwapNamespaceImpl, bs as SwapAuthorization, bt as SwapContractRef, bu as SwapPreview, bv as TermItem, bw as Ticker, bx as TokenAllowance, by as TokenBalance, a2 as TokenIdentifier, a4 as TokenLogo, bz as TokenLogoImage, bA as TokenLogoUrl, D as TokenMetadata, bB as TokenRole, T as TokensNamespace, bC as TokensNamespaceImpl, bD as Tx, al as UnredactedFields, bE as WalletAddress, V as WalletChallengeType, W as WalletError, bF as WalletOwnershipChallenge, bG as WalletProtocol, o as WalletsNamespace, bH as WalletsNamespaceImpl, bI as apiErrorCode, bJ as assertUint256, bK as isChain, bL as parseUint256 } from '../config-DIaFzrMW.cjs';
+import { N as NonEmptyArray, S as SwapQuote, F as FormattedAmountAssetUi, T as TxExplorerUrl, d as FormattedAmountUi, b as FormattedPercentUi, a as ShortenedWalletAddress } from '../collections-DOm9VKVm.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-DOm9VKVm.cjs';
+import { TransactionReceipt, Hash } from 'viem';
 
 /**
  * Walks every page of a cursor-paginated endpoint and returns the flattened
@@ -15,797 +15,827 @@ import { Hash, TransactionReceipt } from 'viem';
  */
 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.
+ * 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 function applyBps(amount: Uint256, bps: Bps): Uint256;
-
-declare function getChainId(chain: EthereumChain): number;
+declare const ONDO_POLL_INTERVAL_MS = 15000;
 /**
- * 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`.
+ * How close to its deadline a built transaction stops being offerable.
  *
- * @throws ValidationError on an unrecognised id. Defaulting to mainnet would
- * let a testnet response read as a live one.
+ * 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 function chainFromId(chainId: string): EthereumChain;
-declare function getNetworkName(chain: EthereumChain): string;
-declare function txExplorerUrl(chain: EthereumChain, txHash: Hash): TxExplorerUrl;
+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>;
 
 /**
- * Minimal ERC-20 ABI the SDK writes against (mirrors viem's `erc20Abi`). The
- * swap flow uses `approve`; `allowance`/`balanceOf`/`decimals`/`symbol`/`name`
- * are included so reads share a single SDK-owned ABI.
+ * 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 const ERC20_ABI: readonly [{
+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: "allowance";
+    readonly name: "authorized";
     readonly inputs: readonly [{
-        readonly name: "owner";
-        readonly type: "address";
-    }, {
-        readonly name: "spender";
+        readonly name: "user";
         readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
     }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "stopped";
+    readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
         readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "approve";
+    readonly name: "SWAP_LEVEL";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "preview";
     readonly inputs: readonly [{
-        readonly name: "spender";
+        readonly name: "token";
         readonly type: "address";
+        readonly internalType: "address";
     }, {
         readonly name: "amount";
         readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "bool";
+        readonly type: "tuple";
+        readonly internalType: "struct Preview";
+        readonly components: readonly [{
+            readonly name: "input";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "fee";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "output";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
     }];
-    readonly stateMutability: "nonpayable";
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "balanceOf";
+    readonly name: "swap";
     readonly inputs: readonly [{
-        readonly name: "account";
+        readonly name: "token";
         readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "slip";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "";
         readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
-    readonly stateMutability: "view";
+    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
-    readonly name: "decimals";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint8";
+    readonly name: "tokenBalance";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
     }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "name";
-    readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "string";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "symbol";
+    readonly name: "outputToken";
     readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "string";
+        readonly type: "address";
+        readonly internalType: "address";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "totalSupply";
+    readonly name: "outputTokenBalance";
     readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
         readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "transfer";
+    readonly name: "totals";
     readonly inputs: readonly [{
-        readonly name: "recipient";
+        readonly name: "token";
         readonly type: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
+        readonly internalType: "address";
     }];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "bool";
+        readonly type: "tuple";
+        readonly internalType: "struct SwapTotal";
+        readonly components: readonly [{
+            readonly name: "inputSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "feeSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "outputSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "count";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
     }];
-    readonly stateMutability: "nonpayable";
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "transferFrom";
+    readonly name: "totals";
     readonly inputs: readonly [{
-        readonly name: "sender";
+        readonly name: "user";
         readonly type: "address";
+        readonly internalType: "address";
     }, {
-        readonly name: "recipient";
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct SwapTotal";
+        readonly components: readonly [{
+            readonly name: "inputSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "feeSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "outputSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "count";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly inputs: readonly [{
+        readonly name: "to";
         readonly type: "address";
+        readonly internalType: "address";
     }, {
         readonly name: "amount";
         readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "";
         readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setBps";
+    readonly inputs: readonly [{
+        readonly name: "points";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
     }];
     readonly stateMutability: "nonpayable";
 }, {
     readonly type: "event";
-    readonly name: "Approval";
+    readonly name: "Swapped";
     readonly inputs: readonly [{
-        readonly name: "owner";
+        readonly name: "user";
         readonly type: "address";
         readonly indexed: true;
+        readonly internalType: "address";
     }, {
-        readonly name: "spender";
+        readonly name: "inputToken";
         readonly type: "address";
         readonly indexed: true;
+        readonly internalType: "address";
     }, {
-        readonly name: "value";
+        readonly name: "outputToken";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "inputAmount";
         readonly type: "uint256";
         readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "outputAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
     }];
     readonly anonymous: false;
 }, {
     readonly type: "event";
-    readonly name: "Transfer";
+    readonly name: "Transferred";
     readonly inputs: readonly [{
-        readonly name: "from";
+        readonly name: "to";
         readonly type: "address";
         readonly indexed: true;
+        readonly internalType: "address";
     }, {
-        readonly name: "to";
+        readonly name: "token";
         readonly type: "address";
         readonly indexed: true;
+        readonly internalType: "address";
     }, {
-        readonly name: "value";
+        readonly name: "amount";
         readonly type: "uint256";
         readonly indexed: false;
+        readonly internalType: "uint256";
     }];
     readonly anonymous: false;
+}, {
+    readonly type: "error";
+    readonly name: "InvalidAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InsufficientAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "SwapFailed";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
 }];
 
-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.
+ * Price of 1 output token in USD, assuming the input token is a $1 stablecoin.
+ *
+ * `raw_price = inputTokenAmount.raw × 10^outputDecimals ÷ outputTokenAmount.raw`
+ *
+ * The multiplication happens before the division so we never lose precision to
+ * integer truncation early. This mirrors standard fixed-point practice on-chain.
+ * Returned decimals match the input token decimals (always the stablecoin's 6).
  */
-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;
+declare function computePrice({ inputTokenAmount, outputTokenAmount, }: SwapQuote): BlockchainAmount | null;
 /**
- * Formats a USD amount capped at 2 fractional digits, falling back to the
- * {@link NA_AMOUNT_ASSET_UI} placeholder when the amount is absent.
+ * Applies slippage to an amount, returning the minimum acceptable amount:
+ * `amount × (BPS_DENOM − slippage) / BPS_DENOM`. Throws when `slippage` exceeds
+ * `BPS_DENOM` (the retained fraction would be negative).
  */
-declare function formattedUsdPrice(amount: BlockchainAmount | null, locale: string): FormattedAmountAssetUi;
+declare function computeSlip(amount: BlockchainAmount, slippage: Bps): BlockchainAmount;
 
-/** 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.
+ * Interprets the on-chain swap availability read from `stopped()` and
+ * `SWAP_LEVEL()`.
  *
- * 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.
+ * The contract tracks paused operations as a bitmask in `stopped`. The swap is
+ * stopped when the SWAP_LEVEL flag is set:
  *
- * @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.
+ *   (stopped & SWAP_LEVEL) != 0  ->  stopped (not active)
  */
-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;
-};
+declare function isStopped(status: SwapStatus): boolean;
 
-/** 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.
+ * Decodes the confirmed output amount from the `Swapped` event in a swap
+ * transaction receipt.
  *
- * 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.
+ * Returns `null` when the event is absent or the amount is not a valid uint256
+ * so callers can fall back to the quote's expected output — the swap already
+ * confirmed on-chain, so a missing/undecodable event should not fail the flow.
  */
-declare const ONDO_POLL_INTERVAL_MS = 15000;
+declare function decodeSwappedOutputAmount(receipt: TransactionReceipt, outputDecimals: AssetDecimals): BlockchainAmount | null;
+
 /**
- * How close to its deadline a built transaction stops being offerable.
+ * Who issues the asset a Superstate swap pays out.
  *
- * 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.
+ * 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 ONDO_QUOTE_EXPIRY_THRESHOLD_MS = 5000;
+declare const SUPERSTATE_ISSUER_NAME = "Superstate";
 /**
- * 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.
+ * The coins a Superstate swap can be funded with, in display order, with the
+ * first preselected.
  *
- * 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.
+ * 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 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 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 ONDO_SETTLEMENT_ASSET: StablecoinSymbol;
+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 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 Superstate swap contract on Ethereum Sepolia, and therefore the ERC-20
+ * spender the user approves there.
  *
- * The buy counterpart is {@link DEFAULT_ONDO_AMOUNT_TO_COMPUTE_PRICE}, which
- * is a dollar figure for the same reason in reverse.
+ * Exported in its own right for a partner driving `coinlist.superstate.execute`
+ * at Level 1, where the contract is an explicit parameter.
  */
-declare const DEFAULT_ONDO_SELL_TOKENS_TO_COMPUTE_PRICE = 1;
+declare const SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA: EvmContractAddress;
 /**
- * The coins an Ondo buy can be funded with, in display order, with the first
- * preselected.
+ * The Superstate swap contract on `chain`, or `null` where none is deployed.
  *
- * 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.
+ * TODO(ENG-1734): Ondo now reads its spender off the offer's `swap_contracts`
+ * via `swapSpender`, which is why that helper sits in `shared/core/offers/`
+ * rather than under a provider. Superstate still resolves from this table, so
+ * two mechanisms answer one question. Migrate once frontline serves
+ * `swap_contracts` on Superstate offers too.
  */
-declare const ONDO_SUPPORTED_INPUT_ASSETS: NonEmptyArray<StablecoinSymbol>;
+declare function superstateSwapContractAddress(chain: EthereumChain): EvmContractAddress | null;
 
 /**
- * The price of one whole asset token in a built Ondo purchase, in the funding
- * token's units - USD per share.
+ * Formats a quote's implied price per output token as a USD amount.
  *
- * 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.
+ * Lives with the provider rather than in `@/universal/core/shared/blockchain/formatters`
+ * because {@link SwapQuote} and {@link computePrice} are Superstate's: the
+ * shared formatters stay provider-agnostic.
+ */
+declare function formattedPricePerShare(quote: SwapQuote | null, locale: string): FormattedAmountAssetUi;
+
+/**
+ * The CoinList contract a swap on `chain` settles through, and therefore the
+ * ERC-20 spender the user approves - or `null` where this offer cannot be
+ * swapped on that chain.
  *
- * 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.
+ * Read off the offer rather than held as a constant because the address varies
+ * by environment, not only by chain: beta and production both run
+ * `ethereum_sepolia` and deploy a different contract on each, and one constant
+ * cannot name both. Frontline resolves it per environment and serves the
+ * answer on the offer.
  *
- * **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 array varies per *offer* as well as per chain - frontline drops a chain
+ * whose funding and swap tokens do not both resolve for this asset - so an
+ * array read for one symbol must not be reused for another. An empty array
+ * means "cannot swap here", which is an answer rather than an error.
  *
- * 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.
+ * A capability rather than a provider slice, and named for the data it reads
+ * rather than for its first caller: `swap_contracts` is an offer field, and
+ * `universal-core-isolation-and-sharing` would stop Superstate reusing this if
+ * it lived under `checkout/ondo/`. Superstate has not migrated yet - it still
+ * reads `superstateSwapContractAddress` - so Ondo is the only caller today.
  */
-declare function computeOndoBuyPrice(transaction: OndoBuyTransaction): BlockchainAmount;
+declare function swapSpender(swapContracts: OfferSwapContract[], chain: EthereumChain): EvmContractAddress | null;
+
+/** Basis-point denominator: 10_000 bps = 100%. */
+declare const BPS_DENOM: Bps;
 /**
- * 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.
+ * 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`.
  *
- * The two readings coincide while frontline forces the fee to zero, which it
- * does today. They diverge the day ENG-1718 lands.
+ * @throws ValidationError on an unrecognised id. Defaulting to mainnet would
+ * let a testnet response read as a live one.
  */
-declare function computeOndoSellPrice(transaction: OndoSellTransaction): BlockchainAmount;
+declare function chainFromId(chainId: string): EthereumChain;
+declare function getNetworkName(chain: EthereumChain): string;
+declare function txExplorerUrl(chain: EthereumChain, txHash: Hash): TxExplorerUrl;
 
-declare const SUPERSTATE_SWAP_ABI: readonly [{
-    readonly type: "function";
-    readonly name: "authorized";
-    readonly inputs: readonly [{
-        readonly name: "user";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "bool";
-        readonly internalType: "bool";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "stopped";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "SWAP_LEVEL";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
-    readonly stateMutability: "view";
-}, {
+/**
+ * Minimal ERC-20 ABI the SDK writes against (mirrors viem's `erc20Abi`). The
+ * swap flow uses `approve`; `allowance`/`balanceOf`/`decimals`/`symbol`/`name`
+ * are included so reads share a single SDK-owned ABI.
+ */
+declare const ERC20_ABI: readonly [{
     readonly type: "function";
-    readonly name: "preview";
+    readonly name: "allowance";
     readonly inputs: readonly [{
-        readonly name: "token";
+        readonly name: "owner";
         readonly type: "address";
-        readonly internalType: "address";
     }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
+        readonly name: "spender";
+        readonly type: "address";
     }];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "tuple";
-        readonly internalType: "struct Preview";
-        readonly components: readonly [{
-            readonly name: "input";
-            readonly type: "uint256";
-            readonly internalType: "uint256";
-        }, {
-            readonly name: "fee";
-            readonly type: "uint256";
-            readonly internalType: "uint256";
-        }, {
-            readonly name: "output";
-            readonly type: "uint256";
-            readonly internalType: "uint256";
-        }];
+        readonly type: "uint256";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "swap";
+    readonly name: "approve";
     readonly inputs: readonly [{
-        readonly name: "token";
+        readonly name: "spender";
         readonly type: "address";
-        readonly internalType: "address";
     }, {
         readonly name: "amount";
         readonly type: "uint256";
-        readonly internalType: "uint256";
-    }, {
-        readonly name: "slip";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
+        readonly type: "bool";
     }];
     readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
-    readonly name: "tokenBalance";
+    readonly name: "balanceOf";
     readonly inputs: readonly [{
-        readonly name: "token";
+        readonly name: "account";
         readonly type: "address";
-        readonly internalType: "address";
     }];
     readonly outputs: readonly [{
         readonly name: "";
         readonly type: "uint256";
-        readonly internalType: "uint256";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "outputToken";
+    readonly name: "decimals";
     readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "address";
-        readonly internalType: "address";
+        readonly type: "uint8";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "outputTokenBalance";
+    readonly name: "name";
     readonly inputs: readonly [];
     readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "totals";
-    readonly inputs: readonly [{
-        readonly name: "token";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "tuple";
-        readonly internalType: "struct SwapTotal";
-        readonly components: readonly [{
-            readonly name: "inputSum";
-            readonly type: "uint256";
-            readonly internalType: "uint256";
-        }, {
-            readonly name: "feeSum";
-            readonly type: "uint256";
-            readonly internalType: "uint256";
-        }, {
-            readonly name: "outputSum";
-            readonly type: "uint256";
-            readonly internalType: "uint256";
-        }, {
-            readonly name: "count";
-            readonly type: "uint256";
-            readonly internalType: "uint256";
-        }];
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "totals";
-    readonly inputs: readonly [{
-        readonly name: "user";
-        readonly type: "address";
-        readonly internalType: "address";
-    }, {
-        readonly name: "token";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "tuple";
-        readonly internalType: "struct SwapTotal";
-        readonly components: readonly [{
-            readonly name: "inputSum";
-            readonly type: "uint256";
-            readonly internalType: "uint256";
-        }, {
-            readonly name: "feeSum";
-            readonly type: "uint256";
-            readonly internalType: "uint256";
-        }, {
-            readonly name: "outputSum";
-            readonly type: "uint256";
-            readonly internalType: "uint256";
-        }, {
-            readonly name: "count";
-            readonly type: "uint256";
-            readonly internalType: "uint256";
-        }];
+        readonly name: "";
+        readonly type: "string";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "transfer";
-    readonly inputs: readonly [{
-        readonly name: "to";
-        readonly type: "address";
-        readonly internalType: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
+    readonly name: "symbol";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
     }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalSupply";
+    readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "bool";
-        readonly internalType: "bool";
+        readonly type: "uint256";
     }];
-    readonly stateMutability: "nonpayable";
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "transfer";
     readonly inputs: readonly [{
-        readonly name: "to";
-        readonly type: "address";
-        readonly internalType: "address";
-    }, {
-        readonly name: "token";
+        readonly name: "recipient";
         readonly type: "address";
-        readonly internalType: "address";
     }, {
         readonly name: "amount";
         readonly type: "uint256";
-        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "";
         readonly type: "bool";
-        readonly internalType: "bool";
     }];
     readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
-    readonly name: "setBps";
+    readonly name: "transferFrom";
     readonly inputs: readonly [{
-        readonly name: "points";
+        readonly name: "sender";
+        readonly type: "address";
+    }, {
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
         readonly type: "uint256";
-        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "";
         readonly type: "bool";
-        readonly internalType: "bool";
     }];
     readonly stateMutability: "nonpayable";
 }, {
     readonly type: "event";
-    readonly name: "Swapped";
+    readonly name: "Approval";
     readonly inputs: readonly [{
-        readonly name: "user";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
-    }, {
-        readonly name: "inputToken";
+        readonly name: "owner";
         readonly type: "address";
         readonly indexed: true;
-        readonly internalType: "address";
     }, {
-        readonly name: "outputToken";
+        readonly name: "spender";
         readonly type: "address";
         readonly indexed: true;
-        readonly internalType: "address";
-    }, {
-        readonly name: "inputAmount";
-        readonly type: "uint256";
-        readonly indexed: false;
-        readonly internalType: "uint256";
     }, {
-        readonly name: "outputAmount";
+        readonly name: "value";
         readonly type: "uint256";
         readonly indexed: false;
-        readonly internalType: "uint256";
     }];
     readonly anonymous: false;
 }, {
     readonly type: "event";
-    readonly name: "Transferred";
+    readonly name: "Transfer";
     readonly inputs: readonly [{
-        readonly name: "to";
+        readonly name: "from";
         readonly type: "address";
         readonly indexed: true;
-        readonly internalType: "address";
     }, {
-        readonly name: "token";
+        readonly name: "to";
         readonly type: "address";
         readonly indexed: true;
-        readonly internalType: "address";
     }, {
-        readonly name: "amount";
+        readonly name: "value";
         readonly type: "uint256";
         readonly indexed: false;
-        readonly internalType: "uint256";
     }];
     readonly anonymous: false;
-}, {
-    readonly type: "error";
-    readonly name: "InvalidAddress";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "InsufficientAmount";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "InvalidAmount";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "SwapFailed";
-    readonly inputs: readonly [{
-        readonly name: "user";
-        readonly type: "address";
-        readonly internalType: "address";
-    }, {
-        readonly name: "token";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
 }];
 
+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;
 /**
- * Price of 1 output token in USD, assuming the input token is a $1 stablecoin.
- *
- * `raw_price = inputTokenAmount.raw × 10^outputDecimals ÷ outputTokenAmount.raw`
- *
- * The multiplication happens before the division so we never lose precision to
- * integer truncation early. This mirrors standard fixed-point practice on-chain.
- * Returned decimals match the input token decimals (always the stablecoin's 6).
- */
-declare function computePrice({ inputTokenAmount, outputTokenAmount, }: SwapQuote): BlockchainAmount | null;
-/**
- * Applies slippage to an amount, returning the minimum acceptable amount:
- * `amount × (BPS_DENOM − slippage) / BPS_DENOM`. Throws when `slippage` exceeds
- * `BPS_DENOM` (the retained fraction would be negative).
- */
-declare function computeSlip(amount: BlockchainAmount, slippage: Bps): BlockchainAmount;
-
-/**
- * Interprets the on-chain swap availability read from `stopped()` and
- * `SWAP_LEVEL()`.
- *
- * The contract tracks paused operations as a bitmask in `stopped`. The swap is
- * stopped when the SWAP_LEVEL flag is set:
- *
- *   (stopped & SWAP_LEVEL) != 0  ->  stopped (not active)
+ * 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 isStopped(status: SwapStatus): boolean;
-
+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;
 /**
- * Decodes the confirmed output amount from the `Swapped` event in a swap
- * transaction receipt.
- *
- * Returns `null` when the event is absent or the amount is not a valid uint256
- * so callers can fall back to the quote's expected output — the swap already
- * confirmed on-chain, so a missing/undecodable event should not fail the flow.
+ * 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 decodeSwappedOutputAmount(receipt: TransactionReceipt, outputDecimals: AssetDecimals): BlockchainAmount | null;
+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;
+};
 /**
- * Who issues the asset a Superstate swap pays out.
+ * 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.
  *
- * 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.
+ * 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.
  *
- * 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).
+ * @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 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;
+declare function blockchainAmountFromRawOrThrow({ label, raw, decimals, }: {
+    label: string;
+    raw: string;
+    decimals: AssetDecimals;
+}): BlockchainAmount;
 /**
- * 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.
+ * 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 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;
+declare function parseBlockchainAmount(amount: string, decimals: AssetDecimals): AmountParseResult;
 
-/**
- * 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 formattedPricePerShare(quote: SwapQuote | null, locale: string): FormattedAmountAssetUi;
+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;
+};
 
 /**
  * Error thrown when a feature or code path is not yet implemented.
@@ -866,4 +896,4 @@ declare const User: {
     fromDto: (dto: UserDto) => User;
 };
 
-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 };
+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, OfferSwapContract, 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, parseBlockchainAmount, shortenAddress, superstateSwapContractAddress, swapSpender, txExplorerUrl, usdAmount };