keyring-agent-core 0.1.0 → 0.2.0

package/dist/tools/builtin/pool-subgraph/SubgraphTrendingPoolsTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubgraphTrendingPoolsTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/pool-subgraph/SubgraphTrendingPoolsTool.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,qBAAqB,EAE3B,MAAM,0CAA0C,CAAC;AAGlD,MAAM,MAAM,+BAA+B,GAAG,qBAAqB,CAAC;AAEpE;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,QAAQ;IACrD,IAAI,SAA6B;IACjC,WAAW,SAI6H;IACxI,QAAQ,SAAqB;IAC7B,aAAa,UAAQ;IACrB,UAAU,EAAE,aAAa,EAAE,CAkBzB;IAEF,OAAO,CAAC,OAAO,CAAyB;gBAE5B,MAAM,CAAC,EAAE,+BAA+B;cAKpC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2D7E"}

package/dist/tools/builtin/pool-subgraph/SubgraphTrendingPoolsTool.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubgraphTrendingPoolsTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const UniswapSubgraphService_1 = require("../../../services/UniswapSubgraphService");
+const SubgraphPoolSearchTool_1 = require("./SubgraphPoolSearchTool");
+/**
+ * Tool: subgraph-trending-pools
+ *
+ * Returns Uniswap V3 pools sorted by 24h volume on the chosen chain(s).
+ * Maps to intent: trending_pool ("hot pools", "most active", "trending").
+ */
+class SubgraphTrendingPoolsTool extends BaseTool_1.BaseTool {
+    name = 'subgraph-trending-pools';
+    description = 'List Uniswap V3 pools with the highest 24h volume on one or more chains via The Graph subgraphs. ' +
+        'Use for: "what are trending pools?", "most active pools", "hot pools right now", "pools with biggest volume today". ' +
+        'Returns pair, TVL, 24h volume, fee tier (%), APR (DefiLlama-enriched) for each. ' +
+        'Supported chains: Ethereum (0x1), Arbitrum (0xa4b1), Polygon (0x89), BSC (0x38), Base (0x2105), Optimism (0xa), Avalanche (0xa86a).';
+    category = 'blockchain-data';
+    noSuggestions = true;
+    parameters = [
+        {
+            name: 'chains',
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Hex chain IDs: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, "0xa4b1" Arbitrum, "0xa86a" Avalanche. ' +
+                'Pass [] when the user did not name a chain — the tool defaults to the connected chain.',
+            required: false,
+            default: [],
+        },
+        {
+            name: 'limit',
+            type: 'number',
+            description: 'Max pools to return. Default 5, max 20.',
+            required: false,
+            default: 5,
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new UniswapSubgraphService_1.UniswapSubgraphService(config);
+    }
+    async run(args, userContext) {
+        const requested = (Array.isArray(args.chains) ? args.chains : []).filter((c) => typeof c === 'string' && c.trim().length > 0);
+        const unsupported = requested.filter((c) => !this.service.isSupported(c));
+        const supported = requested.filter((c) => this.service.isSupported(c)).map((c) => this.service.resolveChain(c));
+        if (requested.length > 0 && supported.length === 0) {
+            return {
+                _instructions: 'User requested unsupported chains. Politely list them and the supported chains; do not show pool data.',
+                unsupportedChains: unsupported,
+                supportedChains: this.service.listSupportedChains(),
+                pools: [],
+                count: 0,
+            };
+        }
+        const chains = supported.length > 0
+            ? supported
+            : this.service.isSupported(userContext?.chain)
+                ? [this.service.resolveChain(userContext?.chain)]
+                : ['0x1'];
+        const limit = typeof args.limit === 'number' && Number.isFinite(args.limit) && args.limit > 0
+            ? Math.min(Math.floor(args.limit), 20)
+            : 5;
+        const results = await Promise.allSettled(chains.map((chain) => this.service.getTrendingPools({ chain })));
+        let pools = results.flatMap((r) => (r.status === 'fulfilled' ? r.value : []));
+        pools.sort((a, b) => b.volume24hUsd - a.volume24hUsd);
+        pools = pools.slice(0, limit);
+        return {
+            _instructions: 'Prefix the answer with: "According to the latest data from Subgraph Uniswap V3," (translate naturally; keep "Subgraph" as-is). ' +
+                'List pools ranked by 24h volume. For each: pair, fee %, 24h volume, TVL, APR (skip if null). ' +
+                'For EACH pool render the provided uniswapUrl as a clickable markdown link (e.g. wrap the pair as "[USDC/WETH](uniswapUrl)" or append "[View on Uniswap](uniswapUrl)"). Never omit it. Do not invent URLs.',
+            chains,
+            unsupportedChains: unsupported,
+            count: pools.length,
+            pools: pools.map((p) => ({
+                pair: p.pair,
+                poolAddress: p.poolAddress,
+                chain: p.chain,
+                feeTierBps: p.feeTierBps,
+                feeTierPercent: p.feeTierPercent,
+                tvlUsd: p.tvl,
+                volume24hUsd: p.volume24hUsd,
+                fees24hUsd: p.fees24hUsd,
+                apr: p.apr,
+                token0: p.token0,
+                token1: p.token1,
+                uniswapUrl: (0, SubgraphPoolSearchTool_1.buildUniswapPoolUrl)(p),
+            })),
+        };
+    }
+}
+exports.SubgraphTrendingPoolsTool = SubgraphTrendingPoolsTool;
+//# sourceMappingURL=SubgraphTrendingPoolsTool.js.map

package/dist/tools/builtin/pool-subgraph/SubgraphTrendingPoolsTool.js.map

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

package/dist/tools/builtin/pool-subgraph/index.d.ts

@@ -0,0 +1,13 @@
+export { SubgraphPoolSearchTool, buildUniswapPoolUrl, UNISWAP_CHAIN_SLUG } from './SubgraphPoolSearchTool';
+export type { SubgraphPoolSearchToolConfig } from './SubgraphPoolSearchTool';
+export { SubgraphTrendingPoolsTool } from './SubgraphTrendingPoolsTool';
+export type { SubgraphTrendingPoolsToolConfig } from './SubgraphTrendingPoolsTool';
+export { SubgraphPoolByAddressTool } from './SubgraphPoolByAddressTool';
+export type { SubgraphPoolByAddressToolConfig } from './SubgraphPoolByAddressTool';
+export { SubgraphPoolByPositionIdTool } from './SubgraphPoolByPositionIdTool';
+export type { SubgraphPoolByPositionIdToolConfig } from './SubgraphPoolByPositionIdTool';
+export { SubgraphPositionDetailTool } from './SubgraphPositionDetailTool';
+export type { SubgraphPositionDetailToolConfig } from './SubgraphPositionDetailTool';
+export { SubgraphCoinPoolPairsTool } from './SubgraphCoinPoolPairsTool';
+export type { SubgraphCoinPoolPairsToolConfig } from './SubgraphCoinPoolPairsTool';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/builtin/pool-subgraph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/pool-subgraph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC3G,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,YAAY,EAAE,kCAAkC,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,YAAY,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/tools/builtin/pool-subgraph/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubgraphCoinPoolPairsTool = exports.SubgraphPositionDetailTool = exports.SubgraphPoolByPositionIdTool = exports.SubgraphPoolByAddressTool = exports.SubgraphTrendingPoolsTool = exports.UNISWAP_CHAIN_SLUG = exports.buildUniswapPoolUrl = exports.SubgraphPoolSearchTool = void 0;
+var SubgraphPoolSearchTool_1 = require("./SubgraphPoolSearchTool");
+Object.defineProperty(exports, "SubgraphPoolSearchTool", { enumerable: true, get: function () { return SubgraphPoolSearchTool_1.SubgraphPoolSearchTool; } });
+Object.defineProperty(exports, "buildUniswapPoolUrl", { enumerable: true, get: function () { return SubgraphPoolSearchTool_1.buildUniswapPoolUrl; } });
+Object.defineProperty(exports, "UNISWAP_CHAIN_SLUG", { enumerable: true, get: function () { return SubgraphPoolSearchTool_1.UNISWAP_CHAIN_SLUG; } });
+var SubgraphTrendingPoolsTool_1 = require("./SubgraphTrendingPoolsTool");
+Object.defineProperty(exports, "SubgraphTrendingPoolsTool", { enumerable: true, get: function () { return SubgraphTrendingPoolsTool_1.SubgraphTrendingPoolsTool; } });
+var SubgraphPoolByAddressTool_1 = require("./SubgraphPoolByAddressTool");
+Object.defineProperty(exports, "SubgraphPoolByAddressTool", { enumerable: true, get: function () { return SubgraphPoolByAddressTool_1.SubgraphPoolByAddressTool; } });
+var SubgraphPoolByPositionIdTool_1 = require("./SubgraphPoolByPositionIdTool");
+Object.defineProperty(exports, "SubgraphPoolByPositionIdTool", { enumerable: true, get: function () { return SubgraphPoolByPositionIdTool_1.SubgraphPoolByPositionIdTool; } });
+var SubgraphPositionDetailTool_1 = require("./SubgraphPositionDetailTool");
+Object.defineProperty(exports, "SubgraphPositionDetailTool", { enumerable: true, get: function () { return SubgraphPositionDetailTool_1.SubgraphPositionDetailTool; } });
+var SubgraphCoinPoolPairsTool_1 = require("./SubgraphCoinPoolPairsTool");
+Object.defineProperty(exports, "SubgraphCoinPoolPairsTool", { enumerable: true, get: function () { return SubgraphCoinPoolPairsTool_1.SubgraphCoinPoolPairsTool; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/builtin/pool-subgraph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/builtin/pool-subgraph/index.ts"],"names":[],"mappings":";;;AAAA,mEAA2G;AAAlG,gIAAA,sBAAsB,OAAA;AAAE,6HAAA,mBAAmB,OAAA;AAAE,4HAAA,kBAAkB,OAAA;AAExE,yEAAwE;AAA/D,sIAAA,yBAAyB,OAAA;AAElC,yEAAwE;AAA/D,sIAAA,yBAAyB,OAAA;AAElC,+EAA8E;AAArE,4IAAA,4BAA4B,OAAA;AAErC,2EAA0E;AAAjE,wIAAA,0BAA0B,OAAA;AAEnC,yEAAwE;AAA/D,sIAAA,yBAAyB,OAAA"}

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

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

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenAnalyticsTool = void 0;
 const BaseTool_1 = require("../../BaseTool");
+const chainResolver_1 = require("../../chainResolver");
 const MoralisService_1 = require("../../../services/MoralisService");
 /**
  * Tool: get-token-analytics
@@ -57,8 +58,8 @@ class TokenAnalyticsTool extends BaseTool_1.BaseTool {
             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,
+                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea. ONLY set this when the user EXPLICITLY names a chain; otherwise OMIT it so the connected wallet chain is used.',
+            required: false,
         },
     ];
     service;
@@ -67,7 +68,7 @@ class TokenAnalyticsTool extends BaseTool_1.BaseTool {
         this.service = new MoralisService_1.MoralisService(config);
     }
     async run(args, userContext) {
-        const chain = args.chain || userContext?.chain || undefined;
+        const chain = (0, chainResolver_1.resolveChain)(args.chain, userContext);
         const walletAddress = userContext?.walletAddress || undefined;
         const tokenSymbol = typeof args.tokenSymbol === 'string' && args.tokenSymbol ? args.tokenSymbol.trim() : undefined;
         let contractAddress = typeof args.contractAddress === 'string' && args.contractAddress ? args.contractAddress.trim() : undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"TokenAnalyticsTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TokenAnalyticsTool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TokenAnalyticsTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TokenAnalyticsTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAC1C,uDAAmD;AAEnD,qEAA6F;AAI7F;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,kBAAmB,SAAQ,mBAAQ;IAC9C,IAAI,GAAG,qBAAqB,CAAC;IAC7B,WAAW,GACT,6GAA6G;QAC7G,gHAAgH;QAChH,wFAAwF;QACxF,kGAAkG;QAClG,kEAAkE;QAClE,oCAAoC;QACpC,mDAAmD;QACnD,6FAA6F;QAC7F,4DAA4D;QAC5D,uFAAuF;QACvF,wFAAwF;QACxF,qDAAqD;QACrD,+EAA+E,CAAC;IAClF,QAAQ,GAAG,iBAAiB,CAAC;IAC7B,UAAU,GAAoB;QAC5B;YACE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,8CAA8C;gBAC9C,sGAAsG;gBACtG,qFAAqF;YACvF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,oFAAoF;gBACpF,qCAAqC;YACvC,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2FAA2F;gBAC3F,uKAAuK;YACzK,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC;IAEM,OAAO,CAAiB;IAEhC,YAAY,MAAiC;QAC3C,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,KAAK,GAAG,IAAA,4BAAY,EAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACpD,MAAM,aAAa,GAAG,WAAW,EAAE,aAAa,IAAI,SAAS,CAAC;QAE9D,MAAM,WAAW,GAAG,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACnH,IAAI,eAAe,GACjB,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAE7G,IAAI,CAAC,WAAW,IAAI,CAAC,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,KAAK,EAAE,oEAAoE,EAAE,CAAC;QACzF,CAAC;QAED,IAAI,cAAkC,CAAC;QACvC,IAAI,YAAgC,CAAC;QAErC,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,WAAW,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;YACtF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO;oBACL,KAAK,EAAE,gCAAgC,WAAW,oCAAoC,KAAK,IAAI,SAAS,yCAAyC;iBAClJ,CAAC;YACJ,CAAC;YACD,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC;YACnC,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;YACjC,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC/B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;YAClD,OAAO,EAAE,eAAgB;YACzB,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,iCAAiC,EAAE,CAAC;QACtE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAE/B,OAAO;YACL,KAAK,EAAE;gBACL,MAAM,EAAE,cAAc,IAAI,WAAW,IAAI,IAAI;gBAC7C,IAAI,EAAE,YAAY,IAAI,IAAI;gBAC1B,eAAe,EAAE,eAAgB;gBACjC,KAAK,EAAE,KAAK,IAAI,SAAS;aAC1B;YACD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;YAC/B,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;YAC3C,0BAA0B,EAAE,IAAI,CAAC,0BAA0B,IAAI,IAAI;YACnE,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;YAC3C,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,IAAI;YAC7C,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;YACrC,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI;YACvC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;YACjC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;YACnC,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;YACzC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,IAAI;SACpD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,sBAAsB,CAClC,MAAc,EACd,KAAc,EACd,aAAsB;QAEtB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAEtC,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5F,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,CAAC;gBAC1F,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;gBAClF,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,IAAI,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,CAAC;YACtF,MAAM,SAAS,GAAG,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC7C,IAAI,SAAS,EAAE,aAAa,EAAE,CAAC;gBAC7B,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;YAC9F,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAhJD,gDAgJC"}

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

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

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenHoldersTool = void 0;
 const BaseTool_1 = require("../../BaseTool");
+const chainResolver_1 = require("../../chainResolver");
 const MoralisService_1 = require("../../../services/MoralisService");
 /**
  * Tool: get-token-holders
@@ -55,8 +56,8 @@ class TokenHoldersTool extends BaseTool_1.BaseTool {
             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,
+                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea . ONLY set this when the user EXPLICITLY names a chain; otherwise OMIT it so the connected wallet chain is used.',
+            required: false,
         },
     ];
     service;
@@ -65,7 +66,7 @@ class TokenHoldersTool extends BaseTool_1.BaseTool {
         this.service = new MoralisService_1.MoralisService(config);
     }
     async run(args, userContext) {
-        const chain = args.chain || userContext?.chain || undefined;
+        const chain = (0, chainResolver_1.resolveChain)(args.chain, userContext);
         const walletAddress = userContext?.walletAddress || undefined;
         const tokenSymbol = typeof args.tokenSymbol === 'string' && args.tokenSymbol ? args.tokenSymbol.trim() : undefined;
         let contractAddress = typeof args.contractAddress === 'string' && args.contractAddress ? args.contractAddress.trim() : undefined;

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

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

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

@@ -1,5 +1,5 @@
 import { BaseTool } from '../../BaseTool';
-import type { ToolParameter, UserContext } from '../../../types';
+import type { SuggestedAction, ToolParameter, ToolResult, UserContext } from '../../../types';
 import type { TokenBalance, TokenMetadata } from '../../../services/MoralisService';
 import { type MoralisServiceConfig } from '../../../services/MoralisService';
 export type TokenInfoToolConfig = MoralisServiceConfig;
@@ -19,7 +19,8 @@ export declare class TokenInfoTool extends BaseTool {
     private llm;
     constructor(config?: TokenInfoToolConfig);
     protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
-        aiInsights: string | null;
+        actionButtons?: SuggestedAction[] | undefined;
+        research: string | null;
         searchResults?: TokenMetadata[] | undefined;
         _instructions: string;
         chain: string;
@@ -29,7 +30,10 @@ export declare class TokenInfoTool extends BaseTool {
     } | {
         error: string;
     }>;
+    execute(args: Record<string, unknown>, userContext?: UserContext): Promise<ToolResult>;
     private searchToken;
+    /** Substitute the {token} placeholder in an LLM-supplied localized template. */
+    private fillTemplate;
     private askGeminiWithSearch;
     private findTokenInWallet;
 }

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

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

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenInfoTool = void 0;
 const BaseTool_1 = require("../../BaseTool");
+const chainResolver_1 = require("../../chainResolver");
 const MoralisService_1 = require("../../../services/MoralisService");
 const GeminiProvider_1 = require("../../../llm/GeminiProvider");
 /**
@@ -30,8 +31,8 @@ class TokenInfoTool extends BaseTool_1.BaseTool {
             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,
+                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea. ONLY set this when the user EXPLICITLY names a chain; otherwise OMIT it so the connected wallet chain is used.',
+            required: false,
         },
         {
             name: 'prompt',
@@ -56,6 +57,26 @@ class TokenInfoTool extends BaseTool_1.BaseTool {
                 'and unusual volume patterns; team or protocol updates; key risks or red flags; and overall sentiment."',
             required: true,
         },
+        {
+            name: 'buy_button_label',
+            type: 'string',
+            description: 'Label for the "Buy" suggestion button shown under the token info, IN THE USER\'S CURRENT LANGUAGE. ' +
+                'Use the exact placeholder "{token}" (do not translate the braces) for the token symbol; put the ' +
+                'localized verb directly in the text. ' +
+                'English example: "Buy {token}". Vietnamese example: "Mua {token}". Japanese example: "{token} を買う". ' +
+                'Always include {token}.',
+            required: true,
+        },
+        {
+            name: 'buy_prompt_template',
+            type: 'string',
+            description: 'A short "buy" command IN THE USER\'S CURRENT LANGUAGE, submitted as the next user turn when the Buy button ' +
+                'is clicked. Use the exact placeholder "{token}" (do not translate the braces) for the token symbol; put ' +
+                'the localized verb directly in the text. ' +
+                'English example: "buy {token}". Vietnamese example: "mua {token}". Japanese example: "{token} を買う". ' +
+                'Always include {token}.',
+            required: true,
+        },
     ];
     service;
     llm;
@@ -66,15 +87,27 @@ class TokenInfoTool extends BaseTool_1.BaseTool {
     }
     async run(args, userContext) {
         const keyword = args.keyword || '';
-        const chain = args.chain || userContext?.chain || '0x1';
+        const chain = (0, chainResolver_1.resolveChain)(args.chain, userContext);
         const prompt = args.prompt || '';
+        const buyButtonLabel = args.buy_button_label || '';
+        const buyPromptTemplate = args.buy_prompt_template || '';
         const walletAddress = userContext?.walletAddress || undefined;
         if (!keyword) {
             return { error: 'Missing required parameter: keyword' };
         }
-        return await this.searchToken(keyword, chain, prompt, walletAddress);
+        return await this.searchToken(keyword, chain, prompt, buyButtonLabel, buyPromptTemplate, walletAddress);
     }
-    async searchToken(keyword, chain, prompt, walletAddress) {
+    // Lift `actionButtons` from run() onto the ToolResult so AgentCore renders
+    // the Buy suggestion button below the token info.
+    async execute(args, userContext) {
+        const result = await super.execute(args, userContext);
+        const data = result.data;
+        if (result.success && data && Array.isArray(data.actionButtons) && data.actionButtons.length > 0) {
+            result.actionButtons = data.actionButtons;
+        }
+        return result;
+    }
+    async searchToken(keyword, chain, prompt, buyButtonLabel, buyPromptTemplate, walletAddress) {
         const systemPrompt = [
             walletAddress ? `User's connected wallet address: ${walletAddress}` : null,
             chain ? `Current chain (hex chain ID): ${chain}, only consider tokens on this chain` : null,
@@ -108,13 +141,29 @@ class TokenInfoTool extends BaseTool_1.BaseTool {
         if (!token && topResult) {
             token = { ...topResult };
         }
+        // Offer a "Buy <token>" suggestion button when a token was resolved. The
+        // label/prompt are built from the LLM-supplied, already-localized templates
+        // (AgentCore stamps the turn language so a click re-runs in the same one).
+        const buySymbol = token?.symbol?.trim();
+        const buyButtons = buySymbol
+            ? [
+                {
+                    label: this.fillTemplate(buyButtonLabel, buySymbol, `Buy {token}`),
+                    prompt: this.fillTemplate(buyPromptTemplate, buySymbol, `buy {token}`),
+                },
+            ]
+            : [];
         const data = {
             _instructions: 'Present the token info in a clear summary. Include: token name & symbol, contract address (shortened), ' +
                 'current USD price, 24h price change % (use ▲ for positive, ▼ for negative), market cap, ' +
                 'fully diluted valuation, 24h trading volume, liquidity, and holder count (if available). ' +
                 'If the user holds this token, prominently show their balance and USD value. ' +
-                'If aiInsights is present, include it as a separate "AI Analysis" section after the token stats. ' +
-                'Format numbers in a human-readable way (e.g. $1.23, +5.67%, $12.5M). If a field is null, omit it.',
+                'If research is present, weave its substance naturally into your answer — fold the relevant points into ' +
+                'the description, context, and any notable news or risks. Do NOT add a labelled "AI Analysis" section or ' +
+                'any similar heading, and do NOT mention that the analysis came from AI; just write it as part of the ' +
+                'token summary. ' +
+                'Format numbers in a human-readable way (e.g. $1.23, +5.67%, $12.5M). If a field is null, omit it. ' +
+                'A "Buy" button is shown below your reply automatically — do NOT mention it, list it, or repeat its text.',
             chain,
             userHoldsToken: !!walletHolding,
             walletBalance: walletHolding,
@@ -124,10 +173,19 @@ class TokenInfoTool extends BaseTool_1.BaseTool {
                     searchResults: sortedList.slice(0, 10),
                 }
                 : {}),
-            aiInsights: aiText,
+            research: aiText,
+            ...(buyButtons.length > 0 ? { actionButtons: buyButtons } : {}),
         };
         return data;
     }
+    /** Substitute the {token} placeholder in an LLM-supplied localized template. */
+    fillTemplate(template, token, fallback) {
+        const tpl = template && template.includes('{token}') ? template : fallback;
+        return tpl
+            .replace(/\{token\}/g, token)
+            .replace(/\s+/g, ' ')
+            .trim();
+    }
     async askGeminiWithSearch(prompt, systemPrompt) {
         const now = Date.now();
         try {

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"TokenScoreTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TokenScoreTool.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,oBAAoB,GAAG,oBAAoB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAqB;IACzB,WAAW,SAauE;IAClF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA0BzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,oBAAoB;cAKzB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;IA0D5E;;;;OAIG;YACW,sBAAsB;CA4BrC"}
+{"version":3,"file":"TokenScoreTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TokenScoreTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAqB;IACzB,WAAW,SAauE;IAClF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA0BzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,oBAAoB;cAKzB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;IA0D5E;;;;OAIG;YACW,sBAAsB;CA4BrC"}

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenScoreTool = void 0;
 const BaseTool_1 = require("../../BaseTool");
+const chainResolver_1 = require("../../chainResolver");
 const MoralisService_1 = require("../../../services/MoralisService");
 /**
  * Tool: get-token-score
@@ -59,8 +60,8 @@ class TokenScoreTool extends BaseTool_1.BaseTool {
             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,
+                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea. ONLY set this when the user EXPLICITLY names a chain; otherwise OMIT it so the connected wallet chain is used.',
+            required: false,
         },
     ];
     service;
@@ -69,7 +70,7 @@ class TokenScoreTool extends BaseTool_1.BaseTool {
         this.service = new MoralisService_1.MoralisService(config);
     }
     async run(args, userContext) {
-        const chain = args.chain || userContext?.chain || undefined;
+        const chain = (0, chainResolver_1.resolveChain)(args.chain, userContext);
         const walletAddress = userContext?.walletAddress || undefined;
         const tokenSymbol = typeof args.tokenSymbol === 'string' && args.tokenSymbol ? args.tokenSymbol.trim() : undefined;
         let contractAddress = typeof args.contractAddress === 'string' && args.contractAddress ? args.contractAddress.trim() : undefined;

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

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

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

@@ -1,21 +1,15 @@
 import { BaseTool } from '../../BaseTool';
 import type { ToolParameter, UserContext } from '../../../types';
-import { type MoralisServiceConfig, type TopGainerToken, type TopGainersTimeFrame } from '../../../services/MoralisService';
+import type { MoralisServiceConfig } from '../../../services/MoralisService';
 export type TopGainersToolConfig = MoralisServiceConfig;
 /**
  * Tool: get-top-gainers
  *
- * Queries `GET /discovery/tokens/top-gainers` — tokens with the largest USD
- * price increase over a chosen timeframe. Supports filters for minimum market
- * cap and minimum security score so the caller can exclude micro-cap or
- * risky contracts.
- *
- * Each row carries multi-timeframe buckets (1h / 1d / 1w / 1M) for:
- *   - price_percent_change_usd
- *   - volume_change_usd / net_volume_change_usd
- *   - liquidity_change_usd
- *   - holders_change
- *   - experienced_net_buyers_change
+ * Queries Pantograph's `GET /token-list/top-gainers/{chain}?duration=…` — the
+ * tokens with the largest USD price increase over a chosen window. Single-chain
+ * (Pantograph has no cross-chain feed); defaults to the connected chain, then
+ * Base. Returns the canonical trending-token shape: price, market cap, 24h
+ * volume, and the price change over the selected window.
  */
 export declare class TopGainersTool extends BaseTool {
     name: string;
@@ -27,19 +21,16 @@ export declare class TopGainersTool extends BaseTool {
     protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
         error: string;
         _instructions?: undefined;
+        chain?: undefined;
         timeFrame?: undefined;
-        filters?: undefined;
         count?: undefined;
         tokens?: undefined;
     } | {
         _instructions: string;
-        timeFrame: TopGainersTimeFrame | null;
-        filters: {
-            minMarketCap: number | null;
-            securityScore: number | null;
-        };
+        chain: string;
+        timeFrame: string | null;
         count: number;
-        tokens: TopGainerToken[];
+        tokens: import("../../../services/MoralisService").TrendingToken[];
         error?: undefined;
     }>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"TopGainersTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TopGainersTool.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,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAIxD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAqB;IACzB,WAAW,SAUiF;IAC5F,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAmCzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,oBAAoB;cAKzB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;CA+C7E"}
+{"version":3,"file":"TopGainersTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TopGainersTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAG7E,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAWxD;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAqB;IACzB,WAAW,SAOuE;IAClF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA0BzB;IAEF,OAAO,CAAC,OAAO,CAAoB;gBAEvB,MAAM,CAAC,EAAE,oBAAoB;cAKzB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;CA2C7E"}