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

package/dist/index.d.cts

@@ -946,6 +946,105 @@ interface BridgeFlowProps {
 }
 declare function BridgeFlow({ onClose, onBackToWallet, feeDelegated, env, variant, title: titleProp, isConnected: isConnectedProp, onRequestConnect, className, ...rest }: BridgeFlowProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * ONEpop (소셜 핸들 드롭) 진입 화면의 표시 계약.
+ *
+ * dapp-ui는 순수 UI 레이어라 `@nexus-cross/pop`(viem 필수)에 의존할 수 없다
+ * (CLAUDE.md §3, docs/pop/03-integration.md). 따라서 이 화면은 **랜딩/진입
+ * UI만** 담당하고, 조회(one-pop-api `/drops`·`/histories` — SIWE JWT + X 연결
+ * 필요)와 실제 deposit/withdraw는 호스트가 `@nexus-cross/pop`으로 수행해
+ * 결과만 `OnePopSummary`로 주입한다. on-ramp(`@nexus-cross/onramp` → `onBuy`)와
+ * 동일한 주입 구조다.
+ */
+/** 활동 행 우측 배지. 디자인의 Claimed / Waiting / Refunded / Ready. */
+type OnePopActivityStatus = "claimed" | "waiting" | "refunded" | "ready";
+/** 활동 행의 자금 방향. `sent`="Sent to @x", `received`="Claimed from @x". */
+type OnePopActivityDirection = "sent" | "received";
+interface OnePopActivityItem {
+    /** React key 및 중복 제거용 고유 값. 보통 `${txHash}-${logIndex}`. */
+    id: string;
+    direction: OnePopActivityDirection;
+    /** 상대 소셜 핸들. `@` 없이 넘기면 UI가 붙인다. */
+    handle: string;
+    /** 상대 프로필 이미지. 없으면 이니셜 아바타로 대체된다. */
+    avatarUrl?: string;
+    /**
+     * 금액 (raw wei-scale 10진 문자열). `decimals`와 함께 UI에서 소수점 2자리
+     * **버림**으로 표기한다 — Number 변환 없이 BigInt로만 다룬다 (CLAUDE.md §4).
+     */
+    amountRaw: string;
+    /** `amountRaw`의 소수 자릿수. */
+    decimals: number;
+    /** 이벤트 시각 (unix epoch, 초 또는 밀리초). 상대시간 표기에 쓴다. */
+    timestamp: number;
+    status: OnePopActivityStatus;
+}
+/**
+ * ONEpop 화면이 그리는 상태 전부. 미주입(`undefined`)이면 "내역 없음" 화면을
+ * 그린다 — 조회 실패/미연동 상태에서도 진입 UI는 항상 동작한다.
+ */
+interface OnePopSummary {
+    /** 수령 대기 중인 드롭 수. 0이면 클레임 배너를 그리지 않는다. */
+    claimableCount: number;
+    /** 수령 대기 합계 (raw wei-scale). `claimableDecimals`와 함께 쓴다. */
+    claimableTotalRaw: string;
+    /** `claimableTotalRaw`의 소수 자릿수. 기본 18. */
+    claimableDecimals: number;
+    /**
+     * "N replies waiting" 배너의 카운트. 백엔드 계약(one-pop-api)에 대응 개념이
+     * 아직 없어 **숫자만** 받는다 — 의미 해석과 조회는 주입측 책임이다.
+     * 0이면 배너를 그리지 않는다.
+     */
+    repliesWaitingCount: number;
+    /** 최근 활동. 비어 있으면 3개 소개 항목(빈 상태)을 대신 그린다. */
+    activity: OnePopActivityItem[];
+    /**
+     * 활성 X 연결 여부 (one-pop-api `/x-connections`). Activity 버튼은 X 연결이
+     * 있어야 의미가 있으므로(수신 내역이 핸들 기준) true일 때만 렌더한다.
+     * 미주입(undefined)이면 미연결로 취급해 숨긴다.
+     */
+    xConnected?: boolean;
+    /** 조회 진행 중이면 배너/리스트 자리에 스켈레톤을 그린다. */
+    isLoading?: boolean;
+}
+
+interface OnePopBodyProps {
+    /** ONEpop 서비스 웹 딥링크의 환경. 미지정 시 production. */
+    env?: Environment;
+    /** Available 카드에 표시할 ONEUSD 잔액 (표시용 포맷 완료 문자열). */
+    balanceDisplay?: string;
+    /** Available 카드의 토큰 아이콘. 미지정 시 아이콘 자리를 비운다. */
+    balanceIconUrl?: string;
+    /** 잔액 조회 중이면 스켈레톤. */
+    isBalanceLoading?: boolean;
+    /** 호스트가 `@nexus-cross/pop`으로 조회해 주입하는 상태. 미주입 = 빈 상태. */
+    summary?: OnePopSummary;
+    /** 브랜드 워드마크 이미지. 미지정 시 인라인 SVG 재현본. */
+    logoSrc?: string;
+    /** 히어로 일러스트 이미지. 미지정 시 인라인 SVG 재현본. */
+    heroSrc?: string;
+    onBack: () => void;
+    onClose: () => void;
+    /**
+     * Send POP 카드 + "Send your first POP!" CTA override. 미주입 시 ONEpop 웹
+     * 센드 페이지(`/pop`)를 새 탭으로 연다. 다른 액션도 같은 규칙 — 전부 서비스
+     * 페이지 이동이라 disabled 상태가 없다.
+     */
+    onSend?: () => void;
+    /** Claim POPs 카드 + 클레임 배너 override. 기본 `/pop/claim`. */
+    onClaim?: () => void;
+    /**
+     * Activity 카드 + "See all activity" override. 기본 `/pop/activity`.
+     * Activity 카드는 `summary.xConnected` 가 true 일 때만 렌더된다.
+     */
+    onActivity?: () => void;
+    /** "You might have POPs waiting" 배너 override. 기본 `/pop/board`. */
+    onBoard?: () => void;
+    /** "Get ONEUSD ›" override. 기본 게임토큰 브리지(`/gametoken/bridge`). */
+    onGetToken?: () => void;
+}
+declare function OnePopBody({ env, balanceDisplay, balanceIconUrl, isBalanceLoading, summary, logoSrc, heroSrc, onBack, onClose, onSend, onClaim, onActivity, onBoard, onGetToken, }: OnePopBodyProps): react_jsx_runtime.JSX.Element;
+
 interface WalletInfoTriggerProps {
     asChild?: boolean;
     className?: string;
@@ -1055,6 +1154,41 @@ interface WalletInfoProps {
      * true면 기본 액션 row에 Portfolio 버튼이 표시되며, 클릭 시 내부 Portfolio 뷰로 전환됩니다.
      */
     showPortfolio?: boolean;
+    /**
+     * ONEpop 사용 여부 (기본 **false** — 서비스 오픈 전 딥링크가 죽은 링크가
+     * 되지 않도록 opt-in). true면 기본 액션 row에 ONEpop 버튼이 표시되며,
+     * 클릭 시 내부 ONEpop 뷰로 전환된다. 뷰는 순수 UI라 아래 데이터/콜백이
+     * 없어도 렌더된다 — 액션 버튼은 전부 ONEpop 서비스 딥링크가 기본 동작이다.
+     * connect-kit-react 경유라면 config `onePopEnabled: true` 하나로 노출과
+     * 조회가 함께 켜진다.
+     */
+    showOnePop?: boolean;
+    /**
+     * ONEpop 뷰가 표시할 상태(수령 대기 수/합계, replies 카운트, 최근 활동).
+     *
+     * dapp-ui는 `@nexus-cross/pop`(viem 필수)에 의존할 수 없으므로 one-pop-api를
+     * 직접 조회하지 않는다 — `/drops`·`/histories`는 SIWE JWT + X 연결이 필요해
+     * 서명 가능한 호스트가 조회한 뒤 이 prop 으로 주입한다.
+     * `@nexus-cross/connect-kit-react`를 쓰면 자동 주입된다.
+     * 미주입 시 "내역 없음" 온보딩 화면을 그린다.
+     */
+    onePopSummary?: OnePopSummary;
+    /**
+     * ONEpop 뷰 진입 시 1회 호출. `onePopSummary` 조회는 SIWE 서명(지갑 팝업)을
+     * 요구하므로, 주입측이 사용자가 실제로 ONEpop을 열 때까지 조회를 미루는
+     * 트리거로 쓴다.
+     */
+    onOnePopOpen?: () => void;
+    /** Send POP 카드 + "Send your first POP!" CTA. 미주입 시 비활성. */
+    onOnePopSend?: () => void;
+    /** Claim POPs 카드 + 수령 대기 배너. 미주입 시 비활성. */
+    onOnePopClaim?: () => void;
+    /** Activity 카드 + "See all activity" + replies 배너. 미주입 시 비활성. */
+    onOnePopActivity?: () => void;
+    /** ONEpop 워드마크 이미지 URL. 미지정 시 내장 SVG 재현본. */
+    onePopLogoSrc?: string;
+    /** ONEpop 히어로 일러스트 URL. 미지정 시 내장 SVG 재현본. */
+    onePopHeroSrc?: string;
     /** Portfolio 뷰의 헤더 타이틀 (기본 "My Portfolio"). */
     portfolioTitle?: string;
     /**
@@ -1121,7 +1255,7 @@ interface WalletInfoProps {
     style?: WalletInfoStyle;
     children: React.ReactNode;
 }
-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, onBridgeDisabledMessage, onSendDisabledMessage, onDisconnect, disconnectLabel, termsUrl, termsLabel, privacyUrl, privacyLabel, open: propOpen, onOpenChange, showPortfolio, portfolioTitle, portfolioSections, showTotalAssets, totalAssetsLabel, sendTransaction, getTransactionReceipt, estimateGas, onOutlink, lpBalanceReader, stakingRewardsReader, bridgeTokens, bridgeHistory, getBridgeQuote, getBridgeToTokens, getBridgeApproval, approveBridge, submitBridge, onReceive, onBridge, onSend, 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, onBridgeDisabledMessage, onSendDisabledMessage, onDisconnect, disconnectLabel, termsUrl, termsLabel, privacyUrl, privacyLabel, open: propOpen, onOpenChange, showPortfolio, showOnePop, onePopSummary, onOnePopOpen, onOnePopSend, onOnePopClaim, onOnePopActivity, onePopLogoSrc, onePopHeroSrc, portfolioTitle, portfolioSections, showTotalAssets, totalAssetsLabel, sendTransaction, getTransactionReceipt, estimateGas, onOutlink, lpBalanceReader, stakingRewardsReader, 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;
@@ -2884,4 +3018,4 @@ interface SkillsButtonProps {
 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, 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 };
+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 OnePopActivityDirection, type OnePopActivityItem, type OnePopActivityStatus, OnePopBody, type OnePopBodyProps, type OnePopSummary, 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 };

package/dist/index.d.ts

@@ -946,6 +946,105 @@ interface BridgeFlowProps {
 }
 declare function BridgeFlow({ onClose, onBackToWallet, feeDelegated, env, variant, title: titleProp, isConnected: isConnectedProp, onRequestConnect, className, ...rest }: BridgeFlowProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * ONEpop (소셜 핸들 드롭) 진입 화면의 표시 계약.
+ *
+ * dapp-ui는 순수 UI 레이어라 `@nexus-cross/pop`(viem 필수)에 의존할 수 없다
+ * (CLAUDE.md §3, docs/pop/03-integration.md). 따라서 이 화면은 **랜딩/진입
+ * UI만** 담당하고, 조회(one-pop-api `/drops`·`/histories` — SIWE JWT + X 연결
+ * 필요)와 실제 deposit/withdraw는 호스트가 `@nexus-cross/pop`으로 수행해
+ * 결과만 `OnePopSummary`로 주입한다. on-ramp(`@nexus-cross/onramp` → `onBuy`)와
+ * 동일한 주입 구조다.
+ */
+/** 활동 행 우측 배지. 디자인의 Claimed / Waiting / Refunded / Ready. */
+type OnePopActivityStatus = "claimed" | "waiting" | "refunded" | "ready";
+/** 활동 행의 자금 방향. `sent`="Sent to @x", `received`="Claimed from @x". */
+type OnePopActivityDirection = "sent" | "received";
+interface OnePopActivityItem {
+    /** React key 및 중복 제거용 고유 값. 보통 `${txHash}-${logIndex}`. */
+    id: string;
+    direction: OnePopActivityDirection;
+    /** 상대 소셜 핸들. `@` 없이 넘기면 UI가 붙인다. */
+    handle: string;
+    /** 상대 프로필 이미지. 없으면 이니셜 아바타로 대체된다. */
+    avatarUrl?: string;
+    /**
+     * 금액 (raw wei-scale 10진 문자열). `decimals`와 함께 UI에서 소수점 2자리
+     * **버림**으로 표기한다 — Number 변환 없이 BigInt로만 다룬다 (CLAUDE.md §4).
+     */
+    amountRaw: string;
+    /** `amountRaw`의 소수 자릿수. */
+    decimals: number;
+    /** 이벤트 시각 (unix epoch, 초 또는 밀리초). 상대시간 표기에 쓴다. */
+    timestamp: number;
+    status: OnePopActivityStatus;
+}
+/**
+ * ONEpop 화면이 그리는 상태 전부. 미주입(`undefined`)이면 "내역 없음" 화면을
+ * 그린다 — 조회 실패/미연동 상태에서도 진입 UI는 항상 동작한다.
+ */
+interface OnePopSummary {
+    /** 수령 대기 중인 드롭 수. 0이면 클레임 배너를 그리지 않는다. */
+    claimableCount: number;
+    /** 수령 대기 합계 (raw wei-scale). `claimableDecimals`와 함께 쓴다. */
+    claimableTotalRaw: string;
+    /** `claimableTotalRaw`의 소수 자릿수. 기본 18. */
+    claimableDecimals: number;
+    /**
+     * "N replies waiting" 배너의 카운트. 백엔드 계약(one-pop-api)에 대응 개념이
+     * 아직 없어 **숫자만** 받는다 — 의미 해석과 조회는 주입측 책임이다.
+     * 0이면 배너를 그리지 않는다.
+     */
+    repliesWaitingCount: number;
+    /** 최근 활동. 비어 있으면 3개 소개 항목(빈 상태)을 대신 그린다. */
+    activity: OnePopActivityItem[];
+    /**
+     * 활성 X 연결 여부 (one-pop-api `/x-connections`). Activity 버튼은 X 연결이
+     * 있어야 의미가 있으므로(수신 내역이 핸들 기준) true일 때만 렌더한다.
+     * 미주입(undefined)이면 미연결로 취급해 숨긴다.
+     */
+    xConnected?: boolean;
+    /** 조회 진행 중이면 배너/리스트 자리에 스켈레톤을 그린다. */
+    isLoading?: boolean;
+}
+
+interface OnePopBodyProps {
+    /** ONEpop 서비스 웹 딥링크의 환경. 미지정 시 production. */
+    env?: Environment;
+    /** Available 카드에 표시할 ONEUSD 잔액 (표시용 포맷 완료 문자열). */
+    balanceDisplay?: string;
+    /** Available 카드의 토큰 아이콘. 미지정 시 아이콘 자리를 비운다. */
+    balanceIconUrl?: string;
+    /** 잔액 조회 중이면 스켈레톤. */
+    isBalanceLoading?: boolean;
+    /** 호스트가 `@nexus-cross/pop`으로 조회해 주입하는 상태. 미주입 = 빈 상태. */
+    summary?: OnePopSummary;
+    /** 브랜드 워드마크 이미지. 미지정 시 인라인 SVG 재현본. */
+    logoSrc?: string;
+    /** 히어로 일러스트 이미지. 미지정 시 인라인 SVG 재현본. */
+    heroSrc?: string;
+    onBack: () => void;
+    onClose: () => void;
+    /**
+     * Send POP 카드 + "Send your first POP!" CTA override. 미주입 시 ONEpop 웹
+     * 센드 페이지(`/pop`)를 새 탭으로 연다. 다른 액션도 같은 규칙 — 전부 서비스
+     * 페이지 이동이라 disabled 상태가 없다.
+     */
+    onSend?: () => void;
+    /** Claim POPs 카드 + 클레임 배너 override. 기본 `/pop/claim`. */
+    onClaim?: () => void;
+    /**
+     * Activity 카드 + "See all activity" override. 기본 `/pop/activity`.
+     * Activity 카드는 `summary.xConnected` 가 true 일 때만 렌더된다.
+     */
+    onActivity?: () => void;
+    /** "You might have POPs waiting" 배너 override. 기본 `/pop/board`. */
+    onBoard?: () => void;
+    /** "Get ONEUSD ›" override. 기본 게임토큰 브리지(`/gametoken/bridge`). */
+    onGetToken?: () => void;
+}
+declare function OnePopBody({ env, balanceDisplay, balanceIconUrl, isBalanceLoading, summary, logoSrc, heroSrc, onBack, onClose, onSend, onClaim, onActivity, onBoard, onGetToken, }: OnePopBodyProps): react_jsx_runtime.JSX.Element;
+
 interface WalletInfoTriggerProps {
     asChild?: boolean;
     className?: string;
@@ -1055,6 +1154,41 @@ interface WalletInfoProps {
      * true면 기본 액션 row에 Portfolio 버튼이 표시되며, 클릭 시 내부 Portfolio 뷰로 전환됩니다.
      */
     showPortfolio?: boolean;
+    /**
+     * ONEpop 사용 여부 (기본 **false** — 서비스 오픈 전 딥링크가 죽은 링크가
+     * 되지 않도록 opt-in). true면 기본 액션 row에 ONEpop 버튼이 표시되며,
+     * 클릭 시 내부 ONEpop 뷰로 전환된다. 뷰는 순수 UI라 아래 데이터/콜백이
+     * 없어도 렌더된다 — 액션 버튼은 전부 ONEpop 서비스 딥링크가 기본 동작이다.
+     * connect-kit-react 경유라면 config `onePopEnabled: true` 하나로 노출과
+     * 조회가 함께 켜진다.
+     */
+    showOnePop?: boolean;
+    /**
+     * ONEpop 뷰가 표시할 상태(수령 대기 수/합계, replies 카운트, 최근 활동).
+     *
+     * dapp-ui는 `@nexus-cross/pop`(viem 필수)에 의존할 수 없으므로 one-pop-api를
+     * 직접 조회하지 않는다 — `/drops`·`/histories`는 SIWE JWT + X 연결이 필요해
+     * 서명 가능한 호스트가 조회한 뒤 이 prop 으로 주입한다.
+     * `@nexus-cross/connect-kit-react`를 쓰면 자동 주입된다.
+     * 미주입 시 "내역 없음" 온보딩 화면을 그린다.
+     */
+    onePopSummary?: OnePopSummary;
+    /**
+     * ONEpop 뷰 진입 시 1회 호출. `onePopSummary` 조회는 SIWE 서명(지갑 팝업)을
+     * 요구하므로, 주입측이 사용자가 실제로 ONEpop을 열 때까지 조회를 미루는
+     * 트리거로 쓴다.
+     */
+    onOnePopOpen?: () => void;
+    /** Send POP 카드 + "Send your first POP!" CTA. 미주입 시 비활성. */
+    onOnePopSend?: () => void;
+    /** Claim POPs 카드 + 수령 대기 배너. 미주입 시 비활성. */
+    onOnePopClaim?: () => void;
+    /** Activity 카드 + "See all activity" + replies 배너. 미주입 시 비활성. */
+    onOnePopActivity?: () => void;
+    /** ONEpop 워드마크 이미지 URL. 미지정 시 내장 SVG 재현본. */
+    onePopLogoSrc?: string;
+    /** ONEpop 히어로 일러스트 URL. 미지정 시 내장 SVG 재현본. */
+    onePopHeroSrc?: string;
     /** Portfolio 뷰의 헤더 타이틀 (기본 "My Portfolio"). */
     portfolioTitle?: string;
     /**
@@ -1121,7 +1255,7 @@ interface WalletInfoProps {
     style?: WalletInfoStyle;
     children: React.ReactNode;
 }
-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, onBridgeDisabledMessage, onSendDisabledMessage, onDisconnect, disconnectLabel, termsUrl, termsLabel, privacyUrl, privacyLabel, open: propOpen, onOpenChange, showPortfolio, portfolioTitle, portfolioSections, showTotalAssets, totalAssetsLabel, sendTransaction, getTransactionReceipt, estimateGas, onOutlink, lpBalanceReader, stakingRewardsReader, bridgeTokens, bridgeHistory, getBridgeQuote, getBridgeToTokens, getBridgeApproval, approveBridge, submitBridge, onReceive, onBridge, onSend, 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, onBridgeDisabledMessage, onSendDisabledMessage, onDisconnect, disconnectLabel, termsUrl, termsLabel, privacyUrl, privacyLabel, open: propOpen, onOpenChange, showPortfolio, showOnePop, onePopSummary, onOnePopOpen, onOnePopSend, onOnePopClaim, onOnePopActivity, onePopLogoSrc, onePopHeroSrc, portfolioTitle, portfolioSections, showTotalAssets, totalAssetsLabel, sendTransaction, getTransactionReceipt, estimateGas, onOutlink, lpBalanceReader, stakingRewardsReader, 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;
@@ -2884,4 +3018,4 @@ interface SkillsButtonProps {
 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, 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 };
+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 OnePopActivityDirection, type OnePopActivityItem, type OnePopActivityStatus, OnePopBody, type OnePopBodyProps, type OnePopSummary, 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 };