@coinlist-co/react 0.12.2-rc.aa91ce3 → 0.12.2-rc.bc20f5b

package/dist/{time-DyjvzWso.d.ts → time-CVZpAkGY.d.ts}

@@ -821,36 +821,16 @@ type Erc20Asset = {
 type Bps = Newtype<bigint, 'Bps'>;
 declare const Bps: (value: bigint) => Bps;
 
-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.
-     */
+type GetTokenAllowanceParams = {
+    tokenAddress: EvmContractAddress;
+    owner: EvmWalletAddress;
+    spender: EvmContractAddress;
     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;
-};
-/**
- * One wallet on one vault: what every position read and every claim is keyed
- * by. There is no order id - a wallet has one pooled position per vault per
- * direction.
- */
-type CentrifugeWalletParams = GetCentrifugeVaultStatusParams & {
-    /**
-     * The wallet whose position is read, or claimed for. A claim must then be
-     * broadcast from this same wallet: the proxy credits the sender.
-     */
-    walletAddress: EvmWalletAddress;
+type GetTokenBalanceParams = {
+    tokenAddress: EvmContractAddress;
+    owner: EvmWalletAddress;
+    chain: EthereumChain;
 };
 
 /**
@@ -1168,6 +1148,70 @@ interface UniversalNamespaceContext {
     ensureUserAuthenticated(): Promise<void>;
 }
 
+/**
+ * Generic ERC-20 reads shared across on-chain flows (swap, token sale): the
+ * allowance an owner has granted a spender, and the raw token balance an owner
+ * holds. These are plain token reads, not tied to any single product flow.
+ *
+ * Read from the chain rather than from a CoinList endpoint. By default that
+ * goes through CoinList's authenticated JSON-RPC proxy, so a logged-out caller
+ * gets the proxy's `401` - surfaced as a viem error wrapping the SDK's
+ * `HttpError`, not as `NotAuthenticatedError`, since viem re-wraps whatever a
+ * `Transport` throws. Point `Config.rpc` at your own node for this chain and no
+ * CoinList session is involved at all. See {@link RpcConfig}.
+ */
+interface Erc20Namespace {
+    /**
+     * Reads the ERC-20 allowance an `owner` has granted a `spender`, as a raw
+     * on-chain integer.
+     */
+    getAllowance(params: GetTokenAllowanceParams): Promise<Uint256>;
+    /**
+     * Reads the raw ERC-20 balance an `owner` holds of a token.
+     */
+    getBalance(params: GetTokenBalanceParams): Promise<Uint256>;
+}
+declare class Erc20NamespaceImpl implements Erc20Namespace {
+    private readonly ctx;
+    private readonly log;
+    constructor(ctx: UniversalNamespaceContext);
+    getAllowance(params: GetTokenAllowanceParams): Promise<Uint256>;
+    getBalance(params: GetTokenBalanceParams): Promise<Uint256>;
+}
+
+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;
+};
+/**
+ * One wallet on one vault: what every position read and every claim is keyed
+ * by. There is no order id - a wallet has one pooled position per vault per
+ * direction.
+ */
+type CentrifugeWalletParams = GetCentrifugeVaultStatusParams & {
+    /**
+     * The wallet whose position is read, or claimed for. A claim must then be
+     * broadcast from this same wallet: the proxy credits the sender.
+     */
+    walletAddress: EvmWalletAddress;
+};
+/**
+ * What `POST /v1/centrifuge/vault/invest` is asked for: the wallet that will
+ * broadcast the request and fund it, plus the deposit.
+ *
+ * Built once, when the user confirms an amount. Broadcasting the result places
+ * a request; it does not buy shares.
+ */
+type BuildCentrifugeVaultBuyParams = CentrifugeWalletParams & {
+    /** How much of the funding token to deposit, in its base units. */
+    amount: BlockchainAmount;
+};
+
 /**
  * The logging surface SDK code uses. Never exported to hosts: they implement
  * {@link Logger}, which is deliberately smaller.
@@ -1255,8 +1299,8 @@ type InternalDebugEvent = {
  * 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`
+ * The GETs are free to poll. The two POSTs return calldata to broadcast:
+ * `invest` is signed for one wallet and called once on confirmation, `claim`
  * collects everything claimable and carries no amount.
  */
 /**
@@ -1264,8 +1308,8 @@ type InternalDebugEvent = {
  * 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}.
+ * `below_minimum` depends on an amount, so a vault status never reports 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. */
@@ -1276,26 +1320,6 @@ type CentrifugeVaultReasonDto = Exclude<CentrifugeOrderReasonDto, 'below_minimum
  * 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
@@ -1332,7 +1356,7 @@ type CentrifugeBroadcastDto = {
     expires_at: string | null;
 };
 /**
- * `POST /v1/centrifuge/vault/buy` with `{ symbol, chain, wallet_address,
+ * `POST /v1/centrifuge/vault/invest` with `{ symbol, chain, wallet_address,
  * amount }`. Broadcasting it places a request in the vault's queue and buys
  * nothing yet.
  */
@@ -1340,9 +1364,6 @@ 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
@@ -1460,31 +1481,6 @@ type CentrifugeOrderability<R extends CentrifugeOrderReason> = {
     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
@@ -1509,7 +1505,7 @@ type CentrifugeVaultStatus = {
     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. */
+    /** When the vault last published a price. A stale value means the price is old. */
     priceUpdatedAt: Date | null;
     orderability: CentrifugeOrderability<CentrifugeVaultReason>;
     /** When the chain was read: how old everything above is. */
@@ -1536,14 +1532,11 @@ type CentrifugeVaultTransactionCore = {
  *
  * **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.
+ * back to claim. 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;
@@ -1684,25 +1677,27 @@ declare const CentrifugeVaultClaimProceedsTransaction: {
 };
 
 /**
- * Centrifuge vault reads and claims: an indicative quote, the vault-wide
- * ordering gate, each wallet's position per direction, and the calldata that
- * claims a filled request.
+ * Centrifuge vault reads and claims: the vault-wide ordering gate, each
+ * wallet's position per direction, and the calldata that claims a filled
+ * request.
  *
  * The reads are free to poll - none spends an attestation, so a client may
- * call them while the user sizes a deposit or waits on a fill. 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.
+ * call them while the user sizes a deposit or waits on a fill.
  *
  * A vault trade settles in two legs: a request the fund fills on its own
  * schedule, then a claim. There is no order id - each wallet has one pooled
  * position per vault per direction - so the claims take a wallet, not an
  * order, and collect everything claimable.
  *
+ * The calldata builders are the exception: {@link CentrifugeNamespace.buildBuyTransaction}
+ * and the claims are each called once, when the user confirms, and never on a
+ * timer. Broadcasting the buy calldata places a request. It does not buy
+ * shares.
+ *
  * Every method requires `AuthState === 'logged-in'` and throws
  * {@link NotAuthenticatedError} otherwise.
  */
 interface CentrifugeNamespace {
-    getQuote(params: GetCentrifugeVaultQuoteParams): Promise<CentrifugeVaultQuote>;
     getVaultStatus(params: GetCentrifugeVaultStatusParams): Promise<CentrifugeVaultStatus>;
     /** The wallet's invest position: funding queued, shares claimable. */
     getPosition(params: CentrifugeWalletParams): Promise<CentrifugeVaultPosition>;
@@ -1724,61 +1719,45 @@ interface CentrifugeNamespace {
      * TODO(frontline, ENG-1909): built against a guessed endpoint.
      */
     createClaimProceeds(params: CentrifugeWalletParams): Promise<CentrifugeVaultClaimProceedsTransaction>;
+    /**
+     * Builds the calldata that places a deposit request.
+     *
+     * Called once on confirmation. The reads above are the ones a checkout polls.
+     */
+    buildBuyTransaction(params: BuildCentrifugeVaultBuyParams): Promise<CentrifugeVaultBuyTransaction>;
 }
 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>;
     getPosition(params: CentrifugeWalletParams): Promise<CentrifugeVaultPosition>;
     getRedeemPosition(params: CentrifugeWalletParams): Promise<CentrifugeVaultRedeemPosition>;
     createClaim(params: CentrifugeWalletParams): Promise<CentrifugeVaultClaimTransaction>;
     createClaimProceeds(params: CentrifugeWalletParams): Promise<CentrifugeVaultClaimProceedsTransaction>;
+    buildBuyTransaction(params: BuildCentrifugeVaultBuyParams): Promise<CentrifugeVaultBuyTransaction>;
 }
 
-type GetTokenAllowanceParams = {
-    tokenAddress: EvmContractAddress;
-    owner: EvmWalletAddress;
-    spender: EvmContractAddress;
-    chain: EthereumChain;
-};
-type GetTokenBalanceParams = {
-    tokenAddress: EvmContractAddress;
-    owner: EvmWalletAddress;
-    chain: EthereumChain;
+type AssetDto = {
+    code: string;
+    fractional_digits: number;
+    id: string;
+    name: string;
 };
 
-/**
- * Generic ERC-20 reads shared across on-chain flows (swap, token sale): the
- * allowance an owner has granted a spender, and the raw token balance an owner
- * holds. These are plain token reads, not tied to any single product flow.
- *
- * Read from the chain rather than from a CoinList endpoint. By default that
- * goes through CoinList's authenticated JSON-RPC proxy, so a logged-out caller
- * gets the proxy's `401` - surfaced as a viem error wrapping the SDK's
- * `HttpError`, not as `NotAuthenticatedError`, since viem re-wraps whatever a
- * `Transport` throws. Point `Config.rpc` at your own node for this chain and no
- * CoinList session is involved at all. See {@link RpcConfig}.
- */
-interface Erc20Namespace {
-    /**
-     * Reads the ERC-20 allowance an `owner` has granted a `spender`, as a raw
-     * on-chain integer.
-     */
-    getAllowance(params: GetTokenAllowanceParams): Promise<Uint256>;
-    /**
-     * Reads the raw ERC-20 balance an `owner` holds of a token.
-     */
-    getBalance(params: GetTokenBalanceParams): Promise<Uint256>;
-}
-declare class Erc20NamespaceImpl implements Erc20Namespace {
-    private readonly ctx;
-    private readonly log;
-    constructor(ctx: UniversalNamespaceContext);
-    getAllowance(params: GetTokenAllowanceParams): Promise<Uint256>;
-    getBalance(params: GetTokenBalanceParams): Promise<Uint256>;
-}
+type AssetId = Newtype<string, 'AssetId'>;
+declare const AssetId: (value: string) => AssetId;
+type AssetCode = Newtype<string, 'AssetCode'>;
+declare const AssetCode: (value: string) => AssetCode;
+type Asset = {
+    id: AssetId;
+    code: AssetCode;
+    name: string;
+    fractionalDigits: number;
+};
+declare const Asset: {
+    fromDto: (dto: AssetDto) => Asset;
+};
 
 /**
  * The product an offer is checked out through. The backend sends one compound
@@ -1854,189 +1833,6 @@ type OfferTokenDto = {
     address: string;
 };
 
-type OfferId = Newtype<string, 'OfferId'>;
-declare const OfferId: (value: string) => OfferId;
-type OfferSlug = Newtype<string, 'OfferSlug'>;
-declare const OfferSlug: (value: string) => OfferSlug;
-type OfferType = OfferTypeDto;
-declare const isOfferType: (value: string) => value is OfferType;
-type OfferBase = {
-    id: OfferId;
-    slug: OfferSlug;
-    endsAt: Date | null;
-    tokens: OfferToken[];
-};
-type CoinListTokenSaleOffer = OfferBase & OfferEditorial & {
-    type: 'coinlist::token_sale';
-    logoUrl: string;
-};
-type SuperstateSwapOffer = OfferBase & OfferEditorial & {
-    type: 'superstate::swap';
-    /** Null when nobody has uploaded artwork: a swap publishes without it. */
-    logoUrl: string | null;
-};
-type OndoSwapOffer = OfferBase & {
-    type: 'ondo::swap';
-    /** 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 and a Centrifuge vault takes deposits continuously, so
- * neither runs one and neither carries any.
- */
-type OfferEditorial = {
-    tagline: string;
-    bannerUrl: string;
-    startsAt: Date;
-};
-declare const OfferEditorial: {
-    /**
-     * `model` prefixes the field in the error (`'Offer'`, `'OfferDetail'`), so
-     * the same three checks name the payload that failed them.
-     */
-    fromDto: (dto: OfferEditorialDto, model: string) => OfferEditorial;
-};
-/**
- * An offer as `GET /v1/offers` lists it: a union on {@link OfferType}, each
- * variant carrying only the fields that mean something for it. Narrow on
- * `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 | CentrifugeVaultOffer;
-declare const Offer: {
-    fromDto: (dto: OfferDto) => Offer;
-    /**
-     * Maps a page of offers, dropping every offer whose `type` this SDK does not
-     * name. The same reasoning as {@link OfferToken.listFromDto}: a plain `.map`
-     * would throw out of `fromDto` and, through `PaginatedResponse.fromDto`,
-     * reject the whole page, so one offer of an unknown type would blank the
-     * grid for every offer beside it. A single offer fetched by id still
-     * throws, because there is nothing beside it to keep.
-     */
-    listFromDto: (dtos: OfferDto[]) => Offer[];
-};
-/**
- * `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;
-    address: EvmContractAddress;
-};
-declare const OfferToken: {
-    fromDto: (dto: OfferTokenDto) => OfferToken;
-    /**
-     * Maps an offer's token list, dropping every token on a chain this SDK does
-     * not name. Frontline's chain registry runs ahead of {@link Chain}, and a
-     * plain `.map` would throw out of `Offer.fromDto` and, through
-     * `PaginatedResponse.fromDto`, reject the whole offers page - which is how
-     * one Base token blanked production's offers list. Dropping costs that
-     * token's metadata alone: `coinlist.tokens.get` takes an `EthereumChain`,
-     * so nobody could have looked it up anyway.
-     *
-     * Same shape as `TokenMetadata.fromRegistryDto`.
-     */
-    listFromDto: (dtos: OfferTokenDto[]) => OfferToken[];
-};
-
-/**
- * The cursor-paginated envelope every list endpoint returns.
- *
- * Generic in its item type, so each resource pairs it with its own item DTO
- * rather than declaring an envelope of its own.
- */
-interface PaginatedResponseDto<T> {
-    data: T[];
-    starting_after?: string;
-    starting_before?: string;
-}
-
-type Cursor = Newtype<string, 'Cursor'>;
-declare const Cursor: (value: string) => Cursor;
-interface PaginatedResponse<T> {
-    data: T[];
-    startingAfter: Cursor | null;
-    startingBefore: Cursor | null;
-}
-declare const PaginatedResponse: {
-    fromDto: <A, B>(dto: PaginatedResponseDto<A>, itemMapper: (item: A) => B) => PaginatedResponse<B>;
-    /**
-     * For a mapper that decides the page as a whole - one that drops items it
-     * cannot map, such as `Offer.listFromDto` - rather than item by item. The
-     * cursors are the wire's either way: dropping an item changes what the
-     * page holds, not where the next page starts.
-     */
-    fromDtoPage: <A, B>(dto: PaginatedResponseDto<A>, pageMapper: (items: A[]) => B[]) => PaginatedResponse<B>;
-};
-/**
- * Cursor-based pagination input used when requesting paginated API resources.
- * Set `after` or `before` to navigate relative to a known cursor, and `limit`
- * to control the maximum number of returned items.
- */
-interface PaginationParams {
-    before?: Cursor;
-    after?: Cursor;
-    limit?: number;
-}
-declare const PaginationParams: {
-    toQueryParams: (params: PaginationParams) => Record<string, QueryParamValue>;
-};
-
-type AssetDto = {
-    code: string;
-    fractional_digits: number;
-    id: string;
-    name: string;
-};
-
-type AssetId = Newtype<string, 'AssetId'>;
-declare const AssetId: (value: string) => AssetId;
-type AssetCode = Newtype<string, 'AssetCode'>;
-declare const AssetCode: (value: string) => AssetCode;
-type Asset = {
-    id: AssetId;
-    code: AssetCode;
-    name: string;
-    fractionalDigits: number;
-};
-declare const Asset: {
-    fromDto: (dto: AssetDto) => Asset;
-};
-
-type ParticipationStatusDto = 'prepared' | 'pending' | 'submitted' | 'completed' | 'failed' | 'remit_submitted' | 'remitted' | 'remit_failed';
-type ParticipationDto = {
-    object: 'participation';
-    id: string;
-    offer_id: string;
-    offer_option_id: string;
-    status: ParticipationStatusDto;
-    amount: string;
-    amount_string: string;
-    asset: AssetDto;
-    chain: string;
-    inserted_at: string | null | undefined;
-    updated_at: string | null | undefined;
-    wallet_address: string | null | undefined;
-};
-type CreateParticipationDto = {
-    offer_id: string;
-    offer_option_id: string;
-    chain: string;
-    wallet_address: string;
-    amount: string;
-    asset_id: string;
-    approval_transaction_hash: string | null | undefined;
-};
-
 /**
  * One variant per `OfferTypeDto`, the same split as `OfferDto` with what
  * `GET /v1/offers/:id` adds on top. Read `type` first.
@@ -2143,6 +1939,100 @@ type OfferDetailVaultContractDto = {
     address: string;
 };
 
+type OfferId = Newtype<string, 'OfferId'>;
+declare const OfferId: (value: string) => OfferId;
+type OfferSlug = Newtype<string, 'OfferSlug'>;
+declare const OfferSlug: (value: string) => OfferSlug;
+type OfferType = OfferTypeDto;
+declare const isOfferType: (value: string) => value is OfferType;
+type OfferBase = {
+    id: OfferId;
+    slug: OfferSlug;
+    endsAt: Date | null;
+    tokens: OfferToken[];
+};
+type CoinListTokenSaleOffer = OfferBase & OfferEditorial & {
+    type: 'coinlist::token_sale';
+    logoUrl: string;
+};
+type SuperstateSwapOffer = OfferBase & OfferEditorial & {
+    type: 'superstate::swap';
+    /** Null when nobody has uploaded artwork: a swap publishes without it. */
+    logoUrl: string | null;
+};
+type OndoSwapOffer = OfferBase & {
+    type: 'ondo::swap';
+    /** 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 and a Centrifuge vault takes deposits continuously, so
+ * neither runs one and neither carries any.
+ */
+type OfferEditorial = {
+    tagline: string;
+    bannerUrl: string;
+    startsAt: Date;
+};
+declare const OfferEditorial: {
+    /**
+     * `model` prefixes the field in the error (`'Offer'`, `'OfferDetail'`), so
+     * the same three checks name the payload that failed them.
+     */
+    fromDto: (dto: OfferEditorialDto, model: string) => OfferEditorial;
+};
+/**
+ * An offer as `GET /v1/offers` lists it: a union on {@link OfferType}, each
+ * variant carrying only the fields that mean something for it. Narrow on
+ * `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 | CentrifugeVaultOffer;
+declare const Offer: {
+    fromDto: (dto: OfferDto) => Offer;
+    /**
+     * Maps a page of offers, dropping every offer whose `type` this SDK does not
+     * name. The same reasoning as {@link OfferToken.listFromDto}: a plain `.map`
+     * would throw out of `fromDto` and, through `PaginatedResponse.fromDto`,
+     * reject the whole page, so one offer of an unknown type would blank the
+     * grid for every offer beside it. A single offer fetched by id still
+     * throws, because there is nothing beside it to keep.
+     */
+    listFromDto: (dtos: OfferDto[]) => Offer[];
+};
+/**
+ * `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;
+    address: EvmContractAddress;
+};
+declare const OfferToken: {
+    fromDto: (dto: OfferTokenDto) => OfferToken;
+    /**
+     * Maps an offer's token list, dropping every token on a chain this SDK does
+     * not name. Frontline's chain registry runs ahead of {@link Chain}, and a
+     * plain `.map` would throw out of `Offer.fromDto` and, through
+     * `PaginatedResponse.fromDto`, reject the whole offers page - which is how
+     * one Base token blanked production's offers list. Dropping costs that
+     * token's metadata alone: `coinlist.tokens.get` takes an `EthereumChain`,
+     * so nobody could have looked it up anyway.
+     *
+     * Same shape as `TokenMetadata.fromRegistryDto`.
+     */
+    listFromDto: (dtos: OfferTokenDto[]) => OfferToken[];
+};
+
 type Ticker = Newtype<string, 'Ticker'>;
 declare const Ticker: (value: string) => Ticker;
 /**
@@ -2366,6 +2256,74 @@ declare const Milestone: {
     fromDto: (dto: OfferDetailMilestoneDto) => Milestone;
 };
 
+/**
+ * The cursor-paginated envelope every list endpoint returns.
+ *
+ * Generic in its item type, so each resource pairs it with its own item DTO
+ * rather than declaring an envelope of its own.
+ */
+interface PaginatedResponseDto<T> {
+    data: T[];
+    starting_after?: string;
+    starting_before?: string;
+}
+
+type Cursor = Newtype<string, 'Cursor'>;
+declare const Cursor: (value: string) => Cursor;
+interface PaginatedResponse<T> {
+    data: T[];
+    startingAfter: Cursor | null;
+    startingBefore: Cursor | null;
+}
+declare const PaginatedResponse: {
+    fromDto: <A, B>(dto: PaginatedResponseDto<A>, itemMapper: (item: A) => B) => PaginatedResponse<B>;
+    /**
+     * For a mapper that decides the page as a whole - one that drops items it
+     * cannot map, such as `Offer.listFromDto` - rather than item by item. The
+     * cursors are the wire's either way: dropping an item changes what the
+     * page holds, not where the next page starts.
+     */
+    fromDtoPage: <A, B>(dto: PaginatedResponseDto<A>, pageMapper: (items: A[]) => B[]) => PaginatedResponse<B>;
+};
+/**
+ * Cursor-based pagination input used when requesting paginated API resources.
+ * Set `after` or `before` to navigate relative to a known cursor, and `limit`
+ * to control the maximum number of returned items.
+ */
+interface PaginationParams {
+    before?: Cursor;
+    after?: Cursor;
+    limit?: number;
+}
+declare const PaginationParams: {
+    toQueryParams: (params: PaginationParams) => Record<string, QueryParamValue>;
+};
+
+type ParticipationStatusDto = 'prepared' | 'pending' | 'submitted' | 'completed' | 'failed' | 'remit_submitted' | 'remitted' | 'remit_failed';
+type ParticipationDto = {
+    object: 'participation';
+    id: string;
+    offer_id: string;
+    offer_option_id: string;
+    status: ParticipationStatusDto;
+    amount: string;
+    amount_string: string;
+    asset: AssetDto;
+    chain: string;
+    inserted_at: string | null | undefined;
+    updated_at: string | null | undefined;
+    wallet_address: string | null | undefined;
+};
+type CreateParticipationDto = {
+    offer_id: string;
+    offer_option_id: string;
+    chain: string;
+    wallet_address: string;
+    amount: string;
+    asset_id: string;
+    approval_transaction_hash: string | null | undefined;
+};
+
 /** Unique identifier for a participation. */
 type ParticipationId = Newtype<string, 'ParticipationId'>;
 /** Casts a string into a typed {@link ParticipationId}. */
@@ -4026,4 +3984,4 @@ declare function isExpired({ expiresAt, now, buffer, }: {
     buffer?: Millis;
 }): boolean;
 
-export { type RequirementType as $, AuthorizationCode as A, BlockchainAmount as B, CodeVerifier as C, StablecoinSymbol as D, EthereumChain as E, type Erc20Asset as F, OfferDetail as G, TokenMetadata as H, type CentrifugeVaultOfferDetail as I, type OfferType as J, type OndoSwapOfferDetail as K, type Logger as L, type CoinListTokenSaleOfferDetail as M, type SuperstateSwapOfferDetail as N, OfferId as O, Participation as P, CentrifugeVaultLegId as Q, type RequirementsNamespace as R, type SuperstateSwapNamespace as S, type TokensNamespace as T, type UniversalNamespaceContext as U, Seconds as V, type WalletError as W, type AsyncOfferType as X, AsyncOfferDetail as Y, Offer as Z, RequirementStatusInfo as _, type CentrifugeNamespace as a, type CentrifugeVaultReason as a$, type RequirementStatusValue as a0, OfferOptionAddress as a1, RequirementId as a2, type KycLevelName as a3, DocumentSubmission as a4, type WalletChallengeType as a5, type PinoLoggerOptions as a6, type CentrifugeOrderReason as a7, type CentrifugeOrderability as a8, CentrifugeVaultQuote as a9, type SafeEvent as aA, type SafeFields as aB, type UnredactedFields as aC, OAuthSession as aD, ClientCredentialsOAuth as aE, type Sender as aF, PaginationParams as aG, PaginatedResponse as aH, ClientSecret as aI, OfferToken as aJ, DecimalString as aK, SwapStatus as aL, type Uint256 as aM, KnownAssetSymbol as aN, type Newtype as aO, type AllowWalletParams as aP, AllowWalletResponse as aQ, Asset as aR, AssetCode as aS, Blockchain as aT, type BuildOndoSwapParamsCore as aU, type CentrifugePositionStatus as aV, CentrifugeVaultBuyTransaction as aW, CentrifugeVaultClaimProceedsTransaction as aX, CentrifugeVaultClaimTransaction as aY, type CentrifugeVaultOffer as aZ, CentrifugeVaultPosition as a_, OndoTradingStatus as aa, AssetDecimals as ab, type BuildOndoBuyParams as ac, type BuildOndoSellParams as ad, OndoQuote as ae, type OndoQuoteSize as af, type TokenIdentifier as ag, CentrifugeVaultLeg as ah, OfferOptionAddressId as ai, CentrifugeVaultStatus as aj, TokenLogo as ak, type DebugEvent as al, type FrontlineEventId as am, HttpError as an, type HttpResponse as ao, KycToken as ap, type LogBinding as aq, type LogBindings as ar, type LogCause as as, type LogLevel as at, type LogScope as au, type LogValue as av, type ProductionLogLevel as aw, RedactedWalletError as ax, type RequestId as ay, type RpcFailureReason as az, AssetSymbol as b, type RpcConfig as b$, CentrifugeVaultRedeemPosition as b0, type CentrifugeVaultTransactionCore as b1, type CentrifugeWalletParams as b2, Chain as b3, ClientId as b4, CodeChallenge as b5, type CoinListTokenSaleOffer as b6, ConnectExternalWalletParams as b7, type CreateKycTokenParams as b8, CreateParticipationParams as b9, OAuthRefreshToken as bA, type OfferBase as bB, type OfferDetailBase as bC, OfferEditorial as bD, OfferOption as bE, OfferOptionSlug as bF, OfferSlug as bG, OfferVaultContract as bH, OffersNamespaceImpl as bI, type OndoQuoteDuration as bJ, type OndoSellOutcome as bK, type OndoSwapOffer as bL, PKCEState as bM, type PaginatedResponseDto as bN, ParticipationId as bO, type ParticipationStatus as bP, ParticipationsPaginationParams as bQ, PauseFlags as bR, Pii as bS, PiiAddress as bT, PiiJurisdiction as bU, type PiiKind as bV, type QueryParamValue as bW, type QueryParamValues as bX, RedirectUri as bY, type RemoveOptionAddressParams as bZ, type RequirementActionNeededReason as b_, CreateWalletOwnershipChallengeParams as ba, Cursor as bb, type DocumentFormType as bc, type DocumentSubmissionStatus as bd, type DocumentType as be, ETHEREUM_CHAINS as bf, EpochMillis as bg, Erc20NamespaceImpl as bh, FaqItem as bi, type GetCentrifugeVaultQuoteParams as bj, type GetCentrifugeVaultStatusParams as bk, type GetOndoQuoteParams as bl, type GetOndoTradingStatusParams as bm, type GetSwapAuthorizationParams as bn, type GetSwapPreviewParams as bo, type GetTokenAllowanceParams as bp, type GetTokenBalanceParams as bq, HexEncodedTransactionData as br, Isin as bs, Iso2CountryCode as bt, Link as bu, type ListOptionAddressesParams as bv, MAX_ASSET_DECIMALS as bw, MAX_UINT_256 as bx, Milestone as by, Millis as bz, type CentrifugeClaimDirection as c, SOLANA_CHAINS as c0, STABLE_DECIMALS as c1, SolanaChain as c2, type SubmitDocumentParams as c3, type SuperstateSwapOffer as c4, type SwapContractRef as c5, SwapPreview as c6, TermItem as c7, Ticker as c8, type TokenLogoImage as c9, TokenLogoUrl as ca, type TokenRole as cb, TokensNamespaceImpl as cc, type Tx as cd, WalletAddress as ce, WalletOwnershipChallenge as cf, type WalletProtocol as cg, WalletsNamespaceImpl as ch, apiErrorCode as ci, assertUint256 as cj, isChain as ck, isExpired as cl, isOfferType as cm, parseUint256 as cn, CentrifugeNamespaceImpl as d, type Erc20Namespace as e, EvmContractAddress as f, type CoinListTokenSaleNamespace as g, OfferOptionId as h, AssetId as i, CoinListTokenSaleNamespaceImpl as j, type OndoNamespace as k, OfferSwapContract as l, OndoBuyTransaction as m, OndoSellTransaction as n, type OndoSwapTransactionCore as o, type OrderBookSide as p, OndoNamespaceImpl as q, type WalletsNamespace as r, Bps as s, EvmWalletAddress as t, SuperstateSwapNamespaceImpl as u, Requirement as v, RequirementsNamespaceImpl as w, type Config as x, type OAuthAccessToken as y, type OffersNamespace as z };
+export { Offer as $, AuthorizationCode as A, BlockchainAmount as B, CodeVerifier as C, type OAuthAccessToken as D, type Erc20Namespace as E, type OffersNamespace as F, StablecoinSymbol as G, type Erc20Asset as H, OfferDetail as I, TokenMetadata as J, type CentrifugeVaultOfferDetail as K, type Logger as L, type OfferType as M, type OndoSwapOfferDetail as N, OfferVaultContract as O, Participation as P, type CoinListTokenSaleOfferDetail as Q, type RequirementsNamespace as R, type SuperstateSwapNamespace as S, type TokensNamespace as T, type UniversalNamespaceContext as U, type SuperstateSwapOfferDetail as V, type WalletError as W, CentrifugeVaultLegId as X, Seconds as Y, type AsyncOfferType as Z, AsyncOfferDetail as _, EthereumChain as a, CentrifugeVaultPosition as a$, RequirementStatusInfo as a0, type RequirementType as a1, type RequirementStatusValue as a2, OfferOptionAddress as a3, RequirementId as a4, type KycLevelName as a5, DocumentSubmission as a6, type WalletChallengeType as a7, type PinoLoggerOptions as a8, AssetDecimals as a9, type RequestId as aA, type RpcFailureReason as aB, type SafeEvent as aC, type SafeFields as aD, type UnredactedFields as aE, OAuthSession as aF, ClientCredentialsOAuth as aG, type Sender as aH, PaginationParams as aI, PaginatedResponse as aJ, ClientSecret as aK, OfferToken as aL, DecimalString as aM, SwapStatus as aN, type Uint256 as aO, KnownAssetSymbol as aP, type Newtype as aQ, type AllowWalletParams as aR, AllowWalletResponse as aS, Asset as aT, AssetCode as aU, Blockchain as aV, type BuildOndoSwapParamsCore as aW, type CentrifugePositionStatus as aX, CentrifugeVaultClaimProceedsTransaction as aY, CentrifugeVaultClaimTransaction as aZ, type CentrifugeVaultOffer as a_, type BuildCentrifugeVaultBuyParams as aa, type CentrifugeOrderReason as ab, type CentrifugeOrderability as ac, OndoTradingStatus as ad, type BuildOndoBuyParams as ae, type BuildOndoSellParams as af, OndoQuote as ag, type OndoQuoteSize as ah, type TokenIdentifier as ai, CentrifugeVaultLeg as aj, OfferOptionAddressId as ak, CentrifugeVaultStatus as al, TokenLogo as am, type DebugEvent as an, type FrontlineEventId as ao, HttpError as ap, type HttpResponse as aq, KycToken as ar, type LogBinding as as, type LogBindings as at, type LogCause as au, type LogLevel as av, type LogScope as aw, type LogValue as ax, type ProductionLogLevel as ay, RedactedWalletError as az, EvmContractAddress as b, SOLANA_CHAINS as b$, type CentrifugeVaultReason as b0, CentrifugeVaultRedeemPosition as b1, type CentrifugeVaultTransactionCore as b2, type CentrifugeWalletParams as b3, Chain as b4, ClientId as b5, CodeChallenge as b6, type CoinListTokenSaleOffer as b7, ConnectExternalWalletParams as b8, type CreateKycTokenParams as b9, OAuthRefreshToken as bA, type OfferBase as bB, type OfferDetailBase as bC, OfferEditorial as bD, OfferOption as bE, OfferOptionSlug as bF, OfferSlug as bG, OffersNamespaceImpl as bH, type OndoQuoteDuration as bI, type OndoSellOutcome as bJ, type OndoSwapOffer as bK, PKCEState as bL, type PaginatedResponseDto as bM, ParticipationId as bN, type ParticipationStatus as bO, ParticipationsPaginationParams as bP, PauseFlags as bQ, Pii as bR, PiiAddress as bS, PiiJurisdiction as bT, type PiiKind as bU, type QueryParamValue as bV, type QueryParamValues as bW, RedirectUri as bX, type RemoveOptionAddressParams as bY, type RequirementActionNeededReason as bZ, type RpcConfig as b_, CreateParticipationParams as ba, CreateWalletOwnershipChallengeParams as bb, Cursor as bc, type DocumentFormType as bd, type DocumentSubmissionStatus as be, type DocumentType as bf, ETHEREUM_CHAINS as bg, EpochMillis as bh, Erc20NamespaceImpl as bi, FaqItem as bj, type GetCentrifugeVaultStatusParams as bk, type GetOndoQuoteParams as bl, type GetOndoTradingStatusParams as bm, type GetSwapAuthorizationParams as bn, type GetSwapPreviewParams as bo, type GetTokenAllowanceParams as bp, type GetTokenBalanceParams as bq, HexEncodedTransactionData as br, Isin as bs, Iso2CountryCode as bt, Link as bu, type ListOptionAddressesParams as bv, MAX_ASSET_DECIMALS as bw, MAX_UINT_256 as bx, Milestone as by, Millis as bz, type CentrifugeNamespace as c, STABLE_DECIMALS as c0, SolanaChain as c1, type SubmitDocumentParams as c2, type SuperstateSwapOffer as c3, type SwapContractRef as c4, SwapPreview as c5, TermItem as c6, Ticker as c7, type TokenLogoImage as c8, TokenLogoUrl as c9, type TokenRole as ca, TokensNamespaceImpl as cb, type Tx as cc, WalletAddress as cd, WalletOwnershipChallenge as ce, type WalletProtocol as cf, WalletsNamespaceImpl as cg, apiErrorCode as ch, assertUint256 as ci, isChain as cj, isExpired as ck, isOfferType as cl, parseUint256 as cm, AssetSymbol as d, CentrifugeVaultBuyTransaction as e, type CentrifugeClaimDirection as f, CentrifugeNamespaceImpl as g, type CoinListTokenSaleNamespace as h, OfferId as i, OfferOptionId as j, AssetId as k, CoinListTokenSaleNamespaceImpl as l, type OndoNamespace as m, OfferSwapContract as n, OndoBuyTransaction as o, OndoSellTransaction as p, type OndoSwapTransactionCore as q, type OrderBookSide as r, OndoNamespaceImpl as s, type WalletsNamespace as t, Bps as u, EvmWalletAddress as v, SuperstateSwapNamespaceImpl as w, Requirement as x, RequirementsNamespaceImpl as y, type Config as z };