@coinlist-co/react 0.11.0 → 0.11.1-rc.8cfcd2a

package/dist/client/index.d.cts

@@ -1,10 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, ButtonHTMLAttributes } from 'react';
-import { A as AuthorizationCode, C as CodeVerifier, E as EvmWalletAddress, a as EthereumChain, T as Tx, b as Erc20Namespace, c as EvmContractAddress, B as BlockchainAmount, d as CoinListTokenSaleNamespace, O as OfferId, e as OfferOptionId, f as AssetId, P as Participation, g as CoinListTokenSaleNamespaceImpl, S as SharedNamespaceContext, h as OndoNamespace, i as AssetSymbol, j as OndoSwapTransaction, k as OndoNamespaceImpl, l as SuperstateSwapNamespace, W as WalletsNamespace, m as Bps, n as SuperstateSwapNamespaceImpl, R as RequirementsNamespace, o as Requirement, p as RequirementsNamespaceImpl, q as Config, r as OAuthAccessToken, s as OffersNamespace, t as TokensNamespace, u as Erc20Asset, v as OfferDetail, w as StablecoinSymbol, x as OfferType, y as Offer, z as RequirementStatusInfo, D as RequirementType, F as RequirementStatusValue, G as OfferOptionAddress, H as RequirementId, K as KycLevelName, I as WalletChallengeType, J as DocumentSubmission, L as OndoTradingStatus, M as AssetDecimals, N as OndoQuote, Q as OrderBookSide, U as OndoQuoteSize, V as BuildOndoSwapTransactionParams, X as OfferOptionAddressId, Y as TokenMetadata, Z as TokenIdentifier } from '../config-B5mwS_2l.cjs';
-export { _ as HttpError, $ as HttpResponse, a0 as KycToken } from '../config-B5mwS_2l.cjs';
-import { P as PKCEConfig, S as SwapQuote, A as AssetIconUrl, a as ShortenedWalletAddress, F as FormattedAmountAssetUi, b as FormattedPercentUi, T as TxExplorerUrl, N as NonEmptyArray } from '../collections-BhDkYmzV.cjs';
-import { Hash, Hex, Abi, TransactionReceipt } from 'viem';
+import { A as AuthorizationCode, C as CodeVerifier, L as Logger, W as WalletError, E as Erc20Namespace, a as EthereumChain, b as EvmContractAddress, B as BlockchainAmount, c as CoinListTokenSaleNamespace, O as OfferId, d as OfferOptionId, e as AssetId, P as Participation, f as CoinListTokenSaleNamespaceImpl, S as SharedNamespaceContext, g as OndoNamespace, h as AssetSymbol, i as OndoSwapTransaction, j as OndoNamespaceImpl, k as SuperstateSwapNamespace, l as WalletsNamespace, m as Bps, n as EvmWalletAddress, o as SuperstateSwapNamespaceImpl, R as RequirementsNamespace, p as Requirement, q as RequirementsNamespaceImpl, r as Config, s as OAuthAccessToken, t as OffersNamespace, T as TokensNamespace, u as Erc20Asset, v as OfferDetail, w as StablecoinSymbol, x as OfferType, y as Offer, z as RequirementStatusInfo, D as RequirementType, F as RequirementStatusValue, G as OfferOptionAddress, H as RequirementId, K as KycLevelName, I as DocumentSubmission, J as WalletChallengeType, M as PinoLoggerOptions, N as OndoTradingStatus, Q as AssetDecimals, U as OndoQuote, V as OrderBookSide, X as OndoQuoteSize, Y as BuildOndoSwapTransactionParams, Z as OfferOptionAddressId, _ as TokenMetadata, $ as TokenIdentifier } from '../config-C6vlghJY.cjs';
+export { a0 as DebugEvent, a1 as FrontlineEventId, a2 as HttpError, a3 as HttpResponse, a4 as KycToken, a5 as LogBinding, a6 as LogBindings, a7 as LogCause, a8 as LogLevel, a9 as LogScope, aa as LogValue, ab as ProductionLogLevel, ac as RedactedWalletError, ad as RequestId, ae as SafeEvent, af as SafeFields, ag as UnredactedFields } from '../config-C6vlghJY.cjs';
+import { P as PKCEConfig, E as EvmWallet, S as SwapQuote, A as AssetIconUrl, a as ShortenedWalletAddress, F as FormattedAmountAssetUi, b as FormattedPercentUi, T as TxExplorerUrl, C as ConnectWallet, N as NonEmptyArray } from '../collections-DrJFEDHl.cjs';
+export { B as BroadcastTxParams, c as EvmSigner, W as WriteContractParams } from '../collections-DrJFEDHl.cjs';
+import { Hash } from 'viem';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 
@@ -94,84 +95,24 @@ type ClientAuthSession = {
  */
 type ClientAuthConfig = PKCEConfig & {
     readonly coinlistBaseUrl?: string;
+    readonly logger?: Logger;
 };
 declare class ClientAuthNamespaceImpl implements ClientAuthNamespace {
     private readonly config;
     private readonly session;
+    private readonly log;
     constructor(config: ClientAuthConfig, session: ClientAuthSession);
     getState(): AuthState;
     startOAuth(): Promise<void>;
+    private redirectToOAuth;
+    /**
+     * Every failure here is silent from the browser's side - a state mismatch
+     * and a missing verifier both just leave the user logged out - so the
+     * reason is logged rather than left for the host to infer from a callback.
+     */
     completeOAuth(): OauthClientResult;
     logout(): void;
-}
-
-/**
- * A classified wallet/transaction failure. The SDK derives this from whatever
- * the {@link EvmWallet} throws, so consumers get a stable, typed error
- * shape regardless of the underlying wallet library.
- */
-type WalletError = {
-    type: 'user_rejected';
-} | {
-    type: 'insufficient_funds';
-} | {
-    type: 'contract_reverted';
-    reason: string;
-} | {
-    type: 'timeout';
-    hash: Hash;
-} | {
-    type: 'unknown';
-    cause: unknown;
-};
-/**
- * Classifies an error thrown by an {@link EvmWallet} into a typed
- * {@link WalletError}. Pass the transaction `hash` when awaiting a receipt so a
- * timeout can be reported against it.
- */
-declare function classifyWalletError(error: unknown, ctx?: {
-    hash?: Hash;
-}): WalletError;
-
-type WriteContractParams = {
-    abi: Abi;
-    address: `0x${string}`;
-    functionName: string;
-    args?: readonly unknown[];
-    value?: bigint;
-    chain: EthereumChain;
-};
-type BroadcastTxParams = Tx & {
-    chain: EthereumChain;
-};
-/**
- * The signing-only wallet capability: address + `signMessage`. This is all the
- * external-wallet ownership proof needs (see `useConnectWallet`), so hosts can
- * satisfy that flow without implementing on-chain capabilities. The richer
- * {@link EvmWallet} extends this for swap flows.
- *
- * SDK users implement this against their own wallet stack (e.g. viem, wagmi,
- * Privy). `signMessage` throws on failure and the SDK classifies it.
- */
-interface EvmSigner {
-    readonly address: EvmWalletAddress;
-    signMessage(message: string): Promise<Hex>;
-}
-/**
- * The full on-chain wallet the SDK needs to run the swap flows: an
- * {@link EvmSigner} plus contract writes, raw-tx broadcast, and confirmation.
- * SDK users implement this against their own wallet stack (e.g. viem, wagmi,
- * Privy).
- *
- * Methods throw on failure. The SDK catches and classifies the thrown error
- * (viem's `UserRejectedRequestError`, `InsufficientFundsError`, timeouts, …)
- * into a typed {@link WalletError}, so implementers can simply let their wallet
- * library's errors propagate.
- */
-interface EvmWallet extends EvmSigner {
-    writeContract(params: WriteContractParams): Promise<Hash>;
-    broadcastRawTx(params: BroadcastTxParams): Promise<Hash>;
-    awaitTx(hash: Hash, chain: EthereumChain): Promise<TransactionReceipt>;
+    private readOauthCallback;
 }
 
 type Erc20AllowancePhase = 'checking-allowance' | 'resetting-allowance' | 'confirming-allowance-reset' | 'approving' | 'confirming-approval';
@@ -660,6 +601,8 @@ interface ClientSupportNamespace {
     contact(): void;
 }
 declare class ClientSupportNamespaceImpl implements ClientSupportNamespace {
+    private readonly log;
+    constructor(logger?: Logger | null);
     contact(): void;
 }
 
@@ -2094,8 +2037,8 @@ interface SuperstateAmountViewProps {
  * and every interaction leaves through `onEvent`.
  *
  * The field is dollar-denominated, so the `$` goes in `CheckoutAmountInput`'s
- * `prefix` slot — where Ondo puts its asset symbol in `suffix`. Nothing here is
- * submitted: confirming only moves the flow to the review step.
+ * `prefix` slot — where Ondo puts the symbol of the token it charges. Nothing
+ * here is submitted: confirming only moves the flow to the review step.
  *
  * Self-scoped: renders fully styled on its own, with no `CoinListStyleScope`
  * needed around it.
@@ -2774,137 +2717,6 @@ interface RequirementItemProps {
  */
 declare function RequirementItem({ ui, expanded, onToggle, className, onAction, onRemoveWallet, walletsStatus, onContactSupport, }: RequirementItemProps): react_jsx_runtime.JSX.Element;
 
-/**
- * The host-provided wallet the ownership flow signs with: the signing-only
- * {@link EvmSigner} plus the {@link EthereumChain} the signature is proven on.
- * `chain` rides on the wallet (not the offer) because the binding is
- * chain-agnostic: it only records which EVM chain signed.
- */
-type ConnectWallet = EvmSigner & {
-    readonly chain: EthereumChain;
-};
-/**
- * Machine-readable classification of a connect-wallet failure, so consumers can
- * branch on the cause (e.g. hide a retry affordance on a terminal failure)
- * instead of pattern-matching a display string.
- */
-type ConnectWalletErrorCode = 'not_authenticated' | 'user_rejected' | 'wallet_not_whitelisted' | 'max_wallets_reached' | 'unknown';
-/**
- * A classified connect-wallet failure. `retryable` is false when re-signing the
- * same wallet can never succeed (a terminal binding rejection, or no signed-in
- * session). Display copy is the caller's concern, kept out of the core.
- */
-type ConnectWalletFlowError = {
-    code: ConnectWalletErrorCode;
-    retryable: boolean;
-};
-/** Progress phases emitted by {@link connectExternalWalletFlow}, in order. */
-type ConnectWalletPhase = 'requesting-challenge' | 'signing-message' | 'submitting-signature';
-type ConnectWalletFlowResult = {
-    type: 'success';
-    binding: OfferOptionAddress;
-} | {
-    type: 'cancelled';
-} | {
-    type: 'error';
-    error: ConnectWalletFlowError;
-};
-/**
- * The client surface the flow actually depends on, kept narrow on purpose.
- *
- * Named as a structural slice rather than `Pick<CoinListClient, 'wallets'>` so
- * this feature does not import its layer's entry point: a flow takes the
- * namespaces it needs, the way `@/client/core/checkout/**` flows do.
- */
-type ConnectWalletClient = {
-    wallets: WalletsNamespace;
-};
-type ConnectWalletFlowParams = {
-    coinlist: ConnectWalletClient;
-    /** Host-provided connected wallet the flow signs with. */
-    wallet: ConnectWallet;
-    offerId: OfferId;
-    offerOptionId: OfferOptionId;
-    /** Challenge framing; defaults to `'siwe'`. */
-    challengeType?: WalletChallengeType;
-    /** SIWE statement shown in the signing prompt. */
-    statement?: string;
-    /**
-     * Polled before each irreversible step (signing, binding). Return true to
-     * abandon a superseded attempt; the flow then resolves `{ type: 'cancelled' }`
-     * without prompting the wallet or binding. React hooks pass a generation
-     * check here; non-React callers can omit it.
-     */
-    isCancelled?: () => boolean;
-    /** Reports flow progress for consumers rendering loading states. */
-    onProgress?: (phase: ConnectWalletPhase) => void;
-};
-/**
- * Drives the external-wallet ownership flow for one offer option:
- * `createWalletOwnershipChallenge` -> host `wallet.signMessage` ->
- * `connectExternalWallet`. Pure and signer-agnostic: signing is delegated to
- * the host-provided {@link ConnectWallet}, and no React is involved so non-hook
- * consumers can drive it directly (mirrors `authorizeWallet` in `swap-flows`).
- * EVM / EOA + SIWE only for now.
- */
-declare function connectExternalWalletFlow(params: ConnectWalletFlowParams): Promise<ConnectWalletFlowResult>;
-
-/**
- * A display-ready connect-wallet error: the core flow's machine-readable code
- * and `retryable` flag, plus copy for the UI.
- */
-type ConnectWalletError = {
-    code: ConnectWalletErrorCode;
-    message: string;
-    retryable: boolean;
-};
-/**
- * Signing-in-flight and the last sign error live inside the READY state (not a
- * separate top-level state) so a failed attempt returns to READY and can be
- * retried without re-opening the modal. Mirrors {@link SignState} in
- * `useTaxDocument`.
- */
-type ConnectWalletSignState = {
-    type: 'idle';
-    error: ConnectWalletError | null;
-} | {
-    type: 'signing';
-};
-type ConnectWalletState = {
-    type: 'NEEDS_WALLET';
-} | {
-    type: 'READY';
-    address: EvmWalletAddress;
-    sign: ConnectWalletSignState;
-} | {
-    type: 'CONNECTED';
-    binding: OfferOptionAddress;
-};
-interface UseConnectWalletOptions {
-    /** The hook resets state each time it opens. */
-    isOpen: boolean;
-    offerId: OfferId;
-    offerOptionId: OfferOptionId;
-    /** Host-provided connected wallet, or `null` while none is connected. */
-    wallet: ConnectWallet | null;
-    /** Challenge framing; defaults to `'siwe'`. */
-    challengeType?: WalletChallengeType;
-    /** SIWE statement shown in the signing prompt. */
-    statement?: string;
-}
-interface UseConnectWalletResult {
-    state: ConnectWalletState;
-    /** READY.sign: idle -> signing -> (CONNECTED | idle w/ error). No-op otherwise. */
-    onSign: () => void;
-}
-/**
- * React wrapper over {@link connectExternalWalletFlow}. Owns the modal state
- * machine, the display copy, and generation-token supersession (so a wallet
- * switch, modal close, or unmount cancels an in-flight attempt). The flow logic
- * itself lives in the framework-free core so non-React consumers can drive it.
- */
-declare function useConnectWallet({ isOpen, offerId, offerOptionId, wallet, challengeType, statement, }: UseConnectWalletOptions): UseConnectWalletResult;
-
 type LoadRequirementsReason = 'not-authenticated' | 'generic-error';
 type LoadRequirementsState = {
     type: 'LOADING';
@@ -3008,8 +2820,7 @@ interface RequirementsChecklistContainerProps {
      */
     data?: RequirementsData;
     /**
-     * Options for the inline Sumsub verification flow shown for KYC-backed
-     * requirements (`identity_verified`, `kyc_approved`, `accreditation`) when
+     * Options for the inline Sumsub verification flow, shown when
      * `onRequirementActionOverride` is not provided. The flow starts whenever
      * the requirement's status carries a `kycLevel` - the backend prescribes
      * both the level and whether the applicant must be reset first.
@@ -3118,8 +2929,8 @@ interface IdentityVerificationContainerProps {
  * Inline Sumsub identity verification flow, backed by
  * {@link useIdentityVerificationViewModel}, which fetches the Sumsub WebSDK
  * access token via {@link useKycToken}. Used by
- * `RequirementsChecklistContainer` for `identity_verified` requirements, and
- * can also be rendered standalone.
+ * `RequirementsChecklistContainer` for KYC-backed requirements, and can also
+ * be rendered standalone.
  */
 declare function IdentityVerificationContainer({ levelName, reset, locale, onSubmitted, onError, className, }: IdentityVerificationContainerProps): ReactNode;
 
@@ -3354,6 +3165,144 @@ interface ConnectWalletModalViewProps {
  */
 declare function ConnectWalletModalView({ state, onEvent, className, }: ConnectWalletModalViewProps): ReactNode;
 
+/**
+ * Classifies an error thrown by an {@link EvmWallet} into a typed
+ * {@link WalletError}. Pass the transaction `hash` when awaiting a receipt so a
+ * timeout can be reported against it.
+ *
+ * **Every check walks the cause chain rather than testing the thrown object.**
+ * viem never throws the error that says what happened: `sendTransaction` wraps
+ * it in a `TransactionExecutionError` and `writeContract` wraps that again in a
+ * `ContractFunctionExecutionError`, so a MetaMask 4001 arrives as a
+ * `UserRejectedRequestError` two levels down. Testing the top level - which is
+ * what this did until it was caught in a partner demo - classified every real
+ * refusal and every real revert as `unknown`, and that is public API: a host
+ * branching on `user_rejected` to stay quiet when a user simply cancels never
+ * saw one.
+ */
+declare function classifyWalletError(error: unknown, ctx?: {
+    hash?: Hash;
+}): WalletError;
+
+/**
+ * A {@link Logger} that writes structured records to the browser console
+ * through pino.
+ *
+ * ```ts
+ * createCoinListClient({
+ *   ...config,
+ *   logger: pinoClientLogger({ isDev: false, level: 'info' }),
+ * });
+ * ```
+ *
+ * The browser counterpart of {@link pinoServerLogger}. Two factories rather
+ * than one that sniffs `typeof window`, because the environment is the
+ * outermost axis of this codebase: the client build resolves pino's browser
+ * entry and the server build resolves its node entry, neither pays for the
+ * other, and neither has a branch in it.
+ *
+ * `browser: { asObject: true }` is the one non-default: pino's browser default
+ * hands its arguments to `console.info` unchanged, which is not a structured
+ * record. With it, each line is a single object carrying `level`, `time`,
+ * `name`, `scope`, the bindings and every field - the same shape the server
+ * writes as ndjson, so a record read in devtools and a record read in a log
+ * aggregator are the same record.
+ *
+ * ## Production
+ *
+ * **Running this in a production browser is not advised**, and the browser is
+ * where that advice is easiest to justify. **A browser console is readable by
+ * anyone with the page open**, and extensions can scrape it, so even the
+ * redacted levels put SDK-authored classification and server-minted ids
+ * somewhere you do not control. Nothing is transmitted anywhere either: pino's
+ * browser build writes to the console and stops, so what you get for the risk
+ * is a record only the end user can read.
+ *
+ * If you run one anyway, `isDev: false` restricts you to `'error'`, `'warn'`
+ * and `'info'` - `{ isDev: false, level: 'debug' }` does not compile, see
+ * {@link PinoLoggerOptions}. Those levels are redacted by construction; what
+ * follows from that in your environment is your call to make, not a warranty
+ * the SDK offers.
+ *
+ * If you want these records off the page, implement {@link Logger} yourself
+ * over your own transport, or pass a pino instance configured with
+ * `browser.transmit` - the seam is deliberately small enough to make that easy.
+ *
+ * Holds no module-level state: every call builds its own pino instance, and
+ * the level is fixed at construction, so two loggers never interfere. Fixed is
+ * this implementation's choice, not the seam's - the SDK re-reads
+ * {@link Logger.level} before every log call - so if you want a level you can
+ * change at runtime, implement {@link Logger} over your own pino instance
+ * rather than calling this.
+ */
+declare function pinoClientLogger(options: PinoLoggerOptions): Logger;
+
+/**
+ * Machine-readable classification of a connect-wallet failure, so consumers can
+ * branch on the cause (e.g. hide a retry affordance on a terminal failure)
+ * instead of pattern-matching a display string.
+ */
+type ConnectWalletErrorCode = 'not_authenticated' | 'user_rejected' | 'wallet_not_whitelisted' | 'max_wallets_reached' | 'unknown';
+/**
+ * A classified connect-wallet failure. `retryable` is false when re-signing the
+ * same wallet can never succeed (a terminal binding rejection, or no signed-in
+ * session). Display copy is the caller's concern, kept out of the core.
+ */
+type ConnectWalletFlowError = {
+    code: ConnectWalletErrorCode;
+    retryable: boolean;
+};
+/** Progress phases emitted by {@link connectExternalWalletFlow}, in order. */
+type ConnectWalletPhase = 'requesting-challenge' | 'signing-message' | 'submitting-signature';
+type ConnectWalletFlowResult = {
+    type: 'success';
+    binding: OfferOptionAddress;
+} | {
+    type: 'cancelled';
+} | {
+    type: 'error';
+    error: ConnectWalletFlowError;
+};
+/**
+ * The client surface the flow actually depends on, kept narrow on purpose.
+ *
+ * Named as a structural slice rather than `Pick<CoinListClient, 'wallets'>` so
+ * this feature does not import its layer's entry point: a flow takes the
+ * namespaces it needs, the way `@/client/core/checkout/**` flows do.
+ */
+type ConnectWalletClient = {
+    wallets: WalletsNamespace;
+};
+type ConnectWalletFlowParams = {
+    coinlist: ConnectWalletClient;
+    /** Host-provided connected wallet the flow signs with. */
+    wallet: ConnectWallet;
+    offerId: OfferId;
+    offerOptionId: OfferOptionId;
+    /** Challenge framing; defaults to `'siwe'`. */
+    challengeType?: WalletChallengeType;
+    /** SIWE statement shown in the signing prompt. */
+    statement?: string;
+    /**
+     * Polled before each irreversible step (signing, binding). Return true to
+     * abandon a superseded attempt; the flow then resolves `{ type: 'cancelled' }`
+     * without prompting the wallet or binding. React hooks pass a generation
+     * check here; non-React callers can omit it.
+     */
+    isCancelled?: () => boolean;
+    /** Reports flow progress for consumers rendering loading states. */
+    onProgress?: (phase: ConnectWalletPhase) => void;
+};
+/**
+ * Drives the external-wallet ownership flow for one offer option:
+ * `createWalletOwnershipChallenge` -> host `wallet.signMessage` ->
+ * `connectExternalWallet`. Pure and signer-agnostic: signing is delegated to
+ * the host-provided {@link ConnectWallet}, and no React is involved so non-hook
+ * consumers can drive it directly (mirrors `authorizeWallet` in `swap-flows`).
+ * EVM / EOA + SIWE only for now.
+ */
+declare function connectExternalWalletFlow(params: ConnectWalletFlowParams): Promise<ConnectWalletFlowResult>;
+
 interface UseCoinListSignInCardViewModelOptions {
     /** `error` renders the sign-in failure banner. Defaults to `idle`. */
     status?: 'idle' | 'error';
@@ -4394,6 +4343,62 @@ interface UseRequirementsChecklistViewModelResult {
  */
 declare function useRequirementsChecklistViewModel(options: UseRequirementsChecklistViewModelOptions): UseRequirementsChecklistViewModelResult;
 
+/**
+ * A display-ready connect-wallet error: the core flow's machine-readable code
+ * and `retryable` flag, plus copy for the UI.
+ */
+type ConnectWalletError = {
+    code: ConnectWalletErrorCode;
+    message: string;
+    retryable: boolean;
+};
+/**
+ * Signing-in-flight and the last sign error live inside the READY state (not a
+ * separate top-level state) so a failed attempt returns to READY and can be
+ * retried without re-opening the modal. Mirrors {@link SignState} in
+ * `useTaxDocument`.
+ */
+type ConnectWalletSignState = {
+    type: 'idle';
+    error: ConnectWalletError | null;
+} | {
+    type: 'signing';
+};
+type ConnectWalletState = {
+    type: 'NEEDS_WALLET';
+} | {
+    type: 'READY';
+    address: EvmWalletAddress;
+    sign: ConnectWalletSignState;
+} | {
+    type: 'CONNECTED';
+    binding: OfferOptionAddress;
+};
+interface UseConnectWalletOptions {
+    /** The hook resets state each time it opens. */
+    isOpen: boolean;
+    offerId: OfferId;
+    offerOptionId: OfferOptionId;
+    /** Host-provided connected wallet, or `null` while none is connected. */
+    wallet: ConnectWallet | null;
+    /** Challenge framing; defaults to `'siwe'`. */
+    challengeType?: WalletChallengeType;
+    /** SIWE statement shown in the signing prompt. */
+    statement?: string;
+}
+interface UseConnectWalletResult {
+    state: ConnectWalletState;
+    /** READY.sign: idle -> signing -> (CONNECTED | idle w/ error). No-op otherwise. */
+    onSign: () => void;
+}
+/**
+ * React wrapper over {@link connectExternalWalletFlow}. Owns the modal state
+ * machine, the display copy, and generation-token supersession (so a wallet
+ * switch, modal close, or unmount cancels an in-flight attempt). The flow logic
+ * itself lives in the framework-free core so non-React consumers can drive it.
+ */
+declare function useConnectWallet({ isOpen, offerId, offerOptionId, wallet, challengeType, statement, }: UseConnectWalletOptions): UseConnectWalletResult;
+
 type KycTokenErrorReason = 'not-authenticated' | 'generic-error';
 type KycTokenState = {
     type: 'IDLE';
@@ -4877,4 +4882,4 @@ interface UseCountdownOptions {
  */
 declare function useCountdown({ until, tickMs, enabled, }: UseCountdownOptions): number | null;
 
-export { type AuthState, type AuthorizeWalletParams, type BroadcastTxParams, ChecklistStatus, CheckoutAssetUi, type CheckoutConfig, type CheckoutConfirmedWalletUi, CheckoutContainer, type CheckoutContainerProps, type CheckoutCtaUi, type CheckoutEmbeddedWalletUi, type CheckoutNetworkUi, type CheckoutSelectableInputAssetUi, type CheckoutStatusUi, type CheckoutWalletSelection, type CheckoutWalletTypeUi, type CheckoutWalletUi, type ClientAuthConfig, type ClientAuthNamespace, ClientAuthNamespaceImpl, type ClientAuthSession, type ClientCoinListTokenSaleNamespace, ClientCoinListTokenSaleNamespaceImpl, type ClientConfig, type ClientOndoNamespace, ClientOndoNamespaceImpl, type ClientRequirementsNamespace, ClientRequirementsNamespaceImpl, type ClientSuperstateSwapNamespace, ClientSuperstateSwapNamespaceImpl, type ClientSupportNamespace, ClientSupportNamespaceImpl, type CoinListClient, CoinListClientInitializationError, CoinListContext, CoinListContextProvider, type CoinListContextValue, CoinListProvider, type CoinListProviderProps, CoinListSignInButton, CoinListSignInCardContainer, type CoinListSignInCardContainerProps, type CoinListSignInCardUiEvent, type CoinListSignInCardUiState, CoinListSignInCardView, type CoinListSignInCardViewProps, CoinListStyleScope, type CoinListStyleScopeProps, type CoinListTokenSaleCheckoutConfig, type CompleteOAuthFailureReason, type ConnectWallet, type ConnectWalletError, type ConnectWalletErrorCode, type ConnectWalletFlowError, type ConnectWalletFlowParams, type ConnectWalletFlowResult, ConnectWalletModalContainer, type ConnectWalletModalContainerProps, type ConnectWalletModalUiEvent, type ConnectWalletModalUiState, ConnectWalletModalView, type ConnectWalletModalViewProps, type ConnectWalletPhase, type ConnectWalletScreenUi, type ConnectWalletSignState, type ConnectWalletState, ConnectedWalletList, type ConnectedWalletListProps, type ConnectedWalletUi, ERC20_BALANCE_POLL_INTERVAL_MS, type Erc20AllowanceError, type Erc20AllowancePhase, type Erc20AllowanceResult, type Erc20ApprovalError, type EvmSigner, type EvmWallet, type ExecuteOndoSwapParams, type ExecuteSwapParams, type ExecuteTokenSaleParams, IdentityVerificationContainer, type IdentityVerificationContainerProps, type IdentityVerificationUiEvent, type IdentityVerificationUiState, IdentityVerificationView, type IdentityVerificationViewProps, KycLevelName, type KycTokenErrorReason, type KycTokenState, type LoadOfferDetailsReason, type LoadOfferDetailsState, type LoadOffersReason, type LoadOffersState, type LoadOndoPriceState, type LoadOndoSwapTransactionState, type LoadOndoTradingStatusState, type LoadOptionAddressesReason, type LoadOptionAddressesState, type LoadParticipationsReason, type LoadParticipationsState, type LoadRequirementsReason, type LoadRequirementsState, type LoadTokenMetadataState, OAUTH_CODE_VERIFIER_KEY, OAUTH_STATE_KEY, type OauthClientErrorReason, type OauthClientResult, OfferCard, type Props as OfferCardProps, OfferCardUi, OffersGridContainer, type OffersGridContainerProps, type OffersGridUiEvent, type OffersGridUiState, OffersGridView, type OffersGridViewProps, type OndoAmountConfirmed, type OndoAmountStepInput, type OndoAmountUiEvent, type OndoAmountUiState, type OndoAmountValidation, OndoAmountView, type OndoAmountViewProps, OndoBuyCheckoutContainer, type OndoBuyCheckoutContainerProps, type OndoBuyCheckoutUiEvent, type OndoBuyCheckoutUiState, OndoBuyCheckoutView, type OndoBuyCheckoutViewProps, type OndoBuyStep, type OndoCheckoutConfig, type OndoLoadErrorReason, OndoOrderConfirmed, type OndoOrderConfirmedProps, type OndoOrderConfirmedUiEvent, type OndoOrderConfirmedUiState, type OndoOrderPlaced, type OndoQuoteStatusUi, type OndoReviewStepInput, type OndoReviewUiEvent, type OndoReviewUiState, OndoReviewView, type OndoReviewViewProps, type OndoSidebarPriceUi, type OndoSidebarUiState, OndoSidebarView, type OndoSidebarViewProps, type OndoSwapExecutionError, type OndoSwapExecutionPhase, type OndoSwapExecutionResult, type OndoSwapPreparationError, type OndoSwapPreparationPhase, type OndoSwapPreparationResult, type OndoWalletSelectStepInput, type OndoWalletSelectUiEvent, type OndoWalletSelectUiState, OndoWalletSelectView, type OndoWalletSelectViewProps, type PrepareOndoSwapParams, type RequiredCheckoutConfig, RequirementItem, type RequirementItemProps, RequirementItemUi, RequirementStatus, RequirementVariant, RequirementsChecklistContainer, type RequirementsChecklistContainerProps, type RequirementsChecklistItemUi, type RequirementsChecklistUiEvent, type RequirementsChecklistUiState, RequirementsChecklistView, type RequirementsChecklistViewProps, type RequirementsData, type RequirementsVerificationUi, type SignState, SlippagePicker, type SlippagePickerProps, type SubmitErc20ApprovalResult, type SuperstateAmountConfirmed, type SuperstateAmountStepInput, type SuperstateAmountUiEvent, type SuperstateAmountUiState, type SuperstateAmountValidation, SuperstateAmountView, type SuperstateAmountViewProps, type SuperstateCheckoutConfig, SuperstateOrderConfirmed, type SuperstateOrderConfirmedProps, type SuperstateOrderConfirmedUiEvent, type SuperstateOrderConfirmedUiState, type SuperstateOrderPlaced, type SuperstateReviewStepInput, type SuperstateReviewUiEvent, type SuperstateReviewUiState, SuperstateReviewView, type SuperstateReviewViewProps, type SuperstateSidebarPriceUi, type SuperstateSidebarUiState, SuperstateSidebarView, type SuperstateSidebarViewProps, type SuperstateSlippageOptionUi, type SuperstateSlippageUi, SuperstateSwapCheckoutContainer, type SuperstateSwapCheckoutContainerProps, type SuperstateSwapCheckoutRetryUiEvent, type SuperstateSwapCheckoutUiEvent, type SuperstateSwapCheckoutUiState, SuperstateSwapCheckoutView, type SuperstateSwapCheckoutViewProps, type SuperstateSwapLoadErrorReason, type SuperstateSwapStep, type SuperstateWalletStepInput, type SuperstateWalletUiEvent, type SuperstateWalletUiState, SuperstateWalletView, type SuperstateWalletViewProps, type SwapExecutionError, type SwapExecutionPhase, type SwapExecutionResult, type SwapOutputTokenState, type TaxDocumentAddressParts, type TaxDocumentFieldUi, type TaxDocumentFields, TaxDocumentModalContainer, type TaxDocumentModalContainerProps, type TaxDocumentModalUiEvent, type TaxDocumentModalUiState, TaxDocumentModalView, type TaxDocumentModalViewProps, type TaxDocumentScreenUi, type TaxDocumentState, type TokenSaleExecutionError, type TokenSaleExecutionPhase, type TokenSaleExecutionResult, USDC_ICON_URL, USDT_ICON_URL, type UseCoinListResult, type UseCoinListSignInCardViewModelOptions, type UseCoinListSignInCardViewModelResult, type UseCompleteOAuthOptions, type UseConnectWalletModalViewModelOptions, type UseConnectWalletModalViewModelResult, type UseConnectWalletOptions, type UseConnectWalletResult, type UseCountdownOptions, type UseErc20TokenBalancesOptions, type UseErc20TokenBalancesResult, type UseIdentityVerificationViewModelOptions, type UseIdentityVerificationViewModelResult, type UseKycTokenResult, type UseOfferDetailsOptions, type UseOfferDetailsResult, type UseOffersGridViewModelOptions, type UseOffersGridViewModelResult, type UseOffersOptions, type UseOffersResult, type UseOndoAmountViewModelOptions, type UseOndoAmountViewModelResult, type UseOndoBuyCheckoutViewModelOptions, type UseOndoBuyCheckoutViewModelResult, type UseOndoPriceOptions, type UseOndoPriceResult, type UseOndoReviewViewModelOptions, type UseOndoReviewViewModelResult, type UseOndoSidebarViewModelOptions, type UseOndoSidebarViewModelResult, type UseOndoSwapTransactionOptions, type UseOndoSwapTransactionResult, type UseOndoTradingStatusOptions, type UseOndoTradingStatusResult, type UseOndoWalletSelectViewModelOptions, type UseOndoWalletSelectViewModelResult, type UseOptionAddressesOptions, type UseOptionAddressesResult, type UseParticipationsOptions, type UseParticipationsResult, type UseRequirementsChecklistViewModelOptions, type UseRequirementsChecklistViewModelResult, type UseRequirementsOptions, type UseRequirementsResult, type UseSuperstateAmountViewModelOptions, type UseSuperstateAmountViewModelResult, type UseSuperstateReviewViewModelOptions, type UseSuperstateReviewViewModelResult, type UseSuperstateSidebarViewModelOptions, type UseSuperstateSidebarViewModelResult, type UseSuperstateSwapCheckoutViewModelOptions, type UseSuperstateSwapCheckoutViewModelResult, type UseSuperstateWalletViewModelOptions, type UseSuperstateWalletViewModelResult, type UseSwapOutputTokenOptions, type UseSwapOutputTokenResult, type UseSwapQuoteOptions, type UseSwapQuoteResult, type UseTaxDocumentModalViewModelOptions, type UseTaxDocumentModalViewModelResult, type UseTaxDocumentOptions, type UseTaxDocumentResult, type UseTokenMetadataOptions, type UseTokenMetadataResult, VerificationOverlay, type VerificationOverlayProps, type WalletAuthorizationError, type WalletAuthorizationPhase, type WalletAuthorizationResult, type WalletError, type WalletsStatus, type WriteContractParams, authorizeWallet, classifyWalletError, connectExternalWalletFlow, createCoinListClient, defaultCheckoutConfig, ensureErc20Allowance, executeOndoSwap, executeSwap, executeTokenSale, formatCountdown, formatMonthYear, offerIconUrl, ondoLoadErrorReason, prepareOndoSwap, quoteIsStale, quoteOverAsks, stablecoinIconUrl, submitErc20Approval, useCoinList, useCoinListSignInCardViewModel, useCompleteOAuth, useConnectWallet, useConnectWalletModalViewModel, useCountdown, useErc20TokenBalances, useIdentityVerificationViewModel, useKycToken, useOfferDetails, useOffers, useOffersGridViewModel, useOndoAmountViewModel, useOndoBuyCheckoutViewModel, useOndoPrice, useOndoReviewViewModel, useOndoSidebarViewModel, useOndoSwapTransaction, useOndoTradingStatus, useOndoWalletSelectViewModel, useOptionAddresses, useParticipations, useRequirements, useRequirementsChecklistViewModel, useSuperstateAmountViewModel, useSuperstateReviewViewModel, useSuperstateSidebarViewModel, useSuperstateSwapCheckoutViewModel, useSuperstateWalletViewModel, useSwapOutputToken, useSwapQuote, useTaxDocument, useTaxDocumentModalViewModel, useTokenMetadata, validateAmount, validateSuperstateAmount };
+export { type AuthState, type AuthorizeWalletParams, ChecklistStatus, CheckoutAssetUi, type CheckoutConfig, type CheckoutConfirmedWalletUi, CheckoutContainer, type CheckoutContainerProps, type CheckoutCtaUi, type CheckoutEmbeddedWalletUi, type CheckoutNetworkUi, type CheckoutSelectableInputAssetUi, type CheckoutStatusUi, type CheckoutWalletSelection, type CheckoutWalletTypeUi, type CheckoutWalletUi, type ClientAuthConfig, type ClientAuthNamespace, ClientAuthNamespaceImpl, type ClientAuthSession, type ClientCoinListTokenSaleNamespace, ClientCoinListTokenSaleNamespaceImpl, type ClientConfig, type ClientOndoNamespace, ClientOndoNamespaceImpl, type ClientRequirementsNamespace, ClientRequirementsNamespaceImpl, type ClientSuperstateSwapNamespace, ClientSuperstateSwapNamespaceImpl, type ClientSupportNamespace, ClientSupportNamespaceImpl, type CoinListClient, CoinListClientInitializationError, CoinListContext, CoinListContextProvider, type CoinListContextValue, CoinListProvider, type CoinListProviderProps, CoinListSignInButton, CoinListSignInCardContainer, type CoinListSignInCardContainerProps, type CoinListSignInCardUiEvent, type CoinListSignInCardUiState, CoinListSignInCardView, type CoinListSignInCardViewProps, CoinListStyleScope, type CoinListStyleScopeProps, type CoinListTokenSaleCheckoutConfig, type CompleteOAuthFailureReason, ConnectWallet, type ConnectWalletError, type ConnectWalletErrorCode, type ConnectWalletFlowError, type ConnectWalletFlowParams, type ConnectWalletFlowResult, ConnectWalletModalContainer, type ConnectWalletModalContainerProps, type ConnectWalletModalUiEvent, type ConnectWalletModalUiState, ConnectWalletModalView, type ConnectWalletModalViewProps, type ConnectWalletPhase, type ConnectWalletScreenUi, type ConnectWalletSignState, type ConnectWalletState, ConnectedWalletList, type ConnectedWalletListProps, type ConnectedWalletUi, ERC20_BALANCE_POLL_INTERVAL_MS, type Erc20AllowanceError, type Erc20AllowancePhase, type Erc20AllowanceResult, type Erc20ApprovalError, EvmWallet, type ExecuteOndoSwapParams, type ExecuteSwapParams, type ExecuteTokenSaleParams, IdentityVerificationContainer, type IdentityVerificationContainerProps, type IdentityVerificationUiEvent, type IdentityVerificationUiState, IdentityVerificationView, type IdentityVerificationViewProps, KycLevelName, type KycTokenErrorReason, type KycTokenState, type LoadOfferDetailsReason, type LoadOfferDetailsState, type LoadOffersReason, type LoadOffersState, type LoadOndoPriceState, type LoadOndoSwapTransactionState, type LoadOndoTradingStatusState, type LoadOptionAddressesReason, type LoadOptionAddressesState, type LoadParticipationsReason, type LoadParticipationsState, type LoadRequirementsReason, type LoadRequirementsState, type LoadTokenMetadataState, Logger, OAUTH_CODE_VERIFIER_KEY, OAUTH_STATE_KEY, type OauthClientErrorReason, type OauthClientResult, OfferCard, type Props as OfferCardProps, OfferCardUi, OffersGridContainer, type OffersGridContainerProps, type OffersGridUiEvent, type OffersGridUiState, OffersGridView, type OffersGridViewProps, type OndoAmountConfirmed, type OndoAmountStepInput, type OndoAmountUiEvent, type OndoAmountUiState, type OndoAmountValidation, OndoAmountView, type OndoAmountViewProps, OndoBuyCheckoutContainer, type OndoBuyCheckoutContainerProps, type OndoBuyCheckoutUiEvent, type OndoBuyCheckoutUiState, OndoBuyCheckoutView, type OndoBuyCheckoutViewProps, type OndoBuyStep, type OndoCheckoutConfig, type OndoLoadErrorReason, OndoOrderConfirmed, type OndoOrderConfirmedProps, type OndoOrderConfirmedUiEvent, type OndoOrderConfirmedUiState, type OndoOrderPlaced, type OndoQuoteStatusUi, type OndoReviewStepInput, type OndoReviewUiEvent, type OndoReviewUiState, OndoReviewView, type OndoReviewViewProps, type OndoSidebarPriceUi, type OndoSidebarUiState, OndoSidebarView, type OndoSidebarViewProps, type OndoSwapExecutionError, type OndoSwapExecutionPhase, type OndoSwapExecutionResult, type OndoSwapPreparationError, type OndoSwapPreparationPhase, type OndoSwapPreparationResult, type OndoWalletSelectStepInput, type OndoWalletSelectUiEvent, type OndoWalletSelectUiState, OndoWalletSelectView, type OndoWalletSelectViewProps, PinoLoggerOptions, type PrepareOndoSwapParams, type RequiredCheckoutConfig, RequirementItem, type RequirementItemProps, RequirementItemUi, RequirementStatus, RequirementVariant, RequirementsChecklistContainer, type RequirementsChecklistContainerProps, type RequirementsChecklistItemUi, type RequirementsChecklistUiEvent, type RequirementsChecklistUiState, RequirementsChecklistView, type RequirementsChecklistViewProps, type RequirementsData, type RequirementsVerificationUi, type SignState, SlippagePicker, type SlippagePickerProps, type SubmitErc20ApprovalResult, type SuperstateAmountConfirmed, type SuperstateAmountStepInput, type SuperstateAmountUiEvent, type SuperstateAmountUiState, type SuperstateAmountValidation, SuperstateAmountView, type SuperstateAmountViewProps, type SuperstateCheckoutConfig, SuperstateOrderConfirmed, type SuperstateOrderConfirmedProps, type SuperstateOrderConfirmedUiEvent, type SuperstateOrderConfirmedUiState, type SuperstateOrderPlaced, type SuperstateReviewStepInput, type SuperstateReviewUiEvent, type SuperstateReviewUiState, SuperstateReviewView, type SuperstateReviewViewProps, type SuperstateSidebarPriceUi, type SuperstateSidebarUiState, SuperstateSidebarView, type SuperstateSidebarViewProps, type SuperstateSlippageOptionUi, type SuperstateSlippageUi, SuperstateSwapCheckoutContainer, type SuperstateSwapCheckoutContainerProps, type SuperstateSwapCheckoutRetryUiEvent, type SuperstateSwapCheckoutUiEvent, type SuperstateSwapCheckoutUiState, SuperstateSwapCheckoutView, type SuperstateSwapCheckoutViewProps, type SuperstateSwapLoadErrorReason, type SuperstateSwapStep, type SuperstateWalletStepInput, type SuperstateWalletUiEvent, type SuperstateWalletUiState, SuperstateWalletView, type SuperstateWalletViewProps, type SwapExecutionError, type SwapExecutionPhase, type SwapExecutionResult, type SwapOutputTokenState, type TaxDocumentAddressParts, type TaxDocumentFieldUi, type TaxDocumentFields, TaxDocumentModalContainer, type TaxDocumentModalContainerProps, type TaxDocumentModalUiEvent, type TaxDocumentModalUiState, TaxDocumentModalView, type TaxDocumentModalViewProps, type TaxDocumentScreenUi, type TaxDocumentState, type TokenSaleExecutionError, type TokenSaleExecutionPhase, type TokenSaleExecutionResult, USDC_ICON_URL, USDT_ICON_URL, type UseCoinListResult, type UseCoinListSignInCardViewModelOptions, type UseCoinListSignInCardViewModelResult, type UseCompleteOAuthOptions, type UseConnectWalletModalViewModelOptions, type UseConnectWalletModalViewModelResult, type UseConnectWalletOptions, type UseConnectWalletResult, type UseCountdownOptions, type UseErc20TokenBalancesOptions, type UseErc20TokenBalancesResult, type UseIdentityVerificationViewModelOptions, type UseIdentityVerificationViewModelResult, type UseKycTokenResult, type UseOfferDetailsOptions, type UseOfferDetailsResult, type UseOffersGridViewModelOptions, type UseOffersGridViewModelResult, type UseOffersOptions, type UseOffersResult, type UseOndoAmountViewModelOptions, type UseOndoAmountViewModelResult, type UseOndoBuyCheckoutViewModelOptions, type UseOndoBuyCheckoutViewModelResult, type UseOndoPriceOptions, type UseOndoPriceResult, type UseOndoReviewViewModelOptions, type UseOndoReviewViewModelResult, type UseOndoSidebarViewModelOptions, type UseOndoSidebarViewModelResult, type UseOndoSwapTransactionOptions, type UseOndoSwapTransactionResult, type UseOndoTradingStatusOptions, type UseOndoTradingStatusResult, type UseOndoWalletSelectViewModelOptions, type UseOndoWalletSelectViewModelResult, type UseOptionAddressesOptions, type UseOptionAddressesResult, type UseParticipationsOptions, type UseParticipationsResult, type UseRequirementsChecklistViewModelOptions, type UseRequirementsChecklistViewModelResult, type UseRequirementsOptions, type UseRequirementsResult, type UseSuperstateAmountViewModelOptions, type UseSuperstateAmountViewModelResult, type UseSuperstateReviewViewModelOptions, type UseSuperstateReviewViewModelResult, type UseSuperstateSidebarViewModelOptions, type UseSuperstateSidebarViewModelResult, type UseSuperstateSwapCheckoutViewModelOptions, type UseSuperstateSwapCheckoutViewModelResult, type UseSuperstateWalletViewModelOptions, type UseSuperstateWalletViewModelResult, type UseSwapOutputTokenOptions, type UseSwapOutputTokenResult, type UseSwapQuoteOptions, type UseSwapQuoteResult, type UseTaxDocumentModalViewModelOptions, type UseTaxDocumentModalViewModelResult, type UseTaxDocumentOptions, type UseTaxDocumentResult, type UseTokenMetadataOptions, type UseTokenMetadataResult, VerificationOverlay, type VerificationOverlayProps, type WalletAuthorizationError, type WalletAuthorizationPhase, type WalletAuthorizationResult, WalletError, type WalletsStatus, authorizeWallet, classifyWalletError, connectExternalWalletFlow, createCoinListClient, defaultCheckoutConfig, ensureErc20Allowance, executeOndoSwap, executeSwap, executeTokenSale, formatCountdown, formatMonthYear, offerIconUrl, ondoLoadErrorReason, pinoClientLogger, prepareOndoSwap, quoteIsStale, quoteOverAsks, stablecoinIconUrl, submitErc20Approval, useCoinList, useCoinListSignInCardViewModel, useCompleteOAuth, useConnectWallet, useConnectWalletModalViewModel, useCountdown, useErc20TokenBalances, useIdentityVerificationViewModel, useKycToken, useOfferDetails, useOffers, useOffersGridViewModel, useOndoAmountViewModel, useOndoBuyCheckoutViewModel, useOndoPrice, useOndoReviewViewModel, useOndoSidebarViewModel, useOndoSwapTransaction, useOndoTradingStatus, useOndoWalletSelectViewModel, useOptionAddresses, useParticipations, useRequirements, useRequirementsChecklistViewModel, useSuperstateAmountViewModel, useSuperstateReviewViewModel, useSuperstateSidebarViewModel, useSuperstateSwapCheckoutViewModel, useSuperstateWalletViewModel, useSwapOutputToken, useSwapQuote, useTaxDocument, useTaxDocumentModalViewModel, useTokenMetadata, validateAmount, validateSuperstateAmount };