@0xprotovox/deficlaw 0.1.1

package/README.md

@@ -0,0 +1,230 @@
+# DefiClaw
+
+**The first open-source DeFi MCP server for Claude Code.**
+
+Analyze any Solana token in seconds. Holder intelligence, risk scoring, smart money tracking, KOL detection. Zero API keys required.
+
+```
+> "analyze token 3oQwNvAfZMuPWjVPC12ukY7RPA9JiGwLod6Pr4Lkpump"
+
+═══ 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.
+```
+
+## Why deficlaw?
+
+Claude Code can write code, fix bugs, deploy apps. But ask it "what's the price of BONK?" and it says *"I don't have real-time data."*
+
+**deficlaw fixes that.** It gives Claude Code real-time access to DeFi data across Solana and 10+ chains.
+
+- **Token Analysis** with holder intelligence, risk scoring, KOL tracking
+- **Real-time Prices** from DexScreener across all major chains
+- **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)
+- **Zero config** - no API keys, no wallets, no accounts needed
+
+## Quick Start
+
+```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
+```
+
+Then just ask Claude naturally:
+
+```
+> "analyze this token: 3oQw...pump"
+> "what's the price of BONK?"
+> "show me trending tokens on solana"
+> "who made money on JUP token?"
+```
+
+## Tools
+
+### `analyze_token`
+
+Full token analysis with holder intelligence, risk scoring, and human-readable summary.
+
+**Input:**
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `address` | string | required | Token contract address |
+| `chain` | string | `"solana"` | Blockchain (solana, ethereum, bsc, base, arbitrum) |
+| `include_holders` | boolean | `true` | Include GMGN holder analysis |
+
+**Output includes:**
+- Token info (name, symbol, age, socials)
+- Price with 5m/1h/6h/24h changes
+- Market data (mcap, fdv, volume, liquidity, vol/liq ratio)
+- Contract security (mint authority, freeze authority, supply)
+- Risk score (0-100) with detailed flags
+- Holder concentration (top 5/10/20)
+- Holder categories (diamond hands, snipers, KOLs, fresh wallets, insiders)
+- Buy/sell pressure ratio
+- Sentiment (profitable vs underwater holders, avg PnL)
+- Dev wallet detection and status
+- Top 20 holders table with PnL and tags
+- KOL list with Twitter handles
+- Human-readable summary with actionable insights
+
+### `get_price`
+
+Quick price lookup. Sub-second response.
+
+```
+> "price of So11111112222..."
+
+BONK — $0.000024 (+5.2% 24h)
+Volume: $142M | Liquidity: $12M | MCap: $1.8B
+```
+
+### `get_trending`
+
+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
+...
+```
+
+### `get_top_traders`
+
+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 Losers:
+1. BgeeV... — -$7,548 (-65%) 💎 diamond hands (!)
+2. 5vqid... — -$5,420 (-50%) gmgn user
+```
+
+## Data Sources
+
+All free, no API keys required:
+
+| Source | Data | Speed |
+|--------|------|-------|
+| **DexScreener** | Prices, volume, liquidity, pairs, trending | <0.5s |
+| **GMGN** | Holders, tags, KOLs, PnL, dev wallet, snipers | ~1s |
+| **Solana RPC** | Mint authority, freeze authority, supply | <0.5s |
+
+**Total analysis time: ~1.5 seconds**
+
+## Supported Chains
+
+Prices and trending work on all DexScreener chains:
+
+Solana, Ethereum, Base, BSC, Arbitrum, Polygon, Avalanche, Optimism, Fantom, and more.
+
+Holder analysis (GMGN) currently supports **Solana** tokens.
+
+## Risk Scoring
+
+The risk scorer analyzes 6 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 |
+
+**Levels:** 🟢 LOW (0-19) | 🟡 MEDIUM (20-44) | 🟠 HIGH (45-69) | 🔴 CRITICAL (70-100)
+
+## Architecture
+
+```
+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)
+- **TypeScript** with full type safety
+
+## Configuration
+
+### Environment Variables (all optional)
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SOLANA_RPC_URL` | `https://api.mainnet-beta.solana.com` | Custom Solana RPC endpoint |
+
+### Claude Code Config
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "defi": {
+      "command": "node",
+      "args": ["/path/to/deficlaw/dist/index.js"],
+      "env": {
+        "SOLANA_RPC_URL": "https://your-rpc.com"
+      }
+    }
+  }
+}
+```
+
+## Roadmap
+
+- [x] Token analysis with holder intelligence
+- [x] Risk scoring (6 dimensions)
+- [x] Contract security checks
+- [x] KOL detection with Twitter handles
+- [x] Human-readable AI summary
+- [x] Top traders (winners/losers)
+- [ ] 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
+
+- [Model Context Protocol SDK](https://github.com/modelcontextprotocol/typescript-sdk) - MCP server framework
+- [DexScreener API](https://docs.dexscreener.com) - Price and market data
+- [GMGN](https://gmgn.ai) - Holder intelligence
+- TypeScript, Zod, Node.js 18+
+
+## License
+
+MIT
+
+## Author
+
+**@0xprotovox** - [Twitter](https://x.com/0xprotovox) | [GitHub](https://github.com/0xprotovox)
+
+20 years building software. Now building AI trading agents and DeFi tools.

package/dist/analysis/formatOutput.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Format analysis output — clean, readable, both summary + detailed numbers
+ */
+export declare function formatAnalysis(data: any): string;

package/dist/analysis/formatOutput.js

@@ -0,0 +1,209 @@
+/**
+ * Format analysis output — clean, readable, both summary + detailed numbers
+ */
+function fmt(n) {
+    if (n === 0)
+        return '$0';
+    if (Math.abs(n) >= 1_000_000)
+        return `$${(n / 1_000_000).toFixed(2)}M`;
+    if (Math.abs(n) >= 1_000)
+        return `$${(n / 1_000).toFixed(1)}K`;
+    if (Math.abs(n) >= 1)
+        return `$${n.toFixed(2)}`;
+    if (Math.abs(n) >= 0.001)
+        return `$${n.toFixed(4)}`;
+    return `$${n.toFixed(8)}`;
+}
+function pct(n, digits = 1) {
+    return `${(n * 100).toFixed(digits)}%`;
+}
+function arrow(n) {
+    if (n > 0)
+        return `+${n.toFixed(2)}% 📈`;
+    if (n < 0)
+        return `${n.toFixed(2)}% 📉`;
+    return '0% ➖';
+}
+function shortenAddr(addr) {
+    if (addr.length <= 12)
+        return addr;
+    return `${addr.slice(0, 6)}...${addr.slice(-4)}`;
+}
+export function formatAnalysis(data) {
+    const lines = [];
+    // ═══════ SUMMARY ═══════
+    if (data.summary) {
+        lines.push('═══ SUMMARY ═══');
+        lines.push(data.summary);
+        lines.push('');
+    }
+    // ═══════ TOKEN INFO ═══════
+    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.createdAt)
+        lines.push(`Created: ${data.token.createdAt}`);
+    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)}`);
+    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('');
+    // ═══════ SECURITY ═══════
+    if (data.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('');
+    }
+    // ═══════ 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('');
+    // ═══════ HOLDERS ═══════
+    if (data.holders) {
+        const h = data.holders;
+        lines.push('═══ HOLDERS ═══');
+        lines.push(`Total Analyzed: ${h.total}`);
+        lines.push('');
+        // Concentration
+        lines.push('Concentration:');
+        lines.push(`  Top 5:  ${pct(h.concentration.top5Pct)}`);
+        lines.push(`  Top 10: ${pct(h.concentration.top10Pct)}`);
+        lines.push(`  Top 20: ${pct(h.concentration.top20Pct)}`);
+        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}`);
+        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(`  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(`  Sell TX: ${h.pressure.totalSellTx}`);
+        lines.push(`  Ratio: ${h.pressure.buySellRatio.toFixed(2)}:1 ${h.pressure.buySellRatio > 1.5 ? '🟢' : h.pressure.buySellRatio < 0.7 ? '🔴' : '🟡'}`);
+        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('');
+        }
+        // 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 Address: ${shortenAddr(data.lpDetection.lpAddress)}`);
+        lines.push(`LP holds: ${pct(data.lpDetection.lpPercent)}`);
+        if (data.lpDetection.realTopHolder) {
+            lines.push(`Real top holder: ${shortenAddr(data.lpDetection.realTopHolder.address)} (${pct(data.lpDetection.realTopHolder.percent)})`);
+        }
+        lines.push('');
+    }
+    // ═══════ 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);
+            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(', ');
+            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(', ')}`);
+        if (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(`Fetch time: ${(data.meta.fetchTimeMs / 1000).toFixed(1)}s`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=formatOutput.js.map

package/dist/analysis/formatOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatOutput.js","sourceRoot":"","sources":["../../src/analysis/formatOutput.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,SAAS,GAAG,CAAC,CAAS;IACpB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACvE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/D,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,GAAG,CAAC,CAAS,EAAE,MAAM,GAAG,CAAC;IAChC,OAAO,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;AACzC,CAAC;AAED,SAAS,KAAK,CAAC,CAAS;IACtB,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAS;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,0BAA0B;IAC1B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,6BAA6B;IAC7B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IACrC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACzE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,wBAAwB;IACxB,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,yBAAyB;IACzB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,MAAM,CAAC,oBAAoB,GAAG,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,2BAA2B;IAC3B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,KAAK,SAAS,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,KAAK,SAAS,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,+BAA+B,EAAE,CAAC,CAAC;QAC/F,KAAK,CAAC,IAAI,CAAC,qBAAqB,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iCAAiC,EAAE,CAAC,CAAC;QACrG,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,MAAM,OAAO,GAA2B,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAChG,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5E,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAM,EAAE,EAAE;YACjC,MAAM,MAAM,GAA2B,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;YAC/F,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,0BAA0B;IAC1B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,gBAAgB;QAChB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,aAAa;QACb,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC;QAC1B,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAClF,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAClE,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAClF,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5E,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrE,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACzE,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACnE,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,YAAY;QACZ,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,iBAAiB,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/F,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,oBAAoB;QACpB,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrJ,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,aAAa;QACb,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7D,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,uBAAuB;QACvB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QAC5E,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAW,EAAE,CAAS,EAAE,EAAE;YAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACrD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YACtF,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,MAAM,MAAM,MAAM,KAAK,MAAM,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC,CAAC;QACpG,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,+BAA+B;IAC/B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,eAAe,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,oBAAoB,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACzI,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,uBAAuB;IACvB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAM,EAAE,CAAS,EAAE,EAAE;YACtC,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAChF,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;YACpE,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,0BAA0B;IAC1B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClG,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAExE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/analysis/riskScorer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Composite Risk Scorer
+ * Combines DexScreener + GMGN data into a 0-100 risk score
+ */
+import type { DexPair, Holder, RiskAssessment } from '../types/index.js';
+export declare function scoreRisk(pair: DexPair | null, holders?: Holder[]): RiskAssessment;

package/dist/analysis/riskScorer.js

@@ -0,0 +1,104 @@
+export function scoreRisk(pair, holders) {
+    const flags = [];
+    let totalScore = 0;
+    // 1. Liquidity risk (25% weight)
+    const liquidity = pair?.liquidity?.usd || 0;
+    if (liquidity < 5000) {
+        flags.push({ type: 'liquidity', severity: 'critical', message: `Extremely low liquidity: $${liquidity.toFixed(0)}` });
+        totalScore += 25;
+    }
+    else if (liquidity < 25000) {
+        flags.push({ type: 'liquidity', severity: 'high', message: `Low liquidity: $${liquidity.toFixed(0)}` });
+        totalScore += 18;
+    }
+    else if (liquidity < 100000) {
+        flags.push({ type: 'liquidity', severity: 'medium', message: `Moderate liquidity: $${liquidity.toFixed(0)}` });
+        totalScore += 8;
+    }
+    // 2. Token age (10% weight)
+    if (pair?.pairCreatedAt) {
+        const ageMs = Date.now() - pair.pairCreatedAt;
+        const ageHours = ageMs / (1000 * 60 * 60);
+        if (ageHours < 1) {
+            flags.push({ type: 'age', severity: 'critical', message: `Token launched ${Math.round(ageHours * 60)}m ago` });
+            totalScore += 10;
+        }
+        else if (ageHours < 24) {
+            flags.push({ type: 'age', severity: 'high', message: `Token is ${Math.round(ageHours)}h old` });
+            totalScore += 6;
+        }
+    }
+    // Holder-based risks (only if we have GMGN data)
+    if (holders && holders.length > 0) {
+        // 3. Top holder concentration (20% weight)
+        const sorted = [...holders].sort((a, b) => b.supplyPercent - a.supplyPercent);
+        const top10Pct = sorted.slice(0, 10).reduce((s, h) => s + h.supplyPercent, 0);
+        if (top10Pct > 60) {
+            flags.push({ type: 'concentration', severity: 'critical', message: `Top 10 holders own ${(top10Pct * 100).toFixed(1)}%` });
+            totalScore += 20;
+        }
+        else if (top10Pct > 40) {
+            flags.push({ type: 'concentration', severity: 'high', message: `Top 10 holders own ${(top10Pct * 100).toFixed(1)}%` });
+            totalScore += 12;
+        }
+        else if (top10Pct > 25) {
+            flags.push({ type: 'concentration', severity: 'medium', message: `Top 10 holders own ${(top10Pct * 100).toFixed(1)}%` });
+            totalScore += 5;
+        }
+        // 4. Dev wallet (20% weight)
+        const dev = holders.find(h => h.isDeployer);
+        if (dev) {
+            if (dev.supplyPercent > 0.10) {
+                flags.push({ type: 'dev_wallet', severity: 'high', message: `Dev holds ${(dev.supplyPercent * 100).toFixed(1)}%` });
+                totalScore += 15;
+            }
+            else if (dev.sellAmount > dev.buyAmount * 0.5) {
+                flags.push({ type: 'dev_selling', severity: 'medium', message: 'Dev has been selling' });
+                totalScore += 8;
+            }
+        }
+        // 5. Fresh wallets (15% weight)
+        const freshCount = holders.filter(h => h.isFreshWallet).length;
+        const freshPct = freshCount / holders.length;
+        if (freshPct > 0.30) {
+            flags.push({ type: 'fresh_wallets', severity: 'high', message: `${(freshPct * 100).toFixed(0)}% fresh wallets (possible bundle/wash)` });
+            totalScore += 15;
+        }
+        else if (freshPct > 0.15) {
+            flags.push({ type: 'fresh_wallets', severity: 'medium', message: `${(freshPct * 100).toFixed(0)}% fresh wallets` });
+            totalScore += 7;
+        }
+        // 6. Sniper activity (10% weight)
+        const sniperCount = holders.filter(h => h.tags.some(t => t.toLowerCase().includes('sniper') || t.toLowerCase().includes('bot'))).length;
+        if (sniperCount > 5) {
+            flags.push({ type: 'snipers', severity: 'high', message: `${sniperCount} sniper/bot wallets detected` });
+            totalScore += 10;
+        }
+        else if (sniperCount > 2) {
+            flags.push({ type: 'snipers', severity: 'medium', message: `${sniperCount} sniper wallets detected` });
+            totalScore += 4;
+        }
+    }
+    else {
+        // No holder data — add uncertainty
+        totalScore += 15;
+        flags.push({ type: 'no_holder_data', severity: 'medium', message: 'Holder analysis unavailable (install Playwright for full analysis)' });
+    }
+    // Clamp to 0-100
+    totalScore = Math.min(100, Math.max(0, totalScore));
+    const level = totalScore >= 70 ? 'CRITICAL' : totalScore >= 45 ? 'HIGH' : totalScore >= 20 ? 'MEDIUM' : 'LOW';
+    const summaryParts = [];
+    if (level === 'CRITICAL')
+        summaryParts.push('Extreme risk');
+    else if (level === 'HIGH')
+        summaryParts.push('High risk');
+    else if (level === 'MEDIUM')
+        summaryParts.push('Moderate risk');
+    else
+        summaryParts.push('Lower risk');
+    if (flags.length > 0) {
+        summaryParts.push(flags.slice(0, 3).map(f => f.message).join('; '));
+    }
+    return { score: totalScore, level, flags, summary: summaryParts.join('. ') + '.' };
+}
+//# sourceMappingURL=riskScorer.js.map

package/dist/analysis/riskScorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"riskScorer.js","sourceRoot":"","sources":["../../src/analysis/riskScorer.ts"],"names":[],"mappings":"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"}

package/dist/analysis/summaryGenerator.d.ts

@@ -0,0 +1,68 @@
+/**
+ * AI-like Summary Generator — code-generated, no API calls
+ * Produces human-readable analysis from raw data
+ */
+interface SummaryInput {
+    token: {
+        symbol: string;
+        name: string;
+        age: string;
+    };
+    price: {
+        usd: number;
+        change1h: number;
+        change6h: number;
+        change24h: number;
+        change5m: number;
+    };
+    market: {
+        marketCap: number;
+        volume24h: number;
+        volume1h: number;
+        liquidity: number;
+        volumeLiquidityRatio: number;
+        dex: string;
+    };
+    risk: {
+        score: number;
+        level: string;
+    };
+    holders?: {
+        total: number;
+        concentration: {
+            top5Pct: number;
+            top10Pct: number;
+            top20Pct: number;
+        };
+        categories: Record<string, number>;
+        sentiment: {
+            profitableHolders: number;
+            losingHolders: number;
+            profitRatio: number;
+            totalPnlUsd: number;
+            avgPnlPerHolder: number;
+        };
+        pressure: {
+            buySellRatio: number;
+            totalBuyTx: number;
+            totalSellTx: number;
+        };
+        devWallet: {
+            status: string;
+            holdingPercent: number;
+        } | null;
+    };
+    kols?: {
+        twitterHandle: string | null;
+        status: string;
+        pnl: number;
+    }[];
+    security?: {
+        mintAuthority: string;
+        freezeAuthority: string;
+        isLpTopHolder: boolean;
+        realTopHolderPct: number;
+    };
+}
+export declare function generateSummary(data: SummaryInput): string;
+export {};