@covalenthq/goldrush-mcp-server 0.0.1

package/dist/services/BaseService.js

@@ -0,0 +1,170 @@
+import { validQuoteValues } from "../utils/constants.js";
+import { stringifyWithBigInt } from "../utils/helpers.js";
+import { ChainName, } from "@covalenthq/client-sdk";
+import { z } from "zod";
+export function addBaseServiceTools(server, goldRushClient) {
+    server.tool("gas_prices", "Get real-time gas estimates for different transaction speeds on a specific network, enabling users to optimize transaction costs and confirmation times. " +
+        "Requires chainName (blockchain network) and eventType (erc20, nativetokens, or uniswapv3). " +
+        "Optional parameter quoteCurrency allows conversion to different currencies (USD, EUR, etc). " +
+        "Returns estimated gas prices for low, medium, and high priority transactions for the specified event type.", {
+        chainName: z.enum(Object.values(ChainName)),
+        eventType: z.enum(["erc20", "nativetokens", "uniswapv3"]),
+        quoteCurrency: z
+            .enum(Object.values(validQuoteValues))
+            .optional(),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.BaseService.getGasPrices(params.chainName, params.eventType, {
+                quoteCurrency: params.quoteCurrency,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("block", "Commonly used to fetch and render a single block for a block explorer." +
+        "Requires chainName (blockchain network) and blockHeight (block number). " +
+        "Returns comprehensive block data including timestamp, transaction count, size, " +
+        "miner information, and other blockchain-specific details.", {
+        chainName: z.enum(Object.values(ChainName)),
+        blockHeight: z.string(),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.BaseService.getBlock(params.chainName, params.blockHeight);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("block_heights", "Commonly used to get all the block heights within a particular date range. " +
+        "Requires chainName (blockchain network), startDate (YYYY-MM-DD format), and endDate (YYYY-MM-DD or 'latest'). " +
+        "Optional pagination parameters include pageSize (default 10) and pageNumber (default 0). " +
+        "Returns block heights, timestamps, and related data for blocks within the specified date range, " +
+        "useful for historical analysis and time-based blockchain queries.", {
+        chainName: z.enum(Object.values(ChainName)),
+        startDate: z.string(),
+        endDate: z.union([z.string(), z.literal("latest")]),
+        pageSize: z.number().optional().default(10),
+        pageNumber: z.number().optional().default(0),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.BaseService.getBlockHeightsByPage(params.chainName, params.startDate, params.endDate, {
+                pageSize: params.pageSize,
+                pageNumber: params.pageNumber,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("log_events_by_address", "Commonly used to get all the event logs emitted from a particular contract address. " +
+        "Useful for building dashboards that examine on-chain interactions." +
+        "Requires chainName (blockchain network) and contractAddress (the address emitting events). " +
+        "Optional parameters include block range (startingBlock, endingBlock) and pagination settings " +
+        "(pageSize default 10, pageNumber default 0). " +
+        "Returns decoded event logs for the specified contract, useful for monitoring specific " +
+        "smart contract activity and analyzing on-chain events.", {
+        chainName: z.enum(Object.values(ChainName)),
+        contractAddress: z.string(),
+        startingBlock: z.union([z.string(), z.number()]).optional(),
+        endingBlock: z.union([z.string(), z.number()]).optional(),
+        pageSize: z.number().optional().default(10),
+        pageNumber: z.number().optional().default(0),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.BaseService.getLogEventsByAddressByPage(params.chainName, params.contractAddress, {
+                startingBlock: params.startingBlock,
+                endingBlock: params.endingBlock,
+                pageSize: params.pageSize,
+                pageNumber: params.pageNumber,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("log_events_by_topic", "Commonly used to get all event logs of the same topic hash across all contracts within a particular chain. " +
+        "Useful for cross-sectional analysis of event logs that are emitted on-chain." +
+        "Requires chainName (blockchain network) and topicHash (the event signature hash). " +
+        "Optional parameters include block range (startingBlock, endingBlock), secondaryTopics for " +
+        "filtering by additional parameters, and pagination settings (pageSize default 10, pageNumber default 0). " +
+        "Returns decoded event logs matching the specified topic hash, ideal for tracking specific " +
+        "event types across multiple contracts on a blockchain.", {
+        chainName: z.enum(Object.values(ChainName)),
+        topicHash: z.string(),
+        startingBlock: z.union([z.string(), z.number()]).optional(),
+        endingBlock: z.union([z.string(), z.number()]).optional(),
+        secondaryTopics: z.string().optional(),
+        pageSize: z.number().optional().default(10),
+        pageNumber: z.number().optional().default(0),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.BaseService.getLogEventsByTopicHashByPage(params.chainName, params.topicHash, {
+                startingBlock: params.startingBlock,
+                endingBlock: params.endingBlock,
+                secondaryTopics: params.secondaryTopics,
+                pageSize: params.pageSize,
+                pageNumber: params.pageNumber,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=BaseService.js.map

package/dist/services/BaseService.js.map

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

package/dist/services/BitcoinService.d.ts

@@ -0,0 +1,4 @@
+import type { GoldRushClient } from "@covalenthq/client-sdk";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function addBitcoinServiceTools(server: McpServer, goldRushClient: GoldRushClient): void;
+//# sourceMappingURL=BitcoinService.d.ts.map

package/dist/services/BitcoinService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitcoinService.d.ts","sourceRoot":"","sources":["../../src/services/BitcoinService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAS,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBzE,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,QAsHjC"}

package/dist/services/BitcoinService.js

@@ -0,0 +1,97 @@
+import { validQuoteValues } from "../utils/constants.js";
+import { stringifyWithBigInt } from "../utils/helpers.js";
+import { z } from "zod";
+export function addBitcoinServiceTools(server, goldRushClient) {
+    server.tool("bitcoin_hd_wallet_balances", "Fetch balances for each active child address derived from a Bitcoin HD wallet.\n" +
+        "This tool provides detailed balance data for Bitcoin wallets identified by an xpub key.\n" +
+        "Required: walletAddress - The xpub key of the HD wallet.\n" +
+        "Optional: quoteCurrency - The currency for price conversion (USD, EUR, etc).\n" +
+        "Returns complete balance details including total balance, available balance, and transaction history summary.", {
+        walletAddress: z.string(),
+        quoteCurrency: z
+            .enum(Object.values(validQuoteValues))
+            .optional(),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.BitcoinService.getBitcoinHdWalletBalances(params.walletAddress, {
+                quoteCurrency: params.quoteCurrency,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("bitcoin_transactions", "Used to fetch the full transaction history of a Bitcoin wallet.\n" +
+        "Required: address - The Bitcoin address to query transactions for.\n" +
+        "Optional: pageSize - Number of results per page (default: 10).\n" +
+        "Optional: pageNumber - Page number for pagination (default: 0, first page).\n" +
+        "Returns comprehensive transaction details including timestamps, amounts, and transaction IDs.", {
+        address: z.string(),
+        pageSize: z.number().optional().default(10),
+        pageNumber: z.number().optional().default(0),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.BitcoinService.getTransactionsForBtcAddress({
+                address: params.address,
+                pageSize: params.pageSize,
+                pageNumber: params.pageNumber,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("bitcoin_non_hd_wallet_balances", "Fetch Bitcoin balance for a non-HD address. Response includes spot prices and other metadata.\n" +
+        "This tool provides detailed balance data for regular Bitcoin addresses.\n" +
+        "Required: walletAddress - The Bitcoin address to query.\n" +
+        "Optional: quoteCurrency - The currency for price conversion (USD, EUR, etc).\n" +
+        "Returns complete balance details including total balance, available balance, and transaction count.", {
+        walletAddress: z.string(),
+        quoteCurrency: z
+            .enum(Object.values(validQuoteValues))
+            .optional(),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.BitcoinService.getBitcoinNonHdWalletBalances(params.walletAddress, {
+                quoteCurrency: params.quoteCurrency,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=BitcoinService.js.map

package/dist/services/BitcoinService.js.map

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

package/dist/services/NftService.d.ts

@@ -0,0 +1,4 @@
+import { type GoldRushClient } from "@covalenthq/client-sdk";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function addNftServiceTools(server: McpServer, goldRushClient: GoldRushClient): void;
+//# sourceMappingURL=NftService.d.ts.map

package/dist/services/NftService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NftService.d.ts","sourceRoot":"","sources":["../../src/services/NftService.ts"],"names":[],"mappings":"AACA,OAAO,EAGH,KAAK,cAAc,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,QA0FjC"}

package/dist/services/NftService.js

@@ -0,0 +1,70 @@
+import { stringifyWithBigInt } from "../utils/helpers.js";
+import { ChainName, } from "@covalenthq/client-sdk";
+import { z } from "zod";
+export function addNftServiceTools(server, goldRushClient) {
+    server.tool("nft_for_address", "Commonly used to render the NFTs (including ERC721 and ERC1155) held by an address.\n" +
+        "Required: chainName (blockchain network name), walletAddress (wallet address or ENS/domain).\n" +
+        "Optional: noSpam (filter spam, default true), noNftAssetMetadata (exclude metadata for faster response, default true), " +
+        "withUncached (fetch uncached metadata, may be slower, default false).\n" +
+        "Returns complete details of NFTs in the wallet including metadata.", {
+        chainName: z.enum(Object.values(ChainName)),
+        walletAddress: z.string(),
+        noSpam: z.boolean().optional().default(true),
+        noNftAssetMetadata: z.boolean().optional().default(true),
+        withUncached: z.boolean().optional().default(false),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.NftService.getNftsForAddress(params.chainName, params.walletAddress, {
+                noSpam: params.noSpam,
+                noNftAssetMetadata: params.noNftAssetMetadata,
+                withUncached: params.withUncached,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("nft_check_ownership", "Commonly used to verify ownership of NFTs (including ERC-721 and ERC-1155) within a collection.\n" +
+        "Required: chainName (blockchain network), walletAddress (wallet address), collectionContract (NFT collection).\n" +
+        "Optional: traitsFilter (filter by trait types), valuesFilter (filter by trait values).\n" +
+        "Returns ownership status and matching NFTs if owned.", {
+        chainName: z.enum(Object.values(ChainName)),
+        walletAddress: z.string(),
+        collectionContract: z.string(),
+        traitsFilter: z.string().optional(),
+        valuesFilter: z.string().optional(),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.NftService.checkOwnershipInNft(params.chainName, params.walletAddress, params.collectionContract, {
+                traitsFilter: params.traitsFilter,
+                valuesFilter: params.valuesFilter,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=NftService.js.map

package/dist/services/NftService.js.map

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

package/dist/services/PricingService.d.ts

@@ -0,0 +1,4 @@
+import { type GoldRushClient } from "@covalenthq/client-sdk";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function addPricingServiceTools(server: McpServer, goldRushClient: GoldRushClient): void;
+//# sourceMappingURL=PricingService.d.ts.map

package/dist/services/PricingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PricingService.d.ts","sourceRoot":"","sources":["../../src/services/PricingService.ts"],"names":[],"mappings":"AAEA,OAAO,EAGH,KAAK,cAAc,EAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,QAiDjC"}

package/dist/services/PricingService.js

@@ -0,0 +1,40 @@
+import { validQuoteValues } from "../utils/constants.js";
+import { stringifyWithBigInt } from "../utils/helpers.js";
+import { ChainName, } from "@covalenthq/client-sdk";
+import { z } from "zod";
+export function addPricingServiceTools(server, goldRushClient) {
+    server.tool("historical_token_prices", "Commonly used to get historic prices of a token between date ranges. Supports native tokens.\n" +
+        "Required: chainName (blockchain network), quoteCurrency (price currency), contractAddress (token contract), from (start date YYYY-MM-DD), to (end date YYYY-MM-DD).\n" +
+        "Optional: pricesAtAsc (set to true for chronological ascending order, default is false for descending order).\n" +
+        "Returns historical token prices for the specified time range.", {
+        chainName: z.enum(Object.values(ChainName)),
+        quoteCurrency: z.enum(Object.values(validQuoteValues)),
+        contractAddress: z.string(),
+        from: z.string(),
+        to: z.string(),
+        pricesAtAsc: z.boolean().optional(),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.PricingService.getTokenPrices(params.chainName, params.quoteCurrency, params.contractAddress, {
+                from: params.from,
+                to: params.to,
+                pricesAtAsc: params.pricesAtAsc,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=PricingService.js.map

package/dist/services/PricingService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PricingService.js","sourceRoot":"","sources":["../../src/services/PricingService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAEH,SAAS,GAGZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,MAAM,UAAU,sBAAsB,CAClC,MAAiB,EACjB,cAA8B;IAE9B,MAAM,CAAC,IAAI,CACP,yBAAyB,EACzB,gGAAgG;QAC5F,uKAAuK;QACvK,iHAAiH;QACjH,+DAA+D,EACnE;QACI,SAAS,EAAE,CAAC,CAAC,IAAI,CACb,MAAM,CAAC,MAAM,CAAC,SAAS,CAA0B,CACpD;QACD,aAAa,EAAE,CAAC,CAAC,IAAI,CACjB,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAA0B,CAC3D;QACD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACtC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACb,IAAI,CAAC;YACD,MAAM,QAAQ,GACV,MAAM,cAAc,CAAC,cAAc,CAAC,cAAc,CAC9C,MAAM,CAAC,SAAkB,EACzB,MAAM,CAAC,aAAsB,EAC7B,MAAM,CAAC,eAAe,EACtB;gBACI,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,WAAW,EAAE,MAAM,CAAC,WAAW;aAClC,CACJ,CAAC;YACN,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC;qBAC3C;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC;gBACpD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/services/SecurityService.d.ts

@@ -0,0 +1,4 @@
+import { type GoldRushClient } from "@covalenthq/client-sdk";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function addSecurityServiceTools(server: McpServer, goldRushClient: GoldRushClient): void;
+//# sourceMappingURL=SecurityService.d.ts.map

package/dist/services/SecurityService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecurityService.d.ts","sourceRoot":"","sources":["../../src/services/SecurityService.ts"],"names":[],"mappings":"AACA,OAAO,EAGH,KAAK,cAAc,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,wBAAgB,uBAAuB,CACnC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,QAoCjC"}

package/dist/services/SecurityService.js

@@ -0,0 +1,30 @@
+import { stringifyWithBigInt } from "../utils/helpers.js";
+import { ChainName, } from "@covalenthq/client-sdk";
+import { z } from "zod";
+export function addSecurityServiceTools(server, goldRushClient) {
+    server.tool("token_approvals", "Commonly used to get a list of approvals across all token contracts categorized by spenders for a wallet's assets.\n" +
+        "Required: chainName (blockchain network, e.g. eth-mainnet or 1), walletAddress (wallet address, supports ENS, RNS, Lens Handle, or Unstoppable Domain).\n" +
+        "Returns a list of ERC20 token approvals and their associated security risk levels.", {
+        chainName: z.enum(Object.values(ChainName)),
+        walletAddress: z.string(),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.SecurityService.getApprovals(params.chainName, params.walletAddress);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=SecurityService.js.map

package/dist/services/SecurityService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecurityService.js","sourceRoot":"","sources":["../../src/services/SecurityService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAEH,SAAS,GAEZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,MAAM,UAAU,uBAAuB,CACnC,MAAiB,EACjB,cAA8B;IAE9B,MAAM,CAAC,IAAI,CACP,iBAAiB,EACjB,sHAAsH;QAClH,2JAA2J;QAC3J,oFAAoF,EACxF;QACI,SAAS,EAAE,CAAC,CAAC,IAAI,CACb,MAAM,CAAC,MAAM,CAAC,SAAS,CAA0B,CACpD;QACD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC5B,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACb,IAAI,CAAC;YACD,MAAM,QAAQ,GACV,MAAM,cAAc,CAAC,eAAe,CAAC,YAAY,CAC7C,MAAM,CAAC,SAAkB,EACzB,MAAM,CAAC,aAAa,CACvB,CAAC;YACN,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC;qBAC3C;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC;gBACpD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/services/TransactionService.d.ts

@@ -0,0 +1,4 @@
+import { type GoldRushClient } from "@covalenthq/client-sdk";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function addTransactionServiceTools(server: McpServer, goldRushClient: GoldRushClient): void;
+//# sourceMappingURL=TransactionService.d.ts.map

package/dist/services/TransactionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionService.d.ts","sourceRoot":"","sources":["../../src/services/TransactionService.ts"],"names":[],"mappings":"AAEA,OAAO,EAGH,KAAK,cAAc,EAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAezE,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,QAkMjC"}

package/dist/services/TransactionService.js

@@ -0,0 +1,150 @@
+import { validQuoteValues } from "../utils/constants.js";
+import { stringifyWithBigInt } from "../utils/helpers.js";
+import { ChainName, } from "@covalenthq/client-sdk";
+import { z } from "zod";
+export function addTransactionServiceTools(server, goldRushClient) {
+    server.tool("transaction", "Commonly used to fetch and render a single transaction including its decoded log events.\n" +
+        "Required: chainName (blockchain network), txHash (transaction hash).\n" +
+        "Optional: quoteCurrency (currency to convert to, USD by default), " +
+        "noLogs (exclude event logs, true by default), " +
+        "withInternal (include internal transactions, false by default), " +
+        "withState (include state changes, false by default), " +
+        "withInputData (include input data, false by default).\n" +
+        "Tracing features (withInternal, withState, withInputData) supported on the following chains: eth-mainnet\n" +
+        "Returns comprehensive details about the specified transaction.", {
+        chainName: z.enum(Object.values(ChainName)),
+        txHash: z.string(),
+        quoteCurrency: z
+            .enum(Object.values(validQuoteValues))
+            .optional(),
+        noLogs: z.boolean().optional().default(true),
+        withInternal: z.boolean().optional(),
+        withState: z.boolean().optional(),
+        withInputData: z.boolean().optional(),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.TransactionService.getTransaction(params.chainName, params.txHash, {
+                quoteCurrency: params.quoteCurrency,
+                noLogs: params.noLogs,
+                withInternal: params.withInternal,
+                withState: params.withState,
+                withInputData: params.withInputData,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("transaction_summary", "Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet.\n" +
+        "Required: chainName (blockchain network), walletAddress (wallet address).\n" +
+        "Optional: quoteCurrency, withGas (include gas usage statistics).\n" +
+        "Returns summary of transaction activity for the specified wallet.", {
+        chainName: z.enum(Object.values(ChainName)),
+        walletAddress: z.string(),
+        quoteCurrency: z
+            .enum(Object.values(validQuoteValues))
+            .optional(),
+        withGas: z.boolean().optional(),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.TransactionService.getTransactionSummary(params.chainName, params.walletAddress, {
+                quoteCurrency: params.quoteCurrency,
+                withGas: params.withGas,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("transactions_for_address", "Commonly used to fetch and render the most recent transactions involving an address.\n" +
+        "Required: chainName (blockchain network), walletAddress (wallet address), page (page number).\n" +
+        "Optional: quoteCurrency, noLogs, blockSignedAtAsc (chronological order).\n" +
+        "Returns transactions for the specified page of results.", {
+        chainName: z.enum(Object.values(ChainName)),
+        walletAddress: z.string(),
+        page: z.number(),
+        quoteCurrency: z
+            .enum(Object.values(validQuoteValues))
+            .optional(),
+        noLogs: z.boolean().optional().default(true),
+        blockSignedAtAsc: z.boolean().optional(),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.TransactionService.getPaginatedTransactionsForAddress(params.chainName, params.walletAddress, params.page, {
+                quoteCurrency: params.quoteCurrency,
+                noLogs: params.noLogs,
+                blockSignedAtAsc: params.blockSignedAtAsc,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("transactions_for_block", "Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.\n" +
+        "Required: chainName (blockchain network), blockHeight (block number or latest).\n" +
+        "Optional: quoteCurrency, noLogs (exclude event logs).\n" +
+        "Returns all transactions from the specified block.", {
+        chainName: z.enum(Object.values(ChainName)),
+        blockHeight: z.union([z.string(), z.number(), z.literal("latest")]),
+        page: z.number(),
+        quoteCurrency: z
+            .enum(Object.values(validQuoteValues))
+            .optional(),
+        noLogs: z.boolean().optional(),
+    }, async (params) => {
+        try {
+            const response = await goldRushClient.TransactionService.getTransactionsForBlockByPage(params.chainName, params.blockHeight, params.page, {
+                quoteCurrency: params.quoteCurrency,
+                noLogs: params.noLogs,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyWithBigInt(response.data),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=TransactionService.js.map