@nexus-cross/dapp-ui 1.1.0 → 1.1.1-beta.2

package/dist/index.d.cts

@@ -134,6 +134,36 @@ interface TransactionReceiptResult {
     status?: "success" | "reverted" | "0x1" | "0x0" | number | bigint | boolean;
 }
 type GetTransactionReceiptFn = (args: GetTransactionReceiptArgs) => Promise<TransactionReceiptResult | null | undefined>;
+/**
+ * Send 확인 단계에서 표시할 가스/수수료 추정 정보를 가져오는 콜백.
+ *
+ * Send 확인 화면 표기 정책 (crossy-sdk-js `docs/06-gas-fee.md` 기준):
+ * - `maxFeePerGas` 채움 → Dynamic(EIP-1559) 모드로 표기
+ *   · Est. Tx Fee = `gasLimit × maxFeePerGas` (native)
+ *   · Max Priority Fee = `maxPriorityFeePerGas` (Gwei)
+ *   · Max Gas Fee = `maxFeePerGas` (Gwei)
+ *   · Gas Limit = `gasLimit`
+ * - `gasPrice`만 채움 → Legacy 모드로 표기
+ *   · Est. Tx Fee = `gasLimit × gasPrice` (native)
+ *   · Gas Price = `gasPrice` (Gwei)
+ *   · Gas Limit = `gasLimit`
+ *
+ * 둘 다 채워지면 Dynamic 우선. 둘 다 비어있으면 해당 행은 "—"로 표시된다.
+ */
+interface EstimateGasArgs {
+    to: `0x${string}`;
+    value?: bigint;
+    data?: `0x${string}`;
+    chainId?: number;
+    from?: `0x${string}`;
+}
+interface GasEstimate {
+    gasLimit: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+}
+type EstimateGasFn = (args: EstimateGasArgs) => Promise<GasEstimate>;
 interface PoolToken {
     address: string;
     symbol: string;
@@ -320,7 +350,7 @@ interface SendAsset {
     };
     icon_url: string;
 }
-type SendStatus = "idle" | "submitting" | "confirming" | "success" | "error";
+type SendStatus = "idle" | "review" | "submitting" | "confirming" | "success" | "error";
 interface RecentSendAddress {
     address: `0x${string}`;
     updatedAt: number;
@@ -341,12 +371,17 @@ interface SendPageProps {
     onTokenChange?: (token: SendAsset) => void;
     sendTransaction?: SendTransactionFn;
     getTransactionReceipt?: GetTransactionReceiptFn;
+    /**
+     * 확인 단계에서 표시할 가스/수수료 추정 함수. 주입되지 않으면 Gas/Est.Time/Max.Gas 행은 "—"로 표시된다.
+     * 사용자가 Send 버튼을 눌러 확인 화면에 진입할 때 한 번 호출된다.
+     */
+    estimateGas?: EstimateGasFn;
     onSuccess?: (txHash: `0x${string}`) => void;
     onConfirmSuccess?: () => void;
     onOutlink?: OnOutlink;
 }
 
-declare function SendPage({ env, theme, walletAddress, accounts, token, tokens, onTokenChange, sendTransaction, getTransactionReceipt, onSuccess, onConfirmSuccess, onOutlink, }: SendPageProps): 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;
 
 interface WalletInfoTriggerProps {
     asChild?: boolean;
@@ -443,6 +478,11 @@ interface WalletInfoProps {
      */
     sendTransaction?: SendTransactionFn;
     getTransactionReceipt?: GetTransactionReceiptFn;
+    /**
+     * Send 확인 단계에서 표시할 가스/수수료 추정 함수.
+     * 주입되지 않으면 확인 화면의 Gas/Est.Time/Max.Gas 행은 "—"로 표시된다.
+     */
+    estimateGas?: EstimateGasFn;
     /**
      * Terms/Privacy · 포트폴리오 섹션 등 외부 링크 이동을 가로채는 콜백.
      * `(url, ctx) => newUrl | null | undefined | Promise<...>` 형태이며
@@ -456,7 +496,7 @@ interface WalletInfoProps {
     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, onOutlink, style, children, }: WalletInfoProps): react_jsx_runtime.JSX.Element;
+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 const WalletInfo: typeof WalletInfoRoot & {
     Trigger: typeof WalletInfoTrigger;
     Content: typeof WalletInfoContent;
@@ -677,6 +717,11 @@ interface WalletPortfolioBodyProps {
     env?: Environment;
     theme?: Theme;
     walletAddress: string;
+    /**
+     * 헤더 좌측 아바타 옆에 표시할 지갑 이름 (예: "Account 1").
+     * 전달되지 않으면 텍스트는 숨겨지고 아바타만 표시된다.
+     */
+    walletName?: string;
     /** 왼쪽 상단 back 버튼 클릭 핸들러. 없으면 back 버튼 숨김. */
     onBack?: () => void;
     /** 헤더 노출 여부. embed 시 외부 헤더를 쓰면 false로 숨길 수 있음. */
@@ -702,7 +747,7 @@ interface WalletPortfolioBodyProps {
      */
     onOutlink?: OnOutlink;
 }
-declare function WalletPortfolioBody({ env, theme, walletAddress, onBack, showHeader, variant, className, sendTransaction, getTransactionReceipt, onOutlink, }: WalletPortfolioBodyProps): react_jsx_runtime.JSX.Element;
+declare function WalletPortfolioBody({ env, theme, walletAddress, walletName, onBack, showHeader, variant, className, sendTransaction, getTransactionReceipt, onOutlink, }: WalletPortfolioBodyProps): react_jsx_runtime.JSX.Element;
 
 declare function CROSSxIcon(): react_jsx_runtime.JSX.Element;
 declare function MetaMaskIcon(): react_jsx_runtime.JSX.Element;

package/dist/index.d.ts

@@ -134,6 +134,36 @@ interface TransactionReceiptResult {
     status?: "success" | "reverted" | "0x1" | "0x0" | number | bigint | boolean;
 }
 type GetTransactionReceiptFn = (args: GetTransactionReceiptArgs) => Promise<TransactionReceiptResult | null | undefined>;
+/**
+ * Send 확인 단계에서 표시할 가스/수수료 추정 정보를 가져오는 콜백.
+ *
+ * Send 확인 화면 표기 정책 (crossy-sdk-js `docs/06-gas-fee.md` 기준):
+ * - `maxFeePerGas` 채움 → Dynamic(EIP-1559) 모드로 표기
+ *   · Est. Tx Fee = `gasLimit × maxFeePerGas` (native)
+ *   · Max Priority Fee = `maxPriorityFeePerGas` (Gwei)
+ *   · Max Gas Fee = `maxFeePerGas` (Gwei)
+ *   · Gas Limit = `gasLimit`
+ * - `gasPrice`만 채움 → Legacy 모드로 표기
+ *   · Est. Tx Fee = `gasLimit × gasPrice` (native)
+ *   · Gas Price = `gasPrice` (Gwei)
+ *   · Gas Limit = `gasLimit`
+ *
+ * 둘 다 채워지면 Dynamic 우선. 둘 다 비어있으면 해당 행은 "—"로 표시된다.
+ */
+interface EstimateGasArgs {
+    to: `0x${string}`;
+    value?: bigint;
+    data?: `0x${string}`;
+    chainId?: number;
+    from?: `0x${string}`;
+}
+interface GasEstimate {
+    gasLimit: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+}
+type EstimateGasFn = (args: EstimateGasArgs) => Promise<GasEstimate>;
 interface PoolToken {
     address: string;
     symbol: string;
@@ -320,7 +350,7 @@ interface SendAsset {
     };
     icon_url: string;
 }
-type SendStatus = "idle" | "submitting" | "confirming" | "success" | "error";
+type SendStatus = "idle" | "review" | "submitting" | "confirming" | "success" | "error";
 interface RecentSendAddress {
     address: `0x${string}`;
     updatedAt: number;
@@ -341,12 +371,17 @@ interface SendPageProps {
     onTokenChange?: (token: SendAsset) => void;
     sendTransaction?: SendTransactionFn;
     getTransactionReceipt?: GetTransactionReceiptFn;
+    /**
+     * 확인 단계에서 표시할 가스/수수료 추정 함수. 주입되지 않으면 Gas/Est.Time/Max.Gas 행은 "—"로 표시된다.
+     * 사용자가 Send 버튼을 눌러 확인 화면에 진입할 때 한 번 호출된다.
+     */
+    estimateGas?: EstimateGasFn;
     onSuccess?: (txHash: `0x${string}`) => void;
     onConfirmSuccess?: () => void;
     onOutlink?: OnOutlink;
 }
 
-declare function SendPage({ env, theme, walletAddress, accounts, token, tokens, onTokenChange, sendTransaction, getTransactionReceipt, onSuccess, onConfirmSuccess, onOutlink, }: SendPageProps): 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;
 
 interface WalletInfoTriggerProps {
     asChild?: boolean;
@@ -443,6 +478,11 @@ interface WalletInfoProps {
      */
     sendTransaction?: SendTransactionFn;
     getTransactionReceipt?: GetTransactionReceiptFn;
+    /**
+     * Send 확인 단계에서 표시할 가스/수수료 추정 함수.
+     * 주입되지 않으면 확인 화면의 Gas/Est.Time/Max.Gas 행은 "—"로 표시된다.
+     */
+    estimateGas?: EstimateGasFn;
     /**
      * Terms/Privacy · 포트폴리오 섹션 등 외부 링크 이동을 가로채는 콜백.
      * `(url, ctx) => newUrl | null | undefined | Promise<...>` 형태이며
@@ -456,7 +496,7 @@ interface WalletInfoProps {
     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, onOutlink, style, children, }: WalletInfoProps): react_jsx_runtime.JSX.Element;
+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 const WalletInfo: typeof WalletInfoRoot & {
     Trigger: typeof WalletInfoTrigger;
     Content: typeof WalletInfoContent;
@@ -677,6 +717,11 @@ interface WalletPortfolioBodyProps {
     env?: Environment;
     theme?: Theme;
     walletAddress: string;
+    /**
+     * 헤더 좌측 아바타 옆에 표시할 지갑 이름 (예: "Account 1").
+     * 전달되지 않으면 텍스트는 숨겨지고 아바타만 표시된다.
+     */
+    walletName?: string;
     /** 왼쪽 상단 back 버튼 클릭 핸들러. 없으면 back 버튼 숨김. */
     onBack?: () => void;
     /** 헤더 노출 여부. embed 시 외부 헤더를 쓰면 false로 숨길 수 있음. */
@@ -702,7 +747,7 @@ interface WalletPortfolioBodyProps {
      */
     onOutlink?: OnOutlink;
 }
-declare function WalletPortfolioBody({ env, theme, walletAddress, onBack, showHeader, variant, className, sendTransaction, getTransactionReceipt, onOutlink, }: WalletPortfolioBodyProps): react_jsx_runtime.JSX.Element;
+declare function WalletPortfolioBody({ env, theme, walletAddress, walletName, onBack, showHeader, variant, className, sendTransaction, getTransactionReceipt, onOutlink, }: WalletPortfolioBodyProps): react_jsx_runtime.JSX.Element;
 
 declare function CROSSxIcon(): react_jsx_runtime.JSX.Element;
 declare function MetaMaskIcon(): react_jsx_runtime.JSX.Element;