Docs restructure

Community & Ecosystem/escrowly.mdx

@@ -1,9 +1,11 @@
 ---
 title: "Escrowly"
-description: "Alternative frontend for Kleros Escrow V1"
+description: "Alternative frontend for Kleros Escrow V1 (retired)"
 ---
 
-
+<Warning>
+**Retired.** Escrowly was a community-created Escrow interface, not officially affiliated with Kleros. It is no longer actively maintained - the app at [escrowly.eth.limo](https://escrowly.eth.limo) fails to load transactions. The content below is kept for historical reference.
+</Warning>
 
 **Escrowly** is a community-built alternative frontend for the Kleros Escrow V1 smart contracts. It provides a modern, user-friendly interface for creating and managing escrow transactions backed by Kleros dispute resolution.
 

ai-tools/mcp-server.mdx

@@ -4,7 +4,7 @@ description: "Use Kleros documentation as an AI context source via the Model Con
 icon: "robot"
 ---
 
-The Kleros documentation site exposes an **MCP (Model Context Protocol) server** that lets AI coding assistants — Claude, Cursor, VS Code Copilot, and others — query these docs directly as context when you are building a Kleros integration.
+The Kleros documentation site exposes an **MCP (Model Context Protocol) server** that lets AI coding assistants - Claude, Cursor, VS Code Copilot, and others - query these docs directly as context when you are building a Kleros integration.
 
 This means your AI assistant can answer questions like "what is the correct extraData encoding for V2?" or "show me the IArbitrableV2 interface" by reading the authoritative docs rather than relying on training data that may be outdated.
 

api-reference/introduction.mdx

@@ -1,7 +1,7 @@
 
 ---
 title: "API Reference"
-description: "HTTP API reference for the Kleros IPFS gateway — upload and retrieve dispute templates, evidence, and policy documents"
+description: "HTTP API reference for the Kleros IPFS gateway - upload and retrieve dispute templates, evidence, and policy documents"
 ---
 
 Every Kleros integration that involves jurors needs off-chain content: dispute templates that tell jurors what question to answer, evidence files that parties submit, and policy documents that define ruling criteria. All of this content is stored on IPFS and referenced on-chain by its CID.
@@ -33,11 +33,11 @@ https://cdn.kleros.link
 | Content | Where it's used | Schema |
 |---------|----------------|--------|
 | Dispute template JSON | `DisputeTemplateRegistry.setDisputeTemplate()` | [Dispute Templates](/reference/data-formats/dispute-templates) |
-| Evidence file JSON | `EvidenceModule` — submitted by parties during a dispute | [Evidence Format](/reference/data-formats/evidence-format) |
+| Evidence file JSON | `EvidenceModule` - submitted by parties during a dispute | [Evidence Format](/reference/data-formats/evidence-format) |
 | Policy document JSON | `policyURI` field in dispute templates | [Policy Format](/reference/data-formats/policy-format) |
 | Item attachment | Curate V2 item metadata | Column-based JSON schema |
 
-## Uploading content — SDK
+## Uploading content - SDK
 
 The `@kleros/kleros-sdk` wraps the gateway upload in a typed helper:
 

changelog/2026-04-14.mdx

@@ -19,7 +19,7 @@ You can now export your Foresight prediction history as a CSV file with UTC time
 
 ### Foresight onboarding guides
 
-New step-by-step guides walk first-time users through the [Foresight](/products/foresight) interface — covering how predictions work, the profit-and-loss mechanics, and the session timeline. An advanced guide with deeper strategy content is also shown on each prediction to help you improve.
+New step-by-step guides walk first-time users through the [Foresight](/products/foresight) interface - covering how predictions work, the profit-and-loss mechanics, and the session timeline. An advanced guide with deeper strategy content is also shown on each prediction to help you improve.
 
 ### Automatic Zodiac proposal verification
 
@@ -81,15 +81,15 @@ The SBT (Soulbound Token) contracts for the Argentina Consumer Protection experi
 
 ## Bug fixes
 
-- **Court network switch modal** — The modal prompting you to switch to the correct network now works properly even without a connected wallet and can be dismissed as expected.
-- **Court wallet connection popups** — Unnecessary wallet connection popups no longer appear when browsing cases.
-- **Dispute Resolver court redirects** — Links from the [Dispute Resolver](/legacy/resolver-v1) to Court now correctly specify the chain, preventing you from landing on the wrong network.
-- **Foresight prediction reset** — Predictions no longer reset unexpectedly after a successful submission.
-- **Foresight dark mode readability** — The advanced guide is now properly styled in dark mode.
-- **Foresight gas estimation** — Gas buffers are now capped to prevent unexpectedly high transaction fees.
-- **Curate registry display reliability** — In [Curate](/products/curate), a single malformed registry item no longer prevents other valid items from loading. The item list now gracefully handles errors so you always see the items that are available.
-- **Scout challenge date accuracy** — Challenge dates in [Scout](/products/scout) item timelines now display correctly.
-- **Escrow value formatting** — Small token amounts now display correctly instead of rounding to zero.
-- **Escrow seller role checks** — The UI now properly reflects seller-specific actions and conditions.
-- **Court smart contract audit fixes** — Several improvements from a security audit have been applied to the core dispute resolution contracts, including simplified reward distribution logic and more efficient event handling.
-- **Court type safety improvements** — Resolved edge cases where optional values in dispute timelines, evidence cards, and voting details could cause errors.
+- **Court network switch modal** - The modal prompting you to switch to the correct network now works properly even without a connected wallet and can be dismissed as expected.
+- **Court wallet connection popups** - Unnecessary wallet connection popups no longer appear when browsing cases.
+- **Dispute Resolver court redirects** - Links from the [Dispute Resolver](/legacy/resolver-v1) to Court now correctly specify the chain, preventing you from landing on the wrong network.
+- **Foresight prediction reset** - Predictions no longer reset unexpectedly after a successful submission.
+- **Foresight dark mode readability** - The advanced guide is now properly styled in dark mode.
+- **Foresight gas estimation** - Gas buffers are now capped to prevent unexpectedly high transaction fees.
+- **Curate registry display reliability** - In [Curate](/products/curate), a single malformed registry item no longer prevents other valid items from loading. The item list now gracefully handles errors so you always see the items that are available.
+- **Scout challenge date accuracy** - Challenge dates in [Scout](/products/scout) item timelines now display correctly.
+- **Escrow value formatting** - Small token amounts now display correctly instead of rounding to zero.
+- **Escrow seller role checks** - The UI now properly reflects seller-specific actions and conditions.
+- **Court smart contract audit fixes** - Several improvements from a security audit have been applied to the core dispute resolution contracts, including simplified reward distribution logic and more efficient event handling.
+- **Court type safety improvements** - Resolved edge cases where optional values in dispute timelines, evidence cards, and voting details could cause errors.

changelog/2026-04-28.mdx

@@ -21,4 +21,4 @@ Curate's attachment and file display has been overhauled with a dedicated header
 
 ## Bug fixes
 
-**Curate IPFS error handling** — Curate no longer breaks when IPFS data is temporarily unavailable. Affected items now degrade gracefully instead of blocking the rest of the registry view.
+**Curate IPFS error handling** - Curate no longer breaks when IPFS data is temporarily unavailable. Affected items now degrade gracefully instead of blocking the rest of the registry view.

changelog/2026-05-12.mdx

@@ -37,6 +37,6 @@ The "last policy change" timer in [Scout](/products/scout) now resolves the seco
 
 ## Bug fixes
 
-**Layout and scroll lock** — Modals on Scout no longer break page layout or leave the underlying page scrollable, and returning from a modal now restores your scroll position reliably.
+**Layout and scroll lock** - Modals on Scout no longer break page layout or leave the underlying page scrollable, and returning from a modal now restores your scroll position reliably.
 
-**Performance** — Reduced CPU usage on Scout dashboard and registry pages for smoother browsing on lower-powered devices.
+**Performance** - Reduced CPU usage on Scout dashboard and registry pages for smoother browsing on lower-powered devices.

changelog/2026-05-19.mdx

@@ -11,4 +11,4 @@ description: "Foresight ships a fix that displays accurate redemption values on
 
 ## Bug fixes
 
-**Accurate redemption values on Foresight** — Position and redemption amounts shown on resolved [Foresight](/products/foresight) markets now reflect the correct payout, so you can trust the figures before redeeming.
+**Accurate redemption values on Foresight** - Position and redemption amounts shown on resolved [Foresight](/products/foresight) markets now reflect the correct payout, so you can trust the figures before redeeming.

changelog/2026-05-25.mdx

@@ -21,6 +21,6 @@ Disputes related to JavaScript submissions in [Scout](/products/scout) now route
 
 ## Bug fixes
 
-**Rabby wallet on mainnet** — [Kleros Court](/court/overview) no longer crashes when connecting with Rabby (or other wallets that don't expose the legacy chain ID call) on mainnet. Contract bindings now resolve reliably across providers.
+**Rabby wallet on mainnet** - [Kleros Court](/court/overview) no longer crashes when connecting with Rabby (or other wallets that don't expose the legacy chain ID call) on mainnet. Contract bindings now resolve reliably across providers.
 
-**Success popup icon in Foresight** — The confirmation icon shown after submitting predictions in [Foresight](/products/foresight) now renders at the correct size.
+**Success popup icon in Foresight** - The confirmation icon shown after submitting predictions in [Foresight](/products/foresight) now renders at the correct size.

changelog/2026-06-15.mdx

@@ -29,8 +29,8 @@ The [Kleros Court V2](/court/overview) header and footer now align consistently
 
 ## Bug fixes
 
-**Cross-product security hardening** — [Court](/court/overview), [Curate](/products/curate) (classic and v2), [Dispute Resolver](/products/proof-of-humanity), and [Escrow](/products/escrow) (UI and V2) all received the same round of URL- and attachment-handling improvements. External links and attached files are now validated before they render, and untrusted links route through a warning screen so you can review the destination before leaving the app.
+**Cross-product security hardening** - [Court](/court/overview), [Curate](/products/curate) (classic and v2), [Dispute Resolver](/products/proof-of-humanity), and [Escrow](/products/escrow) (UI and V2) all received the same round of URL- and attachment-handling improvements. External links and attached files are now validated before they render, and untrusted links route through a warning screen so you can review the destination before leaving the app.
 
-**Proof of Humanity evidence mismatch** — [Dispute Resolver](/products/proof-of-humanity) no longer shows evidence from the wrong submission on Proof of Humanity cases. Evidence and metadata now stay tied to the correct dispute.
+**Proof of Humanity evidence mismatch** - [Dispute Resolver](/products/proof-of-humanity) no longer shows evidence from the wrong submission on Proof of Humanity cases. Evidence and metadata now stay tied to the correct dispute.
 
-**Notifications email save button in Escrow V2** — The Save button on the notification email form in [Escrow](/products/escrow) V2 now activates correctly when you enter a new address, so changes can be saved without refreshing the page.
+**Notifications email save button in Escrow V2** - The Save button on the notification email form in [Escrow](/products/escrow) V2 now activates correctly when you enter a new address, so changes can be saved without refreshing the page.

changelog/2026-06-29.mdx

@@ -21,4 +21,4 @@ The language selector in [Court V2](/court/overview) settings is now centered fo
 
 ## Bug fixes
 
-**File viewer URL hardening in Court V2** — The file viewer in [Court V2](/court/overview) now only loads files served over `http` or `https` and reuses the shared URL sanitizer used elsewhere in the app, so attached evidence and dispute files with unexpected or unsafe URL schemes are rejected before they can render.
+**File viewer URL hardening in Court V2** - The file viewer in [Court V2](/court/overview) now only loads files served over `http` or `https` and reuses the shared URL sanitizer used elsewhere in the app, so attached evidence and dispute files with unexpected or unsafe URL schemes are rejected before they can render.

concepts/pnk-token.mdx

@@ -0,0 +1,72 @@
+---
+title: "PNK Token"
+description: "The Kleros native token that creates the right incentives and prevents Sybil attacks"
+---
+
+# PNK Token
+
+**PNK** is the native token of the Kleros protocol. It serves two core functions: **staking for juror eligibility** and **governance voting rights**. Token holders stake PNK to participate in dispute resolution, with higher stakes increasing selection probability, and use it to vote on governance proposals, court parameters, and platform changes.
+
+The name references **Pinakions**, the bronze plates used in Ancient Athens for randomized jury selection.
+
+---
+
+## Token Supply
+
+The max PNK token supply is **915,528,222.07931277**. Supply changes are controlled exclusively through Kleros DAO governance votes.
+
+- Mainnet contract: [`0x93ED3FBe21207Ec2E8f2d3c3de6e058Cb73Bc04d`](https://etherscan.io/token/0x93ed3fbe21207ec2e8f2d3c3de6e058cb73bc04d)
+
+---
+
+## What PNK Is Used For
+
+| Function | How it works |
+| --- | --- |
+| **Juror staking** | Stake PNK in a court to become eligible for juror selection. Selection probability is proportional to stake. |
+| **Incentive alignment** | Coherent jurors earn arbitration fees and PNK redistributed from incoherent jurors; incoherent jurors lose part of their stake. |
+| **Governance** | PNK holders vote on Kleros Improvement Proposals (KIPs), court parameters, and protocol upgrades. |
+
+<Frame >
+  <img src="/images/PNK_hero.png"  />
+</Frame>
+
+---
+
+## [Why Kleros Needs a Native Token](https://medium.com/kleros/why-kleros-needs-a-native-token-5c6c6e39cdfe)
+
+PNK's design provides three layers of protection against a 51% [(Sybil) attack](https://en.wikipedia.org/wiki/Sybil_attack):
+
+1. **Market scarcity defense.** Acquiring 51% of PNK becomes economically prohibitive: large purchases exhaust available liquidity and drive the price up, unlike an attack denominated in ETH or another asset with vastly deeper markets.
+2. **Price impact risk.** A successful attack would substantially devalue PNK itself, imposing a massive cost on the attacker that does not exist when attacking with an external asset.
+3. **Fork capability.** As a last resort, the community can perform an emergency fork that removes the attacker's holdings, a recovery path unavailable with external tokens.
+
+
+---
+
+## How to Get PNK
+
+The fastest way is the [Buy PNK page of the Court](https://court.kleros.io/tokens), which routes to the exchanges listed there.
+
+| Venue type | Options |
+| --- | --- |
+| **DEX aggregators** (large trades) | Paraswap, 1inch |
+| **DEXs** (medium trades) | Uniswap, Sushiswap, Balancer |
+| **Centralized exchanges** | Bitfinex, Gate.io, OKX |
+| **Fiat onramp** | Guardarian |
+
+---
+
+## What's Next?
+
+<CardGroup cols={3}>
+  <Card title="Tokenomics" icon="chart-pie" href="/concepts/tokenomics">
+    The full economic model behind Kleros
+  </Card>
+  <Card title="Become a Juror" icon="user-plus" href="/tutorials/juror-tutorial-v1">
+    Stake PNK and start judging cases
+  </Card>
+  <Card title="Governance" icon="landmark" href="/governance/overview">
+    Vote with PNK on protocol decisions
+  </Card>
+</CardGroup>

concepts/sortition.mdx

@@ -83,6 +83,10 @@ Kleros V2 uses **Randomizer.io** as the primary random number source on the prod
 
 The RNG request is made with a configurable **lookahead** parameter, the random number depends on a future block, not the current one. This prevents the requester from knowing the outcome at request time.
 
+<Note>
+In Kleros V1, juror selection is built into the KlerosLiquid contract rather than a separate SortitionModule, and randomness comes from a blockhash-based source. V2 moves selection into the standalone SortitionModule and adds swappable RNG sources.
+</Note>
+
 ---
 
 ## Historical Context

court/appeals.mdx

@@ -7,7 +7,11 @@ sidebarTitle: "Appeals"
 
 
 
-The appeals system is a core feature of Kleros Court that ensures fairness and allows for error correction. Any party—or even third parties—can challenge a ruling by funding an appeal.
+The appeals system is a core feature of Kleros Court that ensures fairness and allows for error correction. Any party-or even third parties-can challenge a ruling by funding an appeal. [Read more here](https://blog.kleros.io/kleros-decentralized-token-listing-appeal-fees/)
+
+<Note>
+Appeal mechanics are fundamentally the same in V1 and V2. The V2-specific enhancements (such as Dispute Kit jumps) are labeled where they appear below.
+</Note>
 
 ---
 
@@ -136,7 +140,7 @@ Kleros V2 introduces significant improvements to court jumps:
 <CardGroup cols={2}>
 
 <Card title="Dispute Kit Jumps" icon="puzzle-piece">
-  If a parent court doesn't support the current dispute kit, the dispute can switch to a compatible kit—including complex question types.
+  If a parent court doesn't support the current dispute kit, the dispute can switch to a compatible kit-including complex question types.
 </Card>
 
 <Card title="Dynamic Juror Adjustment" icon="sliders">