keyring-agent-core 0.1.0

package/dist/tools/builtin/nft/WalletNFTsTool.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletNFTsTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+/**
+ * Tool: get-wallet-nfts
+ *
+ * Fetches NFTs owned by a wallet address via the Moralis EVM API
+ * `GET /{address}/nft`. Returns normalized metadata, media variants,
+ * collection info, and cursor-based pagination.
+ *
+ * Default page size is 10. Pass `cursor` from a previous response to
+ * fetch the next page.
+ */
+class WalletNFTsTool extends BaseTool_1.BaseTool {
+    name = 'get-wallet-nfts';
+    description = 'Get NFTs owned by a wallet address, including metadata, images, and collection info. ' +
+        'Use this when the user asks about: "my NFTs", "show my NFTs", "what NFTs do I own", ' +
+        '"NFT collection", or any wallet NFT query. ' +
+        'Supports filtering by one or more NFT contract addresses (collections) and spam exclusion. ' +
+        'Returns paginated results — default page size is 10, pass cursor to get the next page. ' +
+        '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,
+        },
+        {
+            name: 'contractAddresses',
+            type: 'array',
+            description: 'Filter by one or more NFT contract addresses (0x…). ' +
+                'Use this to scope results to specific collections. Omit to return NFTs across all collections.',
+            required: false,
+            items: { type: 'string' },
+        },
+        {
+            name: 'excludeSpam',
+            type: 'boolean',
+            description: 'If true (default) hides NFTs flagged as spam by Moralis.',
+            required: false,
+            default: true,
+        },
+        {
+            name: 'includePrices',
+            type: 'boolean',
+            description: 'If true, include floor price and last sale data when available.',
+            required: false,
+            default: false,
+        },
+        {
+            name: 'limit',
+            type: 'number',
+            description: 'Page size (1-100, default 10).',
+            required: false,
+            default: 10,
+        },
+        {
+            name: 'cursor',
+            type: 'string',
+            description: 'Pagination cursor from a previous response. Pass to fetch the next page.',
+            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)) : 10;
+        const excludeSpam = typeof args.excludeSpam === 'boolean' ? args.excludeSpam : true;
+        const includePrices = typeof args.includePrices === 'boolean' ? args.includePrices : false;
+        const cursor = typeof args.cursor === 'string' && args.cursor ? args.cursor : undefined;
+        const contractAddresses = Array.isArray(args.contractAddresses)
+            ? args.contractAddresses
+                .filter((c) => typeof c === 'string' && !!c)
+                .map((c) => c.trim())
+            : undefined;
+        const result = await this.service.getWalletNFTs({
+            address,
+            chain,
+            limit,
+            excludeSpam,
+            cursor,
+            tokenAddresses: contractAddresses,
+            includePrices,
+        });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch NFTs' };
+        }
+        const rawNfts = result.data?.result ?? [];
+        const nfts = rawNfts.map((nft) => this.normalize(nft));
+        return {
+            walletAddress: address,
+            chain: chain || 'default',
+            filters: {
+                contractAddresses: contractAddresses && contractAddresses.length > 0 ? contractAddresses : null,
+                excludeSpam,
+                includePrices,
+                limit,
+                cursor: cursor ?? null,
+            },
+            pagination: {
+                cursor: result.data?.cursor ?? null,
+                pageSize: result.data?.page_size ?? limit,
+                page: result.data?.page ?? null,
+                hasMore: !!result.data?.cursor,
+            },
+            nftCount: nfts.length,
+            nfts,
+        };
+    }
+    normalize(nft) {
+        const meta = nft.normalized_metadata;
+        const mediaCollection = nft.media?.media_collection;
+        const attributes = Array.isArray(meta?.attributes)
+            ? meta.attributes.map((a) => ({
+                trait_type: a.trait_type,
+                value: String(a.value),
+            }))
+            : [];
+        return {
+            name: meta?.name ?? nft.name ?? null,
+            collectionName: nft.name ?? null,
+            symbol: nft.symbol ?? null,
+            tokenId: nft.token_id,
+            contractAddress: nft.token_address,
+            contractType: nft.contract_type,
+            amount: nft.amount,
+            ownerOf: nft.owner_of,
+            tokenHash: nft.token_hash,
+            tokenUri: nft.token_uri ?? null,
+            description: meta?.description ?? null,
+            image: meta?.image ?? nft.media?.original_media_url ?? null,
+            animationUrl: meta?.animation_url ?? null,
+            media: {
+                original: nft.media?.original_media_url,
+                low: mediaCollection?.low?.url,
+                medium: mediaCollection?.medium?.url,
+                high: mediaCollection?.high?.url,
+                mimetype: nft.media?.mimetype,
+                status: nft.media?.status,
+            },
+            attributes,
+            verifiedCollection: nft.verified_collection,
+            possibleSpam: nft.possible_spam,
+            collectionLogo: nft.collection_logo ?? null,
+            collectionBanner: nft.collection_banner_image ?? null,
+            blockNumber: nft.block_number,
+            blockNumberMinted: nft.block_number_minted,
+        };
+    }
+}
+exports.WalletNFTsTool = WalletNFTsTool;
+//# sourceMappingURL=WalletNFTsTool.js.map

package/dist/tools/builtin/nft/WalletNFTsTool.js.map

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

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

@@ -0,0 +1,7 @@
+export { WalletNFTsTool } from './WalletNFTsTool';
+export type { WalletNFTsToolConfig } from './WalletNFTsTool';
+export { NFTContractInfoTool } from './NFTContractInfoTool';
+export type { NFTContractInfoToolConfig } from './NFTContractInfoTool';
+export { NFTMetadataTool } from './NFTMetadataTool';
+export type { NFTMetadataToolConfig } from './NFTMetadataTool';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tools/builtin/nft/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NFTMetadataTool = exports.NFTContractInfoTool = exports.WalletNFTsTool = void 0;
+var WalletNFTsTool_1 = require("./WalletNFTsTool");
+Object.defineProperty(exports, "WalletNFTsTool", { enumerable: true, get: function () { return WalletNFTsTool_1.WalletNFTsTool; } });
+var NFTContractInfoTool_1 = require("./NFTContractInfoTool");
+Object.defineProperty(exports, "NFTContractInfoTool", { enumerable: true, get: function () { return NFTContractInfoTool_1.NFTContractInfoTool; } });
+var NFTMetadataTool_1 = require("./NFTMetadataTool");
+Object.defineProperty(exports, "NFTMetadataTool", { enumerable: true, get: function () { return NFTMetadataTool_1.NFTMetadataTool; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/builtin/nft/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/index.ts"],"names":[],"mappings":";;;AAAA,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAE5B,qDAAoD;AAA3C,kHAAA,eAAe,OAAA"}

package/dist/tools/builtin/pool/EstimatePoolYieldTool.d.ts

@@ -0,0 +1,124 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type UniswapServiceConfig } from '../../../services/UniswapService';
+export type EstimatePoolYieldToolConfig = UniswapServiceConfig;
+/**
+ * Yield formula (matches Uniswap UI's "estimated APR"):
+ *   fees24h = volume24h × feeTier_decimal
+ *   APR     = (fees24h / TVL) × 365
+ *   yield   = deposit × APR / period
+ *
+ * Note: assumes full-range liquidity. Concentrated positions earn more when in
+ * range, zero when out of range. Does not account for impermanent loss.
+ */
+interface YieldEstimate {
+    depositUsd: number;
+    aprPercent: number;
+    dailyUsd: number;
+    weeklyUsd: number;
+    monthlyUsd: number;
+    yearlyUsd: number;
+}
+export declare class EstimatePoolYieldTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: EstimatePoolYieldToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        _instructions?: undefined;
+        reason?: undefined;
+        missing?: undefined;
+        candidates?: undefined;
+        pool?: undefined;
+        autoPickedReason?: undefined;
+        aprUnavailableReason?: undefined;
+        estimate?: undefined;
+        depositMode?: undefined;
+        disclaimer?: undefined;
+    } | {
+        _instructions: string;
+        reason: string;
+        missing: string[];
+        candidates: {
+            pair: string | undefined;
+            feeTierBps: number | undefined;
+            feeTierPercent: number | undefined;
+            volume24hUsd: number | undefined;
+            address: string | undefined;
+        }[];
+        error?: undefined;
+        pool?: undefined;
+        autoPickedReason?: undefined;
+        aprUnavailableReason?: undefined;
+        estimate?: undefined;
+        depositMode?: undefined;
+        disclaimer?: undefined;
+    } | {
+        _instructions: string;
+        pool: {
+            address: string | undefined;
+            pair: string | undefined;
+            feeTierBps: number | undefined;
+            feeTierPercent: number | undefined;
+            tvlUsd: number | undefined;
+            volume24hUsd: number | undefined;
+            fees24hUsd: number | undefined;
+            aprPercent: number | undefined;
+            chain: string;
+            token0: {
+                symbol: string | undefined;
+            } | undefined;
+            token1: {
+                symbol: string | undefined;
+            } | undefined;
+        };
+        autoPickedReason: string | undefined;
+        aprUnavailableReason: string;
+        error?: undefined;
+        reason?: undefined;
+        missing?: undefined;
+        candidates?: undefined;
+        estimate?: undefined;
+        depositMode?: undefined;
+        disclaimer?: undefined;
+    } | {
+        _instructions: string;
+        pool: {
+            address: string | undefined;
+            pair: string | undefined;
+            feeTierBps: number | undefined;
+            feeTierPercent: number | undefined;
+            tvlUsd: number | undefined;
+            volume24hUsd: number | undefined;
+            fees24hUsd: number | undefined;
+            aprPercent: number | undefined;
+            chain: string;
+            token0: {
+                symbol: string | undefined;
+            } | undefined;
+            token1: {
+                symbol: string | undefined;
+            } | undefined;
+        };
+        estimate: YieldEstimate;
+        depositMode: string;
+        autoPickedReason: string | undefined;
+        disclaimer: string;
+        error?: undefined;
+        reason?: undefined;
+        missing?: undefined;
+        candidates?: undefined;
+        aprUnavailableReason?: undefined;
+    }>;
+    private filterPools;
+    private sym;
+    private rankByVolume;
+    /** Keep the highest-volume pool per fee tier — useful when the same pair has duplicates across protocols. */
+    private dedupeByFeeTier;
+    private describeQuery;
+}
+export {};
+//# sourceMappingURL=EstimatePoolYieldTool.d.ts.map

package/dist/tools/builtin/pool/EstimatePoolYieldTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EstimatePoolYieldTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/pool/EstimatePoolYieldTool.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,EAAyB,MAAM,kCAAkC,CAAC;AAEpH,MAAM,MAAM,2BAA2B,GAAG,oBAAoB,CAAC;AAM/D;;;;;;;;GAQG;AAEH,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAaD,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,IAAI,SAAyB;IAC7B,WAAW,SAauE;IAElF,QAAQ,SAAqB;IAE7B,UAAU,EAAE,aAAa,EAAE,CAsCzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,2BAA2B;cAKhC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4I5E,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,YAAY;IAIpB,6GAA6G;IAC7G,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,aAAa;CAItB"}

package/dist/tools/builtin/pool/EstimatePoolYieldTool.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EstimatePoolYieldTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const UniswapService_1 = require("../../../services/UniswapService");
+const DAYS_PER_YEAR = 365;
+const DEFAULT_DEPOSIT_USD = 1000;
+const EVM_ADDRESS_RE = /^0x[a-fA-F0-9]{40}$/;
+function computeYield(depositUsd, aprDecimal) {
+    return {
+        depositUsd,
+        aprPercent: aprDecimal * 100,
+        dailyUsd: (depositUsd * aprDecimal) / DAYS_PER_YEAR,
+        weeklyUsd: (depositUsd * aprDecimal) / 52,
+        monthlyUsd: (depositUsd * aprDecimal) / 12,
+        yearlyUsd: depositUsd * aprDecimal,
+    };
+}
+class EstimatePoolYieldTool extends BaseTool_1.BaseTool {
+    name = 'estimate_pool_yield';
+    description = 'Estimate daily / weekly / monthly / yearly fee yield for a USD deposit into a Uniswap V3 pool. ' +
+        'Answers questions like: "If I put $1000 into the USDC/WETH 0.05% pool, how much per day?", ' +
+        '"bỏ 500$ vào pool ETH/USDC 0.3% mỗi ngày lời bao nhiêu?", "APR of WBTC/ETH 0.3% on Arbitrum". ' +
+        'BEHAVIOR (designed to minimize back-and-forth with the user):\n' +
+        '  • If only ONE token symbol is given → auto-pick the highest-volume V3 pool containing that token and compute yield. ' +
+        'Do NOT ask the user for the other token.\n' +
+        '  • If BOTH tokens are given but fee tier is missing AND multiple fee tiers exist → return candidates (one per fee tier) ' +
+        'so the agent can ask the user to pick.\n' +
+        '  • If depositUsd is missing → default to $1000 and clearly mark the result as a per-$1000 example. ' +
+        'Do NOT ask the user for the deposit amount.\n' +
+        '  • If chain is missing → default to userContext.chain or "0x1" (Ethereum).\n' +
+        'Source: Uniswap ExploreStats (live 24h data). ' +
+        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea.';
+    category = 'blockchain-data';
+    parameters = [
+        {
+            name: 'token0Symbol',
+            type: 'string',
+            description: 'Symbol of one of the pool tokens (e.g. "USDC"). Pair order does not matter.',
+            required: true,
+        },
+        {
+            name: 'token1Symbol',
+            type: 'string',
+            description: 'Symbol of the other pool token (e.g. "WETH"). ' +
+                'Optional — if omitted, the tool auto-picks the highest-volume pool containing token0Symbol.',
+            required: false,
+        },
+        {
+            name: 'feeTier',
+            type: 'number',
+            description: 'Fee tier in basis points: 100 = 0.01%, 500 = 0.05%, 3000 = 0.30%, 10000 = 1.00%. ' +
+                'Optional — if omitted and the pair has multiple fee tiers, the tool returns candidates.',
+            required: false,
+        },
+        {
+            name: 'depositUsd',
+            type: 'number',
+            description: 'USD amount to deposit. Optional — defaults to 1000 and the response is marked as a per-$1000 example.',
+            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 UniswapService_1.UniswapService(config);
+    }
+    async run(args, userContext) {
+        const chain = typeof args.chain === 'string' && args.chain.trim() ? args.chain.trim() : userContext?.chain || '0x1';
+        const token0Symbol = typeof args.token0Symbol === 'string' ? args.token0Symbol.trim() : '';
+        const token1Symbol = typeof args.token1Symbol === 'string' ? args.token1Symbol.trim() : '';
+        const feeTier = typeof args.feeTier === 'number' && Number.isFinite(args.feeTier) ? Math.floor(args.feeTier) : undefined;
+        const userProvidedDeposit = typeof args.depositUsd === 'number' && Number.isFinite(args.depositUsd) && args.depositUsd > 0;
+        const depositUsd = userProvidedDeposit ? args.depositUsd : DEFAULT_DEPOSIT_USD;
+        if (!token0Symbol) {
+            return { error: 'token0Symbol is required. Ask the user which pool / token they want to estimate yield for.' };
+        }
+        const searchQuery = token1Symbol ? `${token0Symbol} ${token1Symbol}` : token0Symbol;
+        const search = await this.service.searchPools({
+            query: searchQuery,
+            chain,
+            page: 1,
+            size: 50,
+            protocolVersion: 'V3',
+        });
+        if (!search.success)
+            return { error: search.error || 'Pool search failed' };
+        const all = search.data ?? [];
+        const matched = this.filterPools(all, token0Symbol, token1Symbol, feeTier);
+        if (matched.length === 0) {
+            return {
+                error: `No V3 pool found for ${this.describeQuery(token0Symbol, token1Symbol, feeTier)} on chain ${chain}. ` +
+                    'Verify the token symbols with the user.',
+            };
+        }
+        const ranked = this.rankByVolume(matched);
+        // Disambiguation: ONLY when BOTH symbols are given but feeTier is missing
+        // AND there are multiple distinct fee tiers. In every other case we pick
+        // the top pool automatically — this is what makes the UX feel natural.
+        if (token1Symbol && feeTier == null) {
+            const distinctFeeTiers = new Set(ranked.map((p) => p.feeTier).filter((f) => typeof f === 'number'));
+            if (distinctFeeTiers.size > 1) {
+                const candidates = this.dedupeByFeeTier(ranked).slice(0, 5);
+                return {
+                    _instructions: 'The pair has multiple fee tiers. Present them as a short numbered list (fee tier %, 24h volume). ' +
+                        'Ask which fee tier the user wants, then re-call with the same token symbols + chosen feeTier. ' +
+                        'If the user already mentioned a deposit amount, pass it along as depositUsd. ' +
+                        'Do NOT mention tool names. Format numbers human-readably (e.g. $12.5M, 0.05%).',
+                    reason: `${token0Symbol}/${token1Symbol} exists across multiple fee tiers — user choice required.`,
+                    missing: ['feeTier'],
+                    candidates: candidates.map((p) => ({
+                        pair: p.token0?.symbol && p.token1?.symbol ? `${p.token0.symbol}/${p.token1.symbol}` : undefined,
+                        feeTierBps: p.feeTier,
+                        feeTierPercent: typeof p.feeTier === 'number' ? p.feeTier / 10_000 : undefined,
+                        volume24hUsd: p.volumeUsd24hr,
+                        address: p.id,
+                    })),
+                };
+            }
+        }
+        // Auto-pick: highest-volume pool from the filtered set.
+        const chosen = ranked[0];
+        if (!chosen.id || !EVM_ADDRESS_RE.test(chosen.id)) {
+            return { error: 'Resolved pool has no valid address.' };
+        }
+        const detail = await this.service.getV3PoolDetail({ address: chosen.id, chain });
+        if (!detail.success || !detail.data) {
+            return { error: detail.error || 'Failed to fetch pool detail.' };
+        }
+        const pool = detail.data;
+        const tvlUsd = pool.totalLiquidity?.value;
+        const volume24hUsd = pool.volume24h?.value;
+        const feeTierBps = pool.feeTier;
+        const feeTierPercent = typeof feeTierBps === 'number' ? feeTierBps / 10_000 : undefined;
+        const fees24hUsd = typeof volume24hUsd === 'number' && typeof feeTierPercent === 'number'
+            ? (volume24hUsd * feeTierPercent) / 100
+            : undefined;
+        const aprDecimal = typeof fees24hUsd === 'number' && typeof tvlUsd === 'number' && tvlUsd > 0
+            ? (fees24hUsd / tvlUsd) * DAYS_PER_YEAR
+            : undefined;
+        const poolSummary = {
+            address: pool.address,
+            pair: pool.token0?.symbol && pool.token1?.symbol ? `${pool.token0.symbol}/${pool.token1.symbol}` : undefined,
+            feeTierBps,
+            feeTierPercent,
+            tvlUsd,
+            volume24hUsd,
+            fees24hUsd,
+            aprPercent: typeof aprDecimal === 'number' ? aprDecimal * 100 : undefined,
+            chain,
+            token0: pool.token0 ? { symbol: pool.token0.symbol } : undefined,
+            token1: pool.token1 ? { symbol: pool.token1.symbol } : undefined,
+        };
+        const autoPickedReason = !token1Symbol
+            ? `User only provided ${token0Symbol}; auto-picked the highest-volume V3 pool containing it.`
+            : undefined;
+        if (aprDecimal == null) {
+            return {
+                _instructions: 'Pool APR could not be computed (TVL or volume data unavailable). Inform the user briefly and show TVL/volume if present. ' +
+                    'Do NOT mention tool names.',
+                pool: poolSummary,
+                autoPickedReason,
+                aprUnavailableReason: !tvlUsd ? 'TVL is zero or unavailable' : 'Volume data unavailable',
+            };
+        }
+        const estimate = computeYield(depositUsd, aprDecimal);
+        return {
+            _instructions: "Present the yield estimate naturally in the user's language. " +
+                (userProvidedDeposit
+                    ? "Lead with: pool (pair + fee %), chain, APR %. Then show projected earnings for the user's deposit — daily, weekly, monthly, yearly. "
+                    : 'IMPORTANT: depositUsd was NOT specified by the user — the result is a per-$1000 EXAMPLE. ' +
+                        'Lead with: pool (pair + fee %), chain, APR %. Then say "for every $1000 deposited you would earn approximately:" and list daily / weekly / monthly / yearly. ' +
+                        'End with a short note that the user can multiply these numbers by (their deposit / 1000) for a custom amount. ') +
+                (autoPickedReason
+                    ? 'Mention briefly that you picked the highest-volume pool for this token (do NOT say "auto-picked"). '
+                    : '') +
+                'Add a one-line disclaimer about impermanent loss. ' +
+                'Format USD numbers with 2 decimal places (e.g. $3.45/day). Do NOT mention tool names.',
+            pool: poolSummary,
+            estimate,
+            depositMode: userProvidedDeposit ? 'user-specified' : 'default-1000-example',
+            autoPickedReason,
+            disclaimer: "Fee yield is based on the pool's 24h volume snapshot and assumes full-range liquidity. Actual returns vary with price movement, volume changes, and impermanent loss.",
+        };
+    }
+    filterPools(pools, sym0, sym1, fee) {
+        const x = sym0.toLowerCase();
+        const y = sym1 ? sym1.toLowerCase() : '';
+        return pools.filter((p) => {
+            if (fee != null && p.feeTier !== fee)
+                return false;
+            const a = (p.token0?.symbol ?? '').toLowerCase();
+            const b = (p.token1?.symbol ?? '').toLowerCase();
+            if (y) {
+                return (this.sym(a, x) && this.sym(b, y)) || (this.sym(a, y) && this.sym(b, x));
+            }
+            return this.sym(a, x) || this.sym(b, x);
+        });
+    }
+    sym(poolSym, userSym) {
+        if (!poolSym || !userSym)
+            return false;
+        return poolSym.includes(userSym) || userSym.includes(poolSym);
+    }
+    rankByVolume(pools) {
+        return [...pools].sort((a, b) => (b.volumeUsd24hr ?? 0) - (a.volumeUsd24hr ?? 0));
+    }
+    /** Keep the highest-volume pool per fee tier — useful when the same pair has duplicates across protocols. */
+    dedupeByFeeTier(pools) {
+        const seen = new Set();
+        const out = [];
+        for (const p of pools) {
+            if (typeof p.feeTier !== 'number')
+                continue;
+            if (seen.has(p.feeTier))
+                continue;
+            seen.add(p.feeTier);
+            out.push(p);
+        }
+        return out;
+    }
+    describeQuery(sym0, sym1, fee) {
+        const pair = sym1 ? `${sym0}/${sym1}` : sym0;
+        return fee != null ? `${pair} at ${fee} bps` : pair;
+    }
+}
+exports.EstimatePoolYieldTool = EstimatePoolYieldTool;
+//# sourceMappingURL=EstimatePoolYieldTool.js.map

package/dist/tools/builtin/pool/EstimatePoolYieldTool.js.map

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