@0xprotovox/deficlaw 0.1.1 → 0.3.0

package/dist/tools/getTopTraders.js

@@ -1,22 +1,10 @@
 /**
- * get_top_traders tool — Who made/lost money on a token
- * Uses GMGN holder data already collected by analyze_token
+ * get_top_traders tool — Who made/lost money on a token.
+ * Uses GMGN holder data to rank traders by PnL.
  */
 import * as gmgn from '../sources/gmgn.js';
-export async function handleGetTopTraders(args) {
-    const limit = args.limit || 10;
-    if (!(await gmgn.isPlaywrightAvailable())) {
-        return { error: 'Playwright not installed. Run: npm install playwright && npx playwright install chromium' };
-    }
-    const { holders } = await gmgn.getHolders(args.address);
-    if (holders.length === 0)
-        return { error: 'No holder data found' };
-    const withPnl = holders.filter(h => h.totalPnl !== 0);
-    const winners = [...withPnl].sort((a, b) => b.totalPnl - a.totalPnl).slice(0, limit);
-    const losers = [...withPnl].sort((a, b) => a.totalPnl - b.totalPnl).slice(0, limit);
-    const totalProfit = withPnl.filter(h => h.totalPnl > 0).reduce((s, h) => s + h.totalPnl, 0);
-    const totalLoss = withPnl.filter(h => h.totalPnl < 0).reduce((s, h) => s + h.totalPnl, 0);
-    const format = (h) => ({
+function formatTrader(h) {
+    return {
         address: h.address,
         pnl: Math.round(h.totalPnl * 100) / 100,
         profitMultiple: Math.round(h.profitMultiple * 100) / 100,
@@ -27,18 +15,45 @@ export async function handleGetTopTraders(args) {
         stillHolding: h.balance > 0,
         isDeployer: h.isDeployer,
         isDiamondHands: h.tags.some(t => /diamond/i.test(t)),
-    });
+    };
+}
+export async function handleGetTopTraders(args) {
+    if (!args.address || args.address.trim().length === 0) {
+        return { error: 'Token address is required' };
+    }
+    const limit = Math.min(Math.max(1, args.limit || 10), 50);
+    const { holders } = await gmgn.getHolders(args.address);
+    if (holders.length === 0) {
+        return { error: `No holder data found for ${args.address}. The token may not be indexed by GMGN.` };
+    }
+    const withPnl = holders.filter(h => h.totalPnl !== 0);
+    if (withPnl.length === 0) {
+        return {
+            token: args.address,
+            totalHoldersAnalyzed: holders.length,
+            note: 'No PnL data available for any holders. All holders may have entered at the same price.',
+            profitSummary: { totalProfit: 0, totalLoss: 0, profitableCount: 0, losingCount: 0 },
+            topWinners: [],
+            topLosers: [],
+        };
+    }
+    const winners = [...withPnl].sort((a, b) => b.totalPnl - a.totalPnl).slice(0, limit);
+    const losers = [...withPnl].sort((a, b) => a.totalPnl - b.totalPnl).slice(0, limit);
+    const profitable = withPnl.filter(h => h.totalPnl > 0);
+    const losing = withPnl.filter(h => h.totalPnl < 0);
+    const totalProfit = profitable.reduce((s, h) => s + h.totalPnl, 0);
+    const totalLoss = losing.reduce((s, h) => s + h.totalPnl, 0);
     return {
         token: args.address,
         totalHoldersAnalyzed: holders.length,
         profitSummary: {
             totalProfit: Math.round(totalProfit),
             totalLoss: Math.round(totalLoss),
-            profitableCount: withPnl.filter(h => h.totalPnl > 0).length,
-            losingCount: withPnl.filter(h => h.totalPnl < 0).length,
+            profitableCount: profitable.length,
+            losingCount: losing.length,
         },
-        topWinners: winners.map(format),
-        topLosers: losers.map(format),
+        topWinners: winners.map(formatTrader),
+        topLosers: losers.map(formatTrader),
     };
 }
 //# sourceMappingURL=getTopTraders.js.map

package/dist/tools/getTopTraders.js.map

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

package/dist/tools/getTrending.d.ts

@@ -4,6 +4,13 @@ export declare function handleGetTrending(args: {
 }): Promise<{
     chain: string;
     count: number;
-    tokens: any[];
+    tokens: never[];
+    note: string;
     fetchedAt: string;
+} | {
+    chain: string;
+    count: number;
+    tokens: (import("../types/index.js").TrendingToken & Partial<import("../types/index.js").PriceResult>)[];
+    fetchedAt: string;
+    note?: undefined;
 }>;

package/dist/tools/getTrending.js

@@ -1,11 +1,21 @@
 /**
- * get_trending tool — Trending/boosted tokens
+ * get_trending tool — Trending/boosted tokens from DexScreener.
+ * Returns tokens sorted by boost activity with price enrichment.
  */
 import { getTrending } from '../sources/dexscreener.js';
 export async function handleGetTrending(args) {
     const chain = args.chain || 'solana';
-    const limit = args.limit || 20;
+    const limit = Math.min(Math.max(1, args.limit || 20), 50);
     const tokens = await getTrending(chain, limit);
+    if (tokens.length === 0) {
+        return {
+            chain,
+            count: 0,
+            tokens: [],
+            note: `No trending tokens found on ${chain}. DexScreener boost data may be temporarily unavailable.`,
+            fetchedAt: new Date().toISOString(),
+        };
+    }
     return {
         chain,
         count: tokens.length,

package/dist/tools/getTrending.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTrending.js","sourceRoot":"","sources":["../../src/tools/getTrending.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAwC;IAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAE/C,OAAO;QACL,KAAK;QACL,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getTrending.js","sourceRoot":"","sources":["../../src/tools/getTrending.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAwC;IAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAE/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,KAAK;YACL,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,+BAA+B,KAAK,0DAA0D;YACpG,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK;QACL,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/tools/searchToken.d.ts

@@ -0,0 +1,24 @@
+interface SearchResult {
+    address: string;
+    name: string;
+    symbol: string;
+    chain: string;
+    priceUsd: number;
+    volume24h: number;
+    liquidity: number;
+    marketCap: number;
+    dex: string;
+    pairCreatedAt: string | null;
+}
+export declare function handleSearchToken(args: {
+    query: string;
+    chain?: string;
+    limit?: number;
+}): Promise<{
+    results: SearchResult[];
+    count: number;
+    query: string;
+} | {
+    error: string;
+}>;
+export {};

package/dist/tools/searchToken.js

@@ -0,0 +1,43 @@
+/**
+ * search_token tool — Search tokens by name or symbol via DexScreener.
+ * Returns top matches with address, price, chain.
+ */
+import { searchTokens } from '../sources/dexscreener.js';
+import { debug } from '../utils/debug.js';
+export async function handleSearchToken(args) {
+    if (!args.query || args.query.trim().length === 0) {
+        return { error: 'Search query is required (token name or symbol)' };
+    }
+    const query = args.query.trim();
+    const chain = args.chain || undefined;
+    const limit = Math.min(Math.max(1, args.limit || 10), 20);
+    debug(`Searching tokens: "${query}" chain=${chain ?? 'any'} limit=${limit}`);
+    const pairs = await searchTokens(query);
+    if (pairs.length === 0) {
+        return { error: `No tokens found matching "${query}". Try a different name or symbol.` };
+    }
+    // Filter by chain if specified
+    const filtered = chain ? pairs.filter(p => p.chainId === chain) : pairs;
+    if (filtered.length === 0) {
+        return { error: `No tokens found matching "${query}" on ${chain}. Found results on other chains.` };
+    }
+    const results = filtered.slice(0, limit).map(p => ({
+        address: p.baseToken.address,
+        name: p.baseToken.name,
+        symbol: p.baseToken.symbol,
+        chain: p.chainId,
+        priceUsd: parseFloat(p.priceUsd) || 0,
+        volume24h: p.volume?.h24 ?? 0,
+        liquidity: p.liquidity?.usd ?? 0,
+        marketCap: p.marketCap ?? 0,
+        dex: p.dexId,
+        pairCreatedAt: p.pairCreatedAt ? new Date(p.pairCreatedAt).toISOString() : null,
+    }));
+    debug(`Search "${query}": ${results.length} results`);
+    return {
+        query,
+        count: results.length,
+        results,
+    };
+}
+//# sourceMappingURL=searchToken.js.map

package/dist/tools/searchToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchToken.js","sourceRoot":"","sources":["../../src/tools/searchToken.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAe1C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAuD;IAG7F,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;IACtE,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAE1D,KAAK,CAAC,sBAAsB,KAAK,WAAW,KAAK,IAAI,KAAK,UAAU,KAAK,EAAE,CAAC,CAAC;IAE7E,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAExC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,6BAA6B,KAAK,oCAAoC,EAAE,CAAC;IAC3F,CAAC;IAED,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAExE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,6BAA6B,KAAK,QAAQ,KAAK,kCAAkC,EAAE,CAAC;IACtG,CAAC;IAED,MAAM,OAAO,GAAmB,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO;QAC5B,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI;QACtB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM;QAC1B,KAAK,EAAE,CAAC,CAAC,OAAO;QAChB,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;QAC7B,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC;QAChC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC;QAC3B,GAAG,EAAE,CAAC,CAAC,KAAK;QACZ,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;KAChF,CAAC,CAAC,CAAC;IAEJ,KAAK,CAAC,WAAW,KAAK,MAAM,OAAO,CAAC,MAAM,UAAU,CAAC,CAAC;IAEtD,OAAO;QACL,KAAK;QACL,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+/** DexScreener pair data from /latest/dex/tokens endpoint */
 export interface DexPair {
     chainId: string;
     dexId: string;
@@ -45,6 +46,37 @@ export interface DexPair {
     };
     pairCreatedAt?: number;
 }
+/** Normalized price result from DexScreener */
+export interface PriceResult {
+    address: string;
+    symbol: string;
+    name: string;
+    priceUsd: number;
+    priceChange1h: number;
+    priceChange24h: number;
+    volume24h: number;
+    liquidity: number;
+    marketCap: number;
+    dex: string;
+}
+/** Boosted/trending token from DexScreener */
+export interface TrendingToken {
+    address: string;
+    symbol: string;
+    name: string;
+    chainId: string;
+    url: string;
+    boostAmount: number;
+}
+/** Raw GMGN boost entry from /token-boosts endpoints */
+export interface DexBoostEntry {
+    tokenAddress?: string;
+    chainId?: string;
+    description?: string;
+    url?: string;
+    totalAmount?: number;
+}
+/** Normalized holder from GMGN API */
 export interface Holder {
     address: string;
     tags: string[];
@@ -68,6 +100,7 @@ export interface Holder {
     isFreshWallet: boolean;
     lastActiveAt: string | null;
 }
+/** Individual risk flag from analysis */
 export interface RiskFlag {
     type: string;
     severity: 'low' | 'medium' | 'high' | 'critical';
@@ -79,6 +112,7 @@ export interface RiskAssessment {
     flags: RiskFlag[];
     summary: string;
 }
+/** Complete token analysis result */
 export interface TokenAnalysis {
     token: {
         address: string;

package/dist/utils/debug.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Debug logging utility.
+ * Only logs when DEBUG=deficlaw is set. Silent otherwise (clean MCP output).
+ */
+export declare function debug(message: string, ...args: unknown[]): void;
+/** Time a function and log duration */
+export declare function debugTime<T>(label: string, fn: () => Promise<T>): Promise<T>;

package/dist/utils/debug.js

@@ -0,0 +1,27 @@
+/**
+ * Debug logging utility.
+ * Only logs when DEBUG=deficlaw is set. Silent otherwise (clean MCP output).
+ */
+const DEBUG_ENABLED = (process.env.DEBUG ?? '').split(',').some(s => s.trim() === 'deficlaw' || s.trim() === '*');
+export function debug(message, ...args) {
+    if (!DEBUG_ENABLED)
+        return;
+    const ts = new Date().toISOString().slice(11, 23);
+    process.stderr.write(`[deficlaw ${ts}] ${message}${args.length > 0 ? ' ' + args.map(a => typeof a === 'object' ? JSON.stringify(a) : String(a)).join(' ') : ''}\n`);
+}
+/** Time a function and log duration */
+export async function debugTime(label, fn) {
+    if (!DEBUG_ENABLED)
+        return fn();
+    const start = Date.now();
+    try {
+        const result = await fn();
+        debug(`${label} completed in ${Date.now() - start}ms`);
+        return result;
+    }
+    catch (err) {
+        debug(`${label} failed in ${Date.now() - start}ms:`, err instanceof Error ? err.message : String(err));
+        throw err;
+    }
+}
+//# sourceMappingURL=debug.js.map

package/dist/utils/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,aAAa,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAC7D,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,CACjD,CAAC;AAEF,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;IACvD,IAAI,CAAC,aAAa;QAAE,OAAO;IAC3B,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACtK,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,KAAa,EAAE,EAAoB;IACpE,IAAI,CAAC,aAAa;QAAE,OAAO,EAAE,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,KAAK,CAAC,GAAG,KAAK,iBAAiB,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,KAAK,CAAC,GAAG,KAAK,cAAc,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACvG,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xprotovox/deficlaw",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "DeFi MCP Server for Claude Code — token analysis, prices, trending, holder intelligence",
   "author": "0xprotovox",
   "license": "MIT",
@@ -9,6 +9,19 @@
     "deficlaw": "dist/index.js"
   },
   "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/0xprotovox/deficlaw.git"
+  },
+  "bugs": {
+    "url": "https://github.com/0xprotovox/deficlaw/issues"
+  },
+  "homepage": "https://github.com/0xprotovox/deficlaw#readme",
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
@@ -41,6 +54,9 @@
     "crypto",
     "token-analysis",
     "claude-code",
-    "ai-tools"
+    "ai-tools",
+    "dexscreener",
+    "gmgn",
+    "risk-scoring"
   ]
 }