bridge/interfaces/EthereumTransactionStatus.md
Ethereum transaction status from RPC query
Used by getEthereumTransactionStatus() to report the confirmation
status of Ethereum transactions (bridges, transfers, etc.)
get ethereum transaction status
Properties
| Property | Type | Description |
|---|
blockNumber? | number | Block number where transaction was mined. Present when transaction has been found on-chain. |
confirmations? | number | Number of confirmations since block inclusion. Calculated as (currentBlockNumber - blockNumber + 1). Higher values indicate stronger finality. |
confirmed | boolean | Whether the transaction has been successfully processed on-chain. - true: Transaction confirmed and executed successfully - false: Transaction not found, still pending, or failed |
effectiveGasPrice? | string | Effective gas price in wei (if mined). |
error? | string | Error details if transaction failed. Contains the revert reason or execution error. |
gasUsed? | string | Gas used by transaction (if mined). |
status | "failed" | "confirmed" | "finalized" | "not_found" | "pending" | Detailed status of the transaction: - 'pending': Transaction in mempool, not yet mined - 'confirmed': Transaction mined in block - 'finalized': Transaction finalized (12+ confirmations for safety) - 'not_found': Transaction not yet visible on-chain - 'failed': Transaction mined but execution failed (reverted) |
transactionHash | string | Transaction hash (normalized to lowercase). |
block number effective gas price used not found transaction hash