Primary RPC Endpoint

This documentation is intended for advanced developers who already have experience interacting with bundle/transaction relays.

eth_sendBundle

This method is used to send transaction bundles to our builder. It mostly follows the standard bundle API with the following specifications:

{
  "jsonrpc": "2.0",
  "id": "42069",
  "method": "eth_sendBundle",
  "params": [{
    "txs": [],
    "blockNumber": "",
    "minTimestamp": null,
    "maxTimestamp": null,
    "revertingTxHashes": [],
    "refundPercent": null,
    "refundRecipient": null
  }]
}

- We return the bundle hash as a response.

CURL Example

curl -X POST "https://rpc.tbuilder.xyz" \
-H "Accept-Encoding: gzip, deflate" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "eth_sendBundle", "params": [{"txs": ["0x02f86701068085174876e80082520894b0ecf47e41807eaa02e8ba61a0dfa069f16c1b898080c080a0ead6ae58b718572d217d23cae5307e9380144a7e38803e91b851972b5c9bac96a0126ae5d19a0261d096ee840ea046e3c623ca3a26074c1e19c1a617577de15ca2"], "blockNumber": "0x11e64de", "refundRecipient": "0xC18163916EC707272d198f869431607658858A53", "refundPercent": 80}], "id": 2}'

eth_sendRawTransaction

Both eth_sendRawTransaction and eth_sendPrivateRawTransaction methods are used for sending private transactions to our builder. These methods do not provide revert protection. Transactions are kept private and arent shared in the P2P layer. Payload format:

{
  "jsonrpc": "2.0",
  "id": "42069",
  "method": "eth_sendRawTransaction",
  "params": ["signedRawTx"],
}

CURL Example

curl -X POST "https://rpc.tbuilder.xyz" \
-H "Accept-Encoding: gzip, deflate" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": "69420", "method": "eth_sendRawTransaction", "params": ["signedRawTx"]}'

Example response:

{
  "jsonrpc": "2.0",
  "id": "42069",
  "result": "0x..."
}