@mentaproject/core 0.5.15 → 0.6.0

package/dist/types/CoreClient.d.ts

@@ -9,5 +9,14 @@ export type PermissionlessClientProperties<client extends ViemClient | undefined
     paymasterContext: BundlerClientConfig["paymasterContext"] | undefined;
     userOperation: BundlerClientConfig["userOperation"] | undefined;
 };
-export type CoreClient<TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartAccount | undefined = SmartAccount | undefined> = ViemClient<Transport, TChain, TAccount> & PermissionlessClientProperties;
+/**
+ * A basic viem Client used for standard RPC operations.
+ * This is the type returned by createClient before smart account setup.
+ */
+export type CoreClient<TChain extends Chain | undefined = Chain | undefined> = ViemClient<Transport, TChain>;
+/**
+ * A SmartAccountClient with permissionless properties.
+ * This is the type returned after setting up the smart account.
+ */
+export type SmartAccountCoreClient<TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartAccount | undefined = SmartAccount | undefined> = ViemClient<Transport, TChain, TAccount> & PermissionlessClientProperties;
 export type CoreClientConfig = RenameProperty<SmartAccountClientConfig, "bundlerTransport", "transport">;

package/dist/types/MentaAccount.d.ts

@@ -10,6 +10,9 @@ export interface PasskeySigner extends LocalAccount {
 }
 export interface MentaAccountParams {
     signer: PasskeySigner;
+    /** Transport for ERC-4337 bundler calls */
     bundlerTransport: Transport;
+    /** Transport for standard Ethereum RPC calls (eth_getBlock, etc.) */
+    publicTransport: Transport;
 }
 export type MentaAccountClient = Awaited<ReturnType<typeof createMentaAccount>>;

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 export type { AccessList, Address, Hash, Hex, BlockTag, Chain, Log, TransactionType, Quantity, AbiItem, Transport, Withdrawal, Transaction, } from "viem";
 export type { GetEnsAddressReturnType, GetEnsAvatarReturnType, GetEnsNameReturnType, GetEnsResolverReturnType, GetEnsTextReturnType, CallReturnType, CreateAccessListReturnType, CreateBlockFilterReturnType, CreateContractEventFilterReturnType, CreateEventFilterReturnType, CreatePendingTransactionFilterReturnType, EstimateContractGasReturnType, EstimateFeesPerGasReturnType, EstimateMaxPriorityFeePerGasReturnType, EstimateGasReturnType, GetBalanceReturnType, GetBlobBaseFeeReturnType, GetBlockReturnType, GetBlockNumberReturnType, GetBlockTransactionCountReturnType, GetChainIdReturnType, GetCodeReturnType, GetBytecodeReturnType, GetContractEventsReturnType, GetEip712DomainReturnType, GetFeeHistoryReturnType, GetFilterChangesReturnType, GetFilterLogsReturnType, GetGasPriceReturnType, GetLogsReturnType, GetStorageAtReturnType, GetTransactionConfirmationsReturnType, GetTransactionCountReturnType, GetTransactionReturnType, GetTransactionReceiptReturnType, MulticallReturnType, SimulateBlocksReturnType, SimulateContractReturnType, SimulateCallsReturnType, WatchBlocksReturnType, WatchBlockNumberReturnType, WatchEventReturnType, WatchContractEventReturnType, WatchPendingTransactionsReturnType, ReadContractReturnType, GetProofReturnType, WaitForTransactionReceiptReturnType, SendTransactionReturnType, SignMessageReturnType, SignTypedDataReturnType, WriteContractReturnType, GetEnsAddressParameters, GetEnsAvatarParameters, GetEnsNameParameters, GetEnsResolverParameters, GetEnsTextParameters, CallParameters, CreateAccessListParameters, CreateContractEventFilterParameters, CreateEventFilterParameters, EstimateContractGasParameters, EstimateFeesPerGasParameters, EstimateMaxPriorityFeePerGasParameters, EstimateGasParameters, GetBalanceParameters, GetBlockParameters, GetBlockNumberParameters, GetBlockTransactionCountParameters, GetCodeParameters, GetBytecodeParameters, GetContractEventsParameters, GetEip712DomainParameters, GetFeeHistoryParameters, GetFilterChangesParameters, GetFilterLogsParameters, GetLogsParameters, GetStorageAtParameters, GetTransactionConfirmationsParameters, GetTransactionCountParameters, GetTransactionParameters, GetTransactionReceiptParameters, MulticallParameters, SimulateBlocksParameters, SimulateContractParameters, SimulateCallsParameters, WatchBlocksParameters, WatchBlockNumberParameters, WatchEventParameters, WatchContractEventParameters, WatchPendingTransactionsParameters, ReadContractParameters, GetProofParameters, WaitForTransactionReceiptParameters, SendTransactionParameters, SignMessageParameters, SignTypedDataParameters, WriteContractParameters, } from "viem";
 export type { AbiError, AbiConstructor, AbiFunction, AbiEvent, AbiParameter, AbiParameterToPrimitiveType, } from "abitype";
-export type { CoreClient, CoreClientConfig } from "./CoreClient";
+export type { CoreClient, SmartAccountCoreClient, CoreClientConfig } from "./CoreClient";
 export { TraceFilterParameters, TraceFilterReturnType, TraceTransactionParameters, TraceTransactionReturnType, TraceBlockParameters, TraceBlockReturnType, TraceAction, TraceActionResult, TraceEntry, } from "./Trace";
 export { FetchBlockRangeParameters, onBlockRangeCallback, BlockRange, } from "./BlockRangeFetcher";
 export { TransactionOptions } from "./Transaction";

package/dist/utils/createRoutedTransport.d.ts

@@ -0,0 +1,22 @@
+import type { Transport } from "viem";
+/**
+ * Creates a transport that routes requests between a public RPC and a bundler RPC.
+ *
+ * Bundler-specific methods (ERC-4337) are routed to the bundler transport,
+ * while all other methods (eth_getBlockByNumber, eth_call, etc.) are routed
+ * to the public transport.
+ *
+ * @param publicTransport - Transport for standard Ethereum RPC calls
+ * @param bundlerTransport - Transport for ERC-4337 bundler calls
+ * @returns A unified transport that routes requests appropriately
+ *
+ * @example
+ * import { http } from 'viem';
+ * import { createRoutedTransport } from '@mentaproject/core/utils';
+ *
+ * const transport = createRoutedTransport(
+ *   http('https://eth-mainnet.g.alchemy.com/v2/...'),
+ *   http('https://api.pimlico.io/v2/1/rpc?apikey=...')
+ * );
+ */
+export declare function createRoutedTransport(publicTransport: Transport, bundlerTransport: Transport): Transport;

package/dist/utils/index.d.ts

@@ -1,3 +1,4 @@
 export * from 'viem/utils';
 export { bytesToAddress, bytes32ToAddress } from './bytesToAddress';
 export { nonZeroAddress } from './nonZeroAddress';
+export { createRoutedTransport } from './createRoutedTransport';

package/dist/utils/index.js

@@ -33,8 +33,67 @@ const bytes32ToAddress = (bytes) => {
 
 const nonZeroAddress = (address) => address === viem.zeroAddress ? undefined : address;
 
+/**
+ * RPC methods that should be routed to the bundler.
+ * All other methods will be routed to the public RPC.
+ */
+const BUNDLER_METHODS = new Set([
+    // ERC-4337 standard methods
+    "eth_sendUserOperation",
+    "eth_estimateUserOperationGas",
+    "eth_getUserOperationByHash",
+    "eth_getUserOperationReceipt",
+    "eth_supportedEntryPoints",
+    // Pimlico-specific methods
+    "pimlico_getUserOperationGasPrice",
+    "pimlico_getUserOperationStatus",
+    "pimlico_sendCompressedUserOperation",
+    // pm_ paymaster methods (used by some bundlers)
+    "pm_getPaymasterData",
+    "pm_getPaymasterStubData",
+    "pm_sponsorUserOperation",
+    "pm_validateSponsorshipPolicies",
+]);
+/**
+ * Creates a transport that routes requests between a public RPC and a bundler RPC.
+ *
+ * Bundler-specific methods (ERC-4337) are routed to the bundler transport,
+ * while all other methods (eth_getBlockByNumber, eth_call, etc.) are routed
+ * to the public transport.
+ *
+ * @param publicTransport - Transport for standard Ethereum RPC calls
+ * @param bundlerTransport - Transport for ERC-4337 bundler calls
+ * @returns A unified transport that routes requests appropriately
+ *
+ * @example
+ * import { http } from 'viem';
+ * import { createRoutedTransport } from '@mentaproject/core/utils';
+ *
+ * const transport = createRoutedTransport(
+ *   http('https://eth-mainnet.g.alchemy.com/v2/...'),
+ *   http('https://api.pimlico.io/v2/1/rpc?apikey=...')
+ * );
+ */
+function createRoutedTransport(publicTransport, bundlerTransport) {
+    return (params) => {
+        const publicClient = publicTransport(params);
+        const bundlerClient = bundlerTransport(params);
+        const request = async ({ method, params: reqParams }) => {
+            if (BUNDLER_METHODS.has(method)) {
+                return bundlerClient.request({ method, params: reqParams });
+            }
+            return publicClient.request({ method, params: reqParams });
+        };
+        return {
+            ...publicClient,
+            request,
+        };
+    };
+}
+
 exports.bytes32ToAddress = bytes32ToAddress;
 exports.bytesToAddress = bytesToAddress;
+exports.createRoutedTransport = createRoutedTransport;
 exports.nonZeroAddress = nonZeroAddress;
 Object.keys(utils).forEach(function (k) {
     if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/utils/bytesToAddress.ts","../../src/utils/nonZeroAddress.ts"],"sourcesContent":["import { getAddress, slice } from \".\";\nimport { Address, Hex } from \"../types\";\n\n/**\n * Helper function to convert a bytes value to an address.\n * @param bytes The bytes value to convert.\n * @param startByteIndex The index of the first byte to extract from the bytes value.\n * @returns The address or undefined if the conversion failed.\n */\nexport const bytesToAddress = (bytes: Hex, startByteIndex: number): Address => {\n    if (startByteIndex < 0) throw new Error(`startByteIndex must be greater than or equal to 0, got ${startByteIndex}`);\n    if (!bytes || bytes.length < startByteIndex + 20) throw new Error(`Bytes value must be at least ${startByteIndex + 20} characters long, got ${bytes?.length ?? 0}`);\n\n    // Extracts 20 bytes starting from startByteIndex\n    const addressBytes = slice(bytes, startByteIndex, startByteIndex + 20);\n\n    if (addressBytes.length !== 42) throw new Error(`Address bytes must be 42 characters long, got ${addressBytes.length}`);\n    return getAddress(addressBytes);\n};\n\n/**\n * Helper function to convert a bytes32 value to an address.\n * @param bytes The bytes32 value to convert.\n * @returns The address or undefined if the conversion failed.\n */\nexport const bytes32ToAddress = (bytes: Hex): Address => {\n    if (!bytes || bytes.length !== 66) throw new Error(`Bytes32 value must be 66 characters long, got ${bytes?.length ?? 0}`);\n\n    return bytesToAddress(bytes, 12);\n};","import { zeroAddress } from \"..\";\nimport { Address } from \"../types\";\n\nexport const nonZeroAddress = (address: Address): Address | undefined => address === zeroAddress ? undefined : address;"],"names":["slice","getAddress","zeroAddress"],"mappings":";;;;;AAGA;;;;;AAKG;MACU,cAAc,GAAG,CAAC,KAAU,EAAE,cAAsB,KAAa;IAC1E,IAAI,cAAc,GAAG,CAAC;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,0DAA0D,cAAc,CAAA,CAAE,CAAC;IACnH,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,cAAc,GAAG,EAAE;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,CAAA,6BAAA,EAAgC,cAAc,GAAG,EAAE,CAAA,sBAAA,EAAyB,KAAK,EAAE,MAAM,IAAI,CAAC,CAAA,CAAE,CAAC;;AAGnK,IAAA,MAAM,YAAY,GAAGA,WAAK,CAAC,KAAK,EAAE,cAAc,EAAE,cAAc,GAAG,EAAE,CAAC;AAEtE,IAAA,IAAI,YAAY,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,CAAA,8CAAA,EAAiD,YAAY,CAAC,MAAM,CAAA,CAAE,CAAC;AACvH,IAAA,OAAOC,gBAAU,CAAC,YAAY,CAAC;AACnC;AAEA;;;;AAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAU,KAAa;AACpD,IAAA,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,CAAA,8CAAA,EAAiD,KAAK,EAAE,MAAM,IAAI,CAAC,CAAA,CAAE,CAAC;AAEzH,IAAA,OAAO,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC;AACpC;;MC1Ba,cAAc,GAAG,CAAC,OAAgB,KAA0B,OAAO,KAAKC,gBAAW,GAAG,SAAS,GAAG;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":["../../src/utils/bytesToAddress.ts","../../src/utils/nonZeroAddress.ts","../../src/utils/createRoutedTransport.ts"],"sourcesContent":["import { getAddress, slice } from \".\";\nimport { Address, Hex } from \"../types\";\n\n/**\n * Helper function to convert a bytes value to an address.\n * @param bytes The bytes value to convert.\n * @param startByteIndex The index of the first byte to extract from the bytes value.\n * @returns The address or undefined if the conversion failed.\n */\nexport const bytesToAddress = (bytes: Hex, startByteIndex: number): Address => {\n    if (startByteIndex < 0) throw new Error(`startByteIndex must be greater than or equal to 0, got ${startByteIndex}`);\n    if (!bytes || bytes.length < startByteIndex + 20) throw new Error(`Bytes value must be at least ${startByteIndex + 20} characters long, got ${bytes?.length ?? 0}`);\n\n    // Extracts 20 bytes starting from startByteIndex\n    const addressBytes = slice(bytes, startByteIndex, startByteIndex + 20);\n\n    if (addressBytes.length !== 42) throw new Error(`Address bytes must be 42 characters long, got ${addressBytes.length}`);\n    return getAddress(addressBytes);\n};\n\n/**\n * Helper function to convert a bytes32 value to an address.\n * @param bytes The bytes32 value to convert.\n * @returns The address or undefined if the conversion failed.\n */\nexport const bytes32ToAddress = (bytes: Hex): Address => {\n    if (!bytes || bytes.length !== 66) throw new Error(`Bytes32 value must be 66 characters long, got ${bytes?.length ?? 0}`);\n\n    return bytesToAddress(bytes, 12);\n};","import { zeroAddress } from \"..\";\nimport { Address } from \"../types\";\n\nexport const nonZeroAddress = (address: Address): Address | undefined => address === zeroAddress ? undefined : address;","import type { EIP1193RequestFn, Transport } from \"viem\";\n\n/**\n * RPC methods that should be routed to the bundler.\n * All other methods will be routed to the public RPC.\n */\nconst BUNDLER_METHODS = new Set([\n  // ERC-4337 standard methods\n  \"eth_sendUserOperation\",\n  \"eth_estimateUserOperationGas\",\n  \"eth_getUserOperationByHash\",\n  \"eth_getUserOperationReceipt\",\n  \"eth_supportedEntryPoints\",\n  // Pimlico-specific methods\n  \"pimlico_getUserOperationGasPrice\",\n  \"pimlico_getUserOperationStatus\",\n  \"pimlico_sendCompressedUserOperation\",\n  // pm_ paymaster methods (used by some bundlers)\n  \"pm_getPaymasterData\",\n  \"pm_getPaymasterStubData\",\n  \"pm_sponsorUserOperation\",\n  \"pm_validateSponsorshipPolicies\",\n]);\n\n/**\n * Creates a transport that routes requests between a public RPC and a bundler RPC.\n *\n * Bundler-specific methods (ERC-4337) are routed to the bundler transport,\n * while all other methods (eth_getBlockByNumber, eth_call, etc.) are routed\n * to the public transport.\n *\n * @param publicTransport - Transport for standard Ethereum RPC calls\n * @param bundlerTransport - Transport for ERC-4337 bundler calls\n * @returns A unified transport that routes requests appropriately\n *\n * @example\n * import { http } from 'viem';\n * import { createRoutedTransport } from '@mentaproject/core/utils';\n *\n * const transport = createRoutedTransport(\n *   http('https://eth-mainnet.g.alchemy.com/v2/...'),\n *   http('https://api.pimlico.io/v2/1/rpc?apikey=...')\n * );\n */\nexport function createRoutedTransport(\n  publicTransport: Transport,\n  bundlerTransport: Transport,\n): Transport {\n  return (params) => {\n    const publicClient = publicTransport(params);\n    const bundlerClient = bundlerTransport(params);\n\n    const request: EIP1193RequestFn = async ({ method, params: reqParams }) => {\n      if (BUNDLER_METHODS.has(method)) {\n        return bundlerClient.request({ method, params: reqParams } as any);\n      }\n      return publicClient.request({ method, params: reqParams } as any);\n    };\n\n    return {\n      ...publicClient,\n      request,\n    };\n  };\n}\n"],"names":["slice","getAddress","zeroAddress"],"mappings":";;;;;AAGA;;;;;AAKG;MACU,cAAc,GAAG,CAAC,KAAU,EAAE,cAAsB,KAAa;IAC1E,IAAI,cAAc,GAAG,CAAC;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,0DAA0D,cAAc,CAAA,CAAE,CAAC;IACnH,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,cAAc,GAAG,EAAE;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,CAAA,6BAAA,EAAgC,cAAc,GAAG,EAAE,CAAA,sBAAA,EAAyB,KAAK,EAAE,MAAM,IAAI,CAAC,CAAA,CAAE,CAAC;;AAGnK,IAAA,MAAM,YAAY,GAAGA,WAAK,CAAC,KAAK,EAAE,cAAc,EAAE,cAAc,GAAG,EAAE,CAAC;AAEtE,IAAA,IAAI,YAAY,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,CAAA,8CAAA,EAAiD,YAAY,CAAC,MAAM,CAAA,CAAE,CAAC;AACvH,IAAA,OAAOC,gBAAU,CAAC,YAAY,CAAC;AACnC;AAEA;;;;AAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAU,KAAa;AACpD,IAAA,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,CAAA,8CAAA,EAAiD,KAAK,EAAE,MAAM,IAAI,CAAC,CAAA,CAAE,CAAC;AAEzH,IAAA,OAAO,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC;AACpC;;MC1Ba,cAAc,GAAG,CAAC,OAAgB,KAA0B,OAAO,KAAKC,gBAAW,GAAG,SAAS,GAAG;;ACD/G;;;AAGG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;;IAE9B,uBAAuB;IACvB,8BAA8B;IAC9B,4BAA4B;IAC5B,6BAA6B;IAC7B,0BAA0B;;IAE1B,kCAAkC;IAClC,gCAAgC;IAChC,qCAAqC;;IAErC,qBAAqB;IACrB,yBAAyB;IACzB,yBAAyB;IACzB,gCAAgC;AACjC,CAAA,CAAC;AAEF;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAU,qBAAqB,CACnC,eAA0B,EAC1B,gBAA2B,EAAA;IAE3B,OAAO,CAAC,MAAM,KAAI;AAChB,QAAA,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC;AAC5C,QAAA,MAAM,aAAa,GAAG,gBAAgB,CAAC,MAAM,CAAC;AAE9C,QAAA,MAAM,OAAO,GAAqB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAI;AACxE,YAAA,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;AAC/B,gBAAA,OAAO,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAS,CAAC;YACpE;AACA,YAAA,OAAO,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAS,CAAC;AACnE,QAAA,CAAC;QAED,OAAO;AACL,YAAA,GAAG,YAAY;YACf,OAAO;SACR;AACH,IAAA,CAAC;AACH;;;;;;;;;;;;;"}

package/dist/utils/index.mjs

@@ -32,5 +32,63 @@ const bytes32ToAddress = (bytes) => {
 
 const nonZeroAddress = (address) => address === zeroAddress ? undefined : address;
 
-export { bytes32ToAddress, bytesToAddress, nonZeroAddress };
+/**
+ * RPC methods that should be routed to the bundler.
+ * All other methods will be routed to the public RPC.
+ */
+const BUNDLER_METHODS = new Set([
+    // ERC-4337 standard methods
+    "eth_sendUserOperation",
+    "eth_estimateUserOperationGas",
+    "eth_getUserOperationByHash",
+    "eth_getUserOperationReceipt",
+    "eth_supportedEntryPoints",
+    // Pimlico-specific methods
+    "pimlico_getUserOperationGasPrice",
+    "pimlico_getUserOperationStatus",
+    "pimlico_sendCompressedUserOperation",
+    // pm_ paymaster methods (used by some bundlers)
+    "pm_getPaymasterData",
+    "pm_getPaymasterStubData",
+    "pm_sponsorUserOperation",
+    "pm_validateSponsorshipPolicies",
+]);
+/**
+ * Creates a transport that routes requests between a public RPC and a bundler RPC.
+ *
+ * Bundler-specific methods (ERC-4337) are routed to the bundler transport,
+ * while all other methods (eth_getBlockByNumber, eth_call, etc.) are routed
+ * to the public transport.
+ *
+ * @param publicTransport - Transport for standard Ethereum RPC calls
+ * @param bundlerTransport - Transport for ERC-4337 bundler calls
+ * @returns A unified transport that routes requests appropriately
+ *
+ * @example
+ * import { http } from 'viem';
+ * import { createRoutedTransport } from '@mentaproject/core/utils';
+ *
+ * const transport = createRoutedTransport(
+ *   http('https://eth-mainnet.g.alchemy.com/v2/...'),
+ *   http('https://api.pimlico.io/v2/1/rpc?apikey=...')
+ * );
+ */
+function createRoutedTransport(publicTransport, bundlerTransport) {
+    return (params) => {
+        const publicClient = publicTransport(params);
+        const bundlerClient = bundlerTransport(params);
+        const request = async ({ method, params: reqParams }) => {
+            if (BUNDLER_METHODS.has(method)) {
+                return bundlerClient.request({ method, params: reqParams });
+            }
+            return publicClient.request({ method, params: reqParams });
+        };
+        return {
+            ...publicClient,
+            request,
+        };
+    };
+}
+
+export { bytes32ToAddress, bytesToAddress, createRoutedTransport, nonZeroAddress };
 //# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../../src/utils/bytesToAddress.ts","../../src/utils/nonZeroAddress.ts"],"sourcesContent":["import { getAddress, slice } from \".\";\nimport { Address, Hex } from \"../types\";\n\n/**\n * Helper function to convert a bytes value to an address.\n * @param bytes The bytes value to convert.\n * @param startByteIndex The index of the first byte to extract from the bytes value.\n * @returns The address or undefined if the conversion failed.\n */\nexport const bytesToAddress = (bytes: Hex, startByteIndex: number): Address => {\n    if (startByteIndex < 0) throw new Error(`startByteIndex must be greater than or equal to 0, got ${startByteIndex}`);\n    if (!bytes || bytes.length < startByteIndex + 20) throw new Error(`Bytes value must be at least ${startByteIndex + 20} characters long, got ${bytes?.length ?? 0}`);\n\n    // Extracts 20 bytes starting from startByteIndex\n    const addressBytes = slice(bytes, startByteIndex, startByteIndex + 20);\n\n    if (addressBytes.length !== 42) throw new Error(`Address bytes must be 42 characters long, got ${addressBytes.length}`);\n    return getAddress(addressBytes);\n};\n\n/**\n * Helper function to convert a bytes32 value to an address.\n * @param bytes The bytes32 value to convert.\n * @returns The address or undefined if the conversion failed.\n */\nexport const bytes32ToAddress = (bytes: Hex): Address => {\n    if (!bytes || bytes.length !== 66) throw new Error(`Bytes32 value must be 66 characters long, got ${bytes?.length ?? 0}`);\n\n    return bytesToAddress(bytes, 12);\n};","import { zeroAddress } from \"..\";\nimport { Address } from \"../types\";\n\nexport const nonZeroAddress = (address: Address): Address | undefined => address === zeroAddress ? undefined : address;"],"names":[],"mappings":";;;;AAGA;;;;;AAKG;MACU,cAAc,GAAG,CAAC,KAAU,EAAE,cAAsB,KAAa;IAC1E,IAAI,cAAc,GAAG,CAAC;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,0DAA0D,cAAc,CAAA,CAAE,CAAC;IACnH,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,cAAc,GAAG,EAAE;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,CAAA,6BAAA,EAAgC,cAAc,GAAG,EAAE,CAAA,sBAAA,EAAyB,KAAK,EAAE,MAAM,IAAI,CAAC,CAAA,CAAE,CAAC;;AAGnK,IAAA,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,cAAc,GAAG,EAAE,CAAC;AAEtE,IAAA,IAAI,YAAY,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,CAAA,8CAAA,EAAiD,YAAY,CAAC,MAAM,CAAA,CAAE,CAAC;AACvH,IAAA,OAAO,UAAU,CAAC,YAAY,CAAC;AACnC;AAEA;;;;AAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAU,KAAa;AACpD,IAAA,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,CAAA,8CAAA,EAAiD,KAAK,EAAE,MAAM,IAAI,CAAC,CAAA,CAAE,CAAC;AAEzH,IAAA,OAAO,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC;AACpC;;MC1Ba,cAAc,GAAG,CAAC,OAAgB,KAA0B,OAAO,KAAK,WAAW,GAAG,SAAS,GAAG;;;;"}
+{"version":3,"file":"index.mjs","sources":["../../src/utils/bytesToAddress.ts","../../src/utils/nonZeroAddress.ts","../../src/utils/createRoutedTransport.ts"],"sourcesContent":["import { getAddress, slice } from \".\";\nimport { Address, Hex } from \"../types\";\n\n/**\n * Helper function to convert a bytes value to an address.\n * @param bytes The bytes value to convert.\n * @param startByteIndex The index of the first byte to extract from the bytes value.\n * @returns The address or undefined if the conversion failed.\n */\nexport const bytesToAddress = (bytes: Hex, startByteIndex: number): Address => {\n    if (startByteIndex < 0) throw new Error(`startByteIndex must be greater than or equal to 0, got ${startByteIndex}`);\n    if (!bytes || bytes.length < startByteIndex + 20) throw new Error(`Bytes value must be at least ${startByteIndex + 20} characters long, got ${bytes?.length ?? 0}`);\n\n    // Extracts 20 bytes starting from startByteIndex\n    const addressBytes = slice(bytes, startByteIndex, startByteIndex + 20);\n\n    if (addressBytes.length !== 42) throw new Error(`Address bytes must be 42 characters long, got ${addressBytes.length}`);\n    return getAddress(addressBytes);\n};\n\n/**\n * Helper function to convert a bytes32 value to an address.\n * @param bytes The bytes32 value to convert.\n * @returns The address or undefined if the conversion failed.\n */\nexport const bytes32ToAddress = (bytes: Hex): Address => {\n    if (!bytes || bytes.length !== 66) throw new Error(`Bytes32 value must be 66 characters long, got ${bytes?.length ?? 0}`);\n\n    return bytesToAddress(bytes, 12);\n};","import { zeroAddress } from \"..\";\nimport { Address } from \"../types\";\n\nexport const nonZeroAddress = (address: Address): Address | undefined => address === zeroAddress ? undefined : address;","import type { EIP1193RequestFn, Transport } from \"viem\";\n\n/**\n * RPC methods that should be routed to the bundler.\n * All other methods will be routed to the public RPC.\n */\nconst BUNDLER_METHODS = new Set([\n  // ERC-4337 standard methods\n  \"eth_sendUserOperation\",\n  \"eth_estimateUserOperationGas\",\n  \"eth_getUserOperationByHash\",\n  \"eth_getUserOperationReceipt\",\n  \"eth_supportedEntryPoints\",\n  // Pimlico-specific methods\n  \"pimlico_getUserOperationGasPrice\",\n  \"pimlico_getUserOperationStatus\",\n  \"pimlico_sendCompressedUserOperation\",\n  // pm_ paymaster methods (used by some bundlers)\n  \"pm_getPaymasterData\",\n  \"pm_getPaymasterStubData\",\n  \"pm_sponsorUserOperation\",\n  \"pm_validateSponsorshipPolicies\",\n]);\n\n/**\n * Creates a transport that routes requests between a public RPC and a bundler RPC.\n *\n * Bundler-specific methods (ERC-4337) are routed to the bundler transport,\n * while all other methods (eth_getBlockByNumber, eth_call, etc.) are routed\n * to the public transport.\n *\n * @param publicTransport - Transport for standard Ethereum RPC calls\n * @param bundlerTransport - Transport for ERC-4337 bundler calls\n * @returns A unified transport that routes requests appropriately\n *\n * @example\n * import { http } from 'viem';\n * import { createRoutedTransport } from '@mentaproject/core/utils';\n *\n * const transport = createRoutedTransport(\n *   http('https://eth-mainnet.g.alchemy.com/v2/...'),\n *   http('https://api.pimlico.io/v2/1/rpc?apikey=...')\n * );\n */\nexport function createRoutedTransport(\n  publicTransport: Transport,\n  bundlerTransport: Transport,\n): Transport {\n  return (params) => {\n    const publicClient = publicTransport(params);\n    const bundlerClient = bundlerTransport(params);\n\n    const request: EIP1193RequestFn = async ({ method, params: reqParams }) => {\n      if (BUNDLER_METHODS.has(method)) {\n        return bundlerClient.request({ method, params: reqParams } as any);\n      }\n      return publicClient.request({ method, params: reqParams } as any);\n    };\n\n    return {\n      ...publicClient,\n      request,\n    };\n  };\n}\n"],"names":[],"mappings":";;;;AAGA;;;;;AAKG;MACU,cAAc,GAAG,CAAC,KAAU,EAAE,cAAsB,KAAa;IAC1E,IAAI,cAAc,GAAG,CAAC;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,0DAA0D,cAAc,CAAA,CAAE,CAAC;IACnH,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,cAAc,GAAG,EAAE;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,CAAA,6BAAA,EAAgC,cAAc,GAAG,EAAE,CAAA,sBAAA,EAAyB,KAAK,EAAE,MAAM,IAAI,CAAC,CAAA,CAAE,CAAC;;AAGnK,IAAA,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,cAAc,GAAG,EAAE,CAAC;AAEtE,IAAA,IAAI,YAAY,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,CAAA,8CAAA,EAAiD,YAAY,CAAC,MAAM,CAAA,CAAE,CAAC;AACvH,IAAA,OAAO,UAAU,CAAC,YAAY,CAAC;AACnC;AAEA;;;;AAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAU,KAAa;AACpD,IAAA,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,CAAA,8CAAA,EAAiD,KAAK,EAAE,MAAM,IAAI,CAAC,CAAA,CAAE,CAAC;AAEzH,IAAA,OAAO,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC;AACpC;;MC1Ba,cAAc,GAAG,CAAC,OAAgB,KAA0B,OAAO,KAAK,WAAW,GAAG,SAAS,GAAG;;ACD/G;;;AAGG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;;IAE9B,uBAAuB;IACvB,8BAA8B;IAC9B,4BAA4B;IAC5B,6BAA6B;IAC7B,0BAA0B;;IAE1B,kCAAkC;IAClC,gCAAgC;IAChC,qCAAqC;;IAErC,qBAAqB;IACrB,yBAAyB;IACzB,yBAAyB;IACzB,gCAAgC;AACjC,CAAA,CAAC;AAEF;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAU,qBAAqB,CACnC,eAA0B,EAC1B,gBAA2B,EAAA;IAE3B,OAAO,CAAC,MAAM,KAAI;AAChB,QAAA,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC;AAC5C,QAAA,MAAM,aAAa,GAAG,gBAAgB,CAAC,MAAM,CAAC;AAE9C,QAAA,MAAM,OAAO,GAAqB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAI;AACxE,YAAA,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;AAC/B,gBAAA,OAAO,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAS,CAAC;YACpE;AACA,YAAA,OAAO,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAS,CAAC;AACnE,QAAA,CAAC;QAED,OAAO;AACL,YAAA,GAAG,YAAY;YACf,OAAO;SACR;AACH,IAAA,CAAC;AACH;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentaproject/core",
-  "version": "0.5.15",
+  "version": "0.6.0",
   "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/clients/createMentaAccount.ts

@@ -7,6 +7,7 @@ import { entryPoint07Address } from "../account-abstraction";
 import { toKernelSmartAccount } from "permissionless/accounts";
 import { createSmartAccountClient } from "permissionless";
 import { erc7579Actions } from "permissionless/actions/erc7579";
+import { createRoutedTransport } from "../utils/createRoutedTransport";
 import type {
   Client,
   Transport,
@@ -34,8 +35,15 @@ export async function createMentaAccount<TChain extends Chain | undefined>(
     client: client,
   });
 
+  // Create a routed transport that sends bundler methods to the bundler
+  // and all other RPC calls to the public transport
+  const routedTransport = createRoutedTransport(
+    params.publicTransport,
+    params.bundlerTransport,
+  );
+
   return createSmartAccountClient({
     account: kernel,
-    bundlerTransport: params.bundlerTransport,
+    bundlerTransport: routedTransport,
   }).extend(erc7579Actions());
 }

package/src/types/CoreClient.ts

@@ -1,4 +1,4 @@
-import type{ RenameProperty } from './Utils';
+import type { RenameProperty } from './Utils';
 import type { Transport, Chain } from './';
 
 import type { Client as ViemClient } from 'viem';
@@ -14,8 +14,20 @@ export type PermissionlessClientProperties<
     userOperation: BundlerClientConfig["userOperation"] | undefined
 }
 
+/**
+ * A basic viem Client used for standard RPC operations.
+ * This is the type returned by createClient before smart account setup.
+ */
 export type CoreClient<
     TChain extends Chain | undefined = Chain | undefined,
+> = ViemClient<Transport, TChain>;
+
+/**
+ * A SmartAccountClient with permissionless properties.
+ * This is the type returned after setting up the smart account.
+ */
+export type SmartAccountCoreClient<
+    TChain extends Chain | undefined = Chain | undefined,
     TAccount extends SmartAccount | undefined = SmartAccount | undefined,
 > = ViemClient<Transport, TChain, TAccount> & PermissionlessClientProperties;
 

package/src/types/MentaAccount.ts

@@ -12,7 +12,10 @@ export interface PasskeySigner extends LocalAccount {
 
 export interface MentaAccountParams {
   signer: PasskeySigner;
+  /** Transport for ERC-4337 bundler calls */
   bundlerTransport: Transport;
+  /** Transport for standard Ethereum RPC calls (eth_getBlock, etc.) */
+  publicTransport: Transport;
 }
 
 export type MentaAccountClient = Awaited<ReturnType<typeof createMentaAccount>>;

package/src/types/index.ts

@@ -128,7 +128,7 @@ export type {
   AbiParameterToPrimitiveType,
 } from "abitype";
 
-export type { CoreClient, CoreClientConfig } from "./CoreClient";
+export type { CoreClient, SmartAccountCoreClient, CoreClientConfig } from "./CoreClient";
 
 export {
   TraceFilterParameters,

package/src/utils/createRoutedTransport.ts

@@ -0,0 +1,65 @@
+import type { EIP1193RequestFn, Transport } from "viem";
+
+/**
+ * RPC methods that should be routed to the bundler.
+ * All other methods will be routed to the public RPC.
+ */
+const BUNDLER_METHODS = new Set([
+  // ERC-4337 standard methods
+  "eth_sendUserOperation",
+  "eth_estimateUserOperationGas",
+  "eth_getUserOperationByHash",
+  "eth_getUserOperationReceipt",
+  "eth_supportedEntryPoints",
+  // Pimlico-specific methods
+  "pimlico_getUserOperationGasPrice",
+  "pimlico_getUserOperationStatus",
+  "pimlico_sendCompressedUserOperation",
+  // pm_ paymaster methods (used by some bundlers)
+  "pm_getPaymasterData",
+  "pm_getPaymasterStubData",
+  "pm_sponsorUserOperation",
+  "pm_validateSponsorshipPolicies",
+]);
+
+/**
+ * Creates a transport that routes requests between a public RPC and a bundler RPC.
+ *
+ * Bundler-specific methods (ERC-4337) are routed to the bundler transport,
+ * while all other methods (eth_getBlockByNumber, eth_call, etc.) are routed
+ * to the public transport.
+ *
+ * @param publicTransport - Transport for standard Ethereum RPC calls
+ * @param bundlerTransport - Transport for ERC-4337 bundler calls
+ * @returns A unified transport that routes requests appropriately
+ *
+ * @example
+ * import { http } from 'viem';
+ * import { createRoutedTransport } from '@mentaproject/core/utils';
+ *
+ * const transport = createRoutedTransport(
+ *   http('https://eth-mainnet.g.alchemy.com/v2/...'),
+ *   http('https://api.pimlico.io/v2/1/rpc?apikey=...')
+ * );
+ */
+export function createRoutedTransport(
+  publicTransport: Transport,
+  bundlerTransport: Transport,
+): Transport {
+  return (params) => {
+    const publicClient = publicTransport(params);
+    const bundlerClient = bundlerTransport(params);
+
+    const request: EIP1193RequestFn = async ({ method, params: reqParams }) => {
+      if (BUNDLER_METHODS.has(method)) {
+        return bundlerClient.request({ method, params: reqParams } as any);
+      }
+      return publicClient.request({ method, params: reqParams } as any);
+    };
+
+    return {
+      ...publicClient,
+      request,
+    };
+  };
+}

package/src/utils/index.ts

@@ -1,3 +1,4 @@
 export * from 'viem/utils';
 export { bytesToAddress, bytes32ToAddress } from './bytesToAddress';
-export { nonZeroAddress } from './nonZeroAddress';
+export { nonZeroAddress } from './nonZeroAddress';
+export { createRoutedTransport } from './createRoutedTransport';