# Documentation

Sell a file, buy one, or build Annon into a platform. Every page here is also plain Markdown: add `.md` to its URL.

## Start

- [Overview](/docs/overview): What Annon is, how a sale works, and how to try it.
- [What can go wrong](/docs/what-can-go-wrong): What to do before, during and after a payment, refunds, and how to report a problem.
- [NEAR accounts](/docs/near-accounts): Selling and recovering with a NEAR account, and what it costs.
- [Agents: buying and selling through MCP](/docs/agents): What the owner sets up, the MCP client configuration, and the tools an agent calls to buy, open and sell.
- [Quick start: buy a file from the command line](/docs/quickstart): Install the annon CLI, buy a file, open it, and get it back on another computer.
- [Selling a file](/docs/selling): Encrypt a file, register its terms, and sell it through a shop or from your own host.
- [Shops, fees and limits](/docs/shops-and-limits): What the SDK, CLI and MCP server limit, and the hosting and sponsorship limits each shop sets.

## Reference

- [SDK](/docs/sdk): The @defdone/annon package: sell, buy, open, recover and verify from code.
- [Command line](/docs/cli): The annon command: configuration, commands and payment routes.
- [MCP server](/docs/mcp): Local stdio MCP tools for agents, owner settings and the safety model.
- [Agent skill](/docs/skill): The skill that teaches an agent to buy, open, recover, sell and verify Annon files.
- [Relayer](/docs/relayer): Sponsors NEAR transactions and runs the settlement keeper: configuration and limits.
- [Demo host](/docs/demo-host): The file host behind the demo: settings and how to run it.

## Specification

- [Settlement on NEAR](/spec/near-settlement): Terms, purchases, routes, payouts, refunds and key release in the contract.
- [PAY2 file format](/spec/pay2): How a file is encrypted, signed and checked before anyone pays.
- [Nonces](/spec/nonce): How purchase and payment nonces bind a payment to one purchase.
- [x402 profile](/spec/x402-annon): The 402 offers a file answers with, and the Base payment.
- [Downloads](/spec/download): How a buyer proves a purchase to a host.

## Project

- [Security policy](/docs/security-policy): How to report a vulnerability, alpha status, the trust model and known limits.
- [Roadmap](/docs/roadmap): What comes next.

## For agents

- [/llms.txt](/llms.txt): Index of every page for language models
- [/.well-known/annon.json](/.well-known/annon.json): Deployment, packages, install, payments and links as JSON
- [/.well-known/annon-shop.json](/.well-known/annon-shop.json): The demo shop manifest: annon shop add https://annon.dev
- [/docs/skill.md](/docs/skill.md): The skill file an agent loads
- [/api/status.json](/api/status.json): Is the relayer up, as JSON
- [/llms-full.txt](/llms-full.txt): Every docs page in one file
- [https://demo.annon.dev/files.json](https://demo.annon.dev/files.json): The demo shop catalog
- [/.well-known/annon.schema.json](/.well-known/annon.schema.json): JSON Schema of annon.json
- [/sitemap.xml](/sitemap.xml): Every page
