@nexus-cross/dapp-ui 1.4.0-beta.4 → 1.4.0-beta.6

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { Scope } from '@sentry/react';
 import * as React from 'react';
-import { Component, ReactNode, ErrorInfo, CSSProperties } from 'react';
+import { Component, ReactNode, ErrorInfo, CSSProperties, ElementType, ButtonHTMLAttributes } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions } from '@tanstack/react-query';
@@ -11,6 +11,87 @@ type DrawerDirection$1 = "right" | "bottom" | "left";
 
 declare function resolveEnvironment(env?: Environment | "staging" | "prd" | "prod" | "stg"): Environment;
 
+/** env별로 다르면 객체, 모든 env 동일하면 T 단일 값. */
+type RemoteEnvValue<T> = T | Record<Environment, T>;
+type AppsConfig = {
+    skills?: RemoteEnvValue<string>;
+    gametokenBridge?: RemoteEnvValue<string>;
+    /** 브릿지 버튼을 새창 대신 같은 창으로 여는 gametoken 사이트 URL prefix 목록. */
+    gametokenSites?: string[];
+    bridgePoweredBy?: {
+        url?: RemoteEnvValue<string>;
+    };
+    /**
+     * 약관 문서 링크. 브릿지 약관 동의 모달의 Terms of Service 링크가 읽는다 —
+     * cross-game-swap의 legal.json과 같은 운영 방식(무배포 교체). 호출부가
+     * `termsUrl` prop을 넘기면 그 값이 우선, 값이 없으면 DEFAULT_TERMS_URL 폴백.
+     */
+    legal?: {
+        termsUrl?: RemoteEnvValue<string>;
+    };
+    /**
+     * Get ONEUSD chooser action visibility. Swap/Bridge default to enabled;
+     * Transfer Crypto defaults to disabled when remote config is unavailable.
+     */
+    getOneUsd?: {
+        modes?: {
+            swap?: boolean;
+            bridge?: boolean;
+            transferCrypto?: boolean;
+        };
+        /**
+         * 액션별 최소 dapp-ui 버전. 호스트가 설치한 dapp-ui 가 이 값보다 낮으면
+         * `modes`가 true여도 해당 액션을 숨긴다 — 구버전에서 깨지는 기능을 호스트
+         * 재배포 없이 끄기 위한 장치. 값이 없으면 버전 제한 없음, 형식이 깨져
+         * 있으면 통과(설정 오타로 전체가 사라지지 않게).
+         */
+        minVersions?: {
+            swap?: string;
+            bridge?: string;
+            transferCrypto?: string;
+        };
+    };
+    /**
+     * 토큰 상세화면 섹션별 노출 여부. 값이 없으면 기본값(history·balance만 노출).
+     * 섹션 키: chart / balance(=My Balance + Send) / overview / social / history.
+     * env별 값은 apps.json 파일 자체가 환경마다 분리돼 있으므로 단순 boolean만 받는다.
+     */
+    tokenDetail?: {
+        sections?: {
+            chart?: boolean;
+            balance?: boolean;
+            overview?: boolean;
+            social?: boolean;
+            history?: boolean;
+        };
+    };
+    /**
+     * Relay(외부체인 → CROSS 입금) 운영 설정.
+     * `minDepositAmount`: 입금 위저드 Continue를 막는 최소 수량(사람 단위,
+     * 토큰 공통). CDN 값이 없거나 fetch 실패 시 호출부 폴백(6)이 적용된다 —
+     * endpoints.json과 달리 UI 게이트라 폴백을 허용한다.
+     */
+    relay?: {
+        minDepositAmount?: RemoteEnvValue<number | string>;
+        /**
+         * `maxDepositAmount`: Continue를 막는 최대 수량(사람 단위, 토큰 공통).
+         * 브릿지/DEX 유동성 한도를 운영이 수동 반영하는 값 — 미설정 시 상한 없음.
+         */
+        maxDepositAmount?: RemoteEnvValue<number | string>;
+        /**
+         * Role-labelled Relay factory addresses. New SDKs prefer this field so
+         * operators can tell the StandingForwarderFactory and
+         * DepositorForwarderFactory apart without relying on array order.
+         *
+         * A legacy `trustedFactories` field, if encountered, is deliberately not
+         * typed or read by current code.
+         */
+        forwarderFactories?: RemoteEnvValue<{
+            standingForwarderFactory?: string;
+            depositorForwarderFactory?: string;
+        }>;
+    };
+};
 declare const CHAINS_CONFIG_FILE = "chains.json";
 /** 체인 하나의 표시 메타. 지정 안 된 필드는 호출부 폴백(온체인/하드코딩)으로. */
 type ChainDisplayMeta = {
@@ -92,7 +173,7 @@ declare class DappUiErrorBoundary extends Component<DappUiErrorBoundaryProps, Da
     render(): ReactNode;
 }
 
-type DappUiFeature = "app_launcher" | "bridge" | "connect_button" | "relay" | "send" | "skills" | "wallet_connect" | "wallet_info" | "wallet_portfolio";
+type DappUiFeature = "app_launcher" | "bridge" | "connect_button" | "get_one_usd" | "relay" | "send" | "skills" | "wallet_connect" | "wallet_info" | "wallet_portfolio";
 type DappUiFlow = "connect" | "send" | "bridge" | "withdraw" | "relay";
 type DappUiFailureReason = "user-rejected" | "insufficient-gas" | "timeout" | "contract-reverted" | "network" | "unknown";
 interface TrackDappUiFunnelOptions {
@@ -755,7 +836,7 @@ interface BridgeInfoTokenRef {
 interface BridgeInfoRow {
     label: string;
     value: string;
-    tone?: "default" | "accent" | "warning";
+    tone?: "default" | "accent" | "warning" | "danger";
     routeTokens?: BridgeInfoTokenRef[];
     valueToken?: BridgeInfoTokenRef;
 }
@@ -848,9 +929,22 @@ interface BridgeFlowProps {
     onFailed?: (info: BridgeFailedInfo) => void;
     onClose?: () => void;
     onBackToWallet?: () => void;
+    /**
+     * 이 거래의 수수료를 서비스가 대납하는지. 견적(`BridgeTxSummary.txFeeInfo`)의
+     * `isDelegateFee` 는 가스만 가리키므로, 스왑/브릿지 수수료 대납은 호출부가
+     * 알려줘야 한다(Get ONEUSD 는 `pairs.swap/bridge.feeDelegated` 로 안다).
+     */
+    feeDelegated?: boolean;
+    /** Compact modal mode: fixed direction, no history entry, host-provided title. */
+    variant?: "default" | "embedded";
+    title?: string;
+    /** Embedded mode only. Defaults to whether `walletAddress` is present. */
+    isConnected?: boolean;
+    /** Opens the host wallet connection flow from the embedded CTA. */
+    onRequestConnect?: () => void;
     className?: string;
 }
-declare function BridgeFlow({ onClose, onBackToWallet, env, className, ...rest }: BridgeFlowProps): react_jsx_runtime.JSX.Element;
+declare function BridgeFlow({ onClose, onBackToWallet, feeDelegated, env, variant, title: titleProp, isConnected: isConnectedProp, onRequestConnect, className, ...rest }: BridgeFlowProps): react_jsx_runtime.JSX.Element;
 
 interface WalletInfoTriggerProps {
     asChild?: boolean;
@@ -1321,1352 +1415,1473 @@ interface WalletPortfolioBodyProps {
 }
 declare function WalletPortfolioBody({ env, theme, walletAddress, walletName, onBack, showHeader, variant, className, onOutlink, lpBalanceReader, stakingRewardsReader, sendTransaction, estimateGas, conversionRatio, currencySymbol, sections, }: WalletPortfolioBodyProps): react_jsx_runtime.JSX.Element;
 
-declare function CROSSxIcon(): react_jsx_runtime.JSX.Element;
-declare function MetaMaskIcon(): react_jsx_runtime.JSX.Element;
-declare function BinanceIcon(): react_jsx_runtime.JSX.Element;
-declare function Verse8Icon(): react_jsx_runtime.JSX.Element;
-declare function TronIcon(): react_jsx_runtime.JSX.Element;
-declare function GoogleIcon(): react_jsx_runtime.JSX.Element;
-declare function AppleIcon(): react_jsx_runtime.JSX.Element;
-
-declare const WALLET_REGISTRY: {
-    cross_embedded: {
-        id: string;
-        name: "ONEpocket with Social";
-        description: string;
-        icon: typeof CROSSxIcon;
-    };
-    cross_wallet: {
-        id: string;
-        name: "ONEpocket";
-        description: string;
-        icon: typeof CROSSxIcon;
-        featured: true;
-    };
-    cross_extension: {
-        id: string;
-        name: "ONEpocket Extension";
-        description: string;
-        icon: typeof CROSSxIcon;
-        rdns: string;
-        installUrl: string;
-        visibility: "desktop-only";
-    };
-    metamask: {
-        id: string;
-        name: string;
-        description: string;
-        icon: typeof MetaMaskIcon;
-        rdns: string;
-    };
-    binance: {
-        id: string;
-        name: string;
-        description: string;
-        icon: typeof BinanceIcon;
-    };
-    verse8: {
-        id: string;
-        name: string;
-        description: string;
-        icon: typeof Verse8Icon;
-        badge: string;
-    };
-    tron: {
-        id: string;
-        name: string;
-        description: string;
-        icon: typeof TronIcon;
-        badge: string;
-    };
-};
-type WalletId = keyof typeof WALLET_REGISTRY;
-declare const SOCIAL_REGISTRY: {
-    google: {
-        id: string;
-        name: string;
-        icon: typeof GoogleIcon;
-    };
-    apple: {
-        id: string;
-        name: string;
-        icon: typeof AppleIcon;
-    };
-};
-type SocialId = keyof typeof SOCIAL_REGISTRY;
-
-/**
- * Per-instance layout overrides applied as inline CSS variables.
- *
- * Colors / typography are driven by the design system (`--ds-*`, published
- * by `CrossConnectKitProvider` from `@nexus-cross/crossx-design-system`) —
- * retheme there, not per modal. Only layout knobs remain here.
- */
-interface WalletConnectModalStyle extends CSSProperties {
-    "--wcm-dialog-width"?: string;
-    "--wcm-drawer-max-width"?: string;
-    "--wcm-drawer-min-width"?: string;
+/** One origin-side ERC-20 (or native, address = zero) token the UI may offer. */
+interface Token {
+    symbol: string;
+    address: string;
+    decimals: number;
+    logoUrl?: string;
 }
-type WalletVisibility = "always" | "mobile-only" | "desktop-only";
-interface WalletConfig {
-    id: string;
-    name: string;
-    description: string;
-    icon: () => ReactNode;
-    rdns?: string;
-    featured?: boolean;
-    badge?: string;
-    installUrl?: string;
-    visibility?: WalletVisibility;
+/** The fixed destination asset every order delivers: crossd on CROSS. */
+interface Destination {
+    symbol: string;
+    chainId: number;
+    address: string;
+    decimals: number;
+    note?: string;
 }
-type WalletHandlers = Partial<Record<WalletId, () => void | Promise<void>>>;
-interface SocialConfig {
-    id: string;
-    name: string;
-    icon: () => ReactNode;
+/** Origin chain VM family: "evm" (default) or "svm" (Solana). */
+type ChainKind = 'evm' | 'svm';
+/**
+ * One delivery-side asset an order's crossd-equivalent output may be paid
+ * out as -- the default target (isDefault: true) is crossd itself
+ * (byte-identical to Catalog.destination); non-default targets are
+ * alternate payout assets the user may opt into (see GET /v1/deposit-address's
+ * `target` query param). `external: true` marks a target delivered via an
+ * external adapter (e.g. pONEUSD) rather than natively minted -- the UI
+ * shows an extra trust note for these (Task 9).
+ */
+type Target = {
+    symbol: string;
+    address: string;
+    decimals: number;
+    isDefault: boolean;
+    external: boolean;
+};
+/** One supported (chain, token) pair the UI can offer as an order's source. */
+interface OriginOption {
+    chainId: number;
+    chainName: string;
+    /**
+     * VM family of the origin chain. "svm" (Solana) origins are display-only:
+     * the connected EVM wallet cannot sign them, so no one-click deposit or
+     * balance read is offered -- the user pays out-of-band from a Solana wallet.
+     */
+    kind: ChainKind;
+    token: Token;
+    /** Smallest-unit base-10 integer string (matches Token.decimals). */
+    minAmount: string;
+    /** Smallest-unit base-10 integer string; absent = no configured cap. */
+    maxAmount?: string;
 }
-type SocialHandlers = Partial<Record<SocialId, () => void | Promise<void>>>;
-type DrawerDirection = "bottom" | "left" | "right" | "top";
-interface WalletConnectModalProps {
-    wallets: WalletHandlers;
-    socialProviders?: SocialHandlers;
+/**
+ * Which order-creation flow is live: "standing" (GET /v1/deposit-address
+ * returns a stable, reusable per-user address) or "per_order" (the legacy
+ * flow, a fresh forwarder minted per POST /v1/orders). See
+ * internal/catalog.Catalog.AddressMode's doc comment.
+ */
+type AddressMode = 'standing' | 'per_order';
+/** GET /v1/config response: the curated catalog of origins + fixed destination. */
+interface Catalog {
+    destination: Destination;
+    origins: OriginOption[];
+    addressMode: AddressMode;
     /**
-     * URL the "Terms of Service" link in the footer points to. When
-     * omitted the text is rendered without an anchor (still styled in the
-     * primary color to match the design).
+     * The user-selectable delivery targets an order may pay out as (Task 4).
+     * Always includes the default target (crossd, byte-identical to
+     * `destination`). Defaults to `[]` when the backend response omits this
+     * field entirely -- back-compat with an older backend that predates
+     * per-target delivery (see createRelayClient's getConfig).
      */
-    termsUrl?: string;
-    /** URL the "Privacy Policy" link in the footer points to. */
-    privacyUrl?: string;
-    theme?: "dark" | "light";
-    mobileBreakpoint?: number;
-    drawerDirection?: DrawerDirection;
-    dialogWidth?: string;
-    drawerMaxWidth?: string;
-    drawerMinWidth?: string;
-    style?: WalletConnectModalStyle;
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    children: ReactNode;
+    targets: Target[];
 }
-interface WalletConnectModalTriggerProps {
-    asChild?: boolean;
-    children?: ReactNode;
+/** POST /v1/quote request body. */
+interface QuoteRequest {
+    originChainId: number;
+    originCurrency: string;
+    /** Smallest-unit base-10 integer string. */
+    amount: string;
 }
-interface WalletConnectModalContentProps {
-    className?: string;
+/** POST /v1/quote response body. */
+interface QuoteResult {
+    /** Smallest-unit (BSC USDT, 18 decimals) base-10 integer string. */
+    expectedBscUsdt: string;
+    belowMin: boolean;
+    /**
+     * Smallest-unit (crossd, catalog.destination.decimals) base-10 integer
+     * string. Currently assumed at 1:1 parity with BSC USDT -- see
+     * assumesParity.
+     */
+    expectedCrossd: string;
+    assumesParity: boolean;
+    /**
+     * The fee DEDUCTED FROM the bridged amount, in USD, as a decimal string --
+     * Relay's relayer fee plus any app surcharge (upstream af35dd5). It is
+     * exactly what accounts for the gap between what the user sends and
+     * `expectedBscUsdt`.
+     *
+     * It deliberately EXCLUDES the user's own origin-chain gas: that is paid from
+     * their wallet in the origin chain's native token, the wallet already quotes
+     * it at signing time, and none of it comes out of the bridged amount.
+     *
+     * Absent means UNKNOWN, never free -- render absence as absence. "$0.00" for
+     * a fee nobody could compute is the one wrong reading. (A genuine zero, e.g.
+     * the direct BSC-USDT route with no Relay leg, is also absent rather than
+     * "0": no Relay leg means no relayer fee to report.)
+     */
+    feeUsd?: string;
+    /**
+     * How many seconds this quote stays valid. Drives the refresh cadence in
+     * useDepositAddress -- the widget previously hardcoded 30s with no
+     * relationship to the quote's real lifetime. Absent when the backend has no
+     * TTL configured, in which case the client keeps its own default interval.
+     *
+     * There is deliberately no eta/duration field here. An earlier version of
+     * this type carried `etaSeconds` on the assumption that Relay's quote
+     * reports timing; it does not -- the response has no ETA field of any kind
+     * -- so it was removed rather than left permanently undefined.
+     */
+    ttl?: number;
 }
-
-declare function WalletConnectModalTrigger({ asChild, children, }: WalletConnectModalTriggerProps): react_jsx_runtime.JSX.Element;
-
-declare function WalletConnectModalContent({ className, }: WalletConnectModalContentProps): react_jsx_runtime.JSX.Element;
-
-declare function WalletConnectModalRoot({ wallets, socialProviders, termsUrl, privacyUrl, theme, mobileBreakpoint, drawerDirection, dialogWidth, drawerMaxWidth, drawerMinWidth, style, open: openProp, onOpenChange, children, }: WalletConnectModalProps): react_jsx_runtime.JSX.Element;
-declare const WalletConnectModal: typeof WalletConnectModalRoot & {
-    Trigger: typeof WalletConnectModalTrigger;
-    Content: typeof WalletConnectModalContent;
-};
-
-interface DetectedWallet {
-    rdns: string;
-    name: string;
-    icon?: string;
+/** GET /v1/deposit-address request query params -- no amount: a standing
+ * address is resolved purely from (user, originChainId, originCurrency),
+ * independent of any deposit size. */
+interface DepositAddressRequest {
+    user: string;
+    originChainId: number;
+    originCurrency: string;
 }
-interface WalletDetectResult {
-    wallets: DetectedWallet[];
-    isDetected: (rdns: string) => boolean;
-    isLoading: boolean;
+/**
+ * GET /v1/deposit-address response body -- a stable, reusable deposit
+ * address for this (user, origin chain, origin token). The same request
+ * always resolves to the same address; no order/deposit is created by
+ * fetching it, and it accepts any number of deposits over time (see
+ * internal/standing.Service.GetOrCreateDepositAddress).
+ */
+interface DepositAddressResult {
+    user: string;
+    forwarder: string;
+    version: number;
+    depositAddress: string;
+    originChainId: number;
+    originCurrency: string;
 }
-declare function useWalletDetect(): WalletDetectResult;
-
 /**
- * `ConnectButton`의 `style` prop 타입. 표준 `CSSProperties` 위에
- * `--cb-*` CSS 커스텀 변수 키를 추가해 자동완성을 지원한다.
- *
- * 사용 예: `style={{ "--cb-bg": "#7346f3", "--cb-pill-bg": "#1a1a2e" }}`
+ * One row of GET /v1/orders?user=...'s "orders" array. A single order can
+ * aggregate several deposits made to the same reusable forwarder; `deposits[]`
+ * is the per-arrival identity. Amount fields are smallest-unit base-10 integer
+ * strings, "" when not yet known.
+ */
+interface OrderSummary {
+    orderId: string;
+    status: string;
+    source: string;
+    amountIn: string;
+    expectedOut: string;
+    bscBridgeTx: string;
+    originChainId: number;
+    originCurrency: string;
+    /** CROSS delivery-token symbol this order pays out as (a Catalog.targets
+     * symbol, e.g. "pONEUSD"); "" / omitted means the default target. Used to
+     * label the "out" side with the actual delivered token. */
+    target?: string;
+    forwarderVersion: number;
+    /** RFC3339 timestamp. */
+    createdAt: string;
+    /** What the user ACTUALLY received, observed from the CROSS delivery
+     * transfer. Distinct from expectedOut, which is the pre-delivery projection
+     * after fees -- the two differ by swap slippage and any executor fallback.
+     * "" until delivery, and for orders delivered before the backend recorded it. */
+    amountOut?: string;
+    /** The CROSS-side transaction that delivered the funds. "" until delivery. */
+    deliveryTxHash?: string;
+    /** RFC3339 timestamp of the COMPLETED transition -- when the user received
+     * the funds. Absent for orders that never completed. */
+    completedAt?: string;
+    /** The individual deposits this delivery paid out, oldest first. There can be
+     * SEVERAL: a user may top up a little at a time and the sweeper aggregates
+     * whatever has arrived into one order. Empty when the backend has not
+     * attributed the deposits to this order yet. */
+    deposits?: OrderDeposit[];
+}
+/** One deposit inside an order, as GET /v1/orders reports it.
  *
- * 변수는 ConnectButton 의 모든 상태(disconnected / connecting / connected
- * pill)에 cascading 된다. WalletInfo popover 의 스타일은 별도
- * `walletInfoStyle` prop 으로 분리되어 있다.
+ * originChainId/originCurrency are the chain and token the user ACTUALLY paid,
+ * which the order itself cannot report (one reusable deposit address serves
+ * every origin route, so the swept balance carries no memory of where it came
+ * from). They are absent when the backend has not attributed the deposit --
+ * for a DIRECT BSC deposit that is permanent and correct, since it has no
+ * cross-chain leg. */
+interface OrderDeposit {
+    /** Amount that arrived at the forwarder, in BSC USDT base units. NOT the
+     * amount sent on the origin chain, which is larger by Relay's fees and
+     * denominated in the origin token's own decimals. */
+    amount: string;
+    blockNumber: number;
+    originChainId?: number;
+    originCurrency?: string;
+    /** The BSC-side arrival (transfer into the forwarder). */
+    txHash: string;
+    /** The user's own send on the ORIGIN chain -- what the "Deposit" step links
+     * to. Absent when unattributed. */
+    originTxHash?: string;
+}
+type StepStatus = 'done' | 'active' | 'pending';
+interface OrderStep {
+    key: string;
+    label: string;
+    status: StepStatus;
+}
+/**
+ * GET /v1/orders/{orderId} response body. "status" is the raw backend state
+ * (e.g. "AWAITING_DEPOSIT", "COMPLETED", "FAILED", ...); "steps" is the
+ * friendlier 3-stage deposit -> bridge -> deliver breakdown the UI renders.
  */
-interface ConnectButtonStyle extends CSSProperties {
-    "--cb-bg"?: string;
-    "--cb-bg-hover"?: string;
-    "--cb-color"?: string;
-    "--cb-border"?: string;
-    "--cb-radius"?: string;
-    "--cb-height"?: string;
-    "--cb-padding"?: string;
-    "--cb-font-family"?: string;
-    "--cb-font-size"?: string;
-    "--cb-font-weight"?: string | number;
-    "--cb-line-height"?: string | number;
-    "--cb-letter-spacing"?: string;
-    "--cb-gap"?: string;
-    "--cb-transition"?: string;
-    "--cb-loading-opacity"?: string | number;
-    "--cb-press-scale"?: string | number;
-    "--cb-icon-size"?: string;
-    "--cb-spinner-size"?: string;
-    "--cb-spinner-thumb"?: string;
-    "--cb-spinner-track"?: string;
-    "--cb-pill-bg"?: string;
-    "--cb-pill-bg-hover"?: string;
-    "--cb-pill-color"?: string;
-    "--cb-pill-border"?: string;
-    "--cb-pill-radius"?: string;
-    "--cb-pill-height"?: string;
-    "--cb-pill-padding"?: string;
-    "--cb-pill-press-scale"?: string | number;
-    "--cb-pill-font-family"?: string;
-    "--cb-pill-font-size"?: string;
-    "--cb-pill-font-weight"?: string | number;
-    "--cb-pill-line-height"?: string | number;
-    "--cb-pill-gap"?: string;
-    "--cb-pill-icon-size"?: string;
-    "--cb-pill-icon-placeholder-bg"?: string;
-    "--cb-pill-address-font"?: string;
-    "--cb-pill-address-font-size"?: string;
-    "--cb-pill-address-letter-spacing"?: string;
+interface Order {
+    orderId: string;
+    status: string;
+    steps: OrderStep[];
+    bridgeIndex: string;
+    txs: {
+        bscBridge: string;
+        crossFinalize: string;
+        crossExecute: string;
+    };
 }
 /**
- * Resolved wallet provider — determines which icon + display name appears
- * in the connected pill.
- *
- * - `google` / `apple`: crossy-sdk 2.0 OAuth login types (embedded wallet)
- * - `cross`: generic CROSSx mark (covers CROSSx 1.0 extension/app + 2.0
- *   embedded when no OAuth provider is attached)
- * - `metamask` / `binance`: external wallets
+ * GET /v1/recovery?user=... response body -- the permissionless self-recovery
+ * status for a user's standing forwarder on BSC. Task 1's endpoint; consumed
+ * by useRecovery (Task 2) to drive the settings-menu "Recover stuck funds"
+ * panel. Every recovery tx (factory.deploy, forwarder.execute/sweepToUser)
+ * takes no destination argument -- funds always route to `forwarder`'s
+ * immutable recipient, so this info is advisory/orientation only, never a
+ * capability check the UI should use to block the user.
  */
-type WalletProvider = "google" | "apple" | "cross" | "metamask" | "binance";
-interface ConnectButtonProps {
-    /** 사용자가 Connect 버튼을 눌러 연결이 진행 중. 스피너 버튼으로 전환된다. */
-    isConnecting?: boolean;
+interface RecoveryInfo {
+    user: string;
+    /** The user's forwarder address on BSC for the requested target (CREATE2, deterministic from
+     * user+version+target). */
+    forwarder: string;
+    /** Whether `forwarder` has been deployed on-chain yet. */
+    isDeployed: boolean;
+    /** BSC USDT token contract address -- always BSC USDT regardless of `target` (the forwarder
+     * holds BSC USDT pre-bridge in every case). */
+    token: string;
+    decimals: number;
+    /** Smallest-unit base-10 integer string -- the forwarder's current token balance. */
+    balance: string;
+    /** The factory that deploys/derives `forwarder` for the requested target: the
+     * DepositorForwarderFactory for a depositor-kind target, the StandingForwarderFactory
+     * otherwise (recovery follow-up, multi-target). */
+    factory: string;
+    version: number;
+    /** Smallest-unit base-10 integer string -- the bridge's configured minimum. */
+    bridgeMinWei: string;
+    /** Server's best-effort recommendation: "execute" (balance clears the bridge minimum, so a
+     * normal delivery can complete), "sweep" (below minimum -- recover directly instead), or
+     * "none" (no balance to act on). Advisory only -- never used to disable an action. */
+    suggestedAction: 'execute' | 'sweep' | 'none';
+    /** True when the backend sees this balance as possibly mid-flight (e.g. a sweep/bridge job
+     * already in progress) -- advisory caution only, must NOT disable either recovery action. */
+    inFlight: boolean;
+    inFlightReason?: string;
     /**
-     * 0x… 지갑 주소. 지정되면 connected pill로 렌더링된다. 없으면
-     * disconnected 버튼("Connect Wallet")으로 떨어진다.
+     * Task 6/7: every known BSC token held at `forwarder` (not just the primary `token`/`balance`
+     * pair above, which only ever reports BSC USDT) -- lets the UI surface a MISDEPOSITED token
+     * (e.g. someone sent BUSD to a USDT-swap forwarder) that the top-level fields alone can't
+     * represent. Optional/omitted for an older backend that predates this field -- back-compat,
+     * byte-identical to pre-Task-6 behavior when absent (the UI falls back to `token`/`balance`).
+     * Each entry's `suggestedAction` mirrors the top-level one's semantics, per-token.
      */
-    address?: string;
+    tokens?: {
+        address: string;
+        symbol: string;
+        decimals: number;
+        /** Smallest-unit base-10 integer string -- this token's current balance at `forwarder`. */
+        balance: string;
+        /** Server's advisory recoverable flag for this token -- never used to disable the sweep
+         * action (see `recover`'s doc in useRecovery.ts), only to decide which tokens the UI lists. */
+        recoverable: boolean;
+        suggestedAction: 'execute' | 'sweep' | 'none';
+    }[];
+}
+/** GET /v1/recovery request query params. */
+interface RecoveryRequest {
+    user: string;
+    /** Selected CROSS delivery target symbol (mirrors DepositAddressRequest's `target`) -- omitted
+     * (or empty) selects the configured default, preserving pre-multi-target behavior
+     * byte-for-byte. Passed through verbatim as "?target=" when set. */
+    target?: string;
+}
+
+/** Thrown for any non-2xx API response. `status` is the HTTP status code. */
+declare class RelayApiError extends Error {
+    status: number;
+    /** Parsed JSON error body when the response was valid JSON, else undefined. */
+    body?: unknown;
+    constructor(status: number, message: string, body?: unknown);
+}
+interface RelayClientOptions {
+    /** API origin, e.g. "https://orchestrator.example.com". Trailing slashes are stripped. */
+    baseUrl: string;
+}
+interface RelayClient {
+    /** GET /v1/config -- the curated origin catalog + fixed crossd destination. */
+    getConfig(): Promise<Catalog>;
+    /** POST /v1/quote -- a price-only preview, no order/deposit is created. */
+    getQuote(req: QuoteRequest): Promise<QuoteResult>;
     /**
-     * 트리거 pill에 표시될 provider 아이콘 키.
+     * GET /v1/deposit-address -- resolves the stable, reusable deposit
+     * address for (user, originChainId, originCurrency). No amount is
+     * involved and no order is created; the same address can receive any
+     * number of deposits of any size. Several deposits can be aggregated into
+     * one order when they jointly fund the same reusable forwarder.
      *
-     * `address`가 있는데 `provider`가 `undefined`면 SDK 조회 중인 전이
-     * 상태로 취급해 placeholder 원을 띄운다(`pending` 플래시 방지).
-     */
-    provider?: WalletProvider;
-    /**
-     * 트리거 버튼 aria-label에 포함될 provider 표시 이름. 미지정 시
-     * `provider`로부터 기본값이 유추된다 (예: 'Google', 'CROSSx').
-     */
-    providerName?: string;
-    /** WalletInfo 헤더에 노출될 계정 라벨 (예: "Account 1", 사용자 지정 이름). */
-    accountName?: string;
-    /** Send 주소록의 My Account 탭에 노출할 계정 목록. */
-    sendAccounts?: SendAccount[];
-    /** disconnected 상태에서 버튼 클릭 핸들러. */
-    onConnect?: () => void;
-    /** connected 상태에서 WalletInfo 하단 Disconnect 클릭 핸들러. */
-    onDisconnect?: () => void;
-    /**
-     * 주소 복사 성공 콜백. WalletInfo의 `onCopyAddress(address, success)` 에서
-     * `success === true`일 때만 호출된다.
-     */
-    onCopy?: () => void;
-    /** 지갑 변경 chevron 클릭 핸들러. 지정하지 않으면 chevron이 숨김 처리된다. */
-    onSelectWallet?: () => void;
-    /**
-     * WalletInfo 기본 액션 row의 Buy 클릭 핸들러. Promise를 반환하면 reject 시
-     * Buy 카드가 `onBuyDisabledMessage`와 동일한 토스트로 실패를 안내한다.
-     */
-    onBuy?: () => void | Promise<void>;
-    /**
-     * Buy 카드를 시각적으로 비활성 상태로 표시하고, 사용자가 클릭하면 이 메시지를
-     * 토스트로 띄운다. `onBuy`보다 우선. WalletInfoProps의 동일 prop으로 그대로
-     * 전달된다.
-     */
-    onBuyDisabledMessage?: string;
-    /**
-     * disconnected 버튼 라벨. 기본 'Connect Wallet'.
-     * 문자열 외에 ReactNode를 넘겨 아이콘-only / 커스텀 마크업을 렌더할 수 있다
-     * (모바일에서 아이콘만 보여주고 싶을 때 등).
-     */
-    label?: ReactNode;
-    /** isConnecting 상태 라벨. 기본 'Connecting...'. */
-    connectingLabel?: ReactNode;
-    /** WalletInfo 내장 Disconnect 버튼 라벨. 기본 'Disconnect'. */
-    disconnectLabel?: string;
-    /**
-     * 외부(호출부)에서 주입하는 className. disconnected / connecting /
-     * connected(트리거 pill)에 공통으로 추가된다 (기본 `cb-button` /
-     * `cb-pill` 클래스에 병합).
-     */
-    className?: string;
-    /**
-     * 버튼 자체(`disconnected` / `connecting` / `connected pill`)의
-     * CSS 커스텀 변수 오버라이드. WalletInfo popover 스타일은 별도
-     * `walletInfoStyle` 로 분리되어 있다.
-     */
-    style?: ConnectButtonStyle;
-    /**
-     * 트리거 pill 을 눌러 열리는 WalletInfo popover/drawer 의 CSS
-     * 커스텀 변수 오버라이드 (`WalletInfoStyle`).
+     * `target` (Task 8) is the delivery asset's symbol from
+     * `Catalog.targets` -- sent as `&target=<symbol>` only when it's a
+     * non-empty string; omitted otherwise, in which case the backend
+     * resolves the default target (byte-identical to pre-Task-6 behavior).
      */
-    walletInfoStyle?: WalletInfoStyle;
-    theme?: Theme;
-    env?: Environment;
-    showBalance?: boolean;
-    showPortfolio?: boolean;
-    drawerDirection?: DrawerDirection$1;
-    modal?: boolean;
-    connectorId?: ConnectorId;
-    /** Send 페이지의 일반 토큰 전송에 사용할 외부 트랜잭션 전송 함수. */
-    sendTransaction?: SendTransactionFn$1;
-    getTransactionReceipt?: GetTransactionReceiptFn;
+    getDepositAddress(req: DepositAddressRequest, target?: string): Promise<DepositAddressResult>;
     /**
-     * Send 확인 단계의 가스/수수료 추정 함수. 미주입 시 SendPage Confirm 화면의
-     * Est. Tx Fee / Gas Limit / Max. Total Amount 행이 "—"로 표시된다.
+     * GET /v1/orders/{orderId} -- current status + stepper progress for one
+     * order. Reads are public (unauthenticated).
      */
-    estimateGas?: EstimateGasFn;
+    getOrder(orderId: string): Promise<Order>;
     /**
-     * 상단 QR 버튼 / 기본 액션 row의 Receive / Send 콜백. (Buy는 위 onBuy로
-     * 정의됨.)
+     * GET /v1/orders?user=... -- every order swept from deposits to that
+     * user's standing address(es) (newest-first, capped server-side).
      */
-    onReceive?: () => void;
+    listOrders(user: string): Promise<OrderSummary[]>;
+    /** Absolute URL of the SSE order-change stream for `user`
+     * (GET /v1/orders/stream?user=...). Emits `event: connected` on open,
+     * `event: orders-changed` when that user's orders change, and `:
+     * heartbeat` comments -- it carries no order data itself, so consumers
+     * always follow up with `listOrders`. */
+    ordersStreamUrl(user: string): string;
     /**
-     * @deprecated Bridge 버튼은 항상 apps.json(gametokenBridge) 웹으로
-     * 이동한다. 이 콜백은 더 이상 호출되지 않는다.
+     * GET /v1/recovery?user=... -- permissionless self-recovery status for a
+     * user's forwarder on BSC (Task 1). `req.target` (optional) selects which
+     * per-target forwarder/factory to report -- omitted selects the
+     * configured default, byte-identical to pre-multi-target behavior.
+     * Purely informational -- fetching it never triggers or blocks any
+     * on-chain action. The response's `tokens[]` (Task 6/7 -- every known BSC
+     * token held at the forwarder) flows through as-is: it's plain JSON, so no
+     * extra parsing/mapping is needed beyond RecoveryInfo's own typing, and
+     * it's simply absent/undefined for an older backend that predates it.
      */
-    onBridge?: () => void;
-    onSend?: () => void;
-    bridgeTokens?: BridgeToken[];
-    bridgeHistory?: BridgeHistoryItem[];
-    getBridgeQuote?: BridgeQuoteFn;
-    getBridgeToTokens?: BridgeGetToTokensFn;
-    getBridgeApproval?: BridgeGetApprovalFn;
-    approveBridge?: BridgeApproveFn;
-    submitBridge?: BridgeSubmitFn;
+    getRecovery(req: RecoveryRequest): Promise<RecoveryInfo>;
 }
-
-/**
- * 3-state wallet connect button. Caller drives the visual state:
- *
- *   - `isConnecting === true`        → 스피너 disabled 버튼
- *   - `address` 있음                 → WalletInfo + connected pill
- *   - `address`가 있는데 `provider` 없음 → SDK 조회 전이 상태, placeholder 원
- *   - 둘 다 없음                     → "Connect Wallet" 버튼
- *
- * view-only: wagmi / connect-kit 같은 web3 의존성은 갖지 않으며 모든
- * 상태/데이터/콜백은 props로 주입받는다. 실제 wagmi 연결 로직은
- * `@nexus-cross/connect-kit-react`의 상위 래퍼에서 수행한다.
- */
-declare function ConnectButton({ isConnecting, address, provider, providerName, accountName, sendAccounts, onConnect, onDisconnect, onCopy, onSelectWallet, onBuy, onBuyDisabledMessage, label, connectingLabel, disconnectLabel, className, theme, env, showBalance, showPortfolio, drawerDirection, modal, connectorId, style, walletInfoStyle, sendTransaction, getTransactionReceipt, estimateGas, onReceive, onBridge, onSend, bridgeTokens, bridgeHistory, getBridgeQuote, getBridgeToTokens, getBridgeApproval, approveBridge, submitBridge, }: ConnectButtonProps): react_jsx_runtime.JSX.Element;
-
 /**
- * Wallet provider icons used by `ConnectButton`. Ported from
- * `@nexus-cross/connect-kit-wagmi` so dapp-ui stays a self-contained,
- * bundler-agnostic module (no SVG loader required) and doesn't pull in a
- * web3 dependency for icon assets.
- *
- * Each icon is an inline `data:image/svg+xml` URI so it can be consumed
- * directly by `<img src={...}>`.
+ * Builds a framework-agnostic Relay API client. Uses plain `fetch` only --
+ * no react-query, no RainbowKit/wagmi. `baseUrl` is passed in explicitly (no
+ * `import.meta.env` coupling) so the widget can be embedded in any host app's
+ * own config/env story.
  *
- * Source references mirror the ones in `connect-kit-wagmi/src/wallets/icons.ts`:
- *   wallet-crossx.svg        → CROSSX_ICON        (cross / cross-extension / cross-embedded fallback)
- *   wallet-metamask.svg      → METAMASK_ICON
- *   wallet-binance.svg       → BINANCE_ICON
+ * No API key: the backend has no inbound key gate (upstream 83845fb removed
+ * the dead `apiKey`/X-API-Key plumbing -- a security control that does not
+ * exist must not appear in a public type).
  */
-declare const CROSSX_ICON: string;
-declare const METAMASK_ICON: string;
-declare const BINANCE_ICON: string;
-declare const GOOGLE_ICON: string;
-declare const APPLE_ICON: string;
+declare function createRelayClient(options: RelayClientOptions): RelayClient;
 
-/**
- * `SkillsButton`의 `style` prop 타입. 표준 `CSSProperties` 위에
- * `--sb-*` CSS 커스텀 변수 키를 추가해 자동완성을 지원한다.
- *
- * 사용 예: `style={{ "--sb-color": "white", "--sb-bg": "rgba(0,0,0,0.4)" }}`
- *
- * CSS 변수는 자식 요소(아이콘, 스피너)로 cascading 되므로, `--sb-color`
- * 하나만 바꿔도 텍스트·아이콘·스피너가 모두 같은 색을 따라간다.
- */
-interface SkillsButtonStyle extends CSSProperties {
-    "--sb-bg"?: string;
-    "--sb-border"?: string;
-    "--sb-border-hover"?: string;
-    "--sb-color"?: string;
-    "--sb-color-hover"?: string;
-    "--sb-radius"?: string;
-    "--sb-height"?: string;
-    "--sb-padding"?: string;
-    "--sb-gap"?: string;
-    "--sb-font-size"?: string;
-    "--sb-font-weight"?: string | number;
-    "--sb-line-height"?: string | number;
-    "--sb-letter-spacing"?: string;
-    "--sb-blur"?: string;
-    "--sb-border-width"?: string;
-    "--sb-icon-size"?: string;
-    "--sb-icon-hover-rotation"?: string;
-    "--sb-spinner-size"?: string;
-    "--sb-spinner-thumb"?: string;
-    "--sb-spinner-track"?: string;
-    "--sb-disabled-opacity"?: string | number;
-    "--sb-press-scale"?: string | number;
-    "--sb-hover-duration"?: string;
-    "--sb-icon-duration"?: string;
-    "--sb-easing"?: string;
-}
-interface SkillsButtonProps {
-    /** Button text label */
-    label?: string;
-    /** Skills service URL or path to navigate to */
-    href?: string;
-    /** Called when button is clicked (instead of navigation if provided) */
-    onClick?: () => void | Promise<void>;
-    /** Optional CSS class name (merged with built-in `.sb-button`) */
-    className?: string;
-    /** Inline style + CSS custom property overrides (`SkillsButtonStyle`) */
-    style?: SkillsButtonStyle;
-    /** Light/dark surface preset (sets `data-theme`). Defaults to no preset. */
-    theme?: Theme;
-    /** Disable the button */
-    disabled?: boolean;
-    /** Whether button is in loading state */
-    isLoading?: boolean;
-    /** Label shown while loading */
-    loadingLabel?: string;
-    /** Open link in new tab */
-    openInNewTab?: boolean;
-    /** Button type attribute */
-    type?: "button" | "submit" | "reset";
+interface DefaultToken {
+    chainId: number;
+    /** Token contract address, or the zero address for the chain's native asset. */
+    address: string;
 }
 
-/**
- * @deprecated 이동 대상은 apps.json(skills)이 단일 소스다. 이 상수는 더 이상
- * 폴백으로 쓰이지 않으며 하위 호환(공개 export)용으로만 남아 있다.
- */
-declare const DEFAULT_SKILLS_HREF = "https://www.onechain.nexus/skills";
-declare function SkillsButton({ label, href, onClick, className, style, theme, disabled, isLoading, loadingLabel, openInNewTab, type, }: SkillsButtonProps): react_jsx_runtime.JSX.Element;
-
-/** One origin-side ERC-20 (or native, address = zero) token the UI may offer. */
-interface Token {
-    symbol: string;
-    address: string;
-    decimals: number;
-    logoUrl?: string;
+type Hex = `0x${string}`;
+interface RelayTxRequest {
+    chainId: number;
+    to: Hex;
+    value?: bigint;
+    data?: Hex;
 }
-/** The fixed destination asset every order delivers: crossd on CROSS. */
-interface Destination {
-    symbol: string;
+interface RelayContractCall {
     chainId: number;
-    address: string;
+    address: Hex;
+    abi: readonly unknown[];
+    functionName: string;
+    args: readonly unknown[];
+}
+interface RelayBalance {
+    value: bigint;
     decimals: number;
-    note?: string;
+    symbol: string;
 }
-/** Origin chain VM family: "evm" (default) or "svm" (Solana). */
-type ChainKind = 'evm' | 'svm';
-/**
- * One delivery-side asset an order's crossd-equivalent output may be paid
- * out as -- the default target (isDefault: true) is crossd itself
- * (byte-identical to Catalog.destination); non-default targets are
- * alternate payout assets the user may opt into (see GET /v1/deposit-address's
- * `target` query param). `external: true` marks a target delivered via an
- * external adapter (e.g. pONEUSD) rather than natively minted -- the UI
- * shows an extra trust note for these (Task 9).
- */
-type Target = {
-    symbol: string;
-    address: string;
-    decimals: number;
-    isDefault: boolean;
-    external: boolean;
-};
-/** One supported (chain, token) pair the UI can offer as an order's source. */
-interface OriginOption {
+type SendTransactionFn = (req: RelayTxRequest) => Promise<Hex>;
+type WriteContractFn = (call: RelayContractCall) => Promise<Hex>;
+type ReadContractFn = (call: RelayContractCall) => Promise<unknown>;
+type SwitchChainFn = (chainId: number) => Promise<void>;
+type WaitForReceiptFn = (p: {
     chainId: number;
-    chainName: string;
-    /**
-     * VM family of the origin chain. "svm" (Solana) origins are display-only:
-     * the connected EVM wallet cannot sign them, so no one-click deposit or
-     * balance read is offered -- the user pays out-of-band from a Solana wallet.
-     */
-    kind: ChainKind;
-    token: Token;
-    /** Smallest-unit base-10 integer string (matches Token.decimals). */
-    minAmount: string;
-    /** Smallest-unit base-10 integer string; absent = no configured cap. */
-    maxAmount?: string;
+    hash: Hex;
+}) => Promise<{
+    status: "success" | "reverted";
+}>;
+type GetBalanceFn = (p: {
+    chainId: number;
+    address: Hex;
+    token?: Hex;
+}) => Promise<RelayBalance>;
+/** 지갑 주입 props — 전부 optional, 미주입 시 graceful degradation. */
+interface RelayWalletProps {
+    walletAddress?: string;
+    walletChainId?: number;
+    sendTransaction?: SendTransactionFn;
+    writeContract?: WriteContractFn;
+    readContract?: ReadContractFn;
+    switchChain?: SwitchChainFn;
+    waitForReceipt?: WaitForReceiptFn;
+    getBalance?: GetBalanceFn;
+}
+/** A recovery transaction confirmed successfully on BNB Smart Chain. */
+interface RecoverySuccessResult {
+    action: "execute" | "sweep";
+    forwarder: string;
+    actionTxHash: string;
+    /** Present only when this attempt first had to deploy the forwarder. */
+    deployTxHash?: string;
 }
+type RelayTheme = "dark" | "light";
+type RelayDrawerDirection = "bottom" | "left" | "right" | "top";
 /**
- * Which order-creation flow is live: "standing" (GET /v1/deposit-address
- * returns a stable, reusable per-user address) or "per_order" (the legacy
- * flow, a fresh forwarder minted per POST /v1/orders). See
- * internal/catalog.Catalog.AddressMode's doc comment.
+ * Props of the `<RelayDeposit>` compound root (Task 11) — the union of
+ *
+ *   * `RelayWalletProps` (injected wallet capabilities, all optional),
+ *   * the source widget's own configuration props (relay-protocol
+ *     `packages/relay-widget/src/components/RelayDeposit.tsx`), minus its
+ *     `theme: 'auto'` option, which the shared modal shell doesn't have, and
+ *   * `ResponsiveShellProps`' modal/drawer knobs (theme/breakpoint/size/open),
+ *     re-declared here rather than extended so the public surface reads as one
+ *     flat prop list.
+ *
+ * `children` holds `<RelayDeposit.Trigger>` / `<RelayDeposit.Content>`.
  */
-type AddressMode = 'standing' | 'per_order';
-/** GET /v1/config response: the curated catalog of origins + fixed destination. */
-interface Catalog {
-    destination: Destination;
-    origins: OriginOption[];
-    addressMode: AddressMode;
+interface RelayDepositProps extends RelayWalletProps {
+    /** Pre-built client. Takes precedence over apiBaseUrl. */
+    client?: RelayClient;
+    /** Used to build a client via createRelayClient when `client` isn't passed. */
+    apiBaseUrl?: string;
     /**
-     * The user-selectable delivery targets an order may pay out as (Task 4).
-     * Always includes the default target (crossd, byte-identical to
-     * `destination`). Defaults to `[]` when the backend response omits this
-     * field entirely -- back-compat with an older backend that predates
-     * per-target delivery (see createRelayClient's getConfig).
+     * Selects a built-in default relay API base URL (dev/stage/production) when
+     * `apiBaseUrl` isn't passed. `client`/`apiBaseUrl` still take precedence --
+     * this is only consulted when neither is provided. Omitted falls back to
+     * the same global environment resolution every other dapp-ui feature uses
+     * (see `resolveEnvironment`), defaulting to production.
      */
-    targets: Target[];
-}
-/** POST /v1/quote request body. */
-interface QuoteRequest {
-    originChainId: number;
-    originCurrency: string;
-    /** Smallest-unit base-10 integer string. */
-    amount: string;
+    environment?: Environment;
+    /** Restrict the catalog's origins to these chain ids. */
+    chains?: number[];
+    /** Controlled recipient; when provided the recipient input is hidden and no wallet
+     * connection is required to fetch a deposit address. Defaults to `walletAddress`. */
+    recipient?: string;
+    /** Require a valid connected wallet before the deposit flow can issue an
+     * address, quote an amount, or start live order/recovery reads. When enabled,
+     * the recipient is pinned to `walletAddress`; a controlled `recipient` cannot
+     * redirect the connected user's deposit. Defaults to `true` when
+     * `showRecipientInput` is explicitly `false`, otherwise `false` for the
+     * low-level public-address integration. `CrossRelayDeposit` always enables
+     * this guard. */
+    requireWalletConnection?: boolean;
+    /** Hide the editable recipient input even when `recipient` is NOT controlled
+     * (default `true` = original behavior). Hosts that lock the recipient to the
+     * connected wallet set this `false` so a disconnected user sees a connect
+     * prompt instead of a free-form address field — the deposit address can then
+     * only ever resolve to the logged-in wallet. */
+    showRecipientInput?: boolean;
+    /** Controlled human-decimal amount; when provided the amount input is hidden. Optional —
+     * it only drives the quote preview, and never blocks the deposit address. */
+    amount?: string;
+    /** Hide the amount input entirely (address-only, send-any-amount). Independent of `amount`. */
+    hideAmount?: boolean;
+    /** Render the EVM one-click deposit button (default `false`: the modal only
+     * offers the QR / copy-address manual deposit path). Opt in with `true` for
+     * hosts whose users connect external wallets that can sign on the origin
+     * chains — CROSS embedded-wallet users never can, hence the off default. */
+    showOneClickDeposit?: boolean;
+    /** Enable recovery actions (default `false` for low-level RelayDeposit).
+     * The Recover tab remains visible so the Deposit navigation always has the
+     * same three entries; when disabled it shows an unavailable-state message.
+     * Recovery signs on BSC with the connected wallet, which CROSS embedded-wallet
+     * users can never do — so actions stay unavailable unless a host serving
+     * external wallets opts in. Even opted in, it still requires the injected
+     * `writeContract`/`readContract`/`waitForReceipt` capability trio. */
+    showRecovery?: boolean;
+    /** Which (chainId, token address) to default-select once the catalog loads. */
+    defaultToken?: DefaultToken;
+    /** Restricts the delivery-token picker to these symbols from `Catalog.targets`. */
+    targetTokens?: string[];
+    /** Which delivery-token symbol to select initially, instead of the catalog's own default. */
+    defaultTarget?: string;
+    /** Whether to render the delivery-token picker at all. Default `true`; the picker only
+     * ever renders when there is more than one target to choose from either way. */
+    showTargetSelector?: boolean;
+    /** Overrides the pinned factory set the one-click deposit verifies the forwarder against. */
+    trustedFactories?: readonly string[];
+    onDepositAddress?: (result: DepositAddressResult) => void;
+    /** Fired once per one-click deposit that CONFIRMED successfully, with the tx
+     * hash. NOT fired on submission, and NOT fired for a tx that reverted --
+     * watch `depositState` (phase/txHash/reverted) for those. Safe to treat as
+     * "the funds moved" (upstream 83845fb). */
+    onDeposited?: (txHash: string) => void;
+    /** Fired once after a recovery action receipt confirms successfully. */
+    onRecoverySuccess?: (result: RecoverySuccessResult) => void;
+    onError?: (error: Error) => void;
+    /** Called by the `Connect Wallet` CTA under the locked card that stands in for the QR
+     * while the required connected wallet (or, in low-level public-address mode,
+     * a usable recipient) is absent. Omitted — the locked card renders as text
+     * only, with no button. */
+    onRequestConnect?: () => void;
+    /** @deprecated The Deposit footer entry was removed. Retained as a no-op
+     * compatibility prop so existing hosts do not need an immediate migration. */
+    onOpenHistory?: () => void;
+    /** Extra class name(s) for the modal/drawer content element. */
+    className?: string;
+    theme?: RelayTheme;
+    mobileBreakpoint?: number;
+    drawerDirection?: RelayDrawerDirection;
+    dialogWidth?: string;
+    drawerMaxWidth?: string;
+    drawerMinWidth?: string;
+    style?: CSSProperties;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children?: ReactNode;
 }
-/** POST /v1/quote response body. */
-interface QuoteResult {
-    /** Smallest-unit (BSC USDT, 18 decimals) base-10 integer string. */
-    expectedBscUsdt: string;
-    belowMin: boolean;
+/**
+ * Props of the `<RelayRecovery>` compound root — the standalone
+ * "Recover stuck funds" modal, i.e. the deposit wizard's gear panel lifted out
+ * into a modal of its own so a host can offer recovery WITHOUT the deposit
+ * flow (the gear inside `<RelayDeposit>` is unaffected and still opt-in via
+ * `showRecovery`).
+ *
+ * Extends `RelayWalletProps` because recovery is signing-first: unlike
+ * `<RelayHistory>` (read-only, no wallet capabilities at all), the whole point
+ * of this modal is that the USER signs the permissionless recovery tx on BSC.
+ * A wallet missing the `writeContract`/`readContract`/`waitForReceipt` trio
+ * gets a short note instead of a dead panel.
+ *
+ * `children` holds `<RelayRecovery.Trigger>` / `<RelayRecovery.Content>`.
+ */
+interface RelayRecoveryProps extends RelayWalletProps {
+    /** Pre-built client. Takes precedence over apiBaseUrl. */
+    client?: RelayClient;
+    /** Used to build a client via createRelayClient when `client` isn't passed. */
+    apiBaseUrl?: string;
     /**
-     * Smallest-unit (crossd, catalog.destination.decimals) base-10 integer
-     * string. Currently assumed at 1:1 parity with BSC USDT -- see
-     * assumesParity.
+     * Selects a built-in default relay API base URL (dev/stage/production) when
+     * `apiBaseUrl` isn't passed. `client`/`apiBaseUrl` still take precedence --
+     * this is only consulted when neither is provided. Omitted falls back to
+     * the same global environment resolution every other dapp-ui feature uses
+     * (see `resolveEnvironment`), defaulting to production.
      */
-    expectedCrossd: string;
-    assumesParity: boolean;
+    environment?: Environment;
     /**
-     * The fee DEDUCTED FROM the bridged amount, in USD, as a decimal string --
-     * Relay's relayer fee plus any app surcharge (upstream af35dd5). It is
-     * exactly what accounts for the gap between what the user sends and
-     * `expectedBscUsdt`.
-     *
-     * It deliberately EXCLUDES the user's own origin-chain gas: that is paid from
-     * their wallet in the origin chain's native token, the wallet already quotes
-     * it at signing time, and none of it comes out of the bridged amount.
-     *
-     * Absent means UNKNOWN, never free -- render absence as absence. "$0.00" for
-     * a fee nobody could compute is the one wrong reading. (A genuine zero, e.g.
-     * the direct BSC-USDT route with no Relay leg, is also absent rather than
-     * "0": no Relay leg means no relayer fee to report.)
+     * Optional assertion of whose forwarder to check/recover. Recovery is always
+     * pinned to the valid connected `walletAddress`; when this value is supplied
+     * it must match that wallet. A missing/invalid wallet or mismatch renders a
+     * short note and makes ZERO requests (no catalog, no recovery lookup).
      */
-    feeUsd?: string;
+    recipient?: string;
     /**
-     * How many seconds this quote stays valid. Drives the refresh cadence in
-     * useDepositAddress -- the widget previously hardcoded 30s with no
-     * relationship to the quote's real lifetime. Absent when the backend has no
-     * TTL configured, in which case the client keeps its own default interval.
-     *
-     * There is deliberately no eta/duration field here. An earlier version of
-     * this type carried `etaSeconds` on the assumption that Relay's quote
-     * reports timing; it does not -- the response has no ETA field of any kind
-     * -- so it was removed rather than left permanently undefined.
+     * Overrides the pinned factory allowlist recovery verifies against before
+     * signing -- only needed by a self-hosted deployment running its own
+     * factories. Same meaning (and the same fail-closed reasoning) as
+     * `RelayDepositProps.trustedFactories`.
      */
-    ttl?: number;
-}
-/** GET /v1/deposit-address request query params -- no amount: a standing
- * address is resolved purely from (user, originChainId, originCurrency),
- * independent of any deposit size. */
-interface DepositAddressRequest {
-    user: string;
-    originChainId: number;
-    originCurrency: string;
+    trustedFactories?: readonly string[];
+    /** Fired once after a recovery action receipt confirms successfully. */
+    onRecoverySuccess?: (result: RecoverySuccessResult) => void;
+    onError?: (e: Error) => void;
+    /** Extra class name(s) for the modal/drawer content element. */
+    className?: string;
+    theme?: RelayTheme;
+    mobileBreakpoint?: number;
+    drawerDirection?: RelayDrawerDirection;
+    dialogWidth?: string;
+    drawerMaxWidth?: string;
+    drawerMinWidth?: string;
+    style?: CSSProperties;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children?: ReactNode;
 }
 /**
- * GET /v1/deposit-address response body -- a stable, reusable deposit
- * address for this (user, origin chain, origin token). The same request
- * always resolves to the same address; no order/deposit is created by
- * fetching it, and it accepts any number of deposits over time (see
- * internal/standing.Service.GetOrCreateDepositAddress).
+ * Props of the `<RelayHistory>` compound root (Task 12) — the standalone
+ * transfer-history modal built on the shared `ResponsiveShell` +
+ * `useRelayOrders`. `RelayDepositProps`'s simpler sibling: no wizard step,
+ * no catalog/target picking, no wallet-injected send/write capabilities —
+ * just an address to look up orders for and a list to render.
+ *
+ * `children` holds `<RelayHistory.Trigger>` / `<RelayHistory.Content>`.
  */
-interface DepositAddressResult {
-    user: string;
-    forwarder: string;
-    version: number;
-    depositAddress: string;
-    originChainId: number;
-    originCurrency: string;
+interface RelayHistoryProps {
+    /** Pre-built client. Takes precedence over apiBaseUrl. */
+    client?: RelayClient;
+    /** Used to build a client via createRelayClient when `client` isn't passed. */
+    apiBaseUrl?: string;
+    /**
+     * Selects a built-in default relay API base URL (dev/stage/production) when
+     * `apiBaseUrl` isn't passed. `client`/`apiBaseUrl` still take precedence --
+     * this is only consulted when neither is provided. Omitted falls back to
+     * the same global environment resolution every other dapp-ui feature uses
+     * (see `resolveEnvironment`), defaulting to production.
+     */
+    environment?: Environment;
+    /** History subject. Falls back to `walletAddress`; empty-state UI when
+     * neither resolves to a valid address. */
+    recipient?: string;
+    walletAddress?: string;
+    onError?: (e: Error) => void;
+    /** Notified with the resolved explorer URL when a history row's tx link is
+     * clicked. Fire-and-forget -- unlike `OnOutlink` elsewhere in dapp-ui, it
+     * does not intercept navigation; the link still opens in a new tab as normal. */
+    onOutlink?: (url: string) => void;
+    /** Extra class name(s) for the modal/drawer content element. */
+    className?: string;
+    theme?: RelayTheme;
+    mobileBreakpoint?: number;
+    drawerDirection?: RelayDrawerDirection;
+    dialogWidth?: string;
+    drawerMaxWidth?: string;
+    drawerMinWidth?: string;
+    style?: CSSProperties;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children?: ReactNode;
+}
+
+interface RelayDepositContentProps {
+    /** Extra class name(s) for the dialog/drawer content element. Falls back to
+     * `<RelayDeposit>`'s own `className`. */
+    className?: string;
 }
 /**
- * One row of GET /v1/orders?user=...'s "orders" array. A single order can
- * aggregate several deposits made to the same reusable forwarder; `deposits[]`
- * is the per-arrival identity. Amount fields are smallest-unit base-10 integer
- * strings, "" when not yet known.
+ * `<RelayDeposit.Content>` — the modal/drawer surface. The deposit body is a
+ * child of `ShellContent`, i.e. of radix's `Dialog.Portal` / vaul's
+ * `Drawer.Portal`, which render nothing while closed. The state it renders is
+ * NOT its own any more: `<RelayDeposit>` mounts the wizard engine above the
+ * shell for exactly as long as the modal is open, so "no request before open"
+ * and "everything resets on close" still hold -- while a breakpoint crossing
+ * mid-flow now only rebuilds this DOM, not the flow.
  */
-interface OrderSummary {
-    orderId: string;
-    status: string;
-    source: string;
-    amountIn: string;
-    expectedOut: string;
-    bscBridgeTx: string;
-    originChainId: number;
-    originCurrency: string;
-    /** CROSS delivery-token symbol this order pays out as (a Catalog.targets
-     * symbol, e.g. "pONEUSD"); "" / omitted means the default target. Used to
-     * label the "out" side with the actual delivered token. */
-    target?: string;
-    forwarderVersion: number;
-    /** RFC3339 timestamp. */
-    createdAt: string;
-    /** What the user ACTUALLY received, observed from the CROSS delivery
-     * transfer. Distinct from expectedOut, which is the pre-delivery projection
-     * after fees -- the two differ by swap slippage and any executor fallback.
-     * "" until delivery, and for orders delivered before the backend recorded it. */
-    amountOut?: string;
-    /** The CROSS-side transaction that delivered the funds. "" until delivery. */
-    deliveryTxHash?: string;
-    /** RFC3339 timestamp of the COMPLETED transition -- when the user received
-     * the funds. Absent for orders that never completed. */
-    completedAt?: string;
-    /** The individual deposits this delivery paid out, oldest first. There can be
-     * SEVERAL: a user may top up a little at a time and the sweeper aggregates
-     * whatever has arrived into one order. Empty when the backend has not
-     * attributed the deposits to this order yet. */
-    deposits?: OrderDeposit[];
+declare function RelayDepositContent({ className }: RelayDepositContentProps): react_jsx_runtime.JSX.Element;
+
+interface RelayDepositTriggerProps {
+    /** Render the child as the trigger instead of wrapping it. Defaults to
+     * `true` whenever a child is supplied, matching
+     * `WalletConnectModalTrigger`'s `asChild ?? children != null`. */
+    asChild?: boolean;
+    children?: ReactNode;
 }
-/** One deposit inside an order, as GET /v1/orders reports it.
+/**
+ * Thin pass-through to `ShellTrigger` (radix `Dialog.Trigger` on desktop /
+ * vaul `Drawer.Trigger` on mobile) so hosts write
+ * `<RelayDeposit.Trigger><button>…</button></RelayDeposit.Trigger>` without
+ * knowing which primitive is active. Falls back to a plain default button when
+ * no child is given, same as `WalletConnectModalTrigger`.
  *
- * originChainId/originCurrency are the chain and token the user ACTUALLY paid,
- * which the order itself cannot report (one reusable deposit address serves
- * every origin route, so the swept balance carries no memory of where it came
- * from). They are absent when the backend has not attributed the deposit --
- * for a DIRECT BSC deposit that is permanent and correct, since it has no
- * cross-chain leg. */
-interface OrderDeposit {
-    /** Amount that arrived at the forwarder, in BSC USDT base units. NOT the
-     * amount sent on the origin chain, which is larger by Relay's fees and
-     * denominated in the origin token's own decimals. */
-    amount: string;
-    blockNumber: number;
-    originChainId?: number;
-    originCurrency?: string;
-    /** The BSC-side arrival (transfer into the forwarder). */
-    txHash: string;
-    /** The user's own send on the ORIGIN chain -- what the "Deposit" step links
-     * to. Absent when unattributed. */
-    originTxHash?: string;
-}
-type StepStatus = 'done' | 'active' | 'pending';
-interface OrderStep {
-    key: string;
-    label: string;
-    status: StepStatus;
+ * Wrapped in `<TrackingBoundary feature="relay">` for the same reason
+ * `WalletConnectModalTrigger` is: the `data-track="open"` attribute below (and
+ * on any host-supplied child that carries one) is only picked up by the
+ * analytics delegate a boundary installs. Without it the open click is silently
+ * untracked, since the trigger lives OUTSIDE the portaled `<Content>` boundary.
+ */
+declare function RelayDepositTrigger({ asChild, children }: RelayDepositTriggerProps): react_jsx_runtime.JSX.Element;
+
+declare function RelayDepositRoot(props: RelayDepositProps): react_jsx_runtime.JSX.Element;
+declare const RelayDeposit: typeof RelayDepositRoot & {
+    Trigger: typeof RelayDepositTrigger;
+    Content: typeof RelayDepositContent;
+};
+
+interface RelayHistoryContentProps {
+    /** Extra class name(s) for the dialog/drawer content element. Falls back to
+     * `<RelayHistory>`'s own `className`. */
+    className?: string;
 }
 /**
- * GET /v1/orders/{orderId} response body. "status" is the raw backend state
- * (e.g. "AWAITING_DEPOSIT", "COMPLETED", "FAILED", ...); "steps" is the
- * friendlier 3-stage deposit -> bridge -> deliver breakdown the UI renders.
+ * `<RelayHistory.Content>` — the modal/drawer surface. Like
+ * `RelayDepositContent`, this is a child of `ShellContent`, i.e. of radix's
+ * `Dialog.Portal` / vaul's `Drawer.Portal`, which render nothing while
+ * closed: no `listOrders` request happens before the modal is opened, and the
+ * subtree unmounts on close -- there is no per-open state here to reset
+ * explicitly (unlike `RelayDepositBody`'s step/panel state), so
+ * unmount-by-portal is the whole story.
  */
-interface Order {
-    orderId: string;
-    status: string;
-    steps: OrderStep[];
-    bridgeIndex: string;
-    txs: {
-        bscBridge: string;
-        crossFinalize: string;
-        crossExecute: string;
-    };
+declare function RelayHistoryContent({ className }: RelayHistoryContentProps): react_jsx_runtime.JSX.Element;
+
+interface RelayHistoryTriggerProps {
+    /** Render the child as the trigger instead of wrapping it. Defaults to
+     * `true` whenever a child is supplied, matching `RelayDepositTrigger`'s
+     * (and `WalletConnectModalTrigger`'s) `asChild ?? children != null` rule. */
+    asChild?: boolean;
+    children?: ReactNode;
 }
 /**
- * GET /v1/recovery?user=... response body -- the permissionless self-recovery
- * status for a user's standing forwarder on BSC. Task 1's endpoint; consumed
- * by useRecovery (Task 2) to drive the settings-menu "Recover stuck funds"
- * panel. Every recovery tx (factory.deploy, forwarder.execute/sweepToUser)
- * takes no destination argument -- funds always route to `forwarder`'s
- * immutable recipient, so this info is advisory/orientation only, never a
- * capability check the UI should use to block the user.
+ * Thin pass-through to `ShellTrigger` (radix `Dialog.Trigger` on desktop /
+ * vaul `Drawer.Trigger` on mobile), mirroring `RelayDepositTrigger` so hosts
+ * write `<RelayHistory.Trigger><button>…</button></RelayHistory.Trigger>`
+ * without knowing which primitive is active. Falls back to a plain default
+ * button when no child is given.
+ *
+ * Wrapped in `<TrackingBoundary feature="relay">` for the same reason
+ * `RelayDepositTrigger`/`WalletConnectModalTrigger` are: `data-track="open"` is
+ * only read by the delegate a boundary installs, and this trigger sits OUTSIDE
+ * the portaled `<Content>`'s own boundary.
  */
-interface RecoveryInfo {
-    user: string;
-    /** The user's forwarder address on BSC for the requested target (CREATE2, deterministic from
-     * user+version+target). */
-    forwarder: string;
-    /** Whether `forwarder` has been deployed on-chain yet. */
-    isDeployed: boolean;
-    /** BSC USDT token contract address -- always BSC USDT regardless of `target` (the forwarder
-     * holds BSC USDT pre-bridge in every case). */
-    token: string;
-    decimals: number;
-    /** Smallest-unit base-10 integer string -- the forwarder's current token balance. */
-    balance: string;
-    /** The factory that deploys/derives `forwarder` for the requested target: the
-     * DepositorForwarderFactory for a depositor-kind target, the StandingForwarderFactory
-     * otherwise (recovery follow-up, multi-target). */
-    factory: string;
-    version: number;
-    /** Smallest-unit base-10 integer string -- the bridge's configured minimum. */
-    bridgeMinWei: string;
-    /** Server's best-effort recommendation: "execute" (balance clears the bridge minimum, so a
-     * normal delivery can complete), "sweep" (below minimum -- recover directly instead), or
-     * "none" (no balance to act on). Advisory only -- never used to disable an action. */
-    suggestedAction: 'execute' | 'sweep' | 'none';
-    /** True when the backend sees this balance as possibly mid-flight (e.g. a sweep/bridge job
-     * already in progress) -- advisory caution only, must NOT disable either recovery action. */
-    inFlight: boolean;
-    inFlightReason?: string;
-    /**
-     * Task 6/7: every known BSC token held at `forwarder` (not just the primary `token`/`balance`
-     * pair above, which only ever reports BSC USDT) -- lets the UI surface a MISDEPOSITED token
-     * (e.g. someone sent BUSD to a USDT-swap forwarder) that the top-level fields alone can't
-     * represent. Optional/omitted for an older backend that predates this field -- back-compat,
-     * byte-identical to pre-Task-6 behavior when absent (the UI falls back to `token`/`balance`).
-     * Each entry's `suggestedAction` mirrors the top-level one's semantics, per-token.
-     */
-    tokens?: {
-        address: string;
-        symbol: string;
-        decimals: number;
-        /** Smallest-unit base-10 integer string -- this token's current balance at `forwarder`. */
-        balance: string;
-        /** Server's advisory recoverable flag for this token -- never used to disable the sweep
-         * action (see `recover`'s doc in useRecovery.ts), only to decide which tokens the UI lists. */
-        recoverable: boolean;
-        suggestedAction: 'execute' | 'sweep' | 'none';
-    }[];
-}
-/** GET /v1/recovery request query params. */
-interface RecoveryRequest {
-    user: string;
-    /** Selected CROSS delivery target symbol (mirrors DepositAddressRequest's `target`) -- omitted
-     * (or empty) selects the configured default, preserving pre-multi-target behavior
-     * byte-for-byte. Passed through verbatim as "?target=" when set. */
-    target?: string;
+declare function RelayHistoryTrigger({ asChild, children }: RelayHistoryTriggerProps): react_jsx_runtime.JSX.Element;
+
+declare function RelayHistoryRoot(props: RelayHistoryProps): react_jsx_runtime.JSX.Element;
+declare const RelayHistory: typeof RelayHistoryRoot & {
+    Trigger: typeof RelayHistoryTrigger;
+    Content: typeof RelayHistoryContent;
+};
+
+interface RelayRecoveryContentProps {
+    /** Extra class name(s) for the dialog/drawer content element. Falls back to
+     * `<RelayRecovery>`'s own `className`. */
+    className?: string;
 }
+/**
+ * `<RelayRecovery.Content>` — the modal/drawer surface. Same portal-scoped
+ * lifecycle as `<RelayHistory.Content>`: nothing is requested before the modal
+ * is opened, and the whole subtree (including `useRecovery`'s state and any
+ * in-flight recovery tracking) unmounts on close, so there is no per-open state
+ * to reset explicitly.
+ */
+declare function RelayRecoveryContent({ className }: RelayRecoveryContentProps): react_jsx_runtime.JSX.Element;
 
-/** Thrown for any non-2xx API response. `status` is the HTTP status code. */
-declare class RelayApiError extends Error {
-    status: number;
-    /** Parsed JSON error body when the response was valid JSON, else undefined. */
-    body?: unknown;
-    constructor(status: number, message: string, body?: unknown);
+interface RelayRecoveryTriggerProps {
+    /** Render the child as the trigger instead of wrapping it. Defaults to
+     * `true` whenever a child is supplied, matching `RelayHistoryTrigger`'s
+     * (and `RelayDepositTrigger`'s) `asChild ?? children != null` rule. */
+    asChild?: boolean;
+    children?: ReactNode;
 }
-interface RelayClientOptions {
-    /** API origin, e.g. "https://orchestrator.example.com". Trailing slashes are stripped. */
-    baseUrl: string;
+/**
+ * Thin pass-through to `ShellTrigger` (radix `Dialog.Trigger` on desktop /
+ * vaul `Drawer.Trigger` on mobile), mirroring `RelayHistoryTrigger` so hosts
+ * write `<RelayRecovery.Trigger><button>…</button></RelayRecovery.Trigger>`
+ * without knowing which primitive is active. Falls back to a plain-text
+ * "Recover" button when no child is given -- unstyled like the sibling
+ * `RelayDepositTrigger`/`RelayHistoryTrigger` defaults, so it inherits the
+ * host's own button chrome instead of shipping a look of its own.
+ *
+ * The default button renders NO count badge (2026-07-30: removed on request --
+ * the number read as an unread-notification alarm). The root's cross-target
+ * recoverable count still reaches the trigger element as
+ * `data-rd-recovery-count` (radix/vaul merge Trigger props onto the `asChild`
+ * child too), so a host that WANTS a badge can opt in with its own CSS -- e.g.
+ * `button[data-rd-recovery-count]:not([data-rd-recovery-count="0"])::after` --
+ * without refetching anything.
+ *
+ * Wrapped in `<TrackingBoundary feature="relay">` for the same reason
+ * `RelayHistoryTrigger` is: `data-track="open"` is only read by the delegate a
+ * boundary installs, and this trigger sits OUTSIDE the portaled `<Content>`'s
+ * own boundary.
+ */
+declare function RelayRecoveryTrigger({ asChild, children }: RelayRecoveryTriggerProps): react_jsx_runtime.JSX.Element;
+
+declare function RelayRecoveryRoot(props: RelayRecoveryProps): react_jsx_runtime.JSX.Element;
+declare const RelayRecovery: typeof RelayRecoveryRoot & {
+    Trigger: typeof RelayRecoveryTrigger;
+    Content: typeof RelayRecoveryContent;
+};
+
+interface UseRelayOrdersOptions {
+    client: RelayClient;
+    /** Valid EVM address, or undefined -- undefined clears the list and stops polling. */
+    recipient?: string;
+    /** Gate: wait for truthy before the first fetch (RelayDeposit passes rawCatalog). Default true. */
+    enabled?: boolean;
+    /** Keep the snapshot live with SSE + fallback polling. Default true. */
+    live?: boolean;
+    /** REST safety-net cadence in milliseconds. Defaults to 30s; the open Deposit popup uses 1s
+     * so completion still appears promptly when the SSE event is absent. */
+    refetchInterval?: number;
+    /** @deprecated Use `refetchInterval`. Retained for compatibility. */
+    fallbackPollMs?: number;
+    onError?: (e: Error) => void;
 }
-interface RelayClient {
-    /** GET /v1/config -- the curated origin catalog + fixed crossd destination. */
-    getConfig(): Promise<Catalog>;
-    /** POST /v1/quote -- a price-only preview, no order/deposit is created. */
-    getQuote(req: QuoteRequest): Promise<QuoteResult>;
-    /**
-     * GET /v1/deposit-address -- resolves the stable, reusable deposit
-     * address for (user, originChainId, originCurrency). No amount is
-     * involved and no order is created; the same address can receive any
-     * number of deposits of any size. Several deposits can be aggregated into
-     * one order when they jointly fund the same reusable forwarder.
-     *
-     * `target` (Task 8) is the delivery asset's symbol from
-     * `Catalog.targets` -- sent as `&target=<symbol>` only when it's a
-     * non-empty string; omitted otherwise, in which case the backend
-     * resolves the default target (byte-identical to pre-Task-6 behavior).
-     */
-    getDepositAddress(req: DepositAddressRequest, target?: string): Promise<DepositAddressResult>;
-    /**
-     * GET /v1/orders/{orderId} -- current status + stepper progress for one
-     * order. Reads are public (unauthenticated).
-     */
-    getOrder(orderId: string): Promise<Order>;
-    /**
-     * GET /v1/orders?user=... -- every order swept from deposits to that
-     * user's standing address(es) (newest-first, capped server-side).
-     */
-    listOrders(user: string): Promise<OrderSummary[]>;
-    /** Absolute URL of the SSE order-change stream for `user`
-     * (GET /v1/orders/stream?user=...). Emits `event: connected` on open,
-     * `event: orders-changed` when that user's orders change, and `:
-     * heartbeat` comments -- it carries no order data itself, so consumers
-     * always follow up with `listOrders`. */
-    ordersStreamUrl(user: string): string;
-    /**
-     * GET /v1/recovery?user=... -- permissionless self-recovery status for a
-     * user's forwarder on BSC (Task 1). `req.target` (optional) selects which
-     * per-target forwarder/factory to report -- omitted selects the
-     * configured default, byte-identical to pre-multi-target behavior.
-     * Purely informational -- fetching it never triggers or blocks any
-     * on-chain action. The response's `tokens[]` (Task 6/7 -- every known BSC
-     * token held at the forwarder) flows through as-is: it's plain JSON, so no
-     * extra parsing/mapping is needed beyond RecoveryInfo's own typing, and
-     * it's simply absent/undefined for an older backend that predates it.
-     */
-    getRecovery(req: RecoveryRequest): Promise<RecoveryInfo>;
+interface UseRelayOrdersResult {
+    /** Every order swept from deposits to this recipient so far, newest-first
+     * as served by the API. Kept live unless `live: false` requests one snapshot. */
+    orders: OrderSummary[];
+    ordersLoading: boolean;
+    ordersError?: Error;
+    /** Recipient the current snapshot belongs to. Undefined while a new
+     * subscription is waiting for its first accepted fetch, so consumers never
+     * baseline a previous recipient's rows as fresh deposits. */
+    ordersForRecipient?: string;
+    /** Increments after every accepted fetch, even when the client returns the
+     * same array reference or the request fails. Consumers use this as a
+     * low-frequency refresh signal for related read models such as /recovery. */
+    ordersRevision: number;
+    /** True once at least one fetch has COMPLETED (success or failure) for the
+     * current (recipient, enabled) subscription; false again when it resets.
+     * Distinct from `!ordersLoading`, which is also true BEFORE the first fetch
+     * has even started -- consumers that snapshot the list (e.g. the deposit
+     * wizard's new-order watch) must wait for this, or they baseline against
+     * the initial empty state and misread every existing order as new. */
+    ordersInitialized: boolean;
+}
+declare function useRelayOrders(opts: UseRelayOrdersOptions): UseRelayOrdersResult;
+
+interface UseRelayConfigOptions {
+    /** Pre-built client. Takes precedence over apiBaseUrl. */
+    client?: RelayClient;
+    /** Used to build a client when `client` is not supplied. */
+    apiBaseUrl?: string;
+    /** Stops the request and clears the current snapshot. Defaults to true. */
+    enabled?: boolean;
+    /** Optional automatic REST refresh cadence in milliseconds. Disabled when omitted or <= 0. */
+    refetchInterval?: number;
+    onError?: (error: Error) => void;
+}
+interface UseRelayConfigResult {
+    /** Latest GET /v1/config response. */
+    config?: Catalog;
+    loading: boolean;
+    error?: Error;
+    /** Re-fetches GET /v1/config using the current client. */
+    refresh: () => void;
 }
 /**
- * Builds a framework-agnostic Relay API client. Uses plain `fetch` only --
- * no react-query, no RainbowKit/wagmi. `baseUrl` is passed in explicitly (no
- * `import.meta.env` coupling) so the widget can be embedded in any host app's
- * own config/env story.
+ * Public read-only hook for Relay's origin/destination/target catalog.
  *
- * No API key: the backend has no inbound key gate (upstream 83845fb removed
- * the dead `apiKey`/X-API-Key plumbing -- a security control that does not
- * exist must not appear in a public type).
+ * The response is a normal REST snapshot, not an SSE stream. Use
+ * `refetchInterval` for periodic refreshes or call `refresh` for an immediate
+ * read without replacing the client or remounting the component.
  */
-declare function createRelayClient(options: RelayClientOptions): RelayClient;
-
-interface DefaultToken {
-    chainId: number;
-    /** Token contract address, or the zero address for the chain's native asset. */
-    address: string;
-}
+declare function useRelayConfig(opts?: UseRelayConfigOptions): UseRelayConfigResult;
 
-type Hex = `0x${string}`;
-interface RelayTxRequest {
-    chainId: number;
-    to: Hex;
-    value?: bigint;
-    data?: Hex;
-}
-interface RelayContractCall {
-    chainId: number;
-    address: Hex;
-    abi: readonly unknown[];
-    functionName: string;
-    args: readonly unknown[];
-}
-interface RelayBalance {
-    value: bigint;
-    decimals: number;
-    symbol: string;
-}
-type SendTransactionFn = (req: RelayTxRequest) => Promise<Hex>;
-type WriteContractFn = (call: RelayContractCall) => Promise<Hex>;
-type ReadContractFn = (call: RelayContractCall) => Promise<unknown>;
-type SwitchChainFn = (chainId: number) => Promise<void>;
-type WaitForReceiptFn = (p: {
-    chainId: number;
-    hash: Hex;
-}) => Promise<{
-    status: "success" | "reverted";
-}>;
-type GetBalanceFn = (p: {
-    chainId: number;
-    address: Hex;
-    token?: Hex;
-}) => Promise<RelayBalance>;
-/** 지갑 주입 props — 전부 optional, 미주입 시 graceful degradation. */
-interface RelayWalletProps {
-    walletAddress?: string;
-    walletChainId?: number;
-    sendTransaction?: SendTransactionFn;
-    writeContract?: WriteContractFn;
-    readContract?: ReadContractFn;
-    switchChain?: SwitchChainFn;
-    waitForReceipt?: WaitForReceiptFn;
-    getBalance?: GetBalanceFn;
-}
-/** A recovery transaction confirmed successfully on BNB Smart Chain. */
-interface RecoverySuccessResult {
-    action: "execute" | "sweep";
-    forwarder: string;
-    actionTxHash: string;
-    /** Present only when this attempt first had to deploy the forwarder. */
+type RecoveryAction = "execute" | "sweep";
+/** Per-attempt progress for `recover()`. "switching" = prompting a chain switch to BSC;
+ * "deploying" = the factory.deploy() write is in flight/confirming (only needed when the
+ * forwarder wasn't deployed yet); "recovering" = the execute()/sweepToUser() write is in
+ * flight/confirming; "done"/"error" are terminal for this attempt. */
+type RecoveryStep = "idle" | "switching" | "deploying" | "recovering" | "done" | "error";
+interface RecoveryState {
+    step: RecoveryStep;
+    /** Tx hash of the factory.deploy() write -- only set when this attempt needed one. */
     deployTxHash?: string;
+    /** Tx hash of the execute()/sweepToUser() write. */
+    actionTxHash?: string;
+    error?: string;
 }
-type RelayTheme = "dark" | "light";
-type RelayDrawerDirection = "bottom" | "left" | "right" | "top";
+
+type RelayRecoveryQueryKey = readonly [
+    "relay",
+    "recovery",
+    number,
+    string | null,
+    string | null
+];
 /**
- * Props of the `<RelayDeposit>` compound root (Task 11) — the union of
- *
- *   * `RelayWalletProps` (injected wallet capabilities, all optional),
- *   * the source widget's own configuration props (relay-protocol
- *     `packages/relay-widget/src/components/RelayDeposit.tsx`), minus its
- *     `theme: 'auto'` option, which the shared modal shell doesn't have, and
- *   * `ResponsiveShellProps`' modal/drawer knobs (theme/breakpoint/size/open),
- *     re-declared here rather than extended so the public surface reads as one
- *     flat prop list.
- *
- * `children` holds `<RelayDeposit.Trigger>` / `<RelayDeposit.Content>`.
+ * React Query policies accepted by useRelayRecovery. The SDK owns the request
+ * identity and response shape, so callers cannot replace queryKey/queryFn or
+ * inject/select recovery balances.
  */
-interface RelayDepositProps extends RelayWalletProps {
+type RelayRecoveryQueryOptions = Omit<UseQueryOptions<RecoveryInfo, Error, RecoveryInfo, RelayRecoveryQueryKey>, "queryKey" | "queryFn" | "select" | "initialData" | "initialDataUpdatedAt" | "placeholderData">;
+interface UseRelayRecoveryOptions {
     /** Pre-built client. Takes precedence over apiBaseUrl. */
     client?: RelayClient;
-    /** Used to build a client via createRelayClient when `client` isn't passed. */
+    /** Used to build a client via createRelayClient when client isn't passed. */
     apiBaseUrl?: string;
-    /**
-     * Selects a built-in default relay API base URL (dev/stage/production) when
-     * `apiBaseUrl` isn't passed. `client`/`apiBaseUrl` still take precedence --
-     * this is only consulted when neither is provided. Omitted falls back to
-     * the same global environment resolution every other dapp-ui feature uses
-     * (see `resolveEnvironment`), defaulting to production.
-     */
-    environment?: Environment;
-    /** Restrict the catalog's origins to these chain ids. */
-    chains?: number[];
-    /** Controlled recipient; when provided the recipient input is hidden and no wallet
-     * connection is required to fetch a deposit address. Defaults to `walletAddress`. */
+    /** Connected EVM wallet whose recoverable forwarder balances are queried. */
     recipient?: string;
-    /** Require a valid connected wallet before the deposit flow can issue an
-     * address, quote an amount, or start live order/recovery reads. When enabled,
-     * the recipient is pinned to `walletAddress`; a controlled `recipient` cannot
-     * redirect the connected user's deposit. Defaults to `true` when
-     * `showRecipientInput` is explicitly `false`, otherwise `false` for the
-     * low-level public-address integration. `CrossRelayDeposit` always enables
-     * this guard. */
-    requireWalletConnection?: boolean;
-    /** Hide the editable recipient input even when `recipient` is NOT controlled
-     * (default `true` = original behavior). Hosts that lock the recipient to the
-     * connected wallet set this `false` so a disconnected user sees a connect
-     * prompt instead of a free-form address field — the deposit address can then
-     * only ever resolve to the logged-in wallet. */
-    showRecipientInput?: boolean;
-    /** Controlled human-decimal amount; when provided the amount input is hidden. Optional —
-     * it only drives the quote preview, and never blocks the deposit address. */
-    amount?: string;
-    /** Hide the amount input entirely (address-only, send-any-amount). Independent of `amount`. */
-    hideAmount?: boolean;
-    /** Render the EVM one-click deposit button (default `false`: the modal only
-     * offers the QR / copy-address manual deposit path). Opt in with `true` for
-     * hosts whose users connect external wallets that can sign on the origin
-     * chains — CROSS embedded-wallet users never can, hence the off default. */
-    showOneClickDeposit?: boolean;
-    /** Render the recovery gear menu ("Recover stuck funds", default `false`).
-     * Recovery signs on BSC with the connected wallet, which CROSS embedded-wallet
-     * users can never do — so the gear is hidden unless a host serving external
-     * wallets opts in. Even opted in, it still requires the injected
-     * `writeContract`/`readContract`/`waitForReceipt` capability trio. */
-    showRecovery?: boolean;
-    /** Which (chainId, token address) to default-select once the catalog loads. */
-    defaultToken?: DefaultToken;
-    /** Restricts the delivery-token picker to these symbols from `Catalog.targets`. */
-    targetTokens?: string[];
-    /** Which delivery-token symbol to select initially, instead of the catalog's own default. */
-    defaultTarget?: string;
-    /** Whether to render the delivery-token picker at all. Default `true`; the picker only
-     * ever renders when there is more than one target to choose from either way. */
-    showTargetSelector?: boolean;
-    /** Overrides the pinned factory set the one-click deposit verifies the forwarder against. */
-    trustedFactories?: readonly string[];
-    onDepositAddress?: (result: DepositAddressResult) => void;
-    /** Fired once per one-click deposit that CONFIRMED successfully, with the tx
-     * hash. NOT fired on submission, and NOT fired for a tx that reverted --
-     * watch `depositState` (phase/txHash/reverted) for those. Safe to treat as
-     * "the funds moved" (upstream 83845fb). */
-    onDeposited?: (txHash: string) => void;
-    /** Fired once after a recovery action receipt confirms successfully. */
-    onRecoverySuccess?: (result: RecoverySuccessResult) => void;
+    /** Optional CROSS delivery target passed to GET /v1/recovery. */
+    target?: string;
+    /** React Query lifecycle, cache, retry, and refetch policies. */
+    query?: RelayRecoveryQueryOptions;
+    /** Optional wallet capabilities. Read-only consumers may omit this. */
+    wallet?: RelayWalletProps;
+    /** Called when GET /v1/recovery returns 401. */
+    onUnauthorized?: () => void;
+    /** Called after a terminal query or recovery-action error. */
     onError?: (error: Error) => void;
-    /** Called by the `Connect Wallet` CTA under the locked card that stands in for the QR
-     * while the required connected wallet (or, in low-level public-address mode,
-     * a usable recipient) is absent. Omitted — the locked card renders as text
-     * only, with no button. */
-    onRequestConnect?: () => void;
-    /** @deprecated The Deposit footer entry was removed. Retained as a no-op
-     * compatibility prop so existing hosts do not need an immediate migration. */
-    onOpenHistory?: () => void;
-    /** Extra class name(s) for the modal/drawer content element. */
-    className?: string;
-    theme?: RelayTheme;
-    mobileBreakpoint?: number;
-    drawerDirection?: RelayDrawerDirection;
-    dialogWidth?: string;
-    drawerMaxWidth?: string;
-    drawerMinWidth?: string;
-    style?: CSSProperties;
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    children?: ReactNode;
+    /** Called once after a recovery transaction confirms successfully. */
+    onRecoverySuccess?: (result: RecoverySuccessResult) => void;
+    /** Trusted factory override for a self-hosted deployment. */
+    trustedFactories?: readonly string[];
+}
+interface UseRelayRecoveryResult {
+    info?: RecoveryInfo;
+    loading: boolean;
+    error?: Error;
+    /** True for background refetches as well as the first request. */
+    isFetching: boolean;
+    /** Invalidates no identities; immediately refetches this hook's fixed query. */
+    refresh: () => void;
+    /** Signs a recovery transaction for the currently fetched info. */
+    recover: (action: RecoveryAction, tokenAddress?: string) => Promise<void>;
+    recoveryState: RecoveryState;
 }
 /**
- * Props of the `<RelayRecovery>` compound root — the standalone
- * "Recover stuck funds" modal, i.e. the deposit wizard's gear panel lifted out
- * into a modal of its own so a host can offer recovery WITHOUT the deposit
- * flow (the gear inside `<RelayDeposit>` is unaffected and still opt-in via
- * `showRecovery`).
+ * Public Recovery API hook. Unlike the widget-internal useRecovery fetch, this
+ * hook uses the host QueryClient and accepts React Query policies through
+ * `query`. queryKey/queryFn and balance-shaping options remain SDK-owned.
+ */
+declare function useRelayRecovery(opts?: UseRelayRecoveryOptions): UseRelayRecoveryResult;
+
+interface StatusTrackerProps {
+    orderId: string;
+    /** Latest polled order (steps/txs) from GET /v1/orders/{orderId}, owned by the caller. */
+    order?: Order;
+    /** Latest poll error, owned by the caller. */
+    error?: Error;
+}
+declare function StatusTracker({ orderId, order, error }: StatusTrackerProps): react_jsx_runtime.JSX.Element;
+
+/** Every StandingForwarderFactory / DepositorForwarderFactory this deployment
+ * has issued deposit addresses from, on BSC.
  *
- * Extends `RelayWalletProps` because recovery is signing-first: unlike
- * `<RelayHistory>` (read-only, no wallet capabilities at all), the whole point
- * of this modal is that the USER signs the permissionless recovery tx on BSC.
- * A wallet missing the `writeContract`/`readContract`/`waitForReceipt` trio
- * gets a short note instead of a dead panel.
+ * Superseded factories stay listed on purpose. A forwarder's factory is pinned
+ * per address at issuance time (`standing_addresses.factory`, copied onto each
+ * order), so a user recovering an address minted before a rotation legitimately
+ * gets an older factory back from the API -- dropping it here would block that
+ * user from recovering their own funds, which is a worse outcome than the
+ * narrow trust gain. Every entry is one of ours either way.
  *
- * `children` holds `<RelayRecovery.Trigger>` / `<RelayRecovery.Content>`.
- */
-interface RelayRecoveryProps extends RelayWalletProps {
-    /** Pre-built client. Takes precedence over apiBaseUrl. */
-    client?: RelayClient;
-    /** Used to build a client via createRelayClient when `client` isn't passed. */
-    apiBaseUrl?: string;
-    /**
-     * Selects a built-in default relay API base URL (dev/stage/production) when
-     * `apiBaseUrl` isn't passed. `client`/`apiBaseUrl` still take precedence --
-     * this is only consulted when neither is provided. Omitted falls back to
-     * the same global environment resolution every other dapp-ui feature uses
-     * (see `resolveEnvironment`), defaulting to production.
-     */
-    environment?: Environment;
-    /**
-     * Optional assertion of whose forwarder to check/recover. Recovery is always
-     * pinned to the valid connected `walletAddress`; when this value is supplied
-     * it must match that wallet. A missing/invalid wallet or mismatch renders a
-     * short note and makes ZERO requests (no catalog, no recovery lookup).
-     */
-    recipient?: string;
-    /**
-     * Overrides the pinned factory allowlist recovery verifies against before
-     * signing -- only needed by a self-hosted deployment running its own
-     * factories. Same meaning (and the same fail-closed reasoning) as
-     * `RelayDepositProps.trustedFactories`.
-     */
-    trustedFactories?: readonly string[];
-    /** Fired once after a recovery action receipt confirms successfully. */
-    onRecoverySuccess?: (result: RecoverySuccessResult) => void;
-    onError?: (e: Error) => void;
-    /** Extra class name(s) for the modal/drawer content element. */
-    className?: string;
+ * Rotation (see backends/deploy/RUNBOOK-canary.md): ADD the new factory, keep
+ * the old ones. */
+declare const DEFAULT_TRUSTED_FACTORIES: readonly string[];
+
+type GetOneUsdActionId = "swap" | "bridge" | "transfer";
+type GetOneUsdMode = "floating" | "button";
+type GetOneUsdButtonComponent = ElementType<ButtonHTMLAttributes<HTMLButtonElement>>;
+type GetOneUsdWaitForTransaction = (info: BridgeSubmittedInfo) => Promise<void>;
+interface GetOneUsdTokenRef {
+    chainId: number;
+    address: string;
+}
+interface GetOneUsdPairs {
+    target: GetOneUsdTokenRef;
+    swap: {
+        from: GetOneUsdTokenRef;
+        feeDelegated?: boolean;
+    };
+    bridge: {
+        from: GetOneUsdTokenRef[];
+        feeDelegated?: boolean;
+    };
+}
+type GetOneUsdBridgeProps = Omit<BridgeFlowProps, "walletAddress" | "tokens" | "initialFromToken" | "initialToToken" | "env" | "onClose" | "onBackToWallet" | "className" | "title" | "variant" | "isConnected" | "onRequestConnect">;
+type GetOneUsdRelayProps = Omit<RelayDepositProps, "walletAddress" | "children" | "open" | "onOpenChange" | "requireWalletConnection" | "showRecipientInput" | "hideAmount" | "targetTokens" | "defaultTarget" | "onRequestConnect">;
+type GetOneUsdEvent = {
+    name: "fab_click";
+    state: "expanded" | "icon_only";
+} | {
+    name: "action_select";
+    action: GetOneUsdActionId;
+} | {
+    name: "connect_click";
+    action: GetOneUsdActionId;
+} | {
+    name: "success";
+    action: GetOneUsdActionId;
+    txHash: string;
+} | {
+    name: "failure";
+    action: GetOneUsdActionId;
+    message: string;
+};
+interface GetOneUsdProps {
+    /** Connected wallet. A missing address renders a connect CTA in execution views. */
+    walletAddress?: string;
+    /** Full token list supplied by a bridge adapter. It is never mutated. */
+    tokens: BridgeToken[];
+    /** Exact source/target token allowlist. May arrive after remote config loads. */
+    pairs?: GetOneUsdPairs;
+    /** True while the bridge adapter is resolving contracts/tokens. */
+    loading?: boolean;
+    /** View-only BridgeFlow transaction ports. */
+    bridge: GetOneUsdBridgeProps;
+    /** Relay configuration and low-level wallet ports. Built-in env URL is used when omitted. */
+    relay?: GetOneUsdRelayProps;
+    env?: Environment;
+    targetSymbol?: string;
+    /** Relay catalog delivery symbol. Defaults to the canonical `ONEUSD`. */
+    relayTargetSymbol?: string;
+    targetIconUrl?: string;
+    /** Trigger layout. Transaction status always renders as a floating pill. */
+    mode?: GetOneUsdMode;
+    /** Custom styled trigger element used only in button mode. Must forward button props. */
+    buttonComponent?: GetOneUsdButtonComponent;
     theme?: RelayTheme;
     mobileBreakpoint?: number;
     drawerDirection?: RelayDrawerDirection;
     dialogWidth?: string;
     drawerMaxWidth?: string;
     drawerMinWidth?: string;
+    /** CSS variables/styles applied to the selected trigger. */
     style?: CSSProperties;
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    children?: ReactNode;
+    className?: string;
+    contentClassName?: string;
+    hidden?: boolean;
+    /** Force the floating trigger to icon-only. Ignored in button mode. */
+    compactTrigger?: boolean;
+    collapseOnScroll?: boolean;
+    scrollThreshold?: number;
+    /**
+     * Waits for an already-submitted Swap/Bridge transaction to confirm.
+     * While pending, a non-interactive floating status pill is shown.
+     * Omit only when submission itself is the final confirmation boundary.
+     */
+    waitForTransaction?: GetOneUsdWaitForTransaction;
+    /** How long a confirmed/failed result stays on the floating button. Default 4000ms. */
+    transactionResultDurationMs?: number;
+    onRequestConnect?: () => void | Promise<void>;
+    onEvent?: (event: GetOneUsdEvent) => void;
 }
+interface ResolvedGetOneUsdRoute {
+    fromTokens: BridgeToken[];
+    targetToken?: BridgeToken;
+}
+
+declare function GetOneUsd({ walletAddress, tokens, pairs, loading, bridge, relay, env, targetSymbol: targetSymbolProp, relayTargetSymbol, targetIconUrl, mode, buttonComponent, theme, mobileBreakpoint, drawerDirection, dialogWidth, drawerMaxWidth, drawerMinWidth, style, className, contentClassName, hidden, compactTrigger, collapseOnScroll, scrollThreshold, waitForTransaction, transactionResultDurationMs, onRequestConnect, onEvent, }: GetOneUsdProps): react_jsx_runtime.JSX.Element;
+
+type GetOneUsdRemoteModes = NonNullable<NonNullable<AppsConfig["getOneUsd"]>["modes"]>;
+type GetOneUsdRemoteMinVersions = NonNullable<NonNullable<AppsConfig["getOneUsd"]>["minVersions"]>;
 /**
- * Props of the `<RelayHistory>` compound root (Task 12) — the standalone
- * transfer-history modal built on the shared `ResponsiveShell` +
- * `useRelayOrders`. `RelayDepositProps`'s simpler sibling: no wizard step,
- * no catalog/target picking, no wallet-injected send/write capabilities —
- * just an address to look up orders for and a list to render.
+ * 목록에 보일지 여부. Swap/Bridge stay enabled when config is unavailable.
+ * Transfer Crypto is opt-in and stays hidden until S3 explicitly enables it.
+ */
+declare function isGetOneUsdActionVisible(action: GetOneUsdActionId, modes?: GetOneUsdRemoteModes): boolean;
+/**
+ * 이 dapp-ui 버전에서 실행 가능한지. 미달이면 **숨기지 않고 비활성**으로 둔다 —
+ * 항목이 조용히 사라지면 사용자는 기능이 없어진 줄 알지만, 비활성 + 안내면
+ * "업데이트하면 쓸 수 있다"가 전달된다.
+ */
+declare function isGetOneUsdActionSupported(action: GetOneUsdActionId, minVersions?: GetOneUsdRemoteMinVersions): boolean;
+/** 노출 + 실행 가능(= 실제로 선택할 수 있는지). */
+declare function isGetOneUsdActionEnabled(action: GetOneUsdActionId, modes?: GetOneUsdRemoteModes, minVersions?: GetOneUsdRemoteMinVersions): boolean;
+
+declare function getOneUsdTokenKey(token: GetOneUsdTokenRef): string;
+declare function matchesGetOneUsdToken(token: BridgeToken, ref: GetOneUsdTokenRef): boolean;
+declare function findGetOneUsdToken(tokens: BridgeToken[], ref?: GetOneUsdTokenRef): BridgeToken | undefined;
+/** Resolve an action's exact token allowlist without mutating adapter data. */
+declare function resolveGetOneUsdRoute(tokens: BridgeToken[], pairs: GetOneUsdPairs | undefined, action: Exclude<GetOneUsdActionId, "transfer">): ResolvedGetOneUsdRoute;
+declare function isGetOneUsdTargetAvailable(available: BridgeToken[], target: BridgeToken): boolean;
+
+declare function CROSSxIcon(): react_jsx_runtime.JSX.Element;
+declare function MetaMaskIcon(): react_jsx_runtime.JSX.Element;
+declare function BinanceIcon(): react_jsx_runtime.JSX.Element;
+declare function Verse8Icon(): react_jsx_runtime.JSX.Element;
+declare function TronIcon(): react_jsx_runtime.JSX.Element;
+declare function GoogleIcon(): react_jsx_runtime.JSX.Element;
+declare function AppleIcon(): react_jsx_runtime.JSX.Element;
+
+declare const WALLET_REGISTRY: {
+    cross_embedded: {
+        id: string;
+        name: "ONEpocket with Social";
+        description: string;
+        icon: typeof CROSSxIcon;
+    };
+    cross_wallet: {
+        id: string;
+        name: "ONEpocket";
+        description: string;
+        icon: typeof CROSSxIcon;
+        featured: true;
+    };
+    cross_extension: {
+        id: string;
+        name: "ONEpocket Extension";
+        description: string;
+        icon: typeof CROSSxIcon;
+        rdns: string;
+        installUrl: string;
+        visibility: "desktop-only";
+    };
+    metamask: {
+        id: string;
+        name: string;
+        description: string;
+        icon: typeof MetaMaskIcon;
+        rdns: string;
+    };
+    binance: {
+        id: string;
+        name: string;
+        description: string;
+        icon: typeof BinanceIcon;
+    };
+    verse8: {
+        id: string;
+        name: string;
+        description: string;
+        icon: typeof Verse8Icon;
+        badge: string;
+    };
+    tron: {
+        id: string;
+        name: string;
+        description: string;
+        icon: typeof TronIcon;
+        badge: string;
+    };
+};
+type WalletId = keyof typeof WALLET_REGISTRY;
+declare const SOCIAL_REGISTRY: {
+    google: {
+        id: string;
+        name: string;
+        icon: typeof GoogleIcon;
+    };
+    apple: {
+        id: string;
+        name: string;
+        icon: typeof AppleIcon;
+    };
+};
+type SocialId = keyof typeof SOCIAL_REGISTRY;
+
+/**
+ * Per-instance layout overrides applied as inline CSS variables.
  *
- * `children` holds `<RelayHistory.Trigger>` / `<RelayHistory.Content>`.
+ * Colors / typography are driven by the design system (`--ds-*`, published
+ * by `CrossConnectKitProvider` from `@nexus-cross/crossx-design-system`) —
+ * retheme there, not per modal. Only layout knobs remain here.
  */
-interface RelayHistoryProps {
-    /** Pre-built client. Takes precedence over apiBaseUrl. */
-    client?: RelayClient;
-    /** Used to build a client via createRelayClient when `client` isn't passed. */
-    apiBaseUrl?: string;
+interface WalletConnectModalStyle extends CSSProperties {
+    "--wcm-dialog-width"?: string;
+    "--wcm-drawer-max-width"?: string;
+    "--wcm-drawer-min-width"?: string;
+}
+type WalletVisibility = "always" | "mobile-only" | "desktop-only";
+interface WalletConfig {
+    id: string;
+    name: string;
+    description: string;
+    icon: () => ReactNode;
+    rdns?: string;
+    featured?: boolean;
+    badge?: string;
+    installUrl?: string;
+    visibility?: WalletVisibility;
+}
+type WalletHandlers = Partial<Record<WalletId, () => void | Promise<void>>>;
+interface SocialConfig {
+    id: string;
+    name: string;
+    icon: () => ReactNode;
+}
+type SocialHandlers = Partial<Record<SocialId, () => void | Promise<void>>>;
+type DrawerDirection = "bottom" | "left" | "right" | "top";
+interface WalletConnectModalProps {
+    wallets: WalletHandlers;
+    socialProviders?: SocialHandlers;
     /**
-     * Selects a built-in default relay API base URL (dev/stage/production) when
-     * `apiBaseUrl` isn't passed. `client`/`apiBaseUrl` still take precedence --
-     * this is only consulted when neither is provided. Omitted falls back to
-     * the same global environment resolution every other dapp-ui feature uses
-     * (see `resolveEnvironment`), defaulting to production.
+     * URL the "Terms of Service" link in the footer points to. When
+     * omitted the text is rendered without an anchor (still styled in the
+     * primary color to match the design).
      */
-    environment?: Environment;
-    /** History subject. Falls back to `walletAddress`; empty-state UI when
-     * neither resolves to a valid address. */
-    recipient?: string;
-    walletAddress?: string;
-    onError?: (e: Error) => void;
-    /** Notified with the resolved explorer URL when a history row's tx link is
-     * clicked. Fire-and-forget -- unlike `OnOutlink` elsewhere in dapp-ui, it
-     * does not intercept navigation; the link still opens in a new tab as normal. */
-    onOutlink?: (url: string) => void;
-    /** Extra class name(s) for the modal/drawer content element. */
-    className?: string;
-    theme?: RelayTheme;
+    termsUrl?: string;
+    /** URL the "Privacy Policy" link in the footer points to. */
+    privacyUrl?: string;
+    theme?: "dark" | "light";
     mobileBreakpoint?: number;
-    drawerDirection?: RelayDrawerDirection;
+    drawerDirection?: DrawerDirection;
     dialogWidth?: string;
     drawerMaxWidth?: string;
     drawerMinWidth?: string;
-    style?: CSSProperties;
+    style?: WalletConnectModalStyle;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
-    children?: ReactNode;
-}
-
-interface RelayDepositContentProps {
-    /** Extra class name(s) for the dialog/drawer content element. Falls back to
-     * `<RelayDeposit>`'s own `className`. */
-    className?: string;
-}
-/**
- * `<RelayDeposit.Content>` — the modal/drawer surface. The deposit body is a
- * child of `ShellContent`, i.e. of radix's `Dialog.Portal` / vaul's
- * `Drawer.Portal`, which render nothing while closed. The state it renders is
- * NOT its own any more: `<RelayDeposit>` mounts the wizard engine above the
- * shell for exactly as long as the modal is open, so "no request before open"
- * and "everything resets on close" still hold -- while a breakpoint crossing
- * mid-flow now only rebuilds this DOM, not the flow.
- */
-declare function RelayDepositContent({ className }: RelayDepositContentProps): react_jsx_runtime.JSX.Element;
-
-interface RelayDepositTriggerProps {
-    /** Render the child as the trigger instead of wrapping it. Defaults to
-     * `true` whenever a child is supplied, matching
-     * `WalletConnectModalTrigger`'s `asChild ?? children != null`. */
+    children: ReactNode;
+}
+interface WalletConnectModalTriggerProps {
     asChild?: boolean;
     children?: ReactNode;
 }
-/**
- * Thin pass-through to `ShellTrigger` (radix `Dialog.Trigger` on desktop /
- * vaul `Drawer.Trigger` on mobile) so hosts write
- * `<RelayDeposit.Trigger><button>…</button></RelayDeposit.Trigger>` without
- * knowing which primitive is active. Falls back to a plain default button when
- * no child is given, same as `WalletConnectModalTrigger`.
- *
- * Wrapped in `<TrackingBoundary feature="relay">` for the same reason
- * `WalletConnectModalTrigger` is: the `data-track="open"` attribute below (and
- * on any host-supplied child that carries one) is only picked up by the
- * analytics delegate a boundary installs. Without it the open click is silently
- * untracked, since the trigger lives OUTSIDE the portaled `<Content>` boundary.
- */
-declare function RelayDepositTrigger({ asChild, children }: RelayDepositTriggerProps): react_jsx_runtime.JSX.Element;
+interface WalletConnectModalContentProps {
+    className?: string;
+}
 
-declare function RelayDepositRoot(props: RelayDepositProps): react_jsx_runtime.JSX.Element;
-declare const RelayDeposit: typeof RelayDepositRoot & {
-    Trigger: typeof RelayDepositTrigger;
-    Content: typeof RelayDepositContent;
+declare function WalletConnectModalTrigger({ asChild, children, }: WalletConnectModalTriggerProps): react_jsx_runtime.JSX.Element;
+
+declare function WalletConnectModalContent({ className, }: WalletConnectModalContentProps): react_jsx_runtime.JSX.Element;
+
+declare function WalletConnectModalRoot({ wallets, socialProviders, termsUrl, privacyUrl, theme, mobileBreakpoint, drawerDirection, dialogWidth, drawerMaxWidth, drawerMinWidth, style, open: openProp, onOpenChange, children, }: WalletConnectModalProps): react_jsx_runtime.JSX.Element;
+declare const WalletConnectModal: typeof WalletConnectModalRoot & {
+    Trigger: typeof WalletConnectModalTrigger;
+    Content: typeof WalletConnectModalContent;
 };
 
-interface RelayHistoryContentProps {
-    /** Extra class name(s) for the dialog/drawer content element. Falls back to
-     * `<RelayHistory>`'s own `className`. */
-    className?: string;
+interface DetectedWallet {
+    rdns: string;
+    name: string;
+    icon?: string;
 }
+interface WalletDetectResult {
+    wallets: DetectedWallet[];
+    isDetected: (rdns: string) => boolean;
+    isLoading: boolean;
+}
+declare function useWalletDetect(): WalletDetectResult;
+
 /**
- * `<RelayHistory.Content>` — the modal/drawer surface. Like
- * `RelayDepositContent`, this is a child of `ShellContent`, i.e. of radix's
- * `Dialog.Portal` / vaul's `Drawer.Portal`, which render nothing while
- * closed: no `listOrders` request happens before the modal is opened, and the
- * subtree unmounts on close -- there is no per-open state here to reset
- * explicitly (unlike `RelayDepositBody`'s step/panel state), so
- * unmount-by-portal is the whole story.
+ * `ConnectButton`의 `style` prop 타입. 표준 `CSSProperties` 위에
+ * `--cb-*` CSS 커스텀 변수 키를 추가해 자동완성을 지원한다.
+ *
+ * 사용 예: `style={{ "--cb-bg": "#7346f3", "--cb-pill-bg": "#1a1a2e" }}`
+ *
+ * 변수는 ConnectButton 의 모든 상태(disconnected / connecting / connected
+ * pill)에 cascading 된다. WalletInfo popover 의 스타일은 별도
+ * `walletInfoStyle` prop 으로 분리되어 있다.
  */
-declare function RelayHistoryContent({ className }: RelayHistoryContentProps): react_jsx_runtime.JSX.Element;
-
-interface RelayHistoryTriggerProps {
-    /** Render the child as the trigger instead of wrapping it. Defaults to
-     * `true` whenever a child is supplied, matching `RelayDepositTrigger`'s
-     * (and `WalletConnectModalTrigger`'s) `asChild ?? children != null` rule. */
-    asChild?: boolean;
-    children?: ReactNode;
+interface ConnectButtonStyle extends CSSProperties {
+    "--cb-bg"?: string;
+    "--cb-bg-hover"?: string;
+    "--cb-color"?: string;
+    "--cb-border"?: string;
+    "--cb-radius"?: string;
+    "--cb-height"?: string;
+    "--cb-padding"?: string;
+    "--cb-font-family"?: string;
+    "--cb-font-size"?: string;
+    "--cb-font-weight"?: string | number;
+    "--cb-line-height"?: string | number;
+    "--cb-letter-spacing"?: string;
+    "--cb-gap"?: string;
+    "--cb-transition"?: string;
+    "--cb-loading-opacity"?: string | number;
+    "--cb-press-scale"?: string | number;
+    "--cb-icon-size"?: string;
+    "--cb-spinner-size"?: string;
+    "--cb-spinner-thumb"?: string;
+    "--cb-spinner-track"?: string;
+    "--cb-pill-bg"?: string;
+    "--cb-pill-bg-hover"?: string;
+    "--cb-pill-color"?: string;
+    "--cb-pill-border"?: string;
+    "--cb-pill-radius"?: string;
+    "--cb-pill-height"?: string;
+    "--cb-pill-padding"?: string;
+    "--cb-pill-press-scale"?: string | number;
+    "--cb-pill-font-family"?: string;
+    "--cb-pill-font-size"?: string;
+    "--cb-pill-font-weight"?: string | number;
+    "--cb-pill-line-height"?: string | number;
+    "--cb-pill-gap"?: string;
+    "--cb-pill-icon-size"?: string;
+    "--cb-pill-icon-placeholder-bg"?: string;
+    "--cb-pill-address-font"?: string;
+    "--cb-pill-address-font-size"?: string;
+    "--cb-pill-address-letter-spacing"?: string;
 }
 /**
- * Thin pass-through to `ShellTrigger` (radix `Dialog.Trigger` on desktop /
- * vaul `Drawer.Trigger` on mobile), mirroring `RelayDepositTrigger` so hosts
- * write `<RelayHistory.Trigger><button>…</button></RelayHistory.Trigger>`
- * without knowing which primitive is active. Falls back to a plain default
- * button when no child is given.
+ * Resolved wallet provider — determines which icon + display name appears
+ * in the connected pill.
  *
- * Wrapped in `<TrackingBoundary feature="relay">` for the same reason
- * `RelayDepositTrigger`/`WalletConnectModalTrigger` are: `data-track="open"` is
- * only read by the delegate a boundary installs, and this trigger sits OUTSIDE
- * the portaled `<Content>`'s own boundary.
+ * - `google` / `apple`: crossy-sdk 2.0 OAuth login types (embedded wallet)
+ * - `cross`: generic CROSSx mark (covers CROSSx 1.0 extension/app + 2.0
+ *   embedded when no OAuth provider is attached)
+ * - `metamask` / `binance`: external wallets
  */
-declare function RelayHistoryTrigger({ asChild, children }: RelayHistoryTriggerProps): react_jsx_runtime.JSX.Element;
-
-declare function RelayHistoryRoot(props: RelayHistoryProps): react_jsx_runtime.JSX.Element;
-declare const RelayHistory: typeof RelayHistoryRoot & {
-    Trigger: typeof RelayHistoryTrigger;
-    Content: typeof RelayHistoryContent;
-};
-
-interface RelayRecoveryContentProps {
-    /** Extra class name(s) for the dialog/drawer content element. Falls back to
-     * `<RelayRecovery>`'s own `className`. */
+type WalletProvider = "google" | "apple" | "cross" | "metamask" | "binance";
+interface ConnectButtonProps {
+    /** 사용자가 Connect 버튼을 눌러 연결이 진행 중. 스피너 버튼으로 전환된다. */
+    isConnecting?: boolean;
+    /**
+     * 0x… 지갑 주소. 지정되면 connected pill로 렌더링된다. 없으면
+     * disconnected 버튼("Connect Wallet")으로 떨어진다.
+     */
+    address?: string;
+    /**
+     * 트리거 pill에 표시될 provider 아이콘 키.
+     *
+     * `address`가 있는데 `provider`가 `undefined`면 SDK 조회 중인 전이
+     * 상태로 취급해 placeholder 원을 띄운다(`pending` 플래시 방지).
+     */
+    provider?: WalletProvider;
+    /**
+     * 트리거 버튼 aria-label에 포함될 provider 표시 이름. 미지정 시
+     * `provider`로부터 기본값이 유추된다 (예: 'Google', 'CROSSx').
+     */
+    providerName?: string;
+    /** WalletInfo 헤더에 노출될 계정 라벨 (예: "Account 1", 사용자 지정 이름). */
+    accountName?: string;
+    /** Send 주소록의 My Account 탭에 노출할 계정 목록. */
+    sendAccounts?: SendAccount[];
+    /** disconnected 상태에서 버튼 클릭 핸들러. */
+    onConnect?: () => void;
+    /** connected 상태에서 WalletInfo 하단 Disconnect 클릭 핸들러. */
+    onDisconnect?: () => void;
+    /**
+     * 주소 복사 성공 콜백. WalletInfo의 `onCopyAddress(address, success)` 에서
+     * `success === true`일 때만 호출된다.
+     */
+    onCopy?: () => void;
+    /** 지갑 변경 chevron 클릭 핸들러. 지정하지 않으면 chevron이 숨김 처리된다. */
+    onSelectWallet?: () => void;
+    /**
+     * WalletInfo 기본 액션 row의 Buy 클릭 핸들러. Promise를 반환하면 reject 시
+     * Buy 카드가 `onBuyDisabledMessage`와 동일한 토스트로 실패를 안내한다.
+     */
+    onBuy?: () => void | Promise<void>;
+    /**
+     * Buy 카드를 시각적으로 비활성 상태로 표시하고, 사용자가 클릭하면 이 메시지를
+     * 토스트로 띄운다. `onBuy`보다 우선. WalletInfoProps의 동일 prop으로 그대로
+     * 전달된다.
+     */
+    onBuyDisabledMessage?: string;
+    /**
+     * disconnected 버튼 라벨. 기본 'Connect Wallet'.
+     * 문자열 외에 ReactNode를 넘겨 아이콘-only / 커스텀 마크업을 렌더할 수 있다
+     * (모바일에서 아이콘만 보여주고 싶을 때 등).
+     */
+    label?: ReactNode;
+    /** isConnecting 상태 라벨. 기본 'Connecting...'. */
+    connectingLabel?: ReactNode;
+    /** WalletInfo 내장 Disconnect 버튼 라벨. 기본 'Disconnect'. */
+    disconnectLabel?: string;
+    /**
+     * 외부(호출부)에서 주입하는 className. disconnected / connecting /
+     * connected(트리거 pill)에 공통으로 추가된다 (기본 `cb-button` /
+     * `cb-pill` 클래스에 병합).
+     */
     className?: string;
+    /**
+     * 버튼 자체(`disconnected` / `connecting` / `connected pill`)의
+     * CSS 커스텀 변수 오버라이드. WalletInfo popover 스타일은 별도
+     * `walletInfoStyle` 로 분리되어 있다.
+     */
+    style?: ConnectButtonStyle;
+    /**
+     * 트리거 pill 을 눌러 열리는 WalletInfo popover/drawer 의 CSS
+     * 커스텀 변수 오버라이드 (`WalletInfoStyle`).
+     */
+    walletInfoStyle?: WalletInfoStyle;
+    theme?: Theme;
+    env?: Environment;
+    showBalance?: boolean;
+    showPortfolio?: boolean;
+    drawerDirection?: DrawerDirection$1;
+    modal?: boolean;
+    connectorId?: ConnectorId;
+    /** Send 페이지의 일반 토큰 전송에 사용할 외부 트랜잭션 전송 함수. */
+    sendTransaction?: SendTransactionFn$1;
+    getTransactionReceipt?: GetTransactionReceiptFn;
+    /**
+     * Send 확인 단계의 가스/수수료 추정 함수. 미주입 시 SendPage Confirm 화면의
+     * Est. Tx Fee / Gas Limit / Max. Total Amount 행이 "—"로 표시된다.
+     */
+    estimateGas?: EstimateGasFn;
+    /**
+     * 상단 QR 버튼 / 기본 액션 row의 Receive / Send 콜백. (Buy는 위 onBuy로
+     * 정의됨.)
+     */
+    onReceive?: () => void;
+    /**
+     * @deprecated Bridge 버튼은 항상 apps.json(gametokenBridge) 웹으로
+     * 이동한다. 이 콜백은 더 이상 호출되지 않는다.
+     */
+    onBridge?: () => void;
+    onSend?: () => void;
+    bridgeTokens?: BridgeToken[];
+    bridgeHistory?: BridgeHistoryItem[];
+    getBridgeQuote?: BridgeQuoteFn;
+    getBridgeToTokens?: BridgeGetToTokensFn;
+    getBridgeApproval?: BridgeGetApprovalFn;
+    approveBridge?: BridgeApproveFn;
+    submitBridge?: BridgeSubmitFn;
 }
-/**
- * `<RelayRecovery.Content>` — the modal/drawer surface. Same portal-scoped
- * lifecycle as `<RelayHistory.Content>`: nothing is requested before the modal
- * is opened, and the whole subtree (including `useRecovery`'s state and any
- * in-flight recovery tracking) unmounts on close, so there is no per-open state
- * to reset explicitly.
- */
-declare function RelayRecoveryContent({ className }: RelayRecoveryContentProps): react_jsx_runtime.JSX.Element;
 
-interface RelayRecoveryTriggerProps {
-    /** Render the child as the trigger instead of wrapping it. Defaults to
-     * `true` whenever a child is supplied, matching `RelayHistoryTrigger`'s
-     * (and `RelayDepositTrigger`'s) `asChild ?? children != null` rule. */
-    asChild?: boolean;
-    children?: ReactNode;
-}
 /**
- * Thin pass-through to `ShellTrigger` (radix `Dialog.Trigger` on desktop /
- * vaul `Drawer.Trigger` on mobile), mirroring `RelayHistoryTrigger` so hosts
- * write `<RelayRecovery.Trigger><button>…</button></RelayRecovery.Trigger>`
- * without knowing which primitive is active. Falls back to a plain-text
- * "Recover" button when no child is given -- unstyled like the sibling
- * `RelayDepositTrigger`/`RelayHistoryTrigger` defaults, so it inherits the
- * host's own button chrome instead of shipping a look of its own.
+ * 3-state wallet connect button. Caller drives the visual state:
  *
- * The default button renders NO count badge (2026-07-30: removed on request --
- * the number read as an unread-notification alarm). The root's cross-target
- * recoverable count still reaches the trigger element as
- * `data-rd-recovery-count` (radix/vaul merge Trigger props onto the `asChild`
- * child too), so a host that WANTS a badge can opt in with its own CSS -- e.g.
- * `button[data-rd-recovery-count]:not([data-rd-recovery-count="0"])::after` --
- * without refetching anything.
+ *   - `isConnecting === true`        → 스피너 disabled 버튼
+ *   - `address` 있음                 → WalletInfo + connected pill
+ *   - `address`가 있는데 `provider` 없음 → SDK 조회 전이 상태, placeholder 원
+ *   - 둘 다 없음                     → "Connect Wallet" 버튼
  *
- * Wrapped in `<TrackingBoundary feature="relay">` for the same reason
- * `RelayHistoryTrigger` is: `data-track="open"` is only read by the delegate a
- * boundary installs, and this trigger sits OUTSIDE the portaled `<Content>`'s
- * own boundary.
+ * view-only: wagmi / connect-kit 같은 web3 의존성은 갖지 않으며 모든
+ * 상태/데이터/콜백은 props로 주입받는다. 실제 wagmi 연결 로직은
+ * `@nexus-cross/connect-kit-react`의 상위 래퍼에서 수행한다.
  */
-declare function RelayRecoveryTrigger({ asChild, children }: RelayRecoveryTriggerProps): react_jsx_runtime.JSX.Element;
-
-declare function RelayRecoveryRoot(props: RelayRecoveryProps): react_jsx_runtime.JSX.Element;
-declare const RelayRecovery: typeof RelayRecoveryRoot & {
-    Trigger: typeof RelayRecoveryTrigger;
-    Content: typeof RelayRecoveryContent;
-};
-
-interface UseRelayOrdersOptions {
-    client: RelayClient;
-    /** Valid EVM address, or undefined -- undefined clears the list and stops polling. */
-    recipient?: string;
-    /** Gate: wait for truthy before the first fetch (RelayDeposit passes rawCatalog). Default true. */
-    enabled?: boolean;
-    /** REST safety-net cadence in milliseconds. Defaults to 30s; the open Deposit popup uses 1s
-     * so completion still appears promptly when the SSE event is absent. */
-    refetchInterval?: number;
-    /** @deprecated Use `refetchInterval`. Retained for compatibility. */
-    fallbackPollMs?: number;
-    onError?: (e: Error) => void;
-}
-interface UseRelayOrdersResult {
-    /** Every order swept from deposits to this recipient so far, newest-first
-     * as served by the API. Polled continuously once `recipient` is a valid address. */
-    orders: OrderSummary[];
-    ordersLoading: boolean;
-    ordersError?: Error;
-    /** Recipient the current snapshot belongs to. Undefined while a new
-     * subscription is waiting for its first accepted fetch, so consumers never
-     * baseline a previous recipient's rows as fresh deposits. */
-    ordersForRecipient?: string;
-    /** Increments after every accepted fetch, even when the client returns the
-     * same array reference or the request fails. Consumers use this as a
-     * low-frequency refresh signal for related read models such as /recovery. */
-    ordersRevision: number;
-    /** True once at least one fetch has COMPLETED (success or failure) for the
-     * current (recipient, enabled) subscription; false again when it resets.
-     * Distinct from `!ordersLoading`, which is also true BEFORE the first fetch
-     * has even started -- consumers that snapshot the list (e.g. the deposit
-     * wizard's new-order watch) must wait for this, or they baseline against
-     * the initial empty state and misread every existing order as new. */
-    ordersInitialized: boolean;
-}
-declare function useRelayOrders(opts: UseRelayOrdersOptions): UseRelayOrdersResult;
+declare function ConnectButton({ isConnecting, address, provider, providerName, accountName, sendAccounts, onConnect, onDisconnect, onCopy, onSelectWallet, onBuy, onBuyDisabledMessage, label, connectingLabel, disconnectLabel, className, theme, env, showBalance, showPortfolio, drawerDirection, modal, connectorId, style, walletInfoStyle, sendTransaction, getTransactionReceipt, estimateGas, onReceive, onBridge, onSend, bridgeTokens, bridgeHistory, getBridgeQuote, getBridgeToTokens, getBridgeApproval, approveBridge, submitBridge, }: ConnectButtonProps): react_jsx_runtime.JSX.Element;
 
-interface UseRelayConfigOptions {
-    /** Pre-built client. Takes precedence over apiBaseUrl. */
-    client?: RelayClient;
-    /** Used to build a client when `client` is not supplied. */
-    apiBaseUrl?: string;
-    /** Stops the request and clears the current snapshot. Defaults to true. */
-    enabled?: boolean;
-    /** Optional automatic REST refresh cadence in milliseconds. Disabled when omitted or <= 0. */
-    refetchInterval?: number;
-    onError?: (error: Error) => void;
-}
-interface UseRelayConfigResult {
-    /** Latest GET /v1/config response. */
-    config?: Catalog;
-    loading: boolean;
-    error?: Error;
-    /** Re-fetches GET /v1/config using the current client. */
-    refresh: () => void;
-}
 /**
- * Public read-only hook for Relay's origin/destination/target catalog.
+ * Wallet provider icons used by `ConnectButton`. Ported from
+ * `@nexus-cross/connect-kit-wagmi` so dapp-ui stays a self-contained,
+ * bundler-agnostic module (no SVG loader required) and doesn't pull in a
+ * web3 dependency for icon assets.
  *
- * The response is a normal REST snapshot, not an SSE stream. Use
- * `refetchInterval` for periodic refreshes or call `refresh` for an immediate
- * read without replacing the client or remounting the component.
+ * Each icon is an inline `data:image/svg+xml` URI so it can be consumed
+ * directly by `<img src={...}>`.
+ *
+ * Source references mirror the ones in `connect-kit-wagmi/src/wallets/icons.ts`:
+ *   wallet-crossx.svg        → CROSSX_ICON        (cross / cross-extension / cross-embedded fallback)
+ *   wallet-metamask.svg      → METAMASK_ICON
+ *   wallet-binance.svg       → BINANCE_ICON
  */
-declare function useRelayConfig(opts?: UseRelayConfigOptions): UseRelayConfigResult;
-
-type RecoveryAction = "execute" | "sweep";
-/** Per-attempt progress for `recover()`. "switching" = prompting a chain switch to BSC;
- * "deploying" = the factory.deploy() write is in flight/confirming (only needed when the
- * forwarder wasn't deployed yet); "recovering" = the execute()/sweepToUser() write is in
- * flight/confirming; "done"/"error" are terminal for this attempt. */
-type RecoveryStep = "idle" | "switching" | "deploying" | "recovering" | "done" | "error";
-interface RecoveryState {
-    step: RecoveryStep;
-    /** Tx hash of the factory.deploy() write -- only set when this attempt needed one. */
-    deployTxHash?: string;
-    /** Tx hash of the execute()/sweepToUser() write. */
-    actionTxHash?: string;
-    error?: string;
-}
+declare const CROSSX_ICON: string;
+declare const METAMASK_ICON: string;
+declare const BINANCE_ICON: string;
+declare const GOOGLE_ICON: string;
+declare const APPLE_ICON: string;
 
-type RelayRecoveryQueryKey = readonly [
-    "relay",
-    "recovery",
-    number,
-    string | null,
-    string | null
-];
 /**
- * React Query policies accepted by useRelayRecovery. The SDK owns the request
- * identity and response shape, so callers cannot replace queryKey/queryFn or
- * inject/select recovery balances.
+ * `SkillsButton`의 `style` prop 타입. 표준 `CSSProperties` 위에
+ * `--sb-*` CSS 커스텀 변수 키를 추가해 자동완성을 지원한다.
+ *
+ * 사용 예: `style={{ "--sb-color": "white", "--sb-bg": "rgba(0,0,0,0.4)" }}`
+ *
+ * CSS 변수는 자식 요소(아이콘, 스피너)로 cascading 되므로, `--sb-color`
+ * 하나만 바꿔도 텍스트·아이콘·스피너가 모두 같은 색을 따라간다.
  */
-type RelayRecoveryQueryOptions = Omit<UseQueryOptions<RecoveryInfo, Error, RecoveryInfo, RelayRecoveryQueryKey>, "queryKey" | "queryFn" | "select" | "initialData" | "initialDataUpdatedAt" | "placeholderData">;
-interface UseRelayRecoveryOptions {
-    /** Pre-built client. Takes precedence over apiBaseUrl. */
-    client?: RelayClient;
-    /** Used to build a client via createRelayClient when client isn't passed. */
-    apiBaseUrl?: string;
-    /** Connected EVM wallet whose recoverable forwarder balances are queried. */
-    recipient?: string;
-    /** Optional CROSS delivery target passed to GET /v1/recovery. */
-    target?: string;
-    /** React Query lifecycle, cache, retry, and refetch policies. */
-    query?: RelayRecoveryQueryOptions;
-    /** Optional wallet capabilities. Read-only consumers may omit this. */
-    wallet?: RelayWalletProps;
-    /** Called when GET /v1/recovery returns 401. */
-    onUnauthorized?: () => void;
-    /** Called after a terminal query or recovery-action error. */
-    onError?: (error: Error) => void;
-    /** Called once after a recovery transaction confirms successfully. */
-    onRecoverySuccess?: (result: RecoverySuccessResult) => void;
-    /** Trusted factory override for a self-hosted deployment. */
-    trustedFactories?: readonly string[];
+interface SkillsButtonStyle extends CSSProperties {
+    "--sb-bg"?: string;
+    "--sb-border"?: string;
+    "--sb-border-hover"?: string;
+    "--sb-color"?: string;
+    "--sb-color-hover"?: string;
+    "--sb-radius"?: string;
+    "--sb-height"?: string;
+    "--sb-padding"?: string;
+    "--sb-gap"?: string;
+    "--sb-font-size"?: string;
+    "--sb-font-weight"?: string | number;
+    "--sb-line-height"?: string | number;
+    "--sb-letter-spacing"?: string;
+    "--sb-blur"?: string;
+    "--sb-border-width"?: string;
+    "--sb-icon-size"?: string;
+    "--sb-icon-hover-rotation"?: string;
+    "--sb-spinner-size"?: string;
+    "--sb-spinner-thumb"?: string;
+    "--sb-spinner-track"?: string;
+    "--sb-disabled-opacity"?: string | number;
+    "--sb-press-scale"?: string | number;
+    "--sb-hover-duration"?: string;
+    "--sb-icon-duration"?: string;
+    "--sb-easing"?: string;
 }
-interface UseRelayRecoveryResult {
-    info?: RecoveryInfo;
-    loading: boolean;
-    error?: Error;
-    /** True for background refetches as well as the first request. */
-    isFetching: boolean;
-    /** Invalidates no identities; immediately refetches this hook's fixed query. */
-    refresh: () => void;
-    /** Signs a recovery transaction for the currently fetched info. */
-    recover: (action: RecoveryAction, tokenAddress?: string) => Promise<void>;
-    recoveryState: RecoveryState;
+interface SkillsButtonProps {
+    /** Button text label */
+    label?: string;
+    /** Skills service URL or path to navigate to */
+    href?: string;
+    /** Called when button is clicked (instead of navigation if provided) */
+    onClick?: () => void | Promise<void>;
+    /** Optional CSS class name (merged with built-in `.sb-button`) */
+    className?: string;
+    /** Inline style + CSS custom property overrides (`SkillsButtonStyle`) */
+    style?: SkillsButtonStyle;
+    /** Light/dark surface preset (sets `data-theme`). Defaults to no preset. */
+    theme?: Theme;
+    /** Disable the button */
+    disabled?: boolean;
+    /** Whether button is in loading state */
+    isLoading?: boolean;
+    /** Label shown while loading */
+    loadingLabel?: string;
+    /** Open link in new tab */
+    openInNewTab?: boolean;
+    /** Button type attribute */
+    type?: "button" | "submit" | "reset";
 }
+
 /**
- * Public Recovery API hook. Unlike the widget-internal useRecovery fetch, this
- * hook uses the host QueryClient and accepts React Query policies through
- * `query`. queryKey/queryFn and balance-shaping options remain SDK-owned.
+ * @deprecated 이동 대상은 apps.json(skills)이 단일 소스다. 이 상수는 더 이상
+ * 폴백으로 쓰이지 않으며 하위 호환(공개 export)용으로만 남아 있다.
  */
-declare function useRelayRecovery(opts?: UseRelayRecoveryOptions): UseRelayRecoveryResult;
-
-interface StatusTrackerProps {
-    orderId: string;
-    /** Latest polled order (steps/txs) from GET /v1/orders/{orderId}, owned by the caller. */
-    order?: Order;
-    /** Latest poll error, owned by the caller. */
-    error?: Error;
-}
-declare function StatusTracker({ orderId, order, error }: StatusTrackerProps): react_jsx_runtime.JSX.Element;
-
-/** Every StandingForwarderFactory / DepositorForwarderFactory this deployment
- * has issued deposit addresses from, on BSC.
- *
- * Superseded factories stay listed on purpose. A forwarder's factory is pinned
- * per address at issuance time (`standing_addresses.factory`, copied onto each
- * order), so a user recovering an address minted before a rotation legitimately
- * gets an older factory back from the API -- dropping it here would block that
- * user from recovering their own funds, which is a worse outcome than the
- * narrow trust gain. Every entry is one of ours either way.
- *
- * Rotation (see backends/deploy/RUNBOOK-canary.md): ADD the new factory, keep
- * the old ones. */
-declare const DEFAULT_TRUSTED_FACTORIES: readonly string[];
+declare const DEFAULT_SKILLS_HREF = "https://www.onechain.nexus/skills";
+declare function SkillsButton({ label, href, onClick, className, style, theme, disabled, isLoading, loadingLabel, openInNewTab, type, }: SkillsButtonProps): react_jsx_runtime.JSX.Element;
 
-export { APPLE_ICON, AppLauncher, AppLauncherContent, type AppLauncherContentProps, type AppLauncherProps, AppLauncherTrigger, type AppLauncherTriggerProps, type AppLauncherTriggerStyle, type AppLauncherUsageMode, BINANCE_ICON, type BridgeAmountSource, type BridgeApprovalInfo, type BridgeApproveFn, type BridgeFailedInfo, BridgeFlow, type BridgeFlowProps, type BridgeGetApprovalFn, type BridgeGetToTokensFn, type BridgeHistoryItem, type BridgeInfoRow, type BridgeInfoTokenRef, type BridgeLiquidityInfo, type BridgePathType, type BridgeQuoteFn, type BridgeQuoteInput, type BridgeQuoteResult, type BridgeStatus, type BridgeStep, type BridgeSubmitFn, type BridgeSubmittedInfo, type BridgeToken, type BridgeTxSummary, CHAINS_CONFIG_FILE, CONNECTOR_REGISTRY, CROSSX_ICON, type Catalog, type ChainDisplayMeta, type ChainId, type ChainsConfig, ConnectButton, type ConnectButtonProps, type ConnectButtonStyle, ConnectorId, type ConnectorMeta, type CrossdPosition, type CrossdPositionDetail, type CrossdPositionPoolRef, type CrossdPositionTokenRef, DEFAULT_SKILLS_HREF, DEFAULT_TRUSTED_FACTORIES, DappUiErrorBoundary, type DappUiErrorBoundaryProps, type DappUiFailureReason, type DappUiFeature, type DappUiFlow, type DepositAddressResult, type DrawerDirection$1 as DrawerDirection, type Environment, type EstimateGasArgs, type EstimateGasFn, GOOGLE_ICON, type GameSwapPool, type GameSwapTokenRef, type GasEstimate, type GetBalanceFn, type GetTransactionReceiptArgs, type GetTransactionReceiptFn, type GlobalMenu, type GlobalMenuItem, type GlobalMenuItemAssetUrl, type GlobalMenuItemServiceStatus, type GlobalMenuItemUrl, type InitDappUiSentryOptions, type LpBalanceInfo, type LpBalanceReaderFn, METAMASK_ICON, type OnOutlink, type OrderSummary, type OriginOption, type OutlinkCategory, type OutlinkContext, type OutlinkOrigin, PORTFOLIO_SECTIONS, type PortfolioSection, type PreferredToken, type QuoteResult, type ReadContractFn, type RecentSendAddress, type RecoveryInfo, type RecoverySuccessResult, RelayApiError, type RelayBalance, type RelayClient, type RelayClientOptions, type RelayContractCall, RelayDeposit, type RelayDepositContentProps, type RelayDepositProps, type RelayDepositTriggerProps, type RelayDrawerDirection, type Hex as RelayHex, RelayHistory, type RelayHistoryContentProps, type RelayHistoryProps, type RelayHistoryTriggerProps, RelayRecovery, type RecoveryAction as RelayRecoveryAction, type RelayRecoveryContentProps, type RelayRecoveryProps, type RelayRecoveryQueryKey, type RelayRecoveryQueryOptions, type RecoveryState as RelayRecoveryState, type RecoveryStep as RelayRecoveryStep, type RelayRecoveryTriggerProps, type SendTransactionFn as RelaySendTransactionFn, type RelayTheme, type RelayTxRequest, type RelayWalletProps, SOCIAL_REGISTRY, type SendAccount, type SendAsset, SendFlow, type SendFlowProps, type SendPageProps, type SendStatus, type SendTransactionArgs, type SendTransactionFn$1 as SendTransactionFn, SkillsButton, type SkillsButtonProps, type SkillsButtonStyle, type SocialConfig, type SocialHandlers, type SocialId, type StakingRewardsInfo, type StakingRewardsReaderFn, StatusTracker, type StatusTrackerProps, type SwitchChainFn, TOKEN_STATS_QUERY_KEY, type Theme, type TokenBalance, type TokenBalanceResponse, type TokenStats, type TokenStatsResponse, type TrackDappUiFunnelOptions, type TransactionReceiptResult, USER_BALANCE_QUERY_KEY, type UseRelayConfigOptions, type UseRelayConfigResult, type UseRelayOrdersOptions, type UseRelayOrdersResult, type UseRelayRecoveryOptions, type UseRelayRecoveryResult, WALLET_REGISTRY, type WaitForReceiptFn, type WalletConfig, WalletConnectModal, type WalletConnectModalContentProps, type WalletConnectModalProps, type WalletConnectModalStyle, type WalletConnectModalTriggerProps, type WalletHandlers, type WalletId, WalletInfo, type WalletInfoContentProps, type WalletInfoFooterProps, type WalletInfoNavProps, type WalletInfoProps, type WalletInfoStyle, type WalletInfoTriggerProps, WalletPortfolio, WalletPortfolioBody, type WalletPortfolioBodyProps, type WalletPortfolioContentProps, type WalletPortfolioProps, type WalletPortfolioTriggerProps, type WalletProvider, type WriteContractFn, announceAppLauncherUsage, captureDappUiException, createRelayClient, getChainDisplay, getDappUiSentryScope, initDappUiSentry, normalizeFailureReason, resolveEnvironment, setDappUiAnalyticsUser, trackDappUiEvent, trackDappUiFunnel, useChainDisplay, useChainsConfig, useGlobalMenu, useRelayConfig, useRelayOrders, useRelayRecovery, useTokenBalance, useTokenStats, useWalletDetect };
+export { APPLE_ICON, AppLauncher, AppLauncherContent, type AppLauncherContentProps, type AppLauncherProps, AppLauncherTrigger, type AppLauncherTriggerProps, type AppLauncherTriggerStyle, type AppLauncherUsageMode, BINANCE_ICON, type BridgeAmountSource, type BridgeApprovalInfo, type BridgeApproveFn, type BridgeFailedInfo, BridgeFlow, type BridgeFlowProps, type BridgeGetApprovalFn, type BridgeGetToTokensFn, type BridgeHistoryItem, type BridgeInfoRow, type BridgeInfoTokenRef, type BridgeLiquidityInfo, type BridgePathType, type BridgeQuoteFn, type BridgeQuoteInput, type BridgeQuoteResult, type BridgeStatus, type BridgeStep, type BridgeSubmitFn, type BridgeSubmittedInfo, type BridgeToken, type BridgeTxSummary, CHAINS_CONFIG_FILE, CONNECTOR_REGISTRY, CROSSX_ICON, type Catalog, type ChainDisplayMeta, type ChainId, type ChainsConfig, ConnectButton, type ConnectButtonProps, type ConnectButtonStyle, ConnectorId, type ConnectorMeta, type CrossdPosition, type CrossdPositionDetail, type CrossdPositionPoolRef, type CrossdPositionTokenRef, DEFAULT_SKILLS_HREF, DEFAULT_TRUSTED_FACTORIES, DappUiErrorBoundary, type DappUiErrorBoundaryProps, type DappUiFailureReason, type DappUiFeature, type DappUiFlow, type DepositAddressResult, type DrawerDirection$1 as DrawerDirection, type Environment, type EstimateGasArgs, type EstimateGasFn, GOOGLE_ICON, type GameSwapPool, type GameSwapTokenRef, type GasEstimate, type GetBalanceFn, GetOneUsd, type GetOneUsdActionId, type GetOneUsdBridgeProps, type GetOneUsdButtonComponent, type GetOneUsdEvent, type GetOneUsdMode, type GetOneUsdPairs, type GetOneUsdProps, type GetOneUsdRelayProps, type GetOneUsdRemoteModes, type GetOneUsdTokenRef, type GetOneUsdWaitForTransaction, type GetTransactionReceiptArgs, type GetTransactionReceiptFn, type GlobalMenu, type GlobalMenuItem, type GlobalMenuItemAssetUrl, type GlobalMenuItemServiceStatus, type GlobalMenuItemUrl, type InitDappUiSentryOptions, type LpBalanceInfo, type LpBalanceReaderFn, METAMASK_ICON, type OnOutlink, type OrderSummary, type OriginOption, type OutlinkCategory, type OutlinkContext, type OutlinkOrigin, PORTFOLIO_SECTIONS, type PortfolioSection, type PreferredToken, type QuoteResult, type ReadContractFn, type RecentSendAddress, type RecoveryInfo, type RecoverySuccessResult, RelayApiError, type RelayBalance, type RelayClient, type RelayClientOptions, type RelayContractCall, RelayDeposit, type RelayDepositContentProps, type RelayDepositProps, type RelayDepositTriggerProps, type RelayDrawerDirection, type Hex as RelayHex, RelayHistory, type RelayHistoryContentProps, type RelayHistoryProps, type RelayHistoryTriggerProps, RelayRecovery, type RecoveryAction as RelayRecoveryAction, type RelayRecoveryContentProps, type RelayRecoveryProps, type RelayRecoveryQueryKey, type RelayRecoveryQueryOptions, type RecoveryState as RelayRecoveryState, type RecoveryStep as RelayRecoveryStep, type RelayRecoveryTriggerProps, type SendTransactionFn as RelaySendTransactionFn, type RelayTheme, type RelayTxRequest, type RelayWalletProps, type ResolvedGetOneUsdRoute, SOCIAL_REGISTRY, type SendAccount, type SendAsset, SendFlow, type SendFlowProps, type SendPageProps, type SendStatus, type SendTransactionArgs, type SendTransactionFn$1 as SendTransactionFn, SkillsButton, type SkillsButtonProps, type SkillsButtonStyle, type SocialConfig, type SocialHandlers, type SocialId, type StakingRewardsInfo, type StakingRewardsReaderFn, StatusTracker, type StatusTrackerProps, type SwitchChainFn, TOKEN_STATS_QUERY_KEY, type Theme, type TokenBalance, type TokenBalanceResponse, type TokenStats, type TokenStatsResponse, type TrackDappUiFunnelOptions, type TransactionReceiptResult, USER_BALANCE_QUERY_KEY, type UseRelayConfigOptions, type UseRelayConfigResult, type UseRelayOrdersOptions, type UseRelayOrdersResult, type UseRelayRecoveryOptions, type UseRelayRecoveryResult, WALLET_REGISTRY, type WaitForReceiptFn, type WalletConfig, WalletConnectModal, type WalletConnectModalContentProps, type WalletConnectModalProps, type WalletConnectModalStyle, type WalletConnectModalTriggerProps, type WalletHandlers, type WalletId, WalletInfo, type WalletInfoContentProps, type WalletInfoFooterProps, type WalletInfoNavProps, type WalletInfoProps, type WalletInfoStyle, type WalletInfoTriggerProps, WalletPortfolio, WalletPortfolioBody, type WalletPortfolioBodyProps, type WalletPortfolioContentProps, type WalletPortfolioProps, type WalletPortfolioTriggerProps, type WalletProvider, type WriteContractFn, announceAppLauncherUsage, captureDappUiException, createRelayClient, findGetOneUsdToken, getChainDisplay, getDappUiSentryScope, getOneUsdTokenKey, initDappUiSentry, isGetOneUsdActionEnabled, isGetOneUsdActionSupported, isGetOneUsdActionVisible, isGetOneUsdTargetAvailable, matchesGetOneUsdToken, normalizeFailureReason, resolveEnvironment, resolveGetOneUsdRoute, setDappUiAnalyticsUser, trackDappUiEvent, trackDappUiFunnel, useChainDisplay, useChainsConfig, useGlobalMenu, useRelayConfig, useRelayOrders, useRelayRecovery, useTokenBalance, useTokenStats, useWalletDetect };