pending
in a mempool, onchain
in a block, or rolledback
from a block. Capturing these state transitions in real-time is challenging and can lead to corrupted data in your application.

Service Availability
The Transaction Manager service is available on the following blockchains:Service | Bitcoin | Cardano | Dogecoin |
---|---|---|---|
Transaction Manager | Coming Soon | API Reference | Coming Soon |
Possible Transaction States
State | Description |
---|---|
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. |
Onchain | Transaction is part of a minted block. |
Rolledback | Transaction has been removed from the chain due to a network rollback or reorg |
Transaction Monitoring & Webhook Notification System
Maestro’s Transaction Manager is a state-of-the-art tool that abstracts away the complexity of managing blockchain transaction states. It provides a transaction monitoring dashboard and webhook notification system to track all transactions submitted with Maestro. This provides applications with the following benefits:1. On-submit transaction information
- Automatic Retries: Transactions that fail due to network issues are automatically resubmitted.
- Rejection Error Parsing: Transactions rejected by the node will return specific error messages, such as missing UTxOs or malformed transaction bodies.
- Pending Transaction State: Successfully submitted transactions are classified as
Pending
when entered into the mempool.
2. On-chain webhook notifications
- Onchain: Once a
Pending
transaction is included in a block, an Onchain webhook notification is sent. - Rolledback: If an
Onchain
transaction is dropped due to a rollback, aRollback
webhook notification is sent. - Timeouts: [Coming Soon] A transaction that remains in the mempool beyond its time-to-live will be marked as timed out and rejected.
Transaction State Machine
Transaction state transitions can best be understood with a state machine diagram.
Note: The state machine contains loops, meaning a transaction can transition through the same state multiple times before reaching an end state.
Onchain -> Rollback -> Onchain
Transaction Submission
All transactions submitted via Maestro’s specialized endpoint are recorded and tracked by the Transaction Manager. Below are the possible response codes:Response Code | Description | State Transition |
---|---|---|
200 | Valid submission | Start —> Pending |
400 | Invalid submission | Start —> Rejected |
500 | Network failure | Start —> Start (retry) —> Failed |
Common Use Cases
Webhooks are ideal for tracking continuously changing states of data, such as blockchain transactions. Maestro’s transaction notification system provides an efficient way for applications to react to on-chain events, enhancing user experience—particularly for time-sensitive applications.Examples of time-sensitive Web3 applications
- Submitting a trade on a DEX
- Placing a bid for an NFT auction
Turbo Transactions
The Turbo Transaction service is designed to supercharge your transaction submission process. It is a specialized system that employs various strategies to get your transaction on-chain as fast as possible. Whether the network is under heavy load or operating under normal conditions, Turbo Transactions ensures your transactions are added to the blockchain with utmost reliability and speed.This service is only included in subscriptions above the Artist tier.
Service Availability
The Turbo Transaction service is available on the following blockchains:Benefits of a transaction propagation system
- Outcompete transactions trying to consume highly sought-after UTxOs, particularly within intensive DeFi applications.
- Enhance the reliability of transaction submissions, particularly during periods of high network load.
- Accelerate transaction onchain confirmation and finality, providing an edge in time-sensitive operations.
