@tuwaio/nova-transactions 1.0.0-alpha.3.78a2a23 → 1.0.0-alpha.4.a67b545

package/dist/{TransactionsHistory-Bz0XaDda.d.ts → WalletInfoModal-DP-qlvYl.d.ts}

@@ -1,61 +1,59 @@
-import { TransactionStatus, Transaction, TxAdapter, TransactionAdapter, TxActions, TransactionPool, IInitializeTxTrackingStore, ITxTrackingStore } from '@tuwaio/pulsar-core';
-import { ReactNode, JSX, ComponentType, ComponentPropsWithoutRef } from 'react';
-import { ToastContainerProps, ToastContentProps } from 'react-toastify';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as Dialog from '@radix-ui/react-dialog';
+import { TransactionStatus, Transaction, TxAdapter, TransactionAdapter, TransactionPool, TxActions, ITxTrackingStore, InitialTransaction } from '@tuwaio/pulsar-core';
 import { MotionProps } from 'framer-motion';
+import { ReactNode, ComponentType, JSX, ComponentPropsWithoutRef } from 'react';
+import { ToastContainerProps, ToastContentProps } from 'react-toastify';
 
 /**
- * @file This file contains the `HashLink` component, a UI element for displaying hashes with copy and explorer link functionality.
+ * @file This file contains the `HashLink` component, a UI element for displaying
+ * blockchain hashes with copy-to-clipboard and block explorer link functionality.
  */
 /**
- * A component to display a hash string (e.g., transaction hash or address)
- * with an optional label, a link to a block explorer, and a copy-to-clipboard button.
- *
- * @param {object} props - The component props.
- * @param {string} [props.label] - An optional label to display before the hash (e.g., "Tx Hash").
- * @param {string} props.hash - The full hash string to display and copy.
- * @param {string} [props.explorerUrl] - An optional URL to a block explorer. If provided, the hash becomes a link.
- * @param {'default' | 'compact'} [props.variant='default'] - The visual style of the component.
- * @param {string} [props.className] - Additional CSS classes to apply to the container element.
- * @returns {JSX.Element} The rendered HashLink component.
- */
-declare function HashLink({ label, hash, explorerUrl, variant, className, }: {
-    label?: string;
+ * Defines the props for the HashLink component.
+ */
+type HashLinkProps = {
+    /** The full hash string to display and copy (e.g., a transaction hash or wallet address). */
     hash: string;
+    /** An optional label to display before the hash (e.g., "From", "Tx Hash"). */
+    label?: string;
+    /** An optional URL to a block explorer. If provided, the hash becomes a clickable link. */
     explorerUrl?: string;
+    /** The visual style of the component. 'default' is larger, 'compact' is smaller. */
     variant?: 'default' | 'compact';
+    /** Additional CSS classes to apply to the container element for custom styling. */
     className?: string;
-}): react_jsx_runtime.JSX.Element;
+};
+/**
+ * A component to display a hash string with an optional label, a link to a block explorer,
+ * and a copy-to-clipboard button. It automatically ellipsizes the hash for readability.
+ */
+declare function HashLink({ label, hash, explorerUrl, variant, className }: HashLinkProps): react_jsx_runtime.JSX.Element;
 
 /**
  * @file This file contains the `StatusAwareText` component, which displays different text based on a transaction's status.
  */
 
 type StatusAwareTextProps = {
-    /** The current status of the transaction. */
+    /** The current status of the transaction, used to select the correct text and color. */
     txStatus?: TransactionStatus;
     /**
-     * The source for the text. Can be a single string, or an array of strings
-     * corresponding to different statuses in the format: `[pending, success, error, replaced]`.
+     * The source for the text. Can be a single string for static text, or an array of strings
+     * for dynamic text based on status. The array format must be: `[pending, success, error, replaced]`.
      */
-    source?: string | string[];
-    /** A fallback string to display if `source` is not provided. */
+    source?: string | readonly string[];
+    /** A fallback string to display if `source` is not provided or is invalid. */
     fallback?: string;
-    /** The visual variant, determines the base text style ('title' or 'description'). */
+    /** The visual variant, which determines the base text style ('title' or 'description'). */
     variant: 'title' | 'description';
-    /** Optional additional CSS classes. */
-    className?: string;
-    /** If true, applies a status-specific color to the text. */
+    /** If true, applies a status-specific color to the text. Defaults to false. */
     applyColor?: boolean;
+    /** Optional additional CSS classes for custom styling. */
+    className?: string;
 };
 /**
  * A component that renders text conditionally based on a transaction's status.
- * It's designed to work with the `title` and `description` fields of a transaction,
- * which can be a single string or a status-dependent array of strings.
- *
- * @param {StatusAwareTextProps} props - The component props.
- * @returns {ReactNode} The rendered text element or null.
+ * It's designed to work with the `title` and `description` fields of a transaction object.
  */
 declare function StatusAwareText({ txStatus, source, fallback, variant, className, applyColor, }: StatusAwareTextProps): ReactNode;
 
@@ -186,13 +184,22 @@ type TuwaLabels = {
 };
 
 /**
- * @file This file contains the main `NovaProvider` component, the primary entry point for the UI library.
+ * Defines the props for the NovaProvider component.
+ * @template TR - The type of the tracker identifier.
+ * @template T - The transaction type.
+ * @template A - The type of the key returned by an action function.
  */
-
 type NovaProviderProps<TR, T extends Transaction<TR>, A> = {
+    /** An array of configured adapters for different blockchain ecosystems. */
     adapters: TxAdapter<TR, T, A>[];
+    /** The address of the currently connected wallet. */
     connectedWalletAddress?: string;
+    /** The adapter type of the currently connected wallet. */
     connectedAdapterType?: TransactionAdapter;
+    /** The global transaction pool from the Pulsar store. */
+    transactionsPool: TransactionPool<TR, T>;
+    /** A registry of retryable actions, keyed by `actionKey`. */
+    actions?: TxActions;
     /** A partial object of labels to override the default English text. */
     labels?: Partial<TuwaLabels>;
     /** An object to enable or disable major UI features. All are enabled by default. */
@@ -207,22 +214,21 @@ type NovaProviderProps<TR, T extends Transaction<TR>, A> = {
         walletInfoModal?: WalletInfoModalCustomization<TR, T, A>;
         trackingTxModal?: TrackingTxModalCustomization<TR, T, A>;
     };
-    /** A registry of retryable actions, keyed by `actionKey`. */
-    actions?: TxActions;
-    /** The global transaction pool from the tracking store. */
-    transactionsPool: TransactionPool<TR, T>;
-} & Pick<IInitializeTxTrackingStore<TR, T>, 'closeTxTrackedModal'> & Partial<Pick<ITxTrackingStore<TR, T, A>, 'handleTransaction' | 'initialTx'>> & ToastContainerProps;
+} & Pick<ITxTrackingStore<TR, T, A>, 'closeTxTrackedModal' | 'handleTransaction' | 'initialTx'> & ToastContainerProps;
 /**
- * The main provider for the Nova UI ecosystem.
- * It orchestrates toasts, modals, and the i18n context for the entire application.
- *
- * @param {NovaProviderProps<TR, T>} props - The component props.
- * @returns {JSX.Element} The rendered provider.
+ * The main component for the Nova UI ecosystem. It renders and orchestrates all
+ * UI elements like toasts and modals, and provides the i18n context.
+ * This component does not wrap any children.
  */
-declare function NovaProvider<TR, T extends Transaction<TR>, A>({ adapters, connectedWalletAddress, connectedAdapterType, labels, features, customization, closeTxTrackedModal, actions, handleTransaction, initialTx, transactionsPool, ...toastProps }: NovaProviderProps<TR, T, A>): JSX.Element;
+declare function NovaProvider<TR, T extends Transaction<TR>, A>({ adapters, connectedWalletAddress, connectedAdapterType, transactionsPool, initialTx, handleTransaction, closeTxTrackedModal, actions, labels, features, customization, ...toastProps }: NovaProviderProps<TR, T, A>): react_jsx_runtime.JSX.Element;
 
-type CustomHashLinkProps = Parameters<typeof HashLink>[0];
-interface ToastTransactionKeyProps<TR, T extends Transaction<TR>, A> extends Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'transactionsPool'> {
+/**
+ * Defines the props for the TransactionKey component.
+ * @template TR - The type of the tracker identifier.
+ * @template T - The transaction type.
+ * @template A - The type of the key returned by an action function.
+ */
+type TransactionKeyProps<TR, T extends Transaction<TR>, A> = Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'transactionsPool'> & {
     /** The transaction object to display identifiers for. */
     tx: T;
     /** The visual variant, which applies different container styles. */
@@ -233,21 +239,19 @@ interface ToastTransactionKeyProps<TR, T extends Transaction<TR>, A> extends Pic
      * An optional render prop to allow for complete customization of how the hash link is rendered.
      * If not provided, the default `HashLink` component will be used.
      */
-    renderHashLink?: (props: CustomHashLinkProps) => ReactNode;
-}
+    renderHashLink?: (props: HashLinkProps) => ReactNode;
+};
 /**
  * A component that intelligently displays the relevant keys and hashes for a transaction.
- * It handles different tracker types (EVM, Gelato, Safe) and statuses (e.g., replaced transactions).
- *
- * @param {ToastTransactionKeyProps<TR, T>} props - The component props.
- * @returns {JSX.Element} The rendered component.
+ * It leverages the adapter system to show chain-specific identifiers and explorer links.
  */
-declare function TransactionKey<TR, T extends Transaction<TR>, A>({ tx, adapters, transactionsPool, variant, className, renderHashLink, }: ToastTransactionKeyProps<TR, T, A>): react_jsx_runtime.JSX.Element | null;
+declare function TransactionKey<TR, T extends Transaction<TR>, A>({ tx, adapters, transactionsPool, variant, className, renderHashLink, }: TransactionKeyProps<TR, T, A>): react_jsx_runtime.JSX.Element | null;
 
 /**
- * @file This file contains the `TransactionStatusBadge` component for visually displaying a transaction's status.
+ * Defines the props for the TransactionStatusBadge component.
+ * @template TR - The type of the tracker identifier.
+ * @template T - The transaction type.
  */
-
 type TransactionStatusBadgeProps<TR, T extends Transaction<TR>> = {
     /** The transaction object whose status will be displayed. */
     tx: T;
@@ -257,73 +261,47 @@ type TransactionStatusBadgeProps<TR, T extends Transaction<TR>> = {
 /**
  * A component that displays a transaction's status as a styled badge
  * with a corresponding icon, color, and label.
- *
- * @param {TransactionStatusBadgeProps<TR, T>} props - The component props.
- * @returns {JSX.Element} The rendered status badge.
  */
-declare function TransactionStatusBadge<TR, T extends Transaction<TR>>({ tx, className, }: TransactionStatusBadgeProps<TR, T>): JSX.Element;
+declare function TransactionStatusBadge<TR, T extends Transaction<TR>>({ tx, className, }: TransactionStatusBadgeProps<TR, T>): react_jsx_runtime.JSX.Element;
 
 /**
  * @file This file contains the `ToastTransaction` component, which serves as the main body for a transaction notification toast.
  */
 
-type CustomStatusAwareTextProps$1 = Parameters<typeof StatusAwareText>[0];
-type CustomTransactionKeyProps$1<TR, T extends Transaction<TR>, A> = Parameters<typeof TransactionKey<TR, T, A>>[0];
-type CustomStatusBadgeProps$1<TR, T extends Transaction<TR>> = Parameters<typeof TransactionStatusBadge<TR, T>>[0];
-/** Props provided to custom action buttons like 'Wallet Info', 'Speed Up', or 'Cancel'. */
 type CustomActionButtonProps = {
     onClick: () => void;
     children: ReactNode;
 };
-/**
- * Defines the structure for the `customization` prop, allowing users to override
- * default sub-components with their own implementations.
- */
 type ToastTransactionCustomization<TR, T extends Transaction<TR>, A> = {
     components?: {
-        /** Override the default title/description component. */
-        statusAwareText?: (props: CustomStatusAwareTextProps$1) => ReactNode;
-        /** Override the default component for displaying transaction keys/hashes. */
-        transactionKey?: (props: CustomTransactionKeyProps$1<TR, T, A>) => ReactNode;
-        /** Override the default status badge component. */
-        statusBadge?: (props: CustomStatusBadgeProps$1<TR, T>) => ReactNode;
-        /** Override the default "Open wallet info" button. */
-        walletInfoButton?: (props: CustomActionButtonProps) => ReactNode;
-        /** Override the default "Speed Up" button. */
-        speedUpButton?: (props: CustomActionButtonProps) => ReactNode;
-        /** Override the default "Cancel" button. */
-        cancelButton?: (props: CustomActionButtonProps) => ReactNode;
+        StatusAwareText?: ComponentType<StatusAwareTextProps>;
+        TransactionKey?: ComponentType<TransactionKeyProps<TR, T, A>>;
+        StatusBadge?: ComponentType<TransactionStatusBadgeProps<TR, T>>;
+        WalletInfoButton?: ComponentType<CustomActionButtonProps>;
+        SpeedUpButton?: ComponentType<CustomActionButtonProps>;
+        CancelButton?: ComponentType<CustomActionButtonProps>;
     };
 };
 type ToastTransactionProps<TR, T extends Transaction<TR>, A> = {
-    /** The transaction object to display in the toast. */
     tx: T;
-    /** A function to open the main wallet info modal. If not provided, the button will not be rendered. */
-    openWalletInfoModal?: (value: boolean) => void;
-    /** An optional custom icon to display instead of the default chain icon. */
+    openWalletInfoModal?: () => void;
     icon?: ReactNode;
-    /** Optional additional CSS classes for the toast container. */
     className?: string;
-    /** An object to customize and override the default internal components. */
     customization?: ToastTransactionCustomization<TR, T, A>;
-    /** Props from `react-toastify` to control the toast itself. */
     closeToast?: ToastContentProps['closeToast'];
     toastProps?: ToastContainerProps;
 } & Pick<NovaProviderProps<TR, T, A>, 'transactionsPool' | 'adapters' | 'connectedWalletAddress'>;
 /**
  * A composite component that renders the content for a transaction toast notification.
- * It is highly customizable and includes actions for speeding up or canceling transactions
- * when they are in a pending state.
- *
- * @template TR The generic type for the transaction tracker registry.
- * @template T The generic type for the transaction object.
- * @param {ToastTransactionProps<TR, T>} props The component props.
- * @returns {JSX.Element} The rendered toast body.
+ * It is highly customizable and leverages the adapter to show relevant actions like "Speed Up".
  */
 declare function ToastTransaction<TR, T extends Transaction<TR>, A>({ openWalletInfoModal, tx, transactionsPool, icon, className, customization, connectedWalletAddress, adapters, }: ToastTransactionProps<TR, T, A>): JSX.Element;
 
+/**
+ * @file This file contains the `TxErrorBlock` component for displaying transaction error messages.
+ */
 type TxErrorBlockProps = {
-    /** The error message string to display. If undefined, the component renders nothing. */
+    /** The error message string to display. If undefined or empty, the component renders nothing. */
     error?: string;
     /** Optional additional CSS classes for the container. */
     className?: string;
@@ -332,53 +310,30 @@ type TxErrorBlockProps = {
  * A component that displays a formatted block for a transaction error message.
  * It includes a title, an icon, the error message in a scrollable area,
  * and a button to copy the message to the clipboard.
- *
- * @param {TxErrorBlockProps} props - The component props.
- * @returns {JSX.Element | null} The rendered error block, or null if no error is provided.
- */
-declare function TxErrorBlock({ error, className }: TxErrorBlockProps): JSX.Element | null;
-
-/**
- * @file This file contains the `TxInfoBlock` component, which displays key details about a transaction.
  */
+declare function TxErrorBlock({ error, className }: TxErrorBlockProps): react_jsx_runtime.JSX.Element | null;
 
 type CustomInfoRowProps = {
     label: ReactNode;
     value: ReactNode;
 };
-/**
- * Defines the customization options for the `TxInfoBlock` component.
- */
 type TxInfoBlockCustomization<TR, T extends Transaction<TR>, A> = {
     components?: {
-        /** A render prop to replace the default label-value row component. */
-        infoRow?: (props: CustomInfoRowProps) => ReactNode;
-        /**
-         * A render prop to customize the rendering of the transaction keys/hashes.
-         * This is passed down to the underlying `TransactionKey` component.
-         */
-        transactionKey?: ToastTransactionKeyProps<TR, T, A>['renderHashLink'];
+        InfoRow?: ComponentType<CustomInfoRowProps>;
+        transactionKey?: TransactionKeyProps<TR, T, A>['renderHashLink'];
     };
 };
 type TxInfoBlockProps<TR, T extends Transaction<TR>, A> = {
-    tx: T & {
-        desiredChainID?: number;
-    };
+    /** The transaction object to display, which can be a full transaction or an initial one. */
+    tx: T | InitialTransaction;
     className?: string;
     customization?: TxInfoBlockCustomization<TR, T, A>;
 } & Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'transactionsPool'>;
 /**
  * A component that displays a block of essential transaction details,
  * such as network, start time, and relevant hashes/keys.
- *
- * @param {object} props - The component props.
- * @returns {JSX.Element} The rendered info block.
- */
-declare function TxInfoBlock<TR, T extends Transaction<TR>, A>({ tx, adapters, transactionsPool, className, customization, }: TxInfoBlockProps<TR, T, A>): JSX.Element;
-
-/**
- * @file This file contains the `TxProgressIndicator` component, a visual step-by-step progress bar for transactions.
  */
+declare function TxInfoBlock<TR, T extends Transaction<TR>, A>({ tx, adapters, transactionsPool, className, customization, }: TxInfoBlockProps<TR, T, A>): react_jsx_runtime.JSX.Element;
 
 type StepStatus = 'active' | 'completed' | 'error' | 'inactive' | 'replaced';
 type StepProps = {
@@ -386,7 +341,6 @@ type StepProps = {
     label: string;
     isFirst?: boolean;
     isLast?: boolean;
-    className?: string;
 };
 interface TxProgressIndicatorProps {
     isProcessing?: boolean;
@@ -394,21 +348,16 @@ interface TxProgressIndicatorProps {
     isFailed?: boolean;
     isReplaced?: boolean;
     className?: string;
-    /** A custom component to use instead of the default `Step`. */
     StepComponent?: ComponentType<StepProps>;
 }
 /**
  * A 3-step progress indicator that visually represents the lifecycle of a transaction.
- *
- * @param {TxProgressIndicatorProps} props - The component props.
- * @returns {JSX.Element} The rendered progress indicator.
  */
-declare function TxProgressIndicator({ isProcessing, isSucceed, isFailed, isReplaced, className, StepComponent, }: TxProgressIndicatorProps): JSX.Element;
+declare function TxProgressIndicator({ isProcessing, isSucceed, isFailed, isReplaced, className, StepComponent, }: TxProgressIndicatorProps): react_jsx_runtime.JSX.Element;
 
 /**
  * @file This file contains the `TxStatusVisual` component, which displays a large icon representing the transaction's status.
  */
-
 type TxStatusVisualProps = {
     /** True if the transaction is currently being processed (e.g., in the mempool). */
     isProcessing?: boolean;
@@ -422,64 +371,46 @@ type TxStatusVisualProps = {
 /**
  * A component that renders a large, animated icon to visually represent the
  * current state of a transaction within the tracking modal.
- *
- * @param {TxStatusVisualProps} props - The component props.
- * @returns {JSX.Element} The rendered visual status indicator.
  */
-declare function TxStatusVisual({ isProcessing, isSucceed, isFailed, isReplaced }: TxStatusVisualProps): JSX.Element;
+declare function TxStatusVisual({ isProcessing, isSucceed, isFailed, isReplaced }: TxStatusVisualProps): react_jsx_runtime.JSX.Element;
 
-/** Props provided to a custom header component. */
 type CustomHeaderProps$1 = {
-    onClose: (txKey?: string) => void;
+    onClose: () => void;
+    title: ReactNode;
 };
-/** Props provided to a custom footer component. */
 type CustomFooterProps = {
-    onClose: (txKey?: string) => void;
+    onClose: () => void;
     onOpenWalletInfo: () => void;
     onRetry?: () => void;
     onSpeedUp?: () => void;
     onCancel?: () => void;
     isProcessing?: boolean;
+    isFailed?: boolean;
+    canReplace?: boolean;
 };
-/**
- * Defines the customization options for the TrackingTxModal.
- * Allows overriding modal behavior, animations, and individual UI components.
- */
 type TrackingTxModalCustomization<TR, T extends Transaction<TR>, A> = {
-    /** Custom props to pass to the underlying Radix UI `Dialog.Content` component. */
     modalProps?: Partial<ComponentPropsWithoutRef<typeof Dialog.Content>>;
-    /** Custom Framer Motion animation properties for the modal's entrance and exit. */
     motionProps?: MotionProps;
-    /** A record of custom components to override parts of the modal's UI. */
     components?: {
-        header?: (props: CustomHeaderProps$1) => ReactNode;
-        footer?: (props: CustomFooterProps) => ReactNode;
-        statusVisual?: (props: TxStatusVisualProps) => ReactNode;
-        progressIndicator?: (props: TxProgressIndicatorProps) => ReactNode;
-        infoBlock?: (props: TxInfoBlockProps<TR, T, A>) => ReactNode;
-        errorBlock?: (props: TxErrorBlockProps) => ReactNode;
+        Header?: ComponentType<CustomHeaderProps$1>;
+        Footer?: ComponentType<CustomFooterProps>;
+        StatusVisual?: ComponentType<TxStatusVisualProps>;
+        ProgressIndicator?: ComponentType<TxProgressIndicatorProps>;
+        InfoBlock?: ComponentType<TxInfoBlockProps<TR, T, A>>;
+        ErrorBlock?: ComponentType<TxErrorBlockProps>;
     };
 };
-interface TrackingTxModalProps<TR, T extends Transaction<TR>, A> extends Pick<NovaProviderProps<TR, T, A>, 'handleTransaction' | 'initialTx' | 'actions' | 'transactionsPool' | 'adapters' | 'connectedAdapterType'> {
-    /** A function to close the modal. */
+type TrackingTxModalProps<TR, T extends Transaction<TR>, A> = Pick<NovaProviderProps<TR, T, A>, 'handleTransaction' | 'initialTx' | 'actions' | 'transactionsPool' | 'adapters'> & {
     onClose: (txKey?: string) => void;
-    /** A function to open the main wallet info modal. */
     onOpenWalletInfo: () => void;
-    /** Optional additional CSS classes for the modal's container. */
     className?: string;
-    /** An object containing all customization options for the modal. */
     customization?: TrackingTxModalCustomization<TR, T, A>;
-}
+};
 /**
  * A detailed modal that displays the real-time status and lifecycle of a transaction.
  * It opens automatically for transactions initiated with `withTrackedModal: true`.
- *
- * @template TR - The generic type for the transaction tracker registry.
- * @template T - The generic type for the transaction object.
- * @param {TrackingTxModalProps<TR, T>} props - The component props.
- * @returns {JSX.Element} The rendered tracking modal.
  */
-declare function TrackingTxModal<TR, T extends Transaction<TR>, A>({ adapters, onClose, onOpenWalletInfo, className, customization, transactionsPool, actions, handleTransaction, initialTx, connectedAdapterType, }: TrackingTxModalProps<TR, T, A>): JSX.Element;
+declare function TrackingTxModal<TR, T extends Transaction<TR>, A>({ adapters, onClose, onOpenWalletInfo, className, customization, transactionsPool, actions, handleTransaction, initialTx, }: TrackingTxModalProps<TR, T, A>): react_jsx_runtime.JSX.Element | null;
 
 /**
  * @file This file contains the `TransactionHistoryItem` component, which renders a single transaction
@@ -489,141 +420,160 @@ declare function TrackingTxModal<TR, T extends Transaction<TR>, A>({ adapters, o
 type CustomIconProps = {
     chainId: number;
 };
-type CustomStatusAwareTextProps = Parameters<typeof StatusAwareText>[0];
 type CustomTimestampProps = {
     timestamp?: number;
 };
-type CustomStatusBadgeProps<TR, T extends Transaction<TR>> = Parameters<typeof TransactionStatusBadge<TR, T>>[0];
-type CustomTransactionKeyProps<TR, T extends Transaction<TR>, A> = Parameters<typeof TransactionKey<TR, T, A>>[0];
 /**
  * Defines the structure for the `customization` prop, allowing users to override
  * default sub-components with their own implementations for a history item.
  */
 type TransactionHistoryItemCustomization<TR, T extends Transaction<TR>, A> = {
     components?: {
-        /** Override the default chain icon. */
-        icon?: (props: CustomIconProps) => ReactNode;
-        /** Override the default title component. */
-        title?: (props: CustomStatusAwareTextProps) => ReactNode;
-        /** Override the default description component. */
-        description?: (props: CustomStatusAwareTextProps) => ReactNode;
-        /** Override the default timestamp component. */
-        timestamp?: (props: CustomTimestampProps) => ReactNode;
-        /** Override the default status badge component. */
-        statusBadge?: (props: CustomStatusBadgeProps<TR, T>) => ReactNode;
-        /** Override the default component for displaying transaction keys/hashes. */
-        transactionKey?: (props: CustomTransactionKeyProps<TR, T, A>) => ReactNode;
+        Icon?: ComponentType<CustomIconProps>;
+        Title?: ComponentType<StatusAwareTextProps>;
+        Description?: ComponentType<StatusAwareTextProps>;
+        Timestamp?: ComponentType<CustomTimestampProps>;
+        StatusBadge?: ComponentType<TransactionStatusBadgeProps<TR, T>>;
+        TransactionKey?: ComponentType<TransactionKeyProps<TR, T, A>>;
     };
 };
 type TransactionHistoryItemProps<TR, T extends Transaction<TR>, A> = {
     /** The transaction object to display. */
     tx: T;
-    /** The entire pool of transactions. */
-    transactionsPool: TransactionPool<TR, T>;
-    /** Optional additional CSS classes for the container. */
-    className?: string;
     /** An object to customize and override the default internal components. */
     customization?: TransactionHistoryItemCustomization<TR, T, A>;
-} & Pick<NovaProviderProps<TR, T, A>, 'adapters'>;
+    /** Optional additional CSS classes for the container. */
+    className?: string;
+} & Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'transactionsPool'>;
 /**
  * A component that renders a single row in the transaction history list.
- * It is highly customizable via the `customization` prop.
- *
- * @param {TransactionHistoryItemProps<TR, T>} props - The component props.
- * @returns {JSX.Element} The rendered history item.
+ * It is highly customizable via the `customization` prop, allowing developers
+ * to override any of its internal parts with their own components.
  */
 declare function TransactionHistoryItem<TR, T extends Transaction<TR>, A>({ tx, adapters, transactionsPool, className, customization, }: TransactionHistoryItemProps<TR, T, A>): JSX.Element;
 
-/**
- * @file This file contains the main `WalletInfoModal` component, which serves as the primary UI for viewing wallet details and transaction history.
- */
-
-type CustomHeaderProps = {
-    closeModal: () => void;
-};
-type CustomWalletInfoProps<TR, T extends Transaction<TR>, A> = WalletInfoModalProps<TR, T, A>;
-type CustomHistoryProps<TR, T extends Transaction<TR>, A> = WalletInfoModalProps<TR, T, A> & {
-    customization?: TransactionsHistoryCustomization<TR, T, A>;
+type CustomPlaceholderProps = {
+    title: string;
+    message: string;
 };
 /**
- * Defines the customization options for the WalletInfoModal.
- * Allows customization of modal behavior, animations, and individual UI components.
+ * Defines the customization options for the TransactionsHistory component.
  */
-type WalletInfoModalCustomization<TR, T extends Transaction<TR>, A> = {
-    /** Custom props to pass to the underlying Radix UI Dialog.Content component */
-    modalProps?: Partial<ComponentPropsWithoutRef<typeof Dialog.Content>>;
-    /** Custom Framer Motion animation properties */
-    motionProps?: MotionProps;
+type TransactionsHistoryCustomization<TR, T extends Transaction<TR>, A> = {
     classNames?: {
-        /** CSS classes for the main content wrapper div. */
-        contentWrapper?: string;
+        listWrapper?: string;
     };
-    /** Custom component overrides for different parts of the modal */
     components?: {
-        /** A render prop to replace the entire modal header. */
-        header?: (props: CustomHeaderProps) => ReactNode;
-        /** A render prop to replace the `WalletHeader` component. */
-        walletInfo?: (props: CustomWalletInfoProps<TR, T, A>) => ReactNode;
-        /** A render prop to replace the `TransactionsHistory` component. */
-        history?: (props: CustomHistoryProps<TR, T, A>) => ReactNode;
+        Placeholder?: ComponentType<CustomPlaceholderProps>;
+        HistoryItem?: ComponentType<TransactionHistoryItemProps<TR, T, A>>;
     };
 };
 /**
- * Defines the core props for the WalletInfoModal and its children.
+ * Defines the props for the TransactionsHistory component.
+ * @template TR - The type of the tracker identifier.
+ * @template T - The transaction type.
+ * @template A - The type of the key returned by an action function.
  */
-interface WalletInfoModalProps<TR, T extends Transaction<TR>, A> extends Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'connectedAdapterType' | 'connectedWalletAddress' | 'transactionsPool'> {
-    isOpen?: boolean;
-    setIsOpen?: (value: boolean) => void;
-    customization?: WalletInfoModalCustomization<TR, T, A>;
-}
+type TransactionsHistoryProps<TR, T extends Transaction<TR>, A> = Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'transactionsPool' | 'connectedWalletAddress'> & {
+    className?: string;
+    customization?: TransactionsHistoryCustomization<TR, T, A>;
+};
 /**
- * The main modal component for displaying wallet information and transaction history.
- * It is highly customizable through the `customization` prop and supports full Radix UI Dialog customization.
+ * A component that displays a scrollable list of transactions for the connected wallet.
+ * It handles states for when a wallet is not connected or when the history is empty.
+ */
+declare function TransactionsHistory<TR, T extends Transaction<TR>, A>({ adapters, connectedWalletAddress, transactionsPool, className, customization, }: TransactionsHistoryProps<TR, T, A>): react_jsx_runtime.JSX.Element;
+
+/**
+ * @file This file contains the `WalletAddressDisplay` component, a UI element for showing a wallet address.
+ */
+type WalletAddressDisplayProps = {
+    /** The full wallet address to display. */
+    address: string;
+    /** The base URL for the block explorer. If not provided, the explorer link will not be rendered. */
+    explorerUrl?: string;
+    /** Optional additional CSS classes for the container. */
+    className?: string;
+};
+/**
+ * A component that renders a wallet address in a styled "pill" format,
+ * including a copy button and an optional link to the appropriate block explorer.
+ */
+declare function WalletAddressDisplay({ address, explorerUrl, className }: WalletAddressDisplayProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @file This file contains the `WalletAvatar` component for displaying a user's avatar.
+ */
+type WalletAvatarProps = {
+    /** The user's wallet address, used for the blockie fallback and background color. */
+    address: string;
+    /** An optional URL for the user's ENS avatar image. */
+    ensAvatar?: string | null;
+    /** Optional additional CSS classes for the container. */
+    className?: string;
+};
+/**
+ * A component that displays a user's avatar.
  *
- * @param {WalletInfoModalProps<TR, T> & { ... }} props - The component props.
- * @returns {JSX.Element | null} The rendered modal or null if not open.
+ * It prioritizes showing the provided `ensAvatar`. If unavailable or if the image fails to load,
+ * it falls back to a procedurally generated "blockie" based on the user's address.
+ * It also generates a unique background color from the address as a placeholder.
  */
-declare function WalletInfoModal<TR, T extends Transaction<TR>, A>({ isOpen, setIsOpen, customization, ...props }: WalletInfoModalProps<TR, T, A>): JSX.Element | null;
+declare function WalletAvatar({ address, ensAvatar, className }: WalletAvatarProps): react_jsx_runtime.JSX.Element;
 
+type NameRenderProps = {
+    ensName?: string;
+    isLoading: boolean;
+    address: string;
+};
 /**
- * @file This file contains the `TransactionsHistory` component, which displays a list of past and pending transactions.
+ * Defines the props for the `WalletHeader` component, including extensive customization options.
  */
+type WalletHeaderProps<TR, T extends Transaction<TR>, A> = Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'connectedAdapterType'> & {
+    walletAddress?: string;
+    explorerUrl?: string;
+    className?: string;
+    renderAvatar?: (props: WalletAvatarProps) => ReactNode;
+    renderName?: (props: NameRenderProps) => ReactNode;
+    renderAddressDisplay?: (props: WalletAddressDisplayProps) => ReactNode;
+    renderNoWalletContent?: () => ReactNode;
+};
+/**
+ * A component that displays the header for the wallet modal, including the user's avatar,
+ * name (if available), and address. It leverages the active adapter to fetch name service data.
+ */
+declare function WalletHeader<TR, T extends Transaction<TR>, A>({ walletAddress, adapters, connectedAdapterType, className, renderAvatar, renderName, renderAddressDisplay, renderNoWalletContent, explorerUrl, }: WalletHeaderProps<TR, T, A>): react_jsx_runtime.JSX.Element;
 
-type CustomPlaceholderProps = {
-    title: string;
-    message: string;
+type CustomHeaderProps = {
+    closeModal: () => void;
 };
 /**
- * Defines the customization options for the TransactionsHistory component.
+ * Defines the customization options for the WalletInfoModal.
  */
-type TransactionsHistoryCustomization<TR, T extends Transaction<TR>, A> = {
+type WalletInfoModalCustomization<TR, T extends Transaction<TR>, A> = {
+    modalProps?: Partial<ComponentPropsWithoutRef<typeof Dialog.Content>>;
+    motionProps?: MotionProps;
     classNames?: {
-        /** CSS classes for the list's wrapper `div`. */
-        listWrapper?: string;
+        contentWrapper?: string;
     };
     components?: {
-        /**
-         * A render prop to replace the default placeholder component
-         * (e.g., for "Connect Wallet" or "No Transactions").
-         */
-        placeholder?: (props: CustomPlaceholderProps) => ReactNode;
-        /**
-         * A custom component to use instead of the default `TransactionHistoryItem`.
-         * This should be a component type, not a render function.
-         */
-        HistoryItem?: ComponentType<TransactionHistoryItemProps<TR, T, A>>;
+        Header?: ComponentType<CustomHeaderProps>;
+        WalletInfo?: ComponentType<WalletHeaderProps<TR, T, A>>;
+        History?: ComponentType<TransactionsHistoryProps<TR, T, A>>;
     };
 };
 /**
- * A component that displays a scrollable list of transactions for the connected wallet.
- * It handles states for when a wallet is not connected or when there is no history.
- *
- * @param {WalletInfoModalProps<TR, T> & { customization?: TransactionsHistoryCustomization<TR, T> }} props
- * @returns {JSX.Element} The rendered transaction history section.
+ * Defines the core props for the WalletInfoModal.
  */
-declare function TransactionsHistory<TR, T extends Transaction<TR>, A>({ adapters, connectedWalletAddress, transactionsPool, className, customization, }: WalletInfoModalProps<TR, T, A> & Pick<NovaProviderProps<TR, T, A>, 'adapters'> & {
-    className?: string;
-    customization?: TransactionsHistoryCustomization<TR, T, A>;
-}): JSX.Element;
+type WalletInfoModalProps<TR, T extends Transaction<TR>, A> = Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'connectedAdapterType' | 'connectedWalletAddress' | 'transactionsPool'> & {
+    isOpen?: boolean;
+    setIsOpen: (value: boolean) => void;
+    customization?: WalletInfoModalCustomization<TR, T, A>;
+};
+/**
+ * The main modal component for displaying wallet information and transaction history.
+ * It is highly customizable and built with accessibility in mind using Radix UI.
+ */
+declare function WalletInfoModal<TR, T extends Transaction<TR>, A>({ isOpen, setIsOpen, customization, adapters, connectedAdapterType, connectedWalletAddress, transactionsPool, }: WalletInfoModalProps<TR, T, A>): react_jsx_runtime.JSX.Element;
 
-export { WalletInfoModal as A, NovaProvider as B, HashLink as H, type NovaProviderProps as N, StatusAwareText as S, type TuwaLabels as T, type WalletInfoModalCustomization as W, type ToastTransactionCustomization as a, type ToastTransactionProps as b, ToastTransaction as c, type TrackingTxModalCustomization as d, type TrackingTxModalProps as e, TrackingTxModal as f, type TxErrorBlockProps as g, TxErrorBlock as h, type TxInfoBlockCustomization as i, type TxInfoBlockProps as j, TxInfoBlock as k, type StepStatus as l, type StepProps as m, type TxProgressIndicatorProps as n, TxProgressIndicator as o, type TxStatusVisualProps as p, TxStatusVisual as q, type TransactionHistoryItemCustomization as r, type TransactionHistoryItemProps as s, TransactionHistoryItem as t, type ToastTransactionKeyProps as u, TransactionKey as v, type TransactionsHistoryCustomization as w, TransactionsHistory as x, TransactionStatusBadge as y, type WalletInfoModalProps as z };
+export { TransactionsHistory as A, type TransactionStatusBadgeProps as B, TransactionStatusBadge as C, WalletAddressDisplay as D, type WalletAvatarProps as E, WalletAvatar as F, type WalletHeaderProps as G, type HashLinkProps as H, WalletHeader as I, type WalletInfoModalCustomization as J, type WalletInfoModalProps as K, WalletInfoModal as L, NovaProvider as M, type NovaProviderProps as N, type StatusAwareTextProps as S, type TuwaLabels as T, type WalletAddressDisplayProps as W, HashLink as a, StatusAwareText as b, type ToastTransactionCustomization as c, type ToastTransactionProps as d, ToastTransaction as e, type TrackingTxModalCustomization as f, type TrackingTxModalProps as g, TrackingTxModal as h, type TxErrorBlockProps as i, TxErrorBlock as j, type TxInfoBlockCustomization as k, type TxInfoBlockProps as l, TxInfoBlock as m, type StepStatus as n, type StepProps as o, type TxProgressIndicatorProps as p, TxProgressIndicator as q, type TxStatusVisualProps as r, TxStatusVisual as s, type TransactionHistoryItemCustomization as t, type TransactionHistoryItemProps as u, TransactionHistoryItem as v, type TransactionKeyProps as w, TransactionKey as x, type TransactionsHistoryCustomization as y, type TransactionsHistoryProps as z };