# Melee partner documentation

> Specifications Melee shares with integration partners. The first is the Resolver API: how an external party registers as a market resolver, approves each market before creation (evaluate → accept → live), receives triggers and lifecycle notifications, reports status, updates rules, and signs the Solana transactions Melee builds to resolve markets. Access requires the partner password; the "For agents" page explains how to authenticate programmatically.

Every page is available as Markdown at the same URL with `.md` appended, or by requesting the HTML URL with `Accept: text/markdown`. The complete corpus is at https://docs.melee.markets/llms-full.txt. The Melee Resolver API is described in OpenAPI 3.1 at https://docs.melee.markets/resolver-api/openapi.yaml (partner-implemented callbacks are under `webhooks`).

## Start here

- [Welcome](https://docs.melee.markets/index.md)
- [Overview](https://docs.melee.markets/resolver-api.md): What a Melee resolver is and the rules that shape everything else in this specification.
- [Your responsibilities](https://docs.melee.markets/resolver-api/expectations.md): What Melee expects from a resolver as a service provider, and the platform policies that apply to you.
- [Environments & testing](https://docs.melee.markets/resolver-api/environments.md): Devnet and mainnet, program ids that change over time, funding, and how to test your integration before going live.
- [For agents & automation](https://docs.melee.markets/resolver-api/agents.md): How automated clients and AI agents authenticate to this site with the partner password, discover its content, and read it as Markdown or OpenAPI.

## Resolver API — concepts and processes

- [Registration](https://docs.melee.markets/resolver-api/registration.md): The resolver record, its validation rules, and the two-step activation flow.
- [Keys](https://docs.melee.markets/resolver-api/keys.md): Which keys sign what, and why they are immutable per market.
- [Fees](https://docs.melee.markets/resolver-api/fees.md): What a resolver earns, which mint the up-front fee is charged in, and what happens on void.
- [Market acceptance](https://docs.melee.markets/resolver-api/acceptance.md): How a market becomes yours - the definition document, its hash, the confidence policy, and the evaluate, accept and live handshake.
- [Changes to a market](https://docs.melee.markets/resolver-api/changes.md): How a market's definition can change after you accept it, who may initiate each change, and exactly how you update the rules of a live market.
- [Lifecycle notifications](https://docs.melee.markets/resolver-api/lifecycle.md): The phase-change notifications you receive for every market you accepted.
- [Verifying the definition](https://docs.melee.markets/resolver-api/definition.md): How to check that the market you are asked to act on is the market you accepted, and which checks are independent of Melee.
- [Resolution walk-throughs](https://docs.melee.markets/resolver-api/lifecycles.md): Sequence diagrams for every way an accepted market reaches a result.
- [Failure modes](https://docs.melee.markets/resolver-api/errors.md): Every error code the Resolver API returns and what to do about it.

## Resolver API — endpoint reference

- [Authentication & conventions](https://docs.melee.markets/resolver-api/api.md): Base URL, request signing, idempotency, errors, rate limits and outcome references.
- [Endpoints you implement](https://docs.melee.markets/resolver-api/your-endpoints.md): Every endpoint Melee calls under your base URL, how requests are signed and delivered, what to return, and how your status is displayed.
- [Integration reference](https://docs.melee.markets/resolver-api/reference.md): Byte-exact definitions and test vectors for request signing, acceptance evidence, canonical JSON, outcome address derivation, and transaction signing.
- [Resolver management](https://docs.melee.markets/resolver-api/api/resolvers.md): Registering, activating, updating your record, thresholds, secrets, and platform reference data.
- [Markets and proposals](https://docs.melee.markets/resolver-api/api/markets.md): Drafts sent to you, the markets you resolve, their status, definition history, and changes.
- [Resolution actions](https://docs.melee.markets/resolver-api/api/actions.md): Propose, resolve, void, reject and claim fees. Each returns a transaction for you to sign.
- [Transactions](https://docs.melee.markets/resolver-api/api/transactions.md): Submitting signed transactions and tracking their status.

## Optional

- [Full corpus](https://docs.melee.markets/llms-full.txt): every page concatenated, ~166k characters
- [OpenAPI 3.1](https://docs.melee.markets/resolver-api/openapi.yaml): Melee Resolver API and partner webhooks
- [Sitemap](https://docs.melee.markets/sitemap.xml)
