airmicrodrip / README.md
josephrw's picture
Upload folder using huggingface_hub
e9d4f6a verified
|
Raw
History Blame Contribute Delete
4.2 kB
metadata
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

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.