@nexus-cross/dapp-ui 1.1.4 → 1.3.0

package/dist/index.d.cts

@@ -9,6 +9,12 @@ type DrawerDirection$1 = "right" | "bottom" | "left";
 
 declare function resolveEnvironment(env?: Environment | "staging" | "prd" | "prod" | "stg"): Environment;
 
+type AppLauncherUsageMode = "dapp-ui" | "connect-kit-react";
+declare function announceAppLauncherUsage(options?: {
+    mode?: AppLauncherUsageMode;
+    connectKitVersion?: string;
+}): void;
+
 interface AppLauncherProps {
     env?: Environment;
     theme?: Theme;
@@ -226,47 +232,86 @@ interface UserDepositInfo {
     last_updated_time: number;
     last_withdrawn_block: number;
 }
-interface Billboard {
-    price: string;
-    change: string;
-    rate: number;
-    high24: string;
-    low24: string;
-    baseVolume: string;
-    quoteVolume: string;
-}
-interface DexPairInfo {
-    pair_name: string;
+/**
+ * host(wagmi 보유 측)가 공급하는 LP 잔고 reader가 반환하는 단위 정보.
+ * 금액은 모두 raw(wei) BigInt로 다루고, 표기 시에만 decimals로 환산한다.
+ */
+interface LpBalanceInfo {
+    /** 연결 계정의 LP 토큰 잔고 `balanceOf(account)` (raw, wei) */
+    balance: bigint;
+    /** LP 토큰 총발행량 `totalSupply()` (raw, wei). 없으면 지분율 계산 불가. */
+    totalSupply?: bigint;
+    /** LP 토큰 decimals (보통 18). 없으면 18로 간주. */
+    decimals?: number;
+}
+/**
+ * 주입형 LP 잔고 reader. host(wagmi)가 연결 계정 기준으로 주어진 pair(LP)
+ * 토큰 주소들의 balanceOf / totalSupply / decimals를 읽어 반환한다.
+ * 반환 맵의 key는 소문자 정규화된 pair 주소.
+ *
+ * dapp-ui는 이 함수 시그니처에만 의존하며 viem/wagmi를 직접 사용하지 않는다.
+ * 미주입 시 game-swap LP 섹션은 풀 정보만 표시하고 수량/지분율/가치는 생략한다.
+ */
+type LpBalanceReaderFn = (pairAddresses: string[]) => Promise<Record<string, LpBalanceInfo>>;
+/**
+ * game-swap `/portfolio` pool 항목의 토큰 참조.
+ * NOTE: CROSS 쪽(token_b)은 백엔드가 메타데이터 없이 내려준다 —
+ * `symbol: ""`, `name: ""`, `decimals: 0`, `logo_url` 누락. 소비 측에서
+ * symbol은 "CROSS"로, decimals는 18로 간주해야 한다 (실응답 확인 기준).
+ */
+interface GameSwapTokenRef {
+    address: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    logo_url?: string;
+}
+/**
+ * game-swap `GET /addresses/:address/portfolio`의 `pools[]` 항목.
+ * 풀 단위 정보(예비량/가격)만 담고, 사용자별 LP 잔고는 포함하지 않는다
+ * (그것은 주입형 reader의 온체인 read로 보강한다).
+ */
+interface GameSwapPool {
     pair_address: string;
-    quote_address: string;
-    base_address: string;
-    quote_symbol: string;
-    base_symbol: string;
-    quote_name: string;
-    base_name: string;
-    quote_decimals: number;
-    base_decimals: number;
-    icon_image: string;
-    enabled: boolean;
-    active: boolean;
-    status: string;
-    billboard: Billboard;
-    tick_size: string;
-    lot_size: string;
-}
-interface DexOpenOrder {
-    order_id: number;
-    /** 0 = sell (ask), 1 = buy (bid) */
-    order_side: number;
-    owner: string;
-    pair: string;
-    price: string;
-    amount: string;
-    filled: string;
-    volume: string;
-    created_at: number;
-    created_block: number;
-    created_hash: string;
+    token_a?: GameSwapTokenRef;
+    token_b?: GameSwapTokenRef;
+    /** raw wei */
+    reserve_a: string;
+    /** raw wei */
+    reserve_b: string;
+    /** 1 token_a = X token_b(CROSS) */
+    last_price: string;
+    /** last_price × cross_usd */
+    price_usd: string;
+    /** CROSS/USD 환율 */
+    cross_usd: string;
+    /** token_a 24h 변동률 (0.0012 = +0.12%) */
+    change_24h: string;
+}
+/**
+ * POSA governance API의 staking 요약 정보. `GET /stake/:address`.
+ * 금액은 wei가 아니라 CROSS 단위 십진 문자열로 내려온다
+ * (예: `"500.0000"`, `"0.000000000000000000"`). 실응답 확인 기준.
+ */
+interface StakeInfo {
+    address: string;
+    /** 현재 스테이킹된 총량 (CROSS 단위 십진 문자열) */
+    total_stake: string;
+    /** 누적/청구 가능 리워드 (CROSS 단위 십진 문자열) */
+    rewards_earned: string;
+    /** 위임(delegation) 개수 */
+    delegations: number;
+    /** 최초 스테이킹 시각 (ISO timestamp). 스테이킹 이력이 없으면 null. */
+    first_staked_at: string | null;
+    /** 최초 스테이킹 이후 경과 일수. 스테이킹 이력이 없으면 null. */
+    days_since_first_stake: number | null;
+}
+/** 네트워크 통계 중 포트폴리오에서 사용하는 필드 (`GET /network/stats`). */
+interface NetworkStats {
+    /** 네트워크 APR (백분율 문자열, 예: "12.5") */
+    apr: string;
+    total_staked: string;
+    active_validators: number;
 }
 interface ForgePoolToken {
     address: string;
@@ -299,8 +344,6 @@ interface ForgeTokenDetail {
     available_supply: string;
 }
 
-type DexMarket = "cross" | "crossd" | "forge";
-
 /**
  * dapp-ui가 렌더하는 outlink의 대분류.
  * `portfolio`는 세부적으로 `origin`으로 더 나뉜다.
@@ -329,19 +372,23 @@ type OutlinkContext = {
     };
 } | {
     category: "portfolio";
-    origin: "portfolio-forge";
+    origin: "portfolio-stake";
     payload: {
-        pool: ForgePool;
-        tokenDetail?: ForgeTokenDetail;
+        stakeInfo?: StakeInfo;
+        networkStats?: NetworkStats;
+    };
+} | {
+    category: "portfolio";
+    origin: "portfolio-game-swap";
+    payload: {
+        pool: GameSwapPool;
     };
 } | {
     category: "portfolio";
-    origin: "portfolio-dex-order";
+    origin: "portfolio-forge";
     payload: {
-        market: DexMarket;
-        side: "buy" | "sell";
-        order: DexOpenOrder;
-        pair?: DexPairInfo;
+        pool: ForgePool;
+        tokenDetail?: ForgeTokenDetail;
     };
 } | {
     category: "send";
@@ -404,11 +451,169 @@ interface SendPageProps {
      */
     estimateGas?: EstimateGasFn;
     onSuccess?: (txHash: `0x${string}`) => void;
-    onConfirmSuccess?: () => void;
+    onConfirmSuccess?: (txHash?: `0x${string}`) => void;
+    onOutlink?: OnOutlink;
+}
+
+interface SendSubmittedInfo {
+    txHash: `0x${string}`;
+    chainId: number;
+    amount: string;
+    tokenSymbol: string;
+    recipient: `0x${string}`;
+}
+interface SendFailedInfo {
+    txHash?: `0x${string}`;
+    chainId: number;
+    message: string;
+}
+
+interface SendFlowProps {
+    env?: Environment;
+    theme?: Theme;
+    walletAddress: string;
+    accountName?: string;
+    accounts?: SendAccount[];
+    /** First step shown when the flow opens. Defaults to `recipient`. */
+    initialStep?: "token" | "recipient";
+    token: SendAsset;
+    tokens?: SendAsset[];
+    onTokenChange?: (token: SendAsset) => void;
+    sendTransaction?: SendTransactionFn;
+    getTransactionReceipt?: GetTransactionReceiptFn;
+    estimateGas?: EstimateGasFn;
+    getTokenPriceUsd?: (token: SendAsset) => number | undefined;
+    onSubmitted?: (info: SendSubmittedInfo) => void;
+    onSuccess?: (txHash: `0x${string}`) => void;
+    onFailed?: (info: SendFailedInfo) => void;
+    /** Close the whole surface (X). */
+    onClose?: () => void;
+    /** Back out of the first step (return to the wallet view). */
+    onBackToWallet?: () => void;
+    /** Finished after a successful send. */
+    onConfirmSuccess?: (txHash?: `0x${string}`) => void;
     onOutlink?: OnOutlink;
+    className?: string;
 }
+declare function SendFlow({ onClose, onBackToWallet, onConfirmSuccess, onSuccess, className, ...rest }: SendFlowProps): react_jsx_runtime.JSX.Element;
 
-declare function SendPage({ env, theme, walletAddress, accountName, accounts, token, tokens, onTokenChange, sendTransaction, getTransactionReceipt, estimateGas, onSuccess, onConfirmSuccess, onOutlink, }: SendPageProps): react_jsx_runtime.JSX.Element;
+type BridgeStep = "form" | "history";
+type BridgeStatus = "idle" | "quoting" | "submitting" | "success" | "error";
+type BridgeAmountSource = "from" | "to";
+type BridgePathType = "bridge" | "swap" | "swap-bridge" | "bridge-swap" | "deposit-swap" | "swap-withdraw";
+interface BridgeToken {
+    name: string;
+    symbol: string;
+    chainId: number;
+    address: string;
+    decimals: number;
+    balance: string;
+    iconUrl?: string;
+    priceUsd?: number;
+}
+interface BridgeInfoTokenRef {
+    symbol: string;
+    iconUrl?: string;
+}
+interface BridgeInfoRow {
+    label: string;
+    value: string;
+    tone?: "default" | "accent" | "warning";
+    routeTokens?: BridgeInfoTokenRef[];
+    valueToken?: BridgeInfoTokenRef;
+}
+interface BridgeLiquidityInfo {
+    label?: string;
+    value: string;
+    status?: "low" | "normal" | "rebalancing";
+    percentage?: number;
+}
+interface BridgeTxSummary {
+    pathType?: BridgePathType;
+    exchangeRate?: string;
+    liquidity?: BridgeLiquidityInfo;
+    bridgeInfo?: BridgeInfoRow[];
+    swapInfo?: BridgeInfoRow[];
+    txFeeInfo?: {
+        estTxFee: string;
+        isDelegateFee?: boolean;
+        tokenIconUrl?: string;
+        tokenSymbol?: string;
+    };
+    txFee?: BridgeInfoRow[];
+}
+interface BridgeQuoteInput {
+    fromToken: BridgeToken;
+    toToken: BridgeToken;
+    fromAmount: string;
+    toAmount: string;
+    lastChangedBy: BridgeAmountSource;
+    slippage: string;
+}
+interface BridgeQuoteResult {
+    fromAmount?: string;
+    toAmount?: string;
+    summary?: BridgeTxSummary;
+    error?: string;
+}
+interface BridgeSubmittedInfo {
+    txHash: `0x${string}`;
+    fromToken: BridgeToken;
+    toToken: BridgeToken;
+    fromAmount: string;
+    toAmount: string;
+    pathType?: BridgePathType;
+    routeTokens?: BridgeInfoTokenRef[];
+}
+interface BridgeApprovalInfo {
+    token: BridgeToken;
+    tokenAddress: string;
+    spenderAddress: string;
+    amount?: string;
+}
+interface BridgeFailedInfo {
+    message: string;
+    txHash?: `0x${string}`;
+}
+interface BridgeHistoryItem {
+    id: string;
+    timestamp: string;
+    txHash: `0x${string}`;
+    fromToken: BridgeToken;
+    toToken: BridgeToken;
+    fromAmount: string;
+    toAmount: string;
+    summary?: BridgeTxSummary;
+    status?: "pending" | "success" | "failed";
+}
+type BridgeQuoteFn = (input: BridgeQuoteInput) => Promise<BridgeQuoteResult> | BridgeQuoteResult;
+type BridgeSubmitFn = (input: BridgeQuoteInput) => Promise<BridgeSubmittedInfo> | BridgeSubmittedInfo;
+type BridgeGetApprovalFn = (input: BridgeQuoteInput) => Promise<BridgeApprovalInfo | null> | BridgeApprovalInfo | null;
+type BridgeApproveFn = (input: BridgeQuoteInput, approval: BridgeApprovalInfo) => Promise<void> | void;
+type BridgeGetToTokensFn = (fromToken: BridgeToken, tokens: BridgeToken[]) => BridgeToken[];
+
+interface BridgeFlowProps {
+    walletAddress: string;
+    tokens: BridgeToken[];
+    initialFromToken?: BridgeToken;
+    initialToToken?: BridgeToken;
+    history?: BridgeHistoryItem[];
+    initialSlippage?: string;
+    termsUrl?: string;
+    env?: Environment;
+    getQuote?: BridgeQuoteFn;
+    getToTokens?: BridgeGetToTokensFn;
+    getApproval?: BridgeGetApprovalFn;
+    approveBridge?: BridgeApproveFn;
+    submitBridge?: BridgeSubmitFn;
+    onSubmitted?: (info: BridgeSubmittedInfo) => void;
+    onSuccess?: (info: BridgeSubmittedInfo) => void;
+    onFailed?: (info: BridgeFailedInfo) => void;
+    onClose?: () => void;
+    onBackToWallet?: () => void;
+    className?: string;
+}
+declare function BridgeFlow({ onClose, onBackToWallet, env, className, ...rest }: BridgeFlowProps): react_jsx_runtime.JSX.Element;
 
 interface WalletInfoTriggerProps {
     asChild?: boolean;
@@ -446,6 +651,12 @@ interface WalletInfoProps {
     showForgeToken?: boolean;
     showGameToken?: boolean;
     showQR?: boolean;
+    /**
+     * Bridge 액션 노출 여부 (기본 true).
+     * - true: 액션 행에 Bridge 버튼, Receive는 상단 QR 버튼으로 표기
+     * - false: 액션 행에 Receive 버튼, 상단 QR 버튼 미표기
+     */
+    showBridge?: boolean;
     qrLogoSrc?: string;
     walletAddress: string;
     accountName?: string;
@@ -459,6 +670,14 @@ interface WalletInfoProps {
     preferredTokens?: PreferredToken[];
     onSelectWallet?: () => void;
     onCopyAddress?: (address: string, success: boolean) => void;
+    /** WalletInfo 기본 액션 row의 Buy 클릭 핸들러. */
+    onBuy?: () => void;
+    /**
+     * Buy 카드를 시각적으로 비활성 상태로 표시하고, 사용자가 클릭하면 이
+     * 메시지를 토스트로 띄운다. `onBuy`보다 우선. 예: on-ramp가 사용자 국가에서
+     * 차단된 경우 안내 메시지 전달용.
+     */
+    onBuyDisabledMessage?: string;
     /**
      * 지정 시 기본 Disconnect 버튼이 Footer에 노출됨. `WalletInfo.Footer` 슬롯이
      * 있으면 해당 슬롯이 메인 영역을 대체한다. Terms/Privacy 링크는 둘 중 무엇을
@@ -487,8 +706,7 @@ interface WalletInfoProps {
     onOpenChange?: (open: boolean) => void;
     /**
      * Portfolio 뷰 사용 여부.
-     * true면 Total Assets 섹션이 클릭 가능해지며, 클릭 시 내부 Portfolio 뷰로 전환됩니다.
-     * (showBalance=true && showTotalAssets=true 일 때만 클릭 영역이 표시됩니다.)
+     * true면 기본 액션 row에 Portfolio 버튼이 표시되며, 클릭 시 내부 Portfolio 뷰로 전환됩니다.
      */
     showPortfolio?: boolean;
     /** Portfolio 뷰의 헤더 타이틀 (기본 "My Portfolio"). */
@@ -518,10 +736,30 @@ interface WalletInfoProps {
      * `showPortfolio=true`일 때 내부 `WalletPortfolioBody`로도 릴레이된다.
      */
     onOutlink?: OnOutlink;
+    /**
+     * game-swap LP 섹션의 사용자별 LP 잔고/지분율을 온체인에서 보강하기 위한
+     * 주입형 reader. `showPortfolio=true`일 때 `WalletPortfolioBody`로 릴레이된다.
+     * 미주입 시 LP 섹션은 풀 정보만 표시한다.
+     */
+    lpBalanceReader?: LpBalanceReaderFn;
+    bridgeTokens?: BridgeToken[];
+    bridgeHistory?: BridgeHistoryItem[];
+    getBridgeQuote?: BridgeQuoteFn;
+    getBridgeToTokens?: BridgeGetToTokensFn;
+    getBridgeApproval?: BridgeGetApprovalFn;
+    approveBridge?: BridgeApproveFn;
+    submitBridge?: BridgeSubmitFn;
+    /**
+     * 상단 QR 버튼 / 기본 액션 row의 Bridge / Send 콜백. (Buy는 위 onBuy
+     * prop으로 이미 정의됨.) Bridge는 미주입 시 내장 Bridge 화면으로 진입한다.
+     */
+    onReceive?: () => void;
+    onBridge?: () => void;
+    onSend?: () => void;
     style?: WalletInfoStyle;
     children: React.ReactNode;
 }
-declare function WalletInfoRoot({ env, theme, mobileBreakpoint, drawerDirection, modal, showBalance, showForgeToken, showGameToken, showQR, qrLogoSrc, walletAddress, accountName, sendAccounts, profileImageUrl, connectorId, connectorName: connectorNameProp, connectorIconUrl: connectorIconUrlProp, preferredTokens, onSelectWallet, onCopyAddress, onDisconnect, disconnectLabel, termsUrl, termsLabel, privacyUrl, privacyLabel, open: propOpen, onOpenChange, showPortfolio, portfolioTitle, showTotalAssets, totalAssetsLabel, sendTransaction, getTransactionReceipt, estimateGas, onOutlink, style, children, }: WalletInfoProps): react_jsx_runtime.JSX.Element;
+declare function WalletInfoRoot({ env, theme, mobileBreakpoint, drawerDirection, modal, showBalance, showForgeToken, showGameToken, showQR, showBridge, qrLogoSrc, walletAddress, accountName, sendAccounts, profileImageUrl, connectorId, connectorName: connectorNameProp, connectorIconUrl: connectorIconUrlProp, preferredTokens, onSelectWallet, onCopyAddress, onBuy, onBuyDisabledMessage, onDisconnect, disconnectLabel, termsUrl, termsLabel, privacyUrl, privacyLabel, open: propOpen, onOpenChange, showPortfolio, portfolioTitle, showTotalAssets, totalAssetsLabel, sendTransaction, getTransactionReceipt, estimateGas, onOutlink, lpBalanceReader, bridgeTokens, bridgeHistory, getBridgeQuote, getBridgeToTokens, getBridgeApproval, approveBridge, submitBridge, onReceive, onBridge, onSend, style, children, }: WalletInfoProps): react_jsx_runtime.JSX.Element;
 declare const WalletInfo: typeof WalletInfoRoot & {
     Trigger: typeof WalletInfoTrigger;
     Content: typeof WalletInfoContent;
@@ -723,9 +961,14 @@ interface WalletPortfolioProps {
      * 반환값으로 URL 변형 / 취소가 가능하며 async도 지원한다.
      */
     onOutlink?: OnOutlink;
+    /**
+     * game-swap LP 섹션이 사용자별 LP 잔고/지분율을 온체인에서 보강하기 위해
+     * host(wagmi 보유 측)로부터 주입받는 reader. 미주입 시 풀 정보만 표시한다.
+     */
+    lpBalanceReader?: LpBalanceReaderFn;
     children: React.ReactNode;
 }
-declare function WalletPortfolioRoot({ env, theme, walletAddress, open: propOpen, onOpenChange, onOutlink, children, }: WalletPortfolioProps): react_jsx_runtime.JSX.Element;
+declare function WalletPortfolioRoot({ env, theme, walletAddress, open: propOpen, onOpenChange, onOutlink, lpBalanceReader, children, }: WalletPortfolioProps): react_jsx_runtime.JSX.Element;
 declare const WalletPortfolio: typeof WalletPortfolioRoot & {
     Trigger: typeof WalletPortfolioTrigger;
     Content: typeof WalletPortfolioContent;
@@ -735,10 +978,7 @@ interface WalletPortfolioBodyProps {
     env?: Environment;
     theme?: Theme;
     walletAddress: string;
-    /**
-     * 헤더 좌측 아바타 옆에 표시할 지갑 이름 (예: "Account 1").
-     * 전달되지 않으면 텍스트는 숨겨지고 아바타만 표시된다.
-     */
+    /** @deprecated Portfolio header now follows the renewed fixed title design. */
     walletName?: string;
     /** 왼쪽 상단 back 버튼 클릭 핸들러. 없으면 back 버튼 숨김. */
     onBack?: () => void;
@@ -757,8 +997,13 @@ interface WalletPortfolioBodyProps {
      * 반환값으로 URL 변형 / 취소가 가능하며 async도 지원한다.
      */
     onOutlink?: OnOutlink;
+    /**
+     * game-swap LP 섹션이 사용자별 LP 잔고/지분율을 온체인에서 보강하기 위해
+     * host(wagmi 보유 측)로부터 주입받는 reader. 미주입 시 풀 정보만 표시한다.
+     */
+    lpBalanceReader?: LpBalanceReaderFn;
 }
-declare function WalletPortfolioBody({ env, theme, walletAddress, walletName, onBack, showHeader, variant, className, onOutlink, }: WalletPortfolioBodyProps): react_jsx_runtime.JSX.Element;
+declare function WalletPortfolioBody({ env, theme, walletAddress, onBack, showHeader, variant, className, onOutlink, lpBalanceReader, }: WalletPortfolioBodyProps): react_jsx_runtime.JSX.Element;
 
 declare function CROSSxIcon(): react_jsx_runtime.JSX.Element;
 declare function MetaMaskIcon(): react_jsx_runtime.JSX.Element;
@@ -834,17 +1079,14 @@ declare const SOCIAL_REGISTRY: {
 };
 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-primary"?: string;
-    "--wcm-secondary"?: string;
-    "--wcm-surface-bg"?: string;
-    "--wcm-surface-default"?: string;
-    "--wcm-surface-subtle"?: string;
-    "--wcm-border-default"?: string;
-    "--wcm-border-subtle"?: string;
-    "--wcm-texticon-primary"?: string;
-    "--wcm-texticon-secondary"?: string;
-    "--wcm-texticon-tertiary"?: string;
     "--wcm-dialog-width"?: string;
     "--wcm-drawer-max-width"?: string;
     "--wcm-drawer-min-width"?: string;
@@ -942,10 +1184,13 @@ interface ConnectButtonStyle extends CSSProperties {
     "--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;
@@ -960,6 +1205,7 @@ interface ConnectButtonStyle extends CSSProperties {
     "--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;
@@ -1012,6 +1258,14 @@ interface ConnectButtonProps {
     onCopy?: () => void;
     /** 지갑 변경 chevron 클릭 핸들러. 지정하지 않으면 chevron이 숨김 처리된다. */
     onSelectWallet?: () => void;
+    /** WalletInfo 기본 액션 row의 Buy 클릭 핸들러. */
+    onBuy?: () => void;
+    /**
+     * Buy 카드를 시각적으로 비활성 상태로 표시하고, 사용자가 클릭하면 이 메시지를
+     * 토스트로 띄운다. `onBuy`보다 우선. WalletInfoProps의 동일 prop으로 그대로
+     * 전달된다.
+     */
+    onBuyDisabledMessage?: string;
     /**
      * disconnected 버튼 라벨. 기본 'Connect Wallet'.
      * 문자열 외에 ReactNode를 넘겨 아이콘-only / 커스텀 마크업을 렌더할 수 있다
@@ -1054,6 +1308,20 @@ interface ConnectButtonProps {
      * Est. Tx Fee / Gas Limit / Max. Total Amount 행이 "—"로 표시된다.
      */
     estimateGas?: EstimateGasFn;
+    /**
+     * 상단 QR 버튼 / 기본 액션 row의 Bridge / Send 콜백. (Buy는 위 onBuy로
+     * 정의됨.) Bridge는 미주입 시 WalletInfo 내장 Bridge 화면으로 진입한다.
+     */
+    onReceive?: () => void;
+    onBridge?: () => void;
+    onSend?: () => void;
+    bridgeTokens?: BridgeToken[];
+    bridgeHistory?: BridgeHistoryItem[];
+    getBridgeQuote?: BridgeQuoteFn;
+    getBridgeToTokens?: BridgeGetToTokensFn;
+    getBridgeApproval?: BridgeGetApprovalFn;
+    approveBridge?: BridgeApproveFn;
+    submitBridge?: BridgeSubmitFn;
 }
 
 /**
@@ -1068,7 +1336,7 @@ interface ConnectButtonProps {
  * 상태/데이터/콜백은 props로 주입받는다. 실제 wagmi 연결 로직은
  * `@nexus-cross/connect-kit-react`의 상위 래퍼에서 수행한다.
  */
-declare function ConnectButton({ isConnecting, address, provider, providerName, accountName, sendAccounts, onConnect, onDisconnect, onCopy, onSelectWallet, label, connectingLabel, disconnectLabel, className, theme, env, showBalance, showPortfolio, drawerDirection, modal, connectorId, style, walletInfoStyle, sendTransaction, getTransactionReceipt, estimateGas, }: ConnectButtonProps): react_jsx_runtime.JSX.Element;
+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
@@ -1154,4 +1422,4 @@ interface SkillsButtonProps {
 declare const DEFAULT_SKILLS_HREF = "https://skills.cross.nexus";
 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, BINANCE_ICON, CONNECTOR_REGISTRY, CROSSX_ICON, type ChainId, ConnectButton, type ConnectButtonProps, type ConnectButtonStyle, ConnectorId, type ConnectorMeta, DEFAULT_SKILLS_HREF, type DrawerDirection$1 as DrawerDirection, type Environment, type EstimateGasArgs, type EstimateGasFn, GOOGLE_ICON, type GasEstimate, type GetTransactionReceiptArgs, type GetTransactionReceiptFn, type GlobalMenu, type GlobalMenuItem, type GlobalMenuItemUrl, METAMASK_ICON, type OnOutlink, type OutlinkCategory, type OutlinkContext, type OutlinkOrigin, type PreferredToken, type RecentSendAddress, SOCIAL_REGISTRY, type SendAccount, type SendAsset, SendPage, type SendPageProps, type SendStatus, type SendTransactionArgs, type SendTransactionFn, SkillsButton, type SkillsButtonProps, type SkillsButtonStyle, type SocialConfig, type SocialHandlers, type SocialId, TOKEN_STATS_QUERY_KEY, type Theme, type TokenBalance, type TokenBalanceResponse, type TokenStats, type TokenStatsResponse, type TransactionReceiptResult, USER_BALANCE_QUERY_KEY, WALLET_REGISTRY, 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, resolveEnvironment, useGlobalMenu, 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, CONNECTOR_REGISTRY, CROSSX_ICON, type ChainId, ConnectButton, type ConnectButtonProps, type ConnectButtonStyle, ConnectorId, type ConnectorMeta, DEFAULT_SKILLS_HREF, type DrawerDirection$1 as DrawerDirection, type Environment, type EstimateGasArgs, type EstimateGasFn, GOOGLE_ICON, type GameSwapPool, type GameSwapTokenRef, type GasEstimate, type GetTransactionReceiptArgs, type GetTransactionReceiptFn, type GlobalMenu, type GlobalMenuItem, type GlobalMenuItemUrl, type LpBalanceInfo, type LpBalanceReaderFn, METAMASK_ICON, type OnOutlink, type OutlinkCategory, type OutlinkContext, type OutlinkOrigin, type PreferredToken, type RecentSendAddress, SOCIAL_REGISTRY, type SendAccount, type SendAsset, SendFlow, type SendFlowProps, type SendPageProps, type SendStatus, type SendTransactionArgs, type SendTransactionFn, SkillsButton, type SkillsButtonProps, type SkillsButtonStyle, type SocialConfig, type SocialHandlers, type SocialId, TOKEN_STATS_QUERY_KEY, type Theme, type TokenBalance, type TokenBalanceResponse, type TokenStats, type TokenStatsResponse, type TransactionReceiptResult, USER_BALANCE_QUERY_KEY, WALLET_REGISTRY, 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, announceAppLauncherUsage, resolveEnvironment, useGlobalMenu, useTokenBalance, useTokenStats, useWalletDetect };