Transaction Failed

This error occurs when a client submits a transaction that was well-formed but was not included into the ledger due to some other failure. For example, a transaction may fail if:

  • The source account for transaction cannot pay the minimum fee.
  • The sequence number is incorrect.
  • One of the contained operations has failed such as a payment operation that overdraws the paying account.

In almost every case, this error indicates that the transaction submitted in the initial request will never succeed. There is one exception: a transaction that fails with the tx_bad_seq result code (as expressed in the result_code field of the error) may become valid in the future if the sequence number it used was too high.

Attributes

As with all errors Frontier returns, transaction_failed follows the Problem Details for HTTP APIs draft specification guide and thus has the following attributes:

Attribute Type Description
Type URL The identifier for the error. This is a URL that can be visited in the browser.
Title String A short title describing the error.
Status Number An HTTP status code that maps to the error.
Detail String A more detailed description of the error.
Instance String A token that uniquely identifies this request. Allows server administrators to correlate a client report with server log files.

In addition, the following additional data is provided in the extras field of the error:

Attribute Type Description
envelope_xdr String A base64-encoded representation of the TransactionEnvelope XDR whose failure triggered this response.
result_xdr String A base64-encoded representation of the TransactionResult XDR returned by digitalbits-core when submitting this transactions.
result_codes.transaction String The transaction result code returned by digitalbits-core.
result_codes.operations Array An array of strings, representing the operation result codes for each operation in the submitted transaction, if available.

Example

{
  "type":     "https://developer.digitalbits.io/frontier/reference/errors/transaction-failed.html",
  "title":    "Transaction Failed",
  "status":   400,
  "details":  "...",
  "instance": "d3465740-ec3a-4a0b-9d4a-c9ea734ce58a",
	"extras": {
		"envelope_xdr": "...",
		"result_xdr": "...",
    "result_codes": {
      "transaction": "tx_failed",
      "operations": [ "op_bad_auth" ]
    }
  }
}

Edit this doc in GitHub

THE FUTURE OF LOYALTY STARTS HERE

Stay up to date on the latest happenings at DigitalBits. Get the latest news.