Skip to Content
Draft v0.2 — this specification is under active design and may change before implementation.

Transactions

Method & pathPurpose
POST /transactions/{transactionId}Body { "signedTransaction": "<base64>" }. We verify the message is unchanged, broadcast, and wait up to 45 seconds for confirmed commitment. Returns { signature, status }. Accepts Idempotency-Key.
GET /transactions/{transactionId}{ status, signature?, error? } where status is one of Pending, Submitted, Confirmed, Failed, Expired.

While waiting, Melee re-sends the same signed transaction about every 2 seconds and stops once it has expired. A submission whose blockhash has expired answers 410 transaction_expired; request a new envelope.

If the call returns status: "Submitted", confirmation had not arrived within 45 seconds; poll GET until it is Confirmed, Failed or Expired. Confirmed means confirmed commitment on Solana; Melee’s own projections (lifecycle notifications, status) follow shortly after.

You may broadcast yourself, but then we learn of the result only from the chain and cannot attach it to your API history. Submitting through us is the supported path.

Status meanings

statusMeaning
PendingEnvelope issued, nothing submitted yet.
SubmittedBroadcast, awaiting confirmation.
ConfirmedConfirmed on-chain; signature is set.
FailedThe chain rejected it; see error.
ExpiredexpiresAt passed before a valid submission arrived, or its blockhash expired before it confirmed. Request a new envelope.

error object

{ "code": "market_not_active", "message": "The market is no longer in arbitration.", "programError": { "programId": "…", "code": 6216 } }

code is one of the codes in Failure modes, or chain_error for anything Melee does not translate. programError is present when a Melee program returned a custom error; the numeric code is opaque and is what to quote when you contact Melee.

Last updated on