Skip to main content
POST
cURL

Overview

The GetEdgeStatus endpoint returns the current status of an edge rail leg created by QuoteIntentEdge. Use it to track the external (Solana / Tron) bridge hop’s progress alongside the inner intent’s WaitIntentReceipt/GetIntentReceipt stream.

Request Parameters

Required Fields

  • edgeId (string): The Trails edge quote ID returned by QuoteIntentEdge. The server resolves the underlying relayRequestId and origin chain from this ID, then queries the external provider.

Response

  • status (string): The edge rail status. Maps to the EdgeStatus enum values: PENDING, DEPOSITED, FILLED, REFUNDED, FAILED.
  • initTransactionHash (string, optional): The Relay deposit (origin-side) transaction hash — on the rail chain when mode = ORIGIN, on the EVM handoff chain when mode = DESTINATION. Pair it with initChainId, never with the rail chain unconditionally.
  • initChainId (number, optional): Chain the init transaction executed on (Relay’s origin side).
  • fillTransactionHash (string, optional): The Relay fill (destination-side) transaction hash — on the rail chain when mode = DESTINATION, on the intent’s EVM origin chain when mode = ORIGIN. Pair it with fillChainId.
  • fillChainId (number, optional): Chain the fill transaction executed on (Relay’s destination side).
  • refundTransactionHash (string, optional): The Relay refund transaction hash. Refunds return on Relay’s origin side (same chain as the init transaction). Pair it with refundChainId.
  • refundChainId (number, optional): Chain the refund transaction executed on (Relay’s origin side).
  • transactionStates (array, optional): Detailed per-transaction state info.
  • failReason (string, optional): Populated when the edge rail failed.

Example

Next Steps

QuoteIntentEdge

Create the edge quote

WaitIntentReceipt

Stream the inner intent’s receipt updates

Body

application/json
edgeId
string
required

Response

OK

status
string
required
initTransactionHash
string
initChainId
number
fillTransactionHash
string
fillChainId
number
refundTransactionHash
string
refundChainId
number
transactionStates
object[]

[]TransactionStateInfo

failReason
string