# Pelion

> Bittensor Decentralized Adjudication for onchain contracts.

## Docs

- [Architecture](https://docs.pelion.dev/how-it-works/architecture.md): Five layers, from application on Base to bonded cross-chain relay. The whole system in one page.
- [Economic security](https://docs.pelion.dev/how-it-works/economic-security.md): Attack cost analysis, multi-subnet defense, and the quantitative comparison to UMA.
- [Question lifecycle](https://docs.pelion.dev/how-it-works/question-lifecycle.md): From submit on Base to finalized payout. The state machine and edge cases.
- [UNRESOLVABLE and calibration](https://docs.pelion.dev/how-it-works/unresolvable.md): Why genuinely ambiguous questions need a structural escape valve, not a forced binary resolution.
- [Introduction](https://docs.pelion.dev/introduction.md): Bittensor Decentralized Adjudication for onchain contracts.
- [UMA's structural failures](https://docs.pelion.dev/problem/uma-failures.md): Why token-weighted voting cannot produce reliable post-event adjudication when market stakes exceed the voter base's market cap.
- [Why now](https://docs.pelion.dev/problem/why-now.md): Three independent trends that make a model-based adjudication protocol buildable in 2026.
- [Full technical specification](https://docs.pelion.dev/reference/full-spec.md): The canonical Pelion technical specification, v0.1.
- [Glossary](https://docs.pelion.dev/reference/glossary.md): Terms used across the Pelion documentation, specification, and source code.
- [Canonical schemas](https://docs.pelion.dev/reference/schemas.md): Field-by-field reference for Question, Verdict, EvidencePolicy, and PelionSynapse.
- [Governance](https://docs.pelion.dev/token/governance.md): Three-tier governance with quadratic voting, a council for disputed edge cases, and progressive decentralization.
- [Token mechanics](https://docs.pelion.dev/token/mechanics.md): Trading tax with auto-decay. Buyback and burn funded by treasury Bittensor emissions. Utility tied to protocol usage.
- [Treasury](https://docs.pelion.dev/token/treasury.md): How the treasury earns Bittensor emissions and converts them into Pelion token buyback and burn.
- [Benchmark methodology](https://docs.pelion.dev/whats-built/benchmark-methodology.md): What Priority 1 will measure against 18 months of Polymarket historical markets, and what good looks like.
- [Live example](https://docs.pelion.dev/whats-built/live-example.md): Install Pelion, set API keys, produce a real verdict.
- [Repository and modules](https://docs.pelion.dev/whats-built/repository.md): Four Python modules, canonical schemas locked, multi-provider AI council operational. What's in the repo right now.