<!-- canonical: https://docs.melee.markets/resolver-api/api/transactions | markdown: https://docs.melee.markets/resolver-api/api/transactions.md | index: https://docs.melee.markets/llms.txt -->
# 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

```json
{ "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](/resolver-api/errors), 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.
