Tutorials

Monitor Transactions

9min

Prerequisites

Before you start monitoring transactions, make sure you have:

  • Created an Account
  • Created a Project
  • Access to the Transactions page on your Maestro dashboard.


Overview

The Transaction Manager & Monitoring System enables you to track the entire lifecycle of all transactions submitted via the Maestro API. Stay updated on each transaction’s status—from pending in the mempool, to being accepted on-chain, rejected by a node, or rolled back by the network.

Real-time state change notifications are available via Webhooks created on the platform Transaction page.



Cardano Example

Document image


Supported Transaction States

Rejected

Rejected by the block producer due to an invalid transaction.

Pending

Transaction successfully submitted and waiting in a mempool to be accepted on-chain.

Failed

Communication to the node has failed.

Timedout (Coming Soon)

Transaction is in the mempool but has exceeded its configured time-to-live.

Onchain

Transaction is part of a minted block.

Rolledback

Transaction has been removed from the chain due to a network rollback.




Create a Webhook URL

  • Go to the Transaction page of your dashboard.
  • Scroll down to Transaction Events Listening
  • Click + Create webhook.
Document image

  • Select your project, give your webhook a name, and specify its URL.
Document image



Webhook Transaction Notifications

The webhook JSON payloads have the following schema:

JSON


Field

Description

tx_hash

Transaction hash.

state

Current state of the transaction.

timestamp

UTC timestamp of the transaction state change.

block_number

Block number that your transaction is in if it has been accepted on-chain.

metadata (coming soon)

Additional details about your transaction's state.