@tuwaio/nova-transactions 0.4.5 → 0.4.7

package/README.md

@@ -1,203 +1,165 @@
-# TUWA Nova Transactions
+# @tuwaio/nova-transactions
 
 [![NPM Version](https://img.shields.io/npm/v/@tuwaio/nova-transactions.svg)](https://www.npmjs.com/package/@tuwaio/nova-transactions)
 [![License](https://img.shields.io/npm/l/@tuwaio/nova-transactions.svg)](./LICENSE)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/TuwaIO/nova-uikit/release.yml?branch=main)](https://github.com/TuwaIO/nova-uikit/actions)
 
-The official React UI component library for the Pulsar transaction engine. It provides a suite of pre-built, accessible, and highly customizable modals, toasts, and history widgets to visualize the entire transaction lifecycle.
+`@tuwaio/nova-transactions` is the **UI Components (L7)** package of the TUWA Ecosystem transaction lifecycle tracking system. It provides the visual layer to monitor, display, and manage active on-chain transactions, consuming state directly from the headless **[Pulsar Engine](https://github.com/TuwaIO/pulsar-core)** state machine.
 
----
-
-## 🏛️ Architecture
-
-This package provides the **View Layer** for TUWA's transaction tracking ecosystem. It works by consuming the state from your headless Pulsar store and rendering the appropriate UI. You must connect your Pulsar store's state and actions to the `<NovaTransactionsProvider />` component, which acts as a self-contained UI manager that renders modals and toasts.
+By coupling the UI manager to Pulsar stores, it automatically handles pending loaders, speed-up options, failure overlays, and success notifications, keeping the user in the loop even during congested block space periods.
 
 ---
 
-## ✨ Core Features
+## 🏛️ Core Capabilities
 
-- **🧩 Pre-built UI Suite:** A set of accessible components including `TrackingTxModal`, `TransactionsInfoModal`, and `ToastTransaction`, all managed internally by the `NovaTransactionsProvider`.
-- **🔌 Plug-and-Play Integration:** Once connected to your Pulsar store, the UI automatically reacts to all transaction state changes.
-- **🌐 Internationalization (custom version of i18n):** Built-in support for multiple languages with easy overrides for all text content via the `labels` prop.
-- **🎨 Highly Customizable:** Styled with `@tuwaio/nova-core` to be easily themed using CSS variables. Almost every sub-component can be replaced with your own implementation via the `customization` prop.
+- **🧩 Interactive Visual Nodes:** Built-in dialogs and widget cards (`TrackingTxModal` for individual status, `TransactionsInfoModal` for full transaction lists, and `ToastTransaction` feeds).
+- **🔌 Isolated Provider Hooks:** The `<NovaTransactionsProvider />` bridges your React tree with Pulsar's transaction history pools and signature polling events.
+- **🎨 Custom Styling overrides:** Style sub-components via CSS variables from `@tuwaio/nova-core` or replace components using the `customization` property.
+- **🌍 Dynamic Internationalization:** Supports overriding labels configuration to localize status messages (`pending`, `success`, `failed`, `replaced`) and actions.
 
 ---
 
 ## 💾 Installation
 
-### Basic Installation
-
-Install the main package:
-
 ```bash
-pnpm add @tuwaio/nova-transactions
+pnpm add @tuwaio/nova-transactions @tuwaio/nova-core @tuwaio/pulsar-core @tuwaio/pulsar-react
 ```
 
-### Peer Dependencies
+### Peer Dependencies Check
 
-This package requires several peer dependencies for UI rendering:
+Make sure your project contains the required layout and utility engines:
 
 ```bash
-# Core dependencies
-pnpm add @tuwaio/nova-core @tuwaio/pulsar-core @tuwaio/orbit-core
-
-# React ecosystem
-pnpm add react react-dom zustand immer
-
-# UI libraries
-pnpm add framer-motion @radix-ui/react-dialog @heroicons/react
-pnpm add react-toastify @web3icons/common @web3icons/react
-
-# Utilities
-pnpm add dayjs clsx tailwind-merge
-```
+# State & Utilities
+pnpm add zustand immer dayjs clsx tailwind-merge framer-motion
 
-### Complete Installation (All Packages)
-
-For a complete setup with all TUWA packages:
-
-```bash
-# Using pnpm (recommended), but you can use npm, yarn or bun as well
-pnpm add @tuwaio/nova-transactions @tuwaio/nova-core @tuwaio/pulsar-core @tuwaio/orbit-core react-toastify framer-motion @radix-ui/react-dialog @heroicons/react @web3icons/common @web3icons/react dayjs react immer zustand clsx tailwind-merge
+# Dialog Primitives & Notifications
+pnpm add @radix-ui/react-dialog @heroicons/react @web3icons/common @web3icons/react react-toastify
 ```
 
 ---
 
-## 🚀 Getting Started
+## 🚀 Quick Start Setup
 
-To use this library, you must render the `<NovaTransactionsProvider />` component at a high level in your application and pass the state and actions from your Pulsar store to it as props.
+### 1. Create the Transaction Store (Pulsar)
 
-Here is a complete example of a `src/providers/index.tsx` file that configures the entire system.
-
-### 1. Create Transaction Store
+Initialize the local-first persistent transaction store with chain-specific state adapters:
 
 ```tsx
-// src/hooks/txTrackingHooks.tsx
-import { createBoundedUseStore, createPulsarStore } from '@tuwaio/pulsar-core';
-import { evmAdapter } from '@tuwaio/pulsar-evm';
+// src/hooks/usePulsarStore.ts
+'use client';
 
-import { appChains, config } from '@/configs/wagmiConfig';
+import { createBoundedUseStore, createPulsarStore, Transaction } from '@tuwaio/pulsar-core';
+import { pulsarEvmAdapter } from '@tuwaio/pulsar-evm';
+import { pulsarSolanaAdapter } from '@tuwaio/pulsar-solana';
+import { wagmiConfig, appEVMChains, solanaRPCUrls } from '@/config/appConfig';
 
 const storageName = 'transactions-tracking-storage';
 
 export enum TxType {
-  example = 'example',
+  swap = 'swap',
 }
 
-type ExampleTx = Transaction & {
-  type: TxType.example;
-  payload: {
-    value: number;
-  };
+type SwapTx = Transaction & {
+  type: TxType.swap;
+  payload: { from: string; to: string; amount: string };
 };
 
-export type TransactionUnion = ExampleTx;
+export type TransactionUnion = SwapTx;
 
 export const usePulsarStore = createBoundedUseStore(
   createPulsarStore<TransactionUnion>({
     name: storageName,
-    adapter: evmAdapter(config, appChains),
+    adapter: [pulsarEvmAdapter(wagmiConfig, appEVMChains), pulsarSolanaAdapter({ rpcUrls: solanaRPCUrls })],
+    maxTransactions: 50, // prevent localStorage bloat
   }),
 );
 ```
 
-### 2. Setup Provider Component
+### 2. Setup the Transactions UI Provider
+
+Create a bridge component connecting your Pulsar store parameters and Satellite wallet state with the Nova Transactions UI:
 
 ```tsx
-// src/providers/NovaTransactionsProvider.tsx
-import { NovaTransactionsProvider as NP } from '@tuwaio/nova-transactions/providers';
-import { TransactionAdapter } from '@tuwaio/pulsar-core';
+// src/providers/NovaTransactionsWrapper.tsx
+'use client';
+
+import { useSatelliteConnectStore } from '@tuwaio/nova-connect/satellite';
+import { NovaTransactionsProvider as NTP } from '@tuwaio/nova-transactions/providers';
+import { getAdapterFromConnectorType } from '@tuwaio/orbit-core';
 import { useInitializeTransactionsPool } from '@tuwaio/pulsar-react';
-import { useAccount } from 'wagmi';
 
-import { usePulsarStore } from '@/hooks/txTrackingHooks';
+import { usePulsarStore } from '@/hooks/usePulsarStore';
 
-export function NovaTransactionsProvider() {
-  const transactionsPool = usePulsarStore((state) => state.transactionsPool);
+export function NovaTransactionsWrapper() {
+  const getAdapter = usePulsarStore((state) => state.getAdapter);
   const initialTx = usePulsarStore((state) => state.initialTx);
   const closeTxTrackedModal = usePulsarStore((state) => state.closeTxTrackedModal);
-  const handleTransaction = usePulsarStore((state) => state.handleTransaction);
+  const transactionsPool = usePulsarStore((state) => state.transactionsPool);
+  const executeTxAction = usePulsarStore((state) => state.executeTxAction);
   const initializeTransactionsPool = usePulsarStore((state) => state.initializeTransactionsPool);
-  const getAdapter = usePulsarStore((state) => state.getAdapter);
 
-  useInitializeTransactionsPool({ initializeTransactionsPool });
+  const activeConnection = useSatelliteConnectStore((state) => state.activeConnection);
 
-  const { address } = useAccount();
+  // Resume tracking for active pending signatures on mount
+  useInitializeTransactionsPool({ initializeTransactionsPool });
 
   return (
-    <NP
+    <NTP
       transactionsPool={transactionsPool}
       initialTx={initialTx}
       closeTxTrackedModal={closeTxTrackedModal}
-      handleTransaction={handleTransaction}
-      connectedWalletAddress={address}
-      connectedAdapterType={TransactionAdapter.EVM}
+      executeTxAction={executeTxAction}
+      connectedWalletAddress={activeConnection?.isConnected ? activeConnection.address : undefined}
+      connectedAdapterType={getAdapterFromConnectorType(activeConnection?.connectorType ?? 'evm:')}
       adapter={getAdapter()}
     />
   );
 }
 ```
 
-### 3. Integrate into App
+### 3. Usage in Action Buttons
 
-```tsx
-// src/providers/index.tsx
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { ReactNode } from 'react';
-import { WagmiProvider } from 'wagmi';
+Call the action wrapper to trigger on-chain operations and auto-render status modals:
 
-import { config } from '@/configs/wagmiConfig';
-
-import { NovaTransactionsProvider } from './NovaTransactionsProvider';
-
-const queryClient = new QueryClient();
+```tsx
+import { usePulsarStore, TxType } from '@/hooks/usePulsarStore';
+import { OrbitAdapter } from '@tuwaio/orbit-core';
+import { mainnet } from 'viem/chains';
+
+export function SwapButton() {
+  const executeTxAction = usePulsarStore((state) => state.executeTxAction);
+
+  const triggerSwap = async () => {
+    const swapFunction = async () => {
+      // Execute smart contract write method and return the hash
+      return '0x...';
+    };
+
+    await executeTxAction({
+      actionFunction: swapFunction,
+      onSuccess: (tx) => console.log('Transaction succeeded!', tx.hash),
+      params: {
+        type: TxType.swap,
+        adapter: OrbitAdapter.EVM,
+        desiredChainID: mainnet.id,
+        title: 'Swap ETH',
+        description: 'Swapping 1 ETH for USDC',
+        payload: { from: 'ETH', to: 'USDC', amount: '1' },
+        withTrackedModal: true, // opens tracking overlay automatically
+      },
+    });
+  };
 
-export function Providers({ children }: { children: ReactNode }) {
   return (
-    <WagmiProvider config={config}>
-      <QueryClientProvider client={queryClient}>
-        <NovaTransactionsProvider />
-        {children}
-      </QueryClientProvider>
-    </WagmiProvider>
+    <button onClick={triggerSwap} className="btn-primary">
+      Execute Swap
+    </button>
   );
 }
 ```
 
-## 🎨 Customization
-
-You can easily override the default English text by passing a `labels` prop, or replace entire components using the `customization` prop.
-
-```tsx
-<NovaTransactionsProvider
-  // 1. Override text labels
-  labels={{
-    statuses: {
-      pending: 'В обработке...',
-      success: 'Успешно!',
-      failed: 'Ошибка!',
-    },
-    // ... other keys
-  }}
-  customization={{
-    components: {
-      statusBadge: ({ tx }) => <MyCustomBadge status={tx.status} />,
-    },
-  }}
-  // ... other required props
-/>
-```
-
 ---
 
-## 🤝 Contributing & Support
-
-Contributions are welcome! Please read our main **[Contribution Guidelines](https://github.com/TuwaIO/workflows/blob/main/CONTRIBUTING.md)**.
-
-If you find this library useful, please consider supporting its development. Every contribution helps!
-
-[**➡️ View Support Options**](https://github.com/TuwaIO/workflows/blob/main/Donation.md)
-
 ## 📄 License
 
-This project is licensed under the **Apache-2.0 License** - see the [LICENSE](./LICENSE) file for details.
+Licensed under the **Apache-2.0 License**. See the [LICENSE](./LICENSE) file for details.

package/dist/{TransactionsInfoModal-Cd6hZioh.d.cts → TransactionsInfoModal-B4bKn2as.d.cts}

@@ -1,7 +1,7 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode, ComponentType, ComponentPropsWithoutRef, JSX } from 'react';
 import { ToastCloseButtonProps, DialogContent } from '@tuwaio/nova-core';
 import { TransactionStatus, Transaction, TxAdapter, TransactionPool, TxInMemoryPagination, ITxTrackingStore, InitialTransaction } from '@tuwaio/pulsar-core';
-import { ReactNode, ComponentType, ComponentPropsWithoutRef, JSX } from 'react';
 import { OrbitAdapter, TuwaErrorState } from '@tuwaio/orbit-core';
 import { ToastContentProps, ToastContainerProps } from 'react-toastify';
 import { MotionProps } from 'framer-motion';
@@ -35,7 +35,7 @@ type HashLinkProps = {
         linkIcon?: string;
     };
 };
-declare function HashLink({ label, hash, explorerUrl, variant, className, classNames }: HashLinkProps): react_jsx_runtime.JSX.Element;
+declare function HashLink({ label, hash, explorerUrl, variant, className, classNames }: HashLinkProps): react.JSX.Element;
 
 /**
  * @file This file contains the `StatusAwareText` component, which displays different text based on a transaction's status.
@@ -518,7 +518,7 @@ type NovaTransactionsProviderProps<T extends Transaction> = {
  *
  * @template T The specific transaction type, extending the base `Transaction`.
  */
-declare function NovaTransactionsProvider<T extends Transaction>({ adapter, connectedWalletAddress, connectedAdapterType, transactionsPool, initialTx, executeTxAction, closeTxTrackedModal, labels, features, customization, pagination, ...toastProps }: NovaTransactionsProviderProps<T>): react_jsx_runtime.JSX.Element;
+declare function NovaTransactionsProvider<T extends Transaction>({ adapter, connectedWalletAddress, connectedAdapterType, transactionsPool, initialTx, executeTxAction, closeTxTrackedModal, labels, features, customization, pagination, ...toastProps }: NovaTransactionsProviderProps<T>): react.JSX.Element;
 
 type TransactionKeyProps<T extends Transaction> = Pick<NovaTransactionsProviderProps<T>, 'adapter'> & {
     tx: T;
@@ -531,7 +531,7 @@ type TransactionKeyProps<T extends Transaction> = Pick<NovaTransactionsProviderP
     /** ClassNames for original hash link in replaced transactions (falls back to hashLinkClassNames) */
     originalHashLinkClassNames?: HashLinkProps['classNames'];
 };
-declare function TransactionKey<T extends Transaction>({ tx, adapter, variant, className, renderHashLink, confirmations, hashLinkClassNames, originalHashLinkClassNames, }: TransactionKeyProps<T>): react_jsx_runtime.JSX.Element | null;
+declare function TransactionKey<T extends Transaction>({ tx, adapter, variant, className, renderHashLink, confirmations, hashLinkClassNames, originalHashLinkClassNames, }: TransactionKeyProps<T>): react.JSX.Element | null;
 
 type TransactionStatusBadgeProps<T extends Transaction> = {
     tx: T;
@@ -546,7 +546,7 @@ type TransactionStatusBadgeProps<T extends Transaction> = {
         label?: string;
     };
 };
-declare function TransactionStatusBadge<T extends Transaction>({ tx, className, classNames, }: TransactionStatusBadgeProps<T>): react_jsx_runtime.JSX.Element;
+declare function TransactionStatusBadge<T extends Transaction>({ tx, className, classNames, }: TransactionStatusBadgeProps<T>): react.JSX.Element;
 
 /**
  * @file This file contains the `ToastTransaction` component, which serves as the main body for a transaction notification toast.
@@ -716,7 +716,7 @@ type TrackingTxModalProps<T extends Transaction> = Pick<NovaTransactionsProvider
     className?: string;
     customization?: TrackingTxModalCustomization<T>;
 };
-declare function TrackingTxModal<T extends Transaction>({ adapter, onClose, onOpenAllTransactions, className, customization, transactionsPool, executeTxAction, initialTx, connectedWalletAddress, }: TrackingTxModalProps<T>): react_jsx_runtime.JSX.Element | null;
+declare function TrackingTxModal<T extends Transaction>({ adapter, onClose, onOpenAllTransactions, className, customization, transactionsPool, executeTxAction, initialTx, connectedWalletAddress, }: TrackingTxModalProps<T>): react.JSX.Element | null;
 
 type TxErrorBlockClassNames = {
     /** Classes for the container */
@@ -747,7 +747,7 @@ type TxErrorBlockProps = {
  * It includes a title, an icon, the error message in a scrollable area,
  * and a button to copy the message to the clipboard.
  */
-declare function TxErrorBlock({ error, className, classNames }: TxErrorBlockProps): react_jsx_runtime.JSX.Element | null;
+declare function TxErrorBlock({ error, className, classNames }: TxErrorBlockProps): react.JSX.Element | null;
 
 type CustomInfoRowProps = {
     label: ReactNode;
@@ -793,7 +793,7 @@ type TxInfoBlockProps<T extends Transaction> = {
  * A component that displays a block of essential transaction details,
  * such as network, timestamps, Solana-specific details, and relevant hashes/keys.
  */
-declare function TxInfoBlock<T extends Transaction>({ tx, adapter, className, customization }: TxInfoBlockProps<T>): react_jsx_runtime.JSX.Element | null;
+declare function TxInfoBlock<T extends Transaction>({ tx, adapter, className, customization }: TxInfoBlockProps<T>): react.JSX.Element | null;
 
 type StepStatus = 'active' | 'completed' | 'error' | 'inactive' | 'replaced';
 /** ClassNames for step styling overrides */
@@ -830,7 +830,7 @@ interface TxProgressIndicatorProps {
     /** ClassNames for step customization */
     stepClassNames?: StepClassNames;
 }
-declare function TxProgressIndicator({ isProcessing, isSucceed, isFailed, isReplaced, className, StepComponent, stepClassNames, }: TxProgressIndicatorProps): react_jsx_runtime.JSX.Element;
+declare function TxProgressIndicator({ isProcessing, isSucceed, isFailed, isReplaced, className, StepComponent, stepClassNames, }: TxProgressIndicatorProps): react.JSX.Element;
 
 /**
  * @file This file contains the `TxStatusVisual` component, which displays a large icon representing the transaction's status.
@@ -860,7 +860,7 @@ type TxStatusVisualProps = {
  * A component that renders a large, animated icon to visually represent the
  * current state of a transaction within the tracking modal.
  */
-declare function TxStatusVisual({ isProcessing, isSucceed, isFailed, isReplaced, className: containerClassName, iconClassNames, }: TxStatusVisualProps): react_jsx_runtime.JSX.Element;
+declare function TxStatusVisual({ isProcessing, isSucceed, isFailed, isReplaced, className: containerClassName, iconClassNames, }: TxStatusVisualProps): react.JSX.Element;
 
 /** Props for a copyable field block */
 type CopyableFieldProps = {
@@ -923,6 +923,7 @@ type TransactionDetailsCustomization = {
         statusIconContainer?: string;
         title?: string;
         subtitle?: string;
+        sectionHeader?: string;
         coreInfoCard?: string;
         networkBadge?: string;
         metadataSection?: string;
@@ -953,7 +954,7 @@ type TransactionDetailsProps<T extends Transaction> = Pick<NovaTransactionsProvi
 /**
  * TransactionDetails component provides a deep look into a specific transaction's metadata and execution state.
  */
-declare function TransactionDetails<T extends Transaction>({ tx, onBack, adapter, className, customization, }: TransactionDetailsProps<T>): react_jsx_runtime.JSX.Element;
+declare function TransactionDetails<T extends Transaction>({ tx, onBack, adapter, className, customization, }: TransactionDetailsProps<T>): react.JSX.Element;
 
 /**
  * @file This file contains the `TransactionHistoryItem` component, which renders a single transaction
@@ -1130,7 +1131,7 @@ type TransactionsHistoryProps<T extends Transaction> = Pick<NovaTransactionsProv
     /** Whether transaction details can be viewed by clicking on history items. Defaults to true. */
     canViewDetails?: boolean;
 };
-declare function TransactionsHistory<T extends Transaction>({ adapter, connectedWalletAddress, transactionsPool, className, customization, pagination, initialTxKey, canViewDetails, }: TransactionsHistoryProps<T>): react_jsx_runtime.JSX.Element;
+declare function TransactionsHistory<T extends Transaction>({ adapter, connectedWalletAddress, transactionsPool, className, customization, pagination, initialTxKey, canViewDetails, }: TransactionsHistoryProps<T>): react.JSX.Element;
 
 type CustomHeaderProps = {
     closeModal: () => void;
@@ -1165,6 +1166,6 @@ type TransactionsInfoModalProps<T extends Transaction> = Pick<NovaTransactionsPr
     /** Optional transaction key to open directly in detail view */
     selectedTxKey?: string | null;
 };
-declare function TransactionsInfoModal<T extends Transaction>({ isOpen, setIsOpen, customization, adapter, connectedWalletAddress, transactionsPool, pagination, selectedTxKey, }: TransactionsInfoModalProps<T>): react_jsx_runtime.JSX.Element;
+declare function TransactionsInfoModal<T extends Transaction>({ isOpen, setIsOpen, customization, adapter, connectedWalletAddress, transactionsPool, pagination, selectedTxKey, }: TransactionsInfoModalProps<T>): react.JSX.Element;
 
 export { type TxStatusVisualClassNames as $, type TransactionKeyProps as A, TransactionStatusBadge as B, type CopyableFieldProps as C, type DetailItemProps as D, type TransactionStatusBadgeProps as E, TransactionsHistory as F, type TransactionsHistoryCustomization as G, HashLink as H, type TransactionsHistoryLoaderProps as I, type JsonBlockProps as J, type TransactionsHistoryProps as K, TransactionsInfoModal as L, type MetadataRowProps as M, type NovaTransactionsLabels as N, type TransactionsInfoModalCustomization as O, type TransactionsInfoModalProps as P, TxErrorBlock as Q, type TxErrorBlockClassNames as R, StatusAwareText as S, ToastTransaction as T, type TxErrorBlockProps as U, TxInfoBlock as V, type TxInfoBlockCustomization as W, type TxInfoBlockProps as X, TxProgressIndicator as Y, type TxProgressIndicatorProps as Z, TxStatusVisual as _, type HashLinkProps as a, type TxStatusVisualProps as a0, NovaTransactionsProvider as a1, type NovaTransactionsProviderProps as a2, type StatusAwareTextProps as b, type StepClassNames as c, type StepProps as d, type StepStatus as e, type ToastTransactionCustomization as f, type ToastTransactionProps as g, ToastValidationError as h, type ToastValidationErrorClassNames as i, type ToastValidationErrorCopyContentProps as j, type ToastValidationErrorCustomization as k, type ToastValidationErrorFieldProps as l, type ToastValidationErrorIconProps as m, type ToastValidationErrorMessageProps as n, type ToastValidationErrorProps as o, type ToastValidationErrorTitleProps as p, TrackingTxModal as q, type TrackingTxModalCustomization as r, type TrackingTxModalProps as s, TransactionDetails as t, type TransactionDetailsCustomization as u, type TransactionDetailsProps as v, TransactionHistoryItem as w, type TransactionHistoryItemCustomization as x, type TransactionHistoryItemProps as y, TransactionKey as z };

package/dist/{TransactionsInfoModal-Cd6hZioh.d.ts → TransactionsInfoModal-B4bKn2as.d.ts}

@@ -1,7 +1,7 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode, ComponentType, ComponentPropsWithoutRef, JSX } from 'react';
 import { ToastCloseButtonProps, DialogContent } from '@tuwaio/nova-core';
 import { TransactionStatus, Transaction, TxAdapter, TransactionPool, TxInMemoryPagination, ITxTrackingStore, InitialTransaction } from '@tuwaio/pulsar-core';
-import { ReactNode, ComponentType, ComponentPropsWithoutRef, JSX } from 'react';
 import { OrbitAdapter, TuwaErrorState } from '@tuwaio/orbit-core';
 import { ToastContentProps, ToastContainerProps } from 'react-toastify';
 import { MotionProps } from 'framer-motion';
@@ -35,7 +35,7 @@ type HashLinkProps = {
         linkIcon?: string;
     };
 };
-declare function HashLink({ label, hash, explorerUrl, variant, className, classNames }: HashLinkProps): react_jsx_runtime.JSX.Element;
+declare function HashLink({ label, hash, explorerUrl, variant, className, classNames }: HashLinkProps): react.JSX.Element;
 
 /**
  * @file This file contains the `StatusAwareText` component, which displays different text based on a transaction's status.
@@ -518,7 +518,7 @@ type NovaTransactionsProviderProps<T extends Transaction> = {
  *
  * @template T The specific transaction type, extending the base `Transaction`.
  */
-declare function NovaTransactionsProvider<T extends Transaction>({ adapter, connectedWalletAddress, connectedAdapterType, transactionsPool, initialTx, executeTxAction, closeTxTrackedModal, labels, features, customization, pagination, ...toastProps }: NovaTransactionsProviderProps<T>): react_jsx_runtime.JSX.Element;
+declare function NovaTransactionsProvider<T extends Transaction>({ adapter, connectedWalletAddress, connectedAdapterType, transactionsPool, initialTx, executeTxAction, closeTxTrackedModal, labels, features, customization, pagination, ...toastProps }: NovaTransactionsProviderProps<T>): react.JSX.Element;
 
 type TransactionKeyProps<T extends Transaction> = Pick<NovaTransactionsProviderProps<T>, 'adapter'> & {
     tx: T;
@@ -531,7 +531,7 @@ type TransactionKeyProps<T extends Transaction> = Pick<NovaTransactionsProviderP
     /** ClassNames for original hash link in replaced transactions (falls back to hashLinkClassNames) */
     originalHashLinkClassNames?: HashLinkProps['classNames'];
 };
-declare function TransactionKey<T extends Transaction>({ tx, adapter, variant, className, renderHashLink, confirmations, hashLinkClassNames, originalHashLinkClassNames, }: TransactionKeyProps<T>): react_jsx_runtime.JSX.Element | null;
+declare function TransactionKey<T extends Transaction>({ tx, adapter, variant, className, renderHashLink, confirmations, hashLinkClassNames, originalHashLinkClassNames, }: TransactionKeyProps<T>): react.JSX.Element | null;
 
 type TransactionStatusBadgeProps<T extends Transaction> = {
     tx: T;
@@ -546,7 +546,7 @@ type TransactionStatusBadgeProps<T extends Transaction> = {
         label?: string;
     };
 };
-declare function TransactionStatusBadge<T extends Transaction>({ tx, className, classNames, }: TransactionStatusBadgeProps<T>): react_jsx_runtime.JSX.Element;
+declare function TransactionStatusBadge<T extends Transaction>({ tx, className, classNames, }: TransactionStatusBadgeProps<T>): react.JSX.Element;
 
 /**
  * @file This file contains the `ToastTransaction` component, which serves as the main body for a transaction notification toast.
@@ -716,7 +716,7 @@ type TrackingTxModalProps<T extends Transaction> = Pick<NovaTransactionsProvider
     className?: string;
     customization?: TrackingTxModalCustomization<T>;
 };
-declare function TrackingTxModal<T extends Transaction>({ adapter, onClose, onOpenAllTransactions, className, customization, transactionsPool, executeTxAction, initialTx, connectedWalletAddress, }: TrackingTxModalProps<T>): react_jsx_runtime.JSX.Element | null;
+declare function TrackingTxModal<T extends Transaction>({ adapter, onClose, onOpenAllTransactions, className, customization, transactionsPool, executeTxAction, initialTx, connectedWalletAddress, }: TrackingTxModalProps<T>): react.JSX.Element | null;
 
 type TxErrorBlockClassNames = {
     /** Classes for the container */
@@ -747,7 +747,7 @@ type TxErrorBlockProps = {
  * It includes a title, an icon, the error message in a scrollable area,
  * and a button to copy the message to the clipboard.
  */
-declare function TxErrorBlock({ error, className, classNames }: TxErrorBlockProps): react_jsx_runtime.JSX.Element | null;
+declare function TxErrorBlock({ error, className, classNames }: TxErrorBlockProps): react.JSX.Element | null;
 
 type CustomInfoRowProps = {
     label: ReactNode;
@@ -793,7 +793,7 @@ type TxInfoBlockProps<T extends Transaction> = {
  * A component that displays a block of essential transaction details,
  * such as network, timestamps, Solana-specific details, and relevant hashes/keys.
  */
-declare function TxInfoBlock<T extends Transaction>({ tx, adapter, className, customization }: TxInfoBlockProps<T>): react_jsx_runtime.JSX.Element | null;
+declare function TxInfoBlock<T extends Transaction>({ tx, adapter, className, customization }: TxInfoBlockProps<T>): react.JSX.Element | null;
 
 type StepStatus = 'active' | 'completed' | 'error' | 'inactive' | 'replaced';
 /** ClassNames for step styling overrides */
@@ -830,7 +830,7 @@ interface TxProgressIndicatorProps {
     /** ClassNames for step customization */
     stepClassNames?: StepClassNames;
 }
-declare function TxProgressIndicator({ isProcessing, isSucceed, isFailed, isReplaced, className, StepComponent, stepClassNames, }: TxProgressIndicatorProps): react_jsx_runtime.JSX.Element;
+declare function TxProgressIndicator({ isProcessing, isSucceed, isFailed, isReplaced, className, StepComponent, stepClassNames, }: TxProgressIndicatorProps): react.JSX.Element;
 
 /**
  * @file This file contains the `TxStatusVisual` component, which displays a large icon representing the transaction's status.
@@ -860,7 +860,7 @@ type TxStatusVisualProps = {
  * A component that renders a large, animated icon to visually represent the
  * current state of a transaction within the tracking modal.
  */
-declare function TxStatusVisual({ isProcessing, isSucceed, isFailed, isReplaced, className: containerClassName, iconClassNames, }: TxStatusVisualProps): react_jsx_runtime.JSX.Element;
+declare function TxStatusVisual({ isProcessing, isSucceed, isFailed, isReplaced, className: containerClassName, iconClassNames, }: TxStatusVisualProps): react.JSX.Element;
 
 /** Props for a copyable field block */
 type CopyableFieldProps = {
@@ -923,6 +923,7 @@ type TransactionDetailsCustomization = {
         statusIconContainer?: string;
         title?: string;
         subtitle?: string;
+        sectionHeader?: string;
         coreInfoCard?: string;
         networkBadge?: string;
         metadataSection?: string;
@@ -953,7 +954,7 @@ type TransactionDetailsProps<T extends Transaction> = Pick<NovaTransactionsProvi
 /**
  * TransactionDetails component provides a deep look into a specific transaction's metadata and execution state.
  */
-declare function TransactionDetails<T extends Transaction>({ tx, onBack, adapter, className, customization, }: TransactionDetailsProps<T>): react_jsx_runtime.JSX.Element;
+declare function TransactionDetails<T extends Transaction>({ tx, onBack, adapter, className, customization, }: TransactionDetailsProps<T>): react.JSX.Element;
 
 /**
  * @file This file contains the `TransactionHistoryItem` component, which renders a single transaction
@@ -1130,7 +1131,7 @@ type TransactionsHistoryProps<T extends Transaction> = Pick<NovaTransactionsProv
     /** Whether transaction details can be viewed by clicking on history items. Defaults to true. */
     canViewDetails?: boolean;
 };
-declare function TransactionsHistory<T extends Transaction>({ adapter, connectedWalletAddress, transactionsPool, className, customization, pagination, initialTxKey, canViewDetails, }: TransactionsHistoryProps<T>): react_jsx_runtime.JSX.Element;
+declare function TransactionsHistory<T extends Transaction>({ adapter, connectedWalletAddress, transactionsPool, className, customization, pagination, initialTxKey, canViewDetails, }: TransactionsHistoryProps<T>): react.JSX.Element;
 
 type CustomHeaderProps = {
     closeModal: () => void;
@@ -1165,6 +1166,6 @@ type TransactionsInfoModalProps<T extends Transaction> = Pick<NovaTransactionsPr
     /** Optional transaction key to open directly in detail view */
     selectedTxKey?: string | null;
 };
-declare function TransactionsInfoModal<T extends Transaction>({ isOpen, setIsOpen, customization, adapter, connectedWalletAddress, transactionsPool, pagination, selectedTxKey, }: TransactionsInfoModalProps<T>): react_jsx_runtime.JSX.Element;
+declare function TransactionsInfoModal<T extends Transaction>({ isOpen, setIsOpen, customization, adapter, connectedWalletAddress, transactionsPool, pagination, selectedTxKey, }: TransactionsInfoModalProps<T>): react.JSX.Element;
 
 export { type TxStatusVisualClassNames as $, type TransactionKeyProps as A, TransactionStatusBadge as B, type CopyableFieldProps as C, type DetailItemProps as D, type TransactionStatusBadgeProps as E, TransactionsHistory as F, type TransactionsHistoryCustomization as G, HashLink as H, type TransactionsHistoryLoaderProps as I, type JsonBlockProps as J, type TransactionsHistoryProps as K, TransactionsInfoModal as L, type MetadataRowProps as M, type NovaTransactionsLabels as N, type TransactionsInfoModalCustomization as O, type TransactionsInfoModalProps as P, TxErrorBlock as Q, type TxErrorBlockClassNames as R, StatusAwareText as S, ToastTransaction as T, type TxErrorBlockProps as U, TxInfoBlock as V, type TxInfoBlockCustomization as W, type TxInfoBlockProps as X, TxProgressIndicator as Y, type TxProgressIndicatorProps as Z, TxStatusVisual as _, type HashLinkProps as a, type TxStatusVisualProps as a0, NovaTransactionsProvider as a1, type NovaTransactionsProviderProps as a2, type StatusAwareTextProps as b, type StepClassNames as c, type StepProps as d, type StepStatus as e, type ToastTransactionCustomization as f, type ToastTransactionProps as g, ToastValidationError as h, type ToastValidationErrorClassNames as i, type ToastValidationErrorCopyContentProps as j, type ToastValidationErrorCustomization as k, type ToastValidationErrorFieldProps as l, type ToastValidationErrorIconProps as m, type ToastValidationErrorMessageProps as n, type ToastValidationErrorProps as o, type ToastValidationErrorTitleProps as p, TrackingTxModal as q, type TrackingTxModalCustomization as r, type TrackingTxModalProps as s, TransactionDetails as t, type TransactionDetailsCustomization as u, type TransactionDetailsProps as v, TransactionHistoryItem as w, type TransactionHistoryItemCustomization as x, type TransactionHistoryItemProps as y, TransactionKey as z };