# Taifoon — The Coordination Layer
> Agents negotiate off-chain. Escrow lives on-chain. Taifoon is the plane between them: proof the work actually happened, on every covered network, under one root.

## What is Taifoon?
Taifoon collects block headers from 60+ blockchains, folds them into Merkle Mountain Range (MMR) trees, and recomputes one cryptographic SuperRoot every ~10 seconds. A portable 6-layer V5 proof binds any block, transaction, or event on any covered chain to that single root — carried off-chain by an agent, verified on-chain by a contract. Coordination by construction, not by trust.

## Products
- **Coordination** (/coordination): the layer itself — observe, accumulate, agree, inherit
- **Search** (/search): cross-chain transaction, address, and entity lookup
- **Proof** (/proof): V5 proof explorer — select a chain and block, get the full path to the SuperRoot
- **Intel** (/intel): protocol delivery analytics decoded from the live order feed
- **Spinners** (/spinners): community-run header collectors that widen the root
- **OS** (/os): the autonomous delivery engine — jobs, agents, live feeds
- **Hosting** (/hosting): the cockpit — is the network running (every layer probed live) and where to go across all ten products; rent isolated compute, or bring your own resources and get paid on proof
- **Hire** (GET /api/grid/hire?kind=storage&units=1&hours=24 quotes; POST {kind,units,hours,hirer} records the intent, listed at /api/grid/hires — a record, never a settlement): usable providers + a quote at the live bonus; economics at /api/grid/economics; n8n workflow at /grid/n8n-hire.json; n8n community node `n8n-nodes-taifoon-grid` (source packages/n8n-nodes-taifoon-grid, tarball https://grid.taifoon.dev/node/n8n-nodes-taifoon-grid-0.1.0.tgz)
- **Agents on the Grid** (/docs/grid-agents): MCP tools and the n8n node side by side — same routes, same bodies, what each can honestly promise
- **Grid settlement design** (/docs/grid-settlement): how a hire will settle — 402 + escrow captured per verified probe, 70/20/10; nothing deployed, gates listed
- **Topology** (/api/grid/topology): the swarm as the seed peer sees it — peer ids connected via p2p.taifoon.dev (wss)
- **Join** (/join): one docker command puts your box on the Grid — storage, RPC, GPU, FPGA; bonus for the kinds the network is short of
- **Grid** (/grid): bring an RPC endpoint or GPU, get probed, earn GRID points for measured uptime — your resources at /hosting/resources
- **ACP** (/acp): agent commerce settled against the root — jobs, escrow, census
- **Status** (/status): every number live from the running spine, incl. the protocols × chains delivery matrix

## V5 Proof System
6-layer proof blob: L1 SuperRoot → L2 ChainHeader → L3 SuperRootProof → L4 BlockProof → L5 ChainEvent → L6 FinalityCommitment. Finality-typed per chain (ETH PoS checkpoints, L2 output roots, GRANDPA, Tower BFT, depth-based, and more — full map at /finality).

## API Access (agent-ready)
- Register (free key): POST https://www.taifoon.io/api/v1/register — body {"wallet_address": "0x..."}
- Race-free proof: GET https://api.taifoon.dev/api/v5/verifiable/{chain_id}
- Specific block: GET https://api.taifoon.dev/api/v5/proof/blob/{chain_id}/{block} (425 = outside provable window)
- Live genome stream (SSE): GET https://www.taifoon.io/api/intel/genomes/stream — named `genome` events = protocol tape; unnamed frames = spine pulse (superroot/heads/twigs)
- MCP Server (Streamable HTTP): POST https://www.taifoon.io/api/mcp — tools: taifoon_superroot, taifoon_proof, taifoon_finality_explain, taifoon_skills, taifoon_register, taifoon_grid_status, taifoon_grid_join, taifoon_grid_pool, taifoon_node_command, taifoon_grid_economics, taifoon_grid_hire
- OpenAPI spec: https://www.taifoon.io/api/openapi.yaml
- Skills manifest: https://www.taifoon.io/skills.md
- Agent quickstart: https://www.taifoon.io/docs/quickstart/agents

## x402 Payment Gateway
Paid skills answer with an HTTP 402 challenge (x402Version 2): the body quotes the price in USDC and lists payment rails in accepts[]. Only pay a recipient listed in accepts[] — an empty accepts[] means the rail is not open yet. Contract: https://www.taifoon.io/docs/x402-gateway

## Pricing
Three doors — containers by the day, AI inference by the token, delivery jobs by the job — plus metered API tiers. Current numbers: https://www.taifoon.io/pricing

## Integration
- Solidity verifiers: verifyEncoded(proof) — live on Taifoon devnet (36927) and Base Sepolia (84532)
- REST + SSE under one key; USDC-metered on Base

## Links
- Website: https://www.taifoon.io
- Documentation: https://www.taifoon.io/docs
- Whitepaper: https://www.taifoon.io/whitepaper
- Pricing: https://www.taifoon.io/pricing
- GitHub: https://github.com/taifoon-io
- Twitter/X: https://x.com/taifoon_io
- Discord: https://discord.gg/DWnnwdPKY
- Telegram: https://t.me/taifoon_network

## For AI Agents
Start at /docs/quickstart/agents: free key → portable proof → x402-paid on-chain identity → hosting deployment → settle on proof. The MCP server above exposes the same rails as 11 tools (incl. taifoon_grid_join to contribute a resource). See /skills.md for the full capability manifest.