Spaces:
Paused
Paused
| title: AirMicroDrip | |
| emoji: 💧 | |
| colorFrom: blue | |
| colorTo: purple | |
| sdk: docker | |
| pinned: false | |
| license: mit | |
| # AirMicroDrip | |
| Perpetual Airdrop with LLM Liquidity Perpetual Futures - No Mocks, No Simulations. | |
| ## Overview | |
| AirMicroDrip is a revolutionary system that: | |
| 1. **Collects slippage** from whale DEX trades on Solana | |
| 2. **Distributes collected tokens** to new holders (perpetual airdrop) | |
| 3. **Converts LLM inference capacity** into synthetic liquidity | |
| 4. **Powers a perpetual futures DEX** with that liquidity | |
| 5. **Rewards LLM providers** for their contribution | |
| ## Systems | |
| - **Slippage Collector**: Monitors Raydium, Orca, Jupiter for whale trades | |
| - **Holder Tracker**: Detects new token holders and eligibility | |
| - **LLM Liquidity Provider**: Converts inference capacity to synthetic liquidity | |
| - **Perpetual Futures Trading Engine**: Up to 100x leverage trading | |
| - **Funding Rate Engine**: Real-time funding rate calculation | |
| - **Liquidation System**: Position monitoring and liquidation | |
| - **Mining Rewards**: LLM provider rewards and leaderboard | |
| ## API Endpoints | |
| - `/health` - System health check | |
| - `/api/overview` - Aggregate statistics from all systems | |
| - `/api/slippage/stats` - Slippage collection statistics | |
| - `/api/holders/stats` - Holder statistics | |
| - `/api/liquidity/stats` - LLM liquidity statistics | |
| - `/api/trading/stats` - Trading statistics | |
| - `/api/funding/stats` - Funding rate statistics | |
| - `/api/liquidation/stats` - Liquidation statistics | |
| - `/api/mining/stats` - Mining rewards statistics | |
| - `/api/token-launch/status` - Latest one-tree Merkle token launch manifest | |
| - `/api/token-launch/prepare` - Prepare a new unsigned Merkle launch manifest | |
| - `/api/token-launch/pool-setup` - Unsigned SPL mint and liquidity-pool setup plan | |
| - `/api/collateral/scan` - Background scan of the Space owner's public HF repos, Spaces, files, and readable LOC | |
| - `/api/collateral/status` - Latest HF account collateral evidence and root | |
| ## Tech Stack | |
| - Python 3.10+ | |
| - Flask + Gunicorn | |
| - SQLite (real on-disk persistence) | |
| - **Real external APIs only** — no mocks, no simulations | |
| ## Real Data Sources | |
| | System | Data Source | Endpoint | | |
| |--------|-------------|----------| | |
| | Trading Prices | Gate.io Futures API | `api.gateio.ws/api/v4/futures/usdt/tickers` | | |
| | Funding Rates | Gate.io Futures API | `api.gateio.ws/api/v4/futures/usdt/funding_rate` | | |
| | Slippage/Volume | DexScreener API | `api.dexscreener.com/latest/dex/tokens/{mint}` | | |
| | Token Holders | Solana JSON-RPC | `getTokenLargestAccounts` | | |
| | Token Transfers | Solana JSON-RPC | `getSignaturesForAddress` + `getTransaction` | | |
| | LLM Benchmark | Real HTTP inference | Ollama or OpenAI-compatible API | | |
| | Token Launch | Local Merkle manifest | one root over token spec, pool spec, allocations, gates, metrics | | |
| | HF Collateral | Hugging Face public repos | repo/file inventory, readable LOC, file hashes | | |
| ## Runtime Configuration | |
| The deployed app runs without API keys or required runtime variables. These settings are optional overrides only: | |
| | Variable | Required | Description | | |
| |----------|----------|-------------| | |
| | `TOKEN_MINT` | No | Override the public default Solana token mint | | |
| | `INFERENCE_API_URL` | No | Optional no-key local/Ollama-compatible endpoint for live LLM benchmarking | | |
| | `SOLANA_RPC_URL` | No | Override the public Solana RPC endpoint | | |
| Without overrides, the dashboard still boots with public market data, a public Solana RPC default, local SQLite ledgers, and a local-only LLM liquidity state. | |
| ## Deployment | |
| ```bash | |
| cd airmicrodrip | |
| export HF_TOKEN=your_token | |
| bash deploy.sh | |
| ``` | |
| Or see `DEPLOY.md` for detailed instructions. | |
| ## No Mock Guarantee | |
| Every data point comes from a real external API call: | |
| - Gate.io for market data (no fake prices) | |
| - DexScreener for DEX volume (no fake volume) | |
| - Solana RPC for on-chain data (no fake holders) | |
| - Real HTTP inference for LLM benchmarks (no fake capacity) | |
| - Merkle token launch manifests are unsigned until real wallet-signed mint/pool transactions exist | |
| - HF collateral reads public repo files and records unreadable files explicitly | |
| - If a source is unavailable, the system returns `waiting`, `local_only`, or `error` states — never invented data. | |