keyring-agent-core 0.1.0

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

@@ -0,0 +1,35 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig } from '../../../services/MoralisService';
+export type WalletTokenBalancesToolConfig = MoralisServiceConfig;
+/**
+ * Tool: get-wallet-token-balances
+ *
+ * Fetches ERC-20 token balances for a wallet address via the Moralis EVM API.
+ * Automatically enriches prices, filters spam/dust, and uses the connected
+ * wallet + chain from UserContext when not explicitly provided.
+ */
+export declare class WalletTokenBalancesTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: WalletTokenBalancesToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        walletAddress?: undefined;
+        chain?: undefined;
+        tokenCount?: undefined;
+        tokens?: undefined;
+        totalUsdValue?: undefined;
+    } | {
+        walletAddress: string;
+        chain: string;
+        tokenCount: number;
+        tokens: import("../../../services/MoralisService").TokenBalance[];
+        totalUsdValue: number;
+        error?: undefined;
+    }>;
+}
+//# sourceMappingURL=WalletTokenBalancesTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletTokenBalancesTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet/WalletTokenBalancesTool.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,6BAA6B,GAAG,oBAAoB,CAAC;AAEjE;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;IACnD,IAAI,SAA+B;IACnC,WAAW,SAIwE;IACnF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAezB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,6BAA6B;cAKlC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;CA8B7E"}

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

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletTokenBalancesTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+/**
+ * Tool: get-wallet-token-balances
+ *
+ * Fetches ERC-20 token balances for a wallet address via the Moralis EVM API.
+ * Automatically enriches prices, filters spam/dust, and uses the connected
+ * wallet + chain from UserContext when not explicitly provided.
+ */
+class WalletTokenBalancesTool extends BaseTool_1.BaseTool {
+    name = 'get-wallet-token-balances';
+    description = 'Get all ERC-20 token balances for a wallet address, including USD prices and 24h changes. ' +
+        'Use this when the user asks about: "my tokens", "my balances", "what do I hold", "portfolio", ' +
+        '"how much ETH/USDC/… do I have", or any wallet balance question. ' +
+        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea. ';
+    category = 'blockchain-data';
+    parameters = [
+        {
+            name: 'address',
+            type: 'string',
+            description: 'Wallet address to query (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,
+        },
+    ];
+    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.' };
+        }
+        const result = await this.service.getWalletTokenBalances({
+            address,
+            chain,
+            excludeSpam: false,
+            excludeUnverifiedContracts: false,
+        });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch token balances' };
+        }
+        const tokens = result.data?.result || [];
+        // Build structured response data for the Synthesizer
+        return {
+            walletAddress: address,
+            chain: chain || 'default',
+            tokenCount: tokens.length,
+            tokens: tokens,
+            totalUsdValue: tokens.reduce((sum, t) => sum + (t.usd_value || 0), 0),
+        };
+    }
+}
+exports.WalletTokenBalancesTool = WalletTokenBalancesTool;
+//# sourceMappingURL=WalletTokenBalancesTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletTokenBalancesTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet/WalletTokenBalancesTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAE1C,qEAA6F;AAI7F;;;;;;GAMG;AACH,MAAa,uBAAwB,SAAQ,mBAAQ;IACnD,IAAI,GAAG,2BAA2B,CAAC;IACnC,WAAW,GACT,4FAA4F;QAC5F,gGAAgG;QAChG,mEAAmE;QACnE,gFAAgF,CAAC;IACnF,QAAQ,GAAG,iBAAiB,CAAC;IAC7B,UAAU,GAAoB;QAC5B;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yFAAyF;YACtG,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,MAAsC;QAChD,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,OAAO,GAAI,IAAI,CAAC,OAAkB,IAAI,WAAW,EAAE,aAAa,IAAI,SAAS,CAAC;QACpF,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,WAAW,EAAE,KAAK,IAAI,SAAS,CAAC;QAExE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,KAAK,EAAE,uDAAuD,EAAE,CAAC;QAC5E,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC;YACvD,OAAO;YACP,KAAK;YACL,WAAW,EAAE,KAAK;YAClB,0BAA0B,EAAE,KAAK;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,gCAAgC,EAAE,CAAC;QACrE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;QAEzC,qDAAqD;QACrD,OAAO;YACL,aAAa,EAAE,OAAO;YACtB,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,UAAU,EAAE,MAAM,CAAC,MAAM;YACzB,MAAM,EAAE,MAAM;YACd,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;SACtE,CAAC;IACJ,CAAC;CACF;AA9DD,0DA8DC"}

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

@@ -0,0 +1,109 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig, type WalletTokenTransferItem } from '../../../services/MoralisService';
+export type WalletTokenTransfersToolConfig = MoralisServiceConfig;
+interface EnrichedTransfer extends WalletTokenTransferItem {
+    /** "send" = wallet sent, "receive" = wallet received */
+    direction: 'send' | 'receive';
+    /** Human-readable amount */
+    amount_formatted: string;
+    /** The other party: to_address (for send) or from_address (for receive) */
+    counterparty: string;
+    counterparty_label?: string;
+    counterparty_entity?: string;
+}
+interface CounterpartySummary {
+    address: string;
+    label?: string;
+    entity?: string;
+    total_amount: string;
+    tx_count: number;
+    first_seen: string;
+    last_seen: string;
+}
+/**
+ * Tool: get-wallet-token-transfers
+ *
+ * Queries the dedicated Moralis ERC-20 transfer endpoint
+ * `GET /{address}/erc20/transfers`, which returns every ERC-20 transfer
+ * involving the wallet — far more reliable for token-specific questions than
+ * parsing the general history endpoint.
+ *
+ * Each item is enriched with:
+ *   - `direction`: "send" or "receive" (derived from from_address vs wallet)
+ *   - `amount_formatted`: human-readable amount (decimals applied)
+ *   - `counterparty`: the other address (recipient for sends, sender for receives)
+ *   - `counterparty_label` / `counterparty_entity`: Moralis-resolved name if known
+ *
+ * The response also includes a `counterparties` aggregation — unique addresses
+ * grouped by direction with total transferred amount and tx count.
+ */
+export declare class WalletTokenTransfersTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: WalletTokenTransfersToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        walletAddress?: undefined;
+        chain?: undefined;
+        resolvedToken?: undefined;
+        filters?: undefined;
+        pagination?: undefined;
+        transferCount?: undefined;
+        transfers?: undefined;
+        counterparties?: undefined;
+    } | {
+        walletAddress: string;
+        chain: string;
+        resolvedToken: {
+            symbol: string;
+            name: string | undefined;
+            contractAddress: string | undefined;
+        } | null;
+        filters: {
+            tokenSymbol: string | null;
+            contractAddresses: string[] | null;
+            direction: "receive" | "send" | "all";
+            limit: number;
+            order: "ASC" | "DESC";
+            fromDate: string | null;
+            toDate: string | null;
+            fromBlock: number | null;
+            toBlock: number | null;
+        };
+        pagination: {
+            cursor: string | null;
+            pageSize: number;
+            page: number | null;
+            hasMore: boolean;
+        };
+        transferCount: number;
+        transfers: EnrichedTransfer[];
+        counterparties: {
+            sent: CounterpartySummary[];
+            received: CounterpartySummary[];
+        };
+        error?: undefined;
+    }>;
+    /**
+     * Resolve a token's contract address from a symbol string.
+     *
+     * Strategy (in order):
+     *   1. Wallet token balances — most reliable, wallet has actually held this token.
+     *   2. Token search (Pantograph) — fallback for tokens no longer in the wallet.
+     *
+     * Returns the first confident match, or undefined if nothing found.
+     */
+    private resolveContractAddressBySymbol;
+    /**
+     * Aggregate unique counterparties, sorted by tx count descending.
+     * Splits into sent[] and received[].
+     */
+    private buildCounterparties;
+    private parseBlock;
+}
+export {};
+//# sourceMappingURL=WalletTokenTransfersTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletTokenTransfersTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet/WalletTokenTransfersTool.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,uBAAuB,EAC7B,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,8BAA8B,GAAG,oBAAoB,CAAC;AAsBlE,UAAU,gBAAiB,SAAQ,uBAAuB;IACxD,wDAAwD;IACxD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,4BAA4B;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,wBAAyB,SAAQ,QAAQ;IACpD,IAAI,SAAgC;IACpC,WAAW,SAkB0D;IACrE,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA0FzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,8BAA8B;cAKnC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwKpE,mBAAmB,EAAE;sBACjB,mBAAmB,EAAE;;;;IA5CjC;;;;;;;;OAQG;YACW,8BAA8B;IA6B5C;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAwD3B,OAAO,CAAC,UAAU;CAQnB"}

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

@@ -0,0 +1,353 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletTokenTransfersTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+/**
+ * Derive human-readable amount from raw value + decimals string.
+ * Falls back to value_decimal if provided by Moralis.
+ */
+function formatTokenAmount(item) {
+    if (item.value_decimal)
+        return item.value_decimal;
+    const dec = parseInt(item.token_decimals ?? '18', 10);
+    if (isNaN(dec) || dec === 0)
+        return item.value;
+    try {
+        const raw = BigInt(item.value);
+        const divisor = BigInt(10) ** BigInt(dec);
+        const whole = raw / divisor;
+        const remainder = raw % divisor;
+        const fracStr = remainder.toString().padStart(dec, '0').replace(/0+$/, '');
+        return fracStr ? `${whole}.${fracStr}` : `${whole}`;
+    }
+    catch {
+        return item.value;
+    }
+}
+/**
+ * Tool: get-wallet-token-transfers
+ *
+ * Queries the dedicated Moralis ERC-20 transfer endpoint
+ * `GET /{address}/erc20/transfers`, which returns every ERC-20 transfer
+ * involving the wallet — far more reliable for token-specific questions than
+ * parsing the general history endpoint.
+ *
+ * Each item is enriched with:
+ *   - `direction`: "send" or "receive" (derived from from_address vs wallet)
+ *   - `amount_formatted`: human-readable amount (decimals applied)
+ *   - `counterparty`: the other address (recipient for sends, sender for receives)
+ *   - `counterparty_label` / `counterparty_entity`: Moralis-resolved name if known
+ *
+ * The response also includes a `counterparties` aggregation — unique addresses
+ * grouped by direction with total transferred amount and tx count.
+ */
+class WalletTokenTransfersTool extends BaseTool_1.BaseTool {
+    name = 'get-wallet-token-transfers';
+    description = 'Get all ERC-20 token transfers for a wallet from the dedicated Moralis transfers endpoint. ' +
+        'Each transfer includes direction (send/receive), human-readable amount, and the exact counterparty address with its label/entity. ' +
+        'The response includes a "counterparties" section that aggregates unique sender/recipient addresses with totals. ' +
+        'Use tokenSymbol (e.g. "USDC") to filter by token name — the tool automatically resolves the contract address ' +
+        "by checking the wallet's token balances first, then falling back to token search. " +
+        'Use contractAddresses when you already have the exact contract address. ' +
+        'Use this tool for questions like: ' +
+        '"When did I last send USDC and to whom?" (tokenSymbol=USDC, direction=send, limit=1), ' +
+        '"Who have I sent token 0x… to?" (contractAddresses=[0x…], direction=send), ' +
+        '"Who sent me USDT?" (tokenSymbol=USDT, direction=receive), ' +
+        '"Show all USDC transfers" (tokenSymbol=USDC), ' +
+        '"What tokens did I receive this month?" (fromDate=..., direction=receive). ' +
+        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea, Solana. ' +
+        'Returns paginated results — pass cursor to get the next page. ' +
+        'IMPORTANT — this tool covers ERC-20 tokens ONLY. ' +
+        'Do NOT use it for native coins (ETH, BNB, MATIC, AVAX, etc.) — ' +
+        'native coin transfers are not ERC-20 and will not appear here. ' +
+        'For native coin transfer history use get-wallet-history instead.';
+    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: 'tokenSymbol',
+            type: 'string',
+            description: 'Filter by token symbol (e.g. "USDC", "USDT", "WETH"). ' +
+                'The tool resolves the contract address automatically: first checks wallet balances, ' +
+                'then searches by symbol on the chain. Use this when the user mentions a token by name/symbol. ' +
+                'Takes precedence over contractAddresses when both are given.',
+            required: false,
+        },
+        {
+            name: 'contractAddresses',
+            type: 'array',
+            description: 'Filter by one or more ERC-20 token contract addresses (0x…). ' +
+                'Use when the exact contract address is already known. Ignored if tokenSymbol is provided.',
+            required: false,
+            items: { type: 'string' },
+        },
+        {
+            name: 'direction',
+            type: 'string',
+            description: 'Client-side direction filter: "send" (wallet is sender), "receive" (wallet is recipient), "all" (default).',
+            required: false,
+            default: 'all',
+        },
+        {
+            name: 'limit',
+            type: 'number',
+            description: 'Page size (1-100, default 25). ' +
+                'Use limit=1 ONLY when the user asks for the single most recent transfer (e.g. "Lần cuối cùng tôi gửi USDC là khi nào?"). ' +
+                'For "show recent history" or "list my transfers" questions use the default (25). ' +
+                'Use 100 for bulk counterparty analysis.',
+            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',
+        },
+    ];
+    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 rawDir = typeof args.direction === 'string' ? args.direction.trim().toLowerCase() : 'all';
+        const direction = rawDir === 'send' ? 'send' : rawDir === 'receive' ? 'receive' : 'all';
+        // tokenSymbol takes precedence: resolve contract address automatically
+        const tokenSymbol = typeof args.tokenSymbol === 'string' && args.tokenSymbol ? args.tokenSymbol.trim() : undefined;
+        let contractAddresses = Array.isArray(args.contractAddresses)
+            ? args.contractAddresses
+                .filter((c) => typeof c === 'string' && !!c)
+                .map((c) => c.trim())
+            : undefined;
+        let resolvedSymbol;
+        let resolvedTokenName;
+        if (tokenSymbol) {
+            const resolved = await this.resolveContractAddressBySymbol(tokenSymbol, address, chain);
+            if (resolved) {
+                contractAddresses = [resolved.address];
+                resolvedSymbol = resolved.symbol;
+                resolvedTokenName = resolved.name;
+            }
+            // If resolution fails we still proceed — Moralis will return all transfers
+            // and client-side filtering by symbol below acts as a safety net
+        }
+        const result = await this.service.getWalletTokenTransfers({
+            address,
+            chain,
+            contractAddresses,
+            limit,
+            fromDate,
+            toDate,
+            fromBlock,
+            toBlock,
+            cursor,
+            order,
+        });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch token transfers' };
+        }
+        const walletLower = address.toLowerCase();
+        const rawItems = result.data?.result || [];
+        // Enrich each transfer with direction, formatted amount, and counterparty
+        const allEnriched = rawItems.map((tr) => {
+            const isSend = tr.from_address.toLowerCase() === walletLower;
+            const dir = isSend ? 'send' : 'receive';
+            const counterparty = isSend ? tr.to_address : tr.from_address;
+            const counterpartyLabel = isSend ? (tr.to_address_label ?? undefined) : (tr.from_address_label ?? undefined);
+            const counterpartyEntity = isSend ? (tr.to_address_entity ?? undefined) : (tr.from_address_entity ?? undefined);
+            return {
+                ...tr,
+                direction: dir,
+                amount_formatted: formatTokenAmount(tr),
+                counterparty,
+                counterparty_label: counterpartyLabel,
+                counterparty_entity: counterpartyEntity,
+            };
+        });
+        // Apply client-side direction filter
+        let enriched = direction === 'all' ? allEnriched : allEnriched.filter((t) => t.direction === direction);
+        // Safety-net symbol filter: when tokenSymbol was provided but contract resolution failed,
+        // filter results by symbol client-side so we never return unrelated tokens.
+        if (tokenSymbol && !contractAddresses) {
+            const symLower = tokenSymbol.toLowerCase();
+            enriched = enriched.filter((t) => (t.token_symbol ?? '').toLowerCase() === symLower);
+        }
+        // Build counterparty aggregation
+        const counterparties = this.buildCounterparties(enriched);
+        return {
+            walletAddress: address,
+            chain: chain || 'default',
+            resolvedToken: resolvedSymbol
+                ? { symbol: resolvedSymbol, name: resolvedTokenName, contractAddress: contractAddresses?.[0] }
+                : null,
+            filters: {
+                tokenSymbol: tokenSymbol || null,
+                contractAddresses: contractAddresses || null,
+                direction,
+                limit,
+                order,
+                fromDate: fromDate || null,
+                toDate: toDate || null,
+                fromBlock: fromBlock ?? null,
+                toBlock: toBlock ?? 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,
+        };
+    }
+    /**
+     * Resolve a token's contract address from a symbol string.
+     *
+     * Strategy (in order):
+     *   1. Wallet token balances — most reliable, wallet has actually held this token.
+     *   2. Token search (Pantograph) — fallback for tokens no longer in the wallet.
+     *
+     * Returns the first confident match, or undefined if nothing found.
+     */
+    async resolveContractAddressBySymbol(symbol, walletAddress, chain) {
+        const symLower = symbol.toLowerCase();
+        // 1. Check wallet's current token balances
+        const balancesRes = await this.service.getWalletTokenBalances({ address: walletAddress, chain });
+        if (balancesRes.success && balancesRes.data?.result?.length) {
+            const match = balancesRes.data.result.find((t) => (t.symbol ?? '').toLowerCase() === symLower);
+            if (match) {
+                return { address: match.token_address, symbol: match.symbol, name: match.name };
+            }
+        }
+        // 2. Search for the token by symbol on the chain
+        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;
+    }
+    /**
+     * Aggregate unique counterparties, sorted by tx count descending.
+     * Splits into sent[] and received[].
+     */
+    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 amount = parseFloat(t.amount_formatted) || 0;
+            const existing = map.get(key);
+            if (existing) {
+                existing.total += amount;
+                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,
+                    total: amount,
+                    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,
+            total_amount: info.total.toFixed(6).replace(/\.?0+$/, ''),
+            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.WalletTokenTransfersTool = WalletTokenTransfersTool;
+//# sourceMappingURL=WalletTokenTransfersTool.js.map

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

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

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

@@ -0,0 +1,25 @@
+export { WalletTokenBalancesTool } from './WalletTokenBalancesTool';
+export type { WalletTokenBalancesToolConfig } from './WalletTokenBalancesTool';
+export { WalletHistoryTool } from './WalletHistoryTool';
+export type { WalletHistoryToolConfig } from './WalletHistoryTool';
+export { WalletTokenTransfersTool } from './WalletTokenTransfersTool';
+export type { WalletTokenTransfersToolConfig } from './WalletTokenTransfersTool';
+export { WalletNftTransfersTool } from './WalletNftTransfersTool';
+export type { WalletNftTransfersToolConfig } from './WalletNftTransfersTool';
+export { WalletNetWorthTool } from './WalletNetWorthTool';
+export type { WalletNetWorthToolConfig } from './WalletNetWorthTool';
+export { WalletPnlSummaryTool } from './WalletPnlSummaryTool';
+export type { WalletPnlSummaryToolConfig } from './WalletPnlSummaryTool';
+export { WalletPnlTool } from './WalletPnlTool';
+export type { WalletPnlToolConfig } from './WalletPnlTool';
+export { WalletApprovalsTool } from './WalletApprovalsTool';
+export type { WalletApprovalsToolConfig } from './WalletApprovalsTool';
+export { WalletDefiSummaryTool } from './WalletDefiSummaryTool';
+export type { WalletDefiSummaryToolConfig } from './WalletDefiSummaryTool';
+export { WalletDefiPositionsTool } from './WalletDefiPositionsTool';
+export type { WalletDefiPositionsToolConfig } from './WalletDefiPositionsTool';
+export { WalletDefiProtocolPositionsTool } from './WalletDefiProtocolPositionsTool';
+export type { WalletDefiProtocolPositionsToolConfig } from './WalletDefiProtocolPositionsTool';
+export { TransactionByHashTool } from './TransactionByHashTool';
+export type { TransactionByHashToolConfig } from './TransactionByHashTool';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,YAAY,EAAE,qCAAqC,EAAE,MAAM,mCAAmC,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC"}