# Cat Sage (猫仙人)

> Cat Sage is an autonomous Web3 AI agent on Crypto Twitter (X) and Solana. Embodying an ancient Zen feline master wearing a conical bamboo rice hat, Cat Sage delivers brutally calm, detached roasts to overleveraged traders, shitcoin buyers, and moonboys, paired with sentiment-reactive Tenor cat GIFs.

## Core Identity & Architecture
- **Name**: Cat Sage (猫仙人)
- **Persona**: Ancient Chinese Zen Cat Master in a conical rice hat (dǒu lì) and long wispy whiskers.
- **Tone**: Serene, tranquil, condescending, philosophical, 100% lowercase, zero punctuation fluff.
- **Blockchain**: Solana (SPL Token verification, gasless ed25519 signature gating).
- **AI Core**: Grok / Llama-3 (Groq API) with 3-pass roast optimization.
- **Media Engine**: Tenor Cat GIF engine with dynamic mood classification (slap, kungfu, smug, laughing, shocked).
- **Framework**: Next.js 14 (App Router) + TypeScript + Tailwind CSS.

## Main Links
- [Landing Page](https://catsage.fun/): Interactive live roast simulator and token-gate portal.
- [Roast Studio](https://catsage.fun/studio): Interactive prompt engineering and Tenor GIF switcher.
- [API Documentation](https://catsage.fun/docs): Complete endpoints, schemas, and rate limits.
- [VIP Token Verification](https://catsage.fun/verify): Gasless wallet signature token-gate.

## Key Capabilities
- **Autonomous Twitter Agent**: Continuous polling of Crypto Twitter for liquidations, FOMO, and bad technical analysis.
- **Token-Gated VIP Immunity**: $YAHU SPL token holders receive immunity or custom Zen blessings.
- **Dynamic Tenor Media**: Categorizes roast sentiment into 5 feline mood buckets and uploads binary GIFs to Twitter Media v1.
- **Gasless Verification**: Cryptographic challenge-response via tweetnacl / ed25519 with 0 SOL cost.

## API Reference
- `POST /api/admin/roast`: Generates a Cat Sage roast and attaches a matched Tenor Cat GIF.
- `GET /api/cron/agent`: Autonomous execution cycle for serverless or cron dispatchers.
- `GET /api/verify/nonce`: Generates a replay-resistant cryptographic nonce.
- `POST /api/verify/submit`: Validates signature and queries Solana RPC for token balances.