@coinlist-co/react 0.12.2-rc.7b430dd → 0.12.2-rc.a59b344

package/dist/universal/index.d.ts

@@ -1,8 +1,9 @@
-import { au as PaginationParams, av as PaginatedResponse, aw as DecimalString, x as StablecoinSymbol, j as OndoBuyTransaction, B as BlockchainAmount, k as OndoSellTransaction, p as Bps, ax as SwapStatus, a0 as AssetDecimals, b as EvmContractAddress, a as EthereumChain, i as OfferSwapContract, ay as Uint256, h as AssetSymbol, q as EvmWalletAddress, az as KnownAssetSymbol, y as Erc20Asset, aA as Newtype } from '../tokens-namespace-CIWBtgt2.js';
-export { aB as AllowWalletParams, aC as AllowWalletResponse, aD as Asset, aE as AssetCode, e as AssetId, A as AuthorizationCode, aF as Blockchain, a1 as BuildOndoBuyParams, a2 as BuildOndoSellParams, aG as BuildOndoSwapParamsCore, aH as Chain, ar as ClientCredentialsOAuth, aI as ClientId, as as ClientSecret, aJ as CodeChallenge, C as CodeVerifier, c as CoinListTokenSaleNamespace, f as CoinListTokenSaleNamespaceImpl, aK as CoinListTokenSaleOffer, H as CoinListTokenSaleOfferDetail, u as Config, aL as ConnectExternalWalletParams, aM as CreateKycTokenParams, aN as CreateParticipationParams, aO as CreateWalletOwnershipChallengeParams, aP as Cursor, a8 as DebugEvent, aQ as DocumentFormType, Y as DocumentSubmission, aR as DocumentSubmissionStatus, aS as DocumentType, aT as ETHEREUM_CHAINS, E as Erc20Namespace, aU as Erc20NamespaceImpl, aV as FaqItem, a9 as FrontlineEventId, aW as GetOndoQuoteParams, aX as GetOndoTradingStatusParams, aY as GetSwapAuthorizationParams, aZ as GetSwapPreviewParams, a_ as GetTokenAllowanceParams, a$ as GetTokenBalanceParams, b0 as HexEncodedTransactionData, aa as HttpError, ab as HttpResponse, b1 as Isin, b2 as Iso2CountryCode, X as KycLevelName, ac as KycToken, b3 as Link, b4 as ListOptionAddressesParams, ad as LogBinding, ae as LogBindings, af as LogCause, ag as LogLevel, ah as LogScope, ai as LogValue, L as Logger, b5 as MAX_ASSET_DECIMALS, b6 as MAX_UINT_256, b7 as Milestone, v as OAuthAccessToken, b8 as OAuthRefreshToken, aq as OAuthSession, J as Offer, b9 as OfferBase, z as OfferDetail, ba as OfferDetailBase, bb as OfferEditorial, O as OfferId, bc as OfferOption, Q as OfferOptionAddress, a6 as OfferOptionAddressId, d as OfferOptionId, bd as OfferOptionSlug, be as OfferSlug, bf as OfferToken, F as OfferType, w as OffersNamespace, bg as OffersNamespaceImpl, g as OndoNamespace, n as OndoNamespaceImpl, a3 as OndoQuote, bh as OndoQuoteDuration, a4 as OndoQuoteSize, bi as OndoSellOutcome, bj as OndoSwapOffer, G as OndoSwapOfferDetail, l as OndoSwapTransactionCore, $ as OndoTradingStatus, m as OrderBookSide, bk as PKCEState, bl as PaginatedResponseDto, P as Participation, bm as ParticipationId, bn as ParticipationStatus, bo as ParticipationsPaginationParams, bp as PauseFlags, bq as Pii, br as PiiAddress, bs as PiiJurisdiction, bt as PiiKind, _ as PinoLoggerOptions, aj as ProductionLogLevel, bu as QueryParamValue, bv as QueryParamValues, ak as RedactedWalletError, bw as RedirectUri, bx as RemoveOptionAddressParams, al as RequestId, s as Requirement, by as RequirementActionNeededReason, V as RequirementId, K as RequirementStatusInfo, N as RequirementStatusValue, M as RequirementType, R as RequirementsNamespace, t as RequirementsNamespaceImpl, bz as RpcConfig, am as RpcFailureReason, bA as SOLANA_CHAINS, bB as STABLE_DECIMALS, an as SafeEvent, ao as SafeFields, bC as SolanaChain, bD as SubmitDocumentParams, S as SuperstateSwapNamespace, r as SuperstateSwapNamespaceImpl, bE as SuperstateSwapOffer, I as SuperstateSwapOfferDetail, bF as SwapContractRef, bG as SwapPreview, bH as TermItem, bI as Ticker, a5 as TokenIdentifier, a7 as TokenLogo, bJ as TokenLogoImage, bK as TokenLogoUrl, D as TokenMetadata, bL as TokenRole, T as TokensNamespace, bM as TokensNamespaceImpl, bN as Tx, ap as UnredactedFields, bO as WalletAddress, Z as WalletChallengeType, W as WalletError, bP as WalletOwnershipChallenge, bQ as WalletProtocol, o as WalletsNamespace, bR as WalletsNamespaceImpl, bS as apiErrorCode, bT as assertUint256, bU as isChain, bV as isOfferType, bW as parseUint256 } from '../tokens-namespace-CIWBtgt2.js';
-import { N as NonEmptyArray, S as SwapQuote, F as FormattedAmountAssetUi, T as TxExplorerUrl, e as FormattedAmountUi, b as FormattedPercentUi, a as ShortenedWalletAddress } from '../token-registry-snapshot-BNBNuDu1.js';
-export { A as AssetIconUrl, B as BroadcastTxParams, C as ConnectWallet, d as EvmSigner, E as EvmWallet, P as PKCEConfig, f as PKCEParams, c as TokenRegistrySnapshot, W as WriteContractParams, g as generatePKCEParams, o as offerDisplayTokens } from '../token-registry-snapshot-BNBNuDu1.js';
+import { au as PaginationParams, av as PaginatedResponse, ax as DecimalString, x as StablecoinSymbol, j as OndoBuyTransaction, B as BlockchainAmount, k as OndoSellTransaction, ab as HttpError, p as Bps, ay as SwapStatus, a1 as AssetDecimals, b as EvmContractAddress, a as EthereumChain, i as OfferSwapContract, az as Uint256, h as AssetSymbol, q as EvmWalletAddress, aA as KnownAssetSymbol, y as Erc20Asset, aB as Tx, aC as Newtype } from '../tokens-namespace-D_XSpiS-.js';
+export { aD as AllowWalletParams, aE as AllowWalletResponse, aF as Asset, aG as AssetCode, e as AssetId, A as AuthorizationCode, aH as Blockchain, a2 as BuildOndoBuyParams, a3 as BuildOndoSellParams, aI as BuildOndoSwapParamsCore, aJ as CentrifugeVaultOffer, F as CentrifugeVaultOfferDetail, aK as Chain, as as ClientCredentialsOAuth, aL as ClientId, aw as ClientSecret, aM as CodeChallenge, C as CodeVerifier, c as CoinListTokenSaleNamespace, f as CoinListTokenSaleNamespaceImpl, aN as CoinListTokenSaleOffer, I as CoinListTokenSaleOfferDetail, u as Config, aO as ConnectExternalWalletParams, aP as CreateKycTokenParams, aQ as CreateParticipationParams, aR as CreateWalletOwnershipChallengeParams, aS as Cursor, a9 as DebugEvent, aT as DocumentFormType, Z as DocumentSubmission, aU as DocumentSubmissionStatus, aV as DocumentType, aW as ETHEREUM_CHAINS, E as Erc20Namespace, aX as Erc20NamespaceImpl, aY as FaqItem, aa as FrontlineEventId, aZ as GetOndoQuoteParams, a_ as GetOndoTradingStatusParams, a$ as GetSwapAuthorizationParams, b0 as GetSwapPreviewParams, b1 as GetTokenAllowanceParams, b2 as GetTokenBalanceParams, b3 as HexEncodedTransactionData, ac as HttpResponse, b4 as Isin, b5 as Iso2CountryCode, Y as KycLevelName, ad as KycToken, b6 as Link, b7 as ListOptionAddressesParams, ae as LogBinding, af as LogBindings, ag as LogCause, ah as LogLevel, ai as LogScope, aj as LogValue, L as Logger, b8 as MAX_ASSET_DECIMALS, b9 as MAX_UINT_256, ba as Milestone, v as OAuthAccessToken, bb as OAuthRefreshToken, ar as OAuthSession, K as Offer, bc as OfferBase, z as OfferDetail, bd as OfferDetailBase, be as OfferEditorial, O as OfferId, bf as OfferOption, V as OfferOptionAddress, a7 as OfferOptionAddressId, d as OfferOptionId, bg as OfferOptionSlug, bh as OfferSlug, bi as OfferToken, G as OfferType, bj as OfferVaultContract, w as OffersNamespace, bk as OffersNamespaceImpl, g as OndoNamespace, n as OndoNamespaceImpl, a4 as OndoQuote, bl as OndoQuoteDuration, a5 as OndoQuoteSize, bm as OndoSellOutcome, bn as OndoSwapOffer, H as OndoSwapOfferDetail, l as OndoSwapTransactionCore, a0 as OndoTradingStatus, m as OrderBookSide, bo as PKCEState, bp as PaginatedResponseDto, P as Participation, bq as ParticipationId, br as ParticipationStatus, bs as ParticipationsPaginationParams, bt as PauseFlags, bu as Pii, bv as PiiAddress, bw as PiiJurisdiction, bx as PiiKind, $ as PinoLoggerOptions, ak as ProductionLogLevel, by as QueryParamValue, bz as QueryParamValues, al as RedactedWalletError, bA as RedirectUri, bB as RemoveOptionAddressParams, am as RequestId, s as Requirement, bC as RequirementActionNeededReason, X as RequirementId, M as RequirementStatusInfo, Q as RequirementStatusValue, N as RequirementType, R as RequirementsNamespace, t as RequirementsNamespaceImpl, bD as RpcConfig, an as RpcFailureReason, bE as SOLANA_CHAINS, bF as STABLE_DECIMALS, ao as SafeEvent, ap as SafeFields, bG as SolanaChain, bH as SubmitDocumentParams, S as SuperstateSwapNamespace, r as SuperstateSwapNamespaceImpl, bI as SuperstateSwapOffer, J as SuperstateSwapOfferDetail, bJ as SwapContractRef, bK as SwapPreview, bL as TermItem, bM as Ticker, a6 as TokenIdentifier, a8 as TokenLogo, bN as TokenLogoImage, bO as TokenLogoUrl, D as TokenMetadata, bP as TokenRole, T as TokensNamespace, bQ as TokensNamespaceImpl, aq as UnredactedFields, bR as WalletAddress, _ as WalletChallengeType, W as WalletError, bS as WalletOwnershipChallenge, bT as WalletProtocol, o as WalletsNamespace, bU as WalletsNamespaceImpl, bV as apiErrorCode, bW as assertUint256, bX as isChain, bY as isOfferType, bZ as parseUint256 } from '../tokens-namespace-D_XSpiS-.js';
+import { N as NonEmptyArray, S as SwapQuote, F as FormattedAmountAssetUi, T as TxExplorerUrl, e as FormattedAmountUi, b as FormattedPercentUi, a as ShortenedWalletAddress } from '../token-registry-snapshot-BsAfBL_b.js';
+export { A as AssetIconUrl, B as BroadcastTxParams, C as ConnectWallet, d as EvmSigner, E as EvmWallet, P as PKCEConfig, f as PKCEParams, c as TokenRegistrySnapshot, W as WriteContractParams, g as generatePKCEParams, o as offerDisplayTokens } from '../token-registry-snapshot-BsAfBL_b.js';
 import { TransactionReceipt, Hash, Chain } from 'viem';
+export { E as EpochMillis, M as Millis, S as Seconds, i as isExpired } from '../time-DvgN98Q9.js';
 
 /**
  * Walks every page of a cursor-paginated endpoint and returns the flattened
@@ -129,6 +130,26 @@ declare function computeOndoSellPrice(transaction: OndoSellTransaction): Blockch
 /** The sooner of Ondo's deadline and now + {@link ONDO_QUOTE_MAX_TTL_MS}. */
 declare function ondoQuoteOfferDeadline(expiresAt: Date, nowMs?: number): Date;
 
+/**
+ * The CoinList API's error code for an Ondo quote refused because the asset
+ * cannot be traded right now: the market is closed or paused, or the asset is
+ * paused or closed for the session. It arrives on a 409.
+ *
+ * One code for all four of Ondo's reasons, because the remedy is the same:
+ * wait for the market to open. Ondo pauses for a moment at every US session
+ * change (04:00 and 16:00 ET), so a poll can land on one even while
+ * `getTradingStatus` reported the asset tradable a second earlier.
+ */
+declare const ONDO_NOT_TRADABLE_CODE = "not_tradable";
+/**
+ * Whether `error` is the CoinList API refusing an Ondo quote because the
+ * market is not open, as opposed to a request that failed.
+ *
+ * Total: anything that is not an `HttpError` carrying
+ * {@link ONDO_NOT_TRADABLE_CODE} is `false`.
+ */
+declare function isOndoNotTradableError(error: unknown): error is HttpError;
+
 /**
  * The Superstate swap contract's ABI, generated verbatim from the shared
  * `TokenSwap` base contract:
@@ -1122,6 +1143,13 @@ declare const ERC20_ABI: readonly [{
 declare function shortenAddress(address: EvmWalletAddress): ShortenedWalletAddress;
 type FormatAmountOptions = {
     maxFractionDigits?: AssetDecimals;
+    /**
+     * Trailing zeros are kept down to this many places. Defaults to
+     * `maxFractionDigits` when that is set, otherwise 2 (or the token's own
+     * decimals, when fewer). A figure that wants a cap and a shorter floor —
+     * a share headline — passes both.
+     */
+    minFractionDigits?: AssetDecimals;
 };
 declare function formatAmount(amount: BlockchainAmount, locale: string, options?: FormatAmountOptions): FormattedAmountUi;
 declare function formatRawAmount(amount: BlockchainAmount): string;
@@ -1137,6 +1165,16 @@ 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;
+/**
+ * A share quantity for a headline: at most 6 decimal places, at least 2, with
+ * the zeros between those dropped.
+ *
+ * An 18-decimal fill (`0.002689383776381483`) otherwise takes the whole
+ * confirmation row and the fund name collapses to an ellipsis. Places past 6
+ * are dust at share scale. The chain amount is unchanged, and the transaction
+ * link still carries the exact figure.
+ */
+declare function formatShareAmount(amount: BlockchainAmount, locale: string): FormattedAmountUi;
 /**
  * Formats a USD amount capped at 2 fractional digits, falling back to the
  * {@link NA_AMOUNT_ASSET_UI} placeholder when the amount is absent.
@@ -1256,6 +1294,321 @@ declare class MathError extends Error {
     constructor(message: string);
 }
 
+/**
+ * Wire shapes for frontline's `/v1/centrifuge/vault/*` endpoints, as published
+ * in frontline's OpenAPI schema (ENG-1936). Every uint256 crosses as a decimal
+ * string, every price as a decimal string, every timestamp as ISO 8601.
+ *
+ * **A vault deposit does not settle in the transaction that places it.** The
+ * fund fulfils requests on its own epoch, in whole or in part, at a price set
+ * then, and the user claims the resulting shares in a second transaction. So
+ * every share figure before a fill is an estimate.
+ *
+ * The three GETs are free to poll. The two POSTs return calldata to broadcast:
+ * `buy` is signed for one wallet and called once on confirmation, `claim`
+ * collects everything claimable and carries no amount.
+ */
+/**
+ * Why a deposit cannot be placed right now. A closed set, so a client can
+ * branch on every value. `vault_unlinked` is terminal for the offer's proxy on
+ * that chain; the rest clear on their own or by hand.
+ *
+ * `below_minimum` is the one reason that depends on an amount, so only a quote
+ * can report it - see {@link CentrifugeVaultReasonDto}.
+ */
+type CentrifugeOrderReasonDto = 'vault_unlinked' | 'vault_halted' | 'proxy_not_permissioned' | 'price_unavailable' | 'below_minimum';
+/** What a vault status can report: every reason but the amount-dependent one. */
+type CentrifugeVaultReasonDto = Exclude<CentrifugeOrderReasonDto, 'below_minimum'>;
+/**
+ * Where a wallet stands on a vault, derived from its amounts rather than
+ * stored. Not a lifecycle: a new request moves any of these back to `pending`
+ * while earlier shares stay claimed.
+ */
+type CentrifugePositionStatusDto = 'none' | 'pending' | 'partially_filled' | 'filled' | 'claimed';
+/** `GET /v1/centrifuge/vault/quote?symbol&chain&amount`. Indicative only. */
+type CentrifugeVaultQuoteDto = {
+    object: 'centrifuge_vault_quote';
+    /** The vault's share token symbol, e.g. `deJTRSY`. */
+    symbol: string;
+    chain: string;
+    /** The amount priced, echoed back, in `spend_input_decimals`. No fee. */
+    spend_input_amount: string;
+    spend_input_decimals: number;
+    /** An estimate, not a floor: the fill can price either side of it. */
+    estimated_shares: string;
+    share_decimals: number;
+    /** Funding token per whole share. Null when the vault has no price. */
+    indicative_price: string | null;
+    /** In `spend_input_decimals`. Null when the offer sets no minimum. */
+    minimum_input_amount: string | null;
+    can_order: boolean;
+    /** Empty exactly when `can_order` is true. */
+    reasons: CentrifugeOrderReasonDto[];
+};
+/**
+ * `GET /v1/centrifuge/vault/status?symbol&chain`. The vault's own state, read
+ * from the chain on every call; the gate to poll, because Centrifuge announces
+ * none of these changes.
+ */
+type CentrifugeVaultStatusDto = {
+    object: 'centrifuge_vault_status';
+    symbol: string;
+    chain: string;
+    /** Centrifuge's vault, read from the proxy. Fixed for the proxy's life. */
+    vault_address: string;
+    /** False is terminal for this proxy: a replacement has to be deployed. */
+    linked: boolean;
+    /** Whether the proxy is on the share token's memberlist. */
+    permissioned: boolean;
+    membership_valid_until: string | null;
+    /** Set by the proxy after a force-cancel; cleared only by hand. */
+    halted: boolean;
+    price_updated_at: string | null;
+    can_order: boolean;
+    reasons: CentrifugeVaultReasonDto[];
+    as_of: string;
+};
+/**
+ * What both POSTs return: calldata for the wallet to broadcast verbatim.
+ * Unlike Ondo's, `expires_at` is nullable - a claim carries no signature, so
+ * it is always null there.
+ */
+type CentrifugeBroadcastDto = {
+    action: 'broadcast_transaction';
+    /** The offer's proxy on the chain. Lower case: compare case-insensitively. */
+    to: string;
+    data: string;
+    expires_at: string | null;
+};
+/**
+ * `POST /v1/centrifuge/vault/buy` with `{ symbol, chain, wallet_address,
+ * amount }`. Broadcasting it places a request in the vault's queue and buys
+ * nothing yet.
+ */
+type CentrifugeVaultBuyDto = CentrifugeBroadcastDto & {
+    /** Exactly what the approval has to cover: no fee comes off it. */
+    spend_input_amount: string;
+    spend_input_decimals: number;
+    /** Not a quantity purchased: the fill prices later. */
+    estimated_shares: string;
+    share_decimals: number;
+};
+/**
+ * `GET /v1/centrifuge/vault/position?symbol&chain&wallet_address`. The six
+ * amounts are independent: a wallet can hold a pending request, a claimable
+ * balance and claimed shares at once. There is no per-fulfilment breakdown;
+ * settlement pools every fulfilment into one rate.
+ */
+type CentrifugeVaultPositionDto = {
+    object: 'centrifuge_vault_position';
+    symbol: string;
+    chain: string;
+    wallet_address: string;
+    status: CentrifugePositionStatusDto;
+    /** Funding token ever requested, in `asset_decimals`. */
+    requested: string;
+    /** Of that, still queued. */
+    pending: string;
+    /** Of that, fulfilled. */
+    filled_assets: string;
+    /** Shares the fulfilments earned, in `share_decimals`. Held by the proxy until claimed. */
+    earned_shares: string;
+    claimed_shares: string;
+    /** Non-zero means the claim endpoint will return calldata. */
+    claimable_shares: string;
+    /** Read from the share token; can exceed `claimed_shares`. */
+    share_balance: string;
+    asset_decimals: number;
+    share_decimals: number;
+    /** Null before the first claim. */
+    average_price: string | null;
+    /** Centrifuge froze the wallet on the share token; blocks claiming. */
+    frozen: boolean;
+    as_of: string;
+};
+/**
+ * `POST /v1/centrifuge/vault/claim` with `{ symbol, chain, wallet_address }`.
+ * The wallet named must be the one that broadcasts: the proxy credits the
+ * sender.
+ */
+type CentrifugeVaultClaimDto = CentrifugeBroadcastDto & {
+    /** A floor: a fill landing before the broadcast raises it. */
+    claimable_shares: string;
+    share_decimals: number;
+};
+
+/**
+ * Why a deposit cannot be placed on a vault right now. Kept verbatim from the
+ * wire: frontline publishes it as a closed set for clients to branch on.
+ */
+type CentrifugeOrderReason = CentrifugeOrderReasonDto;
+/** The reasons a vault status can report - all but `below_minimum`. */
+type CentrifugeVaultReason = CentrifugeVaultReasonDto;
+/**
+ * Where a wallet stands on a vault. Not a lifecycle - see
+ * {@link CentrifugeVaultPosition.status}.
+ */
+type CentrifugePositionStatus = CentrifugePositionStatusDto;
+/**
+ * Whether a deposit can be placed, as one union rather than the wire's
+ * `can_order` beside `reasons`: a blocked answer always says why, and an
+ * orderable one has nothing to say. The wire pair can contradict itself; this
+ * cannot, because `fromDto` refuses the payloads that do.
+ */
+type CentrifugeOrderability<R extends CentrifugeOrderReason> = {
+    type: 'orderable';
+} | {
+    type: 'blocked';
+    reasons: [R, ...R[]];
+};
+/**
+ * What a deposit of a given size would buy, and whether it can be placed.
+ *
+ * **Indicative only.** The price is read from the vault now and the fund
+ * prices the fulfilment on its own epoch, so neither {@link indicativePrice}
+ * nor {@link estimatedShares} is a commitment. Free to poll while the user
+ * sizes a deposit.
+ */
+type CentrifugeVaultQuote = {
+    chain: EthereumChain;
+    /** The vault's share token symbol, e.g. `deJTRSY`. */
+    symbol: AssetSymbol;
+    /** The amount priced, in the funding token's decimals. No fee is taken. */
+    spendInputAmount: BlockchainAmount;
+    /** Shares at the indicative price, in the share token's decimals. */
+    estimatedShares: BlockchainAmount;
+    /** Funding token per whole share. Null when the vault publishes no price. */
+    indicativePrice: DecimalString | null;
+    /** Null when the offer sets no minimum. Same decimals as the spend. */
+    minimumInputAmount: BlockchainAmount | null;
+    orderability: CentrifugeOrderability<CentrifugeOrderReason>;
+};
+declare const CentrifugeVaultQuote: {
+    fromDto: (dto: CentrifugeVaultQuoteDto) => CentrifugeVaultQuote;
+};
+/**
+ * A vault's own state, independent of any wallet or amount: the gate to poll.
+ * Centrifuge announces none of these changes, and an unlinked vault leaves the
+ * offer's proxy permanently dead, so a cached answer goes wrong silently.
+ */
+type CentrifugeVaultStatus = {
+    chain: EthereumChain;
+    symbol: AssetSymbol;
+    /** Centrifuge's vault behind the proxy. Fixed for the proxy's life. */
+    vaultAddress: EvmContractAddress;
+    /**
+     * Whether Centrifuge still links the vault to its pool. False is terminal
+     * for this proxy: no request or claim succeeds until a new one is deployed.
+     */
+    linked: boolean;
+    /**
+     * Whether the proxy is on the share token's memberlist. It holds shares for
+     * every wallet, so one expired entry stops the whole offer.
+     */
+    permissioned: boolean;
+    /** Watch it: {@link permissioned} goes false the moment it passes. */
+    membershipValidUntil: Date | null;
+    /** The proxy halted itself after a force-cancel; cleared only by hand. */
+    halted: boolean;
+    /** A stale value is the signal that a quote's price is old. */
+    priceUpdatedAt: Date | null;
+    orderability: CentrifugeOrderability<CentrifugeVaultReason>;
+    /** When the chain was read: how old everything above is. */
+    asOf: Date;
+};
+declare const CentrifugeVaultStatus: {
+    fromDto: (dto: CentrifugeVaultStatusDto) => CentrifugeVaultStatus;
+};
+/**
+ * What both vault transactions share: calldata to broadcast verbatim, and the
+ * deadline on it.
+ */
+type CentrifugeVaultTransactionCore = {
+    /** The `to` is the offer's proxy: the spender the deposit was approved to. */
+    tx: Tx;
+    /**
+     * When the calldata stops being accepted, or null when it carries no
+     * deadline - always the case for a claim, which nobody signs.
+     */
+    expiresAt: Date | null;
+};
+/**
+ * A signed deposit request, ready to broadcast.
+ *
+ * **Broadcasting it buys nothing yet.** It places a request in the vault's
+ * queue; the fund fulfils it later at a price set then, and the user comes
+ * back to claim. {@link estimatedShares} is therefore never a quantity
+ * purchased. Single-use: built once on confirmation, never on a timer.
+ */
+type CentrifugeVaultBuyTransaction = CentrifugeVaultTransactionCore & {
+    /** Exactly what the approval has to cover: no fee comes off it. */
+    spendInputAmount: BlockchainAmount;
+    /** At the price read when the calldata was built. An estimate, not a floor. */
+    estimatedShares: BlockchainAmount;
+};
+declare const CentrifugeVaultBuyTransaction: {
+    fromDto: (dto: CentrifugeVaultBuyDto) => CentrifugeVaultBuyTransaction;
+};
+/**
+ * The claim that moves fulfilled shares from the proxy to the wallet: the
+ * second transaction every vault purchase needs. The wallet that broadcasts it
+ * is the one credited.
+ */
+type CentrifugeVaultClaimTransaction = CentrifugeVaultTransactionCore & {
+    /**
+     * Read when the calldata was built. A floor: a fill landing before the
+     * broadcast raises it, and the claim still collects everything.
+     */
+    claimableShares: BlockchainAmount;
+};
+declare const CentrifugeVaultClaimTransaction: {
+    fromDto: (dto: CentrifugeVaultClaimDto) => CentrifugeVaultClaimTransaction;
+};
+/**
+ * One wallet's standing on one vault: what it put in, what has settled, and
+ * what it can claim. The endpoint a returning user lands on, and the one that
+ * says whether to offer the claim.
+ *
+ * The amounts are independent of each other: each piece of a request settles
+ * and is claimed on its own, so a wallet can be pending, claimable and claimed
+ * at once. There is no per-fulfilment breakdown; settlement pools every
+ * fulfilment into one {@link averagePrice}.
+ */
+type CentrifugeVaultPosition = {
+    chain: EthereumChain;
+    symbol: AssetSymbol;
+    walletAddress: EvmWalletAddress;
+    /**
+     * Derived by frontline from the amounts. Not a lifecycle: a new request
+     * moves it back to `pending` while earlier shares stay claimed.
+     */
+    status: CentrifugePositionStatus;
+    /** Funding token ever requested. */
+    requested: BlockchainAmount;
+    /** Of {@link requested}, what is still queued. */
+    pending: BlockchainAmount;
+    /** Of {@link requested}, what has been fulfilled. */
+    filledAssets: BlockchainAmount;
+    /** Shares the fulfilments earned. Held by the proxy until claimed. */
+    earnedShares: BlockchainAmount;
+    claimedShares: BlockchainAmount;
+    /** Non-zero means a claim will return calldata. */
+    claimableShares: BlockchainAmount;
+    /**
+     * What the wallet holds on the share token. Can exceed
+     * {@link claimedShares}: shares acquired any other way count here.
+     */
+    shareBalance: BlockchainAmount;
+    /** Pooled rate over everything claimed. Null before the first claim. */
+    averagePrice: DecimalString | null;
+    /** Centrifuge froze this wallet on the share token. Blocks claiming. */
+    frozen: boolean;
+    asOf: Date;
+};
+declare const CentrifugeVaultPosition: {
+    fromDto: (dto: CentrifugeVaultPositionDto) => CentrifugeVaultPosition;
+};
+
 type UserDto = {
     id: string;
     email: string;
@@ -1273,4 +1626,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_MAX_TTL_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_LEVEL, 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, isSwapAvailable, ondoQuoteOfferDeadline, parseBlockchainAmount, shortenAddress, superstateSwapContractAddress, swapSpender, txExplorerUrl, usdAmount, viemChain };
+export { type AmountParseErrorReason, type AmountParseResult, AssetDecimals, AssetSymbol, BPS_DENOM, BlockchainAmount, Bps, type CentrifugeOrderReason, type CentrifugeOrderability, type CentrifugePositionStatus, CentrifugeVaultBuyTransaction, CentrifugeVaultClaimTransaction, CentrifugeVaultPosition, CentrifugeVaultQuote, type CentrifugeVaultReason, CentrifugeVaultStatus, type CentrifugeVaultTransactionCore, 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, HttpError, InvariantError, KnownAssetSymbol, MathError, NA_AMOUNT_ASSET_UI, NonEmptyArray, NotAuthenticatedError, NotImplementedError, ONDO_NOT_TRADABLE_CODE, ONDO_POLL_INTERVAL_MS, ONDO_QUOTE_MAX_TTL_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_LEVEL, SWAP_POLL_INTERVAL_MS, ShortenedWalletAddress, StablecoinSymbol, SwapQuote, SwapStatus, TOKEN_REGISTRY, Tx, 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, formatShareAmount, formattedPricePerShare, formattedUsdPrice, getChainId, getNetworkName, isOndoNotTradableError, isSwapAvailable, ondoQuoteOfferDeadline, parseBlockchainAmount, shortenAddress, superstateSwapContractAddress, swapSpender, txExplorerUrl, usdAmount, viemChain };

package/dist/universal/index.js

@@ -1,6 +1,11 @@
 import {
   AuthorizationCode,
   BPS_DENOM,
+  CentrifugeVaultBuyTransaction,
+  CentrifugeVaultClaimTransaction,
+  CentrifugeVaultPosition,
+  CentrifugeVaultQuote,
+  CentrifugeVaultStatus,
   ClientId,
   ClientSecret,
   CodeChallenge,
@@ -9,6 +14,7 @@ import {
   DEFAULT_ONDO_AMOUNT_TO_COMPUTE_PRICE,
   DEFAULT_ONDO_SELL_TOKENS_TO_COMPUTE_PRICE,
   DEFAULT_SLIPPAGE_BPS,
+  ONDO_NOT_TRADABLE_CODE,
   ONDO_POLL_INTERVAL_MS,
   ONDO_QUOTE_MAX_TTL_MS,
   ONDO_SETTLEMENT_ASSET,
@@ -41,12 +47,13 @@ import {
   decodeSwappedOutputAmount,
   formattedPricePerShare,
   generatePKCEParams,
+  isOndoNotTradableError,
   isSwapAvailable,
   offerDisplayTokens,
   ondoQuoteOfferDeadline,
   superstateSwapContractAddress,
   swapSpender
-} from "../chunk-VH34YC3Q.js";
+} from "../chunk-UJYSXXJF.js";
 import {
   AllowWalletResponse,
   Asset,
@@ -69,6 +76,7 @@ import {
   DocumentSubmission,
   ERC20_ABI,
   ETHEREUM_CHAINS,
+  EpochMillis,
   Erc20NamespaceImpl,
   EthereumChain,
   EvmContractAddress,
@@ -89,6 +97,7 @@ import {
   MAX_UINT_256,
   MathError,
   Milestone,
+  Millis,
   NA_AMOUNT_ASSET_UI,
   NotAuthenticatedError,
   NotImplementedError,
@@ -106,6 +115,7 @@ import {
   OfferSlug,
   OfferSwapContract,
   OfferToken,
+  OfferVaultContract,
   OndoBuyTransaction,
   OndoNamespaceImpl,
   OndoQuote,
@@ -127,6 +137,7 @@ import {
   SOLANA_CHAINS,
   STABLE_DECIMALS,
   SUPERSTATE_SWAP_ABI,
+  Seconds,
   ShortenedWalletAddress,
   SolanaChain,
   StablecoinSymbol,
@@ -154,10 +165,12 @@ import {
   formatBpsAsPercent,
   formatCompactAmount,
   formatRawAmount,
+  formatShareAmount,
   formattedUsdPrice,
   getChainId,
   getNetworkName,
   isChain,
+  isExpired,
   isOfferType,
   parseBlockchainAmount,
   parseUint256,
@@ -165,7 +178,7 @@ import {
   txExplorerUrl,
   usdAmount,
   viemChain
-} from "../chunk-MOE5S6CE.js";
+} from "../chunk-NBO5E2RO.js";
 export {
   AllowWalletResponse,
   Asset,
@@ -179,6 +192,11 @@ export {
   Blockchain,
   BlockchainAmount,
   Bps,
+  CentrifugeVaultBuyTransaction,
+  CentrifugeVaultClaimTransaction,
+  CentrifugeVaultPosition,
+  CentrifugeVaultQuote,
+  CentrifugeVaultStatus,
   Chain,
   ClientCredentialsOAuth,
   ClientId,
@@ -198,6 +216,7 @@ export {
   DocumentSubmission,
   ERC20_ABI,
   ETHEREUM_CHAINS,
+  EpochMillis,
   Erc20NamespaceImpl,
   EthereumChain,
   EvmContractAddress,
@@ -218,11 +237,13 @@ export {
   MAX_UINT_256,
   MathError,
   Milestone,
+  Millis,
   NA_AMOUNT_ASSET_UI,
   NotAuthenticatedError,
   NotImplementedError,
   OAuthRefreshToken,
   OAuthSession,
+  ONDO_NOT_TRADABLE_CODE,
   ONDO_POLL_INTERVAL_MS,
   ONDO_QUOTE_MAX_TTL_MS,
   ONDO_SETTLEMENT_ASSET,
@@ -239,6 +260,7 @@ export {
   OfferSlug,
   OfferSwapContract,
   OfferToken,
+  OfferVaultContract,
   OffersNamespaceImpl,
   OndoBuyTransaction,
   OndoNamespaceImpl,
@@ -270,6 +292,7 @@ export {
   SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA,
   SWAP_LEVEL,
   SWAP_POLL_INTERVAL_MS,
+  Seconds,
   ShortenedWalletAddress,
   SolanaChain,
   StablecoinSymbol,
@@ -313,13 +336,16 @@ export {
   formatBpsAsPercent,
   formatCompactAmount,
   formatRawAmount,
+  formatShareAmount,
   formattedPricePerShare,
   formattedUsdPrice,
   generatePKCEParams,
   getChainId,
   getNetworkName,
   isChain,
+  isExpired,
   isOfferType,
+  isOndoNotTradableError,
   isSwapAvailable,
   offerDisplayTokens,
   ondoQuoteOfferDeadline,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinlist-co/react",
-  "version": "0.12.2-rc.7b430dd",
+  "version": "0.12.2-rc.a59b344",
   "description": "CoinList Partner SDK",
   "type": "module",
   "scripts": {