<!-- canonical: https://docs.melee.markets/resolver-api/lifecycle | markdown: https://docs.melee.markets/resolver-api/lifecycle.md | index: https://docs.melee.markets/llms.txt -->
# Lifecycle notifications

You receive `POST {baseUrl}/lifecycle` when a market you accepted changes phase. Deliveries are at least once
(same `deliveryId` on retries) and may arrive out of order; order by `slot`.

| `event` | `reason` | Extra fields | Meaning |
|---|---|---|---|
| `Live` | `TradingStarted` | `earliestProposalTs` | Trading started; status polling begins. `earliestProposalTs` is when you may first propose or resolve |
| `Cancelled` | `CancelledBeforePresale` or `PresaleCancelled` | — | Market cancelled before launch; you will never be asked to resolve it |
| `Failed` | `PresaleRequirementsNotMet` | — | Presale did not meet its requirements; same consequence |
| `Voided` | `ResolverVoided`, or `PlatformVoided` with `platformVoidReason` one of `AuthorityDrift`, `DefinitionDrift`, `Operator` ([Platform void](/resolver-api/lifecycles#platform-void)) | `platformVoidReason?` | Market voided by you or by Melee |
| `Resolved` | `Resolved` | `outcomeIndex` | Market resolved |
| `AuthorityChanged` | `ProposerChanged` or `ResolverChanged` | `authorities` (new), `accepted` (what you accepted), `rationale?` (the creator's explanation, when the rotation went through Melee) | **Coming soon** ([Authority changes](/resolver-api/changes#authority-changes)): before launch, the market's keys no longer match what you accepted, and the market cannot launch until you re-accept via a change round or the key is reverted |

Payload:

```json
{
  "deliveryId": "1c3f…",
  "marketPubkey": "9xQe…",
  "bindingId": "…",
  "event": "Voided",
  "reason": "PlatformVoided",
  "platformVoidReason": "Operator",
  "fromState": "Arbitration",
  "toState": "Voided",
  "signature": "…",
  "slot": 312345678,
  "ts": 1789090000,
  "definitionVersion": 3,
  "definitionHash": "9f2a…"
}
```

`fromState` and `toState` use the on-chain state names (`Initialized`, `Pending`, `Presale`, `Live`,
`Arbitration`, `Resolved`, `Failed`, `Cancelled`, `Closed`, `Voided`). `signature` and `slot` are the
transaction that caused the transition and are absent on `AuthorityChanged` only when Melee reverted a key
off-chain before it landed. Respond `2xx`; we retry with exponential backoff for 24 hours.

Lifecycle events and your status reports are shown to users as a single timeline.
