merge: chore/cleanup-remove-bloat-and-secrets into main

docs/FAQ.md

@@ -0,0 +1,54 @@
+# RMI Platform — Frequently Asked Questions
+
+## General
+
+**What is Rug Munch Intelligence (RMI)?**
+A unified crypto intelligence platform with 270+ tools for token security, wallet forensics, whale tracking, market data, and blockchain queries. Free tools available, paid tools via x402 micropayments.
+
+**How many tools are free?**
+Every paid tool includes 1-5 free trial calls. Connecting a wallet unlocks full trial allotment (3-5 for basic tools, 1-2 for premium). Bots without wallets get 1 trial per tool via fingerprint.
+
+**What chains are supported?**
+Solana, Ethereum, Base, BSC, Polygon, Arbitrum, Optimism, Avalanche, Fantom, Gnosis, TRON, Bitcoin (12 payment chains, 38 data chains).
+
+## Pricing & Payments
+
+**How does x402 pricing work?**
+You pay per tool call in USDC. Prices range from $0.01 (basic lookups) to $0.25 (institutional forensics). Payment happens automatically via the x402 protocol — no accounts, no subscriptions, no prepayment.
+
+**Which chains can I pay on?**
+Base, Solana, Ethereum, BSC, TRON, Bitcoin, Polygon, Arbitrum, Optimism, Avalanche, Fantom, Gnosis. Plus EUR/SEPA via AsterPay for European users.
+
+**What if a paid tool returns no data?**
+Full automatic refund within 48 hours. You're never charged for empty results.
+
+**Do free trials reset?**
+Yes — every 24 hours. Fingerprint gating ensures fair usage:
+- **Humans (wallet connected)**: Full trial allotment (3-5 for basic, 1-2 for premium)
+- **Bots (device fingerprint)**: 1 trial per tool, then payment required
+- **IP-only**: 1 trial max, then payment required
+
+## DataBus
+
+**What is DataBus?**
+The single data pipeline powering all 270+ tools. 38 data chains, 67 providers, automatic failover. You never need to specify which provider to use — just request the data type and DataBus handles the rest.
+
+**What happens when a source fails?**
+DataBus automatically tries the next provider in the chain. Token prices try: local cache → Jupiter → DexScreener → Binance → CoinGecko. You always get data.
+
+## Endpoints
+
+| Path | Purpose |
+|------|---------|
+| `/api/v1/x402-databus/*` | DataBus direct endpoints (40 tools) |
+| `/api/v1/x402-tools/*` | Legacy tool endpoints (230+ tools, DataBus fallback) |
+| `/api/v1/catalog` | Human-facing catalog (search, featured, by-trial) |
+| `/mcp/tools` | MCP-compliant tool catalog |
+| `/.well-known/x402` | x402 discovery document |
+
+## Security
+
+- API keys encrypted in GPG vault, never in plaintext
+- No source provider names exposed in responses
+- 6-tier access control: public, authenticated, basic, premium, admin, x402_paid
+- VPN-resistant fingerprinting for trial gating