keyring-agent-core 0.1.0

package/dist/tools/builtin/ai/SolanaCortexTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolanaCortexTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/ai/SolanaCortexTool.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;AAoB1D,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,IAAI,SAAsB;IAC1B,WAAW,SAS6C;IACxD,QAAQ,SAAmB;IAC3B,UAAU,EAAE,aAAa,EAAE,CAgBzB;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;;;;;;;;;CA2B7E"}

package/dist/tools/builtin/ai/SolanaCortexTool.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolanaCortexTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+const SOLANA_SYSTEM_PROMPT = `You are a Solana blockchain data specialist with real-time on-chain access.
+
+Your expertise covers:
+- Native SOL and SPL token balances, transfers, prices
+- Solana NFTs (Metaplex standard, compressed NFTs / cNFTs)
+- Solana DeFi: Jupiter, Raydium, Orca, Marinade, Jito, etc.
+- Solana wallet history, transactions, staking, validators
+- Token metadata, collection info, rarity
+- Solana program interactions and decoded instructions
+
+Rules:
+- Always use accurate, current on-chain data.
+- When returning lists (tokens, NFTs, transactions), structure them clearly.
+- Express SOL amounts with 9 decimal places (lamports base unit).
+- For USD values, use current market prices.
+- If data is unavailable or the address has no activity, say so explicitly.
+- Be concise but complete — cover all aspects the user asked about.`;
+class SolanaCortexTool extends BaseTool_1.BaseTool {
+    name = 'solana-cortex-ai';
+    description = 'Specialized AI tool for all Solana blockchain questions. ' +
+        'Use this tool when: (1) the user is connected to Solana chain (0x736f6c), ' +
+        '(2) the user provides a Solana wallet address (base58, not 0x…), ' +
+        '(3) the user asks about SOL, SPL tokens, Solana NFTs, Solana DeFi (Jupiter, Raydium, Orca, Marinade, Jito), ' +
+        'Solana staking, validators, or any Solana-specific topic. ' +
+        'The "prompt" parameter must be a precise, self-contained English question crafted from the user query ' +
+        'including all relevant context (wallet address, token names, time range, etc.). ' +
+        'Examples: token/SOL balances on a Solana address, Solana NFT holdings, Solana transaction history, ' +
+        'SPL token price or metadata, Solana DeFi positions.';
+    category = 'blockchain-ai';
+    parameters = [
+        {
+            name: 'prompt',
+            type: 'string',
+            description: 'A precise, self-contained English question for the Solana AI. ' +
+                'Include all relevant details: wallet address (if applicable), token name/mint, time range, chain context. ' +
+                'Example: "What are the current SOL and SPL token balances for wallet EaQEsLPoV9Hy12C5nARZvTLATSVUecgR3VxfoB8WxbWd on Solana?"',
+            required: true,
+        },
+        {
+            name: 'address',
+            type: 'string',
+            description: 'Solana wallet address (base58). If omitted, uses the connected wallet from user context.',
+            required: false,
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new MoralisService_1.MoralisService(config);
+    }
+    async run(args, userContext) {
+        const prompt = args.prompt;
+        if (!prompt) {
+            return { error: 'Missing required parameter: prompt' };
+        }
+        const address = args.address || userContext?.walletAddress || null;
+        const contextLines = [];
+        if (address)
+            contextLines.push(`Solana wallet address: ${address}`);
+        const enrichedPrompt = contextLines.length > 0 ? `${contextLines.join('\n')}\n\n${prompt}` : prompt;
+        const result = await this.service.chatWithCortex({
+            prompt: enrichedPrompt,
+            systemPrompt: SOLANA_SYSTEM_PROMPT,
+        });
+        if (!result.success) {
+            return { error: result.error || 'Solana Cortex AI request failed' };
+        }
+        return {
+            source: 'solana-cortex-ai',
+            answer: result.data?.text || '',
+        };
+    }
+}
+exports.SolanaCortexTool = SolanaCortexTool;
+//# sourceMappingURL=SolanaCortexTool.js.map

package/dist/tools/builtin/ai/SolanaCortexTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolanaCortexTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/ai/SolanaCortexTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAE1C,qEAA6F;AAI7F,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;oEAgBuC,CAAC;AAErE,MAAa,gBAAiB,SAAQ,mBAAQ;IAC5C,IAAI,GAAG,kBAAkB,CAAC;IAC1B,WAAW,GACT,2DAA2D;QAC3D,4EAA4E;QAC5E,mEAAmE;QACnE,8GAA8G;QAC9G,4DAA4D;QAC5D,wGAAwG;QACxG,kFAAkF;QAClF,qGAAqG;QACrG,qDAAqD,CAAC;IACxD,QAAQ,GAAG,eAAe,CAAC;IAC3B,UAAU,GAAoB;QAC5B;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,gEAAgE;gBAChE,4GAA4G;gBAC5G,+HAA+H;YACjI,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0FAA0F;YACvG,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC;IAEM,OAAO,CAAiB;IAEhC,YAAY,MAA+B;QACzC,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,MAAM,GAAG,IAAI,CAAC,MAAgB,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;QACzD,CAAC;QAED,MAAM,OAAO,GAAI,IAAI,CAAC,OAAkB,IAAI,WAAW,EAAE,aAAa,IAAI,IAAI,CAAC;QAE/E,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,IAAI,OAAO;YAAE,YAAY,CAAC,IAAI,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;QAEpE,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QAEpG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;YAC/C,MAAM,EAAE,cAAc;YACtB,YAAY,EAAE,oBAAoB;SACnC,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,OAAO;YACL,MAAM,EAAE,kBAAkB;YAC1B,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE;SAChC,CAAC;IACJ,CAAC;CACF;AAjED,4CAiEC"}

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

@@ -0,0 +1,5 @@
+export { MoralisCortexTool } from './MoralisCortexTool';
+export type { MoralisCortexToolConfig } from './MoralisCortexTool';
+export { SolanaCortexTool } from './SolanaCortexTool';
+export type { SolanaCortexToolConfig } from './SolanaCortexTool';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolanaCortexTool = exports.MoralisCortexTool = void 0;
+var MoralisCortexTool_1 = require("./MoralisCortexTool");
+Object.defineProperty(exports, "MoralisCortexTool", { enumerable: true, get: function () { return MoralisCortexTool_1.MoralisCortexTool; } });
+var SolanaCortexTool_1 = require("./SolanaCortexTool");
+Object.defineProperty(exports, "SolanaCortexTool", { enumerable: true, get: function () { return SolanaCortexTool_1.SolanaCortexTool; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/builtin/ai/index.ts"],"names":[],"mappings":";;;AAAA,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

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

@@ -0,0 +1,6 @@
+export * from './token';
+export * from './wallet';
+export * from './nft';
+export * from './ai';
+export * from './pool';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,MAAM,CAAC;AACrB,cAAc,QAAQ,CAAC"}

package/dist/tools/builtin/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./token"), exports);
+__exportStar(require("./wallet"), exports);
+__exportStar(require("./nft"), exports);
+__exportStar(require("./ai"), exports);
+__exportStar(require("./pool"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB;AACzB,wCAAsB;AACtB,uCAAqB;AACrB,yCAAuB"}

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

@@ -0,0 +1,21 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig } from '../../../services/MoralisService';
+export type NFTContractInfoToolConfig = MoralisServiceConfig;
+/**
+ * Tool: get-nft-contract-info
+ *
+ * Fetches metadata for an NFT contract (name, symbol, type) via Moralis EVM API.
+ */
+export declare class NFTContractInfoTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: NFTContractInfoToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<import("../../../services/MoralisService").NFTContractMetadata | {
+        error: string;
+    } | undefined>;
+}
+//# sourceMappingURL=NFTContractInfoTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NFTContractInfoTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/NFTContractInfoTool.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,yBAAyB,GAAG,oBAAoB,CAAC;AAE7D;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,IAAI,SAA2B;IAC/B,WAAW,SAGsE;IACjF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAezB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,yBAAyB;cAK9B,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;CAmB7E"}

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

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NFTContractInfoTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+/**
+ * Tool: get-nft-contract-info
+ *
+ * Fetches metadata for an NFT contract (name, symbol, type) via Moralis EVM API.
+ */
+class NFTContractInfoTool extends BaseTool_1.BaseTool {
+    name = 'get-nft-contract-info';
+    description = 'Get metadata for an NFT collection/contract: name, symbol, and contract type (ERC721/ERC1155). ' +
+        'Use this when the user asks about a specific NFT collection or contract address. ' +
+        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea';
+    category = 'blockchain-data';
+    parameters = [
+        {
+            name: 'contractAddress',
+            type: 'string',
+            description: 'NFT contract address (0x…).',
+            required: true,
+        },
+        {
+            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 contractAddress = args.contractAddress;
+        const chain = args.chain || userContext?.chain || undefined;
+        if (!contractAddress) {
+            return { error: 'NFT contract address is required.' };
+        }
+        const result = await this.service.getNftContractMetadata({
+            address: contractAddress,
+            chain,
+        });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch NFT contract metadata' };
+        }
+        return result.data;
+    }
+}
+exports.NFTContractInfoTool = NFTContractInfoTool;
+//# sourceMappingURL=NFTContractInfoTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NFTContractInfoTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/NFTContractInfoTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAE1C,qEAA6F;AAI7F;;;;GAIG;AACH,MAAa,mBAAoB,SAAQ,mBAAQ;IAC/C,IAAI,GAAG,uBAAuB,CAAC;IAC/B,WAAW,GACT,iGAAiG;QACjG,mFAAmF;QACnF,8EAA8E,CAAC;IACjF,QAAQ,GAAG,iBAAiB,CAAC;IAC7B,UAAU,GAAoB;QAC5B;YACE,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6BAA6B;YAC1C,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2FAA2F;gBAC3F,sFAAsF;YACxF,QAAQ,EAAE,IAAI;SACf;KACF,CAAC;IAEM,OAAO,CAAiB;IAEhC,YAAY,MAAkC;QAC5C,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,eAAe,GAAG,IAAI,CAAC,eAAyB,CAAC;QACvD,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,WAAW,EAAE,KAAK,IAAI,SAAS,CAAC;QAExE,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;QACxD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC;YACvD,OAAO,EAAE,eAAe;YACxB,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,uCAAuC,EAAE,CAAC;QAC5E,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;CACF;AAlDD,kDAkDC"}

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

@@ -0,0 +1,121 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig } from '../../../services/MoralisService';
+export type NFTMetadataToolConfig = MoralisServiceConfig;
+/**
+ * Tool: get-nft-metadata
+ *
+ * Fetches full metadata for a single NFT identified by its contract address
+ * and token id via the Moralis EVM `GET /nft/{address}/{token_id}` endpoint.
+ *
+ * Moralis docs: https://docs.moralis.com/data-api/evm/nft/metadata/nft-metadata
+ */
+export declare class NFTMetadataTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: NFTMetadataToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        chain?: undefined;
+        contractAddress?: undefined;
+        tokenId?: undefined;
+        contractType?: undefined;
+        amount?: undefined;
+        owner?: undefined;
+        minter?: undefined;
+        blockNumber?: undefined;
+        blockNumberMinted?: undefined;
+        tokenHash?: undefined;
+        name?: undefined;
+        description?: undefined;
+        image?: undefined;
+        animationUrl?: undefined;
+        attributes?: undefined;
+        tokenUri?: undefined;
+        metadata?: undefined;
+        collection?: undefined;
+        media?: undefined;
+        floorPrice?: undefined;
+        floorPriceUsd?: undefined;
+        floorPriceCurrency?: undefined;
+        rarityRank?: undefined;
+        rarityPercentage?: undefined;
+        rarityLabel?: undefined;
+        verifiedCollection?: undefined;
+        possibleSpam?: undefined;
+        lastMetadataSync?: undefined;
+        lastTokenUriSync?: undefined;
+    } | {
+        chain: string | undefined;
+        contractAddress: string;
+        tokenId: string;
+        contractType: "ERC721" | "ERC1155";
+        amount: string;
+        owner: string;
+        minter: string | undefined;
+        blockNumber: string;
+        blockNumberMinted: string;
+        tokenHash: string;
+        name: string;
+        description: string | undefined;
+        image: string | undefined;
+        animationUrl: string | undefined;
+        attributes: {
+            trait_type: string;
+            value: string;
+        }[] | undefined;
+        tokenUri: string | undefined;
+        metadata: string | undefined;
+        collection: {
+            name: string;
+            symbol: string;
+            logo: string | undefined;
+            banner: string | undefined;
+            category: string | undefined;
+            projectUrl: string | undefined;
+            wikiUrl: string | undefined;
+            discordUrl: string | undefined;
+            telegramUrl: string | undefined;
+            twitter: string | undefined;
+            instagram: string | undefined;
+        };
+        media: {
+            mimetype: string | undefined;
+            status: string | undefined;
+            originalUrl: string | undefined;
+            previews: {
+                low?: {
+                    url: string;
+                    width: number;
+                    height: number;
+                };
+                medium?: {
+                    url: string;
+                    width: number;
+                    height: number;
+                };
+                high?: {
+                    url: string;
+                    width: number;
+                    height: number;
+                };
+            } | undefined;
+            updatedAt: string | undefined;
+        } | undefined;
+        floorPrice: string | undefined;
+        floorPriceUsd: string | undefined;
+        floorPriceCurrency: string | undefined;
+        rarityRank: number | undefined;
+        rarityPercentage: number | undefined;
+        rarityLabel: string | undefined;
+        verifiedCollection: boolean;
+        possibleSpam: boolean;
+        lastMetadataSync: string | undefined;
+        lastTokenUriSync: string | undefined;
+        error?: undefined;
+    }>;
+}
+//# sourceMappingURL=NFTMetadataTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NFTMetadataTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/NFTMetadataTool.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,qBAAqB,GAAG,oBAAoB,CAAC;AAEzD;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,IAAI,SAAsB;IAC1B,WAAW,SAMuF;IAClG,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA+CzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,qBAAqB;cAK1B,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0F7E"}

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

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NFTMetadataTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+/**
+ * Tool: get-nft-metadata
+ *
+ * Fetches full metadata for a single NFT identified by its contract address
+ * and token id via the Moralis EVM `GET /nft/{address}/{token_id}` endpoint.
+ *
+ * Moralis docs: https://docs.moralis.com/data-api/evm/nft/metadata/nft-metadata
+ */
+class NFTMetadataTool extends BaseTool_1.BaseTool {
+    name = 'get-nft-metadata';
+    description = 'Get the full metadata for a specific NFT by its contract address and token ID: ' +
+        'name, description, image, attributes/traits, media variants, collection info, ' +
+        'floor price, rarity rank, owner, mint block, and sync timestamps. ' +
+        'Use this when the user asks about a specific NFT, e.g. "show NFT #1234 of collection X", ' +
+        '"details of token ID 42 in contract 0x…", "traits of this NFT", or "floor price of this NFT". ' +
+        'Only supports EVM chains: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea.';
+    category = 'blockchain-data';
+    parameters = [
+        {
+            name: 'contractAddress',
+            type: 'string',
+            description: 'NFT contract address (0x…). The collection / contract that mints the token.',
+            required: true,
+        },
+        {
+            name: 'tokenId',
+            type: 'string',
+            description: 'The NFT token ID to look up (as a string, in the format specified by the "format" parameter).',
+            required: true,
+        },
+        {
+            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: 'format',
+            type: 'string',
+            description: 'Format of the provided token ID: "decimal" (default) or "hex".',
+            required: false,
+        },
+        {
+            name: 'normalizeMetadata',
+            type: 'boolean',
+            description: 'Whether Moralis should return a normalized metadata object (name/description/image/attributes). Default: true.',
+            required: false,
+        },
+        {
+            name: 'mediaItems',
+            type: 'boolean',
+            description: 'Whether to include resized media variants (low / medium / high previews). Default: true.',
+            required: false,
+        },
+        {
+            name: 'include',
+            type: 'string',
+            description: 'Optional extra field to refresh / include in the response: "last_token_uri_sync" or "last_metadata_sync".',
+            required: false,
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new MoralisService_1.MoralisService(config);
+    }
+    async run(args, userContext) {
+        const contractAddress = args.contractAddress;
+        const tokenId = args.tokenId != null ? String(args.tokenId) : '';
+        const chain = args.chain || userContext?.chain || undefined;
+        const format = args.format || undefined;
+        const normalizeMetadata = typeof args.normalizeMetadata === 'boolean' ? args.normalizeMetadata : undefined;
+        const mediaItems = typeof args.mediaItems === 'boolean' ? args.mediaItems : undefined;
+        const include = args.include || undefined;
+        if (!contractAddress) {
+            return { error: 'NFT contract address is required.' };
+        }
+        if (!tokenId) {
+            return { error: 'Token ID is required.' };
+        }
+        const result = await this.service.getNftMetadata({
+            address: contractAddress,
+            tokenId,
+            chain,
+            format,
+            normalizeMetadata,
+            mediaItems,
+            include,
+        });
+        if (!result.success) {
+            return { error: result.error || 'Failed to fetch NFT metadata' };
+        }
+        const data = result.data;
+        if (!data) {
+            return { error: 'NFT not found' };
+        }
+        const normalized = data.normalized_metadata;
+        const media = data.media;
+        return {
+            chain: chain,
+            contractAddress: data.token_address,
+            tokenId: data.token_id,
+            contractType: data.contract_type,
+            amount: data.amount,
+            owner: data.owner_of,
+            minter: data.minter_address,
+            blockNumber: data.block_number,
+            blockNumberMinted: data.block_number_minted,
+            tokenHash: data.token_hash,
+            name: normalized?.name || data.name,
+            description: normalized?.description,
+            image: normalized?.image || media?.original_media_url,
+            animationUrl: normalized?.animation_url,
+            attributes: normalized?.attributes,
+            tokenUri: data.token_uri,
+            metadata: data.metadata,
+            collection: {
+                name: data.name,
+                symbol: data.symbol,
+                logo: data.collection_logo,
+                banner: data.collection_banner_image,
+                category: data.collection_category,
+                projectUrl: data.project_url,
+                wikiUrl: data.wiki_url,
+                discordUrl: data.discord_url,
+                telegramUrl: data.telegram_url,
+                twitter: data.twitter_username,
+                instagram: data.instagram_username,
+            },
+            media: media
+                ? {
+                    mimetype: media.mimetype,
+                    status: media.status,
+                    originalUrl: media.original_media_url,
+                    previews: media.media_collection,
+                    updatedAt: media.updated_at,
+                }
+                : undefined,
+            floorPrice: data.floor_price,
+            floorPriceUsd: data.floor_price_usd,
+            floorPriceCurrency: data.floor_price_currency,
+            rarityRank: data.rarity_rank,
+            rarityPercentage: data.rarity_percentage,
+            rarityLabel: data.rarity_label,
+            verifiedCollection: data.verified_collection,
+            possibleSpam: data.possible_spam,
+            lastMetadataSync: data.last_metadata_sync,
+            lastTokenUriSync: data.last_token_uri_sync,
+        };
+    }
+}
+exports.NFTMetadataTool = NFTMetadataTool;
+//# sourceMappingURL=NFTMetadataTool.js.map

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

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

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

@@ -0,0 +1,82 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig } from '../../../services/MoralisService';
+export type WalletNFTsToolConfig = MoralisServiceConfig;
+interface NormalizedNftAttribute {
+    trait_type: string;
+    value: string;
+}
+interface NormalizedNftMedia {
+    original?: string;
+    low?: string;
+    medium?: string;
+    high?: string;
+    mimetype?: string;
+    status?: string;
+}
+interface NormalizedNft {
+    name: string | null;
+    collectionName: string | null;
+    symbol: string | null;
+    tokenId: string;
+    contractAddress: string;
+    contractType: 'ERC721' | 'ERC1155' | string;
+    amount: string;
+    ownerOf: string;
+    tokenHash: string;
+    tokenUri: string | null;
+    description: string | null;
+    image: string | null;
+    animationUrl: string | null;
+    media: NormalizedNftMedia;
+    attributes: NormalizedNftAttribute[];
+    verifiedCollection: boolean;
+    possibleSpam: boolean;
+    collectionLogo: string | null;
+    collectionBanner: string | null;
+    blockNumber: string;
+    blockNumberMinted: string;
+}
+interface WalletNFTsResult {
+    walletAddress: string;
+    chain: string;
+    filters: {
+        contractAddresses: string[] | null;
+        excludeSpam: boolean;
+        includePrices: boolean;
+        limit: number;
+        cursor: string | null;
+    };
+    pagination: {
+        cursor: string | null;
+        pageSize: number;
+        page: number | null;
+        hasMore: boolean;
+    };
+    nftCount: number;
+    nfts: NormalizedNft[];
+}
+/**
+ * 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.
+ */
+export declare class WalletNFTsTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: WalletNFTsToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<WalletNFTsResult | {
+        error: string;
+    }>;
+    private normalize;
+}
+export {};
+//# sourceMappingURL=WalletNFTsTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletNFTsTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/WalletNFTsTool.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,EAAgB,MAAM,kCAAkC,CAAC;AAE3G,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAExD,UAAU,sBAAsB;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,gBAAgB;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,iBAAiB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACnC,WAAW,EAAE,OAAO,CAAC;QACrB,aAAa,EAAE,OAAO,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAqB;IACzB,WAAW,SAMuE;IAClF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAmDzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,oBAAoB;cAKzB,GAAG,CACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA2DhD,OAAO,CAAC,SAAS;CA0ClB"}