Netcup Server
ops: commit netcup-specific docs, config, and M3 Bayesian reputation on netcup mainline
846b6be | # RMI Platform — System Architecture | |
| > **v3 (Jun 21 2026)**: This document now describes the rebuilt architecture. | |
| > The legacy monolith has been replaced via strangler-fig. New v1 routes | |
| > mount via `app/api/v1/__init__.py` aggregator. See `docs/adr/0003-strangler-fig-not-rewrite.md` | |
| > for the migration pattern, and `docs/adr/0001-why-fastapi.md` for framework choice. | |
| ## v3 Architecture Diagram | |
| ``` | |
| ┌─────────────────────┐ | |
| │ CONSUMERS │ | |
| │ Frontend | MCP │ | |
| │ Telegram | API │ | |
| └──────────┬──────────┘ | |
| │ | |
| ┌────────────────────┼────────────────────┐ | |
| │ │ │ | |
| ┌───────▼───────┐ ┌───────▼───────┐ ┌───────▼───────┐ | |
| │ MCP ENDPOINT │ │ REST v1 API │ │ X402 GATEWAY │ | |
| │ /mcp/* │ │ /api/v1/* │ │ CF Workers │ | |
| └───────┬───────┘ └───────┬───────┘ └───────┬───────┘ | |
| │ │ │ | |
| └────────────────────┼────────────────────┘ | |
| │ | |
| ┌────────────▼────────────┐ | |
| │ app/api/v1/__init__.py │ | |
| │ AGGREGATOR (NEW) │ | |
| └────────────┬────────────┘ | |
| │ | |
| ┌────────────────────────┼────────────────────────┐ | |
| │ │ │ | |
| ┌─────────▼─────────┐ ┌──────────▼──────────┐ ┌─────────▼─────────┐ | |
| │ AUTH ROUTERS │ │ PUBLIC ROUTERS │ │ ADMIN ROUTERS │ | |
| │ alerts, wallet │ │ wallet, token, │ │ alerts_webhook │ | |
| │ │ │ scanner, databus │ │ (Prometheus) │ | |
| └───────────────────┘ └──────────┬──────────┘ └───────────────────┘ | |
| │ | |
| ┌───────────▼───────────┐ | |
| │ DATABUS │ | |
| │ 96 chains, 119 prov. │ | |
| └───────────┬───────────┘ | |
| │ | |
| ┌───────────────────────┼───────────────────────┐ | |
| │ │ │ | |
| ┌─────────▼─────────┐ ┌──────────▼──────────┐ ┌────────▼────────┐ | |
| │ SERVICE LAYER │ │ PROVIDER CHAINS │ │ LOCAL MCP │ | |
| │ app/domain/* │ │ Jupiter → Helius → │ │ SVM + EVM │ | |
| │ (pure Python) │ │ Alchemy → … │ │ Self-hosted │ | |
| └───────────────────┘ └─────────────────────┘ └─────────────────┘ | |
| ``` | |
| ## Overview | |
| Rug Munch Intelligence is a unified crypto intelligence platform serving 234 tools across 9 provider categories. Every data call routes through a multi-layer caching shield with automatic provider fallback. The x402 micropayment layer handles paid tool access across 8 chains with instant settlement. | |
| ``` | |
| ┌─────────────────────┐ | |
| │ FRONTEND / BOTS │ | |
| │ Web | Telegram | API│ | |
| └──────────┬──────────┘ | |
| │ | |
| ┌────────────────────┼────────────────────┐ | |
| │ │ │ | |
| ┌───────▼───────┐ ┌───────▼───────┐ ┌───────▼───────┐ | |
| │ MCP ENDPOINT │ │ REST API │ │ X402 GATEWAY │ | |
| │ /mcp/* │ │ /api/v1/* │ │ CF Workers │ | |
| └───────┬───────┘ └───────┬───────┘ └───────┬───────┘ | |
| │ │ │ | |
| └────────────────────┼────────────────────┘ | |
| │ | |
| ┌────────────▼────────────┐ | |
| │ CACHING SHIELD │ | |
| │ L1 Memory → Rate Limit │ | |
| │ → Provider Chain │ | |
| └────────────┬────────────┘ | |
| │ | |
| ┌────────────────────────┼────────────────────────┐ | |
| │ │ │ | |
| ┌─────────▼─────────┐ ┌──────────▼──────────┐ ┌─────────▼─────────┐ | |
| │ DATA PROVIDERS │ │ LOCAL MCP SERVERS │ │ SERVICE MCP │ | |
| │ 20 sources │ │ SVM (60) + EVM (25)│ │ GMGN, Birdeye... │ | |
| └───────────────────┘ └─────────────────────┘ └───────────────────┘ | |
| ``` | |
| ## Tool Categories | |
| | Category | Count | Access | Description | | |
| |----------|-------|--------|-------------| | |
| | Security Scanning | 45 | Free trial + paid | Rug pulls, honeypots, audits, clone detection | | |
| | Wallet Intelligence | 38 | Free trial + paid | PnL, clustering, insider networks, whale tracking | | |
| | Market Data | 32 | Free trial + paid | Prices, liquidity, volume, arbitrage, trends | | |
| | Token Analytics | 28 | Free trial + paid | Holder distribution, sniper detection, deployer history | | |
| | DeFi Analytics | 24 | Free trial + paid | TVL, yields, protocol risk, liquidity flow | | |
| | Social Signals | 18 | Free trial + paid | Sentiment, KOL tracking, profile flips | | |
| | **Caching Shield** | **13** | **Free internal** | Funding trace, risk scan, token price, wallet balance | | |
| | Local MCP | 85 | Self-hosted | SVM Solana RPC, EVM blockchain queries | | |
| | Free Public MCP | 50 | Free external | Boar blockchain (ETH, ENS, contracts) | | |
| ## Caching Shield Architecture | |
| Every data call goes through three layers before hitting any external API: | |
| 1. **L1 Memory Cache** — Sub-millisecond lookup. TTLs: 8s (price) to 1hr (contract ABI). | |
| 2. **Rate Limiter** — Token bucket per provider. Prevents burning free tier quotas. | |
| 3. **Provider Chain** — Ordered fallback. If primary fails, next provider tried automatically. | |
| Example: Token Price Request | |
| ``` | |
| Request → L1 cache (miss) → Rate check (allowed) → Jupiter (primary) → | |
| if fail: Solana Tracker → if fail: DexScreener → if fail: Binance | |
| Result cached for 8 seconds. Next request hits L1 cache instantly. | |
| ``` | |
| ## Provider Fallback Chains | |
| | Data Type | Primary | Fallback 1 | Fallback 2 | Fallback 3 | | |
| |-----------|---------|------------|------------|------------| | |
| | Token Price | Jupiter | Solana Tracker | DexScreener | Binance | | |
| | Token Metadata | Helius DAS | Solana Tracker | Jupiter | DexScreener | | |
| | Wallet Balance | Helius | QuickNode | Alchemy | PublicNode | | |
| | Risk Scan | GoPlus | RugCheck | Honeypot | Local Labels | | |
| | EVM Funding | Blockscout | Etherscan | Public RPC | Boar MCP | | |
| | Solana Funding | Helius | Solana Tracker | Public RPC | Local Labels | | |
| ## Free Access Tiers | |
| ### Free Trials (x402 Tools) | |
| - Every paid tool includes 1-5 free trial calls | |
| - No payment required for trial calls | |
| - Fingerprint-gated anti-abuse protection | |
| - Reset monthly or on tool updates | |
| ### Always-Free Tools | |
| - **Funding Tracer** — Trace wallet funding sources (Solana + 9 EVM chains) | |
| - **Token Price** — Real-time price with multi-provider consensus | |
| - **Risk Scan** — Quick security check with 4 fallback layers | |
| - **Wallet Balance** — Balance lookup with provider redundancy | |
| - **GMGN Security** — Token safety analysis | |
| - **Etherscan Gas** — Current gas prices | |
| - **CoinGecko Price** — Market data | |
| - **Langfuse Stats** — Observability metrics | |
| - **All Local MCP Tools** — 85 tools running on our infrastructure | |
| ### Free Tier Limits (External APIs) | |
| Solana Tracker: 5,000 requests/month across 2 accounts (6 RPS combined) | |
| Helius: 2 accounts, 25 RPS each (50 RPS total) | |
| Blockscout PRO: 100,000 credits/day, 5 RPS | |
| CoinMarketCap: 10,000 calls/month, 11 endpoints | |
| Boar MCP: Unlimited (keyless, read-only) | |
| ## X402 Payment System | |
| - **Price range:** $0.01 - $0.40 per tool call | |
| - **Payment chains:** Base, Solana, Ethereum, BSC, TRON, Bitcoin, Polygon, Arbitrum | |
| - **8 payment facilitators** with automatic fallback | |
| - **Instant refund** if tool returns no data | |
| - **Settlement:** Instant on Base and Solana | |
| ## Local MCP Servers | |
| Two self-hosted MCP servers run on our bare metal, accessed via stdio transport: | |
| **Solana SVM MCP** (60 tools, Rust) | |
| - getBalance, getAccountInfo, getTokenSupply, getSignaturesForAddress | |
| - getTransaction, getProgramAccounts, getBlock, getBlockHeight | |
| - WebSocket subscriptions for real-time updates | |
| - Built-in x402 payment protocol support | |
| **EVM MCP** (25 tools, 86 networks) | |
| - getBalance, getTokenBalance, getAllowance | |
| - getTransaction, getTransactionReceipt, waitForTransaction | |
| - getBlock, resolveENS, lookupENS | |
| - getGasPrice, getContractABI, getChainInfo | |
| ## Observability | |
| Langfuse cloud with smart sampling: | |
| - 20% of normal traces sent to cloud | |
| - 100% of errors sent to cloud | |
| - Full archive in local ClickHouse | |
| - Target: 30,000 observations/month (free tier: 50,000) | |
| ## Deployment | |
| - **Server:** Bare metal VPS (193GB SSD, Ubuntu) | |
| - **Containers:** Docker Compose (30 containers) | |
| - **CI/CD:** GitHub Actions — auto-deploy on push to main | |
| - **Edge:** Cloudflare Workers for x402 payment gateway | |
| - **Secrets:** GPG-encrypted vault (52 secrets), age-encrypted Docker runtime | |
| ## Auto-Updating Platform Manifest | |
| All platform descriptions, tool counts, pricing, and agent skills are managed by a single source of truth at `app/caching_shield/platform_manifest.py`. Every external surface reads from here. | |
| **Live endpoints (always current):** | |
| - `GET /mcp/manifest` — Full platform manifest with live tool counts | |
| - `GET /mcp/membership` — Membership tiers, scan packs, streams, research, batch | |
| - `GET /mcp/skills` — 18 agent skills with workflows and anti-abuse rules | |
| **Directory sync (run to update external listings):** | |
| ```bash | |
| python3 /root/backend/scripts/sync_platforms.py | |
| ``` | |
| Updates Smithery, Glama, mcp.so, and README from the manifest. | |
| **Tools by category (auto-counted):** | |
| | Category | Count | Access | | |
| |----------|-------|--------| | |
| | Paid Tools (with free trials) | 200+ | 1-5 free calls, then pay-per-use | | |
| | Local MCP Tools | 85 | Self-hosted, no rate limits | | |
| | Free Public MCP | 50 | Keyless, read-only | | |
| | Agent Skills | 18 | Free, included with any access | | |
| | Scan Packs | 4 | 50-53% off individual tools | | |
| | Membership Tiers | 4 | $4.99-$199.99/mo, daily call limits | | |
| | Streaming Feeds | 4 | Real-time data via WebSocket | | |
| | Research Reports | 4 | Deep dive investigations | | |
| | Batch Products | 3 | 75-90% off bulk scanning | | |
| | AI Data Feeds | 3 | Machine-ready market data | | |