@0xprotovox/deficlaw 0.1.1 → 0.2.0

package/README.md

@@ -1,4 +1,4 @@
-# DefiClaw
+# deficlaw
 
 **The first open-source DeFi MCP server for Claude Code.**
 
@@ -7,13 +7,13 @@ Analyze any Solana token in seconds. Holder intelligence, risk scoring, smart mo
 ```
 > "analyze token 3oQwNvAfZMuPWjVPC12ukY7RPA9JiGwLod6Pr4Lkpump"
 
-═══ SUMMARY ═══
+=== SUMMARY ===
 POKE6900 is a 9mo old PumpSwap token with $25.9K liquidity and $34.5K market cap.
 53 diamond hands (53.0%), strong holder conviction.
 Only 18.0% of holders are in profit, most are underwater with avg loss of $844 per wallet.
 Buy pressure is strong at 3.3:1 ratio (1093 buys vs 395 sells), accumulation phase.
 Contract looks safe: mint and freeze authorities revoked.
-🟢 Lower risk profile based on available data.
+Lower risk profile based on available data.
 ```
 
 ## Why deficlaw?
@@ -27,18 +27,24 @@ Claude Code can write code, fix bugs, deploy apps. But ask it "what's the price
 - **Trending Tokens** with volume, liquidity, and boost data
 - **Top Traders** showing who made and lost money on any token
 - **Contract Security** checking mint/freeze authority on Solana
-- **1.5 second** full analysis (not 11 seconds like browser-based scrapers)
+- **~1.5 second** full analysis (not 11 seconds like browser-based scrapers)
 - **Zero config** - no API keys, no wallets, no accounts needed
 
-## Quick Start
+## Install
+
+### Option A: npm (recommended)
+
+```bash
+npm install -g @0xprotovox/deficlaw
+claude mcp add defi -- deficlaw
+```
+
+### Option B: From source
 
 ```bash
-# Clone and build
 git clone https://github.com/0xprotovox/deficlaw.git
 cd deficlaw
 npm install && npm run build
-
-# Add to Claude Code
 claude mcp add defi -- node /path/to/deficlaw/dist/index.js
 ```
 
@@ -81,12 +87,12 @@ Full token analysis with holder intelligence, risk scoring, and human-readable s
 
 ### `get_price`
 
-Quick price lookup. Sub-second response.
+Quick price lookup. Sub-second response. Supports both token addresses and name/symbol search.
 
 ```
 > "price of So11111112222..."
 
-BONK — $0.000024 (+5.2% 24h)
+BONK -- $0.000024 (+5.2% 24h)
 Volume: $142M | Liquidity: $12M | MCap: $1.8B
 ```
 
@@ -97,9 +103,9 @@ Trending and boosted tokens on any chain.
 ```
 > "trending tokens on solana"
 
-1. BONK — $0.000024 (+12%) — $142M volume
-2. WIF  — $0.89 (-2.1%)   — $89M volume
-3. JUP  — $0.94 (+3.5%)   — $45M volume
+1. BONK -- $0.000024 (+12%) -- $142M volume
+2. WIF  -- $0.89 (-2.1%)   -- $89M volume
+3. JUP  -- $0.94 (+3.5%)   -- $45M volume
 ...
 ```
 
@@ -110,13 +116,13 @@ Who made and lost money on a token. Winners, losers, PnL, tags.
 ```
 > "who profited on this token?"
 
-🏆 Top Winners:
-1. CR5N... — +$680 (+124%) 🟢 still holding
-2. EsRB... — +$166 (+16%) 💎 diamond hands
+Top Winners:
+1. CR5N... -- +$680 (+124%) still holding
+2. EsRB... -- +$166 (+16%) diamond hands
 
-💀 Top Losers:
-1. BgeeV... — -$7,548 (-65%) 💎 diamond hands (!)
-2. 5vqid... — -$5,420 (-50%) gmgn user
+Top Losers:
+1. BgeeV... -- -$7,548 (-65%) diamond hands (!)
+2. 5vqid... -- -$5,420 (-50%) gmgn user
 ```
 
 ## Data Sources
@@ -141,34 +147,36 @@ Holder analysis (GMGN) currently supports **Solana** tokens.
 
 ## Risk Scoring
 
-The risk scorer analyzes 6 dimensions to produce a 0-100 score:
+The risk scorer analyzes 8 dimensions to produce a 0-100 score:
 
-| Dimension | Weight | What it checks |
-|-----------|--------|----------------|
-| Liquidity | 25% | Pool depth in USD |
-| Token Age | 10% | Time since creation |
-| Holder Concentration | 20% | Top 10 holder % |
-| Dev Wallet | 20% | Dev holdings and selling behavior |
-| Fresh Wallets | 15% | New wallet % (possible wash/bundle) |
-| Sniper Activity | 10% | Bot/sniper wallets in top holders |
+| Dimension | Max Points | What it checks |
+|-----------|-----------|----------------|
+| Liquidity | 22 | Pool depth in USD |
+| Token Age | 10 | Time since creation |
+| Volume Anomalies | 8 | Wash trading signals, vol/mcap ratio |
+| Holder Concentration | 18 | Top 10 holder % |
+| Dev Wallet | 15 | Dev holdings and selling behavior |
+| Fresh Wallets | 12 | New wallet % (possible wash/bundle) |
+| Sniper Activity | 10 | Bot/sniper wallets in top holders |
+| Contract Security | 5 | Mint/freeze authority status |
 
-**Levels:** 🟢 LOW (0-19) | 🟡 MEDIUM (20-44) | 🟠 HIGH (45-69) | 🔴 CRITICAL (70-100)
+**Levels:** LOW (0-19) | MEDIUM (20-44) | HIGH (45-69) | CRITICAL (70-100)
 
 ## Architecture
 
 ```
-Claude Code ←→ MCP stdio ←→ deficlaw server
-                                 │
-                    ┌────────────┼────────────┐
-                    │            │            │
+Claude Code <-> MCP stdio <-> deficlaw server
+                                 |
+                    +------------+------------+
+                    |            |            |
               DexScreener    GMGN API    Solana RPC
               (prices)     (holders)    (security)
 ```
 
 - **MCP SDK** for Claude Code integration
 - **curl-based GMGN fetcher** bypasses Cloudflare (Playwright fallback if needed)
-- **In-memory TTL cache** prevents rate limiting
-- **Rate limiter** for DexScreener (150 req/min)
+- **In-memory TTL cache** with automatic cleanup prevents rate limiting
+- **Rate limiter** with retry logic for DexScreener (150 req/min)
 - **TypeScript** with full type safety
 
 ## Configuration
@@ -187,8 +195,8 @@ Add to your project's `.mcp.json`:
 {
   "mcpServers": {
     "defi": {
-      "command": "node",
-      "args": ["/path/to/deficlaw/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "@0xprotovox/deficlaw"],
       "env": {
         "SOLANA_RPC_URL": "https://your-rpc.com"
       }
@@ -197,19 +205,32 @@ Add to your project's `.mcp.json`:
 }
 ```
 
+Or if installed from source:
+
+```json
+{
+  "mcpServers": {
+    "defi": {
+      "command": "node",
+      "args": ["/path/to/deficlaw/dist/index.js"]
+    }
+  }
+}
+```
+
 ## Roadmap
 
 - [x] Token analysis with holder intelligence
-- [x] Risk scoring (6 dimensions)
+- [x] Risk scoring (8 dimensions)
 - [x] Contract security checks
 - [x] KOL detection with Twitter handles
 - [x] Human-readable AI summary
 - [x] Top traders (winners/losers)
+- [x] npm package (`npm install -g @0xprotovox/deficlaw`)
 - [ ] Token search by name/symbol
 - [ ] Slippage estimation (Jupiter quotes)
 - [ ] Token comparison (side by side)
 - [ ] Multi-chain holder analysis
-- [ ] npm package (`npm install -g deficlaw`)
 - [ ] Price alerts via MCP resources
 
 ## Built With

package/dist/analysis/formatOutput.d.ts

@@ -1,4 +1,115 @@
 /**
- * Format analysis output — clean, readable, both summary + detailed numbers
+ * Format analysis output as clean, readable plain text.
+ * Both human-readable summary and detailed numbers.
  */
-export declare function formatAnalysis(data: any): string;
+interface AnalysisData {
+    summary?: string;
+    token: {
+        name: string;
+        symbol: string;
+        chain: string;
+        address: string;
+        age?: string;
+        createdAt?: string;
+    };
+    price: {
+        usd: number;
+        change5m?: number;
+        change1h: number;
+        change6h?: number;
+        change24h: number;
+    };
+    market: {
+        marketCap: number;
+        fdv: number;
+        liquidity: number;
+        volume24h: number;
+        volume6h?: number;
+        volume1h: number;
+        volume5m?: number;
+        volumeLiquidityRatio?: number;
+        dex: string;
+        pairAddress: string;
+    };
+    security?: {
+        mintAuthority: string;
+        freezeAuthority: string;
+        supply: number;
+        decimals: number;
+    };
+    risk: {
+        score: number;
+        level: string;
+        flags?: {
+            severity: string;
+            message: string;
+        }[];
+    };
+    holders?: {
+        total: number;
+        concentration: {
+            top5Pct: number;
+            top10Pct: number;
+            top20Pct: number;
+        };
+        categories: Record<string, number>;
+        sentiment: {
+            profitableHolders: number;
+            losingHolders: number;
+            profitRatio: number;
+            totalPnlUsd: number;
+            totalCostUsd: number;
+            avgPnlPerHolder: number;
+        };
+        pressure: {
+            totalBuyTx: number;
+            totalSellTx: number;
+            buySellRatio: number;
+        };
+        devWallet?: {
+            address: string;
+            holdingPercent: number;
+            pnl: number;
+            status: string;
+        } | null;
+        topHolders: {
+            address: string;
+            tags: string[];
+            supplyPercent: number;
+            valueUsd: number;
+            pnl: number;
+            profitMultiple?: number;
+            buyTx?: number;
+            sellTx?: number;
+            isDeployer?: boolean;
+            isFreshWallet?: boolean;
+            twitterHandle?: string | null;
+        }[];
+    };
+    lpDetection?: {
+        lpAddress: string;
+        lpPercent: number;
+        realTopHolder?: {
+            address: string;
+            percent: number;
+        } | null;
+    };
+    kols?: {
+        address?: string;
+        twitterHandle?: string | null;
+        pnl: number;
+        status: string;
+        tags: string[];
+    }[];
+    socials?: {
+        websites?: string[];
+        twitter?: string | null;
+        telegram?: string | null;
+    };
+    meta: {
+        sources: string[];
+        fetchTimeMs: number;
+    };
+}
+export declare function formatAnalysis(data: AnalysisData): string;
+export {};

package/dist/analysis/formatOutput.js

@@ -1,6 +1,8 @@
 /**
- * Format analysis output — clean, readable, both summary + detailed numbers
+ * Format analysis output as clean, readable plain text.
+ * Both human-readable summary and detailed numbers.
  */
+/** Format a number as a dollar amount with appropriate precision */
 function fmt(n) {
     if (n === 0)
         return '$0';
@@ -12,89 +14,111 @@ function fmt(n) {
         return `$${n.toFixed(2)}`;
     if (Math.abs(n) >= 0.001)
         return `$${n.toFixed(4)}`;
-    return `$${n.toFixed(8)}`;
+    if (Math.abs(n) >= 0.0000001)
+        return `$${n.toFixed(8)}`;
+    return `$${n.toExponential(2)}`;
 }
+/** Format a decimal as a percentage string */
 function pct(n, digits = 1) {
     return `${(n * 100).toFixed(digits)}%`;
 }
+/** Format a price change with directional arrow */
 function arrow(n) {
     if (n > 0)
-        return `+${n.toFixed(2)}% 📈`;
+        return `+${n.toFixed(2)}%`;
     if (n < 0)
-        return `${n.toFixed(2)}% 📉`;
-    return '0% ➖';
+        return `${n.toFixed(2)}%`;
+    return '0%';
 }
+/** Shorten a blockchain address for display */
 function shortenAddr(addr) {
     if (addr.length <= 12)
         return addr;
     return `${addr.slice(0, 6)}...${addr.slice(-4)}`;
 }
+/** Pad or truncate a string to a fixed width */
+function pad(str, width) {
+    if (str.length >= width)
+        return str.slice(0, width);
+    return str + ' '.repeat(width - str.length);
+}
+/** Right-align a string within a fixed width */
+function rpad(str, width) {
+    if (str.length >= width)
+        return str.slice(0, width);
+    return ' '.repeat(width - str.length) + str;
+}
 export function formatAnalysis(data) {
     const lines = [];
     // ═══════ SUMMARY ═══════
     if (data.summary) {
-        lines.push('═══ SUMMARY ═══');
+        lines.push('=== SUMMARY ===');
         lines.push(data.summary);
         lines.push('');
     }
     // ═══════ TOKEN INFO ═══════
-    lines.push('═══ TOKEN ═══');
+    lines.push('=== TOKEN ===');
     lines.push(`Name: ${data.token.name} (${data.token.symbol})`);
     lines.push(`Chain: ${data.token.chain}`);
     lines.push(`Address: ${data.token.address}`);
-    lines.push(`Age: ${data.token.age}`);
+    if (data.token.age)
+        lines.push(`Age: ${data.token.age}`);
     if (data.token.createdAt)
         lines.push(`Created: ${data.token.createdAt}`);
     lines.push('');
     // ═══════ PRICE ═══════
-    lines.push('═══ PRICE ═══');
+    lines.push('=== PRICE ===');
     lines.push(`Price: ${fmt(data.price.usd)}`);
-    lines.push(`5min: ${arrow(data.price.change5m)}`);
-    lines.push(`1h:   ${arrow(data.price.change1h)}`);
-    lines.push(`6h:   ${arrow(data.price.change6h)}`);
-    lines.push(`24h:  ${arrow(data.price.change24h)}`);
+    if (data.price.change5m !== undefined)
+        lines.push(`5min:  ${arrow(data.price.change5m)}`);
+    lines.push(`1h:    ${arrow(data.price.change1h)}`);
+    if (data.price.change6h !== undefined)
+        lines.push(`6h:    ${arrow(data.price.change6h)}`);
+    lines.push(`24h:   ${arrow(data.price.change24h)}`);
     lines.push('');
     // ═══════ MARKET ═══════
-    lines.push('═══ MARKET ═══');
-    lines.push(`Market Cap: ${fmt(data.market.marketCap)}`);
-    lines.push(`FDV: ${fmt(data.market.fdv)}`);
-    lines.push(`Liquidity: ${fmt(data.market.liquidity)}`);
-    lines.push(`Volume 24h: ${fmt(data.market.volume24h)}`);
-    lines.push(`Volume 6h: ${fmt(data.market.volume6h)}`);
-    lines.push(`Volume 1h: ${fmt(data.market.volume1h)}`);
-    lines.push(`Volume 5m: ${fmt(data.market.volume5m)}`);
-    lines.push(`Vol/Liq Ratio: ${data.market.volumeLiquidityRatio}x`);
-    lines.push(`DEX: ${data.market.dex}`);
-    lines.push(`Pair: ${data.market.pairAddress}`);
+    lines.push('=== MARKET ===');
+    lines.push(`Market Cap:  ${fmt(data.market.marketCap)}`);
+    lines.push(`FDV:         ${fmt(data.market.fdv)}`);
+    lines.push(`Liquidity:   ${fmt(data.market.liquidity)}`);
+    lines.push(`Volume 24h:  ${fmt(data.market.volume24h)}`);
+    if (data.market.volume6h !== undefined)
+        lines.push(`Volume 6h:   ${fmt(data.market.volume6h)}`);
+    lines.push(`Volume 1h:   ${fmt(data.market.volume1h)}`);
+    if (data.market.volume5m !== undefined)
+        lines.push(`Volume 5m:   ${fmt(data.market.volume5m)}`);
+    if (data.market.volumeLiquidityRatio !== undefined) {
+        lines.push(`Vol/Liq:     ${data.market.volumeLiquidityRatio}x`);
+    }
+    lines.push(`DEX:         ${data.market.dex}`);
+    lines.push(`Pair:        ${data.market.pairAddress}`);
     lines.push('');
     // ═══════ SECURITY ═══════
     if (data.security) {
-        lines.push('═══ SECURITY ═══');
+        lines.push('=== SECURITY ===');
         const mintOk = data.security.mintAuthority === 'revoked';
         const freezeOk = data.security.freezeAuthority === 'revoked';
-        lines.push(`Mint Authority: ${mintOk ? '✅ Revoked (safe)' : '⚠️ ACTIVE (can print tokens!)'}`);
-        lines.push(`Freeze Authority: ${freezeOk ? '✅ Revoked (safe)' : '⚠️ ACTIVE (can freeze wallets!)'}`);
-        lines.push(`Total Supply: ${Math.round(data.security.supply).toLocaleString()}`);
-        lines.push(`Decimals: ${data.security.decimals}`);
+        lines.push(`Mint Authority:   ${mintOk ? 'Revoked (safe)' : 'ACTIVE (can print tokens!)'}`);
+        lines.push(`Freeze Authority: ${freezeOk ? 'Revoked (safe)' : 'ACTIVE (can freeze wallets!)'}`);
+        lines.push(`Total Supply:     ${Math.round(data.security.supply).toLocaleString()}`);
+        lines.push(`Decimals:         ${data.security.decimals}`);
         lines.push('');
     }
     // ═══════ RISK ═══════
-    lines.push('═══ RISK ═══');
-    const riskMap = { LOW: '🟢', MEDIUM: '🟡', HIGH: '🟠', CRITICAL: '🔴' };
-    const riskEmoji = riskMap[data.risk.level] || '⚪';
-    lines.push(`Score: ${data.risk.score}/100 ${riskEmoji} ${data.risk.level}`);
-    if (data.risk.flags?.length > 0) {
-        data.risk.flags.forEach((f) => {
-            const sevMap = { critical: '🔴', high: '🟠', medium: '🟡', low: '🟢' };
-            const fEmoji = sevMap[f.severity] || '⚪';
-            lines.push(`  ${fEmoji} ${f.message}`);
-        });
+    lines.push('=== RISK ===');
+    const riskIndicator = { LOW: '[LOW]', MEDIUM: '[MEDIUM]', HIGH: '[HIGH]', CRITICAL: '[CRITICAL]' };
+    lines.push(`Score: ${data.risk.score}/100 ${riskIndicator[data.risk.level] ?? data.risk.level}`);
+    if (data.risk.flags && data.risk.flags.length > 0) {
+        for (const f of data.risk.flags) {
+            const sevIndicator = { critical: '[!]', high: '[!]', medium: '[~]', low: '[.]' };
+            lines.push(`  ${sevIndicator[f.severity] ?? '   '} ${f.message}`);
+        }
     }
     lines.push('');
     // ═══════ HOLDERS ═══════
     if (data.holders) {
         const h = data.holders;
-        lines.push('═══ HOLDERS ═══');
+        lines.push('=== HOLDERS ===');
         lines.push(`Total Analyzed: ${h.total}`);
         lines.push('');
         // Concentration
@@ -105,71 +129,78 @@ export function formatAnalysis(data) {
         lines.push('');
         // Categories
         lines.push('Categories:');
-        const cats = h.categories;
-        if (cats.diamondHands > 0)
-            lines.push(`  💎 Diamond Hands: ${cats.diamondHands}`);
-        if (cats.snipers > 0)
-            lines.push(`  🎯 Snipers: ${cats.snipers}`);
-        if (cats.freshWallets > 0)
-            lines.push(`  🆕 Fresh Wallets: ${cats.freshWallets}`);
-        if (cats.kols > 0)
-            lines.push(`  👑 KOLs: ${cats.kols}`);
-        if (cats.smartMoney > 0)
-            lines.push(`  🧠 Smart Money: ${cats.smartMoney}`);
-        if (cats.insiders > 0)
-            lines.push(`  🔑 Insiders: ${cats.insiders}`);
-        if (cats.devWallets > 0)
-            lines.push(`  🛠️ Dev Wallets: ${cats.devWallets}`);
-        if (cats.photonUsers > 0)
-            lines.push(`  📸 Photon: ${cats.photonUsers}`);
-        if (cats.gmgnUsers > 0)
-            lines.push(`  📲 GMGN: ${cats.gmgnUsers}`);
-        if (cats.transferIn > 0)
-            lines.push(`  ↗️ Transfer In: ${cats.transferIn}`);
+        const catEntries = [
+            ['diamondHands', h.categories.diamondHands ?? 0, 'Diamond Hands'],
+            ['snipers', h.categories.snipers ?? 0, 'Snipers'],
+            ['freshWallets', h.categories.freshWallets ?? 0, 'Fresh Wallets'],
+            ['kols', h.categories.kols ?? 0, 'KOLs'],
+            ['smartMoney', h.categories.smartMoney ?? 0, 'Smart Money'],
+            ['insiders', h.categories.insiders ?? 0, 'Insiders'],
+            ['devWallets', h.categories.devWallets ?? 0, 'Dev Wallets'],
+            ['photonUsers', h.categories.photonUsers ?? 0, 'Photon'],
+            ['gmgnUsers', h.categories.gmgnUsers ?? 0, 'GMGN'],
+            ['transferIn', h.categories.transferIn ?? 0, 'Transfer In'],
+        ];
+        for (const [, count, label] of catEntries) {
+            if (count > 0)
+                lines.push(`  ${label}: ${count}`);
+        }
         lines.push('');
         // Sentiment
         lines.push('Sentiment:');
-        lines.push(`  Profitable: ${h.sentiment.profitableHolders} (${pct(h.sentiment.profitRatio)})`);
-        lines.push(`  Losing: ${h.sentiment.losingHolders}`);
-        lines.push(`  Total PnL: ${fmt(h.sentiment.totalPnlUsd)}`);
-        lines.push(`  Total Cost: ${fmt(h.sentiment.totalCostUsd)}`);
+        lines.push(`  Profitable:     ${h.sentiment.profitableHolders} (${pct(h.sentiment.profitRatio)})`);
+        lines.push(`  Losing:         ${h.sentiment.losingHolders}`);
+        lines.push(`  Total PnL:      ${fmt(h.sentiment.totalPnlUsd)}`);
+        lines.push(`  Total Cost:     ${fmt(h.sentiment.totalCostUsd)}`);
         lines.push(`  Avg PnL/holder: ${fmt(h.sentiment.avgPnlPerHolder)}`);
         lines.push('');
         // Buy/Sell Pressure
         lines.push('Buy/Sell Pressure:');
-        lines.push(`  Buy TX: ${h.pressure.totalBuyTx}`);
+        lines.push(`  Buy TX:  ${h.pressure.totalBuyTx}`);
         lines.push(`  Sell TX: ${h.pressure.totalSellTx}`);
-        lines.push(`  Ratio: ${h.pressure.buySellRatio.toFixed(2)}:1 ${h.pressure.buySellRatio > 1.5 ? '🟢' : h.pressure.buySellRatio < 0.7 ? '🔴' : '🟡'}`);
+        const ratioStr = h.pressure.buySellRatio === Infinity
+            ? 'all buys'
+            : `${h.pressure.buySellRatio.toFixed(2)}:1`;
+        const ratioIndicator = h.pressure.buySellRatio > 1.5 ? ' (bullish)'
+            : h.pressure.buySellRatio < 0.7 ? ' (bearish)'
+                : ' (neutral)';
+        lines.push(`  Ratio:   ${ratioStr}${ratioIndicator}`);
         lines.push('');
         // Dev Wallet
         if (h.devWallet) {
             lines.push('Dev Wallet:');
-            lines.push(`  Address: ${shortenAddr(h.devWallet.address)}`);
-            lines.push(`  Holding: ${pct(h.devWallet.holdingPercent)}`);
-            lines.push(`  PnL: ${fmt(h.devWallet.pnl)}`);
-            lines.push(`  Status: ${h.devWallet.status}`);
+            lines.push(`  Address:  ${shortenAddr(h.devWallet.address)}`);
+            lines.push(`  Holding:  ${pct(h.devWallet.holdingPercent)}`);
+            lines.push(`  PnL:      ${fmt(h.devWallet.pnl)}`);
+            lines.push(`  Status:   ${h.devWallet.status}`);
+            lines.push('');
+        }
+        // Top 20 Holders Table (fixed-width columns for alignment)
+        if (h.topHolders.length > 0) {
+            lines.push('Top Holders:');
+            lines.push(`  ${rpad('#', 3)} ${pad('Address', 13)} ${rpad('Supply', 7)} ${rpad('Value', 10)} ${rpad('PnL', 11)} Tags`);
+            lines.push(`  ${'-'.repeat(3)} ${'-'.repeat(13)} ${'-'.repeat(7)} ${'-'.repeat(10)} ${'-'.repeat(11)} ${'----'}`);
+            for (let i = 0; i < Math.min(h.topHolders.length, 20); i++) {
+                const holder = h.topHolders[i];
+                const num = rpad(String(i + 1), 3);
+                const addr = pad(shortenAddr(holder.address), 13);
+                const supply = rpad(pct(holder.supplyPercent), 7);
+                const value = rpad(fmt(holder.valueUsd), 10);
+                const pnlSign = holder.pnl >= 0 ? '+' : '';
+                const pnlStr = rpad(pnlSign + fmt(holder.pnl), 11);
+                const tags = holder.tags
+                    .filter((t) => !/^TOP\d+$/i.test(t))
+                    .join(', ') || '-';
+                const twitter = holder.twitterHandle ? ` @${holder.twitterHandle}` : '';
+                lines.push(`  ${num} ${addr} ${supply} ${value} ${pnlStr} ${tags}${twitter}`);
+            }
             lines.push('');
         }
-        // Top 20 Holders Table
-        lines.push('Top 20 Holders:');
-        lines.push('  #  | Address      | Supply  | Value     | PnL        | Tags');
-        lines.push('  ---|-------------|---------|-----------|------------|------');
-        h.topHolders.slice(0, 20).forEach((holder, i) => {
-            const num = String(i + 1).padStart(2);
-            const addr = shortenAddr(holder.address).padEnd(12);
-            const supply = pct(holder.supplyPercent).padStart(6);
-            const value = fmt(holder.valueUsd).padStart(9);
-            const pnl = (holder.pnl >= 0 ? '+' : '') + fmt(holder.pnl);
-            const tags = holder.tags.filter((t) => !/^TOP\d+$/.test(t)).join(', ') || '-';
-            const twitter = holder.twitterHandle ? ` @${holder.twitterHandle}` : '';
-            lines.push(`  ${num} | ${addr} | ${supply} | ${value} | ${pnl.padStart(10)} | ${tags}${twitter}`);
-        });
-        lines.push('');
     }
     // ═══════ LP DETECTION ═══════
     if (data.lpDetection) {
-        lines.push('═══ LP POOL ═══');
-        lines.push(`Top holder is LP pool: ✅`);
+        lines.push('=== LP POOL ===');
+        lines.push(`Top holder is LP pool`);
         lines.push(`LP Address: ${shortenAddr(data.lpDetection.lpAddress)}`);
         lines.push(`LP holds: ${pct(data.lpDetection.lpPercent)}`);
         if (data.lpDetection.realTopHolder) {
@@ -179,30 +210,34 @@ export function formatAnalysis(data) {
     }
     // ═══════ KOLs ═══════
     if (data.kols && data.kols.length > 0) {
-        lines.push('═══ KOLs ═══');
-        data.kols.forEach((k, i) => {
-            const handle = k.twitterHandle ? `@${k.twitterHandle}` : shortenAddr(k.address);
+        lines.push('=== KOLs ===');
+        for (let i = 0; i < data.kols.length; i++) {
+            const k = data.kols[i];
+            const handle = k.twitterHandle ? `@${k.twitterHandle}` : shortenAddr(k.address ?? 'unknown');
             const pnlStr = k.pnl !== 0 ? ` | PnL: ${fmt(k.pnl)}` : '';
-            const status = k.status === 'selling' ? '🔴 selling' : '🟢 holding';
-            const tags = k.tags.filter((t) => !/^TOP\d+$/.test(t) && t !== 'kol').join(', ');
+            const status = k.status === 'selling' ? 'selling' : 'holding';
+            const tags = k.tags
+                .filter((t) => !/^TOP\d+$/i.test(t) && t !== 'kol')
+                .join(', ');
             lines.push(`  ${i + 1}. ${handle} | ${status}${pnlStr}${tags ? ` | ${tags}` : ''}`);
-        });
+        }
         lines.push('');
     }
     // ═══════ SOCIALS ═══════
     if (data.socials) {
-        lines.push('═══ SOCIALS ═══');
-        if (data.socials.websites?.length > 0)
-            lines.push(`Website: ${data.socials.websites.join(', ')}`);
+        lines.push('=== SOCIALS ===');
+        if (data.socials.websites && data.socials.websites.length > 0) {
+            lines.push(`Website:  ${data.socials.websites.join(', ')}`);
+        }
         if (data.socials.twitter)
-            lines.push(`Twitter: ${data.socials.twitter}`);
+            lines.push(`Twitter:  ${data.socials.twitter}`);
         if (data.socials.telegram)
             lines.push(`Telegram: ${data.socials.telegram}`);
         lines.push('');
     }
     // ═══════ META ═══════
-    lines.push('═══ META ═══');
-    lines.push(`Sources: ${data.meta.sources.join(' + ')}`);
+    lines.push('=== META ===');
+    lines.push(`Sources:    ${data.meta.sources.join(' + ')}`);
     lines.push(`Fetch time: ${(data.meta.fetchTimeMs / 1000).toFixed(1)}s`);
     return lines.join('\n');
 }