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

package/dist/shared/index.d.cts

@@ -1,7 +1,7 @@
-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.cjs';
-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.cjs';
-import { T as TxExplorerUrl, F as FormattedAmountAssetUi, c as FormattedAmountUi, b as FormattedPercentUi, a as ShortenedWalletAddress, N as NonEmptyArray, S as SwapQuote } from '../collections-BhDkYmzV.cjs';
-export { A as AssetIconUrl, P as PKCEConfig, d as PKCEParams, g as generatePKCEParams } from '../collections-BhDkYmzV.cjs';
+import { ao as PaginationParams, ap as PaginatedResponse, p as Bps, aq as Uint256, a as EthereumChain, X as AssetDecimals, h as AssetSymbol, B as BlockchainAmount, q as EvmWalletAddress, ar as KnownAssetSymbol, y as Erc20Asset, b as EvmContractAddress, x as StablecoinSymbol, as as DecimalString, i as OndoBuyTransaction, j as OndoSellTransaction, at as SwapStatus, au as Newtype } from '../config-CMl1bR3F.cjs';
+export { av as AllowWalletParams, aw as AllowWalletResponse, ax as Asset, ay as AssetCode, e as AssetId, A as AuthorizationCode, az as Blockchain, Y as BuildOndoBuyParams, Z as BuildOndoSellParams, aA as BuildOndoSwapParamsCore, aB as Chain, al as ClientCredentialsOAuth, aC as ClientId, am as ClientSecret, aD as CodeChallenge, C as CodeVerifier, c as CoinListTokenSaleNamespace, f as CoinListTokenSaleNamespaceImpl, u as Config, aE as ConnectExternalWalletParams, aF as CreateKycTokenParams, aG as CreateParticipationParams, aH as CreateWalletOwnershipChallengeParams, aI as Cursor, a3 as DebugEvent, aJ as DocumentFormType, N as DocumentSubmission, aK as DocumentSubmissionStatus, aL as DocumentType, aM as ETHEREUM_CHAINS, E as Erc20Namespace, aN as Erc20NamespaceImpl, aO as FaqItem, a4 as FrontlineEventId, aP as GetOndoQuoteParams, aQ as GetOndoTradingStatusParams, aR as GetSwapAuthorizationParams, aS as GetSwapPreviewParams, aT as GetTokenAllowanceParams, aU as GetTokenBalanceParams, aV as HexEncodedTransactionData, a5 as HttpError, a6 as HttpResponse, aW as Iso2CountryCode, M as KycLevelName, a7 as KycToken, aX as Link, aY as ListOptionAddressesParams, a8 as LogBinding, a9 as LogBindings, aa as LogCause, ab as LogLevel, ac as LogScope, ad as LogValue, L as Logger, aZ as MAX_ASSET_DECIMALS, a_ as MAX_UINT_256, a$ as Milestone, v as OAuthAccessToken, b0 as OAuthRefreshToken, ak as OAuthSession, F as Offer, z as OfferDetail, O as OfferId, b1 as OfferOption, J as OfferOptionAddress, a0 as OfferOptionAddressId, d as OfferOptionId, b2 as OfferOptionSlug, b3 as OfferSlug, b4 as OfferToken, D as OfferType, w as OffersNamespace, b5 as OffersNamespaceImpl, g as OndoNamespace, m as OndoNamespaceImpl, _ as OndoQuote, b6 as OndoQuoteDuration, $ as OndoQuoteSize, b7 as OndoSellOutcome, k as OndoSwapTransactionCore, V as OndoTradingStatus, l as OrderBookSide, b8 as PKCEState, b9 as PaginatedResponseDto, P as Participation, ba as ParticipationId, bb as ParticipationStatus, bc as ParticipationsPaginationParams, bd as Pii, be as PiiAddress, bf as PiiJurisdiction, bg as PiiKind, U as PinoLoggerOptions, ae as ProductionLogLevel, bh as QueryParamValue, bi as QueryParamValues, af as RedactedWalletError, bj as RedirectUri, bk as RemoveOptionAddressParams, ag as RequestId, s as Requirement, bl as RequirementActionNeededReason, K as RequirementId, G as RequirementStatusInfo, I as RequirementStatusValue, H as RequirementType, R as RequirementsNamespace, t as RequirementsNamespaceImpl, bm as SOLANA_CHAINS, bn as STABLE_DECIMALS, ah as SafeEvent, ai as SafeFields, bo as SolanaChain, bp as SubmitDocumentParams, n as SuperstateSwapNamespace, r as SuperstateSwapNamespaceImpl, bq as SwapAuthorization, br as SwapContractRef, bs as SwapPreview, bt as TermItem, bu as Ticker, bv as TokenAllowance, bw as TokenBalance, a2 as TokenIdentifier, bx as TokenLogo, by as TokenLogoImage, bz as TokenLogoUrl, a1 as TokenMetadata, bA as TokenRole, T as TokensNamespace, bB as TokensNamespaceImpl, bC as Tx, aj as UnredactedFields, bD as WalletAddress, Q as WalletChallengeType, W as WalletError, bE as WalletOwnershipChallenge, bF as WalletProtocol, o as WalletsNamespace, bG as WalletsNamespaceImpl, bH as apiErrorCode, bI as assertUint256, bJ as parseUint256 } from '../config-CMl1bR3F.cjs';
+import { T as TxExplorerUrl, F as FormattedAmountAssetUi, d as FormattedAmountUi, b as FormattedPercentUi, a as ShortenedWalletAddress, N as NonEmptyArray, S as SwapQuote } from '../collections-BBI_XydI.cjs';
+export { A as AssetIconUrl, B as BroadcastTxParams, C as ConnectWallet, c as EvmSigner, E as EvmWallet, P as PKCEConfig, e as PKCEParams, W as WriteContractParams, g as generatePKCEParams } from '../collections-BBI_XydI.cjs';
 import { Hash, TransactionReceipt } from 'viem';
 
 /**
@@ -270,7 +270,17 @@ 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;
+    /**
+     * USDC's contract on `chain`. USDC is deployed on every chain the SDK
+     * models, so the table is total and the answer is never `null`.
+     */
+    usdcAddress: (chain: EthereumChain) => EvmContractAddress;
+    /**
+     * USDT's contract on `chain`, or `null` where Tether publishes none —
+     * Base Sepolia today. The honest answer, never a fake address a balance
+     * read would call.
+     */
+    usdtAddress: (chain: EthereumChain) => EvmContractAddress | null;
 };
 
 /** The Ondo integration contract on `chain`, or `null` where none is deployed. */
@@ -308,6 +318,36 @@ declare const ONDO_QUOTE_EXPIRY_THRESHOLD_MS = 5000;
  * 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.
@@ -319,13 +359,13 @@ declare const DEFAULT_ONDO_AMOUNT_TO_COMPUTE_PRICE: DecimalString;
 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.
+ * The price of one whole asset token in a built Ondo purchase, in the funding
+ * token's units - USD per share.
  *
- * `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.
+ * 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
@@ -333,7 +373,7 @@ declare const ONDO_SUPPORTED_INPUT_ASSETS: NonEmptyArray<StablecoinSymbol>;
  *
  * **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
+ * 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.
@@ -341,11 +381,28 @@ declare const ONDO_SUPPORTED_INPUT_ASSETS: NonEmptyArray<StablecoinSymbol>;
  * The two are equal until ENG-1718 turns a fee on, which frontline rejects
  * today. They diverge the moment it does, so the choice is load-bearing rather
  * than academic.
+ */
+declare function computeOndoBuyPrice(transaction: OndoBuyTransaction): BlockchainAmount;
+/**
+ * The price of one whole asset token in a built Ondo sale, in the settlement
+ * token's units - USD per share, the same thing
+ * {@link computeOndoBuyPrice} answers with the ratio inverted.
+ *
+ * **Fee-exclusive, and it takes arithmetic to be so.** `expected.quantity` is
+ * published already net of `expected.fee`, so the proceeds are added back
+ * before dividing: what comes out is the price Ondo filled at, which is the
+ * buy arm's meaning rather than a second one. That is what lets one review row
+ * render on either screen, and what keeps the sell breakdown honest - the fee
+ * sits on its own line beside this, and a net price would count it twice.
  *
- * Denominated in the *funding* token's decimals, so it pairs with
- * `formattedUsdPrice` and with the fee and total rendered beside it.
+ * 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 computeOndoPrice(transaction: Pick<OndoSwapTransaction, 'notionalValue' | 'receiveOutputAmount'>): BlockchainAmount;
+declare function computeOndoSellPrice(transaction: OndoSellTransaction): BlockchainAmount;
 
 declare const SUPERSTATE_SWAP_ABI: readonly [{
     readonly type: "function";
@@ -766,6 +823,31 @@ declare class NotAuthenticatedError extends Error {
 declare class ValidationError extends Error {
     constructor(message: string);
 }
+/**
+ * Error thrown when the SDK computes something impossible: a value outside
+ * uint256 after its own arithmetic, a symbol missing from a registry the SDK
+ * itself ships. Distinct from {@link ValidationError}, which means the backend
+ * sent a shape the SDK does not understand.
+ *
+ * The two have different remedies, which is the whole reason they are separate
+ * types: a {@link ValidationError} is worth reporting to CoinList, an
+ * `InvariantError` is an SDK bug worth reporting against the SDK.
+ */
+declare class InvariantError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when an arithmetic operation has no answer to give: a division
+ * by zero, or a result that falls outside the range its type can represent.
+ *
+ * Distinct from {@link ValidationError}, which says a value arrived malformed.
+ * A `MathError` says every operand was well-formed and the operation on them
+ * still has no result, so the two are worth catching apart: one points at the
+ * response, the other at the arithmetic we asked for.
+ */
+declare class MathError extends Error {
+    constructor(message: string);
+}
 
 type UserDto = {
     id: string;
@@ -784,4 +866,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_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 };
+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 };

package/dist/shared/index.d.ts

@@ -1,7 +1,7 @@
-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 { 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.js';
+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.js';
+import { T as TxExplorerUrl, F as FormattedAmountAssetUi, d as FormattedAmountUi, b as FormattedPercentUi, a as ShortenedWalletAddress, N as NonEmptyArray, S as SwapQuote } from '../collections-BrX9rRWc.js';
+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-BrX9rRWc.js';
 import { Hash, TransactionReceipt } from 'viem';
 
 /**
@@ -270,7 +270,17 @@ 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;
+    /**
+     * USDC's contract on `chain`. USDC is deployed on every chain the SDK
+     * models, so the table is total and the answer is never `null`.
+     */
+    usdcAddress: (chain: EthereumChain) => EvmContractAddress;
+    /**
+     * USDT's contract on `chain`, or `null` where Tether publishes none —
+     * Base Sepolia today. The honest answer, never a fake address a balance
+     * read would call.
+     */
+    usdtAddress: (chain: EthereumChain) => EvmContractAddress | null;
 };
 
 /** The Ondo integration contract on `chain`, or `null` where none is deployed. */
@@ -308,6 +318,36 @@ declare const ONDO_QUOTE_EXPIRY_THRESHOLD_MS = 5000;
  * 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.
@@ -319,13 +359,13 @@ declare const DEFAULT_ONDO_AMOUNT_TO_COMPUTE_PRICE: DecimalString;
 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.
+ * The price of one whole asset token in a built Ondo purchase, in the funding
+ * token's units - USD per share.
  *
- * `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.
+ * 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
@@ -333,7 +373,7 @@ declare const ONDO_SUPPORTED_INPUT_ASSETS: NonEmptyArray<StablecoinSymbol>;
  *
  * **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
+ * 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.
@@ -341,11 +381,28 @@ declare const ONDO_SUPPORTED_INPUT_ASSETS: NonEmptyArray<StablecoinSymbol>;
  * The two are equal until ENG-1718 turns a fee on, which frontline rejects
  * today. They diverge the moment it does, so the choice is load-bearing rather
  * than academic.
+ */
+declare function computeOndoBuyPrice(transaction: OndoBuyTransaction): BlockchainAmount;
+/**
+ * The price of one whole asset token in a built Ondo sale, in the settlement
+ * token's units - USD per share, the same thing
+ * {@link computeOndoBuyPrice} answers with the ratio inverted.
+ *
+ * **Fee-exclusive, and it takes arithmetic to be so.** `expected.quantity` is
+ * published already net of `expected.fee`, so the proceeds are added back
+ * before dividing: what comes out is the price Ondo filled at, which is the
+ * buy arm's meaning rather than a second one. That is what lets one review row
+ * render on either screen, and what keeps the sell breakdown honest - the fee
+ * sits on its own line beside this, and a net price would count it twice.
  *
- * Denominated in the *funding* token's decimals, so it pairs with
- * `formattedUsdPrice` and with the fee and total rendered beside it.
+ * 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 computeOndoPrice(transaction: Pick<OndoSwapTransaction, 'notionalValue' | 'receiveOutputAmount'>): BlockchainAmount;
+declare function computeOndoSellPrice(transaction: OndoSellTransaction): BlockchainAmount;
 
 declare const SUPERSTATE_SWAP_ABI: readonly [{
     readonly type: "function";
@@ -766,6 +823,31 @@ declare class NotAuthenticatedError extends Error {
 declare class ValidationError extends Error {
     constructor(message: string);
 }
+/**
+ * Error thrown when the SDK computes something impossible: a value outside
+ * uint256 after its own arithmetic, a symbol missing from a registry the SDK
+ * itself ships. Distinct from {@link ValidationError}, which means the backend
+ * sent a shape the SDK does not understand.
+ *
+ * The two have different remedies, which is the whole reason they are separate
+ * types: a {@link ValidationError} is worth reporting to CoinList, an
+ * `InvariantError` is an SDK bug worth reporting against the SDK.
+ */
+declare class InvariantError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when an arithmetic operation has no answer to give: a division
+ * by zero, or a result that falls outside the range its type can represent.
+ *
+ * Distinct from {@link ValidationError}, which says a value arrived malformed.
+ * A `MathError` says every operand was well-formed and the operation on them
+ * still has no result, so the two are worth catching apart: one points at the
+ * response, the other at the arithmetic we asked for.
+ */
+declare class MathError extends Error {
+    constructor(message: string);
+}
 
 type UserDto = {
     id: string;
@@ -784,4 +866,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_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 };
+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 };

package/dist/shared/index.js

@@ -7,13 +7,16 @@ import {
   CodeVerifier,
   DEFAULT_AMOUNT_TO_COMPUTE_PRICE,
   DEFAULT_ONDO_AMOUNT_TO_COMPUTE_PRICE,
+  DEFAULT_ONDO_SELL_TOKENS_TO_COMPUTE_PRICE,
   DEFAULT_SLIPPAGE_BPS,
   ERC20_ABI,
   ONDO_POLL_INTERVAL_MS,
   ONDO_QUOTE_EXPIRY_THRESHOLD_MS,
+  ONDO_SETTLEMENT_ASSET,
   ONDO_SUPPORTED_INPUT_ASSETS,
   OffersNamespaceImpl,
   PKCEState,
+  RedactedWalletError,
   RedirectUri,
   SLIPPAGE_OPTIONS_BPS,
   SUPERSTATE_ISSUER_NAME,
@@ -31,7 +34,8 @@ import {
   UserEmail,
   UserId,
   applyBps,
-  computeOndoPrice,
+  computeOndoBuyPrice,
+  computeOndoSellPrice,
   computePrice,
   computeSlip,
   decodeSwappedOutputAmount,
@@ -40,7 +44,7 @@ import {
   isStopped,
   ondoSwapContractAddress,
   superstateSwapContractAddress
-} from "../chunk-B2HCVPCQ.js";
+} from "../chunk-LSPZETDH.js";
 import {
   AllowWalletResponse,
   Asset,
@@ -72,12 +76,14 @@ import {
   FormattedPercentUi,
   HexEncodedTransactionData,
   HttpError,
+  InvariantError,
   Iso2CountryCode,
   KnownAssetSymbol,
   KycToken,
   Link,
   MAX_ASSET_DECIMALS,
   MAX_UINT_256,
+  MathError,
   Milestone,
   NA_AMOUNT_ASSET_UI,
   NotAuthenticatedError,
@@ -94,9 +100,10 @@ import {
   OfferOptionSlug,
   OfferSlug,
   OfferToken,
+  OndoBuyTransaction,
   OndoNamespaceImpl,
   OndoQuote,
-  OndoSwapTransaction,
+  OndoSellTransaction,
   OndoTradingStatus,
   PaginatedResponse,
   PaginationParams,
@@ -146,10 +153,11 @@ import {
   getChainId,
   getNetworkName,
   parseBlockchainAmount,
+  parseUint256,
   shortenAddress,
   txExplorerUrl,
   usdAmount
-} from "../chunk-UIIXXLA7.js";
+} from "../chunk-7CTH4KPU.js";
 export {
   AllowWalletResponse,
   Asset,
@@ -176,6 +184,7 @@ export {
   Cursor,
   DEFAULT_AMOUNT_TO_COMPUTE_PRICE,
   DEFAULT_ONDO_AMOUNT_TO_COMPUTE_PRICE,
+  DEFAULT_ONDO_SELL_TOKENS_TO_COMPUTE_PRICE,
   DEFAULT_SLIPPAGE_BPS,
   DecimalString,
   DocumentSubmission,
@@ -191,12 +200,14 @@ export {
   FormattedPercentUi,
   HexEncodedTransactionData,
   HttpError,
+  InvariantError,
   Iso2CountryCode,
   KnownAssetSymbol,
   KycToken,
   Link,
   MAX_ASSET_DECIMALS,
   MAX_UINT_256,
+  MathError,
   Milestone,
   NA_AMOUNT_ASSET_UI,
   NotAuthenticatedError,
@@ -205,6 +216,7 @@ export {
   OAuthSession,
   ONDO_POLL_INTERVAL_MS,
   ONDO_QUOTE_EXPIRY_THRESHOLD_MS,
+  ONDO_SETTLEMENT_ASSET,
   ONDO_SUPPORTED_INPUT_ASSETS,
   Offer,
   OfferDetail,
@@ -217,9 +229,10 @@ export {
   OfferSlug,
   OfferToken,
   OffersNamespaceImpl,
+  OndoBuyTransaction,
   OndoNamespaceImpl,
   OndoQuote,
-  OndoSwapTransaction,
+  OndoSellTransaction,
   OndoTradingStatus,
   PKCEState,
   PaginatedResponse,
@@ -230,6 +243,7 @@ export {
   Pii,
   PiiAddress,
   PiiJurisdiction,
+  RedactedWalletError,
   RedirectUri,
   Requirement,
   RequirementId,
@@ -278,7 +292,8 @@ export {
   assetAmount,
   blockchainAmountFromRawOrThrow,
   chainFromId,
-  computeOndoPrice,
+  computeOndoBuyPrice,
+  computeOndoSellPrice,
   computePrice,
   computeSlip,
   decodeSwappedOutputAmount,
@@ -295,6 +310,7 @@ export {
   isStopped,
   ondoSwapContractAddress,
   parseBlockchainAmount,
+  parseUint256,
   shortenAddress,
   superstateSwapContractAddress,
   txExplorerUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinlist-co/react",
-  "version": "0.11.0",
+  "version": "0.11.1-rc.10770e8",
   "description": "CoinList Partner SDK",
   "type": "module",
   "scripts": {
@@ -108,6 +108,7 @@
     "@sumsub/websdk-react": "^2.6.3",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.577.0"
+    "lucide-react": "^0.577.0",
+    "pino": "^10.3.1"
   }
 }