ETH Bundle-Trace
The Bundle-Trace service allows traders to check the status of a submitted bundle - see if it has been included on-chain or see what was it's status in bloXroute blocks.
The Bundle-Trace utility has a built-in rate limiting defined by the account tier.
Bundle-Trace returns the bundle hash and block number the bundle was sent to, together with the bundle's result.
REQUEST
parameters
auth_header
Allows the user to include the authentication in the URL string directly.
If the authentication is provided in both the header and the URL parameter, the one in the header will be used.
None
block_number
Allows the user to specify the block number they sent the bundle to. In case the bundle was sent to multiple blocks - this parameter is mandatory
None
RESPONSE
Examples
Bundle is on chain:
Bundle failed initial simulation- tx nonce too low
Potential Response components
Time when the bundle was received by bloXroute.
Initial simulation status - an error that occurred during initial simulation.
Effective gas price of the bundle.
Time the bundle was first included in bloXroute block.
% of how many blocks the bundle was included in.
Reason why the bundle was not included in our block - bundle conflicted/reverted/other bundles paid more.
% of how many blocks the bundle had final simulation errors in.
External builders - in case you chose to send your bundle to external builders, you can see when these builders received the bundle. Available builders are Titan, beaver and rsync.
On-chain status - see if the bundle was included in the on-chain block, some of the bundle's txs are included or the bundle is not included at all.
Rate Limiting
Bundle-Trace is limiting requests if they exceed 2 requests per second. In addition, each tier has a limit to how many requests per day are allowed.
Below are the tiers limits:
Ultra
60
Enterprise-Elite
60
Enterprise
20
Professional
4
Introductory
4
Last updated