@ab-org/predicate-market-sdk 0.1.1 → 1.0.1

package/dist/index.d.ts

@@ -1,22 +1,672 @@
-export * from "./types.js";
-export * from "./auth/config.js";
-export * from "./auth/autoReconnect.js";
-export * from "./auth/google.js";
-export * from "./auth/twitter.js";
-export * from "./modules/deposit.js";
-export * from "./modules/withdraw.js";
-export * from "./modules/marketData.js";
-export * from "./modules/balanceQuery.js";
-export * from "./modules/withdrawExecutor.js";
-export * from "./modules/api.js";
-export * from "./modules/withdrawDirect.js";
-export * from "./policyAdapter.js";
-export * from "./ui/SignInModal.js";
-export * from "./ui/signInTypes.js";
-export * from "./ui/WalletSelectionModal.js";
-export * from "./ui/DepositModal.js";
-export * from "./ui/WithdrawModal.js";
-export * from "./ui/components/DropdownField.js";
-export * from "./ui/components/DepositDetailsPanel.js";
-export * from "./walletUtils.js";
-export * from "./constants/chains.js";
+import { SessionCapabilityPolicy, CubeSignerConfig, WalletSession, SupportedToken, SupportedChain, WalletCapability, CubeSignerSession } from '@ab-org/sdk-core';
+import { ReactNode, ChangeEventHandler } from 'react';
+import { AxiosInstance } from 'axios';
+import * as react_jsx_runtime_js from 'react/jsx-runtime.js';
+export { ClientIds, DEFAULT_FUNDING_CHAIN_ID, DEFAULT_FUNDING_TOKEN_ADDRESS, EvmChainInfo, getChainInfo, getFundingTokenAddress } from '@ab-org/wallet-utils';
+
+interface CustodyAdapter {
+    getDepositStatus(depositId: string): Promise<{
+        status: string;
+        txHash?: string;
+    }>;
+    requestWithdraw(params: {
+        amount: string;
+        token: string;
+        chain: string;
+        targetAddress: string;
+    }): Promise<{
+        requestId: string;
+    }>;
+    getWithdrawStatus(requestId: string): Promise<{
+        status: string;
+        txHash?: string;
+        etaSeconds?: number;
+    }>;
+}
+interface ModalController<TConfig> {
+    open(config?: TConfig): void;
+}
+interface TokenInfo {
+    symbol: string;
+    name: string;
+    decimals: number;
+    iconUrl?: string;
+    minAmount?: string;
+    maxAmount?: string;
+}
+interface ChainInfo {
+    id: string;
+    name: string;
+    iconUrl?: string;
+    confirmations?: number;
+    estimatedTime?: string;
+}
+interface QuoteRequest$1 {
+    token: string;
+    chain: string;
+    amount: string;
+    direction: "deposit" | "withdraw";
+}
+interface QuoteResult {
+    quoteId: string;
+    estimatedAmount: string;
+    slippage: string;
+    fee: string;
+    feeToken: string;
+    exchangeRate: string;
+    expiresAt: number;
+}
+interface DepositAddressResult {
+    address: string;
+    minimumDeposit?: string;
+}
+interface MarketDataProvider {
+    getSupportedTokens(direction: "deposit" | "withdraw"): Promise<TokenInfo[]>;
+    getSupportedChains(token: string, direction: "deposit" | "withdraw"): Promise<ChainInfo[]>;
+    getQuote(request: QuoteRequest$1): Promise<QuoteResult>;
+    getDepositAddress(token: string, chain: string): Promise<DepositAddressResult>;
+}
+
+interface WalletItem {
+    id: string;
+    name: string;
+    icon?: ReactNode;
+    installed?: boolean;
+    installUrl?: string;
+}
+interface SocialProvider {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+}
+interface SignInUiConfig {
+    socialProviders?: SocialProvider[];
+    wallets?: WalletItem[];
+    initialVisibleCount?: number;
+    /**
+     * @deprecated Ignored by `SignInModal` / `useSignInModalController`: social login creates the session without `window.confirm`.
+     */
+    sessionConfirmation?: {
+        enabled?: boolean;
+        title?: string;
+        message?: string;
+    };
+    sessionPolicy?: Partial<SessionCapabilityPolicy>;
+}
+
+interface SDKConfig {
+    googleClientId?: string;
+    twitterClientId?: string;
+    twitterRedirectUri?: string;
+    cubeSigner?: CubeSignerConfig;
+    signIn?: SignInUiConfig;
+}
+/**
+ * Fixed auth config: built-in bundled defaults (see bundledConfig.ts) with optional
+ * overrides from environment (server / `NEXT_PUBLIC_*` client). Used as defaults in initSDK.
+ */
+declare function getFixedAuthConfig(): Partial<SDKConfig>;
+/**
+ * Config for initializing the predicate SDK. Defaults come from bundled config
+ * (and env overrides); you may override any of them here. Optional top-level
+ * `registerUser` is merged into `cubeSigner.oidcLoginHooks` when cubeSigner is present.
+ */
+interface PredicateSDKConfig extends Partial<SDKConfig> {
+    /**
+     * Optional hook to register the user on your backend when CubeSigner proof
+     * indicates the user is not initialized. Used when cubeSigner is available
+     * (from env or override).
+     */
+    registerUser?: (oidcToken: string) => Promise<void>;
+}
+declare function initSDK(config?: PredicateSDKConfig): void;
+declare function getSDKConfig(): Readonly<SDKConfig>;
+
+/**
+ * Attempt to silently reconnect a wallet whose session was restored
+ * from localStorage cache.  Creates a temporary `WalletConnector` with
+ * the default adapter registry (injected wallets + Cubist if configured)
+ * and delegates to `WalletConnector.tryAutoReconnect()`.
+ *
+ * Safe to call multiple times — concurrent calls share the same promise.
+ * Returns the fresh session on success, or `null` if reconnection failed.
+ */
+declare function tryAutoReconnect(): Promise<WalletSession | null>;
+
+declare global {
+    interface Window {
+        google?: {
+            accounts: {
+                id: {
+                    initialize(config: GISInitConfig): void;
+                    prompt(momentListener?: (notification: GISPromptMoment) => void): void;
+                    renderButton(parent: HTMLElement, options: GISButtonConfig): void;
+                    revoke(hint: string, callback?: () => void): void;
+                };
+            };
+        };
+    }
+}
+interface GISInitConfig {
+    client_id: string;
+    callback: (response: GISCredentialResponse) => void;
+    auto_select?: boolean;
+    cancel_on_tap_outside?: boolean;
+    use_fedcm_for_prompt?: boolean;
+}
+interface GISCredentialResponse {
+    credential: string;
+}
+interface GISPromptMoment {
+    isSkippedMoment(): boolean;
+    isDismissedMoment(): boolean;
+    isNotDisplayed(): boolean;
+    getDismissedReason(): string;
+}
+interface GISButtonConfig {
+    type?: "standard" | "icon";
+    size?: "large" | "medium" | "small";
+}
+interface GoogleCredential {
+    idToken: string;
+    email?: string;
+    name?: string;
+    picture?: string;
+}
+declare function isFedCMSupported(): boolean;
+declare function signInWithGoogle(clientId: string): Promise<GoogleCredential>;
+
+interface TwitterAuthResult {
+    code: string;
+    codeVerifier: string;
+    state: string;
+}
+declare function notifyTwitterCallback(): void;
+declare function signInWithTwitter(clientId: string, redirectUri: string): Promise<TwitterAuthResult>;
+
+interface DepositModalConfig {
+    preferredToken?: string;
+    preferredChain?: string;
+    onStatusChange?: (status: DepositStatus) => void;
+}
+type DepositStatus = {
+    phase: "idle";
+} | {
+    phase: "address-issued";
+    depositId: string;
+    address: string;
+} | {
+    phase: "confirming";
+    depositId: string;
+} | {
+    phase: "settled";
+    depositId: string;
+    txHash?: string;
+} | {
+    phase: "failed";
+    reason: string;
+};
+interface DepositController extends ModalController<DepositModalConfig> {
+    readonly status: DepositStatus;
+    fetchTokens(): Promise<TokenInfo[]>;
+    fetchChains(token: string): Promise<ChainInfo[]>;
+    fetchQuote(token: string, chain: string, amount: string): Promise<QuoteResult>;
+    fetchDepositAddress(token: string, chain: string): Promise<DepositAddressResult>;
+}
+declare const createDepositController: (custody: CustodyAdapter, marketData: MarketDataProvider) => DepositController;
+
+interface WithdrawModalConfig {
+    defaultAmount?: string;
+    defaultToken?: string;
+    defaultChain?: string;
+    targetAddress?: string;
+    onStatusChange?: (status: WithdrawStatus) => void;
+}
+type WithdrawStatus = {
+    phase: "idle";
+} | {
+    phase: "requested";
+    requestId: string;
+} | {
+    phase: "processing";
+    requestId: string;
+} | {
+    phase: "settled";
+    requestId: string;
+    txHash?: string;
+} | {
+    phase: "failed";
+    reason: string;
+};
+interface WithdrawController extends ModalController<WithdrawModalConfig> {
+    readonly status: WithdrawStatus;
+    fetchTokens(): Promise<TokenInfo[]>;
+    fetchChains(token: string): Promise<ChainInfo[]>;
+    fetchQuote(token: string, chain: string, amount: string): Promise<QuoteResult>;
+}
+declare const createWithdrawController: (custody: CustodyAdapter, marketData: MarketDataProvider) => WithdrawController;
+
+/**
+ * Default `MarketDataProvider` backed by the merchant chains API.
+ * - getSupportedTokens / getSupportedChains: from GET `{merchantBase}/chains`
+ * - getQuote: local estimate until a dedicated quote API exists
+ * - getDepositAddress: 当前 session 钱包地址 + 与 `token`/`chain` 匹配的 `GET /chains` 中 `minimum_deposit`（按 decimals 格式化）
+ */
+declare function createMarketDataProvider(): MarketDataProvider;
+
+interface Erc20BalanceResult {
+    raw: bigint;
+    formatted: string;
+    symbol: string;
+}
+/**
+ * Query any ERC-20 token balance via a raw JSON-RPC `eth_call`.
+ * No external library dependency – uses the global `fetch`.
+ */
+declare function fetchErc20Balance(rpcUrl: string, tokenAddress: string, walletAddress: string): Promise<bigint>;
+interface FundingTokenBalanceOptions {
+    rpcUrl?: string;
+    tokenAddress?: string;
+    decimals?: number;
+    /**
+     * Funding chain id (e.g. `"3131"` Tenderly BSC, `"56"` mainnet).
+     * When omitted, defaults to `3131` via {@link getChainInfo}.
+     */
+    chainId?: string | number | null;
+    /** Label for {@link Erc20BalanceResult.symbol} (default `"Funding"`). */
+    displaySymbol?: string;
+}
+/**
+ * Fetches the configured funding ERC-20 balance on the selected funding chain.
+ * Defaults: chain `3131`, RPC from {@link getChainInfo}, token from {@link getFundingTokenAddress} / env.
+ */
+declare function fetchFundingTokenBalance(walletAddress: string, options?: FundingTokenBalanceOptions): Promise<Erc20BalanceResult>;
+
+interface WithdrawRequest {
+    /** 用户收款地址（目标链） */
+    toAddress: string;
+    /** Human-readable amount, e.g. "100.5" */
+    amount: string;
+    /** 目标链代币 symbol，如 "USDT" */
+    token: string;
+    /** 目标链 chain_id */
+    chain: string;
+}
+interface WithdrawResult {
+    /** Funding 链上转入一次性地址的 tx hash */
+    txHash: string;
+    /** 提现订单 ID，用于轮询 getWithdrawOrder(orderId) */
+    orderId: string;
+    /** 广播 funding tx 的链 id，用于构建 explorer 链接 */
+    fundingChainId?: string;
+}
+/**
+ * A function that executes a withdraw operation.
+ * Callers can supply their own implementation to override the default behaviour.
+ */
+type WithdrawExecutor = (request: WithdrawRequest) => Promise<WithdrawResult>;
+/**
+ * Convert a human-readable decimal string to the smallest unit (wei-equivalent).
+ *
+ * Examples with decimals=18:
+ *   "1"     → 1000000000000000000n
+ *   "0.5"   → 500000000000000000n
+ *   "100.1" → 100100000000000000000n
+ */
+declare function parseUnits(value: string, decimals: number): bigint;
+interface FundingWithdrawExecutorOptions {
+    /** 源链 funding ERC-20 合约地址；默认 {@link getFundingTokenAddress} / env */
+    tokenAddress?: string;
+    decimals?: number;
+    /**
+     * Funding EVM chain id（如 `3131` Tenderly、`56` 主网）。未传时默认 `3131`。
+     */
+    chainId?: number | string;
+    /** 覆盖 {@link getChainInfo} 提供的 JSON-RPC URL */
+    rpcUrl?: string;
+    /** 系统配置的单笔限额（wei 字符串），若提供则校验 request.amount 不得超过此值 */
+    maxAmountWei?: string;
+    /**
+     * 与商户订单接口约定的 funding 侧 token symbol（默认 `USDT`，按后端协议）。
+     */
+    fundingLegTokenSymbol?: string;
+}
+/**
+ * Factory that returns a `WithdrawExecutor` implementing the flow in withdraw.md:
+ * 1) Create NATIVE_SWAP order → get one-time wallet address (OTW);
+ * 2) Sign ERC-20 transfer of the funding token on the funding chain to the OTW (not to user);
+ * 3) Broadcast tx and return { txHash, orderId } for the client to poll getWithdrawOrder(orderId).
+ */
+declare function createFundingWithdrawExecutor(options?: FundingWithdrawExecutorOptions): WithdrawExecutor;
+
+/**
+ * Merchant API client
+ * 基于 axios 封装，类型与文档一致。
+ */
+
+/** 通用 API 响应：所有接口统一格式 */
+interface ApiResponse<T> {
+    data: T | null;
+    code: number;
+    msg: string;
+    timestamp: number;
+}
+interface TokenData {
+    symbol: string;
+    address: string;
+    decimals: number;
+    /** 最小充值量（最小单位字符串，如 `"15000000"`） */
+    minimum_deposit?: string;
+    /** 是否为 USD 类稳定币 */
+    is_usd_stable?: boolean;
+}
+interface ChainData {
+    chain_id: string;
+    network: string;
+    tokens: TokenData[];
+}
+interface ChainsResponseData {
+    chains: ChainData[];
+    is_testnet: boolean;
+}
+interface PlatformRegisterRequest {
+    platform_contract_address: string;
+    chain_id: string;
+}
+interface PlatformRegisterResponseData {
+    deposit_address: string;
+    chain_id: string;
+}
+type QuoteDirection = "deposit" | "withdraw";
+interface QuoteRequest {
+    direction: QuoteDirection;
+    chain_id: string;
+    token_address: string;
+    token_amount?: string;
+    dst_token_amount?: string;
+}
+interface QuoteResponseData {
+    token_address: string;
+    token_symbol: string;
+    token_decimals: number;
+    rate: string;
+    chain_id: number;
+    deposit_address?: string;
+    dst_token_amount?: string;
+    token_amount?: string;
+    expires_at?: string;
+}
+type DepositOrderStatus = "received" | "processing" | "completed" | "failed" | "funded";
+interface DepositOrderResponseData {
+    order_id: string;
+    status: DepositOrderStatus;
+    source_chain_id: string;
+    token_address: string;
+    token_amount?: string;
+    dst_token_amount?: string;
+    deposit_address?: string;
+    source_tx_hash?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+type WithdrawOrderStatus = "pending" | "funded" | "processing" | "completed" | "failed" | "expired";
+interface WithdrawOrderResponseData {
+    order_id: string;
+    status: WithdrawOrderStatus;
+    one_time_address?: string;
+    chain_id: string;
+    dst_token_amount: string;
+    /** Fee (e.g. "0.01 USDT"); only present if backend includes it in GET /api/v1/orders/withdraw/:id. UI falls back to feeDisplay prop or "—". */
+    fee?: string;
+    target_chain_id: string;
+    target_address: string;
+    funding_tx_hash?: string;
+    dst_tx_hash?: string;
+    out_tx_hash?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+interface NativeSwapPayload {
+    chain_id: string;
+    token_address: string;
+    token_amount: string;
+    dst_chain_id: string;
+    dst_token_address: string;
+    recipient: string;
+}
+interface PaymentPairData {
+    token_symbol: string;
+    token_amount: string;
+    token_address: string;
+    user_address: string;
+    chain_id: string;
+}
+interface CreateOrderRequest {
+    intent_id: string;
+    order_type: "NATIVE_SWAP";
+    order_payload: NativeSwapPayload;
+    payment_pairs: PaymentPairData[];
+}
+type PaymentSessionStatus = "CREATED" | "PENDING" | "FUNDED" | "CANCELED" | "CAPTURING" | "SUCCEED";
+interface PaymentSessionResponseData {
+    payment_session_id: string;
+    created_at?: string;
+    status: PaymentSessionStatus;
+    one_time_wallet_address: string;
+    amount: string;
+    currency: string;
+    user_address?: string;
+    network?: string;
+    token_symbol?: string;
+    chain_id?: string;
+    funding_transaction_hash?: string | null;
+    capturable_amount?: string;
+    captured_amount?: string;
+}
+interface CreateOrderResponseData {
+    order_id: string;
+    payment_sessions: PaymentSessionResponseData[];
+}
+/**
+ * 配置 Merchant API 的 baseURL
+ */
+declare function configureMerchantApi(): void;
+/**
+ * 获取当前 axios 实例（用于自定义请求）
+ */
+declare function getMerchantApiClient(): AxiosInstance;
+/** GET /chains - 查询支持的链和代币列表 */
+declare function getChains(): Promise<ChainsResponseData>;
+/** POST /api/v1/platform - 注册平台合约并获取充值地址 */
+declare function registerPlatform(body: PlatformRegisterRequest): Promise<PlatformRegisterResponseData>;
+/** POST /api/v1/quote - 统一报价（充值/提现） */
+declare function quote(body: QuoteRequest): Promise<QuoteResponseData>;
+/** GET /api/v1/orders/deposit/{order_id} - 查询充值订单状态 */
+declare function getDepositOrder(orderId: string): Promise<DepositOrderResponseData>;
+/** GET /api/v1/orders/withdraw/{order_id} - 查询提现订单状态 */
+declare function getWithdrawOrder(orderId: string): Promise<WithdrawOrderResponseData>;
+/** POST /order - 创建 NATIVE_SWAP 提现订单 */
+declare function createOrder(body: CreateOrderRequest): Promise<CreateOrderResponseData>;
+
+/**
+ * funding 链（与 {@link DEFAULT_FUNDING_CHAIN_ID} 一致）上，且 `tokenAddress` 在 Merchant `GET /chains`
+ * 中对应条目的 `is_usd_stable === true` 时，由业务层自行完成提现并构造 `withdrawDirectResult`；
+ * 其余情况走默认 funding 提现执行器与订单轮询。
+ */
+declare function isUsdtWithdrawDirect(chainId: string, tokenAddress: string, chains: ChainData[]): boolean;
+/**
+ * 从 `getChains()` 返回的 `chains` 中，按当前选择的链 id + token symbol 或合约地址解析 `TokenData`。
+ */
+declare function findTokenDataFromChains(chains: ChainData[], chainId: string, opts: {
+    symbol: string;
+    tokenAddress?: string;
+}): TokenData | undefined;
+
+interface PredicateMarketPolicyAdapterOptions {
+    appId?: string;
+    origin?: string;
+    expiresAt?: number;
+}
+declare const createPredicateMarketPolicyAdapter: (options?: PredicateMarketPolicyAdapterOptions) => {
+    deposit(token: SupportedToken, chain: SupportedChain, maxAmount?: string): SessionCapabilityPolicy;
+    withdraw(token: SupportedToken, chain: SupportedChain, maxAmount?: string): SessionCapabilityPolicy;
+    trade(chain: SupportedChain, capabilities?: WalletCapability[]): SessionCapabilityPolicy;
+};
+
+interface SignInModalProps {
+    title?: string;
+    socialProviders?: SocialProvider[];
+    wallets?: WalletItem[];
+    initialVisibleCount?: number;
+    privacyPolicyUrl?: string;
+    termsOfUseUrl?: string;
+    onGoogleLogin?: (credential: GoogleCredential) => void;
+    onTwitterLogin?: (result: TwitterAuthResult) => void;
+    onCubeSignerSession?: (session: CubeSignerSession) => void;
+    onWalletConnected?: (session: WalletSession, walletId: string) => void;
+    onSocialLogin?: (providerId: string) => void;
+    onWalletSelect?: (walletId: string) => void | Promise<void>;
+    onDismiss?: () => void;
+    onSuccess?: (session: WalletSession) => void;
+}
+declare function clearSocialAccountInstance(): void;
+declare const SignInModal: ({ title, socialProviders, wallets, initialVisibleCount, privacyPolicyUrl, termsOfUseUrl, onGoogleLogin, onTwitterLogin, onCubeSignerSession, onWalletConnected, onSocialLogin, onWalletSelect, onDismiss, onSuccess, }: SignInModalProps) => react_jsx_runtime_js.JSX.Element;
+
+interface WalletOption {
+    id: string;
+    label: string;
+    description: string;
+    category: "social" | "plugin";
+    icon?: ReactNode;
+}
+interface WalletSelectionModalProps {
+    title?: string;
+    options: WalletOption[];
+    onSelect?: (id: string) => void;
+}
+declare const WalletSelectionModal: ({ title, options, onSelect, }: WalletSelectionModalProps) => react_jsx_runtime_js.JSX.Element;
+
+interface SelectOption {
+    id: string;
+    label: string;
+    subtitle?: string;
+    icon?: ReactNode;
+}
+interface DropdownFieldProps {
+    label: string;
+    placeholder?: string;
+    value?: string;
+    icon?: ReactNode;
+    focused?: boolean;
+    options?: SelectOption[];
+    onSelect?: (id: string) => void;
+    /** @deprecated Use `options` + `onSelect` instead. */
+    onClick?: () => void;
+}
+declare const DropdownField: ({ label, placeholder, value, icon, focused, options, onSelect, onClick, }: DropdownFieldProps) => react_jsx_runtime_js.JSX.Element;
+
+interface DepositModalProps {
+    /** Pre-selected token id. */
+    token?: string;
+    /** Pre-selected chain id. */
+    chain?: string;
+    /** Available tokens (when not provided, fetched from getChains). */
+    tokenOptions?: SelectOption[];
+    /** Available chains (when not provided, derived from getChains by token). */
+    chainOptions?: SelectOption[];
+    /** Deposit address，必须由调用方传入；在已选 token+chain 时若未传入合法值将抛错。 */
+    depositAddress?: string;
+    /** e.g. "0.01 USDT" */
+    minimumDeposit?: string;
+    /** Icon rendered at the center of the QR code. */
+    qrCenterIcon?: ReactNode;
+    /** Extra icons shown on the Transfer Crypto row. */
+    cryptoIcons?: ReactNode;
+    /** Deposit amount for quote (optional; when set, quote is fetched and shown). */
+    depositAmount?: string;
+    /** Called for toast messages (copy, quote expired, wait for balance, transfer confirmed). */
+    onShowToast?: (message: string) => void;
+    /** When set, show "Transfer confirmed" toast and explorer link. */
+    txHash?: string;
+    /** Build explorer URL for tx; e.g. (chainId, txHash) => `https://bscscan.com/tx/${txHash}` */
+    explorerTxUrl?: (chainId: string, txHash: string) => string;
+    onTokenSelect?: (id: string) => void;
+    onChainSelect?: (id: string) => void;
+    onCopyAddress?: (address: string) => void;
+    onBuyCrypto?: () => void;
+    onSignIn?: () => void;
+    onBack?: () => void;
+    onClose?: () => void;
+}
+declare const DepositModal: ({ token, chain, tokenOptions: tokenOptionsProp, chainOptions: chainOptionsProp, depositAddress, minimumDeposit, qrCenterIcon, cryptoIcons, depositAmount, onShowToast, txHash, explorerTxUrl, onTokenSelect, onChainSelect, onCopyAddress, onBuyCrypto, onSignIn, onBack, onClose, }: DepositModalProps) => react_jsx_runtime_js.JSX.Element;
+
+type WithdrawUiStatus = "idle" | "pending" | "success" | "manual_review";
+interface WithdrawModalProps {
+    address?: string;
+    token?: string;
+    tokenSymbol?: string;
+    chain?: string;
+    amount?: string;
+    balance?: string;
+    status?: WithdrawUiStatus;
+    receiveAmount?: string;
+    txHash?: string;
+    eta?: string;
+    tokenOptions?: SelectOption[];
+    chainOptions?: SelectOption[];
+    /** 使用 Merchant API：getChains 拉取 token/chain，quote(withdraw) 询价 */
+    useMerchantApi?: boolean;
+    /** 创建订单后传入，用于轮询提现订单状态 */
+    orderId?: string;
+    /** 提现模式：direct 直接提现，cross_chain 跨链提现 */
+    withdrawMode?: "direct" | "cross_chain";
+    /**
+     * 直接提现模式（无 orderId）下的结果数据；
+     * 将用来构造一个与 getWithdrawOrder 返回值兼容的对象，从而复用“有 orderId”时的全部交互与展示。
+     * 最少建议提供：status、dst_token_amount、target_chain_id、target_address（必要时包含 dst_tx_hash / out_tx_hash、fee）。
+     */
+    withdrawDirectResult?: Partial<WithdrawOrderResponseData>;
+    /** 成功页 Fee 展示：优先用订单接口返回的 fee，若后端未返回则用此值（如询价时的 fee），均无则显示 "—" */
+    feeDisplay?: string;
+    /** 广播后的 funding tx 所在链 id，与 txHash 一起用于展示「查看交易」链接 */
+    fundingChainId?: string;
+    /** 构建链上交易浏览器链接（已弃用，使用 getExplorerUrl） */
+    explorerTxUrl?: (chainId: string, txHash: string) => string;
+    onShowToast?: (message: string) => void;
+    onAddressChange?: ChangeEventHandler<HTMLInputElement>;
+    onTokenSelect?: (id: string) => void;
+    onChainSelect?: (id: string) => void;
+    onAmountChange?: ChangeEventHandler<HTMLInputElement>;
+    onMaxClick?: () => void;
+    /** 提交时传入当前表单值（收款地址、金额、所选 token、链上合约地址、所选 chain），由调用方执行提现 */
+    onSubmit?: (payload: {
+        toAddress: string;
+        amount: string;
+        token: string;
+        tokenAddress: string;
+        chain: string;
+    }) => void;
+    /** 提现订单状态变为 completed 时调用，用于调用方刷新余额等 */
+    onWithdrawCompleted?: () => void;
+    /** 点击「Start another withdrawal」时调用；应由调用方清空 orderId、重置 amount，恢复到待提交状态（不关弹层）。未传则退化为 onClose。 */
+    onStartAnotherWithdrawal?: () => void;
+    onSignIn?: () => void;
+    onClose?: () => void;
+}
+declare const WithdrawModal: ({ address, token, tokenSymbol, chain, amount, balance, status, receiveAmount: receiveAmountProp, txHash, tokenOptions: tokenOptionsProp, chainOptions: chainOptionsProp, useMerchantApi, orderId, withdrawMode, withdrawDirectResult, feeDisplay, fundingChainId, onShowToast, onAddressChange, onTokenSelect, onChainSelect, onAmountChange, onMaxClick, onSubmit, onWithdrawCompleted, onStartAnotherWithdrawal, onSignIn, onClose, }: WithdrawModalProps) => react_jsx_runtime_js.JSX.Element;
+
+interface DepositDetailsPanelProps {
+    address: string;
+    tokenIcon?: ReactNode;
+    minimumDeposit?: string;
+    onCopyAddress?: (address: string) => void;
+}
+declare const DepositDetailsPanel: ({ address, tokenIcon, minimumDeposit, onCopyAddress, }: DepositDetailsPanelProps) => react_jsx_runtime_js.JSX.Element;
+
+declare function getEnv(key: string): string;
+
+declare function getExplorerUrl(chainId: string, data: {
+    txId: string;
+}): string;
+
+export { type ApiResponse, type ChainData, type ChainInfo, type ChainsResponseData, type CreateOrderRequest, type CreateOrderResponseData, type CustodyAdapter, type DepositAddressResult, type DepositController, DepositDetailsPanel, type DepositDetailsPanelProps, DepositModal, type DepositModalConfig, type DepositModalProps, type DepositOrderResponseData, type DepositOrderStatus, type DepositStatus, DropdownField, type DropdownFieldProps, type Erc20BalanceResult, type FundingTokenBalanceOptions, type FundingWithdrawExecutorOptions, type GoogleCredential, type MarketDataProvider, type ModalController, type NativeSwapPayload, type PaymentPairData, type PaymentSessionResponseData, type PaymentSessionStatus, type PlatformRegisterRequest, type PlatformRegisterResponseData, type PredicateMarketPolicyAdapterOptions, type PredicateSDKConfig, type QuoteDirection, type QuoteRequest$1 as QuoteRequest, type QuoteResponseData, type QuoteResult, type SDKConfig, type SelectOption, SignInModal, type SignInModalProps, type SignInUiConfig, type SocialProvider, type TokenData, type TokenInfo, type TwitterAuthResult, type WalletItem, type WalletOption, WalletSelectionModal, type WalletSelectionModalProps, type WithdrawController, type WithdrawExecutor, WithdrawModal, type WithdrawModalConfig, type WithdrawModalProps, type WithdrawOrderResponseData, type WithdrawOrderStatus, type WithdrawRequest, type WithdrawResult, type WithdrawStatus, type WithdrawUiStatus, clearSocialAccountInstance, configureMerchantApi, createDepositController, createFundingWithdrawExecutor, createMarketDataProvider, createOrder, createPredicateMarketPolicyAdapter, createWithdrawController, fetchErc20Balance, fetchFundingTokenBalance, findTokenDataFromChains, getChains, getDepositOrder, getEnv, getExplorerUrl, getFixedAuthConfig, getMerchantApiClient, getSDKConfig, getWithdrawOrder, initSDK, isFedCMSupported, isUsdtWithdrawDirect, notifyTwitterCallback, parseUnits, quote, registerPlatform, signInWithGoogle, signInWithTwitter, tryAutoReconnect };