Stellar - Broadcast Transaction Timeout

When attempting to broadcast a Stellar transaction, you may face an error looking as follows:

{
    "statusCode": 403,
    "errorCode": "xlm.broadcast.failed",
    "message": "Unable to broadcast transaction.",
    "cause": "Title: Timeout. Type:  Detail: Your request timed out before completing.  Please try your request again. If you are submitting a transaction make sure you are sending exactly the same transaction (with the same sequence number).."
 },

This error occurs when either:

  • Horizon has not received a confirmation from the Stellar Core server that the transaction you are trying to submit to the network was included in a ledger on time.
    • If you are using KMS, make sure it's checking for pending transactions faster (default 5 seconds).
  • Blockchain congestion.
    • Keep resubmitting the same transaction (with the same sequence number) and wait until it finally is added to a new ledger.
    • Increase the fee to prioritize your transaction vs others.

📘

Additional information is available at the following link.