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

package/dist/index.d.cts

@@ -8,6 +8,19 @@ import { QueryClient, UseQueryOptions } from '@tanstack/react-query';
 type Environment = "dev" | "stage" | "production";
 type Theme = "dark" | "light";
 type DrawerDirection$1 = "right" | "bottom" | "left";
+/**
+ * CAIP-2 체인 식별자 (`"eip155:612055"`). 자산 목록과 운영 설정이 체인을
+ * 가리키는 형식이다.
+ *
+ * `eip155` 이외 namespace(`solana:`·`bip122:` 등)를 **지금 지원하지는 않는다** —
+ * 만나면 걸러내고 경고한다(`features/networks.md` AC-13). 그럼에도 식별자
+ * 자체는 좁히지 않는다: 조회 목록은 운영이 편집하는 published JSON 이 정본이라,
+ * 형식을 십진수로 굳혀 두면 나중에 namespace 를 열 때 파일과 코드를 동시에
+ * 갈아야 한다. 자리를 비워 두는 쪽이 싸다 (`context/decisions/0009`).
+ */
+type ChainId = `${string}:${string}`;
+/** EVM 전용 경로가 좁혀 쓰는 CAIP-2 식별자. */
+type EvmChainId = `eip155:${number}`;
 
 declare function resolveEnvironment(env?: Environment | "staging" | "prd" | "prod" | "stg"): Environment;
 
@@ -38,6 +51,8 @@ type AppsConfig = {
             swap?: boolean;
             bridge?: boolean;
             transferCrypto?: boolean;
+            /** Stake ONEUSD into the sONEUSD vault. Opt-in like Transfer Crypto. */
+            stake?: boolean;
         };
         /**
          * 액션별 최소 dapp-ui 버전. 호스트가 설치한 dapp-ui 가 이 값보다 낮으면
@@ -49,6 +64,7 @@ type AppsConfig = {
             swap?: string;
             bridge?: string;
             transferCrypto?: string;
+            stake?: string;
         };
     };
     /**
@@ -127,17 +143,27 @@ type AppsConfig = {
     };
 };
 declare const CHAINS_CONFIG_FILE = "chains.json";
-/** 체인 하나의 표시 메타. 지정 안 된 필드는 호출부 폴백(온체인/하드코딩)으로. */
+/** 체인 하나의 메타. 지정 안 된 필드는 호출부 폴백(온체인/하드코딩)으로. */
 type ChainDisplayMeta = {
     /** 체인 표시명 (예: 'One Mainnet'). */
     name?: string;
     /** 네이티브 통화 표시 심볼 (예: 'ONE' / 'tONE'). DISPLAY 전용. */
     nativeSymbol?: string;
+    /**
+     * WalletInfo 자산 목록에서 이 체인의 잔고를 조회할지. 지정 안 하면 조회하지
+     * 않는다 — 표시 메타만 필요한 체인(전환 UI 등)이 조회 대상이 되지 않게.
+     */
+    balance?: boolean;
 };
-/** chains.json 스키마 — chainId(10진 문자열) → 표시 메타. */
+/** chains.json 스키마 — CAIP-2(또는 10진) chainId → 체인 메타. */
 type ChainsConfig = {
     chains?: Record<string, ChainDisplayMeta>;
 };
+/**
+ * chains.json 의 `chains` 맵에서 한 체인의 메타를 꺼낸다. CAIP-2 키를
+ * 먼저 보고, 없으면 십진수 키로 폴백한다 — 두 형태가 공존한다.
+ */
+declare function selectChainMeta(chains: Record<string, ChainDisplayMeta> | undefined, chainId: number): ChainDisplayMeta;
 /**
  * chains.json에서 특정 chainId의 표시 메타를 비동기로 반환한다.
  * fetch 실패·미정의면 `{}` — 호출부에서 `?? 폴백`으로 처리.
@@ -151,9 +177,12 @@ declare function getChainDisplay(chainId: number, env: Environment): Promise<Cha
  */
 declare function useChainDisplay(chainId: number | undefined, env: Environment): ChainDisplayMeta;
 /**
- * chains.json의 전체 chainId→표시 메타 맵을 구독한다. 여러 체인의 표시명을
+ * chains.json의 전체 chainId→체인 메타 맵을 구독한다. 여러 체인의 표시명을
  * 한 번에 매핑해야 하는 곳(네트워크 스위처 등)에서 사용한다. 로딩 전/실패 시
- * 빈 객체 — 호출부에서 `map[String(id)]?.name ?? 폴백`으로 처리한다.
+ * 빈 객체다.
+ *
+ * 키는 CAIP-2 와 십진수가 공존하므로 **`selectChainMeta(map, id)` 로 꺼낸다** —
+ * `map[String(id)]` 로 직접 읽으면 CAIP-2 로 적힌 항목을 놓친다.
  */
 declare function useChainsConfig(env: Environment): Record<string, ChainDisplayMeta>;
 
@@ -301,8 +330,6 @@ declare function AppLauncherContent({ align, sideOffset, className, }: AppLaunch
 
 declare function useGlobalMenu(env?: Environment): _tanstack_react_query.UseQueryResult<GlobalMenu, Error>;
 
-/** CAIP-2 chain identifier (e.g. "eip155:612044") */
-type ChainId = `eip155:${number}`;
 declare enum ConnectorId {
     CROSSx = "crossx",
     MetaMask = "io.metamask",
@@ -2574,7 +2601,7 @@ declare function StatusTracker({ orderId, order, error }: StatusTrackerProps): r
  * the old ones. */
 declare const DEFAULT_TRUSTED_FACTORIES: readonly string[];
 
-type GetOneUsdActionId = "swap" | "bridge" | "transfer";
+type GetOneUsdActionId = "swap" | "bridge" | "transfer" | "stake";
 type GetOneUsdMode = "floating" | "button";
 type GetOneUsdButtonComponent = ElementType<ButtonHTMLAttributes<HTMLButtonElement>>;
 type GetOneUsdWaitForTransaction = (info: BridgeSubmittedInfo) => Promise<void>;
@@ -2595,6 +2622,23 @@ interface GetOneUsdPairs {
 }
 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">;
+/**
+ * Stake (ONEUSD → sONEUSD vault) configuration and wallet ports. Every port is
+ * optional here because the same capabilities are usually already injected via
+ * `relay` — a missing port falls back to the matching `relay` one. The action
+ * is hidden when, after that fallback, `readContract`/`writeContract` are still
+ * missing or the environment has no vault address.
+ */
+interface GetOneUsdStakeProps {
+    /** ERC-4626 sONEUSD vault. Built-in per-environment address when omitted. */
+    vaultAddress?: string;
+    /** Wallet's active chain; a stake switches chain first when it differs. */
+    walletChainId?: number;
+    readContract?: ReadContractFn;
+    writeContract?: WriteContractFn;
+    switchChain?: SwitchChainFn;
+    waitForReceipt?: WaitForReceiptFn;
+}
 type GetOneUsdEvent = {
     name: "fab_click";
     state: "expanded" | "icon_only";
@@ -2626,6 +2670,8 @@ interface GetOneUsdProps {
     bridge: GetOneUsdBridgeProps;
     /** Relay configuration and low-level wallet ports. Built-in env URL is used when omitted. */
     relay?: GetOneUsdRelayProps;
+    /** Stake vault override and wallet ports. Falls back to `relay` ports when omitted. */
+    stake?: GetOneUsdStakeProps;
     env?: Environment;
     targetSymbol?: string;
     /** Relay catalog delivery symbol. Defaults to the canonical `ONEUSD`. */
@@ -2666,13 +2712,14 @@ interface ResolvedGetOneUsdRoute {
     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;
+declare function GetOneUsd({ walletAddress, tokens, pairs, loading, bridge, relay, stake, 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"]>;
 /**
  * 목록에 보일지 여부. Swap/Bridge stay enabled when config is unavailable.
  * Transfer Crypto is opt-in and stays hidden until S3 explicitly enables it.
+ * Swap/Bridge/Stake stay visible when config is unavailable.
  */
 declare function isGetOneUsdActionVisible(action: GetOneUsdActionId, modes?: GetOneUsdRemoteModes): boolean;
 /**
@@ -3119,4 +3166,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 OnePopActivityDirection, type OnePopActivityItem, type OnePopActivityStatus, OnePopBody, type OnePopBodyProps, OnePopGetTokenTrigger, 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_PORTFOLIO_QUERY_PREFIX, 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, invalidateWalletPortfolioQueries, 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, type EvmChainId, 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 GetOneUsdStakeProps, 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, OnePopGetTokenTrigger, 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_PORTFOLIO_QUERY_PREFIX, 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, invalidateWalletPortfolioQueries, isGetOneUsdActionEnabled, isGetOneUsdActionSupported, isGetOneUsdActionVisible, isGetOneUsdTargetAvailable, matchesGetOneUsdToken, normalizeFailureReason, resolveEnvironment, resolveGetOneUsdRoute, selectChainMeta, setDappUiAnalyticsUser, trackDappUiEvent, trackDappUiFunnel, useChainDisplay, useChainsConfig, useGlobalMenu, useRelayConfig, useRelayOrders, useRelayRecovery, useTokenBalance, useTokenStats, useWalletDetect };

package/dist/index.d.ts

@@ -8,6 +8,19 @@ import { QueryClient, UseQueryOptions } from '@tanstack/react-query';
 type Environment = "dev" | "stage" | "production";
 type Theme = "dark" | "light";
 type DrawerDirection$1 = "right" | "bottom" | "left";
+/**
+ * CAIP-2 체인 식별자 (`"eip155:612055"`). 자산 목록과 운영 설정이 체인을
+ * 가리키는 형식이다.
+ *
+ * `eip155` 이외 namespace(`solana:`·`bip122:` 등)를 **지금 지원하지는 않는다** —
+ * 만나면 걸러내고 경고한다(`features/networks.md` AC-13). 그럼에도 식별자
+ * 자체는 좁히지 않는다: 조회 목록은 운영이 편집하는 published JSON 이 정본이라,
+ * 형식을 십진수로 굳혀 두면 나중에 namespace 를 열 때 파일과 코드를 동시에
+ * 갈아야 한다. 자리를 비워 두는 쪽이 싸다 (`context/decisions/0009`).
+ */
+type ChainId = `${string}:${string}`;
+/** EVM 전용 경로가 좁혀 쓰는 CAIP-2 식별자. */
+type EvmChainId = `eip155:${number}`;
 
 declare function resolveEnvironment(env?: Environment | "staging" | "prd" | "prod" | "stg"): Environment;
 
@@ -38,6 +51,8 @@ type AppsConfig = {
             swap?: boolean;
             bridge?: boolean;
             transferCrypto?: boolean;
+            /** Stake ONEUSD into the sONEUSD vault. Opt-in like Transfer Crypto. */
+            stake?: boolean;
         };
         /**
          * 액션별 최소 dapp-ui 버전. 호스트가 설치한 dapp-ui 가 이 값보다 낮으면
@@ -49,6 +64,7 @@ type AppsConfig = {
             swap?: string;
             bridge?: string;
             transferCrypto?: string;
+            stake?: string;
         };
     };
     /**
@@ -127,17 +143,27 @@ type AppsConfig = {
     };
 };
 declare const CHAINS_CONFIG_FILE = "chains.json";
-/** 체인 하나의 표시 메타. 지정 안 된 필드는 호출부 폴백(온체인/하드코딩)으로. */
+/** 체인 하나의 메타. 지정 안 된 필드는 호출부 폴백(온체인/하드코딩)으로. */
 type ChainDisplayMeta = {
     /** 체인 표시명 (예: 'One Mainnet'). */
     name?: string;
     /** 네이티브 통화 표시 심볼 (예: 'ONE' / 'tONE'). DISPLAY 전용. */
     nativeSymbol?: string;
+    /**
+     * WalletInfo 자산 목록에서 이 체인의 잔고를 조회할지. 지정 안 하면 조회하지
+     * 않는다 — 표시 메타만 필요한 체인(전환 UI 등)이 조회 대상이 되지 않게.
+     */
+    balance?: boolean;
 };
-/** chains.json 스키마 — chainId(10진 문자열) → 표시 메타. */
+/** chains.json 스키마 — CAIP-2(또는 10진) chainId → 체인 메타. */
 type ChainsConfig = {
     chains?: Record<string, ChainDisplayMeta>;
 };
+/**
+ * chains.json 의 `chains` 맵에서 한 체인의 메타를 꺼낸다. CAIP-2 키를
+ * 먼저 보고, 없으면 십진수 키로 폴백한다 — 두 형태가 공존한다.
+ */
+declare function selectChainMeta(chains: Record<string, ChainDisplayMeta> | undefined, chainId: number): ChainDisplayMeta;
 /**
  * chains.json에서 특정 chainId의 표시 메타를 비동기로 반환한다.
  * fetch 실패·미정의면 `{}` — 호출부에서 `?? 폴백`으로 처리.
@@ -151,9 +177,12 @@ declare function getChainDisplay(chainId: number, env: Environment): Promise<Cha
  */
 declare function useChainDisplay(chainId: number | undefined, env: Environment): ChainDisplayMeta;
 /**
- * chains.json의 전체 chainId→표시 메타 맵을 구독한다. 여러 체인의 표시명을
+ * chains.json의 전체 chainId→체인 메타 맵을 구독한다. 여러 체인의 표시명을
  * 한 번에 매핑해야 하는 곳(네트워크 스위처 등)에서 사용한다. 로딩 전/실패 시
- * 빈 객체 — 호출부에서 `map[String(id)]?.name ?? 폴백`으로 처리한다.
+ * 빈 객체다.
+ *
+ * 키는 CAIP-2 와 십진수가 공존하므로 **`selectChainMeta(map, id)` 로 꺼낸다** —
+ * `map[String(id)]` 로 직접 읽으면 CAIP-2 로 적힌 항목을 놓친다.
  */
 declare function useChainsConfig(env: Environment): Record<string, ChainDisplayMeta>;
 
@@ -301,8 +330,6 @@ declare function AppLauncherContent({ align, sideOffset, className, }: AppLaunch
 
 declare function useGlobalMenu(env?: Environment): _tanstack_react_query.UseQueryResult<GlobalMenu, Error>;
 
-/** CAIP-2 chain identifier (e.g. "eip155:612044") */
-type ChainId = `eip155:${number}`;
 declare enum ConnectorId {
     CROSSx = "crossx",
     MetaMask = "io.metamask",
@@ -2574,7 +2601,7 @@ declare function StatusTracker({ orderId, order, error }: StatusTrackerProps): r
  * the old ones. */
 declare const DEFAULT_TRUSTED_FACTORIES: readonly string[];
 
-type GetOneUsdActionId = "swap" | "bridge" | "transfer";
+type GetOneUsdActionId = "swap" | "bridge" | "transfer" | "stake";
 type GetOneUsdMode = "floating" | "button";
 type GetOneUsdButtonComponent = ElementType<ButtonHTMLAttributes<HTMLButtonElement>>;
 type GetOneUsdWaitForTransaction = (info: BridgeSubmittedInfo) => Promise<void>;
@@ -2595,6 +2622,23 @@ interface GetOneUsdPairs {
 }
 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">;
+/**
+ * Stake (ONEUSD → sONEUSD vault) configuration and wallet ports. Every port is
+ * optional here because the same capabilities are usually already injected via
+ * `relay` — a missing port falls back to the matching `relay` one. The action
+ * is hidden when, after that fallback, `readContract`/`writeContract` are still
+ * missing or the environment has no vault address.
+ */
+interface GetOneUsdStakeProps {
+    /** ERC-4626 sONEUSD vault. Built-in per-environment address when omitted. */
+    vaultAddress?: string;
+    /** Wallet's active chain; a stake switches chain first when it differs. */
+    walletChainId?: number;
+    readContract?: ReadContractFn;
+    writeContract?: WriteContractFn;
+    switchChain?: SwitchChainFn;
+    waitForReceipt?: WaitForReceiptFn;
+}
 type GetOneUsdEvent = {
     name: "fab_click";
     state: "expanded" | "icon_only";
@@ -2626,6 +2670,8 @@ interface GetOneUsdProps {
     bridge: GetOneUsdBridgeProps;
     /** Relay configuration and low-level wallet ports. Built-in env URL is used when omitted. */
     relay?: GetOneUsdRelayProps;
+    /** Stake vault override and wallet ports. Falls back to `relay` ports when omitted. */
+    stake?: GetOneUsdStakeProps;
     env?: Environment;
     targetSymbol?: string;
     /** Relay catalog delivery symbol. Defaults to the canonical `ONEUSD`. */
@@ -2666,13 +2712,14 @@ interface ResolvedGetOneUsdRoute {
     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;
+declare function GetOneUsd({ walletAddress, tokens, pairs, loading, bridge, relay, stake, 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"]>;
 /**
  * 목록에 보일지 여부. Swap/Bridge stay enabled when config is unavailable.
  * Transfer Crypto is opt-in and stays hidden until S3 explicitly enables it.
+ * Swap/Bridge/Stake stay visible when config is unavailable.
  */
 declare function isGetOneUsdActionVisible(action: GetOneUsdActionId, modes?: GetOneUsdRemoteModes): boolean;
 /**
@@ -3119,4 +3166,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 OnePopActivityDirection, type OnePopActivityItem, type OnePopActivityStatus, OnePopBody, type OnePopBodyProps, OnePopGetTokenTrigger, 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_PORTFOLIO_QUERY_PREFIX, 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, invalidateWalletPortfolioQueries, 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, type EvmChainId, 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 GetOneUsdStakeProps, 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, OnePopGetTokenTrigger, 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_PORTFOLIO_QUERY_PREFIX, 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, invalidateWalletPortfolioQueries, isGetOneUsdActionEnabled, isGetOneUsdActionSupported, isGetOneUsdActionVisible, isGetOneUsdTargetAvailable, matchesGetOneUsdToken, normalizeFailureReason, resolveEnvironment, resolveGetOneUsdRoute, selectChainMeta, setDappUiAnalyticsUser, trackDappUiEvent, trackDappUiFunnel, useChainDisplay, useChainsConfig, useGlobalMenu, useRelayConfig, useRelayOrders, useRelayRecovery, useTokenBalance, useTokenStats, useWalletDetect };