============================================================ >>> HOLLOW DOCUMENTATION ============================================================
OVERVIEW
HOLLOW is a personal AI agent creator for BNB Smart Chain. Each wallet gets one unique agent, permanently bound to their address. Your agent analyzes your wallet's holdings, transaction patterns, and behavior using blockchain data and AI intelligence.
Unlike feed scanners, HOLLOW creates a digital identity for your wallet - a persistent agent that understands your trading style and risk profile.
CORE FEATURES
1:1 WALLET BINDING
Each wallet address gets exactly one agent. No duplicates, no sharing.
PERMANENT STORAGE
Agents are stored forever in /agents/[wallet].json format.
BLOCKCHAIN ANALYSIS
Real-time wallet analysis using BSCScan API for transactions and holdings.
AI INTELLIGENCE
OpenAI-powered summaries of wallet behavior and trading patterns.
AGENT CREATION GUIDE
STEP 1: CONNECT WALLET
Enter your BNB Smart Chain wallet address (0x...)
• Manual input supported
• System checks if agent already exists
STEP 2: CONFIGURE AGENT
Fill in agent details:
• Name: Your agent's identity (required)
• Personality: Behavior profile (e.g., "Conservative trader")
• Description: Purpose and characteristics
• Risk Profile: Low / Medium / High
• Avatar: Upload custom image (base64 stored)
STEP 3: FORGE AGENT
Click "FORGE AGENT" to create. Agent saved to /agents/[wallet].json
ANALYSIS ENGINE
WHAT IT ANALYZES
• Token holdings (top 10 positions)
• Recent transactions (24h window)
• Buy/sell patterns
• Contract approvals
• Trading frequency
OUTPUT FORMAT
• Holdings list with contract addresses
• Transaction counts (buys/sells/approvals)
• AI-generated intelligence summary
• Risk assessment aligned with agent profile
API ENDPOINTS
POST /api/agents
Create or update agent profile
GET /api/agents?wallet=[address]
Load existing agent by wallet address
POST /api/agents/run
Run wallet analysis for agent
GET /api/agents/analyze/[wallet]
Analyze specific wallet with agent intelligence
TECHNICAL STACK
FRONTEND
• Next.js 14
• React 18
• TypeScript
• TailwindCSS
BACKEND
• Node.js
• BSCScan API
• OpenAI API
• File-based storage
AVAILABLE COMMANDS
agent forge→ Create new agent
agent load→ Load existing agent
analyze wallet→ Run intelligence scan
docs→ View documentation
HOLLOW CMD BUILD v1.0 — AGENTS ONLINE
System operational. All agents bound to BNB Smart Chain.