@coinlist-co/react 0.12.2-rc.0fda52c → 0.12.2-rc.5f2ca48

package/dist/{tokens-namespace-BJfFeowE.d.ts → tokens-namespace-CcvHrw-k.d.ts}

@@ -412,7 +412,7 @@ type PinoLoggerOptions = {
  * - an operation, a flow, a hook - is a {@link LogBinding} and appears as its
  * own field.
  */
-type LogScope = 'HTTP' | 'RPC' | 'AUTH' | 'OFFERS' | 'REQUIREMENTS' | 'WALLETS' | 'ERC20' | 'TOKEN_SALE' | 'SUPERSTATE' | 'ONDO' | 'TOKENS' | 'SUPPORT' | 'HOOKS';
+type LogScope = 'HTTP' | 'RPC' | 'AUTH' | 'OFFERS' | 'REQUIREMENTS' | 'WALLETS' | 'ERC20' | 'TOKEN_SALE' | 'SUPERSTATE' | 'ONDO' | 'CENTRIFUGE' | 'TOKENS' | 'SUPPORT' | 'HOOKS';
 /**
  * Correlates every line one logical request produces. The first attempt, each
  * retry, and the re-send after a session renewal all carry the same id, so a
@@ -1267,13 +1267,13 @@ type InternalDebugEvent = {
  * union makes a `switch` over it exhaustive: adding a provider without
  * handling it becomes a compile error.
  */
-type OfferTypeDto = 'coinlist::token_sale' | 'superstate::swap' | 'ondo::swap';
+type OfferTypeDto = 'coinlist::token_sale' | 'superstate::swap' | 'ondo::swap' | 'centrifuge::vault';
 /**
  * One variant per {@link OfferTypeDto}, mirroring frontline#1365, which keys
  * `GET /v1/offers` on `type`. Read `type` first: it decides which of the
  * fields below mean anything.
  */
-type OfferDto = CoinListTokenSaleOfferDto | SuperstateSwapOfferDto | OndoSwapOfferDto;
+type OfferDto = CoinListTokenSaleOfferDto | SuperstateSwapOfferDto | OndoSwapOfferDto | CentrifugeVaultOfferDto;
 type OfferBaseDto = {
     id: string;
     slug: string;
@@ -1290,15 +1290,16 @@ type OfferEditorialDto = {
     starts_at: string;
 };
 /**
- * What an Ondo swap sends in place of {@link OfferEditorialDto}. It trades
- * continuously and runs no campaign, so the keys arrive as `null` and carry
- * nothing. Declared so a fixture can describe the real payload; no `fromDto`
- * reads them.
+ * What an Ondo swap or a Centrifuge vault sends in place of
+ * {@link OfferEditorialDto}. Neither runs a campaign, so the keys arrive as
+ * `null` and carry nothing, and the backend may stop sending them at all.
+ * Declared so a fixture can describe the real payload; no `fromDto` reads
+ * them.
  */
 type OfferNoEditorialDto = {
-    tagline: null;
-    banner_url: null;
-    starts_at: null;
+    tagline?: null;
+    banner_url?: null;
+    starts_at?: null;
 };
 type CoinListTokenSaleOfferDto = OfferBaseDto & OfferEditorialDto & {
     type: 'coinlist::token_sale';
@@ -1314,8 +1315,17 @@ type OndoSwapOfferDto = OfferBaseDto & OfferNoEditorialDto & {
     /** Publishing a swap does not require anyone to upload artwork for it. */
     logo_url: string | null;
 };
+type CentrifugeVaultOfferDto = OfferBaseDto & OfferNoEditorialDto & {
+    type: 'centrifuge::vault';
+    /** Publishing a vault does not require anyone to upload artwork for it. */
+    logo_url: string | null;
+};
 type OfferTokenDto = {
-    role: 'funding' | 'distribution' | 'swap';
+    /**
+     * `vault` is the share token a `centrifuge::vault` offer issues for
+     * deposits, as `swap` is the token a swap offer trades into.
+     */
+    role: 'funding' | 'distribution' | 'swap' | 'vault';
     chain: string;
     address: string;
 };
@@ -1346,10 +1356,16 @@ type OndoSwapOffer = OfferBase & {
     /** Null when nobody has uploaded artwork: a swap publishes without it. */
     logoUrl: string | null;
 };
+type CentrifugeVaultOffer = OfferBase & {
+    type: 'centrifuge::vault';
+    /** Null when nobody has uploaded artwork: a vault publishes without it. */
+    logoUrl: string | null;
+};
 /**
  * A curated sale window and the hand-authored copy that goes with it. Every
  * variant that runs such a campaign carries all three, validated; an Ondo swap
- * trades continuously, runs none, and carries none.
+ * trades continuously and a Centrifuge vault takes deposits continuously, so
+ * neither runs one and neither carries any.
  */
 type OfferEditorial = {
     tagline: string;
@@ -1369,7 +1385,7 @@ declare const OfferEditorial: {
  * `type` before reading anything beyond {@link OfferBase} - an Ondo swap has
  * no `startsAt` to read, and the compiler says so.
  */
-type Offer = CoinListTokenSaleOffer | SuperstateSwapOffer | OndoSwapOffer;
+type Offer = CoinListTokenSaleOffer | SuperstateSwapOffer | OndoSwapOffer | CentrifugeVaultOffer;
 declare const Offer: {
     fromDto: (dto: OfferDto) => Offer;
     /**
@@ -1382,7 +1398,11 @@ declare const Offer: {
      */
     listFromDto: (dtos: OfferDto[]) => Offer[];
 };
-type TokenRole = 'funding' | 'distribution' | 'swap';
+/**
+ * `vault` is the share token a `centrifuge::vault` offer issues for deposits,
+ * as `swap` is the token a swap offer trades into.
+ */
+type TokenRole = 'funding' | 'distribution' | 'swap' | 'vault';
 type OfferToken = {
     role: TokenRole;
     chain: Chain;
@@ -1497,16 +1517,16 @@ type CreateParticipationDto = {
  * One variant per `OfferTypeDto`, the same split as `OfferDto` with what
  * `GET /v1/offers/:id` adds on top. Read `type` first.
  */
-type OfferDetailDto = CoinListTokenSaleOfferDetailDto | SuperstateSwapOfferDetailDto | OndoSwapOfferDetailDto;
-type CoinListTokenSaleOfferDetailDto = OfferDetailBaseDto & OfferEditorialDto & OfferDetailNoSwapContractsDto & {
+type OfferDetailDto = CoinListTokenSaleOfferDetailDto | SuperstateSwapOfferDetailDto | OndoSwapOfferDetailDto | CentrifugeVaultOfferDetailDto;
+type CoinListTokenSaleOfferDetailDto = OfferDetailBaseDto & OfferEditorialDto & OfferDetailNoSwapContractsDto & OfferDetailNoVaultContractsDto & {
     type: 'coinlist::token_sale';
     logo_url: string;
 };
-type SuperstateSwapOfferDetailDto = OfferDetailBaseDto & OfferEditorialDto & OfferDetailNoSwapContractsDto & {
+type SuperstateSwapOfferDetailDto = OfferDetailBaseDto & OfferEditorialDto & OfferDetailNoSwapContractsDto & OfferDetailNoVaultContractsDto & {
     type: 'superstate::swap';
     logo_url: string | null;
 };
-type OndoSwapOfferDetailDto = OfferDetailBaseDto & OfferNoEditorialDto & {
+type OndoSwapOfferDetailDto = OfferDetailBaseDto & OfferNoEditorialDto & OfferDetailNoVaultContractsDto & {
     type: 'ondo::swap';
     logo_url: string | null;
     /**
@@ -1515,6 +1535,19 @@ type OndoSwapOfferDetailDto = OfferDetailBaseDto & OfferNoEditorialDto & {
      */
     swap_contracts: OfferDetailSwapContractDto[];
 };
+type CentrifugeVaultOfferDetailDto = OfferDetailBaseDto & OfferNoEditorialDto & OfferDetailNoSwapContractsDto & {
+    type: 'centrifuge::vault';
+    logo_url: string | null;
+    /**
+     * Every chain this vault takes deposits on, with the CoinList proxy each
+     * request goes through. `[]` is an answer - "deposits nowhere", which is
+     * every vault until a proxy is deployed - and a missing key is not.
+     */
+    vault_contracts: OfferDetailVaultContractDto[];
+};
+type OfferDetailNoVaultContractsDto = {
+    vault_contracts?: OfferDetailVaultContractDto[];
+};
 /**
  * An offer that does not settle through a CoinList swap contract sends `[]`
  * or no key at all, and either way there is nothing to read. Declared so a
@@ -1581,6 +1614,10 @@ type OfferDetailSwapContractDto = {
     chain: string;
     address: string;
 };
+type OfferDetailVaultContractDto = {
+    chain: string;
+    address: string;
+};
 
 type Ticker = Newtype<string, 'Ticker'>;
 declare const Ticker: (value: string) => Ticker;
@@ -1618,6 +1655,16 @@ type OndoSwapOfferDetail = OfferDetailBase & {
      */
     swapContracts: OfferSwapContract[];
 };
+type CentrifugeVaultOfferDetail = OfferDetailBase & {
+    type: 'centrifuge::vault';
+    /** Null when nobody has uploaded artwork: a vault publishes without it. */
+    logoUrl: string | null;
+    /**
+     * Every chain this vault takes deposits on, with the CoinList proxy each
+     * request goes through. Empty means it takes deposits nowhere yet.
+     */
+    vaultContracts: OfferVaultContract[];
+};
 type OfferDetailBase = {
     id: OfferId;
     slug: OfferSlug;
@@ -1695,13 +1742,38 @@ type OfferSwapContract = {
 declare const OfferSwapContract: {
     fromDto: (dto: OfferDetailSwapContractDto) => OfferSwapContract;
 };
+/**
+ * A chain a Centrifuge vault takes deposits on, with the CoinList proxy the
+ * request goes through. Not a token, so the token registry knows nothing about
+ * it: it is the spender the user approves the funding token to, and the `to`
+ * the buy and claim transactions are sent to.
+ *
+ * Its own type rather than an {@link OfferSwapContract}, although the shape is
+ * the same, because the meaning is not: a swap contract serves every Ondo
+ * asset on its chain, while a proxy belongs to one offer on one chain, so the
+ * same chain carries a different address on every vault.
+ */
+type OfferVaultContract = {
+    chain: Chain;
+    address: EvmContractAddress;
+};
+declare const OfferVaultContract: {
+    fromDto: (dto: OfferDetailVaultContractDto) => OfferVaultContract;
+    /**
+     * Drops every proxy on a chain this SDK does not name, as
+     * `OfferToken.listFromDto` does: frontline publishes the full offer-token
+     * chain list, which runs ahead of {@link Chain}, and one unmodelled chain
+     * should not throw away the proxies the SDK can use.
+     */
+    listFromDto: (dtos: OfferDetailVaultContractDto[]) => OfferVaultContract[];
+};
 /**
  * An offer as `GET /v1/offers/:id` serves it: the same union on `type` as
  * {@link Offer}, each variant carrying only the fields that mean something
  * for it. Narrow on `type` before reading anything beyond
  * {@link OfferDetailBase}.
  */
-type OfferDetail = CoinListTokenSaleOfferDetail | SuperstateSwapOfferDetail | OndoSwapOfferDetail;
+type OfferDetail = CoinListTokenSaleOfferDetail | SuperstateSwapOfferDetail | OndoSwapOfferDetail | CentrifugeVaultOfferDetail;
 declare const OfferDetail: {
     fromDto: (dto: OfferDetailDto) => OfferDetail;
 };
@@ -2488,6 +2560,17 @@ declare const OndoSellTransaction: {
  */
 interface OndoNamespace {
     getTradingStatus(params: GetOndoTradingStatusParams): Promise<OndoTradingStatus>;
+    /**
+     * An indicative price for `params`' size, from Ondo's live market.
+     *
+     * Ondo refuses to quote while the market is closed or paused, or the asset
+     * is paused or closed for the session - including for about a minute at
+     * every US session change, when `getTradingStatus` may still have reported
+     * the asset tradable. The request then rejects with a 409 carrying
+     * `code: "not_tradable"`; tell it apart from a failure with
+     * {@link isOndoNotTradableError}. Retrying before the market opens fails the
+     * same way.
+     */
     getQuote(params: GetOndoQuoteParams): Promise<OndoQuote>;
     /**
      * Builds a purchase for a specific wallet and deposit: spends an attestation
@@ -3135,6 +3218,365 @@ declare class RequirementsNamespaceImpl implements RequirementsNamespace {
     submitDocument(params: SubmitDocumentParams): Promise<DocumentSubmission>;
 }
 
+type GetCentrifugeVaultStatusParams = {
+    /** Share token symbol of the vault, e.g. `deJTRSY`. */
+    symbol: AssetSymbol;
+    /**
+     * The chain whose proxy answers. Only chains this offer has a proxy on
+     * are accepted; the offer's `vault_contracts` lists them.
+     */
+    chain: EthereumChain;
+};
+type GetCentrifugeVaultQuoteParams = GetCentrifugeVaultStatusParams & {
+    /**
+     * Amount to price, in the base units of the funding token. Must be greater
+     * than zero. No fee is deducted; this product charges none.
+     *
+     * Sized by `amount` alone: the quote is a free read of one spend, not a
+     * dollar figure converted later.
+     */
+    amount: BlockchainAmount;
+};
+
+/**
+ * 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;
+};
+
+/**
+ * Centrifuge vault reads: an indicative quote and the vault-wide ordering
+ * gate.
+ *
+ * Both are free to poll - neither spends an attestation, so a client may
+ * call them while the user sizes a deposit. The quote has no expiry: it is
+ * indicative, the fund prices fulfilment later, and a countdown would imply
+ * a commitment the API does not make.
+ *
+ * Every method requires `AuthState === 'logged-in'` and throws
+ * {@link NotAuthenticatedError} otherwise.
+ */
+interface CentrifugeNamespace {
+    getQuote(params: GetCentrifugeVaultQuoteParams): Promise<CentrifugeVaultQuote>;
+    getVaultStatus(params: GetCentrifugeVaultStatusParams): Promise<CentrifugeVaultStatus>;
+}
+declare class CentrifugeNamespaceImpl implements CentrifugeNamespace {
+    private readonly ctx;
+    protected readonly log: InternalLogger;
+    constructor(ctx: UniversalNamespaceContext);
+    getQuote(params: GetCentrifugeVaultQuoteParams): Promise<CentrifugeVaultQuote>;
+    getVaultStatus(params: GetCentrifugeVaultStatusParams): Promise<CentrifugeVaultStatus>;
+}
+
 /**
  * Reads over CoinList's offers: the catalogue a user can browse, and the full
  * detail of a single offer.
@@ -3350,4 +3792,4 @@ declare class TokensNamespaceImpl implements TokensNamespace {
     list(chain?: EthereumChain): Promise<TokenMetadata[]>;
 }
 
-export { OndoTradingStatus as $, AuthorizationCode as A, BlockchainAmount as B, CodeVerifier as C, TokenMetadata as D, type Erc20Namespace as E, type OfferType as F, type OndoSwapOfferDetail as G, type CoinListTokenSaleOfferDetail as H, type SuperstateSwapOfferDetail as I, Offer as J, RequirementStatusInfo as K, type Logger as L, type RequirementType as M, type RequirementStatusValue as N, OfferId as O, Participation as P, OfferOptionAddress as Q, type RequirementsNamespace as R, type SuperstateSwapNamespace as S, type TokensNamespace as T, type UniversalNamespaceContext as U, RequirementId as V, type WalletError as W, type KycLevelName as X, DocumentSubmission as Y, type WalletChallengeType as Z, type PinoLoggerOptions as _, EthereumChain as a, type GetTokenBalanceParams as a$, AssetDecimals as a0, type BuildOndoBuyParams as a1, type BuildOndoSellParams as a2, OndoQuote as a3, type OndoQuoteSize as a4, type TokenIdentifier as a5, OfferOptionAddressId as a6, TokenLogo as a7, type DebugEvent as a8, type FrontlineEventId as a9, type Newtype as aA, type AllowWalletParams as aB, AllowWalletResponse as aC, Asset as aD, AssetCode as aE, Blockchain as aF, type BuildOndoSwapParamsCore as aG, Chain as aH, ClientId as aI, CodeChallenge as aJ, type CoinListTokenSaleOffer as aK, ConnectExternalWalletParams as aL, type CreateKycTokenParams as aM, CreateParticipationParams as aN, CreateWalletOwnershipChallengeParams as aO, Cursor as aP, type DocumentFormType as aQ, type DocumentSubmissionStatus as aR, type DocumentType as aS, ETHEREUM_CHAINS as aT, Erc20NamespaceImpl as aU, FaqItem as aV, type GetOndoQuoteParams as aW, type GetOndoTradingStatusParams as aX, type GetSwapAuthorizationParams as aY, type GetSwapPreviewParams as aZ, type GetTokenAllowanceParams as a_, HttpError as aa, type HttpResponse as ab, KycToken as ac, type LogBinding as ad, type LogBindings as ae, type LogCause as af, type LogLevel as ag, type LogScope as ah, type LogValue as ai, type ProductionLogLevel as aj, RedactedWalletError as ak, type RequestId as al, type RpcFailureReason as am, type SafeEvent as an, type SafeFields as ao, type UnredactedFields as ap, OAuthSession as aq, ClientCredentialsOAuth as ar, type Sender as as, PaginationParams as at, PaginatedResponse as au, ClientSecret as av, DecimalString as aw, SwapStatus as ax, type Uint256 as ay, KnownAssetSymbol as az, EvmContractAddress as b, HexEncodedTransactionData as b0, Isin as b1, Iso2CountryCode as b2, Link as b3, type ListOptionAddressesParams as b4, MAX_ASSET_DECIMALS as b5, MAX_UINT_256 as b6, Milestone as b7, OAuthRefreshToken as b8, type OfferBase as b9, SOLANA_CHAINS as bA, STABLE_DECIMALS as bB, SolanaChain as bC, type SubmitDocumentParams as bD, type SuperstateSwapOffer as bE, type SwapContractRef as bF, SwapPreview as bG, TermItem as bH, Ticker as bI, type TokenLogoImage as bJ, TokenLogoUrl as bK, type TokenRole as bL, TokensNamespaceImpl as bM, type Tx as bN, WalletAddress as bO, WalletOwnershipChallenge as bP, type WalletProtocol as bQ, WalletsNamespaceImpl as bR, apiErrorCode as bS, assertUint256 as bT, isChain as bU, isOfferType as bV, parseUint256 as bW, type OfferDetailBase as ba, OfferEditorial as bb, OfferOption as bc, OfferOptionSlug as bd, OfferSlug as be, OfferToken as bf, OffersNamespaceImpl as bg, type OndoQuoteDuration as bh, type OndoSellOutcome as bi, type OndoSwapOffer as bj, PKCEState as bk, type PaginatedResponseDto as bl, ParticipationId as bm, type ParticipationStatus as bn, ParticipationsPaginationParams as bo, PauseFlags as bp, Pii as bq, PiiAddress as br, PiiJurisdiction as bs, type PiiKind as bt, type QueryParamValue as bu, type QueryParamValues as bv, RedirectUri as bw, type RemoveOptionAddressParams as bx, type RequirementActionNeededReason as by, type RpcConfig as bz, type CoinListTokenSaleNamespace as c, OfferOptionId as d, AssetId as e, CoinListTokenSaleNamespaceImpl as f, type OndoNamespace as g, AssetSymbol as h, OfferSwapContract as i, OndoBuyTransaction as j, OndoSellTransaction as k, type OndoSwapTransactionCore as l, type OrderBookSide as m, OndoNamespaceImpl as n, type WalletsNamespace as o, Bps as p, EvmWalletAddress as q, SuperstateSwapNamespaceImpl as r, Requirement as s, RequirementsNamespaceImpl as t, type Config as u, type OAuthAccessToken as v, type OffersNamespace as w, StablecoinSymbol as x, type Erc20Asset as y, OfferDetail as z };
+export { type WalletChallengeType as $, AuthorizationCode as A, BlockchainAmount as B, CodeVerifier as C, OfferDetail as D, type Erc20Namespace as E, TokenMetadata as F, type CentrifugeVaultOfferDetail as G, type OfferType as H, type OndoSwapOfferDetail as I, type CoinListTokenSaleOfferDetail as J, type SuperstateSwapOfferDetail as K, type Logger as L, Offer as M, RequirementStatusInfo as N, OfferId as O, Participation as P, type RequirementType as Q, type RequirementsNamespace as R, type SuperstateSwapNamespace as S, type TokensNamespace as T, type UniversalNamespaceContext as U, type RequirementStatusValue as V, type WalletError as W, OfferOptionAddress as X, RequirementId as Y, type KycLevelName as Z, DocumentSubmission as _, EthereumChain as a, CreateParticipationParams as a$, type PinoLoggerOptions as a0, type CentrifugeOrderReason as a1, type CentrifugeOrderability as a2, CentrifugeVaultQuote as a3, CentrifugeVaultStatus as a4, OndoTradingStatus as a5, AssetDecimals as a6, type BuildOndoBuyParams as a7, type BuildOndoSellParams as a8, OndoQuote as a9, PaginatedResponse as aA, ClientSecret as aB, DecimalString as aC, SwapStatus as aD, type Uint256 as aE, KnownAssetSymbol as aF, type Newtype as aG, type AllowWalletParams as aH, AllowWalletResponse as aI, Asset as aJ, AssetCode as aK, Blockchain as aL, type BuildOndoSwapParamsCore as aM, CentrifugeNamespaceImpl as aN, type CentrifugePositionStatus as aO, CentrifugeVaultBuyTransaction as aP, CentrifugeVaultClaimTransaction as aQ, type CentrifugeVaultOffer as aR, CentrifugeVaultPosition as aS, type CentrifugeVaultReason as aT, type CentrifugeVaultTransactionCore as aU, Chain as aV, ClientId as aW, CodeChallenge as aX, type CoinListTokenSaleOffer as aY, ConnectExternalWalletParams as aZ, type CreateKycTokenParams as a_, type OndoQuoteSize as aa, type TokenIdentifier as ab, OfferOptionAddressId as ac, TokenLogo as ad, type DebugEvent as ae, type FrontlineEventId as af, HttpError as ag, type HttpResponse as ah, KycToken as ai, type LogBinding as aj, type LogBindings as ak, type LogCause as al, type LogLevel as am, type LogScope as an, type LogValue as ao, type ProductionLogLevel as ap, RedactedWalletError as aq, type RequestId as ar, type RpcFailureReason as as, type SafeEvent as at, type SafeFields as au, type UnredactedFields as av, OAuthSession as aw, ClientCredentialsOAuth as ax, type Sender as ay, PaginationParams as az, EvmContractAddress as b, TokenLogoUrl as b$, CreateWalletOwnershipChallengeParams as b0, Cursor as b1, type DocumentFormType as b2, type DocumentSubmissionStatus as b3, type DocumentType as b4, ETHEREUM_CHAINS as b5, Erc20NamespaceImpl as b6, FaqItem as b7, type GetCentrifugeVaultQuoteParams as b8, type GetCentrifugeVaultStatusParams as b9, type OndoSwapOffer as bA, PKCEState as bB, type PaginatedResponseDto as bC, ParticipationId as bD, type ParticipationStatus as bE, ParticipationsPaginationParams as bF, PauseFlags as bG, Pii as bH, PiiAddress as bI, PiiJurisdiction as bJ, type PiiKind as bK, type QueryParamValue as bL, type QueryParamValues as bM, RedirectUri as bN, type RemoveOptionAddressParams as bO, type RequirementActionNeededReason as bP, type RpcConfig as bQ, SOLANA_CHAINS as bR, STABLE_DECIMALS as bS, SolanaChain as bT, type SubmitDocumentParams as bU, type SuperstateSwapOffer as bV, type SwapContractRef as bW, SwapPreview as bX, TermItem as bY, Ticker as bZ, type TokenLogoImage as b_, type GetOndoQuoteParams as ba, type GetOndoTradingStatusParams as bb, type GetSwapAuthorizationParams as bc, type GetSwapPreviewParams as bd, type GetTokenAllowanceParams as be, type GetTokenBalanceParams as bf, HexEncodedTransactionData as bg, Isin as bh, Iso2CountryCode as bi, Link as bj, type ListOptionAddressesParams as bk, MAX_ASSET_DECIMALS as bl, MAX_UINT_256 as bm, Milestone as bn, OAuthRefreshToken as bo, type OfferBase as bp, type OfferDetailBase as bq, OfferEditorial as br, OfferOption as bs, OfferOptionSlug as bt, OfferSlug as bu, OfferToken as bv, OfferVaultContract as bw, OffersNamespaceImpl as bx, type OndoQuoteDuration as by, type OndoSellOutcome as bz, type CoinListTokenSaleNamespace as c, type TokenRole as c0, TokensNamespaceImpl as c1, type Tx as c2, WalletAddress as c3, WalletOwnershipChallenge as c4, type WalletProtocol as c5, WalletsNamespaceImpl as c6, apiErrorCode as c7, assertUint256 as c8, isChain as c9, isOfferType as ca, parseUint256 as cb, OfferOptionId as d, AssetId as e, CoinListTokenSaleNamespaceImpl as f, type OndoNamespace as g, AssetSymbol as h, OfferSwapContract as i, OndoBuyTransaction as j, OndoSellTransaction as k, type OndoSwapTransactionCore as l, type OrderBookSide as m, OndoNamespaceImpl as n, type WalletsNamespace as o, Bps as p, EvmWalletAddress as q, SuperstateSwapNamespaceImpl as r, Requirement as s, RequirementsNamespaceImpl as t, type Config as u, type OAuthAccessToken as v, type OffersNamespace as w, type CentrifugeNamespace as x, StablecoinSymbol as y, type Erc20Asset as z };