# TetraFi > Institutional cross-chain settlement with compliance-gated RFQ auction, DvP escrow, and WORM audit trail. The docs site at [/docs](/docs) is hand-authored MDX; this index exposes the canonical structure and deep links. Each page is also available as plain markdown at `/docs/raw/` for LLM ingestion. - Structured sitemap (JSON, with persona/status/ETA metadata): [/docs/raw/index.json](/docs/raw/index.json) - Concatenated full corpus (single-request ingestion): [/llms-full.txt](/llms-full.txt) ## Overview - [Core Concepts](https://tetrafi.io/docs/overview/concepts): Key terminology, the Intent Execution Stack, and a high-level overview of how a TetraFi trade works. - [Quick Reference](https://tetrafi.io/docs/overview/quick-reference): Single-page cheat sheet: API endpoints, SDK methods, settlement state machine, contract addresses, glossary, and key constants. - [For Takers](https://tetrafi.io/docs/personas/taker): Integrator pages for the Taker audience: submitting RFQs, accepting quotes, handling settlement events, and managing compliance state. - [For Solvers](https://tetrafi.io/docs/personas/solver): Integrator pages for the Solver audience: connecting pricing engines, running quote auctions, managing custody, and proving fills cross-chain. - [For Ops](https://tetrafi.io/docs/personas/ops): Operations pages: authentication, event delivery, error handling, compliance architecture, and audit trail evidence. - [FAQ](https://tetrafi.io/docs/faq): Common questions about the TetraFi protocol, SDK, compliance, settlement, and integration - aggregated across the whole doc corpus. - [Docs status](https://tetrafi.io/docs/status): Every doc page grouped by lifecycle status - a single board-level roadmap of what's shipped, in testnet, beta, planned, or experimental. - [Lint test - stub](https://tetrafi.io/docs/_lint-test-deliberate-break): Leftover stub from an R9 deliberate-break test. Safe to delete. ## Platform - [Platform Personas](https://tetrafi.io/docs/platform/personas): Four participant types: Direct Users, Companies, Brokers, and LPs - onboarding, workspace, and data visibility. - [Protocol Economics](https://tetrafi.io/docs/platform/economics): Fee structure, solver incentives, target order economics, and comparison with traditional OTC settlement. - [Discovery & Corridors](https://tetrafi.io/docs/platform/discovery): Network discovery, corridor configuration, member onboarding, and workspace management. ## Integration - [Integration](https://tetrafi.io/docs/integration): Connect to TetraFi - authentication, REST API, webhooks, SDK clients, and end-to-end guides for Takers and Solvers. - [Authentication](https://tetrafi.io/docs/integration/authentication): API key management, authentication headers, environments, rate limits, error handling, and pagination. - [Taker Integration Guide](https://tetrafi.io/docs/integration/taker-guide): Step-by-step guide for institutional takers to submit orders, receive quotes, and execute settlement. - [Solver Integration Guide](https://tetrafi.io/docs/integration/solver-guide): Step-by-step guide for solvers (market makers) to connect, price, and fill orders on TetraFi. - [REST API Reference](https://tetrafi.io/docs/integration/api-reference): Complete endpoint reference for quotes, orders, settlements, workspaces, solvers, and webhooks. - [Custody & Signing](https://tetrafi.io/docs/integration/custody): Fireblocks, AWS KMS, and hardware wallet integration for EIP-712 order signing and settlement. - [Webhooks & Events](https://tetrafi.io/docs/integration/events): Real-time WebSocket events, webhook configuration, signature verification, and retry logic. - [Error Code Registry](https://tetrafi.io/docs/integration/errors): Canonical reference for every API error code. Entries here mirror the inline tables in authentication, api-reference, and events - keep these synchronised. - [LLM-Ready Docs](https://tetrafi.io/docs/integration/llm-access): Plain-text index and raw-markdown routes for AI tools, LLM-aware IDEs, and code assistants ingesting TetraFi docs. - [MCP (Model Context Protocol)](https://tetrafi.io/docs/mcp): Connect Claude Desktop, Cursor, Windsurf, or any MCP-aware agent to the TetraFi docs corpus in one click. - [R10 verification — draft gate](https://tetrafi.io/docs/_r10-verify-draft): Temporary draft fixture for verifying the R10 draft-preview pipeline. ## Cookbook - [Cookbook](https://tetrafi.io/docs/cookbook): Browse runnable recipes by persona, language, and difficulty. Every card deep-links to a self-contained snippet in the one-page recipe book. - [Cookbook](https://tetrafi.io/docs/cookbook/recipes): Task-oriented recipes: common integration patterns, cross-chain workflows, compliance checks, and WebSocket usage. ## Architecture - [Architecture](https://tetrafi.io/docs/architecture): How the TetraFi settlement protocol is built - contracts, oracles, compliance, data, and the quote pipeline. - [Flow Explorer](https://tetrafi.io/docs/architecture/flow-explorer): A 5-phase tour of the TetraFi protocol - intent, compliance, quote auction, settlement, and audit - each phase mounting the authoritative diagram. - [Architecture Overview](https://tetrafi.io/docs/architecture/overview): Understand the TetraFi settlement protocol: 6-stage lifecycle, compliance layer, cross-chain architecture, and security model. - [Architecture Graph](https://tetrafi.io/docs/architecture/graph): One canvas showing how every TetraFi component connects - actors, engines, contracts, and oracles - with clickable deep links. - [Architecture Explorer](https://tetrafi.io/docs/architecture/explorer): Stage-by-stage traversal of the protocol - pick a phase to see just the components active in it, and click any node to open its reference doc. - [Flow Player](https://tetrafi.io/docs/architecture/flow-player): Watch a TetraFi settlement unfold step-by-step - 8-stage interactive playback with stage drilldowns, timeline controls, and clickable nodes. - [Settlement Flows](https://tetrafi.io/docs/architecture/settlement): Lock types, escrow models, settlement path routing, equivocation protection, and the fill/claim lifecycle. - [Oracle Network](https://tetrafi.io/docs/architecture/oracles): 7 cross-chain oracle implementations, relay mechanisms, attestation verification, and oracle selection per corridor. - [Intent Netting & Batch Auction](https://tetrafi.io/docs/architecture/intent-netting): Batch auction mechanics, CIP-67 fair winner selection, UCCP pricing, and four intent netting modes. - [Quote Pipeline & Auction](https://tetrafi.io/docs/architecture/quote-pipeline): RFQ auction mechanics, quote preferences, swap types, selection strategies, batch auctions, and intent netting. - [Smart Contracts](https://tetrafi.io/docs/architecture/contracts): On-chain contract reference: InputSettler, OutputSettler, ComplianceRegistry, oracle implementations, and deployment addresses. - [Compliance Architecture](https://tetrafi.io/docs/architecture/compliance): ComplianceRegistry attestation model, settlement path routing, KYC/KYB onboarding, Travel Rule, and WORM evidence ledger. - [Data Layer & Evidence](https://tetrafi.io/docs/architecture/data-layer): WORM evidence ledger, hash-chained audit trail, credit system, workspace model, and data archival. - [Architecture Comparisons](https://tetrafi.io/docs/architecture/comparisons): Side-by-side deep dives on the most-asked TetraFi architecture decisions. - [ResourceLock vs Permit2Escrow](https://tetrafi.io/docs/architecture/comparisons/resourcelock-vs-permit2escrow): Output-first versus input-first settlement locks - when to choose each and why. - [RFQ vs Dutch Auction](https://tetrafi.io/docs/architecture/comparisons/rfq-vs-dutch-auction): Quote-first competition versus time-decaying price - price discovery trade-offs for cross-chain intents. - [TetraFi vs Bridge + Swap](https://tetrafi.io/docs/architecture/comparisons/tetrafi-vs-bridge-swap): Single-signature intent-based settlement versus multi-tx bridge-then-swap paths. ## SDK - [SDK](https://tetrafi.io/docs/sdk): Typed TypeScript and Python client libraries - core concepts, per-language references, and a unified method index. - [SDK Client](https://tetrafi.io/docs/sdk/client): TetraFi SDK reference - TypeScript and Python. Installation, initialization, core methods, types, and error handling. - [TypeScript SDK](https://tetrafi.io/docs/sdk/typescript): Complete reference for the @tetrafi/sdk TypeScript package - installation, initialization, methods, types. - [Python SDK](https://tetrafi.io/docs/sdk/python): Complete reference for the tetrafi Python package - installation, initialization, methods, async support. - [React Components](https://tetrafi.io/docs/sdk/components): Premade React components for embedding TetraFi functionality - SwapWidget, PriceStream, SettlementStatus. - [All SDK Methods](https://tetrafi.io/docs/sdk/all-methods): Unified index of every method across TypeScript and Python SDKs. Filter by language, namespace, and status; sort by name, namespace, or version. - [Compare SDK Methods](https://tetrafi.io/docs/sdk/compare): Side-by-side comparison of SDK methods. Pick 2-4 methods to see namespaces, return types, versions, and deprecation status in one matrix. - [SDK Version History](https://tetrafi.io/docs/sdk/history): Version-grouped roll-up of every SDK method - what was added, deprecated, and changed per release. ## Changelog - [Docs Changelog](https://tetrafi.io/docs/changelog): When TetraFi documentation pages were last reviewed or materially updated. - [API Changelog](https://tetrafi.io/docs/changelog/api): Version-by-version feed of SDK method additions and deprecations, auto-compiled from every block across the SDK docs.