@0xprotovox/deficlaw 0.1.1 → 0.2.0

package/dist/tools/getPrice.js

@@ -1,12 +1,31 @@
 /**
- * get_price tool — Quick price lookup
+ * get_price tool — Quick price lookup via DexScreener.
+ * Returns structured price data or error if token not found.
  */
-import { getPrice } from '../sources/dexscreener.js';
+import { getPrice, searchTokens } from '../sources/dexscreener.js';
 export async function handleGetPrice(args) {
+    if (!args.token || args.token.trim().length === 0) {
+        return { error: 'Token address or search query is required' };
+    }
     const chain = args.chain || 'solana';
-    const result = await getPrice(args.token, chain);
+    const token = args.token.trim();
+    // If it looks like an address (long alphanumeric), do direct lookup
+    if (token.length > 20) {
+        const result = await getPrice(token, chain);
+        if (!result) {
+            return { error: `Token not found: ${token} on ${chain}. Verify the address is correct.` };
+        }
+        return result;
+    }
+    // Otherwise try as a search query (symbol or name)
+    const pairs = await searchTokens(token);
+    const chainPair = pairs.find(p => p.chainId === chain) ?? pairs[0];
+    if (!chainPair) {
+        return { error: `No token found matching "${token}" on ${chain}` };
+    }
+    const result = await getPrice(chainPair.baseToken.address, chainPair.chainId);
     if (!result) {
-        return { error: `Token not found: ${args.token} on ${chain}` };
+        return { error: `Token data unavailable for "${token}" on ${chain}` };
     }
     return result;
 }

package/dist/tools/getPrice.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPrice.js","sourceRoot":"","sources":["../../src/tools/getPrice.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAuC;IAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,KAAK,EAAE,oBAAoB,IAAI,CAAC,KAAK,OAAO,KAAK,EAAE,EAAE,CAAC;IACjE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"getPrice.js","sourceRoot":"","sources":["../../src/tools/getPrice.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGnE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAuC;IAC1E,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAEhC,oEAAoE;IACpE,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,KAAK,EAAE,oBAAoB,KAAK,OAAO,KAAK,kCAAkC,EAAE,CAAC;QAC5F,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,mDAAmD;IACnD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,4BAA4B,KAAK,QAAQ,KAAK,EAAE,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,KAAK,EAAE,+BAA+B,KAAK,QAAQ,KAAK,EAAE,EAAE,CAAC;IACxE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/getTopTraders.d.ts

@@ -1,3 +1,15 @@
+interface TraderInfo {
+    address: string;
+    pnl: number;
+    profitMultiple: number;
+    tags: string[];
+    twitterHandle: string | null;
+    buyTx: number;
+    sellTx: number;
+    stillHolding: boolean;
+    isDeployer: boolean;
+    isDiamondHands: boolean;
+}
 export declare function handleGetTopTraders(args: {
     address: string;
     limit?: number;
@@ -5,9 +17,23 @@ export declare function handleGetTopTraders(args: {
     error: string;
     token?: undefined;
     totalHoldersAnalyzed?: undefined;
+    note?: undefined;
     profitSummary?: undefined;
     topWinners?: undefined;
     topLosers?: undefined;
+} | {
+    token: string;
+    totalHoldersAnalyzed: number;
+    note: string;
+    profitSummary: {
+        totalProfit: number;
+        totalLoss: number;
+        profitableCount: number;
+        losingCount: number;
+    };
+    topWinners: never[];
+    topLosers: never[];
+    error?: undefined;
 } | {
     token: string;
     totalHoldersAnalyzed: number;
@@ -17,29 +43,9 @@ export declare function handleGetTopTraders(args: {
         profitableCount: number;
         losingCount: number;
     };
-    topWinners: {
-        address: string;
-        pnl: number;
-        profitMultiple: number;
-        tags: string[];
-        twitterHandle: string | null;
-        buyTx: number;
-        sellTx: number;
-        stillHolding: boolean;
-        isDeployer: boolean;
-        isDiamondHands: boolean;
-    }[];
-    topLosers: {
-        address: string;
-        pnl: number;
-        profitMultiple: number;
-        tags: string[];
-        twitterHandle: string | null;
-        buyTx: number;
-        sellTx: number;
-        stillHolding: boolean;
-        isDeployer: boolean;
-        isDiamondHands: boolean;
-    }[];
+    topWinners: TraderInfo[];
+    topLosers: TraderInfo[];
     error?: undefined;
+    note?: undefined;
 }>;
+export {};

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xprotovox/deficlaw",
-  "version": "0.1.1",
+  "version": "0.2.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"
   ]
 }