keyring-agent-core 0.1.0

package/dist/tools/builtin/wallet/WalletNftTransfersTool.js

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletNftTransfersTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+/**
+ * Tool: get-wallet-nft-transfers
+ *
+ * Queries the dedicated Moralis NFT transfer endpoint
+ * `GET /{address}/nft/transfers`, which returns every NFT transfer involving
+ * the wallet — optionally scoped to specific NFT contract addresses.
+ *
+ * Each item is enriched with:
+ *   - `direction`: "send" or "receive" (from from_address vs wallet)
+ *   - `counterparty`: the other address with optional label/entity
+ *   - `last_sale`: purchase price data if `includePrices=true`
+ *
+ * The response includes a `counterparties` aggregation with token IDs,
+ * collections, and timestamps for each unique sender/recipient.
+ */
+class WalletNftTransfersTool extends BaseTool_1.BaseTool {
+    name = 'get-wallet-nft-transfers';
+    description = 'Get all NFT transfers for a wallet from the dedicated Moralis NFT transfers endpoint. ' +
+        'Each transfer includes direction (send/receive), the exact counterparty address, token ID, collection, contract type (ERC721/ERC1155), and optional last sale price. ' +
+        "The response includes a 'counterparties' section aggregating unique senders/recipients with token IDs and collections. " +
+        'Use this tool for questions like: ' +
+        '"Which NFTs did I sell and to whom?" (direction=send), ' +
+        '"Who sent me NFTs from collection 0x…?" (contractAddresses=[0x…], direction=receive), ' +
+        '"Show all transfers for my NFT collection 0x…" (contractAddresses=[0x…]), ' +
+        '"What NFTs did I mint?" (direction=receive), ' +
+        '"Show NFT sales with prices" (direction=send, includePrices=true). ' +
+        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea, Solana. ' +
+        'Returns paginated results — pass cursor to get the next page.';
+    category = 'blockchain-data';
+    parameters = [
+        {
+            name: 'address',
+            type: 'string',
+            description: 'EVM wallet address (0x…). If omitted, uses the connected wallet from user context.',
+            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,
+        },
+        {
+            name: 'contractAddresses',
+            type: 'array',
+            description: 'Filter by one or more NFT contract addresses (0x…). ' +
+                'Use this to scope queries to a specific collection. Omit to return all NFT transfers.',
+            required: false,
+            items: { type: 'string' },
+        },
+        {
+            name: 'direction',
+            type: 'string',
+            description: 'Client-side direction filter: "send" (wallet sent the NFT), "receive" (wallet received it), "all" (default).',
+            required: false,
+            default: 'all',
+        },
+        {
+            name: 'limit',
+            type: 'number',
+            description: 'Page size (1-100, default 25).',
+            required: false,
+            default: 25,
+        },
+        {
+            name: 'fromDate',
+            type: 'string',
+            description: 'Inclusive start date (ISO-8601 or "YYYY-MM-DD").',
+            required: false,
+        },
+        {
+            name: 'toDate',
+            type: 'string',
+            description: 'Inclusive end date (ISO-8601 or "YYYY-MM-DD").',
+            required: false,
+        },
+        {
+            name: 'fromBlock',
+            type: 'number',
+            description: 'Minimum block number.',
+            required: false,
+        },
+        {
+            name: 'toBlock',
+            type: 'number',
+            description: 'Maximum block number.',
+            required: false,
+        },
+        {
+            name: 'cursor',
+            type: 'string',
+            description: 'Pagination cursor from a previous response.',
+            required: false,
+        },
+        {
+            name: 'order',
+            type: 'string',
+            description: '"DESC" newest first (default) or "ASC" oldest first.',
+            required: false,
+            default: 'DESC',
+        },
+        {
+            name: 'includePrices',
+            type: 'boolean',
+            description: 'If true, include last_sale price data (buyer, seller, price, USD value, payment token) on each transfer. ' +
+                'Useful for questions about NFT sale prices.',
+            required: false,
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new MoralisService_1.MoralisService(config);
+    }
+    async run(args, userContext) {
+        const address = args.address || userContext?.walletAddress || undefined;
+        const chain = args.chain || userContext?.chain || undefined;
+        if (!address) {
+            return { error: 'No wallet address available. Please connect a wallet or pass "address".' };
+        }
+        const rawLimit = typeof args.limit === 'number' ? args.limit : Number(args.limit);
+        const limit = Number.isFinite(rawLimit) && rawLimit > 0 ? Math.min(100, Math.floor(rawLimit)) : 25;
+        const fromDate = typeof args.fromDate === 'string' && args.fromDate ? args.fromDate : undefined;
+        const toDate = typeof args.toDate === 'string' && args.toDate ? args.toDate : undefined;
+        const fromBlock = this.parseBlock(args.fromBlock);
+        const toBlock = this.parseBlock(args.toBlock);
+        const cursor = typeof args.cursor === 'string' && args.cursor ? args.cursor : undefined;
+        const rawOrder = typeof args.order === 'string' ? args.order.toUpperCase() : '';
+        const order = rawOrder === 'ASC' ? 'ASC' : 'DESC';
+        const includePrices = typeof args.includePrices === 'boolean' ? args.includePrices : undefined;
+        const rawDir = typeof args.direction === 'string' ? args.direction.trim().toLowerCase() : 'all';
+        const direction = rawDir === 'send' ? 'send' : rawDir === 'receive' ? 'receive' : 'all';
+        const contractAddresses = Array.isArray(args.contractAddresses)
+            ? args.contractAddresses
+                .filter((c) => typeof c === 'string' && !!c)
+                .map((c) => c.trim())
+            : undefined;
+        const result = await this.service.getWalletNftTransfers({
+            address,
+            chain,
+            contractAddresses,
+            limit,
+            fromDate,
+            toDate,
+            fromBlock,
+            toBlock,
+            cursor,
+            order,
+            includePrices,
+        });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch NFT transfers' };
+        }
+        const walletLower = address.toLowerCase();
+        const rawItems = result.data?.result || [];
+        // Enrich with direction and counterparty
+        const allEnriched = rawItems.map((nft) => {
+            const isSend = nft.from_address.toLowerCase() === walletLower;
+            const dir = isSend ? 'send' : 'receive';
+            const counterparty = isSend ? nft.to_address : nft.from_address;
+            const counterpartyLabel = isSend ? (nft.to_address_label ?? undefined) : (nft.from_address_label ?? undefined);
+            const counterpartyEntity = isSend ? (nft.to_address_entity ?? undefined) : (nft.from_address_entity ?? undefined);
+            return {
+                ...nft,
+                direction: dir,
+                counterparty,
+                counterparty_label: counterpartyLabel,
+                counterparty_entity: counterpartyEntity,
+            };
+        });
+        // Apply client-side direction filter
+        const enriched = direction === 'all' ? allEnriched : allEnriched.filter((t) => t.direction === direction);
+        // Build counterparty aggregation
+        const counterparties = this.buildCounterparties(enriched);
+        return {
+            walletAddress: address,
+            chain: chain || 'default',
+            filters: {
+                contractAddresses: contractAddresses || null,
+                direction,
+                limit,
+                order,
+                fromDate: fromDate || null,
+                toDate: toDate || null,
+                fromBlock: fromBlock ?? null,
+                toBlock: toBlock ?? null,
+                includePrices: includePrices ?? null,
+            },
+            pagination: {
+                cursor: result.data?.cursor ?? null,
+                pageSize: result.data?.page_size ?? limit,
+                page: result.data?.page ?? null,
+                hasMore: !!result.data?.cursor,
+            },
+            transferCount: enriched.length,
+            transfers: enriched,
+            counterparties,
+        };
+    }
+    buildCounterparties(transfers) {
+        const sentMap = new Map();
+        const receivedMap = new Map();
+        for (const t of transfers) {
+            const map = t.direction === 'send' ? sentMap : receivedMap;
+            const key = t.counterparty.toLowerCase();
+            const collection = t.token_name ?? t.token_address;
+            const existing = map.get(key);
+            if (existing) {
+                existing.tokenIds.add(t.token_id);
+                existing.collections.add(collection);
+                existing.count += 1;
+                if (!existing.label && t.counterparty_label)
+                    existing.label = t.counterparty_label;
+                if (!existing.entity && t.counterparty_entity)
+                    existing.entity = t.counterparty_entity;
+                if (t.block_timestamp < existing.first)
+                    existing.first = t.block_timestamp;
+                if (t.block_timestamp > existing.last)
+                    existing.last = t.block_timestamp;
+            }
+            else {
+                map.set(key, {
+                    label: t.counterparty_label,
+                    entity: t.counterparty_entity,
+                    tokenIds: new Set([t.token_id]),
+                    collections: new Set([collection]),
+                    count: 1,
+                    first: t.block_timestamp,
+                    last: t.block_timestamp,
+                });
+            }
+        }
+        const toArray = (map) => Array.from(map.entries())
+            .sort((a, b) => b[1].count - a[1].count)
+            .map(([addr, info]) => ({
+            address: addr,
+            label: info.label,
+            entity: info.entity,
+            token_ids: Array.from(info.tokenIds),
+            collections: Array.from(info.collections),
+            tx_count: info.count,
+            first_seen: info.first,
+            last_seen: info.last,
+        }));
+        return { sent: toArray(sentMap), received: toArray(receivedMap) };
+    }
+    parseBlock(raw) {
+        if (typeof raw === 'number')
+            return Number.isFinite(raw) ? raw : undefined;
+        if (typeof raw === 'string' && raw) {
+            const n = Number(raw);
+            return Number.isFinite(n) ? n : undefined;
+        }
+        return undefined;
+    }
+}
+exports.WalletNftTransfersTool = WalletNftTransfersTool;
+//# sourceMappingURL=WalletNftTransfersTool.js.map

package/dist/tools/builtin/wallet/WalletNftTransfersTool.js.map

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

package/dist/tools/builtin/wallet/WalletPnlSummaryTool.d.ts

@@ -0,0 +1,43 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig, type WalletPnlDaysWindow } from '../../../services/MoralisService';
+export type WalletPnlSummaryToolConfig = MoralisServiceConfig;
+/**
+ * Tool: get-wallet-pnl-summary
+ *
+ * Queries `GET /wallets/{address}/profitability/summary` for an aggregate
+ * profit-and-loss view across all tokens the wallet has traded.
+ *
+ * Mainnet only — supported chains: Ethereum (0x1), Base (0x2105), Polygon (0x89).
+ */
+export declare class WalletPnlSummaryTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: WalletPnlSummaryToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        walletAddress?: undefined;
+        chain?: undefined;
+        days?: undefined;
+        summary?: undefined;
+    } | {
+        walletAddress: string;
+        chain: string;
+        days: WalletPnlDaysWindow;
+        summary: {
+            totalCountOfTrades: number;
+            totalTradeVolume: string;
+            totalRealizedProfitUsd: string;
+            totalRealizedProfitPercentage: number;
+            totalBuys: number;
+            totalSells: number;
+            totalBoughtVolumeUsd: string;
+            totalSoldVolumeUsd: string;
+        };
+        error?: undefined;
+    }>;
+}
+//# sourceMappingURL=WalletPnlSummaryTool.d.ts.map

package/dist/tools/builtin/wallet/WalletPnlSummaryTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletPnlSummaryTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet/WalletPnlSummaryTool.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,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvH,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAI9D;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,IAAI,SAA4B;IAChC,WAAW,SAWgC;IAC3C,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAwBzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,0BAA0B;cAK/B,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;CAmC7E"}

package/dist/tools/builtin/wallet/WalletPnlSummaryTool.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletPnlSummaryTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+const VALID_DAYS = ['all', '7', '30', '60', '90'];
+/**
+ * Tool: get-wallet-pnl-summary
+ *
+ * Queries `GET /wallets/{address}/profitability/summary` for an aggregate
+ * profit-and-loss view across all tokens the wallet has traded.
+ *
+ * Mainnet only — supported chains: Ethereum (0x1), Base (0x2105), Polygon (0x89).
+ */
+class WalletPnlSummaryTool extends BaseTool_1.BaseTool {
+    name = 'get-wallet-pnl-summary';
+    description = "Get a wallet's aggregate realized profit-and-loss summary across all tokens it has traded. " +
+        'Returns: total_count_of_trades, total_trade_volume (USD), total_realized_profit_usd, ' +
+        'total_realized_profit_percentage, total_buys, total_sells, total_sold_volume_usd, total_bought_volume_usd. ' +
+        'Use this tool for questions like: ' +
+        '"How much profit have I made trading?", "What is my realized PnL?", ' +
+        '"How many trades have I done this month?" (days=30), "Am I up or down overall?". ' +
+        'IMPORTANT — this endpoint only supports mainnet: Ethereum ("0x1"), Base ("0x2105"), Polygon ("0x89"). ' +
+        'Use days="all" (default), "7", "30", "60", or "90" to scope the time window. ' +
+        'Do NOT use for: per-token breakdown → get-wallet-pnl; ' +
+        'current portfolio value → get-wallet-token-balance; ' +
+        'transfer history → get-wallet-history.';
+    category = 'blockchain-data';
+    parameters = [
+        {
+            name: 'address',
+            type: 'string',
+            description: 'EVM wallet address (0x…). If omitted, uses the connected wallet from user context.',
+            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,
+        },
+        {
+            name: 'days',
+            type: 'string',
+            description: 'Time window for the summary. Values: "all" (default, lifetime), "7", "30", "60", "90". ' +
+                'Pass "30" when the user asks about the last month, "7" for the last week, etc.',
+            required: false,
+            default: 'all',
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new MoralisService_1.MoralisService(config);
+    }
+    async run(args, userContext) {
+        const address = args.address || userContext?.walletAddress || undefined;
+        const chain = args.chain || userContext?.chain || undefined;
+        if (!address) {
+            return { error: 'No wallet address available. Please connect a wallet or pass "address".' };
+        }
+        const rawDays = typeof args.days === 'string' ? args.days.trim().toLowerCase() : '';
+        const days = VALID_DAYS.includes(rawDays) ? rawDays : undefined;
+        const result = await this.service.getWalletPnlSummary({ address, chain, days });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch wallet PnL summary' };
+        }
+        const data = result.data;
+        return {
+            walletAddress: address,
+            chain: chain || 'default',
+            days: days ?? 'all',
+            summary: {
+                totalCountOfTrades: data.total_count_of_trades,
+                totalTradeVolume: data.total_trade_volume,
+                totalRealizedProfitUsd: data.total_realized_profit_usd,
+                totalRealizedProfitPercentage: data.total_realized_profit_percentage,
+                totalBuys: data.total_buys,
+                totalSells: data.total_sells,
+                totalBoughtVolumeUsd: data.total_bought_volume_usd,
+                totalSoldVolumeUsd: data.total_sold_volume_usd,
+            },
+        };
+    }
+}
+exports.WalletPnlSummaryTool = WalletPnlSummaryTool;
+//# sourceMappingURL=WalletPnlSummaryTool.js.map

package/dist/tools/builtin/wallet/WalletPnlSummaryTool.js.map

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

package/dist/tools/builtin/wallet/WalletPnlTool.d.ts

@@ -0,0 +1,43 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig, type WalletPnlDaysWindow } from '../../../services/MoralisService';
+export type WalletPnlToolConfig = MoralisServiceConfig;
+export declare class WalletPnlTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: WalletPnlToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        walletAddress?: undefined;
+        chain?: undefined;
+        days?: undefined;
+        filters?: undefined;
+        tokenCount?: undefined;
+        tokens?: undefined;
+    } | {
+        walletAddress: string;
+        chain: string;
+        days: WalletPnlDaysWindow;
+        filters: {
+            tokenAddresses: string[] | null;
+            resolvedSymbols: {
+                symbol: string;
+                address: string;
+            }[] | null;
+            unresolvedSymbols: string[] | null;
+        };
+        tokenCount: number;
+        tokens: import("../../../services/MoralisService").WalletPnlTokenItem[];
+        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=WalletPnlTool.d.ts.map

package/dist/tools/builtin/wallet/WalletPnlTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletPnlTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet/WalletPnlTool.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,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvH,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAevD,qBAAa,aAAc,SAAQ,QAAQ;IACzC,IAAI,SAAoB;IACxB,WAAW,SAgBwC;IACnD,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAyCzB;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;;;;;;;;;;;;;;;wBAuB/B,MAAM;yBAAW,MAAM;;;;;;;;IA+CpE;;;;OAIG;YACW,sBAAsB;CA4BrC"}

package/dist/tools/builtin/wallet/WalletPnlTool.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletPnlTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+const VALID_DAYS = ['all', '7', '30', '60', '90'];
+/**
+ * Tool: get-wallet-pnl
+ *
+ * Queries `GET /wallets/{address}/profitability` for a per-token realized-PnL
+ * breakdown. Each entry covers average buy/sell price, invested amount,
+ * quantities traded, realized profit USD + percentage, and counts.
+ *
+ * Mainnet only — supported chains: Ethereum (0x1), Base (0x2105), Polygon (0x89).
+ */
+const MAX_TOKEN_FILTERS = 25;
+class WalletPnlTool extends BaseTool_1.BaseTool {
+    name = 'get-wallet-pnl';
+    description = "Get a wallet's realized profit-and-loss broken down per ERC-20 token. " +
+        'Each entry includes: token_address, name, symbol, decimals, logo, avg_buy_price_usd, avg_sell_price_usd, ' +
+        'total_usd_invested, total_tokens_bought, total_tokens_sold, total_sold_usd, avg_cost_of_quantity_sold, ' +
+        'count_of_trades, realized_profit_usd, realized_profit_percentage, total_buys, total_sells, possible_spam. ' +
+        'Use this tool for questions like: ' +
+        '"Which tokens made me the most money?", "What are my best/worst trades?", ' +
+        '"How much profit did I make on USDC?" (tokenSymbols=["USDC"]), ' +
+        '"PnL for PEPE and DEGEN this month" (tokenSymbols=["PEPE","DEGEN"], days=30), ' +
+        '"PnL breakdown for each token I traded this month" (days=30). ' +
+        'IMPORTANT — this endpoint ONLY supports mainnet: Ethereum ("0x1"), Polygon ("0x89"), Base ("0x2105"). ' +
+        'Use days="all" (default), "7", "30", "60", or "90" for the time window. ' +
+        'Pass tokenSymbols (by ticker, auto-resolved) and/or tokenAddresses (raw 0x…) to restrict to specific tokens ' +
+        `— combined total capped at ${MAX_TOKEN_FILTERS}. ` +
+        'Do NOT use for: aggregate summary → get-wallet-pnl-summary; ' +
+        'current balances → get-wallet-token-balances; ' +
+        'transfer history → get-wallet-token-transfers.';
+    category = 'blockchain-data';
+    parameters = [
+        {
+            name: 'address',
+            type: 'string',
+            description: 'EVM wallet address (0x…). If omitted, uses the connected wallet from user context.',
+            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,
+        },
+        {
+            name: 'days',
+            type: 'string',
+            description: 'Time window for the breakdown. Values: "all" (default, lifetime), "7", "30", "60", "90".',
+            required: false,
+            default: 'all',
+        },
+        {
+            name: 'tokenSymbols',
+            type: 'array',
+            description: 'Optional list of token symbols (e.g. ["USDC", "PEPE"]). Auto-resolved to contract addresses via ' +
+                "the connected wallet's balances first, then Pantograph search. Symbols that can't be resolved are skipped. " +
+                `Merged with tokenAddresses; combined total capped at ${MAX_TOKEN_FILTERS}.`,
+            required: false,
+            items: { type: 'string' },
+        },
+        {
+            name: 'tokenAddresses',
+            type: 'array',
+            description: `Optional list of raw ERC-20 contract addresses (0x…). Use when the exact addresses are already known. ` +
+                `Merged with tokenSymbols; combined total capped at ${MAX_TOKEN_FILTERS}.`,
+            required: false,
+            items: { type: 'string' },
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new MoralisService_1.MoralisService(config);
+    }
+    async run(args, userContext) {
+        const address = args.address || userContext?.walletAddress || undefined;
+        const chain = args.chain || userContext?.chain || undefined;
+        if (!address) {
+            return { error: 'No wallet address available. Please connect a wallet or pass "address".' };
+        }
+        const rawDays = typeof args.days === 'string' ? args.days.trim().toLowerCase() : '';
+        const days = VALID_DAYS.includes(rawDays) ? rawDays : undefined;
+        const rawTokenSymbols = Array.isArray(args.tokenSymbols)
+            ? args.tokenSymbols
+                .filter((s) => typeof s === 'string' && !!s.trim())
+                .map((s) => s.trim())
+            : [];
+        const rawTokenAddresses = Array.isArray(args.tokenAddresses)
+            ? args.tokenAddresses
+                .filter((a) => typeof a === 'string' && !!a.trim())
+                .map((a) => a.trim())
+            : [];
+        const resolvedFromSymbols = [];
+        const unresolvedSymbols = [];
+        if (rawTokenSymbols.length > 0) {
+            const resolutions = await Promise.all(rawTokenSymbols.map((sym) => this.resolveContractAddress(sym, chain, address)));
+            resolutions.forEach((resolved, i) => {
+                if (resolved)
+                    resolvedFromSymbols.push({ symbol: rawTokenSymbols[i], address: resolved.address });
+                else
+                    unresolvedSymbols.push(rawTokenSymbols[i]);
+            });
+        }
+        const mergedAddresses = dedupe([...resolvedFromSymbols.map((r) => r.address), ...rawTokenAddresses]).slice(0, MAX_TOKEN_FILTERS);
+        const tokenAddresses = mergedAddresses.length > 0 ? mergedAddresses : undefined;
+        const result = await this.service.getWalletPnl({
+            address,
+            chain,
+            days,
+            tokenAddresses,
+        });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch wallet PnL' };
+        }
+        const tokens = result.data?.result ?? [];
+        return {
+            walletAddress: address,
+            chain: chain || 'default',
+            days: days ?? 'all',
+            filters: {
+                tokenAddresses: tokenAddresses ?? null,
+                resolvedSymbols: resolvedFromSymbols.length > 0 ? resolvedFromSymbols : null,
+                unresolvedSymbols: unresolvedSymbols.length > 0 ? unresolvedSymbols : null,
+            },
+            tokenCount: tokens.length,
+            tokens,
+        };
+    }
+    /**
+     * 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.WalletPnlTool = WalletPnlTool;
+function dedupe(addresses) {
+    const seen = new Set();
+    const out = [];
+    for (const addr of addresses) {
+        const key = addr.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(addr);
+    }
+    return out;
+}
+//# sourceMappingURL=WalletPnlTool.js.map

package/dist/tools/builtin/wallet/WalletPnlTool.js.map

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