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

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.

eventreasonExtra fieldsMeaning
LiveTradingStartedearliestProposalTsTrading started; status polling begins. earliestProposalTs is when you may first propose or resolve
CancelledCancelledBeforePresale or PresaleCancelled—Market cancelled before launch; you will never be asked to resolve it
FailedPresaleRequirementsNotMet—Presale did not meet its requirements; same consequence
VoidedResolverVoided, or PlatformVoided with platformVoidReason one of AuthorityDrift, DefinitionDrift, Operator (Platform void)platformVoidReason?Market voided by you or by Melee
ResolvedResolvedoutcomeIndexMarket resolved
AuthorityChangedProposerChanged or ResolverChangedauthorities (new), accepted (what you accepted), rationale? (the creator’s explanation, when the rotation went through Melee)Coming soon (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:

{ "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.

Last updated on