Documentation
Architecture, methodology, and design references for Pharos. Human-readable pages are paired with markdown negotiation for agent consumption.
Start Here
High-signal public docs
Durable reference pages for external integrations, flow methodology, and the static-export architecture.
API integrators
API Reference
Endpoint authentication, response contracts, cache headers, pagination, and public dataset export details.
Flow analysts
Mint Burn Flows
Mint and burn ingestion, pressure scoring, Bank Run Gauge inputs, reconciliation, and historical backfill policy.
Maintainers
Architecture
Static export ownership, Cloudflare Pages and Worker lanes, crawl metadata, generated artifacts, and route maps.
System and Data
- API Reference
Public Pharos API contracts for stablecoin data: endpoints, authentication, response schemas, pagination, freshness headers, and dataset exports.
- Architecture
How Pharos is built: static Next.js export, Cloudflare Pages Functions, Worker API lanes, D1 storage, route ownership, and SEO metadata rules.
- Data Flow Map
Source-to-UI map for Pharos stablecoin data, covering market prices, peg monitoring, liquidity, report cards, alerts, and generated public artifacts.
- Data Pipeline
Stablecoin data pipeline guide for price enrichment, source priority, freshness checks, integrity guardrails, fallback behavior, and sync cadence.
- Worker and API Limits
Operational limits for the Pharos Worker and API: cron budgets, fetch connection caps, polling intervals, cache behavior, and guardrail checks.
Methodology
- Classification
Stablecoin classification methodology for peg currencies, backing models, governance labels, commodity pegs, lifecycle status, and taxonomy pages.
- Stablecoin Listing Policy
How Pharos admits, classifies, quarantines, delists, and preserves stablecoin records while separating catalog policy from runtime pricing failures.
- Pricing Pipeline
How Pharos computes stablecoin prices: source consensus, peg-aware validation, fallback enrichment, stale-data handling, and override policy.
- Depeg Detection
Depeg detection methodology covering two-stage confirmation, peg-score inputs, severity bands, event lifecycle, and recovery handling.
- DEWS
Depeg Early Warning System methodology: DEWS formula, stress sub-signals, bands, downgrade gates, and API response contract.
- DEX Liquidity
DEX Liquidity Score methodology for stablecoins: pool discovery, depth scoring, durability, pair diversity, cross-validation, and risk bands.
- Pharos Stability Index
Pharos Stability Index methodology explaining the PSI formula, active universe, stress bands, storage model, API surface, and replay rules.
- Report Cards
Stablecoin report-card methodology for safety scoring, peg risk, liquidity, reserves, resilience, decentralization, dependency exposure, and portfolios.
- Redemption Backstops
Redemption Backstops methodology for exit routes, redemption terms, effective-exit scoring, operational disclosures, and stored review evidence.
- Chain Health
Chain Health Score methodology for stablecoin networks: supply concentration, venue health, deployment coverage, risk factors, and score bands.
- Mint Burn Flows
Mint and burn flow methodology covering issuance-chain ingestion, pressure scoring, Bank Run Gauge inputs, reconciliation, and backfills.
- Yield Intelligence
Yield Intelligence methodology for stablecoin APY resolution, Pharos Yield Score, source confidence, reward warnings, and risk-adjusted ranking.
- Shadow Stablecoins
Shadow stablecoin policy for PSI-only assets, eligibility boundaries, UI exclusions, data handling, and why these assets stay out of main rankings.
Design
- Design Context
Pharos design context for product direction, user needs, brand posture, information density, and how the dashboard should feel in daily use.
- Design Language
Pharos design language reference for live UI patterns, typography, spacing, responsive behavior, visual hierarchy, and route-specific conventions.
- Design Tokens
Design token reference for Pharos CSS variables, semantic layers, colors, spacing, component styling, and token ownership rules.