169 lines
8.6 KiB
Markdown
169 lines
8.6 KiB
Markdown
# RMI Platform — System Architecture
|
|
|
|
## 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 |
|