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

Supported Transaction States

RejectedRejected by the block producer due to an invalid transaction.
PendingTransaction successfully submitted and waiting in a mempool to be accepted on-chain.
FailedCommunication to the node has failed.
Timedout (Coming Soon)Transaction is in the mempool but has exceeded its configured time-to-live.
OnchainTransaction is part of a minted block.
RolledbackTransaction 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.
  • Select your project, give your webhook a name, and specify its URL.

Webhook Transaction Notifications

The webhook JSON payloads have the following schema:
{
    "tx_hash": "84bc33c0336a91f1a42722da8e70b37…",
    "state": "onchain",
    "timestamp": "2023-01-06T06:37:23+00:00",
    "block_number": 8115321,
    "metadata": {...}
}
FieldDescription
tx_hashTransaction hash.
stateCurrent state of the transaction.
timestampUTC timestamp of the transaction state change.
block_numberBlock number that your transaction is in if it has been accepted on-chain.
metadata (coming soon)Additional details about your transaction’s state.