DEPLOY.md

AirMicroDrip Deployment Guide

Prerequisites

• Hugging Face account
• HF_TOKEN environment variable set

Quick Deploy

cd airmicrodrip
export HF_TOKEN=your_hf_token_here
bash deploy.sh

Manual Deploy (Git Push)

cd airmicrodrip
export HF_TOKEN=your_hf_token_here
export HF_SPACE_ID=josephrw/membra-airmicrodrip

# Initialize git
git init
git config user.email "deploy@membra.ai"
git config user.name "MEMBRA Deploy"
git add -A
git commit -m "Deploy AirMicroDrip"

# Push to Hugging Face
git push "https://$HF_TOKEN@huggingface.co/spaces/$HF_SPACE_ID" main --force

Runtime Configuration

The app does not require API keys or Space secrets at runtime. Optional overrides can be added in HF Space Settings:

Variable	Description	Example
TOKEN_MINT	Override the default public token mint	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
INFERENCE_API_URL	Optional no-key local/Ollama-compatible LLM endpoint for live benchmarking	http://localhost:11434
SOLANA_RPC_URL	Override the public Solana RPC endpoint	https://api.mainnet-beta.solana.com

Data Sources

All data is fetched from real APIs — no mocks, no simulations:

• Trading: Gate.io Futures API (real-time prices, funding rates)
• Slippage: DexScreener API (real DEX volume/liquidity data)
• Holders: Solana RPC getTokenLargestAccounts (real on-chain holder data)
• LLM Liquidity: Real HTTP inference benchmark (Ollama or OpenAI-compatible)
• Liquidation: Gate.io prices + local position DB

Architecture

HF Space (Docker)
  └── Flask API
      ├── /api/slippage/stats    → DexScreener API
      ├── /api/holders/stats     → Solana RPC
      ├── /api/liquidity/stats   → Inference benchmark
      ├── /api/trading/stats     → Gate.io API
      ├── /api/funding/stats     → Gate.io API
      ├── /api/liquidation/stats → Gate.io + local DB
      ├── /api/token-launch/status  → Merkle launch manifest
      ├── /api/token-launch/prepare → Rebuild unsigned launch tree
      ├── /api/token-launch/pool-setup → Unsigned mint/pool setup plan
      ├── /api/collateral/scan   → Background HF account file/LOC collateral scan
      ├── /api/collateral/status → Latest collateral root and evidence
      └── /                      → Dashboard UI

Verification

After deployment:

1. Visit https://huggingface.co/spaces/YOUR_SPACE
2. Check System Status shows real backend states for trading, funding, liquidation, holders, and slippage
3. Confirm the header says "No-key backend"
4. Confirm "One Merkle Tree Token Launch" shows unsigned_ready
5. LLM liquidity should show local_only until a real local endpoint is connected

Troubleshooting

• Holder/slippage waiting: Public Solana or DexScreener data has not returned yet; no key is required
• LLM liquidity local-only: This is expected without a real local inference endpoint
• Merkle launch unsigned_ready: The root and proofs are prepared; SPL mint/pool creation still requires a real wallet signature
• "Gate.io API unreachable": Check network connectivity; app uses fallback only if API fails