Transactions
| Method & path | Purpose |
|---|---|
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
status | Meaning |
|---|---|
Pending | Envelope issued, nothing submitted yet. |
Submitted | Broadcast, awaiting confirmation. |
Confirmed | Confirmed on-chain; signature is set. |
Failed | The chain rejected it; see error. |
Expired | expiresAt 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.