keyring-agent-core 0.1.0

package/dist/tools/builtin/token/TokenInfoTool.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenInfoTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+const GeminiProvider_1 = require("../../../llm/GeminiProvider");
+/**
+ * Tool: get-token-info
+ *
+ * Searches for a token by symbol/name and returns metadata, price,
+ * 24h change, and whether the user holds it in their wallet.
+ * Combines data from Pantograph search, Moralis metadata, and wallet balances.
+ */
+class TokenInfoTool extends BaseTool_1.BaseTool {
+    name = 'get-token-info';
+    description = 'Get information about a specific cryptocurrency token: price, metadata, 24h change, market data, and user holdings. ' +
+        'Use this when the user asks about: token price, token info, "what is X token", "tell me about X", ' +
+        '"how much is X worth", or any token-specific question. ' +
+        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea';
+    category = 'blockchain-data';
+    parameters = [
+        {
+            name: 'keyword',
+            type: 'string',
+            description: 'Token symbol, name, or contract address (e.g. "USDC", "Pepe", "ETH", "0x1234…"). ' +
+                'If a 0x address is provided, performs a precise contract lookup. Otherwise searches by name/symbol.',
+            required: true,
+        },
+        {
+            name: 'chain',
+            type: 'string',
+            description: 'Hex chain ID: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, ' +
+                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea. Defaults to connected chain.',
+            required: true,
+        },
+        {
+            name: 'prompt',
+            type: 'string',
+            description: 'A rich, multi-angle research prompt sent to Gemini with Google Search grounding (real-time web access). ' +
+                "The prompt must be self-contained — Gemini does NOT see the user's original message, only this prompt. " +
+                'ALWAYS include: the token symbol/name, the chain, and an instruction to use web search for up-to-date info. ' +
+                'When the user asks an open/broad question (e.g. "show me X", "tell me about X", "what is X"), ' +
+                'expand the prompt to cover ALL of these angles in one request: ' +
+                '(1) what the token/project is and its core utility, ' +
+                '(2) current USD price, 24h change, market cap, FDV, 24h volume, ' +
+                '(3) recent news, announcements, or notable events in the last 7-30 days, ' +
+                '(4) on-chain activity signals (holders, liquidity, unusual flows), ' +
+                '(5) team/protocol updates or roadmap items, ' +
+                '(6) key risks, red flags, or controversies, ' +
+                '(7) sentiment and notable community discussion. ' +
+                'When the user asks a narrow question (e.g. "price of X"), still include 2-3 supporting angles for context. ' +
+                'Aim for 3-6 sentences. Be specific to the token. Do not use generic filler. ' +
+                'Example for "show me JPYT": "Research the JPYT token on Ethereum using up-to-date web sources. ' +
+                'Cover: what JPYT is and who issues it; current USD price, 24h change, market cap, FDV, and 24h volume; ' +
+                'recent news or announcements in the last 30 days; on-chain signals such as holder count, liquidity, ' +
+                'and unusual volume patterns; team or protocol updates; key risks or red flags; and overall sentiment."',
+            required: true,
+        },
+    ];
+    service;
+    llm;
+    constructor(config) {
+        super();
+        this.service = new MoralisService_1.MoralisService(config);
+        this.llm = new GeminiProvider_1.GeminiProvider({});
+    }
+    async run(args, userContext) {
+        const keyword = args.keyword || '';
+        const chain = args.chain || userContext?.chain || '0x1';
+        const prompt = args.prompt || '';
+        const walletAddress = userContext?.walletAddress || undefined;
+        if (!keyword) {
+            return { error: 'Missing required parameter: keyword' };
+        }
+        return await this.searchToken(keyword, chain, prompt, walletAddress);
+    }
+    async searchToken(keyword, chain, prompt, walletAddress) {
+        const systemPrompt = [
+            walletAddress ? `User's connected wallet address: ${walletAddress}` : null,
+            chain ? `Current chain (hex chain ID): ${chain}, only consider tokens on this chain` : null,
+            'Use this context to personalize your answer where relevant (e.g. whether the user holds the token, chain-specific data).',
+        ]
+            .filter(Boolean)
+            .join('\n');
+        // Run search, wallet check, and Gemini (with Google Search grounding) in parallel
+        const [searchRes, walletHolding, aiText] = await Promise.all([
+            this.service.searchTokensByKey({ key: keyword, chain }),
+            walletAddress ? this.findTokenInWallet(walletAddress, chain, keyword) : Promise.resolve(null),
+            prompt ? this.askGeminiWithSearch(prompt, systemPrompt) : Promise.resolve(null),
+        ]);
+        const list = searchRes.success && searchRes.data ? (Array.isArray(searchRes.data) ? searchRes.data : []) : [];
+        const kw = keyword.toLowerCase();
+        const isExactMatch = (t) => t.symbol?.toLowerCase() === kw || t.token_address?.toLowerCase() === kw;
+        const sortedList = [...list].sort((a, b) => (isExactMatch(a) ? 0 : 1) - (isExactMatch(b) ? 0 : 1));
+        // Get Moralis metadata for best match (richer price data)
+        let token = null;
+        const topResult = sortedList[0];
+        if (topResult?.token_address) {
+            const metaRes = await this.service.getTokenMetadata({
+                address: topResult.token_address,
+                chain,
+            });
+            if (metaRes.success && metaRes.data) {
+                token = metaRes.data;
+            }
+        }
+        // Fallback: use search result directly
+        if (!token && topResult) {
+            token = { ...topResult };
+        }
+        const data = {
+            _instructions: 'Present the token info in a clear summary. Include: token name & symbol, contract address (shortened), ' +
+                'current USD price, 24h price change % (use ▲ for positive, ▼ for negative), market cap, ' +
+                'fully diluted valuation, 24h trading volume, liquidity, and holder count (if available). ' +
+                'If the user holds this token, prominently show their balance and USD value. ' +
+                'If aiInsights is present, include it as a separate "AI Analysis" section after the token stats. ' +
+                'Format numbers in a human-readable way (e.g. $1.23, +5.67%, $12.5M). If a field is null, omit it.',
+            chain,
+            userHoldsToken: !!walletHolding,
+            walletBalance: walletHolding,
+            token,
+            ...(list.length > 1
+                ? {
+                    searchResults: sortedList.slice(0, 10),
+                }
+                : {}),
+            aiInsights: aiText,
+        };
+        return data;
+    }
+    async askGeminiWithSearch(prompt, systemPrompt) {
+        const now = Date.now();
+        try {
+            const res = await this.llm.chat([
+                ...(systemPrompt ? [{ role: 'system', content: systemPrompt, timestamp: now }] : []),
+                { role: 'user', content: prompt, timestamp: now },
+            ], undefined, { googleSearch: true, maxRetries: 1 });
+            return res.text?.trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async findTokenInWallet(walletAddress, chain, keyword) {
+        if (!keyword)
+            return null;
+        const balancesRes = await this.service.getWalletTokenBalances({
+            address: walletAddress,
+            chain,
+            excludeSpam: true,
+            excludeUnverifiedContracts: true,
+        });
+        if (!balancesRes.success || !balancesRes.data?.result)
+            return null;
+        const kw = keyword.toLowerCase();
+        const match = balancesRes.data.result.find((t) => t.token_address.toLowerCase() === kw || t.symbol?.toLowerCase() === kw || t.name?.toLowerCase().includes(kw));
+        if (!match)
+            return null;
+        return match;
+    }
+}
+exports.TokenInfoTool = TokenInfoTool;
+//# sourceMappingURL=TokenInfoTool.js.map

package/dist/tools/builtin/token/TokenInfoTool.js.map

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

package/dist/tools/builtin/token/TokenScoreTool.d.ts

@@ -0,0 +1,63 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig } from '../../../services/MoralisService';
+export type TokenScoreToolConfig = MoralisServiceConfig;
+/**
+ * Tool: get-token-score
+ *
+ * Queries `GET /tokens/{tokenAddress}/score` — a composite 0–100 health/safety
+ * score for a single token, plus the underlying metrics Moralis uses to
+ * compute it.
+ *
+ * Returned fields:
+ *   - score: integer 0–100 (higher = safer / healthier)
+ *   - updatedAt: ISO timestamp of last refresh
+ *   - metrics.usdPrice, metrics.liquidityUsd
+ *   - metrics.volumeUsd: 10m / 30m / 1h / 4h / 12h / 1d / 7d / 30d
+ *   - metrics.transactions: same 8 buckets
+ *   - metrics.supply: { total, top10Percent }
+ *
+ * Accepts either `tokenSymbol` (e.g. "PEPE") or `contractAddress` (0x…).
+ * Symbol → address resolution mirrors `TokenAnalyticsTool` / `TokenHoldersTool`:
+ * first checks the connected wallet's balances, then falls back to Pantograph
+ * search.
+ */
+export declare class TokenScoreTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: TokenScoreToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        token?: undefined;
+        score?: undefined;
+        updatedAt?: undefined;
+        metrics?: undefined;
+    } | {
+        token: {
+            symbol: string | null;
+            name: string | null;
+            contractAddress: string;
+            chain: string;
+        };
+        score: number | null;
+        updatedAt: string | null;
+        metrics: {
+            usdPrice: number | null;
+            liquidityUsd: number | null;
+            volumeUsd: import("../../../services/MoralisService").TokenScoreTimeframeBuckets | null;
+            transactions: import("../../../services/MoralisService").TokenScoreTimeframeBuckets | null;
+            supply: import("../../../services/MoralisService").TokenScoreSupply | null;
+        };
+        error?: undefined;
+    }>;
+    /**
+     * Resolve a contract address from a token symbol.
+     * 1. Wallet balances (if wallet address available — most reliable)
+     * 2. Pantograph token search (fallback)
+     */
+    private resolveContractAddress;
+}
+//# sourceMappingURL=TokenScoreTool.d.ts.map

package/dist/tools/builtin/token/TokenScoreTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenScoreTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TokenScoreTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAqB;IACzB,WAAW,SAauE;IAClF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA0BzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,oBAAoB;cAKzB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;IA0D5E;;;;OAIG;YACW,sBAAsB;CA4BrC"}

package/dist/tools/builtin/token/TokenScoreTool.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenScoreTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+/**
+ * Tool: get-token-score
+ *
+ * Queries `GET /tokens/{tokenAddress}/score` — a composite 0–100 health/safety
+ * score for a single token, plus the underlying metrics Moralis uses to
+ * compute it.
+ *
+ * Returned fields:
+ *   - score: integer 0–100 (higher = safer / healthier)
+ *   - updatedAt: ISO timestamp of last refresh
+ *   - metrics.usdPrice, metrics.liquidityUsd
+ *   - metrics.volumeUsd: 10m / 30m / 1h / 4h / 12h / 1d / 7d / 30d
+ *   - metrics.transactions: same 8 buckets
+ *   - metrics.supply: { total, top10Percent }
+ *
+ * Accepts either `tokenSymbol` (e.g. "PEPE") or `contractAddress` (0x…).
+ * Symbol → address resolution mirrors `TokenAnalyticsTool` / `TokenHoldersTool`:
+ * first checks the connected wallet's balances, then falls back to Pantograph
+ * search.
+ */
+class TokenScoreTool extends BaseTool_1.BaseTool {
+    name = 'get-token-score';
+    description = 'Get a composite 0–100 health/safety score for a single ERC-20 token, plus the metrics behind it. ' +
+        'Returns: overall score, last-updated timestamp, current USD price, paired liquidity, ' +
+        'multi-timeframe volume buckets (10m / 30m / 1h / 4h / 12h / 1d / 7d / 30d), ' +
+        'same buckets for transaction counts, and supply info (total supply + % held by top 10 holders). ' +
+        'Use tokenSymbol (e.g. "PEPE") to look up by name — the tool auto-resolves the contract address. ' +
+        'Use contractAddress when you already have the exact 0x address. ' +
+        'Use this tool for questions like: ' +
+        '"Is PEPE a safe token?" (tokenSymbol=PEPE → score), ' +
+        '"What\'s the health/score of USDC?", ' +
+        '"How concentrated is X\'s supply among whales?" (→ metrics.supply.top10Percent), ' +
+        '"How much volume did this token do over the last 7 days?" (→ metrics.volumeUsd.7d), ' +
+        '"Transaction count for this token in the last hour?" (→ metrics.transactions.1h). ' +
+        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea.';
+    category = 'blockchain-data';
+    parameters = [
+        {
+            name: 'tokenSymbol',
+            type: 'string',
+            description: 'Token symbol (e.g. "PEPE", "USDC", "WETH"). ' +
+                "The tool resolves the contract address automatically: first checks the connected wallet's balances, " +
+                'then searches by symbol. Takes precedence over contractAddress when both are given.',
+            required: false,
+        },
+        {
+            name: 'contractAddress',
+            type: 'string',
+            description: 'ERC-20 token contract address (0x…). Use when the exact address is already known. ' +
+                'Ignored if tokenSymbol is provided.',
+            required: false,
+        },
+        {
+            name: 'chain',
+            type: 'string',
+            description: 'Hex chain ID: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, ' +
+                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea. Defaults to connected chain.',
+            required: true,
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new MoralisService_1.MoralisService(config);
+    }
+    async run(args, userContext) {
+        const chain = args.chain || userContext?.chain || undefined;
+        const walletAddress = userContext?.walletAddress || undefined;
+        const tokenSymbol = typeof args.tokenSymbol === 'string' && args.tokenSymbol ? args.tokenSymbol.trim() : undefined;
+        let contractAddress = typeof args.contractAddress === 'string' && args.contractAddress ? args.contractAddress.trim() : undefined;
+        if (!tokenSymbol && !contractAddress) {
+            return { error: 'Provide either tokenSymbol (e.g. "PEPE") or contractAddress (0x…).' };
+        }
+        let resolvedSymbol;
+        let resolvedName;
+        if (tokenSymbol) {
+            const resolved = await this.resolveContractAddress(tokenSymbol, chain, walletAddress);
+            if (!resolved) {
+                return {
+                    error: `Cannot resolve token symbol "${tokenSymbol}" to a contract address on chain ${chain ?? 'default'}. Try passing contractAddress directly.`,
+                };
+            }
+            contractAddress = resolved.address;
+            resolvedSymbol = resolved.symbol;
+            resolvedName = resolved.name;
+        }
+        const result = await this.service.getTokenScore({
+            address: contractAddress,
+            chain,
+        });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch token score' };
+        }
+        const data = result.data ?? {};
+        const metrics = data.metrics ?? {};
+        return {
+            token: {
+                symbol: resolvedSymbol ?? tokenSymbol ?? null,
+                name: resolvedName ?? null,
+                contractAddress: contractAddress,
+                chain: chain || 'default',
+            },
+            score: data.score ?? null,
+            updatedAt: data.updatedAt ?? null,
+            metrics: {
+                usdPrice: metrics.usdPrice ?? null,
+                liquidityUsd: metrics.liquidityUsd ?? null,
+                volumeUsd: metrics.volumeUsd ?? null,
+                transactions: metrics.transactions ?? null,
+                supply: metrics.supply ?? null,
+            },
+        };
+    }
+    /**
+     * Resolve a contract address from a token symbol.
+     * 1. Wallet balances (if wallet address available — most reliable)
+     * 2. Pantograph token search (fallback)
+     */
+    async resolveContractAddress(symbol, chain, walletAddress) {
+        const symLower = symbol.toLowerCase();
+        if (walletAddress) {
+            const balRes = await this.service.getWalletTokenBalances({ address: walletAddress, chain });
+            if (balRes.success && balRes.data?.result?.length) {
+                const match = balRes.data.result.find((t) => (t.symbol ?? '').toLowerCase() === symLower);
+                if (match) {
+                    return { address: match.token_address, symbol: match.symbol, name: match.name };
+                }
+            }
+        }
+        const searchRes = await this.service.searchTokensByKey({ key: symbol, chain });
+        if (searchRes.success && searchRes.data?.length) {
+            const exact = searchRes.data.find((t) => (t.symbol ?? '').toLowerCase() === symLower);
+            const candidate = exact ?? searchRes.data[0];
+            if (candidate?.token_address) {
+                return { address: candidate.token_address, symbol: candidate.symbol, name: candidate.name };
+            }
+        }
+        return undefined;
+    }
+}
+exports.TokenScoreTool = TokenScoreTool;
+//# sourceMappingURL=TokenScoreTool.js.map

package/dist/tools/builtin/token/TokenScoreTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenScoreTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TokenScoreTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAE1C,qEAA6F;AAI7F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,cAAe,SAAQ,mBAAQ;IAC1C,IAAI,GAAG,iBAAiB,CAAC;IACzB,WAAW,GACT,mGAAmG;QACnG,uFAAuF;QACvF,8EAA8E;QAC9E,kGAAkG;QAClG,kGAAkG;QAClG,kEAAkE;QAClE,oCAAoC;QACpC,sDAAsD;QACtD,uCAAuC;QACvC,mFAAmF;QACnF,sFAAsF;QACtF,oFAAoF;QACpF,+EAA+E,CAAC;IAClF,QAAQ,GAAG,iBAAiB,CAAC;IAC7B,UAAU,GAAoB;QAC5B;YACE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,8CAA8C;gBAC9C,sGAAsG;gBACtG,qFAAqF;YACvF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,oFAAoF;gBACpF,qCAAqC;YACvC,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2FAA2F;gBAC3F,qFAAqF;YACvF,QAAQ,EAAE,IAAI;SACf;KACF,CAAC;IAEM,OAAO,CAAiB;IAEhC,YAAY,MAA6B;QACvC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,+BAAc,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAES,KAAK,CAAC,GAAG,CAAC,IAA6B,EAAE,WAAyB;QAC1E,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,WAAW,EAAE,KAAK,IAAI,SAAS,CAAC;QACxE,MAAM,aAAa,GAAG,WAAW,EAAE,aAAa,IAAI,SAAS,CAAC;QAE9D,MAAM,WAAW,GAAG,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACnH,IAAI,eAAe,GACjB,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAE7G,IAAI,CAAC,WAAW,IAAI,CAAC,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,KAAK,EAAE,oEAAoE,EAAE,CAAC;QACzF,CAAC;QAED,IAAI,cAAkC,CAAC;QACvC,IAAI,YAAgC,CAAC;QAErC,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,WAAW,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;YACtF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO;oBACL,KAAK,EAAE,gCAAgC,WAAW,oCAAoC,KAAK,IAAI,SAAS,yCAAyC;iBAClJ,CAAC;YACJ,CAAC;YACD,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC;YACnC,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;YACjC,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC/B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;YAC9C,OAAO,EAAE,eAAgB;YACzB,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,6BAA6B,EAAE,CAAC;QAClE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QAEnC,OAAO;YACL,KAAK,EAAE;gBACL,MAAM,EAAE,cAAc,IAAI,WAAW,IAAI,IAAI;gBAC7C,IAAI,EAAE,YAAY,IAAI,IAAI;gBAC1B,eAAe,EAAE,eAAgB;gBACjC,KAAK,EAAE,KAAK,IAAI,SAAS;aAC1B;YACD,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;YACjC,OAAO,EAAE;gBACP,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;gBAClC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;gBAC1C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;gBACpC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;gBAC1C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;aAC/B;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,sBAAsB,CAClC,MAAc,EACd,KAAc,EACd,aAAsB;QAEtB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAEtC,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5F,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,CAAC;gBAC1F,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;gBAClF,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,IAAI,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,CAAC;YACtF,MAAM,SAAS,GAAG,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC7C,IAAI,SAAS,EAAE,aAAa,EAAE,CAAC;gBAC7B,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;YAC9F,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AA/ID,wCA+IC"}

package/dist/tools/builtin/token/TopGainersTool.d.ts

@@ -0,0 +1,46 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig, type TopGainerToken, type TopGainersTimeFrame } from '../../../services/MoralisService';
+export type TopGainersToolConfig = MoralisServiceConfig;
+/**
+ * Tool: get-top-gainers
+ *
+ * Queries `GET /discovery/tokens/top-gainers` — tokens with the largest USD
+ * price increase over a chosen timeframe. Supports filters for minimum market
+ * cap and minimum security score so the caller can exclude micro-cap or
+ * risky contracts.
+ *
+ * Each row carries multi-timeframe buckets (1h / 1d / 1w / 1M) for:
+ *   - price_percent_change_usd
+ *   - volume_change_usd / net_volume_change_usd
+ *   - liquidity_change_usd
+ *   - holders_change
+ *   - experienced_net_buyers_change
+ */
+export declare class TopGainersTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: TopGainersToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        _instructions?: undefined;
+        timeFrame?: undefined;
+        filters?: undefined;
+        count?: undefined;
+        tokens?: undefined;
+    } | {
+        _instructions: string;
+        timeFrame: TopGainersTimeFrame | null;
+        filters: {
+            minMarketCap: number | null;
+            securityScore: number | null;
+        };
+        count: number;
+        tokens: TopGainerToken[];
+        error?: undefined;
+    }>;
+}
+//# sourceMappingURL=TopGainersTool.d.ts.map

package/dist/tools/builtin/token/TopGainersTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TopGainersTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TopGainersTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAIxD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAqB;IACzB,WAAW,SAUiF;IAC5F,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAmCzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,oBAAoB;cAKzB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;CA+C7E"}

package/dist/tools/builtin/token/TopGainersTool.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopGainersTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+const ALLOWED_TIMEFRAMES = ['1h', '1d', '1w', '1M'];
+/**
+ * Tool: get-top-gainers
+ *
+ * Queries `GET /discovery/tokens/top-gainers` — tokens with the largest USD
+ * price increase over a chosen timeframe. Supports filters for minimum market
+ * cap and minimum security score so the caller can exclude micro-cap or
+ * risky contracts.
+ *
+ * Each row carries multi-timeframe buckets (1h / 1d / 1w / 1M) for:
+ *   - price_percent_change_usd
+ *   - volume_change_usd / net_volume_change_usd
+ *   - liquidity_change_usd
+ *   - holders_change
+ *   - experienced_net_buyers_change
+ */
+class TopGainersTool extends BaseTool_1.BaseTool {
+    name = 'get-top-gainers';
+    description = 'List tokens with the highest USD price increase over a chosen timeframe (1h / 1d / 1w / 1M). ' +
+        'Returns price, market cap, fully-diluted valuation, token age, Twitter followers, security score, ' +
+        'on-chain strength index, and multi-timeframe change buckets for: price %, volume, net volume, ' +
+        'liquidity, holder count, and experienced net buyers. ' +
+        'Optionally filter out low-quality tokens via minMarketCap (USD floor) and securityScore (0–100, higher = safer). ' +
+        'Use this tool for questions like: ' +
+        '"What are today\'s top gainers?", "Biggest pumps this week?", "Which tokens went up most in the last hour?", ' +
+        '"Show me safe tokens that gained this month (securityScore >= 80)", ' +
+        '"Top gainers on Base with market cap over $10M". ' +
+        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea, and more.';
+    category = 'blockchain-data';
+    parameters = [
+        {
+            name: 'chain',
+            type: 'string',
+            description: 'Hex chain ID: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, ' +
+                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea. Defaults to connected chain, ' +
+                'or Ethereum (0x1) if no chain is connected.',
+            required: true,
+        },
+        {
+            name: 'timeFrame',
+            type: 'string',
+            description: 'Window over which the price change is measured. Allowed values: ' +
+                '"1h" (last hour), "1d" (last 24h), "1w" (last 7 days), "1M" (last 30 days). ' +
+                'Pick the timeframe that matches the user\'s question — e.g. "today" → "1d", "this week" → "1w".',
+            required: false,
+        },
+        {
+            name: 'minMarketCap',
+            type: 'number',
+            description: 'Minimum token market cap in USD. Use to exclude micro-caps and meme dust. ' +
+                'Example: 1000000 = $1M floor, 10000000 = $10M floor. Omit for no floor.',
+            required: false,
+        },
+        {
+            name: 'securityScore',
+            type: 'number',
+            description: 'Minimum security score threshold on a 0–100 scale (higher = safer). ' +
+                'Typical values: 70 (moderate safety), 80 (safe), 90 (very safe). Omit for no filter.',
+            required: false,
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new MoralisService_1.MoralisService(config);
+    }
+    async run(args, userContext) {
+        const chain = args.chain || userContext?.chain || '0x1';
+        const rawTimeFrame = typeof args.timeFrame === 'string' ? args.timeFrame.trim() : undefined;
+        const timeFrame = rawTimeFrame && ALLOWED_TIMEFRAMES.includes(rawTimeFrame)
+            ? rawTimeFrame
+            : undefined;
+        if (rawTimeFrame && !timeFrame) {
+            return {
+                error: `Invalid timeFrame "${rawTimeFrame}". Allowed values: ${ALLOWED_TIMEFRAMES.join(', ')}.`,
+            };
+        }
+        const minMarketCap = typeof args.minMarketCap === 'number' && Number.isFinite(args.minMarketCap) && args.minMarketCap >= 0
+            ? args.minMarketCap
+            : undefined;
+        const securityScore = typeof args.securityScore === 'number' && Number.isFinite(args.securityScore) ? args.securityScore : undefined;
+        const result = await this.service.getTopGainers({ chain, timeFrame, minMarketCap, securityScore });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch top gainers' };
+        }
+        const tokens = result.data ?? [];
+        return {
+            _instructions: 'Present the top gainers as a ranked list. For each token show: rank number, name & symbol, ' +
+                'current USD price, price change % over the selected timeframe (use ▲ for positive, ▼ for negative), ' +
+                'market cap, 24h volume change, liquidity change, and security score (if available). ' +
+                'Format numbers in a human-readable way (e.g. $1.23, +5.67%, $12.5M). ' +
+                'If securityScore is present, add a safety label: ≥80 = Safe, 60–79 = Moderate, <60 = Risky. ' +
+                'If a field is null, omit it.',
+            timeFrame: timeFrame ?? null,
+            filters: {
+                minMarketCap: minMarketCap ?? null,
+                securityScore: securityScore ?? null,
+            },
+            count: tokens.length,
+            tokens: tokens,
+        };
+    }
+}
+exports.TopGainersTool = TopGainersTool;
+//# sourceMappingURL=TopGainersTool.js.map

package/dist/tools/builtin/token/TopGainersTool.js.map

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

package/dist/tools/builtin/token/TopLosersTool.d.ts

@@ -0,0 +1,66 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig, type TopGainersTimeFrame } from '../../../services/MoralisService';
+export type TopLosersToolConfig = MoralisServiceConfig;
+/**
+ * Tool: get-top-losers
+ *
+ * Queries `GET /discovery/tokens/top-losers` — tokens with the largest USD
+ * price decrease over a chosen timeframe. Mirrors the top-gainers endpoint
+ * with the same filter set (minimum market cap, minimum security score) and
+ * the same response shape; only the ranking direction differs.
+ *
+ * Each row carries multi-timeframe buckets (1h / 1d / 1w / 1M) for:
+ *   - price_percent_change_usd
+ *   - volume_change_usd / net_volume_change_usd
+ *   - liquidity_change_usd
+ *   - holders_change
+ *   - experienced_net_buyers_change
+ */
+export declare class TopLosersTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: TopLosersToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        chain?: undefined;
+        timeFrame?: undefined;
+        filters?: undefined;
+        count?: undefined;
+        tokens?: undefined;
+    } | {
+        chain: string;
+        timeFrame: TopGainersTimeFrame | null;
+        filters: {
+            minMarketCap: number | null;
+            securityScore: number | null;
+        };
+        count: number;
+        tokens: {
+            chainId: string;
+            contractAddress: string;
+            symbol: string | null;
+            name: string | null;
+            logo: string | null;
+            usdPrice: number | null;
+            marketCap: number | null;
+            fullyDilutedValuation: number | null;
+            tokenAgeInDays: number | null;
+            securityScore: number | null;
+            onChainStrengthIndex: number | null;
+            twitterFollowers: number | null;
+            pricePercentChangeUsd: import("../../../services/MoralisService").TopGainerTimeFrames | null;
+            volumeChangeUsd: import("../../../services/MoralisService").TopGainerTimeFrames | null;
+            netVolumeChangeUsd: import("../../../services/MoralisService").TopGainerTimeFrames | null;
+            liquidityChangeUsd: import("../../../services/MoralisService").TopGainerTimeFrames | null;
+            holdersChange: import("../../../services/MoralisService").TopGainerTimeFrames | null;
+            experiencedNetBuyersChange: import("../../../services/MoralisService").TopGainerTimeFrames | null;
+        }[];
+        error?: undefined;
+    }>;
+    private projectToken;
+}
+//# sourceMappingURL=TopLosersTool.d.ts.map

package/dist/tools/builtin/token/TopLosersTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TopLosersTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TopLosersTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAIvD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,IAAI,SAAoB;IACxB,WAAW,SAWiF;IAC5F,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAmCzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,mBAAmB;cAKxB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA0C5E,OAAO,CAAC,YAAY;CAsBrB"}