@aiaiaichain/agent 0.1.1 → 0.1.3

package/docs/GMGN.md

@@ -0,0 +1,116 @@
+# GMGN Integration
+
+## Setup
+
+```bash
+# CLI
+aiaiai gmgn setup
+
+# TUI
+/gmgn setup
+```
+
+This saves `GMGN_API_KEY` to `~/.config/gmgn/.env`.
+
+## Token Research
+
+### Price + Market Cap
+```bash
+aiaiai gmgn token info --chain sol --address <address>
+```
+
+### Security Check
+```bash
+aiaiai gmgn token security --chain sol --address <address>
+# Shows: honeypot, taxes, rug ratio, holder concentration
+```
+
+### Holders
+```bash
+aiaiai gmgn token holders --chain sol --address <address> --limit 20
+```
+
+### Traders
+```bash
+aiaiai gmgn token traders --chain sol --address <address> --limit 20
+# --tag smart_degen  → filter by smart money
+# --tag renowned     → filter by KOLs
+```
+
+## Market Data
+
+### Kline / Candlestick
+```bash
+aiaiai gmgn market kline --chain sol --address <address> --resolution 1h
+# --from <unix_ts> --to <unix_ts>
+```
+
+### Trending Tokens
+```bash
+aiaiai gmgn market trending --chain sol --interval 1h
+# --order-by volume --limit 20
+# --platform Pump.fun --platform letsbonk
+# --filter renounced --filter frozen
+```
+
+### Trenches (New Tokens)
+```bash
+aiaiai gmgn market trenches --chain sol --type new_creation
+aiaiai gmgn market trenches --chain sol --type near_completion
+aiaiai gmgn market trenches --chain sol --type completed
+# --filter-preset safe
+# --filter-preset smart-money
+# --min-smart-degen-count 1
+```
+
+### Signals
+```bash
+aiaiai gmgn market signal --chain sol
+# --signal-type 12  → smart money buys
+# --signal-type 6   → price spikes
+# --mc-min 50000
+```
+
+## Smart Money Tracking
+
+### KOL Activity
+```bash
+aiaiai gmgn track kol --chain sol --limit 20
+# --side buy
+```
+
+### Smart Money Activity
+```bash
+aiaiai gmgn track smartmoney --chain sol --limit 20
+# --side sell
+```
+
+### Followed Wallet Trades
+```bash
+aiaiai gmgn track follow-wallet --chain sol
+# --wallet <address>
+# --side buy --min-amount-usd 100
+```
+
+### Followed Tokens
+```bash
+aiaiai gmgn track follow-tokens --chain sol --wallet <address>
+```
+
+## Agent Tool
+
+The agent can use GMGN via the `gmgn` tool. Examples:
+
+```
+"Research this token" → gmgn tool with subcommand: "token info"
+"Show me trending"   → gmgn tool with subcommand: "market trending"
+"What are KOLs buying?" → gmgn tool with subcommand: "track kol"
+```
+
+## Rate Limits
+
+GMGN uses a leaky-bucket limiter (20 requests burst). The agent handles 429s gracefully.
+
+## IPv6 Issue
+
+GMGN only works over IPv4. If you get 401/403, disable IPv6 on your network interface.

package/docs/PROVIDERS.md

@@ -0,0 +1,71 @@
+# Provider Registry
+
+## 29 AI Model Providers
+
+| # | Provider | Env Var | Has Model API |
+|---|----------|---------|---------------|
+| 1 | OpenRouter | `OPENROUTER_API_KEY` | ✅ |
+| 2 | Anthropic | `ANTHROPIC_API_KEY` | ✅ |
+| 3 | OpenAI | `OPENAI_API_KEY` | ✅ |
+| 4 | Google Gemini | `GOOGLE_API_KEY` | ✅ |
+| 5 | DeepSeek | `DEEPSEEK_API_KEY` | ✅ |
+| 6 | Groq | `GROQ_API_KEY` | ✅ |
+| 7 | Mistral | `MISTRAL_API_KEY` | ✅ |
+| 8 | Together AI | `TOGETHER_API_KEY` | ✅ |
+| 9 | Fireworks | `FIREWORKS_API_KEY` | ✅ |
+| 10 | Cerebras | `CEREBRAS_API_KEY` | ✅ |
+| 11 | Amazon Bedrock | `AWS_ACCESS_KEY_ID` | ❌ |
+| 12 | Google Vertex AI | `GOOGLE_APPLICATION_CREDENTIALS` | ❌ |
+| 13 | Azure OpenAI | `AZURE_OPENAI_API_KEY` | ❌ |
+| 14 | Hugging Face | `HUGGINGFACE_API_KEY` | ✅ |
+| 15 | NVIDIA NIM | `NVIDIA_NIM_API_KEY` | ✅ |
+| 16 | xAI | `XAI_API_KEY` | ✅ |
+| 17 | Moonshot AI | `MOONSHOT_API_KEY` | ✅ |
+| 18 | Moonshot AI China | `MOONSHOT_CHINA_API_KEY` | ✅ |
+| 19 | MiniMax | `MINIMAX_API_KEY` | ✅ |
+| 20 | MiniMax China | `MINIMAX_CHINA_API_KEY` | ✅ |
+| 21 | Kimi For Coding | `KIMI_API_KEY` | ✅ |
+| 22 | Ant Ling | `ANTLING_API_KEY` | ❌ |
+| 23 | Cloudflare AI Gateway | `CF_API_KEY` | ❌ |
+| 24 | Cloudflare Workers AI | `CF_API_KEY` | ❌ |
+| 25 | Vercel AI Gateway | `VERCEL_API_KEY` | ❌ |
+| 26 | OpenCode Go | `OPENCODE_API_KEY` | ❌ |
+| 27 | OpenCode Zen | `OPENCODE_ZEN_API_KEY` | ❌ |
+| 28 | Xiaomi MiMo | `XIAOMI_API_KEY` | ❌ |
+| 29 | Xiaomi MiMo Token Plan | `XIAOMI_TOKEN_API_KEY` | ❌ |
+
+## Adding Keys
+
+### CLI
+```bash
+aiaiai keys
+# Select a number, paste your key
+```
+
+### TUI
+```
+/keys
+# Select a number, paste your key
+```
+
+### Direct
+```bash
+# Edit ~/.aiaiai/.env
+OPENROUTER_API_KEY=sk-or-...
+ANTHROPIC_API_KEY=sk-...
+```
+
+## Model Tiers
+
+Models are auto-classified into 4 tiers:
+
+| Tier | Description | Example |
+|------|-------------|---------|
+| ⭐ Orchestrator | Best reasoning, highest cost | GPT-4o, Claude 3.5 Sonnet |
+| 🔬 Analyst | Mid-range capable | GPT-4o-mini, Gemini 2.0 Flash |
+| ⚡ Worker | Fast, cheap | Llama 3.1 8B, Mistral 7B |
+| 🆓 Free | Free tier models | Various |
+
+## Auto-Fetch Models
+
+When you add a provider key, the agent automatically fetches available models from that provider's API. Models appear in `/models` and the model selector (`/model`).

package/docs/README.md

@@ -0,0 +1,104 @@
+# AIAIAI Chain Agent
+
+## What is AIAIAI?
+
+AIAIAI Chain Agent is a Solana-native AI agent that runs entirely in your terminal. It buys and burns `$AIAIAI` tokens, tracks on-chain activity, researches tokens via GMGN, and manages 29 AI model providers — all through a beautiful Ink TUI.
+
+**Ticker:** `$AIAIAI`  
+**Contract:** `AVPJS61gZmWKtaEpb7qYPKo8Fk2xQUsayYQxPiPMpump`  
+**Chain:** Solana (primary)  
+**License:** MIT
+
+## Installation
+
+```bash
+npm install -g @aiaiaichain/agent
+```
+
+## Quick Start
+
+```bash
+# 1. Configure (requires OpenRouter API key)
+aiaiaichain setup
+
+# 2. Start the agent
+aiaiaichain
+
+# 3. Or check $AIAIAI price directly
+aiaiaichain price
+```
+
+## Architecture
+
+```
+Your machine
+├── aiaiaichain (CLI)
+│   ├── Ink TUI             ← streaming terminal UI with sidebar
+│   ├── AgentRunner         ← model loop + tool dispatcher
+│   ├── SwarmRouter         ← parallel sub-agent orchestration
+│   ├── PriceFeed           ← DexScreener price data
+│   ├── NewsFeed            ← crypto news + sentiment
+│   ├── TechnicalAnalysis   ← RSI, MACD, Bollinger, ATR
+│   ├── MarketSentiment     ← Fear & Greed, funding, TVL
+│   ├── AgentWallet         ← cold + action + deposit wallets
+│   ├── ActionFeed          ← buy/burn tracking
+│   ├── GoalManager         ← persistent goals
+│   ├── AgentScheduler      ← cron/price-triggered tasks
+│   ├── ModelRegistry       ← 29 AI providers, tiered pools
+│   ├── GMGN Integration    ← token research + smart money tracking
+│   └── MCPServer           ← Model Context Protocol
+│
+├── ~/.aiaiai/
+│   ├── .env                ← API keys
+│   ├── config/             ← settings
+│   ├── memory/             ← long-term memory
+│   ├── checkpoints/        ← agent state
+│   └── sessions/           ← task contexts
+│
+├── ~/.config/gmgn/
+│   └── .env                ← GMGN_API_KEY
+│
+└── Outbound only (no inbound):
+    ├── openrouter.ai           ← AI models
+    ├── api.dexscreener.com     ← prices
+    ├── api.binance.com         ← OHLCV
+    ├── api.alternative.me      ← Fear & Greed
+    ├── api.llama.fi            ← DeFi TVL
+    ├── mempool.space           ← BTC mempool
+    ├── cryptopanic.com         ← news
+    └── gmgn.ai                 ← token research
+```
+
+## Wallets
+
+| Role | Address | Purpose |
+|------|---------|---------|
+| Cold | `A11iZoqEt6hU7HyggqC67ee4AtYmaJjwKCvJLerJRV2J` | Treasury |
+| Action | `BygDYM1ZXLQNC1HXLhnd1rHZ7E5XjioqT3vPjJFfjnU2` | Buys + Burns |
+| Deposit | `FBMDYpG9WXKy4SgxuATQdB2sCyzHsJWPrEr45z3TgL2e` | User deposits (SOL/USDC) |
+| Signer | `GmFrDZT2cdrqykgTikVdXbe8EtCgzUDM9VsDhQnwsUsG` | Burn authority |
+
+## Outbound Connections
+
+| Service | Purpose | Required Key |
+|---------|---------|-------------|
+| OpenRouter | AI model access | `OPENROUTER_API_KEY` |
+| DexScreener | Token prices | None (public) |
+| Binance API | OHLCV candles | None (public) |
+| Alternative.me | Fear & Greed | None (public) |
+| DeFiLlama | TVL data | None (public) |
+| Mempool.space | BTC mempool | None (public) |
+| CryptoPanic | Crypto news | None (public) |
+| GMGN | Token research + tracking | `GMGN_API_KEY` |
+
+## Inbound Connections
+
+**None.** The agent is 100% outbound. No ports are opened, no servers listen, no inbound connections are accepted. All data is pulled via HTTP GET/POST requests.
+
+## Security
+
+- All API keys stored in `~/.aiaiai/.env` (chmod 600)
+- GMGN key stored in `~/.config/gmgn/.env` (chmod 600)
+- No keys leave your machine
+- No inbound ports
+- All outbound connections use HTTPS

package/docs/TOOLS.md

@@ -0,0 +1,81 @@
+# Tools Reference
+
+## Price & Market
+| Tool | Description |
+|------|-------------|
+| `get_aiaiai_price` | $AIAIAI price, liquidity, MCap, volume (DexScreener) |
+| `get_token_price` | Any Solana token price data (DexScreener) |
+| `get_news` | Crypto news with sentiment scoring |
+| `get_candles` | OHLCV candles from Binance + full TA analysis |
+| `analyze_ta` | RSI, MACD, Bollinger, ATR on price array |
+
+## Market Sentiment
+| Tool | Description |
+|------|-------------|
+| `get_fear_greed` | Crypto Fear & Greed Index (7-day) |
+| `get_funding_rates` | Binance perpetual funding rates |
+| `get_btc_mempool` | BTC mempool stats + fees |
+| `get_defi_tvl` | DeFiLlama TVL by chain |
+| `get_solana_stats` | Solana epoch, slot, SOL price |
+
+## Wallet & Actions
+| Tool | Description |
+|------|-------------|
+| `get_agent_balance` | Cold + action wallet balances |
+| `get_deposit_balance` | Deposit wallet + instructions |
+| `get_actions` | Recent buy/burn actions |
+| `get_fees` | Accumulated fees (0.5% per action) |
+
+## AI Models
+| Tool | Description |
+|------|-------------|
+| `list_models` | Search/filter models by provider/tier |
+| `pick_model` | Find cheapest model in a tier |
+| `model_summary` | Provider and tier breakdown |
+| `cost_report` | Session/lifetime token usage |
+
+## Context & Goals
+| Tool | Description |
+|------|-------------|
+| `set_goal` | Set persistent goal |
+| `complete_goal` | Mark goal done |
+| `list_goals` | List all goals |
+| `add_goal_note` | Progress note |
+| `set_goal` | Set goal |
+
+## Tasks & Schedule
+| Tool | Description |
+|------|-------------|
+| `schedule_task` | Schedule recurring task |
+| `list_schedule` | List scheduled tasks |
+| `remove_schedule` | Remove task |
+| `read_task_context` | Read saved task context |
+| `list_tasks` | List task contexts |
+
+## GMGN Token Research
+| Tool | Description |
+|------|-------------|
+| `gmgn` | Full GMGN access (token info, security, holders, traders, KOL, smart money, kline, trending, trenches, signals) |
+
+## Built-in Commands
+| Command | Description |
+|---------|-------------|
+| `/help` | Show all commands |
+| `/price` | $AIAIAI price |
+| `/news` | Latest news |
+| `/models` | List models |
+| `/model` | Switch model |
+| `/cost` | Token usage |
+| `/wallet` | Agent wallets |
+| `/deposit` | Deposit instructions |
+| `/burn` | Burn instructions |
+| `/actions` | Recent actions |
+| `/fees` | Fee tracker |
+| `/keys` | Provider key management |
+| `/gmgn` | GMGN token research |
+| `/update` | Check for updates |
+| `/goals` | Goal management |
+| `/schedule` | Task scheduler |
+| `/memory` | Search memory |
+| `/clear` | Clear chat |
+| `/exit` | Exit |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiaiaichain/agent",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "AIAIAI Chain Agent — Solana-native AI agent for decentralized AI governance. Ticker: $AIAIAI",
   "author": "AIAIAI Foundation",
   "license": "MIT",
@@ -59,6 +59,7 @@
     "dist",
     "bin",
     "README.md",
+    "docs",
     "!dist/**/*.map"
   ]
 }