EvmTransaction

EvmTransaction = BaseTransaction & object

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

An EVM transaction. Trackers fill the on-chain fields (hash, nonce, fees, to, value, input) once the transaction details are available.

Type Declaration

adapter

adapter: OrbitAdapter.EVM

Always OrbitAdapter.EVM.

bundlerUrl?

optional bundlerUrl?: string

Custom bundler RPC URL used to track an ERC-4337 UserOperation. Stored with the transaction, so it is persisted to localStorage and passed to onRemoteCreate (a backend can track through the same bundler). Keep API keys out of this URL; pass them as pimlicoApiKey.

hash?

optional hash?: `0x${string}`

The on-chain transaction hash: the txKey for standard transactions, and the hash of the mined transaction for ERC-4337 and Safe once it is known.

input?

optional input?: `0x${string}`

The calldata of the transaction.

maxFeePerGas?

optional maxFeePerGas?: string

EIP-1559 max fee per gas, in wei, as a decimal string.

maxPriorityFeePerGas?

optional maxPriorityFeePerGas?: string

EIP-1559 max priority fee per gas, in wei, as a decimal string.

nonce?

optional nonce?: number

The nonce of the sender account.

pimlicoApiKey?

optional pimlicoApiKey?: string

Pimlico API key used to track an ERC-4337 UserOperation when no bundlerUrl is set. Persisted to localStorage with the transaction, so tracking can resume after a reload, but never passed to onRemoteCreate.

replacedReason?

optional replacedReason?: "repriced" | "cancelled" | "replaced" | "unknown"

What spent the nonce (set with status: Replaced): repriced is the same transaction with higher fees (a speed-up), so the money moved in the replacement; cancelled is a transfer of nothing to the sender, so it did not; replaced is any other transaction; unknown means the nonce was spent by a transaction that could not be found. Set by the on-chain trackers, not by the Safe tracker.

replacedTxHash?

optional replacedTxHash?: `0x${string}`

The hash of the transaction that replaced this one (set with status: Replaced). For Safe transactions it is the safeTxHash of the transaction executed instead. Absent when replacedReason is unknown.

replaces?

optional replaces?: `0x${string}`

The hash of the transaction this record replaced, when it is a speed-up: the same operation under a new hash. The replaced record stays in the pool as Replaced, with this record’s hash in replacedTxHash.

sender?

optional sender?: `0x${string}`

The sender as the chain reports it, read by the tracker. It owns nonce, so together they tell what became of the transaction when a node no longer returns its hash. It differs from from, the wallet, for a relayed transaction.

to?

optional to?: `0x${string}`

The recipient or contract address.

value?

optional value?: string

The native value sent, in wei, as a decimal string.