keyring-agent-core 0.2.0 → 0.2.2

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

@@ -1,71 +0,0 @@
-import { BaseTool } from '../../BaseTool';
-import type { ToolParameter, UserContext } from '../../../types';
-import { type MoralisServiceConfig } from '../../../services/MoralisService';
-export type TokenAnalyticsToolConfig = MoralisServiceConfig;
-/**
- * Tool: get-token-analytics
- *
- * Queries `GET /tokens/{tokenAddress}/analytics` — detailed trading analytics
- * for a single token broken down across 5min / 1h / 6h / 24h windows.
- *
- * Returned metrics:
- *   - totalBuyVolume / totalSellVolume (USD)
- *   - totalBuyers / totalSellers (unique counts)
- *   - totalBuys / totalSells (transaction counts)
- *   - uniqueWallets
- *   - pricePercentChange
- *   - usdPrice, totalLiquidity, totalFullyDilutedValuation (point-in-time)
- *
- * Accepts either `tokenSymbol` (e.g. "PEPE") or `contractAddress` (0x…).
- * Symbol → address resolution mirrors `TokenHoldersTool`: first checks the
- * connected wallet's balances, then falls back to Pantograph search.
- */
-export declare class TokenAnalyticsTool extends BaseTool {
-    name: string;
-    description: string;
-    category: string;
-    parameters: ToolParameter[];
-    private service;
-    constructor(config?: TokenAnalyticsToolConfig);
-    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
-        error: string;
-        token?: undefined;
-        usdPrice?: undefined;
-        totalLiquidity?: undefined;
-        totalFullyDilutedValuation?: undefined;
-        totalBuyVolume?: undefined;
-        totalSellVolume?: undefined;
-        totalBuyers?: undefined;
-        totalSellers?: undefined;
-        totalBuys?: undefined;
-        totalSells?: undefined;
-        uniqueWallets?: undefined;
-        pricePercentChange?: undefined;
-    } | {
-        token: {
-            symbol: string | null;
-            name: string | null;
-            contractAddress: string;
-            chain: string;
-        };
-        usdPrice: string | number | null;
-        totalLiquidity: string | number | null;
-        totalFullyDilutedValuation: string | number | null;
-        totalBuyVolume: import("../../../services/MoralisService").TokenAnalyticsTimeframeBuckets | null;
-        totalSellVolume: import("../../../services/MoralisService").TokenAnalyticsTimeframeBuckets | null;
-        totalBuyers: import("../../../services/MoralisService").TokenAnalyticsTimeframeBuckets | null;
-        totalSellers: import("../../../services/MoralisService").TokenAnalyticsTimeframeBuckets | null;
-        totalBuys: import("../../../services/MoralisService").TokenAnalyticsTimeframeBuckets | null;
-        totalSells: import("../../../services/MoralisService").TokenAnalyticsTimeframeBuckets | null;
-        uniqueWallets: import("../../../services/MoralisService").TokenAnalyticsTimeframeBuckets | null;
-        pricePercentChange: import("../../../services/MoralisService").TokenAnalyticsTimeframeBuckets | 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=TokenAnalyticsTool.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"TokenAnalyticsTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TokenAnalyticsTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,IAAI,SAAyB;IAC7B,WAAW,SAauE;IAClF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA0BzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,wBAAwB;cAK7B,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2D5E;;;;OAIG;YACW,sBAAsB;CA4BrC"}

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

@@ -1,147 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TokenAnalyticsTool = void 0;
-const BaseTool_1 = require("../../BaseTool");
-const chainResolver_1 = require("../../chainResolver");
-const MoralisService_1 = require("../../../services/MoralisService");
-/**
- * Tool: get-token-analytics
- *
- * Queries `GET /tokens/{tokenAddress}/analytics` — detailed trading analytics
- * for a single token broken down across 5min / 1h / 6h / 24h windows.
- *
- * Returned metrics:
- *   - totalBuyVolume / totalSellVolume (USD)
- *   - totalBuyers / totalSellers (unique counts)
- *   - totalBuys / totalSells (transaction counts)
- *   - uniqueWallets
- *   - pricePercentChange
- *   - usdPrice, totalLiquidity, totalFullyDilutedValuation (point-in-time)
- *
- * Accepts either `tokenSymbol` (e.g. "PEPE") or `contractAddress` (0x…).
- * Symbol → address resolution mirrors `TokenHoldersTool`: first checks the
- * connected wallet's balances, then falls back to Pantograph search.
- */
-class TokenAnalyticsTool extends BaseTool_1.BaseTool {
-    name = 'get-token-analytics';
-    description = 'Get detailed trading analytics for a single ERC-20 token, broken down across 5min / 1h / 6h / 24h windows. ' +
-        'Returns: buy volume, sell volume, unique buyers, unique sellers, buy/sell transaction counts, unique wallets, ' +
-        'price % change, current USD price, total liquidity and fully-diluted valuation (FDV). ' +
-        '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: ' +
-        '"How is PEPE trading today?" (tokenSymbol=PEPE), ' +
-        '"24h buy vs sell volume for USDC?" (tokenSymbol=USDC → totalBuyVolume vs totalSellVolume), ' +
-        '"Is buying or selling pressure stronger for this token?", ' +
-        '"How many unique wallets touched this token in the last hour?" (→ uniqueWallets.1h), ' +
-        '"What\'s the FDV and liquidity of X?" (→ totalFullyDilutedValuation, totalLiquidity), ' +
-        '"Price change over 6h?" (→ pricePercentChange.6h). ' +
-        '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. ONLY set this when the user EXPLICITLY names a chain; otherwise OMIT it so the connected wallet chain is used.',
-            required: false,
-        },
-    ];
-    service;
-    constructor(config) {
-        super();
-        this.service = new MoralisService_1.MoralisService(config);
-    }
-    async run(args, userContext) {
-        const chain = (0, chainResolver_1.resolveChain)(args.chain, userContext);
-        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.getTokenAnalytics({
-            address: contractAddress,
-            chain,
-        });
-        if (!result.success) {
-            return { error: result.error || 'Failed to fetch token analytics' };
-        }
-        const data = result.data ?? {};
-        return {
-            token: {
-                symbol: resolvedSymbol ?? tokenSymbol ?? null,
-                name: resolvedName ?? null,
-                contractAddress: contractAddress,
-                chain: chain || 'default',
-            },
-            usdPrice: data.usdPrice ?? null,
-            totalLiquidity: data.totalLiquidity ?? null,
-            totalFullyDilutedValuation: data.totalFullyDilutedValuation ?? null,
-            totalBuyVolume: data.totalBuyVolume ?? null,
-            totalSellVolume: data.totalSellVolume ?? null,
-            totalBuyers: data.totalBuyers ?? null,
-            totalSellers: data.totalSellers ?? null,
-            totalBuys: data.totalBuys ?? null,
-            totalSells: data.totalSells ?? null,
-            uniqueWallets: data.uniqueWallets ?? null,
-            pricePercentChange: data.pricePercentChange ?? 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.TokenAnalyticsTool = TokenAnalyticsTool;
-//# sourceMappingURL=TokenAnalyticsTool.js.map

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

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

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

@@ -1,81 +0,0 @@
-import { BaseTool } from '../../BaseTool';
-import type { ToolParameter, UserContext } from '../../../types';
-import { type MoralisServiceConfig } from '../../../services/MoralisService';
-export type TokenHoldersToolConfig = MoralisServiceConfig;
-/**
- * Tool: get-token-holders
- *
- * Queries `GET /erc20/{address}/holders` which returns aggregate holder
- * statistics for an ERC-20 token — NOT a paginated list of addresses.
- *
- * Response covers:
- *   - totalHolders: current unique holder count
- *   - holderChange: change in holder count over 5min / 1h / 6h / 24h / 3d / 7d / 30d
- *   - holdersByAcquisition: how holders acquired (swap / transfer / airdrop)
- *   - holderSupply: supply concentration for top 10/25/50/100/250/500 holders
- *   - holderDistribution: segmentation by size (whales → shrimps)
- */
-export declare class TokenHoldersTool extends BaseTool {
-    name: string;
-    description: string;
-    category: string;
-    parameters: ToolParameter[];
-    private service;
-    constructor(config?: TokenHoldersToolConfig);
-    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
-        error: string;
-        token?: undefined;
-        totalHolders?: undefined;
-        holdersByAcquisition?: undefined;
-        holderChange?: undefined;
-        holderSupply?: undefined;
-        holderDistribution?: undefined;
-    } | {
-        token: {
-            symbol: string | null;
-            name: string | null;
-            contractAddress: string;
-            chain: string;
-        };
-        totalHolders: number;
-        holdersByAcquisition: {
-            swap: number;
-            transfer: number;
-            airdrop: number;
-        };
-        holderChange: {
-            '5min': import("../../../services/MoralisService").HolderChangePeriod;
-            '1h': import("../../../services/MoralisService").HolderChangePeriod;
-            '6h': import("../../../services/MoralisService").HolderChangePeriod;
-            '24h': import("../../../services/MoralisService").HolderChangePeriod;
-            '3d': import("../../../services/MoralisService").HolderChangePeriod;
-            '7d': import("../../../services/MoralisService").HolderChangePeriod;
-            '30d': import("../../../services/MoralisService").HolderChangePeriod;
-        };
-        holderSupply: {
-            top10: import("../../../services/MoralisService").HolderSupplyTier;
-            top25: import("../../../services/MoralisService").HolderSupplyTier;
-            top50: import("../../../services/MoralisService").HolderSupplyTier;
-            top100: import("../../../services/MoralisService").HolderSupplyTier;
-            top250: import("../../../services/MoralisService").HolderSupplyTier;
-            top500: import("../../../services/MoralisService").HolderSupplyTier;
-        };
-        holderDistribution: {
-            whales: number;
-            sharks: number;
-            dolphins: number;
-            fish: number;
-            octopus: number;
-            crabs: number;
-            shrimps: number;
-        };
-        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=TokenHoldersTool.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"TokenHoldersTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TokenHoldersTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,IAAI,SAAuB;IAC3B,WAAW,SAgBwE;IACnF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA0BzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,sBAAsB;cAK3B,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqD5E;;;;OAIG;YACW,sBAAsB;CA4BrC"}

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

@@ -1,139 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TokenHoldersTool = void 0;
-const BaseTool_1 = require("../../BaseTool");
-const chainResolver_1 = require("../../chainResolver");
-const MoralisService_1 = require("../../../services/MoralisService");
-/**
- * Tool: get-token-holders
- *
- * Queries `GET /erc20/{address}/holders` which returns aggregate holder
- * statistics for an ERC-20 token — NOT a paginated list of addresses.
- *
- * Response covers:
- *   - totalHolders: current unique holder count
- *   - holderChange: change in holder count over 5min / 1h / 6h / 24h / 3d / 7d / 30d
- *   - holdersByAcquisition: how holders acquired (swap / transfer / airdrop)
- *   - holderSupply: supply concentration for top 10/25/50/100/250/500 holders
- *   - holderDistribution: segmentation by size (whales → shrimps)
- */
-class TokenHoldersTool extends BaseTool_1.BaseTool {
-    name = 'get-token-holders';
-    description = 'Get holder statistics and analytics for an ERC-20 token. ' +
-        'Returns: total holder count, holder count changes over time (5min/1h/6h/24h/3d/7d/30d), ' +
-        'how holders acquired the token (swap/transfer/airdrop), ' +
-        'supply concentration (% held by top 10/25/50/100/250/500 holders), ' +
-        'and holder size distribution (whales, sharks, dolphins, fish, octopus, crabs, shrimps). ' +
-        'Use tokenSymbol (e.g. "USDC") 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: ' +
-        '"How many holders does USDC have?" (tokenSymbol=USDC), ' +
-        '"Is USDC gaining or losing holders?" (tokenSymbol=USDC → holderChange), ' +
-        '"How many new holders did ETH get in the last 7 days?" (tokenSymbol=WETH), ' +
-        '"How concentrated is USDC ownership?" (tokenSymbol=USDC → holderSupply), ' +
-        '"What % of supply do the top 10 holders control?" (tokenSymbol=USDC), ' +
-        '"How many whales hold USDT?" (tokenSymbol=USDT → holderDistribution), ' +
-        '"Did most holders buy via swap or transfer?" (tokenSymbol=USDC → holdersByAcquisition). ' +
-        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea. ';
-    category = 'blockchain-data';
-    parameters = [
-        {
-            name: 'tokenSymbol',
-            type: 'string',
-            description: 'Token symbol (e.g. "USDC", "USDT", "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 . ONLY set this when the user EXPLICITLY names a chain; otherwise OMIT it so the connected wallet chain is used.',
-            required: false,
-        },
-    ];
-    service;
-    constructor(config) {
-        super();
-        this.service = new MoralisService_1.MoralisService(config);
-    }
-    async run(args, userContext) {
-        const chain = (0, chainResolver_1.resolveChain)(args.chain, userContext);
-        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. "USDC") 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.getTokenHolders({
-            address: contractAddress,
-            chain,
-        });
-        if (!result.success) {
-            return { error: result.error || 'Failed to fetch token holder stats' };
-        }
-        const data = result.data;
-        return {
-            token: {
-                symbol: resolvedSymbol ?? tokenSymbol ?? null,
-                name: resolvedName ?? null,
-                contractAddress: contractAddress,
-                chain: chain || 'default',
-            },
-            totalHolders: data.totalHolders,
-            holdersByAcquisition: data.holdersByAcquisition,
-            holderChange: data.holderChange,
-            holderSupply: data.holderSupply,
-            holderDistribution: data.holderDistribution,
-        };
-    }
-    /**
-     * 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.TokenHoldersTool = TokenHoldersTool;
-//# sourceMappingURL=TokenHoldersTool.js.map

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

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

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

@@ -1,40 +0,0 @@
-import { BaseTool } from '../../BaseTool';
-import type { SuggestedAction, ToolParameter, ToolResult, UserContext } from '../../../types';
-import type { TokenBalance, TokenMetadata } from '../../../services/MoralisService';
-import { type MoralisServiceConfig } from '../../../services/MoralisService';
-export type TokenInfoToolConfig = MoralisServiceConfig;
-/**
- * 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.
- */
-export declare class TokenInfoTool extends BaseTool {
-    name: string;
-    description: string;
-    category: string;
-    parameters: ToolParameter[];
-    private service;
-    private llm;
-    constructor(config?: TokenInfoToolConfig);
-    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
-        actionButtons?: SuggestedAction[] | undefined;
-        research: string | null;
-        searchResults?: TokenMetadata[] | undefined;
-        _instructions: string;
-        chain: string;
-        userHoldsToken: boolean;
-        walletBalance: TokenBalance | null;
-        token: TokenMetadata | null;
-    } | {
-        error: string;
-    }>;
-    execute(args: Record<string, unknown>, userContext?: UserContext): Promise<ToolResult>;
-    private searchToken;
-    /** Substitute the {token} placeholder in an LLM-supplied localized template. */
-    private fillTemplate;
-    private askGeminiWithSearch;
-    private findTokenInWallet;
-}
-//# sourceMappingURL=TokenInfoTool.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"TokenInfoTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TokenInfoTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAG7F,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAEvD;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,IAAI,SAAoB;IACxB,WAAW,SAIsE;IACjF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA+DzB;IAEF,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,GAAG,CAAiB;gBAEhB,MAAM,CAAC,EAAE,mBAAmB;cAMxB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;IAiBtE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;YAS9E,WAAW;IA0FzB,gFAAgF;IAChF,OAAO,CAAC,YAAY;YAQN,mBAAmB;YAiBnB,iBAAiB;CA0BhC"}