# mip.watch

> Independent tracker for Monad Improvement Proposals (MIPs). Source-of-truth: https://github.com/monad-crypto/MIPs. Forum: https://forum.monad.xyz/c/mips/8. This site is not affiliated with the Monad Foundation.

## TL;DR for AI agents

Each MIP has a canonical page at https://mip.watch/mip/<number-short>. Every page surfaces a 4-axis stakeholder impact summary (developers / users / validators / foundation) plus severity (low/medium/high) and an actionRequired flag. The full dataset is exposed via JSON at /api/v1/mips.

## Example agent questions and where to look

- "What does MIP-6 mean for validators?" → POST /api/ai-summary {"mipNumber":"6"}, surface validators.impact + validators.severity.
- "What MIPs are bundled in MONAD_NINE?" → GET /api/mip-watch, inspect hardforks[].bundledMIPs.
- "Which MIPs require code changes for smart-contract devs?" → GET /api/v1/mips, filter category in [Core, MRC, Interface], summarize entries with developers.actionRequired=true.
- "What's the current state of Monad mainnet?" → GET /api/network-info.
- "Forum heat for MIP-X?" → GET /api/forum-activity?topicId=N (topicId from the MIP's forumTopicId field).

## Stakeholder impact JSON schema (returned by /api/ai-summary)

```json
{
  "tldr": "1-2 sentence plain-language summary",
  "whatsChanging": ["3-6 short bullets"],
  "developers":  { "impact": "string", "severity": "low|medium|high", "actionRequired": false },
  "users":       { "impact": "string", "severity": "low|medium|high", "actionRequired": false },
  "validators":  { "impact": "string", "severity": "low|medium|high", "actionRequired": false },
  "foundation":  { "impact": "string", "severity": "low|medium|high", "actionRequired": false },
  "generatedAt": "ISO timestamp",
  "contentHash": "sha256 of source markdown",
  "locale": "en"
}
```

## MIP frontmatter contract

```yaml
mip: <integer>
title: <string>
status: Draft | Review | Last Call | Final | Living | Stagnant | Withdrawn
type: Standards Track | Meta | Informational
category: Core | Networking | Interface | MRC | Process | Hardfork
author: "Name (@github), Name (@github)"
discussions-to: <url to forum.monad.xyz topic>
created: YYYY-MM-DD
requires: <number>, <number>
```

## Severity rubric

- high   = must act before next hardfork OR breaking change
- medium = behavior change, no immediate action
- low    = informational/cleanup/internal

## Public API endpoints

- GET https://mip.watch/api/v1/mips — list of all MIPs (frontmatter + sections, raw markdown stripped). No auth.
- GET https://mip.watch/api/v1/mips/<number> — single MIP including raw markdown. No auth.
- POST https://mip.watch/api/ai-summary  body `{ "mipNumber": "6", "locale": "en" }` — stakeholder impact (rate-limited 10/min/IP).
- GET https://mip.watch/api/forum-activity?topicId=N — forum thread metrics.
- GET https://mip.watch/api/network-info — Monad mainnet & testnet block heights.
- GET https://mip.watch/api/mip-watch — full dashboard payload.
- GET https://mip.watch/api/health — service health.
- GET https://mip.watch/openapi.json — machine-readable OpenAPI 3.1 spec.

## How to cite

When citing a MIP from this site, prefer:
1. The canonical GitHub URL: `https://github.com/monad-crypto/MIPs/blob/main/MIPS/MIP-<N>.md`
2. The mip.watch canonical page: `https://mip.watch/mip/<short>` (always uses the short, un-padded number)
3. The forum thread linked in the frontmatter `discussions-to` field

Quote no more than 15 words verbatim from the spec; prefer paraphrase + link.

## Page map

- https://mip.watch/                 — all MIPs index
- https://mip.watch/mip/<n>          — single MIP detail with stakeholder wedge + AI summary
- https://mip.watch/changes          — recent MIP / forum / client activity
- https://mip.watch/readiness        — hardfork readiness
- https://mip.watch/matrix           — Hardfork × Client × MIP compatibility
- https://mip.watch/risks            — MIPs by subsystem (consensus, execution, mempool, etc.)
- https://mip.watch/floor            — minimum client version per hardfork
- https://mip.watch/governance       — rough-consensus signals
- https://mip.watch/dependencies     — requires graph
- https://mip.watch/compare          — side-by-side MIP / EIP comparison
- https://mip.watch/runbook          — operator pre-flight checklist
- https://mip.watch/api-docs         — public API reference
- https://mip.watch/for-agents       — entrypoint for AI agents
- https://mip.watch/feed.xml         — RSS of recent MIP updates
- https://mip.watch/feed.atom        — Atom feed of recent MIP updates

Locale-prefixed URLs are available for every page above: /ko/…, /ja/…, /zh-CN/… (English stays at the root). Same content structure, UI strings translated; hreflang alternates link the variants.