BaseTransaction

BaseTransaction = object

Defined in: packages/pulsar-core/src/types.ts:58

The fundamental structure for any transaction being tracked by Pulsar. This serves as the base upon which chain-specific transaction types are built.

Properties

chainId

chainId: number | string

Defined in: packages/pulsar-core/src/types.ts:60

The chain identifier (e.g., 1 for Ethereum Mainnet, ‘SN_MAIN’ for Starknet).

confirmations?

optional confirmations?: number | string | null

Defined in: packages/pulsar-core/src/types.ts:108

The number of confirmations received. A string value indicates a confirmed transaction, while null means it’s pending.

connectorType

connectorType: string

Defined in: packages/pulsar-core/src/types.ts:104

The type of connector used to sign the transaction (e.g., ‘injected’, ‘walletConnect’).

description?

optional description?: string | [string, string, string, string]

Defined in: packages/pulsar-core/src/types.ts:69

User-facing description. Can be a single string for all states, or a tuple for specific states.

Example


// A single description for all states
description: 'Swap 1 ETH for 1,500 USDC'
// Specific descriptions for each state in order: [pending, success, error, replaced]
description: ['Swapping...', 'Swapped Successfully', 'Swap Failed', 'Swap Replaced']

error?

optional error?: TuwaErrorState

Defined in: packages/pulsar-core/src/types.ts:71

The error state if the transaction failed, containing message and raw error details.

finishedTimestamp?

optional finishedTimestamp?: number

Defined in: packages/pulsar-core/src/types.ts:73

The on-chain timestamp (in seconds) when the transaction was finalized.

from

from: string

Defined in: packages/pulsar-core/src/types.ts:75

The sender’s wallet address.

isError?

optional isError?: boolean

Defined in: packages/pulsar-core/src/types.ts:77

A flag indicating if the transaction is in a failed state.

isTrackedModalOpen?

optional isTrackedModalOpen?: boolean

Defined in: packages/pulsar-core/src/types.ts:79

A UI flag to control the visibility of a detailed tracking modal for this transaction.

localTimestamp

localTimestamp: number

Defined in: packages/pulsar-core/src/types.ts:81

The local timestamp (in seconds) when the transaction was initiated by the user.

payload?

optional payload?: Record<string, string | number>

Defined in: packages/pulsar-core/src/types.ts:83

Custom data (strings or numbers) to associate with the transaction.

pending

pending: boolean

Defined in: packages/pulsar-core/src/types.ts:85

A flag indicating if the transaction is still awaiting on-chain confirmation.

requiredConfirmations?

optional requiredConfirmations?: number

Defined in: packages/pulsar-core/src/types.ts:106

The number of confirmations required for the transaction to be considered confirmed.

rpcUrl?

optional rpcUrl?: string

Defined in: packages/pulsar-core/src/types.ts:110

The RPC URL to use for the transaction. Required for Solana transactions.

status?

optional status?: TransactionStatus

Defined in: packages/pulsar-core/src/types.ts:87

The final on-chain status of the transaction.

title?

optional title?: string | [string, string, string, string]

Defined in: packages/pulsar-core/src/types.ts:96

User-facing title. Can be a single string for all states, or a tuple for specific states.

Example


// A single title for all states
title: 'ETH/USDC Swap'
// Specific titles for each state in order: [pending, success, error, replaced]
title: ['Processing Swap', 'Swap Complete', 'Swap Error', 'Swap Replaced']

tracker

tracker: TransactionTracker

Defined in: packages/pulsar-core/src/types.ts:98

The specific tracker responsible for monitoring this transaction’s status.

txKey

txKey: string

Defined in: packages/pulsar-core/src/types.ts:100

The unique identifier for the transaction (e.g., EVM hash, Solana signature, or Gelato task ID).

type

type: string

Defined in: packages/pulsar-core/src/types.ts:102

The application-specific type or category of the transaction (e.g., ‘SWAP’, ‘APPROVE’).