keyring-agent-core 0.1.0

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

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletDefiSummaryTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+/**
+ * Tool: get-wallet-defi-summary
+ *
+ * Queries `GET /wallets/{address}/defi/summary` — a high-level DeFi overview
+ * for a wallet: total USD value, total unclaimed rewards, number of active
+ * protocols and positions, plus a per-protocol breakdown.
+ *
+ * Moralis docs: https://docs.moralis.com/data-api/evm/wallet/wallet-protocols
+ */
+class WalletDefiSummaryTool extends BaseTool_1.BaseTool {
+    name = 'get-wallet-defi-summary';
+    description = "Get a wallet's DeFi protocols summary: which protocols the wallet is using, " +
+        'total USD value locked across all protocols, total unclaimed rewards/fees, ' +
+        'number of active protocols, and total number of positions. ' +
+        'Returns a per-protocol breakdown (protocol name, logo, url, positions count, usd value, unclaimed). ' +
+        'Use for questions like: "Which DeFi protocols am I using?", "What\'s my total DeFi value?", ' +
+        '"How much do I have in DeFi?", "Show my DeFi portfolio overview", "Unclaimed rewards across protocols". ' +
+        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea (EVM mainnets only). ' +
+        'Do NOT use for: detailed per-position data → get-wallet-defi-positions; ' +
+        'positions inside a single protocol → get-wallet-defi-protocol-positions.';
+    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,
+        },
+    ];
+    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 result = await this.service.getWalletDefiSummary({ address, chain });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch wallet DeFi summary' };
+        }
+        const data = result.data;
+        return {
+            walletAddress: address,
+            chain: chain || 'default',
+            activeProtocols: data.active_protocols,
+            totalPositions: data.total_positions,
+            totalUsdValue: data.total_usd_value,
+            totalUnclaimedUsdValue: data.total_unclaimed_usd_value,
+            protocols: (data.protocols || []).map((p) => ({
+                protocolName: p.protocol_name,
+                protocolId: p.protocol_id,
+                protocolUrl: p.protocol_url,
+                protocolLogo: p.protocol_logo,
+                positions: p.positions,
+                totalUsdValue: p.total_usd_value,
+                totalUnclaimedUsdValue: p.total_unclaimed_usd_value,
+                accountHealthFactor: p.account_health_factor ?? null,
+            })),
+        };
+    }
+}
+exports.WalletDefiSummaryTool = WalletDefiSummaryTool;
+//# sourceMappingURL=WalletDefiSummaryTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletDefiSummaryTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet/WalletDefiSummaryTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAE1C,qEAA6F;AAI7F;;;;;;;;GAQG;AACH,MAAa,qBAAsB,SAAQ,mBAAQ;IACjD,IAAI,GAAG,yBAAyB,CAAC;IACjC,WAAW,GACT,8EAA8E;QAC9E,6EAA6E;QAC7E,6DAA6D;QAC7D,sGAAsG;QACtG,8FAA8F;QAC9F,0GAA0G;QAC1G,oGAAoG;QACpG,0EAA0E;QAC1E,0EAA0E,CAAC;IAC7E,QAAQ,GAAG,iBAAiB,CAAC;IAC7B,UAAU,GAAoB;QAC5B;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oFAAoF;YACjG,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,MAAoC;QAC9C,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,yEAAyE,EAAE,CAAC;QAC9F,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAE3E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,qCAAqC,EAAE,CAAC;QAC1E,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAK,CAAC;QAC1B,OAAO;YACL,aAAa,EAAE,OAAO;YACtB,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,cAAc,EAAE,IAAI,CAAC,eAAe;YACpC,aAAa,EAAE,IAAI,CAAC,eAAe;YACnC,sBAAsB,EAAE,IAAI,CAAC,yBAAyB;YACtD,SAAS,EAAE,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5C,YAAY,EAAE,CAAC,CAAC,aAAa;gBAC7B,UAAU,EAAE,CAAC,CAAC,WAAW;gBACzB,WAAW,EAAE,CAAC,CAAC,YAAY;gBAC3B,YAAY,EAAE,CAAC,CAAC,aAAa;gBAC7B,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,aAAa,EAAE,CAAC,CAAC,eAAe;gBAChC,sBAAsB,EAAE,CAAC,CAAC,yBAAyB;gBACnD,mBAAmB,EAAE,CAAC,CAAC,qBAAqB,IAAI,IAAI;aACrD,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF;AAvED,sDAuEC"}

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

@@ -0,0 +1,31 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig, type WalletHistoryItem } from '../../../services/MoralisService';
+export type WalletHistoryToolConfig = MoralisServiceConfig;
+export declare class WalletHistoryTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: WalletHistoryToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        walletAddress?: undefined;
+        chain?: undefined;
+        pagination?: undefined;
+        transactionCount?: undefined;
+        transactions?: undefined;
+    } | {
+        walletAddress: string;
+        chain: string;
+        pagination: {
+            cursor: string | null;
+            hasMore: boolean;
+        };
+        transactionCount: number;
+        transactions: WalletHistoryItem[];
+        error?: undefined;
+    }>;
+}
+//# sourceMappingURL=WalletHistoryTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletHistoryTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet/WalletHistoryTool.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,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErH,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAE3D,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,IAAI,SAAwB;IAC5B,WAAW,SAWyE;IACpF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAuEzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,uBAAuB;cAK5B,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;CAoE7E"}

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

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletHistoryTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+class WalletHistoryTool extends BaseTool_1.BaseTool {
+    name = 'get-wallet-history';
+    description = "Get a wallet's decoded on-chain transaction history. Always fetches the latest 100 transactions. " +
+        'Each transaction includes: category, summary, from_address, to_address, and nested arrays: ' +
+        'native_transfers (each has direction="send"|"receive", from_address, to_address, value_formatted, token_symbol), ' +
+        'erc20_transfers (each has direction, token_symbol, value_formatted), nft_transfers. ' +
+        'To find ETH sends/receives, inspect native_transfers[].direction — ETH moves appear across many categories ' +
+        '(e.g. "token swap", "send", "receive"), not just category="send". ' +
+        'Use this tool for: native coin transfers, swaps, airdrops, deposits, withdrawals, contract interactions, mixed history. ' +
+        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea, Solana. ' +
+        'Returns paginated results — pass cursor to get the next page. ' +
+        'Do NOT use for: specific ERC-20 tokens → get-wallet-token-transfers; ' +
+        'NFT transfers → get-wallet-nft-transfers; balances → get-wallet-token-balances.';
+    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: '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: 'includeInternalTransactions',
+            type: 'boolean',
+            description: 'Include decoded internal transactions on each item.',
+            required: false,
+        },
+        {
+            name: 'nftMetadata',
+            type: 'boolean',
+            description: 'Include NFT normalized metadata in nft_transfers.',
+            required: false,
+        },
+        {
+            name: 'limit',
+            type: 'number',
+            description: 'Number of transactions to return per page. Defaults to 10.',
+            required: false,
+            default: 10,
+        },
+    ];
+    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 fromDate = typeof args.fromDate === 'string' && args.fromDate ? args.fromDate : undefined;
+        const toDate = typeof args.toDate === 'string' && args.toDate ? args.toDate : undefined;
+        const fromBlockRaw = typeof args.fromBlock === 'number'
+            ? args.fromBlock
+            : typeof args.fromBlock === 'string' && args.fromBlock
+                ? Number(args.fromBlock)
+                : undefined;
+        const toBlockRaw = typeof args.toBlock === 'number'
+            ? args.toBlock
+            : typeof args.toBlock === 'string' && args.toBlock
+                ? Number(args.toBlock)
+                : undefined;
+        const fromBlock = Number.isFinite(fromBlockRaw) ? fromBlockRaw : undefined;
+        const toBlock = Number.isFinite(toBlockRaw) ? toBlockRaw : undefined;
+        const cursor = typeof args.cursor === 'string' && args.cursor ? args.cursor : undefined;
+        const rawOrder = typeof args.order === 'string' ? args.order.toUpperCase() : undefined;
+        const order = rawOrder === 'ASC' ? 'ASC' : 'DESC';
+        const includeInternalTransactions = typeof args.includeInternalTransactions === 'boolean' ? args.includeInternalTransactions : undefined;
+        const nftMetadata = typeof args.nftMetadata === 'boolean' ? args.nftMetadata : undefined;
+        const limitRaw = typeof args.limit === 'number' ? args.limit : typeof args.limit === 'string' ? Number(args.limit) : undefined;
+        const limit = Number.isFinite(limitRaw) && limitRaw > 0 ? limitRaw : 10;
+        const result = await this.service.getWalletHistory({
+            address,
+            chain,
+            limit,
+            fromDate,
+            toDate,
+            fromBlock,
+            toBlock,
+            cursor,
+            order,
+            includeInternalTransactions,
+            nftMetadata,
+        });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch wallet history' };
+        }
+        const transactions = result.data?.result || [];
+        return {
+            walletAddress: address,
+            chain: chain || 'default',
+            pagination: {
+                cursor: result.data?.cursor ?? null,
+                hasMore: !!result.data?.cursor,
+            },
+            transactionCount: transactions.length,
+            transactions,
+        };
+    }
+}
+exports.WalletHistoryTool = WalletHistoryTool;
+//# sourceMappingURL=WalletHistoryTool.js.map

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

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

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

@@ -0,0 +1,44 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig } from '../../../services/MoralisService';
+export type WalletNetWorthToolConfig = MoralisServiceConfig;
+/**
+ * Tool: get-wallet-net-worth
+ *
+ * Queries `GET /wallets/{address}/net-worth` to return a wallet's total USD
+ * value across one or more chains. Response includes per-chain breakdown
+ * (native + token USD value) plus a grand total.
+ */
+export declare class WalletNetWorthTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: WalletNetWorthToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        walletAddress?: undefined;
+        chainsQueried?: undefined;
+        filters?: undefined;
+        totalNetWorthUsd?: undefined;
+        chains?: undefined;
+        unsupportedChainIds?: undefined;
+        unavailableChains?: undefined;
+    } | {
+        walletAddress: string;
+        chainsQueried: string[];
+        filters: {
+            excludeSpam: boolean;
+            excludeUnverifiedContracts: boolean | null;
+            maxTokenInactivity: number | null;
+            minPairSideLiquidityUsd: number | null;
+        };
+        totalNetWorthUsd: string;
+        chains: import("../../../services/MoralisService").WalletNetWorthChainBreakdown[];
+        unsupportedChainIds: string[];
+        unavailableChains: import("../../../services/MoralisService").WalletNetWorthUnavailableChain[];
+        error?: undefined;
+    }>;
+}
+//# sourceMappingURL=WalletNetWorthTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletNetWorthTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet/WalletNetWorthTool.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,wBAAwB,GAAG,oBAAoB,CAAC;AAE5D;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,IAAI,SAA0B;IAC9B,WAAW,SAWwC;IACnD,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA2CzB;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;;;;;;;;;;;;;;;;;;;;;;;;CAwD7E"}

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

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletNetWorthTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+/**
+ * Tool: get-wallet-net-worth
+ *
+ * Queries `GET /wallets/{address}/net-worth` to return a wallet's total USD
+ * value across one or more chains. Response includes per-chain breakdown
+ * (native + token USD value) plus a grand total.
+ */
+class WalletNetWorthTool extends BaseTool_1.BaseTool {
+    name = 'get-wallet-net-worth';
+    description = "Get a wallet's total net worth in USD, with a per-chain breakdown. " +
+        'Returns: total_networth_usd (grand total across all queried chains), ' +
+        'chains[] (each with chain, native_balance_formatted, native_balance_usd, token_balance_usd, networth_usd), ' +
+        'and optional unsupported_chain_ids / unavailable_chains lists. ' +
+        'Use this tool for questions like: ' +
+        '"How much is my wallet worth?", "What is my total portfolio value?", ' +
+        '"What is my net worth on Ethereum?", "Portfolio value across all chains?". ' +
+        'Pass chains=["0x1","0x2105"] to query multiple chains at once; defaults to the connected chain. ' +
+        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea, Solana. ' +
+        'Do NOT use for: individual token balances → get-wallet-token-balances; ' +
+        'realized profit/loss → get-wallet-pnl-summary.';
+    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: 'chains',
+            type: 'array',
+            description: 'One or more hex chain IDs to aggregate. Values:  "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, ' +
+                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea ' +
+                'If omitted, defaults to the connected chain.',
+            required: false,
+            items: { type: 'string' },
+        },
+        {
+            name: 'excludeSpam',
+            type: 'boolean',
+            description: 'Exclude tokens flagged as spam. Default true for cleaner totals.',
+            required: false,
+            default: true,
+        },
+        {
+            name: 'excludeUnverifiedContracts',
+            type: 'boolean',
+            description: 'Exclude unverified token contracts. Default false.',
+            required: false,
+            default: false,
+        },
+        {
+            name: 'maxTokenInactivity',
+            type: 'number',
+            description: 'Exclude tokens that have been inactive for more than N days.',
+            required: false,
+        },
+        {
+            name: 'minPairSideLiquidityUsd',
+            type: 'number',
+            description: 'Exclude tokens with pair-side liquidity below this USD threshold.',
+            required: false,
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new MoralisService_1.MoralisService(config);
+    }
+    async run(args, userContext) {
+        const address = args.address || userContext?.walletAddress || undefined;
+        if (!address) {
+            return { error: 'No wallet address available. Please connect a wallet or pass "address".' };
+        }
+        const chains = Array.isArray(args.chains)
+            ? args.chains.filter((c) => typeof c === 'string' && !!c).map((c) => c.trim())
+            : undefined;
+        const fallbackChain = userContext?.chain;
+        const chainsToQuery = chains && chains.length > 0 ? chains : fallbackChain ? [fallbackChain] : undefined;
+        const excludeSpam = typeof args.excludeSpam === 'boolean' ? args.excludeSpam : true;
+        const excludeUnverifiedContracts = typeof args.excludeUnverifiedContracts === 'boolean' ? args.excludeUnverifiedContracts : undefined;
+        const maxTokenInactivity = typeof args.maxTokenInactivity === 'number' && Number.isFinite(args.maxTokenInactivity)
+            ? args.maxTokenInactivity
+            : undefined;
+        const minPairSideLiquidityUsd = typeof args.minPairSideLiquidityUsd === 'number' && Number.isFinite(args.minPairSideLiquidityUsd)
+            ? args.minPairSideLiquidityUsd
+            : undefined;
+        const result = await this.service.getWalletNetWorth({
+            address,
+            chains: chainsToQuery,
+            excludeSpam,
+            excludeUnverifiedContracts,
+            maxTokenInactivity,
+            minPairSideLiquidityUsd,
+        });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch wallet net worth' };
+        }
+        const data = result.data;
+        return {
+            walletAddress: address,
+            chainsQueried: chainsToQuery ?? ['default'],
+            filters: {
+                excludeSpam,
+                excludeUnverifiedContracts: excludeUnverifiedContracts ?? null,
+                maxTokenInactivity: maxTokenInactivity ?? null,
+                minPairSideLiquidityUsd: minPairSideLiquidityUsd ?? null,
+            },
+            totalNetWorthUsd: data.total_networth_usd,
+            chains: data.chains,
+            unsupportedChainIds: data.unsupported_chain_ids ?? [],
+            unavailableChains: data.unavailable_chains ?? [],
+        };
+    }
+}
+exports.WalletNetWorthTool = WalletNetWorthTool;
+//# sourceMappingURL=WalletNetWorthTool.js.map

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

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

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

@@ -0,0 +1,86 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig, type WalletNftTransferItem } from '../../../services/MoralisService';
+export type WalletNftTransfersToolConfig = MoralisServiceConfig;
+interface EnrichedNftTransfer extends WalletNftTransferItem {
+    /** "send" = wallet sent this NFT, "receive" = wallet received it */
+    direction: 'send' | 'receive';
+    /** The other party's address */
+    counterparty: string;
+    counterparty_label?: string;
+    counterparty_entity?: string;
+}
+interface NftCounterpartySummary {
+    address: string;
+    label?: string;
+    entity?: string;
+    token_ids: string[];
+    collections: string[];
+    tx_count: number;
+    first_seen: string;
+    last_seen: string;
+}
+/**
+ * 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.
+ */
+export declare class WalletNftTransfersTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: WalletNftTransfersToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        walletAddress?: undefined;
+        chain?: undefined;
+        filters?: undefined;
+        pagination?: undefined;
+        transferCount?: undefined;
+        transfers?: undefined;
+        counterparties?: undefined;
+    } | {
+        walletAddress: string;
+        chain: string;
+        filters: {
+            contractAddresses: string[] | null;
+            direction: "receive" | "send" | "all";
+            limit: number;
+            order: "ASC" | "DESC";
+            fromDate: string | null;
+            toDate: string | null;
+            fromBlock: number | null;
+            toBlock: number | null;
+            includePrices: boolean | null;
+        };
+        pagination: {
+            cursor: string | null;
+            pageSize: number;
+            page: number | null;
+            hasMore: boolean;
+        };
+        transferCount: number;
+        transfers: EnrichedNftTransfer[];
+        counterparties: {
+            sent: NftCounterpartySummary[];
+            received: NftCounterpartySummary[];
+        };
+        error?: undefined;
+    }>;
+    private buildCounterparties;
+    private parseBlock;
+}
+export {};
+//# sourceMappingURL=WalletNftTransfersTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletNftTransfersTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet/WalletNftTransfersTool.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,qBAAqB,EAC3B,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAEhE,UAAU,mBAAoB,SAAQ,qBAAqB;IACzD,oEAAoE;IACpE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,IAAI,SAA8B;IAClC,WAAW,SAWuD;IAClE,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAoFzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,4BAA4B;cAKjC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAoGpE,sBAAsB,EAAE;sBACpB,sBAAsB,EAAE;;;;IAFpC,OAAO,CAAC,mBAAmB;IA4D3B,OAAO,CAAC,UAAU;CAQnB"}