@mentaproject/core 0.5.12 → 0.5.13

package/dist/actions/index.d.ts

@@ -1,7 +1,9 @@
 export * from "viem/actions";
-export { sendTransaction, signMessage, signTypedData, writeContract } from "permissionless/actions/smartAccount";
+export { sendTransaction, signMessage, signTypedData, writeContract, } from "permissionless/actions/smartAccount";
 /** Trace Actions */
 export { traceFilter } from "./traceFilter";
 export { traceTransaction } from "./traceTransaction";
+export { traceActions } from "./traceActions";
+export type { TraceActions } from "./traceActions";
 /** Block Range Actions */
 export { fetchByBlockRange } from "./fetchByBlockRange";

package/dist/actions/index.js

@@ -14,7 +14,7 @@ var smartAccount = require('permissionless/actions/smartAccount');
  * NOTE: This method relies on the non-standard 'trace_filter' method of the RPC.
  * It may not be supported by all nodes.
  *
- * @param client The CoreClient instance used to perform the RPC call.
+ * @param client The client instance used to perform the RPC call.
  * @param params The filtering parameters for the trace request (block range, addresses, etc.).
  * @returns A promise that returns an array of trace entries (GenericTraceEntry[])
  * that match the filtering criteria.
@@ -25,7 +25,7 @@ async function traceFilter(client, params) {
     if (typeof params.toAddress === "string")
         params.toAddress = [params.toAddress];
     return await client.request({
-        method: 'trace_filter',
+        method: "trace_filter",
         params: [params],
     });
 }
@@ -41,18 +41,25 @@ async function traceFilter(client, params) {
  * NOTE: This method relies on the non-standard 'trace_transaction' method of the RPC.
  * It may not be supported by all nodes.
  *
- * @param client The CoreClient instance used to perform the RPC call.
+ * @param client The client instance used to perform the RPC call.
  * @param params The transaction hash for which to retrieve traces.
  * @returns A promise that returns an array of trace entries (GenericTraceEntry[])
  * for the specified transaction hash.
  */
 async function traceTransaction(client, params) {
     return await client.request({
-        method: 'trace_transaction',
+        method: "trace_transaction",
         params: [params],
     });
 }
 
+function traceActions() {
+    return (client) => ({
+        traceFilter: (args) => traceFilter(client, args),
+        traceTransaction: (args) => traceTransaction(client, args),
+    });
+}
+
 function calcBlockRange(fromBlock, rangeSize, direction = "forward") {
     if (direction === "backward")
         return { fromBlock: fromBlock - BigInt(rangeSize), toBlock: fromBlock };
@@ -161,6 +168,7 @@ Object.defineProperty(exports, "writeContract", {
     get: function () { return smartAccount.writeContract; }
 });
 exports.fetchByBlockRange = fetchByBlockRange;
+exports.traceActions = traceActions;
 exports.traceFilter = traceFilter;
 exports.traceTransaction = traceTransaction;
 Object.keys(actions).forEach(function (k) {

package/dist/actions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/actions/traceFilter.ts","../../src/actions/traceTransaction.ts","../../src/actions/fetchByBlockRange.ts"],"sourcesContent":["import  type { TraceFilterParameters, TraceFilterReturnType, CoreClient, Hash } from \"../types\";\n\n/**\n * Calls the 'trace_filter' RPC method to retrieve execution traces\n * filtered according to the specified criteria.\n *\n * This function sends a JSON-RPC request to the Ethereum node (or EVM-compatible)\n * via the provided client object and returns the array of trace entries matching\n * the filters.\n * \n * NOTE: This method relies on the non-standard 'trace_filter' method of the RPC.\n * It may not be supported by all nodes.\n *\n * @param client The CoreClient instance used to perform the RPC call.\n * @param params The filtering parameters for the trace request (block range, addresses, etc.).\n * @returns A promise that returns an array of trace entries (GenericTraceEntry[])\n * that match the filtering criteria.\n */\nexport async function traceFilter(client: CoreClient, params: TraceFilterParameters): Promise<TraceFilterReturnType> {\n    if (typeof params.fromAddress === \"string\") params.fromAddress = [params.fromAddress];\n    if (typeof params.toAddress === \"string\") params.toAddress = [params.toAddress];\n    \n    return await client.request<{\n        method: 'trace_filter',\n        Parameters: TraceFilterParameters[],\n        ReturnType: TraceFilterReturnType\n    }>({\n        method: 'trace_filter',\n        params: [params],\n    });\n}","import  type { TraceTransactionParameters, TraceTransactionReturnType, CoreClient, Hash } from \"../types\";\n\n/**\n * Calls the 'trace_transaction' RPC method to retrieve execution traces\n * for a specific transaction hash.\n *\n * This function sends a JSON-RPC request to the Ethereum node (or EVM-compatible)\n * via the provided client object and returns the array of trace entries for\n * the specified transaction hash.\n * \n * NOTE: This method relies on the non-standard 'trace_transaction' method of the RPC.\n * It may not be supported by all nodes.\n * \n * @param client The CoreClient instance used to perform the RPC call.\n * @param params The transaction hash for which to retrieve traces.\n * @returns A promise that returns an array of trace entries (GenericTraceEntry[])\n * for the specified transaction hash.\n */\nexport async function traceTransaction(client: CoreClient, params: TraceTransactionParameters): Promise<TraceTransactionReturnType> {\n    return await client.request<{\n        method: 'trace_transaction',\n        Parameters: TraceTransactionParameters[],\n        ReturnType: TraceTransactionReturnType\n    }>({\n        method: 'trace_transaction',\n        params: [params],\n    });\n}","import { FetchBlockRangeParameters } from \"../types/BlockRangeFetcher\";\n\nfunction calcBlockRange(fromBlock: bigint, rangeSize: number, direction: \"backward\" | \"forward\" = \"forward\") {\n    if (direction === \"backward\") return { fromBlock: fromBlock - BigInt(rangeSize), toBlock: fromBlock };\n    return { fromBlock: fromBlock, toBlock: fromBlock + BigInt(rangeSize) };\n};\n\nfunction hasHitBlockLimit(blockNumber: bigint, direction: \"backward\" | \"forward\", blockLimit: bigint) {\n    return direction === \"backward\" ? blockNumber < blockLimit : blockNumber > blockLimit;\n};\n\nfunction hasHitItemLimit(items: any[], itemLimit: number) {\n    return items.length >= itemLimit;\n};\n\n/**\n * Fetch large amounts of data in batches by exploring with dynamic block ranges.\n * \n * Block ranges automatically adjust based on the provided configuration and how many items are found per batch. \n * If the actual block range returns too many items, the explorer will automatically reduce the range size for the next batch. \n * If the actual block range returns too few items, the explorer will automatically increase the range size for the next batch.\n * \n * This method is optimized to maximize efficiency by fetching items and minimizing the charge on the RPC node by \n * requesting too many items per batch or too many batches per second.\n * \n * Useful for methods like `eth_getLogs` or `trace_filter` that iterate over blocks to find items.\n * \n * @param params - The parameters for creating the explorer.\n */\nexport async function fetchByBlockRange(params: FetchBlockRangeParameters) {\n    const options = {\n\n        // By how much to increase/decrease the range size if the batch returns few/many items\n        dividerOnHigh: 2,\n        multiplierOnLow: 1.5,\n        multiplierOnZero: 2,\n\n        // How to determine if the batch returned few/many items\n        highActivityThreshold: 50,\n        lowActivityThreshold: 10,\n\n        // Limits and init values for the range size\n        initialRangeSize: 100,\n        maxRangeSize: 100_000,\n        minRangeSize: 1,\n\n        // \n        ...params.options,\n    };\n\n    let currentBlock = params.fromBlock;\n    let rangeSize = options.initialRangeSize;\n    let stopped = false;\n\n    const stop = () => {\n        stopped = true;\n    };\n\n    const totalItems: any[] = [];\n\n    function shouldStop() {\n        return hasHitBlockLimit(currentBlock, params.direction, params.toBlock) || hasHitItemLimit(totalItems, params.itemLimit);\n    }\n\n    while (!stopped && !shouldStop() ) {\n        const blockRange = calcBlockRange(currentBlock, rangeSize, params.direction);\n\n        // Cap the block range to the overall limits\n        if (params.direction === \"forward\") {\n            if (blockRange.toBlock > params.toBlock) {\n                blockRange.toBlock = params.toBlock;\n            }\n        } else { // backward\n            if (blockRange.fromBlock < params.toBlock) {\n                blockRange.fromBlock = params.toBlock;\n            }\n        }\n\n        const batchItems = await params.onBlockRange(blockRange, stop);\n\n        totalItems.push(...batchItems);\n\n        if (stopped) break;\n\n        // Adjust range size based on activity\n        if (batchItems.length > options.highActivityThreshold) {\n            rangeSize /= options.dividerOnHigh;\n        } else if (batchItems.length === 0) {\n            rangeSize *= options.multiplierOnZero;\n        } else if (batchItems.length <= options.lowActivityThreshold) {\n            rangeSize *= options.multiplierOnLow;\n        }\n\n        // Cap and round the range size\n        rangeSize = Math.round(\n            Math.max(options.minRangeSize, Math.min(options.maxRangeSize, rangeSize))\n        );\n\n        // Determine the next block to start from, fixing the \"backward\" direction logic\n        if (params.direction === \"backward\") {\n            currentBlock = blockRange.fromBlock - 1n;\n        } else {\n            currentBlock = blockRange.toBlock + 1n;\n        }\n    }\n\n    return totalItems.slice(0, params.itemLimit);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/actions/traceFilter.ts","../../src/actions/traceTransaction.ts","../../src/actions/traceActions.ts","../../src/actions/fetchByBlockRange.ts"],"sourcesContent":["import type { Client, Transport, Chain } from \"viem\";\nimport type { TraceFilterParameters, TraceFilterReturnType } from \"../types\";\n\n/**\n * Calls the 'trace_filter' RPC method to retrieve execution traces\n * filtered according to the specified criteria.\n *\n * This function sends a JSON-RPC request to the Ethereum node (or EVM-compatible)\n * via the provided client object and returns the array of trace entries matching\n * the filters.\n *\n * NOTE: This method relies on the non-standard 'trace_filter' method of the RPC.\n * It may not be supported by all nodes.\n *\n * @param client The client instance used to perform the RPC call.\n * @param params The filtering parameters for the trace request (block range, addresses, etc.).\n * @returns A promise that returns an array of trace entries (GenericTraceEntry[])\n * that match the filtering criteria.\n */\nexport async function traceFilter<TChain extends Chain | undefined>(\n  client: Client<Transport, TChain>,\n  params: TraceFilterParameters,\n): Promise<TraceFilterReturnType> {\n  if (typeof params.fromAddress === \"string\")\n    params.fromAddress = [params.fromAddress];\n  if (typeof params.toAddress === \"string\")\n    params.toAddress = [params.toAddress];\n\n  return await client.request<{\n    method: \"trace_filter\";\n    Parameters: TraceFilterParameters[];\n    ReturnType: TraceFilterReturnType;\n  }>({\n    method: \"trace_filter\",\n    params: [params],\n  });\n}\n","import type { Client, Transport, Chain } from \"viem\";\nimport type {\n  TraceTransactionParameters,\n  TraceTransactionReturnType,\n} from \"../types\";\n\n/**\n * Calls the 'trace_transaction' RPC method to retrieve execution traces\n * for a specific transaction hash.\n *\n * This function sends a JSON-RPC request to the Ethereum node (or EVM-compatible)\n * via the provided client object and returns the array of trace entries for\n * the specified transaction hash.\n *\n * NOTE: This method relies on the non-standard 'trace_transaction' method of the RPC.\n * It may not be supported by all nodes.\n *\n * @param client The client instance used to perform the RPC call.\n * @param params The transaction hash for which to retrieve traces.\n * @returns A promise that returns an array of trace entries (GenericTraceEntry[])\n * for the specified transaction hash.\n */\nexport async function traceTransaction<TChain extends Chain | undefined>(\n  client: Client<Transport, TChain>,\n  params: TraceTransactionParameters,\n): Promise<TraceTransactionReturnType> {\n  return await client.request<{\n    method: \"trace_transaction\";\n    Parameters: TraceTransactionParameters[];\n    ReturnType: TraceTransactionReturnType;\n  }>({\n    method: \"trace_transaction\",\n    params: [params],\n  });\n}\n","import type { Chain, Client, Transport } from \"viem\";\nimport type {\n  TraceFilterParameters,\n  TraceFilterReturnType,\n  TraceTransactionParameters,\n  TraceTransactionReturnType,\n} from \"../types\";\nimport { traceFilter } from \"./traceFilter\";\nimport { traceTransaction } from \"./traceTransaction\";\n\nexport type TraceActions = {\n  traceFilter: (args: TraceFilterParameters) => Promise<TraceFilterReturnType>;\n  traceTransaction: (\n    args: TraceTransactionParameters,\n  ) => Promise<TraceTransactionReturnType>;\n};\n\nexport function traceActions(): <TChain extends Chain | undefined>(\n  client: Client<Transport, TChain>,\n) => TraceActions {\n  return (client) => ({\n    traceFilter: (args) => traceFilter(client, args),\n    traceTransaction: (args) => traceTransaction(client, args),\n  });\n}\n","import { FetchBlockRangeParameters } from \"../types/BlockRangeFetcher\";\n\nfunction calcBlockRange(fromBlock: bigint, rangeSize: number, direction: \"backward\" | \"forward\" = \"forward\") {\n    if (direction === \"backward\") return { fromBlock: fromBlock - BigInt(rangeSize), toBlock: fromBlock };\n    return { fromBlock: fromBlock, toBlock: fromBlock + BigInt(rangeSize) };\n};\n\nfunction hasHitBlockLimit(blockNumber: bigint, direction: \"backward\" | \"forward\", blockLimit: bigint) {\n    return direction === \"backward\" ? blockNumber < blockLimit : blockNumber > blockLimit;\n};\n\nfunction hasHitItemLimit(items: any[], itemLimit: number) {\n    return items.length >= itemLimit;\n};\n\n/**\n * Fetch large amounts of data in batches by exploring with dynamic block ranges.\n * \n * Block ranges automatically adjust based on the provided configuration and how many items are found per batch. \n * If the actual block range returns too many items, the explorer will automatically reduce the range size for the next batch. \n * If the actual block range returns too few items, the explorer will automatically increase the range size for the next batch.\n * \n * This method is optimized to maximize efficiency by fetching items and minimizing the charge on the RPC node by \n * requesting too many items per batch or too many batches per second.\n * \n * Useful for methods like `eth_getLogs` or `trace_filter` that iterate over blocks to find items.\n * \n * @param params - The parameters for creating the explorer.\n */\nexport async function fetchByBlockRange(params: FetchBlockRangeParameters) {\n    const options = {\n\n        // By how much to increase/decrease the range size if the batch returns few/many items\n        dividerOnHigh: 2,\n        multiplierOnLow: 1.5,\n        multiplierOnZero: 2,\n\n        // How to determine if the batch returned few/many items\n        highActivityThreshold: 50,\n        lowActivityThreshold: 10,\n\n        // Limits and init values for the range size\n        initialRangeSize: 100,\n        maxRangeSize: 100_000,\n        minRangeSize: 1,\n\n        // \n        ...params.options,\n    };\n\n    let currentBlock = params.fromBlock;\n    let rangeSize = options.initialRangeSize;\n    let stopped = false;\n\n    const stop = () => {\n        stopped = true;\n    };\n\n    const totalItems: any[] = [];\n\n    function shouldStop() {\n        return hasHitBlockLimit(currentBlock, params.direction, params.toBlock) || hasHitItemLimit(totalItems, params.itemLimit);\n    }\n\n    while (!stopped && !shouldStop() ) {\n        const blockRange = calcBlockRange(currentBlock, rangeSize, params.direction);\n\n        // Cap the block range to the overall limits\n        if (params.direction === \"forward\") {\n            if (blockRange.toBlock > params.toBlock) {\n                blockRange.toBlock = params.toBlock;\n            }\n        } else { // backward\n            if (blockRange.fromBlock < params.toBlock) {\n                blockRange.fromBlock = params.toBlock;\n            }\n        }\n\n        const batchItems = await params.onBlockRange(blockRange, stop);\n\n        totalItems.push(...batchItems);\n\n        if (stopped) break;\n\n        // Adjust range size based on activity\n        if (batchItems.length > options.highActivityThreshold) {\n            rangeSize /= options.dividerOnHigh;\n        } else if (batchItems.length === 0) {\n            rangeSize *= options.multiplierOnZero;\n        } else if (batchItems.length <= options.lowActivityThreshold) {\n            rangeSize *= options.multiplierOnLow;\n        }\n\n        // Cap and round the range size\n        rangeSize = Math.round(\n            Math.max(options.minRangeSize, Math.min(options.maxRangeSize, rangeSize))\n        );\n\n        // Determine the next block to start from, fixing the \"backward\" direction logic\n        if (params.direction === \"backward\") {\n            currentBlock = blockRange.fromBlock - 1n;\n        } else {\n            currentBlock = blockRange.toBlock + 1n;\n        }\n    }\n\n    return totalItems.slice(0, params.itemLimit);\n}\n"],"names":[],"mappings":"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"}

package/dist/actions/index.mjs

@@ -12,7 +12,7 @@ export { sendTransaction, signMessage, signTypedData, writeContract } from 'perm
  * NOTE: This method relies on the non-standard 'trace_filter' method of the RPC.
  * It may not be supported by all nodes.
  *
- * @param client The CoreClient instance used to perform the RPC call.
+ * @param client The client instance used to perform the RPC call.
  * @param params The filtering parameters for the trace request (block range, addresses, etc.).
  * @returns A promise that returns an array of trace entries (GenericTraceEntry[])
  * that match the filtering criteria.
@@ -23,7 +23,7 @@ async function traceFilter(client, params) {
     if (typeof params.toAddress === "string")
         params.toAddress = [params.toAddress];
     return await client.request({
-        method: 'trace_filter',
+        method: "trace_filter",
         params: [params],
     });
 }
@@ -39,18 +39,25 @@ async function traceFilter(client, params) {
  * NOTE: This method relies on the non-standard 'trace_transaction' method of the RPC.
  * It may not be supported by all nodes.
  *
- * @param client The CoreClient instance used to perform the RPC call.
+ * @param client The client instance used to perform the RPC call.
  * @param params The transaction hash for which to retrieve traces.
  * @returns A promise that returns an array of trace entries (GenericTraceEntry[])
  * for the specified transaction hash.
  */
 async function traceTransaction(client, params) {
     return await client.request({
-        method: 'trace_transaction',
+        method: "trace_transaction",
         params: [params],
     });
 }
 
+function traceActions() {
+    return (client) => ({
+        traceFilter: (args) => traceFilter(client, args),
+        traceTransaction: (args) => traceTransaction(client, args),
+    });
+}
+
 function calcBlockRange(fromBlock, rangeSize, direction = "forward") {
     if (direction === "backward")
         return { fromBlock: fromBlock - BigInt(rangeSize), toBlock: fromBlock };
@@ -142,5 +149,5 @@ async function fetchByBlockRange(params) {
     return totalItems.slice(0, params.itemLimit);
 }
 
-export { fetchByBlockRange, traceFilter, traceTransaction };
+export { fetchByBlockRange, traceActions, traceFilter, traceTransaction };
 //# sourceMappingURL=index.mjs.map

package/dist/actions/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../../src/actions/traceFilter.ts","../../src/actions/traceTransaction.ts","../../src/actions/fetchByBlockRange.ts"],"sourcesContent":["import  type { TraceFilterParameters, TraceFilterReturnType, CoreClient, Hash } from \"../types\";\n\n/**\n * Calls the 'trace_filter' RPC method to retrieve execution traces\n * filtered according to the specified criteria.\n *\n * This function sends a JSON-RPC request to the Ethereum node (or EVM-compatible)\n * via the provided client object and returns the array of trace entries matching\n * the filters.\n * \n * NOTE: This method relies on the non-standard 'trace_filter' method of the RPC.\n * It may not be supported by all nodes.\n *\n * @param client The CoreClient instance used to perform the RPC call.\n * @param params The filtering parameters for the trace request (block range, addresses, etc.).\n * @returns A promise that returns an array of trace entries (GenericTraceEntry[])\n * that match the filtering criteria.\n */\nexport async function traceFilter(client: CoreClient, params: TraceFilterParameters): Promise<TraceFilterReturnType> {\n    if (typeof params.fromAddress === \"string\") params.fromAddress = [params.fromAddress];\n    if (typeof params.toAddress === \"string\") params.toAddress = [params.toAddress];\n    \n    return await client.request<{\n        method: 'trace_filter',\n        Parameters: TraceFilterParameters[],\n        ReturnType: TraceFilterReturnType\n    }>({\n        method: 'trace_filter',\n        params: [params],\n    });\n}","import  type { TraceTransactionParameters, TraceTransactionReturnType, CoreClient, Hash } from \"../types\";\n\n/**\n * Calls the 'trace_transaction' RPC method to retrieve execution traces\n * for a specific transaction hash.\n *\n * This function sends a JSON-RPC request to the Ethereum node (or EVM-compatible)\n * via the provided client object and returns the array of trace entries for\n * the specified transaction hash.\n * \n * NOTE: This method relies on the non-standard 'trace_transaction' method of the RPC.\n * It may not be supported by all nodes.\n * \n * @param client The CoreClient instance used to perform the RPC call.\n * @param params The transaction hash for which to retrieve traces.\n * @returns A promise that returns an array of trace entries (GenericTraceEntry[])\n * for the specified transaction hash.\n */\nexport async function traceTransaction(client: CoreClient, params: TraceTransactionParameters): Promise<TraceTransactionReturnType> {\n    return await client.request<{\n        method: 'trace_transaction',\n        Parameters: TraceTransactionParameters[],\n        ReturnType: TraceTransactionReturnType\n    }>({\n        method: 'trace_transaction',\n        params: [params],\n    });\n}","import { FetchBlockRangeParameters } from \"../types/BlockRangeFetcher\";\n\nfunction calcBlockRange(fromBlock: bigint, rangeSize: number, direction: \"backward\" | \"forward\" = \"forward\") {\n    if (direction === \"backward\") return { fromBlock: fromBlock - BigInt(rangeSize), toBlock: fromBlock };\n    return { fromBlock: fromBlock, toBlock: fromBlock + BigInt(rangeSize) };\n};\n\nfunction hasHitBlockLimit(blockNumber: bigint, direction: \"backward\" | \"forward\", blockLimit: bigint) {\n    return direction === \"backward\" ? blockNumber < blockLimit : blockNumber > blockLimit;\n};\n\nfunction hasHitItemLimit(items: any[], itemLimit: number) {\n    return items.length >= itemLimit;\n};\n\n/**\n * Fetch large amounts of data in batches by exploring with dynamic block ranges.\n * \n * Block ranges automatically adjust based on the provided configuration and how many items are found per batch. \n * If the actual block range returns too many items, the explorer will automatically reduce the range size for the next batch. \n * If the actual block range returns too few items, the explorer will automatically increase the range size for the next batch.\n * \n * This method is optimized to maximize efficiency by fetching items and minimizing the charge on the RPC node by \n * requesting too many items per batch or too many batches per second.\n * \n * Useful for methods like `eth_getLogs` or `trace_filter` that iterate over blocks to find items.\n * \n * @param params - The parameters for creating the explorer.\n */\nexport async function fetchByBlockRange(params: FetchBlockRangeParameters) {\n    const options = {\n\n        // By how much to increase/decrease the range size if the batch returns few/many items\n        dividerOnHigh: 2,\n        multiplierOnLow: 1.5,\n        multiplierOnZero: 2,\n\n        // How to determine if the batch returned few/many items\n        highActivityThreshold: 50,\n        lowActivityThreshold: 10,\n\n        // Limits and init values for the range size\n        initialRangeSize: 100,\n        maxRangeSize: 100_000,\n        minRangeSize: 1,\n\n        // \n        ...params.options,\n    };\n\n    let currentBlock = params.fromBlock;\n    let rangeSize = options.initialRangeSize;\n    let stopped = false;\n\n    const stop = () => {\n        stopped = true;\n    };\n\n    const totalItems: any[] = [];\n\n    function shouldStop() {\n        return hasHitBlockLimit(currentBlock, params.direction, params.toBlock) || hasHitItemLimit(totalItems, params.itemLimit);\n    }\n\n    while (!stopped && !shouldStop() ) {\n        const blockRange = calcBlockRange(currentBlock, rangeSize, params.direction);\n\n        // Cap the block range to the overall limits\n        if (params.direction === \"forward\") {\n            if (blockRange.toBlock > params.toBlock) {\n                blockRange.toBlock = params.toBlock;\n            }\n        } else { // backward\n            if (blockRange.fromBlock < params.toBlock) {\n                blockRange.fromBlock = params.toBlock;\n            }\n        }\n\n        const batchItems = await params.onBlockRange(blockRange, stop);\n\n        totalItems.push(...batchItems);\n\n        if (stopped) break;\n\n        // Adjust range size based on activity\n        if (batchItems.length > options.highActivityThreshold) {\n            rangeSize /= options.dividerOnHigh;\n        } else if (batchItems.length === 0) {\n            rangeSize *= options.multiplierOnZero;\n        } else if (batchItems.length <= options.lowActivityThreshold) {\n            rangeSize *= options.multiplierOnLow;\n        }\n\n        // Cap and round the range size\n        rangeSize = Math.round(\n            Math.max(options.minRangeSize, Math.min(options.maxRangeSize, rangeSize))\n        );\n\n        // Determine the next block to start from, fixing the \"backward\" direction logic\n        if (params.direction === \"backward\") {\n            currentBlock = blockRange.fromBlock - 1n;\n        } else {\n            currentBlock = blockRange.toBlock + 1n;\n        }\n    }\n\n    return totalItems.slice(0, params.itemLimit);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../../src/actions/traceFilter.ts","../../src/actions/traceTransaction.ts","../../src/actions/traceActions.ts","../../src/actions/fetchByBlockRange.ts"],"sourcesContent":["import type { Client, Transport, Chain } from \"viem\";\nimport type { TraceFilterParameters, TraceFilterReturnType } from \"../types\";\n\n/**\n * Calls the 'trace_filter' RPC method to retrieve execution traces\n * filtered according to the specified criteria.\n *\n * This function sends a JSON-RPC request to the Ethereum node (or EVM-compatible)\n * via the provided client object and returns the array of trace entries matching\n * the filters.\n *\n * NOTE: This method relies on the non-standard 'trace_filter' method of the RPC.\n * It may not be supported by all nodes.\n *\n * @param client The client instance used to perform the RPC call.\n * @param params The filtering parameters for the trace request (block range, addresses, etc.).\n * @returns A promise that returns an array of trace entries (GenericTraceEntry[])\n * that match the filtering criteria.\n */\nexport async function traceFilter<TChain extends Chain | undefined>(\n  client: Client<Transport, TChain>,\n  params: TraceFilterParameters,\n): Promise<TraceFilterReturnType> {\n  if (typeof params.fromAddress === \"string\")\n    params.fromAddress = [params.fromAddress];\n  if (typeof params.toAddress === \"string\")\n    params.toAddress = [params.toAddress];\n\n  return await client.request<{\n    method: \"trace_filter\";\n    Parameters: TraceFilterParameters[];\n    ReturnType: TraceFilterReturnType;\n  }>({\n    method: \"trace_filter\",\n    params: [params],\n  });\n}\n","import type { Client, Transport, Chain } from \"viem\";\nimport type {\n  TraceTransactionParameters,\n  TraceTransactionReturnType,\n} from \"../types\";\n\n/**\n * Calls the 'trace_transaction' RPC method to retrieve execution traces\n * for a specific transaction hash.\n *\n * This function sends a JSON-RPC request to the Ethereum node (or EVM-compatible)\n * via the provided client object and returns the array of trace entries for\n * the specified transaction hash.\n *\n * NOTE: This method relies on the non-standard 'trace_transaction' method of the RPC.\n * It may not be supported by all nodes.\n *\n * @param client The client instance used to perform the RPC call.\n * @param params The transaction hash for which to retrieve traces.\n * @returns A promise that returns an array of trace entries (GenericTraceEntry[])\n * for the specified transaction hash.\n */\nexport async function traceTransaction<TChain extends Chain | undefined>(\n  client: Client<Transport, TChain>,\n  params: TraceTransactionParameters,\n): Promise<TraceTransactionReturnType> {\n  return await client.request<{\n    method: \"trace_transaction\";\n    Parameters: TraceTransactionParameters[];\n    ReturnType: TraceTransactionReturnType;\n  }>({\n    method: \"trace_transaction\",\n    params: [params],\n  });\n}\n","import type { Chain, Client, Transport } from \"viem\";\nimport type {\n  TraceFilterParameters,\n  TraceFilterReturnType,\n  TraceTransactionParameters,\n  TraceTransactionReturnType,\n} from \"../types\";\nimport { traceFilter } from \"./traceFilter\";\nimport { traceTransaction } from \"./traceTransaction\";\n\nexport type TraceActions = {\n  traceFilter: (args: TraceFilterParameters) => Promise<TraceFilterReturnType>;\n  traceTransaction: (\n    args: TraceTransactionParameters,\n  ) => Promise<TraceTransactionReturnType>;\n};\n\nexport function traceActions(): <TChain extends Chain | undefined>(\n  client: Client<Transport, TChain>,\n) => TraceActions {\n  return (client) => ({\n    traceFilter: (args) => traceFilter(client, args),\n    traceTransaction: (args) => traceTransaction(client, args),\n  });\n}\n","import { FetchBlockRangeParameters } from \"../types/BlockRangeFetcher\";\n\nfunction calcBlockRange(fromBlock: bigint, rangeSize: number, direction: \"backward\" | \"forward\" = \"forward\") {\n    if (direction === \"backward\") return { fromBlock: fromBlock - BigInt(rangeSize), toBlock: fromBlock };\n    return { fromBlock: fromBlock, toBlock: fromBlock + BigInt(rangeSize) };\n};\n\nfunction hasHitBlockLimit(blockNumber: bigint, direction: \"backward\" | \"forward\", blockLimit: bigint) {\n    return direction === \"backward\" ? blockNumber < blockLimit : blockNumber > blockLimit;\n};\n\nfunction hasHitItemLimit(items: any[], itemLimit: number) {\n    return items.length >= itemLimit;\n};\n\n/**\n * Fetch large amounts of data in batches by exploring with dynamic block ranges.\n * \n * Block ranges automatically adjust based on the provided configuration and how many items are found per batch. \n * If the actual block range returns too many items, the explorer will automatically reduce the range size for the next batch. \n * If the actual block range returns too few items, the explorer will automatically increase the range size for the next batch.\n * \n * This method is optimized to maximize efficiency by fetching items and minimizing the charge on the RPC node by \n * requesting too many items per batch or too many batches per second.\n * \n * Useful for methods like `eth_getLogs` or `trace_filter` that iterate over blocks to find items.\n * \n * @param params - The parameters for creating the explorer.\n */\nexport async function fetchByBlockRange(params: FetchBlockRangeParameters) {\n    const options = {\n\n        // By how much to increase/decrease the range size if the batch returns few/many items\n        dividerOnHigh: 2,\n        multiplierOnLow: 1.5,\n        multiplierOnZero: 2,\n\n        // How to determine if the batch returned few/many items\n        highActivityThreshold: 50,\n        lowActivityThreshold: 10,\n\n        // Limits and init values for the range size\n        initialRangeSize: 100,\n        maxRangeSize: 100_000,\n        minRangeSize: 1,\n\n        // \n        ...params.options,\n    };\n\n    let currentBlock = params.fromBlock;\n    let rangeSize = options.initialRangeSize;\n    let stopped = false;\n\n    const stop = () => {\n        stopped = true;\n    };\n\n    const totalItems: any[] = [];\n\n    function shouldStop() {\n        return hasHitBlockLimit(currentBlock, params.direction, params.toBlock) || hasHitItemLimit(totalItems, params.itemLimit);\n    }\n\n    while (!stopped && !shouldStop() ) {\n        const blockRange = calcBlockRange(currentBlock, rangeSize, params.direction);\n\n        // Cap the block range to the overall limits\n        if (params.direction === \"forward\") {\n            if (blockRange.toBlock > params.toBlock) {\n                blockRange.toBlock = params.toBlock;\n            }\n        } else { // backward\n            if (blockRange.fromBlock < params.toBlock) {\n                blockRange.fromBlock = params.toBlock;\n            }\n        }\n\n        const batchItems = await params.onBlockRange(blockRange, stop);\n\n        totalItems.push(...batchItems);\n\n        if (stopped) break;\n\n        // Adjust range size based on activity\n        if (batchItems.length > options.highActivityThreshold) {\n            rangeSize /= options.dividerOnHigh;\n        } else if (batchItems.length === 0) {\n            rangeSize *= options.multiplierOnZero;\n        } else if (batchItems.length <= options.lowActivityThreshold) {\n            rangeSize *= options.multiplierOnLow;\n        }\n\n        // Cap and round the range size\n        rangeSize = Math.round(\n            Math.max(options.minRangeSize, Math.min(options.maxRangeSize, rangeSize))\n        );\n\n        // Determine the next block to start from, fixing the \"backward\" direction logic\n        if (params.direction === \"backward\") {\n            currentBlock = blockRange.fromBlock - 1n;\n        } else {\n            currentBlock = blockRange.toBlock + 1n;\n        }\n    }\n\n    return totalItems.slice(0, params.itemLimit);\n}\n"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;AAeG;AACI,eAAe,WAAW,CAC/B,MAAiC,EACjC,MAA6B,EAAA;AAE7B,IAAA,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;QACxC,MAAM,CAAC,WAAW,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC;AAC3C,IAAA,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACtC,MAAM,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;AAEvC,IAAA,OAAO,MAAM,MAAM,CAAC,OAAO,CAIxB;AACD,QAAA,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,CAAC,MAAM,CAAC;AACjB,KAAA,CAAC;AACJ;;AC9BA;;;;;;;;;;;;;;;AAeG;AACI,eAAe,gBAAgB,CACpC,MAAiC,EACjC,MAAkC,EAAA;AAElC,IAAA,OAAO,MAAM,MAAM,CAAC,OAAO,CAIxB;AACD,QAAA,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE,CAAC,MAAM,CAAC;AACjB,KAAA,CAAC;AACJ;;SCjBgB,YAAY,GAAA;AAG1B,IAAA,OAAO,CAAC,MAAM,MAAM;QAClB,WAAW,EAAE,CAAC,IAAI,KAAK,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC;QAChD,gBAAgB,EAAE,CAAC,IAAI,KAAK,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC;AAC3D,KAAA,CAAC;AACJ;;ACtBA,SAAS,cAAc,CAAC,SAAiB,EAAE,SAAiB,EAAE,YAAoC,SAAS,EAAA;IACvG,IAAI,SAAS,KAAK,UAAU;AAAE,QAAA,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;AACrG,IAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE;AAC3E;AAEA,SAAS,gBAAgB,CAAC,WAAmB,EAAE,SAAiC,EAAE,UAAkB,EAAA;AAChG,IAAA,OAAO,SAAS,KAAK,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU;AACzF;AAEA,SAAS,eAAe,CAAC,KAAY,EAAE,SAAiB,EAAA;AACpD,IAAA,OAAO,KAAK,CAAC,MAAM,IAAI,SAAS;AACpC;AAEA;;;;;;;;;;;;;AAaG;AACI,eAAe,iBAAiB,CAAC,MAAiC,EAAA;AACrE,IAAA,MAAM,OAAO,GAAG;;AAGZ,QAAA,aAAa,EAAE,CAAC;AAChB,QAAA,eAAe,EAAE,GAAG;AACpB,QAAA,gBAAgB,EAAE,CAAC;;AAGnB,QAAA,qBAAqB,EAAE,EAAE;AACzB,QAAA,oBAAoB,EAAE,EAAE;;AAGxB,QAAA,gBAAgB,EAAE,GAAG;AACrB,QAAA,YAAY,EAAE,MAAO;AACrB,QAAA,YAAY,EAAE,CAAC;;QAGf,GAAG,MAAM,CAAC,OAAO;KACpB;AAED,IAAA,IAAI,YAAY,GAAG,MAAM,CAAC,SAAS;AACnC,IAAA,IAAI,SAAS,GAAG,OAAO,CAAC,gBAAgB;IACxC,IAAI,OAAO,GAAG,KAAK;IAEnB,MAAM,IAAI,GAAG,MAAK;QACd,OAAO,GAAG,IAAI;AAClB,IAAA,CAAC;IAED,MAAM,UAAU,GAAU,EAAE;AAE5B,IAAA,SAAS,UAAU,GAAA;QACf,OAAO,gBAAgB,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC;IAC5H;AAEA,IAAA,OAAO,CAAC,OAAO,IAAI,CAAC,UAAU,EAAE,EAAG;AAC/B,QAAA,MAAM,UAAU,GAAG,cAAc,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;;AAG5E,QAAA,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE;YAChC,IAAI,UAAU,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE;AACrC,gBAAA,UAAU,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO;YACvC;QACJ;AAAO,aAAA;YACH,IAAI,UAAU,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE;AACvC,gBAAA,UAAU,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO;YACzC;QACJ;QAEA,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC;AAE9D,QAAA,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;AAE9B,QAAA,IAAI,OAAO;YAAE;;QAGb,IAAI,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE;AACnD,YAAA,SAAS,IAAI,OAAO,CAAC,aAAa;QACtC;AAAO,aAAA,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE;AAChC,YAAA,SAAS,IAAI,OAAO,CAAC,gBAAgB;QACzC;aAAO,IAAI,UAAU,CAAC,MAAM,IAAI,OAAO,CAAC,oBAAoB,EAAE;AAC1D,YAAA,SAAS,IAAI,OAAO,CAAC,eAAe;QACxC;;QAGA,SAAS,GAAG,IAAI,CAAC,KAAK,CAClB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,CAC5E;;AAGD,QAAA,IAAI,MAAM,CAAC,SAAS,KAAK,UAAU,EAAE;AACjC,YAAA,YAAY,GAAG,UAAU,CAAC,SAAS,GAAG,EAAE;QAC5C;aAAO;AACH,YAAA,YAAY,GAAG,UAAU,CAAC,OAAO,GAAG,EAAE;QAC1C;IACJ;IAEA,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC;AAChD;;;;"}

package/dist/actions/traceActions.d.ts

@@ -0,0 +1,7 @@
+import type { Chain, Client, Transport } from "viem";
+import type { TraceFilterParameters, TraceFilterReturnType, TraceTransactionParameters, TraceTransactionReturnType } from "../types";
+export type TraceActions = {
+    traceFilter: (args: TraceFilterParameters) => Promise<TraceFilterReturnType>;
+    traceTransaction: (args: TraceTransactionParameters) => Promise<TraceTransactionReturnType>;
+};
+export declare function traceActions(): <TChain extends Chain | undefined>(client: Client<Transport, TChain>) => TraceActions;

package/dist/actions/traceFilter.d.ts

@@ -1,4 +1,5 @@
-import type { TraceFilterParameters, TraceFilterReturnType, CoreClient } from "../types";
+import type { Client, Transport, Chain } from "viem";
+import type { TraceFilterParameters, TraceFilterReturnType } from "../types";
 /**
  * Calls the 'trace_filter' RPC method to retrieve execution traces
  * filtered according to the specified criteria.
@@ -10,9 +11,9 @@ import type { TraceFilterParameters, TraceFilterReturnType, CoreClient } from ".
  * NOTE: This method relies on the non-standard 'trace_filter' method of the RPC.
  * It may not be supported by all nodes.
  *
- * @param client The CoreClient instance used to perform the RPC call.
+ * @param client The client instance used to perform the RPC call.
  * @param params The filtering parameters for the trace request (block range, addresses, etc.).
  * @returns A promise that returns an array of trace entries (GenericTraceEntry[])
  * that match the filtering criteria.
  */
-export declare function traceFilter(client: CoreClient, params: TraceFilterParameters): Promise<TraceFilterReturnType>;
+export declare function traceFilter<TChain extends Chain | undefined>(client: Client<Transport, TChain>, params: TraceFilterParameters): Promise<TraceFilterReturnType>;

package/dist/actions/traceTransaction.d.ts

@@ -1,4 +1,5 @@
-import type { TraceTransactionParameters, TraceTransactionReturnType, CoreClient } from "../types";
+import type { Client, Transport, Chain } from "viem";
+import type { TraceTransactionParameters, TraceTransactionReturnType } from "../types";
 /**
  * Calls the 'trace_transaction' RPC method to retrieve execution traces
  * for a specific transaction hash.
@@ -10,9 +11,9 @@ import type { TraceTransactionParameters, TraceTransactionReturnType, CoreClient
  * NOTE: This method relies on the non-standard 'trace_transaction' method of the RPC.
  * It may not be supported by all nodes.
  *
- * @param client The CoreClient instance used to perform the RPC call.
+ * @param client The client instance used to perform the RPC call.
  * @param params The transaction hash for which to retrieve traces.
  * @returns A promise that returns an array of trace entries (GenericTraceEntry[])
  * for the specified transaction hash.
  */
-export declare function traceTransaction(client: CoreClient, params: TraceTransactionParameters): Promise<TraceTransactionReturnType>;
+export declare function traceTransaction<TChain extends Chain | undefined>(client: Client<Transport, TChain>, params: TraceTransactionParameters): Promise<TraceTransactionReturnType>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentaproject/core",
-  "version": "0.5.12",
+  "version": "0.5.13",
   "description": "Core library for menta packages, it includes all basic evm instances like Account, Transactions, Blocks etc...",
   "type": "module",
   "main": "dist/index.js",

package/src/actions/index.ts

@@ -1,12 +1,17 @@
 export * from "viem/actions";
 
 export {
-    sendTransaction, signMessage, signTypedData, writeContract
+  sendTransaction,
+  signMessage,
+  signTypedData,
+  writeContract,
 } from "permissionless/actions/smartAccount";
 
 /** Trace Actions */
 export { traceFilter } from "./traceFilter";
 export { traceTransaction } from "./traceTransaction";
+export { traceActions } from "./traceActions";
+export type { TraceActions } from "./traceActions";
 
 /** Block Range Actions */
-export { fetchByBlockRange } from "./fetchByBlockRange";
+export { fetchByBlockRange } from "./fetchByBlockRange";

package/src/actions/traceActions.ts

@@ -0,0 +1,25 @@
+import type { Chain, Client, Transport } from "viem";
+import type {
+  TraceFilterParameters,
+  TraceFilterReturnType,
+  TraceTransactionParameters,
+  TraceTransactionReturnType,
+} from "../types";
+import { traceFilter } from "./traceFilter";
+import { traceTransaction } from "./traceTransaction";
+
+export type TraceActions = {
+  traceFilter: (args: TraceFilterParameters) => Promise<TraceFilterReturnType>;
+  traceTransaction: (
+    args: TraceTransactionParameters,
+  ) => Promise<TraceTransactionReturnType>;
+};
+
+export function traceActions(): <TChain extends Chain | undefined>(
+  client: Client<Transport, TChain>,
+) => TraceActions {
+  return (client) => ({
+    traceFilter: (args) => traceFilter(client, args),
+    traceTransaction: (args) => traceTransaction(client, args),
+  });
+}

package/src/actions/traceFilter.ts

@@ -1,4 +1,5 @@
-import  type { TraceFilterParameters, TraceFilterReturnType, CoreClient, Hash } from "../types";
+import type { Client, Transport, Chain } from "viem";
+import type { TraceFilterParameters, TraceFilterReturnType } from "../types";
 
 /**
  * Calls the 'trace_filter' RPC method to retrieve execution traces
@@ -7,25 +8,30 @@ import  type { TraceFilterParameters, TraceFilterReturnType, CoreClient, Hash }
  * This function sends a JSON-RPC request to the Ethereum node (or EVM-compatible)
  * via the provided client object and returns the array of trace entries matching
  * the filters.
- * 
+ *
  * NOTE: This method relies on the non-standard 'trace_filter' method of the RPC.
  * It may not be supported by all nodes.
  *
- * @param client The CoreClient instance used to perform the RPC call.
+ * @param client The client instance used to perform the RPC call.
  * @param params The filtering parameters for the trace request (block range, addresses, etc.).
  * @returns A promise that returns an array of trace entries (GenericTraceEntry[])
  * that match the filtering criteria.
  */
-export async function traceFilter(client: CoreClient, params: TraceFilterParameters): Promise<TraceFilterReturnType> {
-    if (typeof params.fromAddress === "string") params.fromAddress = [params.fromAddress];
-    if (typeof params.toAddress === "string") params.toAddress = [params.toAddress];
-    
-    return await client.request<{
-        method: 'trace_filter',
-        Parameters: TraceFilterParameters[],
-        ReturnType: TraceFilterReturnType
-    }>({
-        method: 'trace_filter',
-        params: [params],
-    });
-}
+export async function traceFilter<TChain extends Chain | undefined>(
+  client: Client<Transport, TChain>,
+  params: TraceFilterParameters,
+): Promise<TraceFilterReturnType> {
+  if (typeof params.fromAddress === "string")
+    params.fromAddress = [params.fromAddress];
+  if (typeof params.toAddress === "string")
+    params.toAddress = [params.toAddress];
+
+  return await client.request<{
+    method: "trace_filter";
+    Parameters: TraceFilterParameters[];
+    ReturnType: TraceFilterReturnType;
+  }>({
+    method: "trace_filter",
+    params: [params],
+  });
+}

package/src/actions/traceTransaction.ts

@@ -1,4 +1,8 @@
-import  type { TraceTransactionParameters, TraceTransactionReturnType, CoreClient, Hash } from "../types";
+import type { Client, Transport, Chain } from "viem";
+import type {
+  TraceTransactionParameters,
+  TraceTransactionReturnType,
+} from "../types";
 
 /**
  * Calls the 'trace_transaction' RPC method to retrieve execution traces
@@ -7,22 +11,25 @@ import  type { TraceTransactionParameters, TraceTransactionReturnType, CoreClien
  * This function sends a JSON-RPC request to the Ethereum node (or EVM-compatible)
  * via the provided client object and returns the array of trace entries for
  * the specified transaction hash.
- * 
+ *
  * NOTE: This method relies on the non-standard 'trace_transaction' method of the RPC.
  * It may not be supported by all nodes.
- * 
- * @param client The CoreClient instance used to perform the RPC call.
+ *
+ * @param client The client instance used to perform the RPC call.
  * @param params The transaction hash for which to retrieve traces.
  * @returns A promise that returns an array of trace entries (GenericTraceEntry[])
  * for the specified transaction hash.
  */
-export async function traceTransaction(client: CoreClient, params: TraceTransactionParameters): Promise<TraceTransactionReturnType> {
-    return await client.request<{
-        method: 'trace_transaction',
-        Parameters: TraceTransactionParameters[],
-        ReturnType: TraceTransactionReturnType
-    }>({
-        method: 'trace_transaction',
-        params: [params],
-    });
-}
+export async function traceTransaction<TChain extends Chain | undefined>(
+  client: Client<Transport, TChain>,
+  params: TraceTransactionParameters,
+): Promise<TraceTransactionReturnType> {
+  return await client.request<{
+    method: "trace_transaction";
+    Parameters: TraceTransactionParameters[];
+    ReturnType: TraceTransactionReturnType;
+  }>({
+    method: "trace_transaction",
+    params: [params],
+  });
+}