@tuwaio/nova-transactions 0.0.17 → 0.0.19

package/README.md

@@ -100,14 +100,13 @@ export function Providers({children}: { children: React.ReactNode }) {
           initialTx={initialTx}
           handleTransaction={handleTransaction}
           closeTxTrackedModal={closeTxTrackedModal}
-          actions={actions}
 
           // Pass live wallet and adapter data
           connectedWalletAddress={address}
           connectedAdapterType={chain?.id ? TransactionAdapter.EVM : undefined} // Example for EVM
 
           // Pass static configuration
-          adapters={[evmAdapter(wagmiConfig, chains)]}
+          adapter={evmAdapter(wagmiConfig, chains)}
         />
       </QueryClientProvider>
     </WagmiProvider>

package/dist/{WalletInfoModal-BcTPDgW_.d.cts → WalletInfoModal-BMSFI1JW.d.cts}

@@ -1,6 +1,6 @@
 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 { TransactionStatus, Transaction, TxAdapter, TransactionAdapter, TransactionPool, ITxTrackingStore, InitialTransaction } from '@tuwaio/pulsar-core';
 import { MotionProps } from 'framer-motion';
 import { ReactNode, ComponentType, JSX, ComponentPropsWithoutRef } from 'react';
 import { ToastContainerProps, ToastContentProps } from 'react-toastify';
@@ -62,7 +62,8 @@ declare function StatusAwareText({ txStatus, source, fallback, variant, classNam
  * It provides a strict structure for all text used in the UI components, ensuring type safety for different languages.
  */
 /**
- * Defines the complete structure for all customizable text labels used throughout the transaction tracking UI components.
+ * Represents the set of labels used for various UI elements and features in a Tuwa-based application.
+ * This type defines structured labels for wallet modals, transaction statuses, toast notifications, and more.
  */
 type TuwaLabels = {
     /** Labels for the main wallet information modal. */
@@ -107,6 +108,8 @@ type TuwaLabels = {
         replaced: string;
         /** Text for an unknown or indeterminate status. */
         unknown: string;
+        /** Text for a confirmation count label, e.g., "1 confirmation" or "10 confirmations" */
+        confirmationsLabel: string;
     };
     /** Labels for different types of transaction hashes/keys. */
     hashLabels: {
@@ -120,6 +123,10 @@ type TuwaLabels = {
         replaced: string;
         /** Default label for a standard transaction hash. */
         default: string;
+        /** Special label for the most recent blockhash. This is used for the "Recent Blockhash" field in the transaction details modal. */
+        recentBlockhash: string;
+        /** Special label for the Solana signature. This is used for the "Signature" field in the transaction details modal. */
+        solana: string;
     };
     /** Labels for the transaction information block. */
     txInfo: {
@@ -127,6 +134,8 @@ type TuwaLabels = {
         started: string;
         /** Label for the network name. */
         network: string;
+        /** Slot number for the transaction. This is used for the "Slot" field in the transaction details modal. */
+        slot: string;
     };
     /** Labels for the transaction error block. */
     txError: {
@@ -186,12 +195,11 @@ type TuwaLabels = {
 /**
  * Defines the props for the NovaProvider component.
  */
-type NovaProviderProps<TR, T extends Transaction<TR>, A> = {
-    adapters: TxAdapter<TR, T, A>[];
+type NovaProviderProps<T extends Transaction> = {
+    adapter: TxAdapter<T> | TxAdapter<T>[];
     connectedWalletAddress?: string;
     connectedAdapterType?: TransactionAdapter;
-    transactionsPool: TransactionPool<TR, T>;
-    actions?: TxActions;
+    transactionsPool: TransactionPool<T>;
     labels?: Partial<TuwaLabels>;
     features?: {
         toasts?: boolean;
@@ -199,16 +207,16 @@ type NovaProviderProps<TR, T extends Transaction<TR>, A> = {
         trackingTxModal?: boolean;
     };
     customization?: {
-        toast?: ToastTransactionCustomization<TR, T, A>;
-        walletInfoModal?: WalletInfoModalCustomization<TR, T, A>;
-        trackingTxModal?: TrackingTxModalCustomization<TR, T, A>;
+        toast?: ToastTransactionCustomization<T>;
+        walletInfoModal?: WalletInfoModalCustomization<T>;
+        trackingTxModal?: TrackingTxModalCustomization<T>;
     };
-} & Pick<ITxTrackingStore<TR, T, A>, 'closeTxTrackedModal' | 'handleTransaction' | 'initialTx'> & ToastContainerProps;
+} & Pick<ITxTrackingStore<T>, 'closeTxTrackedModal' | 'handleTransaction' | 'initialTx'> & ToastContainerProps;
 /**
  * The main component for the Nova UI ecosystem. It renders and orchestrates all
  * UI elements like toasts and modals, and provides the i18n context.
  */
-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;
+declare function NovaProvider<T extends Transaction>({ adapter, connectedWalletAddress, connectedAdapterType, transactionsPool, initialTx, handleTransaction, closeTxTrackedModal, labels, features, customization, ...toastProps }: NovaProviderProps<T>): react_jsx_runtime.JSX.Element;
 
 /**
  * Defines the props for the TransactionKey component.
@@ -216,7 +224,7 @@ declare function NovaProvider<TR, T extends Transaction<TR>, A>({ adapters, conn
  * @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'> & {
+type TransactionKeyProps<T extends Transaction> = Pick<NovaProviderProps<T>, 'adapter' | 'transactionsPool'> & {
     /** The transaction object to display identifiers for. */
     tx: T;
     /** The visual variant, which applies different container styles. */
@@ -228,19 +236,21 @@ type TransactionKeyProps<TR, T extends Transaction<TR>, A> = Pick<NovaProviderPr
      * If not provided, the default `HashLink` component will be used.
      */
     renderHashLink?: (props: HashLinkProps) => ReactNode;
+    /** Optional number of confirmations for a transaction. */
+    confirmations?: number;
 };
 /**
  * A component that intelligently displays the relevant keys and hashes for a transaction.
  * 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, }: TransactionKeyProps<TR, T, A>): react_jsx_runtime.JSX.Element | null;
+declare function TransactionKey<T extends Transaction>({ tx, adapter, transactionsPool, variant, className, renderHashLink, confirmations, }: TransactionKeyProps<T>): react_jsx_runtime.JSX.Element | null;
 
 /**
  * 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>> = {
+type TransactionStatusBadgeProps<T extends Transaction> = {
     /** The transaction object whose status will be displayed. */
     tx: T;
     /** Optional additional CSS classes to apply to the badge container. */
@@ -250,7 +260,7 @@ 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.
  */
-declare function TransactionStatusBadge<TR, T extends Transaction<TR>>({ tx, className, }: TransactionStatusBadgeProps<TR, T>): react_jsx_runtime.JSX.Element;
+declare function TransactionStatusBadge<T extends Transaction>({ tx, className }: TransactionStatusBadgeProps<T>): react_jsx_runtime.JSX.Element;
 
 /**
  * @file This file contains the `ToastTransaction` component, which serves as the main body for a transaction notification toast.
@@ -260,30 +270,30 @@ type CustomActionButtonProps = {
     onClick: () => void;
     children: ReactNode;
 };
-type ToastTransactionCustomization<TR, T extends Transaction<TR>, A> = {
+type ToastTransactionCustomization<T extends Transaction> = {
     components?: {
         StatusAwareText?: ComponentType<StatusAwareTextProps>;
-        TransactionKey?: ComponentType<TransactionKeyProps<TR, T, A>>;
-        StatusBadge?: ComponentType<TransactionStatusBadgeProps<TR, T>>;
+        TransactionKey?: ComponentType<TransactionKeyProps<T>>;
+        StatusBadge?: ComponentType<TransactionStatusBadgeProps<T>>;
         WalletInfoButton?: ComponentType<CustomActionButtonProps>;
         SpeedUpButton?: ComponentType<CustomActionButtonProps>;
         CancelButton?: ComponentType<CustomActionButtonProps>;
     };
 };
-type ToastTransactionProps<TR, T extends Transaction<TR>, A> = {
+type ToastTransactionProps<T extends Transaction> = {
     tx: T;
     openWalletInfoModal?: () => void;
     icon?: ReactNode;
     className?: string;
-    customization?: ToastTransactionCustomization<TR, T, A>;
+    customization?: ToastTransactionCustomization<T>;
     closeToast?: ToastContentProps['closeToast'];
     toastProps?: ToastContainerProps;
-} & Pick<NovaProviderProps<TR, T, A>, 'transactionsPool' | 'adapters' | 'connectedWalletAddress'>;
+} & Pick<NovaProviderProps<T>, 'transactionsPool' | 'adapter' | 'connectedWalletAddress'>;
 /**
  * A composite component that renders the content for a transaction toast notification.
  * 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;
+declare function ToastTransaction<T extends Transaction>({ openWalletInfoModal, tx, transactionsPool, icon, className, customization, connectedWalletAddress, adapter, }: ToastTransactionProps<T>): JSX.Element;
 
 /**
  * @file This file contains the `TxErrorBlock` component for displaying transaction error messages.
@@ -305,23 +315,23 @@ type CustomInfoRowProps = {
     label: ReactNode;
     value: ReactNode;
 };
-type TxInfoBlockCustomization<TR, T extends Transaction<TR>, A> = {
+type TxInfoBlockCustomization<T extends Transaction> = {
     components?: {
         InfoRow?: ComponentType<CustomInfoRowProps>;
-        transactionKey?: TransactionKeyProps<TR, T, A>['renderHashLink'];
+        transactionKey?: TransactionKeyProps<T>['renderHashLink'];
     };
 };
-type TxInfoBlockProps<TR, T extends Transaction<TR>, A> = {
+type TxInfoBlockProps<T extends Transaction> = {
     /** 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'>;
+    customization?: TxInfoBlockCustomization<T>;
+} & Pick<NovaProviderProps<T>, 'adapter' | 'transactionsPool'>;
 /**
  * A component that displays a block of essential transaction details,
- * such as network, start time, and relevant hashes/keys.
+ * such as network, timestamps, Solana-specific details, and relevant hashes/keys.
  */
-declare function TxInfoBlock<TR, T extends Transaction<TR>, A>({ tx, adapters, transactionsPool, className, customization, }: TxInfoBlockProps<TR, T, A>): react_jsx_runtime.JSX.Element;
+declare function TxInfoBlock<T extends Transaction>({ tx, adapter, transactionsPool, className, customization, }: TxInfoBlockProps<T>): react_jsx_runtime.JSX.Element | null;
 
 type StepStatus = 'active' | 'completed' | 'error' | 'inactive' | 'replaced';
 type StepProps = {
@@ -377,7 +387,7 @@ type CustomFooterProps = {
     canReplace?: boolean;
     connectedWalletAddress?: string;
 };
-type TrackingTxModalCustomization<TR, T extends Transaction<TR>, A> = {
+type TrackingTxModalCustomization<T extends Transaction> = {
     modalProps?: Partial<ComponentPropsWithoutRef<typeof Dialog.Content>>;
     motionProps?: MotionProps;
     components?: {
@@ -385,21 +395,21 @@ type TrackingTxModalCustomization<TR, T extends Transaction<TR>, A> = {
         Footer?: ComponentType<CustomFooterProps>;
         StatusVisual?: ComponentType<TxStatusVisualProps>;
         ProgressIndicator?: ComponentType<TxProgressIndicatorProps>;
-        InfoBlock?: ComponentType<TxInfoBlockProps<TR, T, A>>;
+        InfoBlock?: ComponentType<TxInfoBlockProps<T>>;
         ErrorBlock?: ComponentType<TxErrorBlockProps>;
     };
 };
-type TrackingTxModalProps<TR, T extends Transaction<TR>, A> = Pick<NovaProviderProps<TR, T, A>, 'handleTransaction' | 'initialTx' | 'actions' | 'transactionsPool' | 'adapters' | 'connectedWalletAddress'> & {
+type TrackingTxModalProps<T extends Transaction> = Pick<NovaProviderProps<T>, 'handleTransaction' | 'initialTx' | 'transactionsPool' | 'adapter' | 'connectedWalletAddress'> & {
     onClose: (txKey?: string) => void;
     onOpenWalletInfo: () => void;
     className?: string;
-    customization?: TrackingTxModalCustomization<TR, T, A>;
+    customization?: TrackingTxModalCustomization<T>;
 };
 /**
  * A detailed modal that displays the real-time status and lifecycle of a transaction.
  * It opens automatically for transactions initiated with `withTrackedModal: true`.
  */
-declare function TrackingTxModal<TR, T extends Transaction<TR>, A>({ adapters, onClose, onOpenWalletInfo, className, customization, transactionsPool, actions, handleTransaction, initialTx, connectedWalletAddress, }: TrackingTxModalProps<TR, T, A>): react_jsx_runtime.JSX.Element | null;
+declare function TrackingTxModal<T extends Transaction>({ adapter, onClose, onOpenWalletInfo, className, customization, transactionsPool, handleTransaction, initialTx, connectedWalletAddress, }: TrackingTxModalProps<T>): react_jsx_runtime.JSX.Element | null;
 
 /**
  * @file This file contains the `TransactionHistoryItem` component, which renders a single transaction
@@ -416,30 +426,30 @@ type CustomTimestampProps = {
  * 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> = {
+type TransactionHistoryItemCustomization<T extends Transaction> = {
     components?: {
         Icon?: ComponentType<CustomIconProps>;
         Title?: ComponentType<StatusAwareTextProps>;
         Description?: ComponentType<StatusAwareTextProps>;
         Timestamp?: ComponentType<CustomTimestampProps>;
-        StatusBadge?: ComponentType<TransactionStatusBadgeProps<TR, T>>;
-        TransactionKey?: ComponentType<TransactionKeyProps<TR, T, A>>;
+        StatusBadge?: ComponentType<TransactionStatusBadgeProps<T>>;
+        TransactionKey?: ComponentType<TransactionKeyProps<T>>;
     };
 };
-type TransactionHistoryItemProps<TR, T extends Transaction<TR>, A> = {
+type TransactionHistoryItemProps<T extends Transaction> = {
     /** The transaction object to display. */
     tx: T;
     /** An object to customize and override the default internal components. */
-    customization?: TransactionHistoryItemCustomization<TR, T, A>;
+    customization?: TransactionHistoryItemCustomization<T>;
     /** Optional additional CSS classes for the container. */
     className?: string;
-} & Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'transactionsPool'>;
+} & Pick<NovaProviderProps<T>, 'adapter' | 'transactionsPool'>;
 /**
  * A component that renders a single row in the transaction history list.
  * 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;
+declare function TransactionHistoryItem<T extends Transaction>({ tx, adapter, transactionsPool, className, customization, }: TransactionHistoryItemProps<T>): JSX.Element;
 
 type CustomPlaceholderProps = {
     title: string;
@@ -448,30 +458,28 @@ type CustomPlaceholderProps = {
 /**
  * Defines the customization options for the TransactionsHistory component.
  */
-type TransactionsHistoryCustomization<TR, T extends Transaction<TR>, A> = {
+type TransactionsHistoryCustomization<T extends Transaction> = {
     classNames?: {
         listWrapper?: string;
     };
     components?: {
         Placeholder?: ComponentType<CustomPlaceholderProps>;
-        HistoryItem?: ComponentType<TransactionHistoryItemProps<TR, T, A>>;
+        HistoryItem?: ComponentType<TransactionHistoryItemProps<T>>;
     };
 };
 /**
  * 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.
  */
-type TransactionsHistoryProps<TR, T extends Transaction<TR>, A> = Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'transactionsPool' | 'connectedWalletAddress'> & {
+type TransactionsHistoryProps<T extends Transaction> = Pick<NovaProviderProps<T>, 'adapter' | 'transactionsPool' | 'connectedWalletAddress'> & {
     className?: string;
-    customization?: TransactionsHistoryCustomization<TR, T, A>;
+    customization?: TransactionsHistoryCustomization<T>;
 };
 /**
  * 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;
+declare function TransactionsHistory<T extends Transaction>({ adapter, connectedWalletAddress, transactionsPool, className, customization, }: TransactionsHistoryProps<T>): react_jsx_runtime.JSX.Element;
 
 /**
  * @file This file contains the `WalletAddressDisplay` component, a UI element for showing a wallet address.
@@ -518,7 +526,7 @@ type NameRenderProps = {
 /**
  * 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'> & {
+type WalletHeaderProps<T extends Transaction> = Pick<NovaProviderProps<T>, 'adapter' | 'connectedAdapterType'> & {
     walletAddress?: string;
     explorerUrl?: string;
     className?: string;
@@ -531,7 +539,7 @@ type WalletHeaderProps<TR, T extends Transaction<TR>, A> = Pick<NovaProviderProp
  * 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;
+declare function WalletHeader<T extends Transaction>({ walletAddress, adapter, connectedAdapterType, className, renderAvatar, renderName, renderAddressDisplay, renderNoWalletContent, explorerUrl, }: WalletHeaderProps<T>): react_jsx_runtime.JSX.Element;
 
 type CustomHeaderProps = {
     closeModal: () => void;
@@ -539,7 +547,7 @@ type CustomHeaderProps = {
 /**
  * Defines the customization options for the WalletInfoModal.
  */
-type WalletInfoModalCustomization<TR, T extends Transaction<TR>, A> = {
+type WalletInfoModalCustomization<T extends Transaction> = {
     modalProps?: Partial<ComponentPropsWithoutRef<typeof Dialog.Content>>;
     motionProps?: MotionProps;
     classNames?: {
@@ -547,22 +555,22 @@ type WalletInfoModalCustomization<TR, T extends Transaction<TR>, A> = {
     };
     components?: {
         Header?: ComponentType<CustomHeaderProps>;
-        WalletInfo?: ComponentType<WalletHeaderProps<TR, T, A>>;
-        History?: ComponentType<TransactionsHistoryProps<TR, T, A>>;
+        WalletInfo?: ComponentType<WalletHeaderProps<T>>;
+        History?: ComponentType<TransactionsHistoryProps<T>>;
     };
 };
 /**
  * Defines the core props for the WalletInfoModal.
  */
-type WalletInfoModalProps<TR, T extends Transaction<TR>, A> = Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'connectedAdapterType' | 'connectedWalletAddress' | 'transactionsPool'> & {
+type WalletInfoModalProps<T extends Transaction> = Pick<NovaProviderProps<T>, 'adapter' | 'connectedAdapterType' | 'connectedWalletAddress' | 'transactionsPool'> & {
     isOpen?: boolean;
     setIsOpen: (value: boolean) => void;
-    customization?: WalletInfoModalCustomization<TR, T, A>;
+    customization?: WalletInfoModalCustomization<T>;
 };
 /**
  * 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;
+declare function WalletInfoModal<T extends Transaction>({ isOpen, setIsOpen, customization, adapter, connectedAdapterType, connectedWalletAddress, transactionsPool, }: WalletInfoModalProps<T>): react_jsx_runtime.JSX.Element;
 
 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 };