@nevermined-io/core-kit 0.5.21 → 0.5.23

package/dist/contracts/ContractBase.d.ts

@@ -33,6 +33,15 @@ export declare abstract class ContractBase extends Instantiable {
     simulateMulticall(calls: SimulateMulticallEntry[], from: Account | SmartAccount, params?: TxParameters): Promise<boolean>;
     simulate(functionName: string, from: Account | SmartAccount, args: any[], params?: TxParameters): Promise<boolean>;
     send(functionName: string, from: Account | SmartAccount, args: any[], params?: TxParameters): Promise<TransactionReceipt | UserOperationReceipt>;
+    /**
+     * Poll a previously-submitted UserOperation's receipt by hash WITHOUT
+     * blocking. Returns the receipt once the bundler has mined it, or `null`
+     * while it is still in the mempool / not yet known. A client-side
+     * receipt-wait timeout does NOT cancel a submitted UserOp, so callers that
+     * persist the hash (e.g. the onchain-mirror worker, nvm-monorepo#1508) use
+     * this to confirm a prior submission instead of resubmitting a duplicate.
+     */
+    getUserOperationReceipt(hash: `0x${string}`): Promise<UserOperationReceipt | null>;
     private internalMulticallSmartAccount;
     private assertUserOpSucceeded;
     private internalSendSmartAccount;

package/dist/contracts/ContractBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContractBase.d.ts","sourceRoot":"","sources":["../../src/contracts/ContractBase.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,GAAG,EACH,OAAO,EACP,OAAO,EAQP,kBAAkB,EACnB,MAAM,MAAM,CAAA;AACb,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAE7E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAKxD,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,OAAO,CAAA;IACxB,GAAG,EAAE,GAAG,CAAA;IACR,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,GAAG,EAAE,CAAA;CACZ;AA0CD,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,GAAG,CAAA;IACR,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,EAAE,EAAE,OAAO,CAAA;CACZ;AAED,8BAAsB,YAAa,SAAQ,YAAY;IACrD,SAAgB,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,EAAE,GAAG,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IACvB,OAAO,CAAC,iBAAiB,CAA+D;gBAE5E,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;cAMlC,IAAI,CAClB,MAAM,EAAE,kBAAkB,EAC1B,cAAc,EAAE;QAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,GAAG,EAAE,GAAG,CAAA;KAAE;IAYzC,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAiBrE,qBAAqB,CAChC,MAAM,EAAE,oBAAoB,GAAG,kBAAkB,GAChD,OAAO,CAAC,kBAAkB,CAAC;IAiBvB,kBAAkB,CACvB,SAAS,EAAE,kBAAkB,GAAG,oBAAoB,EACpD,SAAS,CAAC,EAAE,MAAM,GAOZ,GAAG,EAAE;IAGA,SAAS,CACpB,KAAK,EAAE,cAAc,EAAE,EACvB,IAAI,EAAE,OAAO,GAAG,YAAY,EAC5B,MAAM,GAAE,YAAiB;IAgBd,iBAAiB,CAC5B,KAAK,EAAE,sBAAsB,EAAE,EAC/B,IAAI,EAAE,OAAO,GAAG,YAAY,EAC5B,MAAM,GAAE,YAAiB;IAgBd,QAAQ,CACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,GAAG,YAAY,EAC5B,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,GAAE,YAAiB;IAgBd,IAAI,CACf,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,GAAG,YAAY,EAC5B,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,GAAE,YAAiB,GACxB,OAAO,CAAC,kBAAkB,GAAG,oBAAoB,CAAC;YAiBvC,6BAA6B;IAuF3C,OAAO,CAAC,qBAAqB;YAaf,wBAAwB;YAqIxB,4BAA4B;YAuB5B,oBAAoB;YAuBpB,gBAAgB;YAmIhB,qBAAqB;YAyBrB,6BAA6B;YAqB7B,qCAAqC;IAkEnD,OAAO,CAAC,oBAAoB;IAU5B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAW1B,SAAS,CAAC,aAAa,IAAI,MAAM;IAcjC,OAAO,CAAC,eAAe;CAYxB"}
+{"version":3,"file":"ContractBase.d.ts","sourceRoot":"","sources":["../../src/contracts/ContractBase.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,GAAG,EACH,OAAO,EACP,OAAO,EAQP,kBAAkB,EACnB,MAAM,MAAM,CAAA;AACb,OAAO,EAGL,YAAY,EACZ,oBAAoB,EACrB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAKxD,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,OAAO,CAAA;IACxB,GAAG,EAAE,GAAG,CAAA;IACR,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,GAAG,EAAE,CAAA;CACZ;AA0CD,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,GAAG,CAAA;IACR,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,EAAE,EAAE,OAAO,CAAA;CACZ;AAED,8BAAsB,YAAa,SAAQ,YAAY;IACrD,SAAgB,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,EAAE,GAAG,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IACvB,OAAO,CAAC,iBAAiB,CAA+D;gBAE5E,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;cAMlC,IAAI,CAClB,MAAM,EAAE,kBAAkB,EAC1B,cAAc,EAAE;QAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,GAAG,EAAE,GAAG,CAAA;KAAE;IAYzC,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAiBrE,qBAAqB,CAChC,MAAM,EAAE,oBAAoB,GAAG,kBAAkB,GAChD,OAAO,CAAC,kBAAkB,CAAC;IAiBvB,kBAAkB,CACvB,SAAS,EAAE,kBAAkB,GAAG,oBAAoB,EACpD,SAAS,CAAC,EAAE,MAAM,GAOZ,GAAG,EAAE;IAGA,SAAS,CACpB,KAAK,EAAE,cAAc,EAAE,EACvB,IAAI,EAAE,OAAO,GAAG,YAAY,EAC5B,MAAM,GAAE,YAAiB;IAgBd,iBAAiB,CAC5B,KAAK,EAAE,sBAAsB,EAAE,EAC/B,IAAI,EAAE,OAAO,GAAG,YAAY,EAC5B,MAAM,GAAE,YAAiB;IAgBd,QAAQ,CACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,GAAG,YAAY,EAC5B,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,GAAE,YAAiB;IAgBd,IAAI,CACf,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,GAAG,YAAY,EAC5B,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,GAAE,YAAiB,GACxB,OAAO,CAAC,kBAAkB,GAAG,oBAAoB,CAAC;IAiBrD;;;;;;;OAOG;IACU,uBAAuB,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;YA8BjF,6BAA6B;IAuF3C,OAAO,CAAC,qBAAqB;YAaf,wBAAwB;YAmMxB,4BAA4B;YAuB5B,oBAAoB;YAuBpB,gBAAgB;YAmIhB,qBAAqB;YAyBrB,6BAA6B;YAqB7B,qCAAqC;IAkEnD,OAAO,CAAC,oBAAoB;IAU5B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAW1B,SAAS,CAAC,aAAa,IAAI,MAAM;IAcjC,OAAO,CAAC,eAAe;CAYxB"}

package/dist/contracts/ContractBase.js

@@ -1,6 +1,7 @@
 import { createKernelAccountClient, createZeroDevPaymasterClient } from '@zerodev/sdk';
 import { estimateUserOperationFees, getBundlerRpcUrl, getPaymasterRpcUrl, isRelayerMode } from '../nevermined/utils/BlockchainViemUtils.js';
 import { BaseError, ContractFunctionRevertedError, encodeFunctionData, getContract, http, parseAbi, parseEventLogs } from 'viem';
+import { createBundlerClient, getUserOperationHash } from 'viem/account-abstraction';
 import { ContractsError, ContractSimulationError } from '../errors/index.js';
 import { Instantiable } from '../Instantiable.abstract.js';
 import { getInputsOfFunctionFormatted, getTransactionReceipt } from '../nevermined/index.js';
@@ -151,6 +152,42 @@ export class ContractBase extends Instantiable {
             throw new ContractsError(`Account not supported`);
         }
     }
+    /**
+   * Poll a previously-submitted UserOperation's receipt by hash WITHOUT
+   * blocking. Returns the receipt once the bundler has mined it, or `null`
+   * while it is still in the mempool / not yet known. A client-side
+   * receipt-wait timeout does NOT cancel a submitted UserOp, so callers that
+   * persist the hash (e.g. the onchain-mirror worker, nvm-monorepo#1508) use
+   * this to confirm a prior submission instead of resubmitting a duplicate.
+   */ async getUserOperationReceipt(hash) {
+        try {
+            const bundlerClient = createBundlerClient({
+                chain: getChain(this.config.chainId),
+                transport: http(this.getBundlerRPC()),
+                client: this.client.public
+            });
+            return await bundlerClient.getUserOperationReceipt({
+                hash
+            }) ?? null;
+        } catch (err) {
+            // A genuinely-absent receipt (UserOp still in the mempool) is expected
+            // and benign — some bundlers signal it by throwing rather than returning
+            // null. Anything else (RPC/transport/config fault) must NOT masquerade as
+            // "still pending": surface it at `warn` so a bundler outage is visible
+            // instead of silently driving the caller's grace-window logic. Either
+            // way we return null so the caller re-polls rather than consuming a retry.
+            const message = err instanceof Error ? err.message : String(err);
+            if (/not[\s_]?found|UserOperationReceiptNotFound/i.test(message)) {
+                this.logger.debug(`getUserOperationReceipt(${hash}): not yet mined`);
+            } else {
+                // Redact URLs before logging: the bundler RPC URL embeds the ZeroDev
+                // project id, which should not leak into logs.
+                const safeMessage = message.replace(/https?:\/\/[^\s'")]+/gi, '<redacted-url>');
+                this.logger.warn(`getUserOperationReceipt(${hash}) lookup error (treating as not-yet-mined): ${safeMessage}`);
+            }
+            return null;
+        }
+    }
     async internalMulticallSmartAccount(calls, from, txparams, progress) {
         if (progress) {
             progress({
@@ -289,16 +326,72 @@ export class ContractBase extends Instantiable {
             const nonce = await from.getNonce({
                 key: getRandomBigInt(ZERODEV_NONCE_KEY_BITS)
             });
-            userOpHash = await kernelClient.sendUserOperation({
-                callData: await kernelClient.account.encodeCalls([
-                    {
-                        to: this.address,
-                        value: txparams.value || 0n,
-                        data
-                    }
-                ]),
+            const callData = await kernelClient.account.encodeCalls([
+                {
+                    to: this.address,
+                    value: txparams.value || 0n,
+                    data
+                }
+            ]);
+            // When a caller supplies a `progress` callback it may need the UserOp
+            // hash BEFORE the send completes — the onchain-mirror worker races the
+            // send against a per-tick deadline and must persist the hash even if the
+            // send is cut off mid-flight, otherwise it resubmits and double-burns
+            // (#1508/#1904). So prepare the UserOp here, surface its hash via
+            // `progress({stage:'prepared'})`, and send that exact prepared op so the
+            // bundler-returned hash matches. Best-effort and GATED ON `progress`:
+            // any failure falls back to the normal send, and callers that pass no
+            // progress callback keep the original send path byte-for-byte.
+            let preparedUserOp;
+            let preparedHash;
+            if (progress) {
+                try {
+                    preparedUserOp = await kernelClient.prepareUserOperation({
+                        callData,
+                        nonce
+                    });
+                    preparedHash = getUserOperationHash({
+                        chainId: this.config.chainId,
+                        entryPointAddress: from.entryPoint.address,
+                        entryPointVersion: from.entryPoint.version,
+                        userOperation: preparedUserOp
+                    });
+                    progress({
+                        stage: 'prepared',
+                        args: functionInputs,
+                        userOpHash: preparedHash,
+                        method: name,
+                        from: from,
+                        value,
+                        contractName: this.contractName,
+                        contractAddress: this.address,
+                        gasLimit
+                    });
+                } catch (prepErr) {
+                    this.logger.warn(`prepareUserOperation (pre-send hash) failed for "${name}"; ` + `sending without an early hash: ${prepErr}`);
+                    preparedUserOp = undefined;
+                    preparedHash = undefined;
+                }
+            }
+            userOpHash = await kernelClient.sendUserOperation(// Re-send the exact prepared op (stripping the estimation stub
+            // signature so the kernel re-signs) so the bundler hash matches the one
+            // emitted above. Falls back to the original {callData, nonce} path
+            // (which prepares internally) when no early hash was prepared.
+            preparedUserOp ? {
+                ...preparedUserOp,
+                signature: undefined
+            } : {
+                callData,
                 nonce
             });
+            // Determinism guard: the 'prepared' hash should equal the bundler's. If a
+            // paymaster re-request changed the op it won't — a caller that persisted
+            // the 'prepared' hash then just fails to find it and reconciles safely
+            // (never a double-burn), but we log so we can see whether the early-hash
+            // path is actually holding in practice.
+            if (preparedHash && userOpHash !== preparedHash) {
+                this.logger.warn(`UserOp 'prepared' hash ${preparedHash} != sent hash ${userOpHash} for "${name}"; ` + `early-hash callers will reconcile via receipt-not-found`);
+            }
         } catch (err) {
             if (err instanceof BaseError) {
                 const revertError = err.walk((err)=>err instanceof ContractFunctionRevertedError);
@@ -610,7 +703,7 @@ export class ContractBase extends Instantiable {
         if (!projectId && !isRelayerMode()) {
             throw new ContractsError('getBundlerRPC: zeroDevProjectId is required for non-relayer (production) mode');
         }
-        return getBundlerRpcUrl(projectId ?? '', this.config.chainId);
+        return getBundlerRpcUrl(projectId ?? '', this.config.chainId, this.config.useUltraRelay);
     }
     getPaymasterRPC() {
         // Only ever consulted when `getPaymasterConfig` decides to attach a

package/dist/contracts/ContractBase.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/contracts/ContractBase.ts"],"sourcesContent":["import { createKernelAccountClient, createZeroDevPaymasterClient } from '@zerodev/sdk'\nimport {\n  estimateUserOperationFees,\n  getBundlerRpcUrl,\n  getPaymasterRpcUrl,\n  isRelayerMode,\n} from '../nevermined/utils/BlockchainViemUtils.js'\nimport {\n  Abi,\n  Account,\n  Address,\n  BaseError,\n  ContractFunctionRevertedError,\n  encodeFunctionData,\n  getContract,\n  http,\n  parseAbi,\n  parseEventLogs,\n  TransactionReceipt,\n} from 'viem'\nimport { SmartAccount, UserOperationReceipt } from 'viem/account-abstraction'\nimport { ContractsError, ContractSimulationError } from '../errors/index.js'\nimport { Instantiable, InstantiableConfig } from '../Instantiable.abstract.js'\nimport { TxParameters } from '../models/Transactions.js'\nimport { getInputsOfFunctionFormatted, getTransactionReceipt } from '../nevermined/index.js'\nimport { getRandomBigInt } from '../utils/helpers.js'\nimport { getChain } from '../utils/Network.js'\n\nexport interface MulticallEntry {\n  contractName?: string\n  contractAddress: Address\n  abi: Abi\n  functionName: string\n  args: any[]\n}\n\n/**\n * When a testnet RPC (Base Sepolia) fails internally, some providers return\n * `eth_estimateGas` values equal to — or even above — the block gas limit\n * instead of a real error. Using that value causes the node to reject the tx\n * with `intrinsic gas too high` before it ever reaches the mempool.\n *\n * `writeContract` in viem re-estimates gas internally when `gas` isn't\n * already set on the request (viem's `simulateContract` only performs\n * `eth_call`, not `eth_estimateGas`). That means the naïve path has no\n * chance to intercept a bogus estimate. We run the estimation ourselves\n * here, sanity-check the result, and always pass an explicit gas value\n * into `writeContract` so it doesn't re-query the misbehaving RPC.\n */\nconst GAS_SANITY_THRESHOLD = 25_000_000n\nconst GAS_FALLBACK_CAP = 5_000_000n\n\n// EntryPoint v0.7: ZeroDev's `toKernelPluginManager` rejects `customNonceKey > maxUint16`.\n// 16 bits = 65 536 channels — collision probability for the SDK's expected concurrency\n// (k=2–5 parallel sends from one SCA) is negligible (< 0.02 %). High-fan-out callers\n// (k > 50) should consider a per-process monotonic counter instead. See issue #1579.\nconst ZERODEV_NONCE_KEY_BITS = 16\n\n// Client-side cap on `waitForUserOperationReceipt`. The userOp is already in the bundler\n// mempool when this fires — a client-side timeout does NOT cancel it. Callers that catch\n// the resulting `ContractsError` MUST poll `bundlerClient.getUserOperationReceipt(hash)`\n// before retrying; otherwise a retry can produce a duplicate on-chain op.\nconst USEROP_RECEIPT_TIMEOUT_MS = 90_000\n\nfunction capForBogusEstimate(\n  estimatedGas: bigint,\n  logger: { warn: (msg: string) => void },\n): bigint {\n  if (estimatedGas < GAS_SANITY_THRESHOLD) return estimatedGas\n  logger.warn(\n    `Estimated gas (${estimatedGas}) exceeds sanity threshold ` +\n      `(${GAS_SANITY_THRESHOLD}); overriding with ${GAS_FALLBACK_CAP} to bypass misbehaving RPC estimate.`,\n  )\n  return GAS_FALLBACK_CAP\n}\n\nexport interface SimulateMulticallEntry {\n  functionName: string\n  value?: bigint\n  abi: Abi\n  args: any[]\n  to: Address\n}\n\nexport abstract class ContractBase extends Instantiable {\n  public readonly contractName: string\n  public contract: any\n  public address: Address\n  private _zeroDevPaymaster: ReturnType<typeof createZeroDevPaymasterClient> | null = null\n\n  constructor(contractName: string, address: Address) {\n    super()\n    this.contractName = contractName\n    this.address = address\n  }\n\n  protected async init(\n    config: InstantiableConfig,\n    contractConfig: { address: `0x${string}`; abi: Abi },\n  ) {\n    this.setInstanceConfig(config)\n    this.address = contractConfig.address\n\n    this.contract = getContract({\n      address: contractConfig.address,\n      abi: contractConfig.abi,\n      client: { public: this.publicClient, wallet: this.walletClient },\n    })\n  }\n\n  public async call<T>(functionName: string, args: any[], from?: string): Promise<T> {\n    try {\n      return (await this.client.public.readContract({\n        address: this.address,\n        abi: this.contract.abi,\n        functionName: parseAbi([functionName]),\n        args,\n        ...(from && { account: from as `0x${string}` }),\n      })) as T\n      //return await this.contract[functionSignature](...args, { from })\n    } catch (err) {\n      throw new ContractsError(\n        `Calling method \"${functionName}\" on contract \"${this.contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n  }\n\n  public async getTransactionReceipt(\n    txHash: UserOperationReceipt | TransactionReceipt,\n  ): Promise<TransactionReceipt> {\n    // Get the transaction receipt depending on the type of txHash\n    if ('transactionHash' in txHash) {\n      // txHash is TransactionReceipt\n      return txHash\n    } else if ('userOpHash' in txHash) {\n      // txHash is UserOperationReceipt, fetch the actual receipt using the utility function with retry logic\n      const hash = txHash.receipt.transactionHash\n      return await getTransactionReceipt({\n        txHash: hash,\n        publicClient: this.client.public,\n      })\n    } else {\n      throw new Error('Unknown transaction type')\n    }\n  }\n\n  public getTransactionLogs(\n    txReceipt: TransactionReceipt | UserOperationReceipt,\n    eventName?: string,\n  ) {\n    return parseEventLogs({\n      abi: this.contract.abi,\n      logs: txReceipt.logs,\n      eventName,\n      strict: false,\n    }) as any[]\n  }\n\n  public async multicall(\n    calls: MulticallEntry[],\n    from: Account | SmartAccount,\n    params: TxParameters = {},\n  ) {\n    if (from.type === 'local') {\n      this.logger.debug(`Blockchain Multicall using Local account`)\n      return await this.localAccountMulticall(calls, from, params, params.progress)\n    } else if (from.type === 'json-rpc') {\n      this.logger.debug(`Blockchain Multicall using JSON-RPC account`)\n      return await this.localAccountMulticall(calls, from, params, params.progress)\n    } else if (from.type === 'smart') {\n      this.logger.debug(`Blockchain Multicall using ZeroDev account`)\n      return await this.internalMulticallSmartAccount(calls, from, params, params.progress)\n    } else {\n      throw new ContractsError(`Account not supported`)\n    }\n  }\n\n  public async simulateMulticall(\n    calls: SimulateMulticallEntry[],\n    from: Account | SmartAccount,\n    params: TxParameters = {},\n  ) {\n    if (from.type === 'local') {\n      this.logger.debug(`Simulating calls using Local account`)\n      return await this.localAccountSimulateMulticall(calls, from, params)\n    } else if (from.type === 'json-rpc') {\n      this.logger.debug(`Simulating calls using JSON-RPC account`)\n      return await this.localAccountSimulateMulticall(calls, from, params)\n    } else if (from.type === 'smart') {\n      this.logger.debug(`Simulating calls using Smart Account account`)\n      return await this.internalSimulateMulticallSmartAccount(calls, from, params)\n    } else {\n      throw new ContractsError(`Account not supported`)\n    }\n  }\n\n  public async simulate(\n    functionName: string,\n    from: Account | SmartAccount,\n    args: any[],\n    params: TxParameters = {},\n  ) {\n    if (from.type === 'local') {\n      this.logger.debug(`Simulating calls using Local account`)\n      return await this.localAccountSimulate(functionName, from, args, params)\n    } else if (from.type === 'json-rpc') {\n      this.logger.debug(`Simulating calls using JSON-RPC account`)\n      return await this.localAccountSimulate(functionName, from, args, params)\n    } else if (from.type === 'smart') {\n      this.logger.debug(`Simulating calls using Smart Account account`)\n      return await this.internalSimulateSmartAccount(functionName, from, args, params)\n    } else {\n      throw new ContractsError(`Account not supported`)\n    }\n  }\n\n  public async send(\n    functionName: string,\n    from: Account | SmartAccount,\n    args: any[],\n    params: TxParameters = {},\n  ): Promise<TransactionReceipt | UserOperationReceipt> {\n    if (from.type === 'local') {\n      this.logger.debug(\n        `Blockchain Send using Local account with functionName: ${functionName} and following args: ${args}`,\n      )\n      return await this.localAccountSend(functionName, from, args, params, params.progress)\n    } else if (from.type === 'json-rpc') {\n      this.logger.debug(`Blockchain Send using JSON-RPC account to ${functionName}`)\n      return await this.localAccountSend(functionName, from, args, params, params.progress)\n    } else if (from.type === 'smart') {\n      this.logger.debug(`Blockchain Send using ZeroDev account`)\n      return await this.internalSendSmartAccount(functionName, from, args, params, params.progress)\n    } else {\n      throw new ContractsError(`Account not supported`)\n    }\n  }\n\n  private async internalMulticallSmartAccount(\n    calls: MulticallEntry[],\n    from: SmartAccount,\n    txparams: any,\n    progress: ((data: any) => void) | undefined,\n  ) {\n    if (progress) {\n      progress({\n        stage: 'multicall-sending',\n        args: [],\n        method: '',\n        from: from,\n        contractAddress: this.address,\n      })\n    }\n\n    const kernelClient = createKernelAccountClient({\n      account: from,\n      chain: getChain(this.config.chainId),\n      bundlerTransport: http(this.getBundlerRPC()),\n      client: this.client.public,\n      ...this.getPaymasterConfig(),\n      userOperation: {\n        estimateFeesPerGas: async ({ bundlerClient }) => {\n          return estimateUserOperationFees(bundlerClient, this.client.public)\n        },\n      },\n    })\n\n    const encodedCalls: any[] = []\n    calls.map((call) => {\n      encodedCalls.push({\n        to: call.contractAddress || this.address,\n        value: txparams.value || 0n,\n        data: encodeFunctionData({\n          abi: call.abi,\n          functionName: call.functionName,\n          args: call.args,\n        }),\n      })\n    })\n\n    let userOpHash: `0x${string}` | undefined\n    try {\n      // Random nonce key per send so concurrent userOps from the same SCA\n      // hit distinct EntryPoint nonce channels instead of colliding on the\n      // default `customNonceKey=0n`. See issue #1579.\n      const nonce = await from.getNonce({ key: getRandomBigInt(ZERODEV_NONCE_KEY_BITS) })\n      userOpHash = await kernelClient.sendUserOperation({\n        callData: await kernelClient.account.encodeCalls(encodedCalls),\n        nonce,\n      })\n\n      if (progress) {\n        progress({\n          stage: 'multicall-sent',\n          args: [],\n          method: '',\n          from: from,\n          contractAddress: this.address,\n        })\n      }\n\n      // Wait for the transaction to be mined\n      this.logger.debug(`Waiting for transaction to be mined... ${userOpHash}`)\n      const txReceipt = await kernelClient.waitForUserOperationReceipt({\n        hash: userOpHash,\n        timeout: USEROP_RECEIPT_TIMEOUT_MS,\n      })\n      this.logger.debug(`Transaction mined - UserOperationHash: ${userOpHash}`)\n      this.logger.debug(\n        `Transaction receipt - TransactionHash: ${txReceipt.receipt.transactionHash}`,\n      )\n      this.assertUserOpSucceeded(txReceipt, 'multicall', userOpHash)\n      return txReceipt.receipt\n    } catch (err) {\n      if (err instanceof BaseError) {\n        const revertError = err.walk((err) => err instanceof ContractFunctionRevertedError)\n        this.logger.error(`revertError: ${String(revertError)}`)\n      }\n      // Surface userOpHash so callers can poll for eventual inclusion before\n      // retrying — a client-side receipt-wait timeout does NOT cancel the userOp.\n      const hashSuffix = userOpHash ? ` userOpHash=${userOpHash}` : ''\n      throw new ContractsError(`Multicall failed:${hashSuffix} ${err}`)\n    }\n  }\n\n  private assertUserOpSucceeded(\n    txReceipt: UserOperationReceipt,\n    method: string,\n    userOpHash: string,\n  ): void {\n    if (txReceipt.success) return\n    throw new ContractsError(\n      `UserOp inner call reverted for \"${method}\" on \"${this.contractName}\". ` +\n        `userOpHash=${userOpHash} txHash=${txReceipt.receipt.transactionHash} ` +\n        `reason=${txReceipt.reason ?? 'unknown'}`,\n    )\n  }\n\n  private async internalSendSmartAccount(\n    name: string,\n    from: SmartAccount,\n    args: any[],\n    txparams: any,\n    progress: ((data: any) => void) | undefined,\n  ): Promise<UserOperationReceipt> {\n    const functionInputs = getInputsOfFunctionFormatted(this.contract.abi, name, args)\n\n    const { gasLimit, value } = txparams\n    if (progress) {\n      progress({\n        stage: 'sending',\n        args: functionInputs,\n        method: name,\n        from: from,\n        value,\n        contractName: this.contractName,\n        contractAddress: this.address,\n        gasLimit,\n      })\n    }\n\n    try {\n      await this.client.public.simulateContract({\n        address: this.address,\n        abi: this.contract.abi,\n        functionName: name,\n        args,\n        account: from,\n        ...(txparams.value && { value: txparams.value }),\n      })\n    } catch (err) {\n      if (err instanceof BaseError) {\n        const revertError = err.walk((err) => err instanceof ContractFunctionRevertedError)\n        this.logger.error(`revertError: ${String(revertError)}`)\n      }\n      throw new ContractsError(\n        `Calling method \"${name}\" on contract \"${this.contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n\n    const kernelClient = createKernelAccountClient({\n      account: from,\n      chain: getChain(this.config.chainId),\n      bundlerTransport: http(this.getBundlerRPC()),\n      client: this.client.public,\n      ...this.getPaymasterConfig(),\n      userOperation: {\n        estimateFeesPerGas: async ({ bundlerClient }) => {\n          return estimateUserOperationFees(bundlerClient, this.client.public)\n        },\n      },\n    })\n    const data = encodeFunctionData({ abi: this.contract.abi, functionName: name, args })\n\n    let userOpHash\n    try {\n      // Random nonce key per send so concurrent userOps from the same SCA\n      // hit distinct EntryPoint nonce channels instead of colliding on the\n      // default `customNonceKey=0n`. See issue #1579.\n      const nonce = await from.getNonce({ key: getRandomBigInt(ZERODEV_NONCE_KEY_BITS) })\n      userOpHash = await kernelClient.sendUserOperation({\n        callData: await kernelClient.account.encodeCalls([\n          {\n            to: this.address,\n            value: txparams.value || 0n,\n            data,\n          },\n        ]),\n        nonce,\n      })\n    } catch (err) {\n      if (err instanceof BaseError) {\n        const revertError = err.walk((err) => err instanceof ContractFunctionRevertedError)\n        this.logger.error(`revertError: ${String(revertError)}`)\n      }\n      throw new ContractsError(\n        `Calling method \"${name}\" on contract \"${this.contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n\n    if (progress) {\n      progress({\n        stage: 'sent',\n        args: functionInputs,\n        userOpHash,\n        method: name,\n        from: from,\n        value,\n        contractName: this.contractName,\n        contractAddress: this.address,\n        gasLimit,\n      })\n    }\n\n    let txReceipt: UserOperationReceipt\n    try {\n      txReceipt = await kernelClient.waitForUserOperationReceipt({\n        hash: userOpHash,\n        timeout: USEROP_RECEIPT_TIMEOUT_MS,\n      })\n    } catch (err) {\n      // The userOp is already in the bundler mempool — a client-side timeout\n      // does NOT cancel it. Surface userOpHash so callers can poll for eventual\n      // inclusion before retrying, otherwise a retry can produce a duplicate\n      // on-chain op. Wrap symmetric to `internalMulticallSmartAccount`.\n      throw new ContractsError(\n        `Calling method \"${name}\" on contract \"${this.contractName}\" timed out ` +\n          `waiting for UserOp receipt. userOpHash=${userOpHash} — confirm on-chain ` +\n          `inclusion before retrying. Underlying: ${err}`,\n      )\n    }\n\n    this.assertUserOpSucceeded(txReceipt, name, userOpHash)\n\n    if (progress) {\n      progress({\n        stage: 'receipt',\n        args: functionInputs,\n        txReceipt,\n        method: name,\n        from: from,\n        value,\n        contractName: this.contractName,\n        contractAddress: this.address,\n        gasLimit,\n      })\n    }\n\n    return txReceipt\n  }\n\n  private async internalSimulateSmartAccount(\n    name: string,\n    from: SmartAccount,\n    args: any[],\n    txparams: any,\n  ) {\n    try {\n      await this.client.public.simulateContract({\n        address: this.address,\n        abi: this.contract.abi,\n        functionName: name,\n        args,\n        account: from.address,\n        ...(txparams.value && { value: txparams.value }),\n      })\n      return true\n    } catch (err) {\n      throw new ContractSimulationError(\n        `Error Simulating contract call \"${name}\" on contract \"${this.contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n  }\n\n  private async localAccountSimulate(\n    name: string,\n    from: Account | `0x${string}`,\n    args: any[],\n    txparams: any,\n  ) {\n    try {\n      await this.client.public.simulateContract({\n        address: this.address,\n        abi: this.contract.abi,\n        functionName: name,\n        args,\n        account: from,\n        ...(txparams.value && { value: txparams.value }),\n      })\n    } catch (err) {\n      throw new ContractSimulationError(\n        `Error Simulating contract call \"${name}\" on contract \"${this.contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n    return true\n  }\n\n  private async localAccountSend(\n    name: string,\n    from: Account | `0x${string}`,\n    args: any[],\n    txparams: any,\n    progress: ((data: any) => void) | undefined,\n    _contractAbi?: Abi,\n    _contractAddress?: Address,\n    _contractName?: string,\n  ) {\n    const abi = _contractAbi || this.contract.abi\n    const contractAddress = _contractAddress || this.address\n    const contractName = _contractName || this.contractName\n\n    const functionInputs = getInputsOfFunctionFormatted(abi, name, args)\n    // Uncomment to debug contract calls\n    // if (name === 'order') {\n    //   const functionSignature = getSignatureOfFunction(this.contract.abi, name, args)\n    //   this.logger.info(`Making contract call ....: ${name} - ${from}`)\n    //   this.logger.info(`With args: `, JSON.stringify(args, jsonReplacer))\n    //   this.logger.info(`And signature: ${JSON.stringify(functionSignature, jsonReplacer)}`)\n    //   this.logger.info('And amount: ', txparams.value)\n    // }\n    //  abi.filter(({name, inputs}) => name === 'closeSignals' && inputs.length === 1)\n    // const abiFilter = this.contract.abi.filter((abi) => abi.name === name && abi.inputs.length === args.length)\n    // const abiFilter = this.contract.abi.filter((abi) => abi.name === name && abi.type === 'function')\n    // console.debug('abi', this.contract.abi.filter((abi) => abi.name === name))\n    // console.debug('abiFilter', abiFilter)\n    // if (!abiFilter)\n    //   throw new ContractsError(\n    //     `No ABI found for method \"${name}\" with ${args.length} arguments on contract \"${this.contractName}\"`,\n    //   )\n\n    const { gasLimit, value } = txparams\n    // make the call\n    if (progress) {\n      progress({\n        stage: 'sending',\n        args: functionInputs,\n        method: name,\n        from,\n        value,\n        contractName,\n        contractAddress,\n        gasLimit,\n      })\n    }\n\n    let txHash: `0x${string}` | undefined\n    try {\n      const { request } = await this.client.public.simulateContract({\n        address: contractAddress,\n        abi,\n        functionName: name,\n        args,\n        account: from,\n        ...(txparams.value && { value: txparams.value }),\n      })\n\n      // Resolve gas ourselves so `writeContract` never falls back to its own\n      // `eth_estimateGas`. An explicit caller `gasLimit` always wins; otherwise\n      // we estimate, apply the block-limit sanity check, and pin the result.\n      // If estimation itself fails we still honour any explicit cap.\n      let resolvedGas: bigint | undefined = gasLimit\n      if (resolvedGas === undefined) {\n        try {\n          const estimate = await this.client.public.estimateContractGas({\n            address: contractAddress,\n            abi,\n            functionName: name,\n            args,\n            account: from,\n            ...(txparams.value && { value: txparams.value }),\n          })\n          resolvedGas = capForBogusEstimate(estimate, this.logger)\n        } catch (estErr) {\n          this.logger.warn(\n            `estimateContractGas for \"${name}\" on \"${contractName}\" failed (${estErr}); ` +\n              `falling back to ${GAS_FALLBACK_CAP} to avoid a bogus RPC re-estimate in writeContract.`,\n          )\n          resolvedGas = GAS_FALLBACK_CAP\n        }\n      }\n\n      txHash = await this.client.wallet.writeContract({\n        ...request,\n        account: from,\n        gas: resolvedGas,\n      })\n    } catch (err) {\n      if (err instanceof BaseError) {\n        const revertError = err.walk((err) => err instanceof ContractFunctionRevertedError)\n        this.logger.error(`revertError: ${String(revertError)}`)\n      }\n      throw new ContractsError(\n        `Calling method \"${name}\" on contract \"${contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n\n    if (progress) {\n      progress({\n        stage: 'sent',\n        args: functionInputs,\n        txHash,\n        method: name,\n        from,\n        value,\n        contractName,\n        contractAddress,\n        gasLimit,\n      })\n    }\n    const txReceipt = getTransactionReceipt({ txHash, publicClient: this.client.public })\n\n    if (progress) {\n      progress({\n        stage: 'receipt',\n        args: functionInputs,\n        txReceipt,\n        method: name,\n        from,\n        value,\n        contractName,\n        contractAddress,\n        gasLimit,\n      })\n    }\n\n    return txReceipt\n  }\n\n  private async localAccountMulticall(\n    calls: MulticallEntry[],\n    from: Account,\n    txparams: any,\n    progress: ((data: any) => void) | undefined,\n  ): Promise<TransactionReceipt> {\n    const receipts: TransactionReceipt[] = []\n    for (const call of calls) {\n      receipts.push(\n        await this.localAccountSend(\n          call.functionName,\n          from,\n          call.args,\n          txparams,\n          progress,\n          call.abi,\n          call.contractAddress,\n          call.contractName,\n        ),\n      )\n    }\n    if (receipts.length > 0) return receipts.pop() as TransactionReceipt\n    else throw new ContractsError(`No receipts found for multicall`)\n  }\n\n  private async localAccountSimulateMulticall(\n    calls: SimulateMulticallEntry[],\n    from: Account,\n    txparams: any,\n  ) {\n    try {\n      const { results } = await this.client.public.simulateCalls({\n        calls,\n        account: from,\n      })\n      this.logger.debug(`Simulated multicall - ${results}`)\n      return true\n    } catch (err) {\n      if (err instanceof BaseError) {\n        const revertError = err.walk((err) => err instanceof ContractFunctionRevertedError)\n        this.logger.error(`revertError: ${String(revertError)}`)\n      }\n      throw new ContractsError(`Error simulating multicall - ${err}`)\n    }\n  }\n\n  private async internalSimulateMulticallSmartAccount(\n    calls: SimulateMulticallEntry[],\n    from: SmartAccount,\n    txparams: any,\n  ) {\n    try {\n      const kernelClient = createKernelAccountClient({\n        account: from,\n        chain: getChain(this.config.chainId),\n        bundlerTransport: http(this.getBundlerRPC()),\n        client: this.client.public,\n        ...this.getPaymasterConfig(),\n        userOperation: {\n          estimateFeesPerGas: async ({ bundlerClient }) => {\n            return estimateUserOperationFees(bundlerClient, this.client.public)\n          },\n        },\n      })\n\n      const encodedCalls = []\n      for (const call of calls) {\n        encodedCalls.push({\n          to: call.to,\n          value: call.value || 0n,\n          data: encodeFunctionData({\n            abi: call.abi,\n            functionName: call.functionName,\n            args: call.args,\n          }),\n        })\n      }\n\n      // DONT DELETE THE COMMENTED LINES - ARE NECESSARY FOR F***ING ZERODEV DEBUGGING\n\n      // this.logger.info(`Encoded multicall - ${JSON.stringify(encodedCalls, jsonReplacer)}`)\n      // const code = await this.client.public.getCode({ address: from.address })\n      // const isDeployed = code !== undefined && code !== '0x'\n      // this.logger.info(`++++++ Smart account ${from.address} deployment status: ${isDeployed ? 'DEPLOYED' : 'NOT DEPLOYED'}`)\n\n      // // Log account details\n      // this.logger.info(`Account type: ${from.type}`)\n      // this.logger.info(`Account address: ${from.address}`)\n\n      // // Log the calls being made\n      // this.logger.info(`Number of calls: ${encodedCalls.length}`)\n      // encodedCalls.forEach((call, index) => {\n      //   this.logger.info(`Call ${index}: to=${call.to}, value=${call.value}, data=${call.data.slice(0, 10)}...`)\n      // })\n\n      await kernelClient.prepareUserOperation({\n        callData: await kernelClient.account.encodeCalls(encodedCalls),\n      })\n\n      return true\n    } catch (err) {\n      this.logger.error(`Error details: ${JSON.stringify(err, null, 2)}`)\n      if (err instanceof BaseError) {\n        const revertError = err.walk((e) => e instanceof ContractFunctionRevertedError)\n        if (revertError) {\n          this.logger.error(`Revert error: ${String(revertError)}`)\n        }\n      }\n      throw new ContractSimulationError(`Error Simulating Multicalls - ${err}`)\n    }\n  }\n\n  private getOrCreatePaymaster() {\n    if (!this._zeroDevPaymaster) {\n      this._zeroDevPaymaster = createZeroDevPaymasterClient({\n        chain: getChain(this.config.chainId),\n        transport: http(this.getPaymasterRPC()),\n      })\n    }\n    return this._zeroDevPaymaster\n  }\n\n  /**\n   * Builds the `paymaster` partial for `createKernelAccountClient`. In relayer\n   * mode (e.g. local `ultra-relay` for tests) returns an empty object so the\n   * kernel client submits UserOps without paymaster fields and the bundler\n   * pays gas via its executor key. In production returns the ZeroDev paymaster\n   * sponsorship callback.\n   */\n  private getPaymasterConfig() {\n    if (isRelayerMode()) return {}\n    const zerodevPaymaster = this.getOrCreatePaymaster()\n    return {\n      paymaster: {\n        getPaymasterData: (userOperation: any) =>\n          zerodevPaymaster.sponsorUserOperation({ userOperation }),\n      },\n    }\n  }\n\n  protected getBundlerRPC(): string {\n    // In relayer mode `getBundlerRpcUrl` reads `BUNDLER_RPC_URL_OVERRIDE`\n    // and never touches the project id, so an empty value is harmless. In\n    // production callers must pass a project id — surface a clear error if\n    // the SDK was instantiated without one and we need it.\n    const projectId = this.config.zeroDevProjectId\n    if (!projectId && !isRelayerMode()) {\n      throw new ContractsError(\n        'getBundlerRPC: zeroDevProjectId is required for non-relayer (production) mode',\n      )\n    }\n    return getBundlerRpcUrl(projectId ?? '', this.config.chainId)\n  }\n\n  private getPaymasterRPC(): string {\n    // Only ever consulted when `getPaymasterConfig` decides to attach a\n    // paymaster, which is gated on `!isRelayerMode()`. A missing project\n    // id at this point is a configuration bug worth surfacing.\n    const projectId = this.config.zeroDevProjectId\n    if (!projectId) {\n      throw new ContractsError(\n        'getPaymasterRPC: zeroDevProjectId is required to build the paymaster URL',\n      )\n    }\n    return getPaymasterRpcUrl(projectId, this.config.chainId)\n  }\n}\n"],"names":["createKernelAccountClient","createZeroDevPaymasterClient","estimateUserOperationFees","getBundlerRpcUrl","getPaymasterRpcUrl","isRelayerMode","BaseError","ContractFunctionRevertedError","encodeFunctionData","getContract","http","parseAbi","parseEventLogs","ContractsError","ContractSimulationError","Instantiable","getInputsOfFunctionFormatted","getTransactionReceipt","getRandomBigInt","getChain","GAS_SANITY_THRESHOLD","GAS_FALLBACK_CAP","ZERODEV_NONCE_KEY_BITS","USEROP_RECEIPT_TIMEOUT_MS","capForBogusEstimate","estimatedGas","logger","warn","ContractBase","contractName","address","_zeroDevPaymaster","init","config","contractConfig","setInstanceConfig","contract","abi","client","public","publicClient","wallet","walletClient","call","functionName","args","from","readContract","account","err","txHash","hash","receipt","transactionHash","Error","getTransactionLogs","txReceipt","eventName","logs","strict","multicall","calls","params","type","debug","localAccountMulticall","progress","internalMulticallSmartAccount","simulateMulticall","localAccountSimulateMulticall","internalSimulateMulticallSmartAccount","simulate","localAccountSimulate","internalSimulateSmartAccount","send","localAccountSend","internalSendSmartAccount","txparams","stage","method","contractAddress","kernelClient","chain","chainId","bundlerTransport","getBundlerRPC","getPaymasterConfig","userOperation","estimateFeesPerGas","bundlerClient","encodedCalls","map","push","to","value","data","userOpHash","nonce","getNonce","key","sendUserOperation","callData","encodeCalls","waitForUserOperationReceipt","timeout","assertUserOpSucceeded","revertError","walk","error","String","hashSuffix","success","reason","name","functionInputs","gasLimit","simulateContract","_contractAbi","_contractAddress","_contractName","request","resolvedGas","undefined","estimate","estimateContractGas","estErr","writeContract","gas","receipts","length","pop","results","simulateCalls","prepareUserOperation","JSON","stringify","e","getOrCreatePaymaster","transport","getPaymasterRPC","zerodevPaymaster","paymaster","getPaymasterData","sponsorUserOperation","projectId","zeroDevProjectId"],"mappings":"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"}
+{"version":3,"sources":["../../src/contracts/ContractBase.ts"],"sourcesContent":["import { createKernelAccountClient, createZeroDevPaymasterClient } from '@zerodev/sdk'\nimport {\n  estimateUserOperationFees,\n  getBundlerRpcUrl,\n  getPaymasterRpcUrl,\n  isRelayerMode,\n} from '../nevermined/utils/BlockchainViemUtils.js'\nimport {\n  Abi,\n  Account,\n  Address,\n  BaseError,\n  ContractFunctionRevertedError,\n  encodeFunctionData,\n  getContract,\n  http,\n  parseAbi,\n  parseEventLogs,\n  TransactionReceipt,\n} from 'viem'\nimport {\n  createBundlerClient,\n  getUserOperationHash,\n  SmartAccount,\n  UserOperationReceipt,\n} from 'viem/account-abstraction'\nimport { ContractsError, ContractSimulationError } from '../errors/index.js'\nimport { Instantiable, InstantiableConfig } from '../Instantiable.abstract.js'\nimport { TxParameters } from '../models/Transactions.js'\nimport { getInputsOfFunctionFormatted, getTransactionReceipt } from '../nevermined/index.js'\nimport { getRandomBigInt } from '../utils/helpers.js'\nimport { getChain } from '../utils/Network.js'\n\nexport interface MulticallEntry {\n  contractName?: string\n  contractAddress: Address\n  abi: Abi\n  functionName: string\n  args: any[]\n}\n\n/**\n * When a testnet RPC (Base Sepolia) fails internally, some providers return\n * `eth_estimateGas` values equal to — or even above — the block gas limit\n * instead of a real error. Using that value causes the node to reject the tx\n * with `intrinsic gas too high` before it ever reaches the mempool.\n *\n * `writeContract` in viem re-estimates gas internally when `gas` isn't\n * already set on the request (viem's `simulateContract` only performs\n * `eth_call`, not `eth_estimateGas`). That means the naïve path has no\n * chance to intercept a bogus estimate. We run the estimation ourselves\n * here, sanity-check the result, and always pass an explicit gas value\n * into `writeContract` so it doesn't re-query the misbehaving RPC.\n */\nconst GAS_SANITY_THRESHOLD = 25_000_000n\nconst GAS_FALLBACK_CAP = 5_000_000n\n\n// EntryPoint v0.7: ZeroDev's `toKernelPluginManager` rejects `customNonceKey > maxUint16`.\n// 16 bits = 65 536 channels — collision probability for the SDK's expected concurrency\n// (k=2–5 parallel sends from one SCA) is negligible (< 0.02 %). High-fan-out callers\n// (k > 50) should consider a per-process monotonic counter instead. See issue #1579.\nconst ZERODEV_NONCE_KEY_BITS = 16\n\n// Client-side cap on `waitForUserOperationReceipt`. The userOp is already in the bundler\n// mempool when this fires — a client-side timeout does NOT cancel it. Callers that catch\n// the resulting `ContractsError` MUST poll `bundlerClient.getUserOperationReceipt(hash)`\n// before retrying; otherwise a retry can produce a duplicate on-chain op.\nconst USEROP_RECEIPT_TIMEOUT_MS = 90_000\n\nfunction capForBogusEstimate(\n  estimatedGas: bigint,\n  logger: { warn: (msg: string) => void },\n): bigint {\n  if (estimatedGas < GAS_SANITY_THRESHOLD) return estimatedGas\n  logger.warn(\n    `Estimated gas (${estimatedGas}) exceeds sanity threshold ` +\n      `(${GAS_SANITY_THRESHOLD}); overriding with ${GAS_FALLBACK_CAP} to bypass misbehaving RPC estimate.`,\n  )\n  return GAS_FALLBACK_CAP\n}\n\nexport interface SimulateMulticallEntry {\n  functionName: string\n  value?: bigint\n  abi: Abi\n  args: any[]\n  to: Address\n}\n\nexport abstract class ContractBase extends Instantiable {\n  public readonly contractName: string\n  public contract: any\n  public address: Address\n  private _zeroDevPaymaster: ReturnType<typeof createZeroDevPaymasterClient> | null = null\n\n  constructor(contractName: string, address: Address) {\n    super()\n    this.contractName = contractName\n    this.address = address\n  }\n\n  protected async init(\n    config: InstantiableConfig,\n    contractConfig: { address: `0x${string}`; abi: Abi },\n  ) {\n    this.setInstanceConfig(config)\n    this.address = contractConfig.address\n\n    this.contract = getContract({\n      address: contractConfig.address,\n      abi: contractConfig.abi,\n      client: { public: this.publicClient, wallet: this.walletClient },\n    })\n  }\n\n  public async call<T>(functionName: string, args: any[], from?: string): Promise<T> {\n    try {\n      return (await this.client.public.readContract({\n        address: this.address,\n        abi: this.contract.abi,\n        functionName: parseAbi([functionName]),\n        args,\n        ...(from && { account: from as `0x${string}` }),\n      })) as T\n      //return await this.contract[functionSignature](...args, { from })\n    } catch (err) {\n      throw new ContractsError(\n        `Calling method \"${functionName}\" on contract \"${this.contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n  }\n\n  public async getTransactionReceipt(\n    txHash: UserOperationReceipt | TransactionReceipt,\n  ): Promise<TransactionReceipt> {\n    // Get the transaction receipt depending on the type of txHash\n    if ('transactionHash' in txHash) {\n      // txHash is TransactionReceipt\n      return txHash\n    } else if ('userOpHash' in txHash) {\n      // txHash is UserOperationReceipt, fetch the actual receipt using the utility function with retry logic\n      const hash = txHash.receipt.transactionHash\n      return await getTransactionReceipt({\n        txHash: hash,\n        publicClient: this.client.public,\n      })\n    } else {\n      throw new Error('Unknown transaction type')\n    }\n  }\n\n  public getTransactionLogs(\n    txReceipt: TransactionReceipt | UserOperationReceipt,\n    eventName?: string,\n  ) {\n    return parseEventLogs({\n      abi: this.contract.abi,\n      logs: txReceipt.logs,\n      eventName,\n      strict: false,\n    }) as any[]\n  }\n\n  public async multicall(\n    calls: MulticallEntry[],\n    from: Account | SmartAccount,\n    params: TxParameters = {},\n  ) {\n    if (from.type === 'local') {\n      this.logger.debug(`Blockchain Multicall using Local account`)\n      return await this.localAccountMulticall(calls, from, params, params.progress)\n    } else if (from.type === 'json-rpc') {\n      this.logger.debug(`Blockchain Multicall using JSON-RPC account`)\n      return await this.localAccountMulticall(calls, from, params, params.progress)\n    } else if (from.type === 'smart') {\n      this.logger.debug(`Blockchain Multicall using ZeroDev account`)\n      return await this.internalMulticallSmartAccount(calls, from, params, params.progress)\n    } else {\n      throw new ContractsError(`Account not supported`)\n    }\n  }\n\n  public async simulateMulticall(\n    calls: SimulateMulticallEntry[],\n    from: Account | SmartAccount,\n    params: TxParameters = {},\n  ) {\n    if (from.type === 'local') {\n      this.logger.debug(`Simulating calls using Local account`)\n      return await this.localAccountSimulateMulticall(calls, from, params)\n    } else if (from.type === 'json-rpc') {\n      this.logger.debug(`Simulating calls using JSON-RPC account`)\n      return await this.localAccountSimulateMulticall(calls, from, params)\n    } else if (from.type === 'smart') {\n      this.logger.debug(`Simulating calls using Smart Account account`)\n      return await this.internalSimulateMulticallSmartAccount(calls, from, params)\n    } else {\n      throw new ContractsError(`Account not supported`)\n    }\n  }\n\n  public async simulate(\n    functionName: string,\n    from: Account | SmartAccount,\n    args: any[],\n    params: TxParameters = {},\n  ) {\n    if (from.type === 'local') {\n      this.logger.debug(`Simulating calls using Local account`)\n      return await this.localAccountSimulate(functionName, from, args, params)\n    } else if (from.type === 'json-rpc') {\n      this.logger.debug(`Simulating calls using JSON-RPC account`)\n      return await this.localAccountSimulate(functionName, from, args, params)\n    } else if (from.type === 'smart') {\n      this.logger.debug(`Simulating calls using Smart Account account`)\n      return await this.internalSimulateSmartAccount(functionName, from, args, params)\n    } else {\n      throw new ContractsError(`Account not supported`)\n    }\n  }\n\n  public async send(\n    functionName: string,\n    from: Account | SmartAccount,\n    args: any[],\n    params: TxParameters = {},\n  ): Promise<TransactionReceipt | UserOperationReceipt> {\n    if (from.type === 'local') {\n      this.logger.debug(\n        `Blockchain Send using Local account with functionName: ${functionName} and following args: ${args}`,\n      )\n      return await this.localAccountSend(functionName, from, args, params, params.progress)\n    } else if (from.type === 'json-rpc') {\n      this.logger.debug(`Blockchain Send using JSON-RPC account to ${functionName}`)\n      return await this.localAccountSend(functionName, from, args, params, params.progress)\n    } else if (from.type === 'smart') {\n      this.logger.debug(`Blockchain Send using ZeroDev account`)\n      return await this.internalSendSmartAccount(functionName, from, args, params, params.progress)\n    } else {\n      throw new ContractsError(`Account not supported`)\n    }\n  }\n\n  /**\n   * Poll a previously-submitted UserOperation's receipt by hash WITHOUT\n   * blocking. Returns the receipt once the bundler has mined it, or `null`\n   * while it is still in the mempool / not yet known. A client-side\n   * receipt-wait timeout does NOT cancel a submitted UserOp, so callers that\n   * persist the hash (e.g. the onchain-mirror worker, nvm-monorepo#1508) use\n   * this to confirm a prior submission instead of resubmitting a duplicate.\n   */\n  public async getUserOperationReceipt(hash: `0x${string}`): Promise<UserOperationReceipt | null> {\n    try {\n      const bundlerClient = createBundlerClient({\n        chain: getChain(this.config.chainId),\n        transport: http(this.getBundlerRPC()),\n        client: this.client.public,\n      })\n      return (await bundlerClient.getUserOperationReceipt({ hash })) ?? null\n    } catch (err) {\n      // A genuinely-absent receipt (UserOp still in the mempool) is expected\n      // and benign — some bundlers signal it by throwing rather than returning\n      // null. Anything else (RPC/transport/config fault) must NOT masquerade as\n      // \"still pending\": surface it at `warn` so a bundler outage is visible\n      // instead of silently driving the caller's grace-window logic. Either\n      // way we return null so the caller re-polls rather than consuming a retry.\n      const message = err instanceof Error ? err.message : String(err)\n      if (/not[\\s_]?found|UserOperationReceiptNotFound/i.test(message)) {\n        this.logger.debug(`getUserOperationReceipt(${hash}): not yet mined`)\n      } else {\n        // Redact URLs before logging: the bundler RPC URL embeds the ZeroDev\n        // project id, which should not leak into logs.\n        const safeMessage = message.replace(/https?:\\/\\/[^\\s'\")]+/gi, '<redacted-url>')\n        this.logger.warn(\n          `getUserOperationReceipt(${hash}) lookup error (treating as not-yet-mined): ${safeMessage}`,\n        )\n      }\n      return null\n    }\n  }\n\n  private async internalMulticallSmartAccount(\n    calls: MulticallEntry[],\n    from: SmartAccount,\n    txparams: any,\n    progress: ((data: any) => void) | undefined,\n  ) {\n    if (progress) {\n      progress({\n        stage: 'multicall-sending',\n        args: [],\n        method: '',\n        from: from,\n        contractAddress: this.address,\n      })\n    }\n\n    const kernelClient = createKernelAccountClient({\n      account: from,\n      chain: getChain(this.config.chainId),\n      bundlerTransport: http(this.getBundlerRPC()),\n      client: this.client.public,\n      ...this.getPaymasterConfig(),\n      userOperation: {\n        estimateFeesPerGas: async ({ bundlerClient }) => {\n          return estimateUserOperationFees(bundlerClient, this.client.public)\n        },\n      },\n    })\n\n    const encodedCalls: any[] = []\n    calls.map((call) => {\n      encodedCalls.push({\n        to: call.contractAddress || this.address,\n        value: txparams.value || 0n,\n        data: encodeFunctionData({\n          abi: call.abi,\n          functionName: call.functionName,\n          args: call.args,\n        }),\n      })\n    })\n\n    let userOpHash: `0x${string}` | undefined\n    try {\n      // Random nonce key per send so concurrent userOps from the same SCA\n      // hit distinct EntryPoint nonce channels instead of colliding on the\n      // default `customNonceKey=0n`. See issue #1579.\n      const nonce = await from.getNonce({ key: getRandomBigInt(ZERODEV_NONCE_KEY_BITS) })\n      userOpHash = await kernelClient.sendUserOperation({\n        callData: await kernelClient.account.encodeCalls(encodedCalls),\n        nonce,\n      })\n\n      if (progress) {\n        progress({\n          stage: 'multicall-sent',\n          args: [],\n          method: '',\n          from: from,\n          contractAddress: this.address,\n        })\n      }\n\n      // Wait for the transaction to be mined\n      this.logger.debug(`Waiting for transaction to be mined... ${userOpHash}`)\n      const txReceipt = await kernelClient.waitForUserOperationReceipt({\n        hash: userOpHash,\n        timeout: USEROP_RECEIPT_TIMEOUT_MS,\n      })\n      this.logger.debug(`Transaction mined - UserOperationHash: ${userOpHash}`)\n      this.logger.debug(\n        `Transaction receipt - TransactionHash: ${txReceipt.receipt.transactionHash}`,\n      )\n      this.assertUserOpSucceeded(txReceipt, 'multicall', userOpHash)\n      return txReceipt.receipt\n    } catch (err) {\n      if (err instanceof BaseError) {\n        const revertError = err.walk((err) => err instanceof ContractFunctionRevertedError)\n        this.logger.error(`revertError: ${String(revertError)}`)\n      }\n      // Surface userOpHash so callers can poll for eventual inclusion before\n      // retrying — a client-side receipt-wait timeout does NOT cancel the userOp.\n      const hashSuffix = userOpHash ? ` userOpHash=${userOpHash}` : ''\n      throw new ContractsError(`Multicall failed:${hashSuffix} ${err}`)\n    }\n  }\n\n  private assertUserOpSucceeded(\n    txReceipt: UserOperationReceipt,\n    method: string,\n    userOpHash: string,\n  ): void {\n    if (txReceipt.success) return\n    throw new ContractsError(\n      `UserOp inner call reverted for \"${method}\" on \"${this.contractName}\". ` +\n        `userOpHash=${userOpHash} txHash=${txReceipt.receipt.transactionHash} ` +\n        `reason=${txReceipt.reason ?? 'unknown'}`,\n    )\n  }\n\n  private async internalSendSmartAccount(\n    name: string,\n    from: SmartAccount,\n    args: any[],\n    txparams: any,\n    progress: ((data: any) => void) | undefined,\n  ): Promise<UserOperationReceipt> {\n    const functionInputs = getInputsOfFunctionFormatted(this.contract.abi, name, args)\n\n    const { gasLimit, value } = txparams\n    if (progress) {\n      progress({\n        stage: 'sending',\n        args: functionInputs,\n        method: name,\n        from: from,\n        value,\n        contractName: this.contractName,\n        contractAddress: this.address,\n        gasLimit,\n      })\n    }\n\n    try {\n      await this.client.public.simulateContract({\n        address: this.address,\n        abi: this.contract.abi,\n        functionName: name,\n        args,\n        account: from,\n        ...(txparams.value && { value: txparams.value }),\n      })\n    } catch (err) {\n      if (err instanceof BaseError) {\n        const revertError = err.walk((err) => err instanceof ContractFunctionRevertedError)\n        this.logger.error(`revertError: ${String(revertError)}`)\n      }\n      throw new ContractsError(\n        `Calling method \"${name}\" on contract \"${this.contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n\n    const kernelClient = createKernelAccountClient({\n      account: from,\n      chain: getChain(this.config.chainId),\n      bundlerTransport: http(this.getBundlerRPC()),\n      client: this.client.public,\n      ...this.getPaymasterConfig(),\n      userOperation: {\n        estimateFeesPerGas: async ({ bundlerClient }) => {\n          return estimateUserOperationFees(bundlerClient, this.client.public)\n        },\n      },\n    })\n    const data = encodeFunctionData({ abi: this.contract.abi, functionName: name, args })\n\n    let userOpHash\n    try {\n      // Random nonce key per send so concurrent userOps from the same SCA\n      // hit distinct EntryPoint nonce channels instead of colliding on the\n      // default `customNonceKey=0n`. See issue #1579.\n      const nonce = await from.getNonce({ key: getRandomBigInt(ZERODEV_NONCE_KEY_BITS) })\n      const callData = await kernelClient.account.encodeCalls([\n        {\n          to: this.address,\n          value: txparams.value || 0n,\n          data,\n        },\n      ])\n\n      // When a caller supplies a `progress` callback it may need the UserOp\n      // hash BEFORE the send completes — the onchain-mirror worker races the\n      // send against a per-tick deadline and must persist the hash even if the\n      // send is cut off mid-flight, otherwise it resubmits and double-burns\n      // (#1508/#1904). So prepare the UserOp here, surface its hash via\n      // `progress({stage:'prepared'})`, and send that exact prepared op so the\n      // bundler-returned hash matches. Best-effort and GATED ON `progress`:\n      // any failure falls back to the normal send, and callers that pass no\n      // progress callback keep the original send path byte-for-byte.\n      let preparedUserOp: Awaited<ReturnType<typeof kernelClient.prepareUserOperation>> | undefined\n      let preparedHash: `0x${string}` | undefined\n      if (progress) {\n        try {\n          preparedUserOp = await kernelClient.prepareUserOperation({ callData, nonce })\n          preparedHash = getUserOperationHash({\n            chainId: this.config.chainId,\n            entryPointAddress: from.entryPoint.address,\n            entryPointVersion: from.entryPoint.version,\n            userOperation: preparedUserOp,\n          })\n          progress({\n            stage: 'prepared',\n            args: functionInputs,\n            userOpHash: preparedHash,\n            method: name,\n            from: from,\n            value,\n            contractName: this.contractName,\n            contractAddress: this.address,\n            gasLimit,\n          })\n        } catch (prepErr) {\n          this.logger.warn(\n            `prepareUserOperation (pre-send hash) failed for \"${name}\"; ` +\n              `sending without an early hash: ${prepErr}`,\n          )\n          preparedUserOp = undefined\n          preparedHash = undefined\n        }\n      }\n\n      userOpHash = await kernelClient.sendUserOperation(\n        // Re-send the exact prepared op (stripping the estimation stub\n        // signature so the kernel re-signs) so the bundler hash matches the one\n        // emitted above. Falls back to the original {callData, nonce} path\n        // (which prepares internally) when no early hash was prepared.\n        preparedUserOp\n          ? ({ ...preparedUserOp, signature: undefined } as Parameters<\n              typeof kernelClient.sendUserOperation\n            >[0])\n          : { callData, nonce },\n      )\n\n      // Determinism guard: the 'prepared' hash should equal the bundler's. If a\n      // paymaster re-request changed the op it won't — a caller that persisted\n      // the 'prepared' hash then just fails to find it and reconciles safely\n      // (never a double-burn), but we log so we can see whether the early-hash\n      // path is actually holding in practice.\n      if (preparedHash && userOpHash !== preparedHash) {\n        this.logger.warn(\n          `UserOp 'prepared' hash ${preparedHash} != sent hash ${userOpHash} for \"${name}\"; ` +\n            `early-hash callers will reconcile via receipt-not-found`,\n        )\n      }\n    } catch (err) {\n      if (err instanceof BaseError) {\n        const revertError = err.walk((err) => err instanceof ContractFunctionRevertedError)\n        this.logger.error(`revertError: ${String(revertError)}`)\n      }\n      throw new ContractsError(\n        `Calling method \"${name}\" on contract \"${this.contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n\n    if (progress) {\n      progress({\n        stage: 'sent',\n        args: functionInputs,\n        userOpHash,\n        method: name,\n        from: from,\n        value,\n        contractName: this.contractName,\n        contractAddress: this.address,\n        gasLimit,\n      })\n    }\n\n    let txReceipt: UserOperationReceipt\n    try {\n      txReceipt = await kernelClient.waitForUserOperationReceipt({\n        hash: userOpHash,\n        timeout: USEROP_RECEIPT_TIMEOUT_MS,\n      })\n    } catch (err) {\n      // The userOp is already in the bundler mempool — a client-side timeout\n      // does NOT cancel it. Surface userOpHash so callers can poll for eventual\n      // inclusion before retrying, otherwise a retry can produce a duplicate\n      // on-chain op. Wrap symmetric to `internalMulticallSmartAccount`.\n      throw new ContractsError(\n        `Calling method \"${name}\" on contract \"${this.contractName}\" timed out ` +\n          `waiting for UserOp receipt. userOpHash=${userOpHash} — confirm on-chain ` +\n          `inclusion before retrying. Underlying: ${err}`,\n      )\n    }\n\n    this.assertUserOpSucceeded(txReceipt, name, userOpHash)\n\n    if (progress) {\n      progress({\n        stage: 'receipt',\n        args: functionInputs,\n        txReceipt,\n        method: name,\n        from: from,\n        value,\n        contractName: this.contractName,\n        contractAddress: this.address,\n        gasLimit,\n      })\n    }\n\n    return txReceipt\n  }\n\n  private async internalSimulateSmartAccount(\n    name: string,\n    from: SmartAccount,\n    args: any[],\n    txparams: any,\n  ) {\n    try {\n      await this.client.public.simulateContract({\n        address: this.address,\n        abi: this.contract.abi,\n        functionName: name,\n        args,\n        account: from.address,\n        ...(txparams.value && { value: txparams.value }),\n      })\n      return true\n    } catch (err) {\n      throw new ContractSimulationError(\n        `Error Simulating contract call \"${name}\" on contract \"${this.contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n  }\n\n  private async localAccountSimulate(\n    name: string,\n    from: Account | `0x${string}`,\n    args: any[],\n    txparams: any,\n  ) {\n    try {\n      await this.client.public.simulateContract({\n        address: this.address,\n        abi: this.contract.abi,\n        functionName: name,\n        args,\n        account: from,\n        ...(txparams.value && { value: txparams.value }),\n      })\n    } catch (err) {\n      throw new ContractSimulationError(\n        `Error Simulating contract call \"${name}\" on contract \"${this.contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n    return true\n  }\n\n  private async localAccountSend(\n    name: string,\n    from: Account | `0x${string}`,\n    args: any[],\n    txparams: any,\n    progress: ((data: any) => void) | undefined,\n    _contractAbi?: Abi,\n    _contractAddress?: Address,\n    _contractName?: string,\n  ) {\n    const abi = _contractAbi || this.contract.abi\n    const contractAddress = _contractAddress || this.address\n    const contractName = _contractName || this.contractName\n\n    const functionInputs = getInputsOfFunctionFormatted(abi, name, args)\n    // Uncomment to debug contract calls\n    // if (name === 'order') {\n    //   const functionSignature = getSignatureOfFunction(this.contract.abi, name, args)\n    //   this.logger.info(`Making contract call ....: ${name} - ${from}`)\n    //   this.logger.info(`With args: `, JSON.stringify(args, jsonReplacer))\n    //   this.logger.info(`And signature: ${JSON.stringify(functionSignature, jsonReplacer)}`)\n    //   this.logger.info('And amount: ', txparams.value)\n    // }\n    //  abi.filter(({name, inputs}) => name === 'closeSignals' && inputs.length === 1)\n    // const abiFilter = this.contract.abi.filter((abi) => abi.name === name && abi.inputs.length === args.length)\n    // const abiFilter = this.contract.abi.filter((abi) => abi.name === name && abi.type === 'function')\n    // console.debug('abi', this.contract.abi.filter((abi) => abi.name === name))\n    // console.debug('abiFilter', abiFilter)\n    // if (!abiFilter)\n    //   throw new ContractsError(\n    //     `No ABI found for method \"${name}\" with ${args.length} arguments on contract \"${this.contractName}\"`,\n    //   )\n\n    const { gasLimit, value } = txparams\n    // make the call\n    if (progress) {\n      progress({\n        stage: 'sending',\n        args: functionInputs,\n        method: name,\n        from,\n        value,\n        contractName,\n        contractAddress,\n        gasLimit,\n      })\n    }\n\n    let txHash: `0x${string}` | undefined\n    try {\n      const { request } = await this.client.public.simulateContract({\n        address: contractAddress,\n        abi,\n        functionName: name,\n        args,\n        account: from,\n        ...(txparams.value && { value: txparams.value }),\n      })\n\n      // Resolve gas ourselves so `writeContract` never falls back to its own\n      // `eth_estimateGas`. An explicit caller `gasLimit` always wins; otherwise\n      // we estimate, apply the block-limit sanity check, and pin the result.\n      // If estimation itself fails we still honour any explicit cap.\n      let resolvedGas: bigint | undefined = gasLimit\n      if (resolvedGas === undefined) {\n        try {\n          const estimate = await this.client.public.estimateContractGas({\n            address: contractAddress,\n            abi,\n            functionName: name,\n            args,\n            account: from,\n            ...(txparams.value && { value: txparams.value }),\n          })\n          resolvedGas = capForBogusEstimate(estimate, this.logger)\n        } catch (estErr) {\n          this.logger.warn(\n            `estimateContractGas for \"${name}\" on \"${contractName}\" failed (${estErr}); ` +\n              `falling back to ${GAS_FALLBACK_CAP} to avoid a bogus RPC re-estimate in writeContract.`,\n          )\n          resolvedGas = GAS_FALLBACK_CAP\n        }\n      }\n\n      txHash = await this.client.wallet.writeContract({\n        ...request,\n        account: from,\n        gas: resolvedGas,\n      })\n    } catch (err) {\n      if (err instanceof BaseError) {\n        const revertError = err.walk((err) => err instanceof ContractFunctionRevertedError)\n        this.logger.error(`revertError: ${String(revertError)}`)\n      }\n      throw new ContractsError(\n        `Calling method \"${name}\" on contract \"${contractName}\" failed. Args: ${args} - ${err}`,\n      )\n    }\n\n    if (progress) {\n      progress({\n        stage: 'sent',\n        args: functionInputs,\n        txHash,\n        method: name,\n        from,\n        value,\n        contractName,\n        contractAddress,\n        gasLimit,\n      })\n    }\n    const txReceipt = getTransactionReceipt({ txHash, publicClient: this.client.public })\n\n    if (progress) {\n      progress({\n        stage: 'receipt',\n        args: functionInputs,\n        txReceipt,\n        method: name,\n        from,\n        value,\n        contractName,\n        contractAddress,\n        gasLimit,\n      })\n    }\n\n    return txReceipt\n  }\n\n  private async localAccountMulticall(\n    calls: MulticallEntry[],\n    from: Account,\n    txparams: any,\n    progress: ((data: any) => void) | undefined,\n  ): Promise<TransactionReceipt> {\n    const receipts: TransactionReceipt[] = []\n    for (const call of calls) {\n      receipts.push(\n        await this.localAccountSend(\n          call.functionName,\n          from,\n          call.args,\n          txparams,\n          progress,\n          call.abi,\n          call.contractAddress,\n          call.contractName,\n        ),\n      )\n    }\n    if (receipts.length > 0) return receipts.pop() as TransactionReceipt\n    else throw new ContractsError(`No receipts found for multicall`)\n  }\n\n  private async localAccountSimulateMulticall(\n    calls: SimulateMulticallEntry[],\n    from: Account,\n    txparams: any,\n  ) {\n    try {\n      const { results } = await this.client.public.simulateCalls({\n        calls,\n        account: from,\n      })\n      this.logger.debug(`Simulated multicall - ${results}`)\n      return true\n    } catch (err) {\n      if (err instanceof BaseError) {\n        const revertError = err.walk((err) => err instanceof ContractFunctionRevertedError)\n        this.logger.error(`revertError: ${String(revertError)}`)\n      }\n      throw new ContractsError(`Error simulating multicall - ${err}`)\n    }\n  }\n\n  private async internalSimulateMulticallSmartAccount(\n    calls: SimulateMulticallEntry[],\n    from: SmartAccount,\n    txparams: any,\n  ) {\n    try {\n      const kernelClient = createKernelAccountClient({\n        account: from,\n        chain: getChain(this.config.chainId),\n        bundlerTransport: http(this.getBundlerRPC()),\n        client: this.client.public,\n        ...this.getPaymasterConfig(),\n        userOperation: {\n          estimateFeesPerGas: async ({ bundlerClient }) => {\n            return estimateUserOperationFees(bundlerClient, this.client.public)\n          },\n        },\n      })\n\n      const encodedCalls = []\n      for (const call of calls) {\n        encodedCalls.push({\n          to: call.to,\n          value: call.value || 0n,\n          data: encodeFunctionData({\n            abi: call.abi,\n            functionName: call.functionName,\n            args: call.args,\n          }),\n        })\n      }\n\n      // DONT DELETE THE COMMENTED LINES - ARE NECESSARY FOR F***ING ZERODEV DEBUGGING\n\n      // this.logger.info(`Encoded multicall - ${JSON.stringify(encodedCalls, jsonReplacer)}`)\n      // const code = await this.client.public.getCode({ address: from.address })\n      // const isDeployed = code !== undefined && code !== '0x'\n      // this.logger.info(`++++++ Smart account ${from.address} deployment status: ${isDeployed ? 'DEPLOYED' : 'NOT DEPLOYED'}`)\n\n      // // Log account details\n      // this.logger.info(`Account type: ${from.type}`)\n      // this.logger.info(`Account address: ${from.address}`)\n\n      // // Log the calls being made\n      // this.logger.info(`Number of calls: ${encodedCalls.length}`)\n      // encodedCalls.forEach((call, index) => {\n      //   this.logger.info(`Call ${index}: to=${call.to}, value=${call.value}, data=${call.data.slice(0, 10)}...`)\n      // })\n\n      await kernelClient.prepareUserOperation({\n        callData: await kernelClient.account.encodeCalls(encodedCalls),\n      })\n\n      return true\n    } catch (err) {\n      this.logger.error(`Error details: ${JSON.stringify(err, null, 2)}`)\n      if (err instanceof BaseError) {\n        const revertError = err.walk((e) => e instanceof ContractFunctionRevertedError)\n        if (revertError) {\n          this.logger.error(`Revert error: ${String(revertError)}`)\n        }\n      }\n      throw new ContractSimulationError(`Error Simulating Multicalls - ${err}`)\n    }\n  }\n\n  private getOrCreatePaymaster() {\n    if (!this._zeroDevPaymaster) {\n      this._zeroDevPaymaster = createZeroDevPaymasterClient({\n        chain: getChain(this.config.chainId),\n        transport: http(this.getPaymasterRPC()),\n      })\n    }\n    return this._zeroDevPaymaster\n  }\n\n  /**\n   * Builds the `paymaster` partial for `createKernelAccountClient`. In relayer\n   * mode (e.g. local `ultra-relay` for tests) returns an empty object so the\n   * kernel client submits UserOps without paymaster fields and the bundler\n   * pays gas via its executor key. In production returns the ZeroDev paymaster\n   * sponsorship callback.\n   */\n  private getPaymasterConfig() {\n    if (isRelayerMode()) return {}\n    const zerodevPaymaster = this.getOrCreatePaymaster()\n    return {\n      paymaster: {\n        getPaymasterData: (userOperation: any) =>\n          zerodevPaymaster.sponsorUserOperation({ userOperation }),\n      },\n    }\n  }\n\n  protected getBundlerRPC(): string {\n    // In relayer mode `getBundlerRpcUrl` reads `BUNDLER_RPC_URL_OVERRIDE`\n    // and never touches the project id, so an empty value is harmless. In\n    // production callers must pass a project id — surface a clear error if\n    // the SDK was instantiated without one and we need it.\n    const projectId = this.config.zeroDevProjectId\n    if (!projectId && !isRelayerMode()) {\n      throw new ContractsError(\n        'getBundlerRPC: zeroDevProjectId is required for non-relayer (production) mode',\n      )\n    }\n    return getBundlerRpcUrl(projectId ?? '', this.config.chainId, this.config.useUltraRelay)\n  }\n\n  private getPaymasterRPC(): string {\n    // Only ever consulted when `getPaymasterConfig` decides to attach a\n    // paymaster, which is gated on `!isRelayerMode()`. A missing project\n    // id at this point is a configuration bug worth surfacing.\n    const projectId = this.config.zeroDevProjectId\n    if (!projectId) {\n      throw new ContractsError(\n        'getPaymasterRPC: zeroDevProjectId is required to build the paymaster URL',\n      )\n    }\n    return getPaymasterRpcUrl(projectId, this.config.chainId)\n  }\n}\n"],"names":["createKernelAccountClient","createZeroDevPaymasterClient","estimateUserOperationFees","getBundlerRpcUrl","getPaymasterRpcUrl","isRelayerMode","BaseError","ContractFunctionRevertedError","encodeFunctionData","getContract","http","parseAbi","parseEventLogs","createBundlerClient","getUserOperationHash","ContractsError","ContractSimulationError","Instantiable","getInputsOfFunctionFormatted","getTransactionReceipt","getRandomBigInt","getChain","GAS_SANITY_THRESHOLD","GAS_FALLBACK_CAP","ZERODEV_NONCE_KEY_BITS","USEROP_RECEIPT_TIMEOUT_MS","capForBogusEstimate","estimatedGas","logger","warn","ContractBase","contractName","address","_zeroDevPaymaster","init","config","contractConfig","setInstanceConfig","contract","abi","client","public","publicClient","wallet","walletClient","call","functionName","args","from","readContract","account","err","txHash","hash","receipt","transactionHash","Error","getTransactionLogs","txReceipt","eventName","logs","strict","multicall","calls","params","type","debug","localAccountMulticall","progress","internalMulticallSmartAccount","simulateMulticall","localAccountSimulateMulticall","internalSimulateMulticallSmartAccount","simulate","localAccountSimulate","internalSimulateSmartAccount","send","localAccountSend","internalSendSmartAccount","getUserOperationReceipt","bundlerClient","chain","chainId","transport","getBundlerRPC","message","String","test","safeMessage","replace","txparams","stage","method","contractAddress","kernelClient","bundlerTransport","getPaymasterConfig","userOperation","estimateFeesPerGas","encodedCalls","map","push","to","value","data","userOpHash","nonce","getNonce","key","sendUserOperation","callData","encodeCalls","waitForUserOperationReceipt","timeout","assertUserOpSucceeded","revertError","walk","error","hashSuffix","success","reason","name","functionInputs","gasLimit","simulateContract","preparedUserOp","preparedHash","prepareUserOperation","entryPointAddress","entryPoint","entryPointVersion","version","prepErr","undefined","signature","_contractAbi","_contractAddress","_contractName","request","resolvedGas","estimate","estimateContractGas","estErr","writeContract","gas","receipts","length","pop","results","simulateCalls","JSON","stringify","e","getOrCreatePaymaster","getPaymasterRPC","zerodevPaymaster","paymaster","getPaymasterData","sponsorUserOperation","projectId","zeroDevProjectId","useUltraRelay"],"mappings":"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"}

package/dist/models/AgentX402AccessToken.d.ts

@@ -37,6 +37,13 @@ export type X402Erc4337Payload = {
             id: string;
             data: string;
         }[];
+        /**
+         * Signed planId (#1678). Present on v2 tokens (minted after #1678) and
+         * covered by the EIP-712 signature, so it is tamper-evident on its own.
+         * OPTIONAL on the wire type only for backwards-compat: genuinely-old v1
+         * tokens carry no `planId` here and verify against the legacy type list.
+         */
+        planId?: string;
     };
 };
 /**
@@ -69,6 +76,16 @@ export type NeverminedTypedDataDomain = {
     chainId: number;
     verifyingContract: `0x${string}`;
 };
+/**
+ * EIP-712 `Authorization` struct WITH a signed `planId` (#1678).
+ *
+ * `planId` is appended LAST so the change is purely additive to the EIP-712
+ * encoding of the legacy (v1) struct. Signing the planId makes the token's plan
+ * tamper-evident on its own — defense-in-depth atop the resource server's
+ * `validateAcceptedMatchesRequirements` demand-match, which remains the primary
+ * gate. See `NeverminedTypedDataTypesV1` for the legacy struct that pre-#1678
+ * tokens were signed over; both shapes verify against the same signer.
+ */
 export type NeverminedTypedData = {
     SessionKey: [{
         name: 'id';
@@ -93,11 +110,55 @@ export type NeverminedTypedData = {
         {
             name: 'sessionKeys';
             type: 'SessionKey[]';
+        },
+        {
+            name: 'planId';
+            type: 'string';
         }
     ];
 };
 export declare const NeverminedTypedDataTypes: NeverminedTypedData;
-export type NeverminedTypedDataMessage = {
+/**
+ * Legacy (v1) EIP-712 `Authorization` struct — WITHOUT a signed `planId`.
+ *
+ * Retained so `verifyAgentX402AccessToken` can still validate genuinely-old
+ * tokens minted before #1678 (their `authorization` carries no `planId`, and
+ * EIP-712 hashes the type set, so they only verify against THIS type list).
+ * Mint always produces the v2 (with-planId) shape going forward.
+ */
+export type NeverminedTypedDataV1 = {
+    SessionKey: [{
+        name: 'id';
+        type: 'string';
+    }, {
+        name: 'data';
+        type: 'string';
+    }];
+    SessionKeys: [{
+        name: 'sessionKeys';
+        type: 'SessionKey[]';
+    }];
+    Authorization: [
+        {
+            name: 'from';
+            type: 'address';
+        },
+        {
+            name: 'sessionKeysProvider';
+            type: 'string';
+        },
+        {
+            name: 'sessionKeys';
+            type: 'SessionKey[]';
+        }
+    ];
+};
+export declare const NeverminedTypedDataTypesV1: NeverminedTypedDataV1;
+/**
+ * Legacy (v1) signed message shape — no `planId`. Mirrors `NeverminedTypedDataTypesV1`.
+ * Only genuinely-old tokens carry this shape; mint never produces it.
+ */
+export type NeverminedTypedDataMessageV1 = {
     from: `0x${string}`;
     sessionKeysProvider: string;
     sessionKeys: {
@@ -105,6 +166,15 @@ export type NeverminedTypedDataMessage = {
         data: string;
     }[];
 };
+/**
+ * The v2 signed message shape — `planId` is REQUIRED. Mint always produces this
+ * shape (#1678), so `planId` is non-optional here; the v1 variant above models
+ * the legacy no-planId message. Mirrors `NeverminedTypedDataTypes`.
+ */
+export type NeverminedTypedDataMessage = NeverminedTypedDataMessageV1 & {
+    /** Signed planId (#1678) — always present on v2 (minted) tokens. */
+    planId: string;
+};
 /**
  * Options for generating an x402 access token
  */
@@ -130,7 +200,42 @@ export type GenerateX402TokenOptions = {
  */
 export declare const generateAgentX402AccessToken: (options: GenerateX402TokenOptions) => Promise<AgentX402AccessToken>;
 /**
- * Verify an x402 access token signature
+ * True when `authorization` carries a GENUINE signed planId (#1678) — a present,
+ * non-empty string. This is the single v1/v2 discriminator: verification keys off
+ * it to choose the matching EIP-712 type list, the handler keys off it to decide
+ * whether the signed-vs-unsigned consistency guard fires. Keying off genuine
+ * presence (not just `'planId' in authorization`) ensures a `planId: ''` / nullish
+ * value can never be mistaken for a real signed claim.
+ */
+export declare const hasSignedPlanId: (authorization: X402Erc4337Payload["authorization"]) => authorization is X402Erc4337Payload["authorization"] & {
+    planId: string;
+};
+/**
+ * The signed-vs-unsigned planId consistency invariant (#1678), co-located with
+ * `hasSignedPlanId` so signer, verifier, and the API handler share ONE
+ * definition (no drift between where the planId is signed and where the guard
+ * enforces it).
+ *
+ * For a v2 token (signed planId present) the tamperable unsigned `accepted.planId`
+ * MUST exactly equal the signed `authorization.planId` — anything else is a
+ * post-signing edit of the outer JSON. Returns `true` for v1 tokens (no signed
+ * planId): there is no signed value to be consistent with, so the guard does not
+ * apply (the caller handles the legacy fallback separately). The API handler maps
+ * a `false` result to its forgery-gated rejection.
+ */
+export declare const isSignedPlanIdConsistent: (authorization: X402Erc4337Payload["authorization"], acceptedPlanId: string | null | undefined) => boolean;
+/**
+ * Verify an x402 access token signature.
+ *
+ * EIP-712 hashes the type set, so a token signed over the v2 (with-planId)
+ * struct cannot verify against the v1 type list and vice-versa. We therefore
+ * detect which shape the token carries (genuine signed planId → v2) and verify
+ * against the matching type list. This keeps genuinely-old v1 tokens valid
+ * (#1678 backwards-compat) while v2 tokens are checked over the signed planId.
+ *
+ * Downgrade-safe: a v2 token was signed over the with-planId digest, so stripping
+ * `authorization.planId` to force the v1 branch changes the digest and the
+ * signature fails — an attacker cannot demote a signed token to dodge the planId.
  *
  * @param accessToken - The x402 access token to verify
  * @param publicClient - Viem public client

package/dist/models/AgentX402AccessToken.d.ts.map

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

package/dist/models/AgentX402AccessToken.js

@@ -1,5 +1,41 @@
 import { keccak256, toBytes } from 'viem';
 export const NeverminedTypedDataTypes = {
+    SessionKey: [
+        {
+            name: 'id',
+            type: 'string'
+        },
+        {
+            name: 'data',
+            type: 'string'
+        }
+    ],
+    SessionKeys: [
+        {
+            name: 'sessionKeys',
+            type: 'SessionKey[]'
+        }
+    ],
+    Authorization: [
+        {
+            name: 'from',
+            type: 'address'
+        },
+        {
+            name: 'sessionKeysProvider',
+            type: 'string'
+        },
+        {
+            name: 'sessionKeys',
+            type: 'SessionKey[]'
+        },
+        {
+            name: 'planId',
+            type: 'string'
+        }
+    ]
+};
+export const NeverminedTypedDataTypesV1 = {
     SessionKey: [
         {
             name: 'id',
@@ -38,10 +74,20 @@ export const NeverminedTypedDataTypes = {
  * @returns x402 access token with EIP-712 signature
  */ export const generateAgentX402AccessToken = async (options)=>{
     const { subscriber, orderSessionKey, redeemSessionKey, publicClient, planId, schemeVersion = '1', agentId, resource, httpVerb, validUntil } = options;
+    // A v2 token MUST carry a non-empty signed planId (#1678) — an empty/blank
+    // planId would otherwise be signed into `authorization.planId` and could be
+    // misread as a "present but empty" signed claim, blurring the v1/v2 boundary
+    // that verification keys off genuine presence. erc4337 already requires a
+    // planId upstream (`validateX402TokenStructure`), so this is a hard invariant.
+    if (typeof planId !== 'string' || planId.trim() === '') {
+        throw new Error('generateAgentX402AccessToken: planId is required and must be a non-empty string');
+    }
     // hash the session keys
     const redeemSessionKeyHash = keccak256(toBytes(redeemSessionKey));
     const orderSessionKeyHash = keccak256(toBytes(orderSessionKey));
-    // generate the message with `from` address
+    // generate the message with `from` address and the SIGNED planId (#1678).
+    // Including `planId` here puts it inside the EIP-712 digest, so it cannot be
+    // altered without invalidating the signature.
     const message = {
         from: subscriber.address,
         sessionKeysProvider: 'zerodev',
@@ -54,7 +100,8 @@ export const NeverminedTypedDataTypes = {
                 id: 'redeem',
                 data: redeemSessionKeyHash
             }
-        ]
+        ],
+        planId
     };
     const domain = {
         name: 'Nevermined',
@@ -103,7 +150,43 @@ export const NeverminedTypedDataTypes = {
     };
 };
 /**
- * Verify an x402 access token signature
+ * True when `authorization` carries a GENUINE signed planId (#1678) — a present,
+ * non-empty string. This is the single v1/v2 discriminator: verification keys off
+ * it to choose the matching EIP-712 type list, the handler keys off it to decide
+ * whether the signed-vs-unsigned consistency guard fires. Keying off genuine
+ * presence (not just `'planId' in authorization`) ensures a `planId: ''` / nullish
+ * value can never be mistaken for a real signed claim.
+ */ export const hasSignedPlanId = (authorization)=>{
+    return typeof authorization?.planId === 'string' && authorization.planId.trim() !== '';
+};
+/**
+ * The signed-vs-unsigned planId consistency invariant (#1678), co-located with
+ * `hasSignedPlanId` so signer, verifier, and the API handler share ONE
+ * definition (no drift between where the planId is signed and where the guard
+ * enforces it).
+ *
+ * For a v2 token (signed planId present) the tamperable unsigned `accepted.planId`
+ * MUST exactly equal the signed `authorization.planId` — anything else is a
+ * post-signing edit of the outer JSON. Returns `true` for v1 tokens (no signed
+ * planId): there is no signed value to be consistent with, so the guard does not
+ * apply (the caller handles the legacy fallback separately). The API handler maps
+ * a `false` result to its forgery-gated rejection.
+ */ export const isSignedPlanIdConsistent = (authorization, acceptedPlanId)=>{
+    if (!hasSignedPlanId(authorization)) return true;
+    return acceptedPlanId === authorization.planId;
+};
+/**
+ * Verify an x402 access token signature.
+ *
+ * EIP-712 hashes the type set, so a token signed over the v2 (with-planId)
+ * struct cannot verify against the v1 type list and vice-versa. We therefore
+ * detect which shape the token carries (genuine signed planId → v2) and verify
+ * against the matching type list. This keeps genuinely-old v1 tokens valid
+ * (#1678 backwards-compat) while v2 tokens are checked over the signed planId.
+ *
+ * Downgrade-safe: a v2 token was signed over the with-planId digest, so stripping
+ * `authorization.planId` to force the v1 branch changes the digest and the
+ * signature fails — an attacker cannot demote a signed token to dodge the planId.
  *
  * @param accessToken - The x402 access token to verify
  * @param publicClient - Viem public client
@@ -122,7 +205,9 @@ export const NeverminedTypedDataTypes = {
     const isValid = await publicClient.verifyTypedData({
         address: subscriberAddress,
         signature,
-        types: NeverminedTypedDataTypes,
+        // v2 (signed planId) verifies over the with-planId type list; legacy v1
+        // tokens (no signed planId) verify over the original type list.
+        types: hasSignedPlanId(authorization) ? NeverminedTypedDataTypes : NeverminedTypedDataTypesV1,
         domain,
         message: authorization,
         primaryType: 'Authorization'

package/dist/models/AgentX402AccessToken.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/models/AgentX402AccessToken.ts"],"sourcesContent":["import { keccak256, PublicClient, toBytes, TypedDataDefinition } from 'viem'\nimport { SmartAccount } from 'viem/account-abstraction'\n\n/**\n * x402 Resource information\n */\nexport type X402Resource = {\n  url: string\n  description?: string\n  mimeType?: string\n}\n\n/**\n * Supported x402 payment schemes\n */\nexport type X402Scheme = 'nvm:erc4337' | 'nvm:card-delegation'\n\n/**\n * x402 Accepted scheme fields (common to all schemes)\n */\nexport type X402Accepted = {\n  scheme: X402Scheme\n  network: string\n  planId?: string\n  extra: {\n    version: string\n    agentId?: string\n    httpVerb?: string\n  }\n}\n\n/**\n * Payload specific to the nvm:erc4337 scheme\n */\nexport type X402Erc4337Payload = {\n  signature: `0x${string}`\n  authorization: {\n    from: `0x${string}`\n    sessionKeysProvider: string\n    sessionKeys: { id: string; data: string }[]\n  }\n}\n\n/**\n * Payload specific to the nvm:card-delegation scheme\n */\nexport type X402CardDelegationPayload = {\n  token: string\n}\n\n/**\n * x402 Access Token aligned with x402 v2 spec\n *\n * Key changes from previous version:\n * - `subscriberAddress` moved to `payload.authorization.from`\n * - `planId` is now in `accepted` (optional — required for erc4337, optional for card-delegation)\n * - `agentId` moved to `accepted.extra.agentId` (optional)\n * - `scheme` and `network` moved to `accepted`\n * - Added `resource` and `extensions` for x402 v2 alignment\n */\nexport type AgentX402AccessToken = {\n  x402Version: 2\n  resource?: X402Resource\n  accepted: X402Accepted\n  payload: X402Erc4337Payload | X402CardDelegationPayload\n  validUntil?: number\n  extensions: Record<string, unknown>\n}\n\nexport type NeverminedTypedDataDomain = {\n  name: 'Nevermined'\n  version: '1'\n  chainId: number\n  verifyingContract: `0x${string}`\n}\n\nexport type NeverminedTypedData = {\n  SessionKey: [{ name: 'id'; type: 'string' }, { name: 'data'; type: 'string' }]\n  SessionKeys: [{ name: 'sessionKeys'; type: 'SessionKey[]' }]\n  Authorization: [\n    { name: 'from'; type: 'address' },\n    { name: 'sessionKeysProvider'; type: 'string' },\n    { name: 'sessionKeys'; type: 'SessionKey[]' },\n  ]\n}\n\nexport const NeverminedTypedDataTypes: NeverminedTypedData = {\n  SessionKey: [\n    { name: 'id', type: 'string' },\n    { name: 'data', type: 'string' },\n  ],\n  SessionKeys: [{ name: 'sessionKeys', type: 'SessionKey[]' }],\n  Authorization: [\n    { name: 'from', type: 'address' },\n    { name: 'sessionKeysProvider', type: 'string' },\n    { name: 'sessionKeys', type: 'SessionKey[]' },\n  ],\n}\n\nexport type NeverminedTypedDataMessage = {\n  from: `0x${string}`\n  sessionKeysProvider: string\n  sessionKeys: { id: string; data: string }[]\n}\n\n/**\n * Options for generating an x402 access token\n */\nexport type GenerateX402TokenOptions = {\n  subscriber: SmartAccount\n  orderSessionKey: string\n  redeemSessionKey: string\n  publicClient: PublicClient\n  planId: string\n  /** Scheme version (e.g., '1') - stored in accepted.extra.version */\n  schemeVersion?: string\n  agentId?: string\n  resource?: X402Resource\n  httpVerb?: string\n  /** Token expiration timestamp in seconds (Unix epoch) */\n  validUntil?: number\n}\n\n/**\n * Generate an x402 access token aligned with x402 v2 spec\n *\n * @param options - Token generation options\n * @returns x402 access token with EIP-712 signature\n */\nexport const generateAgentX402AccessToken = async (\n  options: GenerateX402TokenOptions,\n): Promise<AgentX402AccessToken> => {\n  const {\n    subscriber,\n    orderSessionKey,\n    redeemSessionKey,\n    publicClient,\n    planId,\n    schemeVersion = '1',\n    agentId,\n    resource,\n    httpVerb,\n    validUntil,\n  } = options\n\n  // hash the session keys\n  const redeemSessionKeyHash = keccak256(toBytes(redeemSessionKey))\n  const orderSessionKeyHash = keccak256(toBytes(orderSessionKey))\n\n  // generate the message with `from` address\n  const message: NeverminedTypedDataMessage = {\n    from: subscriber.address,\n    sessionKeysProvider: 'zerodev',\n    sessionKeys: [\n      {\n        id: 'order',\n        data: orderSessionKeyHash,\n      },\n      {\n        id: 'redeem',\n        data: redeemSessionKeyHash,\n      },\n    ],\n  }\n\n  const domain: NeverminedTypedDataDomain = {\n    name: 'Nevermined',\n    version: '1',\n    chainId: publicClient.chain?.id as number,\n    verifyingContract: subscriber.address,\n  }\n\n  // generate the eip712 data\n  const eip712Data = {\n    domain,\n\n    types: NeverminedTypedDataTypes,\n    primaryType: 'Authorization',\n    message,\n  } satisfies TypedDataDefinition<NeverminedTypedData, 'Authorization'>\n\n  const signature = await subscriber.signTypedData(eip712Data)\n\n  // Get network in CAIP-2 format (eip155:chainId)\n  const chainId = publicClient.chain?.id\n  const network = chainId ? `eip155:${chainId}` : (publicClient.chain?.name as string)\n\n  return {\n    x402Version: 2,\n    ...(resource && { resource }),\n    accepted: {\n      scheme: 'nvm:erc4337',\n      network,\n      planId,\n      extra: {\n        version: schemeVersion,\n        ...(agentId && { agentId }),\n        ...(httpVerb && { httpVerb }),\n      },\n    },\n    payload: {\n      signature,\n      authorization: message,\n    },\n    ...(validUntil !== undefined && { validUntil }),\n    extensions: {},\n  }\n}\n\n/**\n * Verify an x402 access token signature\n *\n * @param accessToken - The x402 access token to verify\n * @param publicClient - Viem public client\n * @returns true if signature is valid\n */\nexport const verifyAgentX402AccessToken = async (\n  accessToken: AgentX402AccessToken,\n  publicClient: PublicClient,\n): Promise<boolean> => {\n  const erc4337Payload = accessToken.payload as X402Erc4337Payload\n  // Extract subscriber address from payload.authorization.from\n  const subscriberAddress = erc4337Payload.authorization.from\n\n  const domain: NeverminedTypedDataDomain = {\n    name: 'Nevermined',\n    version: '1',\n    chainId: publicClient.chain?.id as number,\n    verifyingContract: subscriberAddress,\n  }\n  const { signature, authorization } = erc4337Payload\n  const isValid = await publicClient.verifyTypedData({\n    address: subscriberAddress,\n    signature,\n    types: NeverminedTypedDataTypes,\n    domain,\n    message: authorization,\n    primaryType: 'Authorization',\n  })\n  return isValid\n}\n\n/**\n * Validation result for x402 token structure\n */\nexport type X402TokenValidationResult = {\n  valid: boolean\n  errors: string[]\n}\n\n/**\n * Validate the structure of an x402 access token\n *\n * @param token - The token to validate (unknown type for safety)\n * @returns Validation result with errors if any\n */\nconst SUPPORTED_SCHEMES: X402Scheme[] = ['nvm:erc4337', 'nvm:card-delegation']\n\nexport const validateX402TokenStructure = (token: unknown): X402TokenValidationResult => {\n  const errors: string[] = []\n\n  if (!token || typeof token !== 'object') {\n    return { valid: false, errors: ['Token must be an object'] }\n  }\n\n  const t = token as Record<string, unknown>\n\n  // Validate x402Version\n  if (t.x402Version !== 2) {\n    errors.push('x402Version must be 2')\n  }\n\n  // Validate accepted object\n  if (!t.accepted || typeof t.accepted !== 'object') {\n    errors.push('accepted is required')\n  } else {\n    const accepted = t.accepted as Record<string, unknown>\n    const scheme = accepted.scheme as string\n\n    if (!SUPPORTED_SCHEMES.includes(scheme as X402Scheme)) {\n      errors.push(`scheme must be one of: ${SUPPORTED_SCHEMES.join(', ')}`)\n    }\n\n    if (!accepted.network || typeof accepted.network !== 'string') {\n      errors.push('network is required in accepted')\n    }\n\n    // Validate extra\n    if (!accepted.extra || typeof accepted.extra !== 'object') {\n      errors.push('extra is required in accepted')\n    } else {\n      const extra = accepted.extra as Record<string, unknown>\n      if (!extra.version || typeof extra.version !== 'string') {\n        errors.push('version is required in accepted.extra')\n      }\n    }\n\n    // Scheme-specific accepted validation\n    if (scheme === 'nvm:erc4337') {\n      if (!accepted.planId || typeof accepted.planId !== 'string') {\n        errors.push('planId is required in accepted for nvm:erc4337')\n      }\n    }\n  }\n\n  // Validate payload\n  if (!t.payload || typeof t.payload !== 'object') {\n    errors.push('payload is required')\n  } else {\n    const accepted = t.accepted as Record<string, unknown> | undefined\n    const scheme = accepted?.scheme as string | undefined\n    const payload = t.payload as Record<string, unknown>\n\n    if (scheme === 'nvm:erc4337') {\n      if (!payload.signature || typeof payload.signature !== 'string') {\n        errors.push('signature is required in payload')\n      }\n\n      if (!payload.authorization || typeof payload.authorization !== 'object') {\n        errors.push('authorization is required in payload')\n      } else {\n        const auth = payload.authorization as Record<string, unknown>\n\n        if (!auth.from || typeof auth.from !== 'string') {\n          errors.push('from address is required in payload.authorization')\n        } else if (!auth.from.startsWith('0x')) {\n          errors.push('from must be a valid hex address')\n        }\n\n        if (!auth.sessionKeysProvider || typeof auth.sessionKeysProvider !== 'string') {\n          errors.push('sessionKeysProvider is required in payload.authorization')\n        }\n\n        if (!Array.isArray(auth.sessionKeys)) {\n          errors.push('sessionKeys array is required in payload.authorization')\n        }\n      }\n    } else if (scheme === 'nvm:card-delegation') {\n      if (!payload.token || typeof payload.token !== 'string') {\n        errors.push('token is required in payload for nvm:card-delegation')\n      }\n    }\n  }\n\n  // Validate extensions (must be present, even if empty)\n  if (t.extensions === undefined) {\n    errors.push('extensions is required (can be empty object)')\n  }\n\n  return { valid: errors.length === 0, errors }\n}\n\nexport const b64EncodeX402AccessToken = (accessToken: AgentX402AccessToken): string => {\n  return Buffer.from(JSON.stringify(accessToken)).toString('base64')\n}\n\nexport const b64DecodeX402AccessToken = (encoded: string): AgentX402AccessToken => {\n  return JSON.parse(Buffer.from(encoded, 'base64').toString('utf-8'))\n}\n"],"names":["keccak256","toBytes","NeverminedTypedDataTypes","SessionKey","name","type","SessionKeys","Authorization","generateAgentX402AccessToken","options","subscriber","orderSessionKey","redeemSessionKey","publicClient","planId","schemeVersion","agentId","resource","httpVerb","validUntil","redeemSessionKeyHash","orderSessionKeyHash","message","from","address","sessionKeysProvider","sessionKeys","id","data","domain","version","chainId","chain","verifyingContract","eip712Data","types","primaryType","signature","signTypedData","network","x402Version","accepted","scheme","extra","payload","authorization","undefined","extensions","verifyAgentX402AccessToken","accessToken","erc4337Payload","subscriberAddress","isValid","verifyTypedData","SUPPORTED_SCHEMES","validateX402TokenStructure","token","errors","valid","t","push","includes","join","auth","startsWith","Array","isArray","length","b64EncodeX402AccessToken","Buffer","JSON","stringify","toString","b64DecodeX402AccessToken","encoded","parse"],"mappings":"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"}
+{"version":3,"sources":["../../src/models/AgentX402AccessToken.ts"],"sourcesContent":["import { keccak256, PublicClient, toBytes, TypedDataDefinition } from 'viem'\nimport { SmartAccount } from 'viem/account-abstraction'\n\n/**\n * x402 Resource information\n */\nexport type X402Resource = {\n  url: string\n  description?: string\n  mimeType?: string\n}\n\n/**\n * Supported x402 payment schemes\n */\nexport type X402Scheme = 'nvm:erc4337' | 'nvm:card-delegation'\n\n/**\n * x402 Accepted scheme fields (common to all schemes)\n */\nexport type X402Accepted = {\n  scheme: X402Scheme\n  network: string\n  planId?: string\n  extra: {\n    version: string\n    agentId?: string\n    httpVerb?: string\n  }\n}\n\n/**\n * Payload specific to the nvm:erc4337 scheme\n */\nexport type X402Erc4337Payload = {\n  signature: `0x${string}`\n  authorization: {\n    from: `0x${string}`\n    sessionKeysProvider: string\n    sessionKeys: { id: string; data: string }[]\n    /**\n     * Signed planId (#1678). Present on v2 tokens (minted after #1678) and\n     * covered by the EIP-712 signature, so it is tamper-evident on its own.\n     * OPTIONAL on the wire type only for backwards-compat: genuinely-old v1\n     * tokens carry no `planId` here and verify against the legacy type list.\n     */\n    planId?: string\n  }\n}\n\n/**\n * Payload specific to the nvm:card-delegation scheme\n */\nexport type X402CardDelegationPayload = {\n  token: string\n}\n\n/**\n * x402 Access Token aligned with x402 v2 spec\n *\n * Key changes from previous version:\n * - `subscriberAddress` moved to `payload.authorization.from`\n * - `planId` is now in `accepted` (optional — required for erc4337, optional for card-delegation)\n * - `agentId` moved to `accepted.extra.agentId` (optional)\n * - `scheme` and `network` moved to `accepted`\n * - Added `resource` and `extensions` for x402 v2 alignment\n */\nexport type AgentX402AccessToken = {\n  x402Version: 2\n  resource?: X402Resource\n  accepted: X402Accepted\n  payload: X402Erc4337Payload | X402CardDelegationPayload\n  validUntil?: number\n  extensions: Record<string, unknown>\n}\n\nexport type NeverminedTypedDataDomain = {\n  name: 'Nevermined'\n  version: '1'\n  chainId: number\n  verifyingContract: `0x${string}`\n}\n\n/**\n * EIP-712 `Authorization` struct WITH a signed `planId` (#1678).\n *\n * `planId` is appended LAST so the change is purely additive to the EIP-712\n * encoding of the legacy (v1) struct. Signing the planId makes the token's plan\n * tamper-evident on its own — defense-in-depth atop the resource server's\n * `validateAcceptedMatchesRequirements` demand-match, which remains the primary\n * gate. See `NeverminedTypedDataTypesV1` for the legacy struct that pre-#1678\n * tokens were signed over; both shapes verify against the same signer.\n */\nexport type NeverminedTypedData = {\n  SessionKey: [{ name: 'id'; type: 'string' }, { name: 'data'; type: 'string' }]\n  SessionKeys: [{ name: 'sessionKeys'; type: 'SessionKey[]' }]\n  Authorization: [\n    { name: 'from'; type: 'address' },\n    { name: 'sessionKeysProvider'; type: 'string' },\n    { name: 'sessionKeys'; type: 'SessionKey[]' },\n    { name: 'planId'; type: 'string' },\n  ]\n}\n\nexport const NeverminedTypedDataTypes: NeverminedTypedData = {\n  SessionKey: [\n    { name: 'id', type: 'string' },\n    { name: 'data', type: 'string' },\n  ],\n  SessionKeys: [{ name: 'sessionKeys', type: 'SessionKey[]' }],\n  Authorization: [\n    { name: 'from', type: 'address' },\n    { name: 'sessionKeysProvider', type: 'string' },\n    { name: 'sessionKeys', type: 'SessionKey[]' },\n    { name: 'planId', type: 'string' },\n  ],\n}\n\n/**\n * Legacy (v1) EIP-712 `Authorization` struct — WITHOUT a signed `planId`.\n *\n * Retained so `verifyAgentX402AccessToken` can still validate genuinely-old\n * tokens minted before #1678 (their `authorization` carries no `planId`, and\n * EIP-712 hashes the type set, so they only verify against THIS type list).\n * Mint always produces the v2 (with-planId) shape going forward.\n */\nexport type NeverminedTypedDataV1 = {\n  SessionKey: [{ name: 'id'; type: 'string' }, { name: 'data'; type: 'string' }]\n  SessionKeys: [{ name: 'sessionKeys'; type: 'SessionKey[]' }]\n  Authorization: [\n    { name: 'from'; type: 'address' },\n    { name: 'sessionKeysProvider'; type: 'string' },\n    { name: 'sessionKeys'; type: 'SessionKey[]' },\n  ]\n}\n\nexport const NeverminedTypedDataTypesV1: NeverminedTypedDataV1 = {\n  SessionKey: [\n    { name: 'id', type: 'string' },\n    { name: 'data', type: 'string' },\n  ],\n  SessionKeys: [{ name: 'sessionKeys', type: 'SessionKey[]' }],\n  Authorization: [\n    { name: 'from', type: 'address' },\n    { name: 'sessionKeysProvider', type: 'string' },\n    { name: 'sessionKeys', type: 'SessionKey[]' },\n  ],\n}\n\n/**\n * Legacy (v1) signed message shape — no `planId`. Mirrors `NeverminedTypedDataTypesV1`.\n * Only genuinely-old tokens carry this shape; mint never produces it.\n */\nexport type NeverminedTypedDataMessageV1 = {\n  from: `0x${string}`\n  sessionKeysProvider: string\n  sessionKeys: { id: string; data: string }[]\n}\n\n/**\n * The v2 signed message shape — `planId` is REQUIRED. Mint always produces this\n * shape (#1678), so `planId` is non-optional here; the v1 variant above models\n * the legacy no-planId message. Mirrors `NeverminedTypedDataTypes`.\n */\nexport type NeverminedTypedDataMessage = NeverminedTypedDataMessageV1 & {\n  /** Signed planId (#1678) — always present on v2 (minted) tokens. */\n  planId: string\n}\n\n/**\n * Options for generating an x402 access token\n */\nexport type GenerateX402TokenOptions = {\n  subscriber: SmartAccount\n  orderSessionKey: string\n  redeemSessionKey: string\n  publicClient: PublicClient\n  planId: string\n  /** Scheme version (e.g., '1') - stored in accepted.extra.version */\n  schemeVersion?: string\n  agentId?: string\n  resource?: X402Resource\n  httpVerb?: string\n  /** Token expiration timestamp in seconds (Unix epoch) */\n  validUntil?: number\n}\n\n/**\n * Generate an x402 access token aligned with x402 v2 spec\n *\n * @param options - Token generation options\n * @returns x402 access token with EIP-712 signature\n */\nexport const generateAgentX402AccessToken = async (\n  options: GenerateX402TokenOptions,\n): Promise<AgentX402AccessToken> => {\n  const {\n    subscriber,\n    orderSessionKey,\n    redeemSessionKey,\n    publicClient,\n    planId,\n    schemeVersion = '1',\n    agentId,\n    resource,\n    httpVerb,\n    validUntil,\n  } = options\n\n  // A v2 token MUST carry a non-empty signed planId (#1678) — an empty/blank\n  // planId would otherwise be signed into `authorization.planId` and could be\n  // misread as a \"present but empty\" signed claim, blurring the v1/v2 boundary\n  // that verification keys off genuine presence. erc4337 already requires a\n  // planId upstream (`validateX402TokenStructure`), so this is a hard invariant.\n  if (typeof planId !== 'string' || planId.trim() === '') {\n    throw new Error(\n      'generateAgentX402AccessToken: planId is required and must be a non-empty string',\n    )\n  }\n\n  // hash the session keys\n  const redeemSessionKeyHash = keccak256(toBytes(redeemSessionKey))\n  const orderSessionKeyHash = keccak256(toBytes(orderSessionKey))\n\n  // generate the message with `from` address and the SIGNED planId (#1678).\n  // Including `planId` here puts it inside the EIP-712 digest, so it cannot be\n  // altered without invalidating the signature.\n  const message: NeverminedTypedDataMessage = {\n    from: subscriber.address,\n    sessionKeysProvider: 'zerodev',\n    sessionKeys: [\n      {\n        id: 'order',\n        data: orderSessionKeyHash,\n      },\n      {\n        id: 'redeem',\n        data: redeemSessionKeyHash,\n      },\n    ],\n    planId,\n  }\n\n  const domain: NeverminedTypedDataDomain = {\n    name: 'Nevermined',\n    version: '1',\n    chainId: publicClient.chain?.id as number,\n    verifyingContract: subscriber.address,\n  }\n\n  // generate the eip712 data\n  const eip712Data = {\n    domain,\n\n    types: NeverminedTypedDataTypes,\n    primaryType: 'Authorization',\n    message,\n  } satisfies TypedDataDefinition<NeverminedTypedData, 'Authorization'>\n\n  const signature = await subscriber.signTypedData(eip712Data)\n\n  // Get network in CAIP-2 format (eip155:chainId)\n  const chainId = publicClient.chain?.id\n  const network = chainId ? `eip155:${chainId}` : (publicClient.chain?.name as string)\n\n  return {\n    x402Version: 2,\n    ...(resource && { resource }),\n    accepted: {\n      scheme: 'nvm:erc4337',\n      network,\n      planId,\n      extra: {\n        version: schemeVersion,\n        ...(agentId && { agentId }),\n        ...(httpVerb && { httpVerb }),\n      },\n    },\n    payload: {\n      signature,\n      authorization: message,\n    },\n    ...(validUntil !== undefined && { validUntil }),\n    extensions: {},\n  }\n}\n\n/**\n * True when `authorization` carries a GENUINE signed planId (#1678) — a present,\n * non-empty string. This is the single v1/v2 discriminator: verification keys off\n * it to choose the matching EIP-712 type list, the handler keys off it to decide\n * whether the signed-vs-unsigned consistency guard fires. Keying off genuine\n * presence (not just `'planId' in authorization`) ensures a `planId: ''` / nullish\n * value can never be mistaken for a real signed claim.\n */\nexport const hasSignedPlanId = (\n  authorization: X402Erc4337Payload['authorization'],\n): authorization is X402Erc4337Payload['authorization'] & { planId: string } => {\n  return typeof authorization?.planId === 'string' && authorization.planId.trim() !== ''\n}\n\n/**\n * The signed-vs-unsigned planId consistency invariant (#1678), co-located with\n * `hasSignedPlanId` so signer, verifier, and the API handler share ONE\n * definition (no drift between where the planId is signed and where the guard\n * enforces it).\n *\n * For a v2 token (signed planId present) the tamperable unsigned `accepted.planId`\n * MUST exactly equal the signed `authorization.planId` — anything else is a\n * post-signing edit of the outer JSON. Returns `true` for v1 tokens (no signed\n * planId): there is no signed value to be consistent with, so the guard does not\n * apply (the caller handles the legacy fallback separately). The API handler maps\n * a `false` result to its forgery-gated rejection.\n */\nexport const isSignedPlanIdConsistent = (\n  authorization: X402Erc4337Payload['authorization'],\n  acceptedPlanId: string | null | undefined,\n): boolean => {\n  if (!hasSignedPlanId(authorization)) return true\n  return acceptedPlanId === authorization.planId\n}\n\n/**\n * Verify an x402 access token signature.\n *\n * EIP-712 hashes the type set, so a token signed over the v2 (with-planId)\n * struct cannot verify against the v1 type list and vice-versa. We therefore\n * detect which shape the token carries (genuine signed planId → v2) and verify\n * against the matching type list. This keeps genuinely-old v1 tokens valid\n * (#1678 backwards-compat) while v2 tokens are checked over the signed planId.\n *\n * Downgrade-safe: a v2 token was signed over the with-planId digest, so stripping\n * `authorization.planId` to force the v1 branch changes the digest and the\n * signature fails — an attacker cannot demote a signed token to dodge the planId.\n *\n * @param accessToken - The x402 access token to verify\n * @param publicClient - Viem public client\n * @returns true if signature is valid\n */\nexport const verifyAgentX402AccessToken = async (\n  accessToken: AgentX402AccessToken,\n  publicClient: PublicClient,\n): Promise<boolean> => {\n  const erc4337Payload = accessToken.payload as X402Erc4337Payload\n  // Extract subscriber address from payload.authorization.from\n  const subscriberAddress = erc4337Payload.authorization.from\n\n  const domain: NeverminedTypedDataDomain = {\n    name: 'Nevermined',\n    version: '1',\n    chainId: publicClient.chain?.id as number,\n    verifyingContract: subscriberAddress,\n  }\n  const { signature, authorization } = erc4337Payload\n  const isValid = await publicClient.verifyTypedData({\n    address: subscriberAddress,\n    signature,\n    // v2 (signed planId) verifies over the with-planId type list; legacy v1\n    // tokens (no signed planId) verify over the original type list.\n    types: hasSignedPlanId(authorization) ? NeverminedTypedDataTypes : NeverminedTypedDataTypesV1,\n    domain,\n    message: authorization,\n    primaryType: 'Authorization',\n  })\n  return isValid\n}\n\n/**\n * Validation result for x402 token structure\n */\nexport type X402TokenValidationResult = {\n  valid: boolean\n  errors: string[]\n}\n\n/**\n * Validate the structure of an x402 access token\n *\n * @param token - The token to validate (unknown type for safety)\n * @returns Validation result with errors if any\n */\nconst SUPPORTED_SCHEMES: X402Scheme[] = ['nvm:erc4337', 'nvm:card-delegation']\n\nexport const validateX402TokenStructure = (token: unknown): X402TokenValidationResult => {\n  const errors: string[] = []\n\n  if (!token || typeof token !== 'object') {\n    return { valid: false, errors: ['Token must be an object'] }\n  }\n\n  const t = token as Record<string, unknown>\n\n  // Validate x402Version\n  if (t.x402Version !== 2) {\n    errors.push('x402Version must be 2')\n  }\n\n  // Validate accepted object\n  if (!t.accepted || typeof t.accepted !== 'object') {\n    errors.push('accepted is required')\n  } else {\n    const accepted = t.accepted as Record<string, unknown>\n    const scheme = accepted.scheme as string\n\n    if (!SUPPORTED_SCHEMES.includes(scheme as X402Scheme)) {\n      errors.push(`scheme must be one of: ${SUPPORTED_SCHEMES.join(', ')}`)\n    }\n\n    if (!accepted.network || typeof accepted.network !== 'string') {\n      errors.push('network is required in accepted')\n    }\n\n    // Validate extra\n    if (!accepted.extra || typeof accepted.extra !== 'object') {\n      errors.push('extra is required in accepted')\n    } else {\n      const extra = accepted.extra as Record<string, unknown>\n      if (!extra.version || typeof extra.version !== 'string') {\n        errors.push('version is required in accepted.extra')\n      }\n    }\n\n    // Scheme-specific accepted validation\n    if (scheme === 'nvm:erc4337') {\n      if (!accepted.planId || typeof accepted.planId !== 'string') {\n        errors.push('planId is required in accepted for nvm:erc4337')\n      }\n    }\n  }\n\n  // Validate payload\n  if (!t.payload || typeof t.payload !== 'object') {\n    errors.push('payload is required')\n  } else {\n    const accepted = t.accepted as Record<string, unknown> | undefined\n    const scheme = accepted?.scheme as string | undefined\n    const payload = t.payload as Record<string, unknown>\n\n    if (scheme === 'nvm:erc4337') {\n      if (!payload.signature || typeof payload.signature !== 'string') {\n        errors.push('signature is required in payload')\n      }\n\n      if (!payload.authorization || typeof payload.authorization !== 'object') {\n        errors.push('authorization is required in payload')\n      } else {\n        const auth = payload.authorization as Record<string, unknown>\n\n        if (!auth.from || typeof auth.from !== 'string') {\n          errors.push('from address is required in payload.authorization')\n        } else if (!auth.from.startsWith('0x')) {\n          errors.push('from must be a valid hex address')\n        }\n\n        if (!auth.sessionKeysProvider || typeof auth.sessionKeysProvider !== 'string') {\n          errors.push('sessionKeysProvider is required in payload.authorization')\n        }\n\n        if (!Array.isArray(auth.sessionKeys)) {\n          errors.push('sessionKeys array is required in payload.authorization')\n        }\n      }\n    } else if (scheme === 'nvm:card-delegation') {\n      if (!payload.token || typeof payload.token !== 'string') {\n        errors.push('token is required in payload for nvm:card-delegation')\n      }\n    }\n  }\n\n  // Validate extensions (must be present, even if empty)\n  if (t.extensions === undefined) {\n    errors.push('extensions is required (can be empty object)')\n  }\n\n  return { valid: errors.length === 0, errors }\n}\n\nexport const b64EncodeX402AccessToken = (accessToken: AgentX402AccessToken): string => {\n  return Buffer.from(JSON.stringify(accessToken)).toString('base64')\n}\n\nexport const b64DecodeX402AccessToken = (encoded: string): AgentX402AccessToken => {\n  return JSON.parse(Buffer.from(encoded, 'base64').toString('utf-8'))\n}\n"],"names":["keccak256","toBytes","NeverminedTypedDataTypes","SessionKey","name","type","SessionKeys","Authorization","NeverminedTypedDataTypesV1","generateAgentX402AccessToken","options","subscriber","orderSessionKey","redeemSessionKey","publicClient","planId","schemeVersion","agentId","resource","httpVerb","validUntil","trim","Error","redeemSessionKeyHash","orderSessionKeyHash","message","from","address","sessionKeysProvider","sessionKeys","id","data","domain","version","chainId","chain","verifyingContract","eip712Data","types","primaryType","signature","signTypedData","network","x402Version","accepted","scheme","extra","payload","authorization","undefined","extensions","hasSignedPlanId","isSignedPlanIdConsistent","acceptedPlanId","verifyAgentX402AccessToken","accessToken","erc4337Payload","subscriberAddress","isValid","verifyTypedData","SUPPORTED_SCHEMES","validateX402TokenStructure","token","errors","valid","t","push","includes","join","auth","startsWith","Array","isArray","length","b64EncodeX402AccessToken","Buffer","JSON","stringify","toString","b64DecodeX402AccessToken","encoded","parse"],"mappings":"AAAA,SAASA,SAAS,EAAgBC,OAAO,QAA6B,OAAM;AAwG5E,OAAO,MAAMC,2BAAgD;IAC3DC,YAAY;QACV;YAAEC,MAAM;YAAMC,MAAM;QAAS;QAC7B;YAAED,MAAM;YAAQC,MAAM;QAAS;KAChC;IACDC,aAAa;QAAC;YAAEF,MAAM;YAAeC,MAAM;QAAe;KAAE;IAC5DE,eAAe;QACb;YAAEH,MAAM;YAAQC,MAAM;QAAU;QAChC;YAAED,MAAM;YAAuBC,MAAM;QAAS;QAC9C;YAAED,MAAM;YAAeC,MAAM;QAAe;QAC5C;YAAED,MAAM;YAAUC,MAAM;QAAS;KAClC;AACH,EAAC;AAoBD,OAAO,MAAMG,6BAAoD;IAC/DL,YAAY;QACV;YAAEC,MAAM;YAAMC,MAAM;QAAS;QAC7B;YAAED,MAAM;YAAQC,MAAM;QAAS;KAChC;IACDC,aAAa;QAAC;YAAEF,MAAM;YAAeC,MAAM;QAAe;KAAE;IAC5DE,eAAe;QACb;YAAEH,MAAM;YAAQC,MAAM;QAAU;QAChC;YAAED,MAAM;YAAuBC,MAAM;QAAS;QAC9C;YAAED,MAAM;YAAeC,MAAM;QAAe;KAC7C;AACH,EAAC;AAwCD;;;;;CAKC,GACD,OAAO,MAAMI,+BAA+B,OAC1CC;IAEA,MAAM,EACJC,UAAU,EACVC,eAAe,EACfC,gBAAgB,EAChBC,YAAY,EACZC,MAAM,EACNC,gBAAgB,GAAG,EACnBC,OAAO,EACPC,QAAQ,EACRC,QAAQ,EACRC,UAAU,EACX,GAAGV;IAEJ,2EAA2E;IAC3E,4EAA4E;IAC5E,6EAA6E;IAC7E,0EAA0E;IAC1E,+EAA+E;IAC/E,IAAI,OAAOK,WAAW,YAAYA,OAAOM,IAAI,OAAO,IAAI;QACtD,MAAM,IAAIC,MACR;IAEJ;IAEA,wBAAwB;IACxB,MAAMC,uBAAuBvB,UAAUC,QAAQY;IAC/C,MAAMW,sBAAsBxB,UAAUC,QAAQW;IAE9C,0EAA0E;IAC1E,6EAA6E;IAC7E,8CAA8C;IAC9C,MAAMa,UAAsC;QAC1CC,MAAMf,WAAWgB,OAAO;QACxBC,qBAAqB;QACrBC,aAAa;YACX;gBACEC,IAAI;gBACJC,MAAMP;YACR;YACA;gBACEM,IAAI;gBACJC,MAAMR;YACR;SACD;QACDR;IACF;IAEA,MAAMiB,SAAoC;QACxC5B,MAAM;QACN6B,SAAS;QACTC,SAASpB,aAAaqB,KAAK,EAAEL;QAC7BM,mBAAmBzB,WAAWgB,OAAO;IACvC;IAEA,2BAA2B;IAC3B,MAAMU,aAAa;QACjBL;QAEAM,OAAOpC;QACPqC,aAAa;QACbd;IACF;IAEA,MAAMe,YAAY,MAAM7B,WAAW8B,aAAa,CAACJ;IAEjD,gDAAgD;IAChD,MAAMH,UAAUpB,aAAaqB,KAAK,EAAEL;IACpC,MAAMY,UAAUR,UAAU,CAAC,OAAO,EAAEA,SAAS,GAAIpB,aAAaqB,KAAK,EAAE/B;IAErE,OAAO;QACLuC,aAAa;QACb,GAAIzB,YAAY;YAAEA;QAAS,CAAC;QAC5B0B,UAAU;YACRC,QAAQ;YACRH;YACA3B;YACA+B,OAAO;gBACLb,SAASjB;gBACT,GAAIC,WAAW;oBAAEA;gBAAQ,CAAC;gBAC1B,GAAIE,YAAY;oBAAEA;gBAAS,CAAC;YAC9B;QACF;QACA4B,SAAS;YACPP;YACAQ,eAAevB;QACjB;QACA,GAAIL,eAAe6B,aAAa;YAAE7B;QAAW,CAAC;QAC9C8B,YAAY,CAAC;IACf;AACF,EAAC;AAED;;;;;;;CAOC,GACD,OAAO,MAAMC,kBAAkB,CAC7BH;IAEA,OAAO,OAAOA,eAAejC,WAAW,YAAYiC,cAAcjC,MAAM,CAACM,IAAI,OAAO;AACtF,EAAC;AAED;;;;;;;;;;;;CAYC,GACD,OAAO,MAAM+B,2BAA2B,CACtCJ,eACAK;IAEA,IAAI,CAACF,gBAAgBH,gBAAgB,OAAO;IAC5C,OAAOK,mBAAmBL,cAAcjC,MAAM;AAChD,EAAC;AAED;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,MAAMuC,6BAA6B,OACxCC,aACAzC;IAEA,MAAM0C,iBAAiBD,YAAYR,OAAO;IAC1C,6DAA6D;IAC7D,MAAMU,oBAAoBD,eAAeR,aAAa,CAACtB,IAAI;IAE3D,MAAMM,SAAoC;QACxC5B,MAAM;QACN6B,SAAS;QACTC,SAASpB,aAAaqB,KAAK,EAAEL;QAC7BM,mBAAmBqB;IACrB;IACA,MAAM,EAAEjB,SAAS,EAAEQ,aAAa,EAAE,GAAGQ;IACrC,MAAME,UAAU,MAAM5C,aAAa6C,eAAe,CAAC;QACjDhC,SAAS8B;QACTjB;QACA,wEAAwE;QACxE,gEAAgE;QAChEF,OAAOa,gBAAgBH,iBAAiB9C,2BAA2BM;QACnEwB;QACAP,SAASuB;QACTT,aAAa;IACf;IACA,OAAOmB;AACT,EAAC;AAUD;;;;;CAKC,GACD,MAAME,oBAAkC;IAAC;IAAe;CAAsB;AAE9E,OAAO,MAAMC,6BAA6B,CAACC;IACzC,MAAMC,SAAmB,EAAE;IAE3B,IAAI,CAACD,SAAS,OAAOA,UAAU,UAAU;QACvC,OAAO;YAAEE,OAAO;YAAOD,QAAQ;gBAAC;aAA0B;QAAC;IAC7D;IAEA,MAAME,IAAIH;IAEV,uBAAuB;IACvB,IAAIG,EAAEtB,WAAW,KAAK,GAAG;QACvBoB,OAAOG,IAAI,CAAC;IACd;IAEA,2BAA2B;IAC3B,IAAI,CAACD,EAAErB,QAAQ,IAAI,OAAOqB,EAAErB,QAAQ,KAAK,UAAU;QACjDmB,OAAOG,IAAI,CAAC;IACd,OAAO;QACL,MAAMtB,WAAWqB,EAAErB,QAAQ;QAC3B,MAAMC,SAASD,SAASC,MAAM;QAE9B,IAAI,CAACe,kBAAkBO,QAAQ,CAACtB,SAAuB;YACrDkB,OAAOG,IAAI,CAAC,CAAC,uBAAuB,EAAEN,kBAAkBQ,IAAI,CAAC,OAAO;QACtE;QAEA,IAAI,CAACxB,SAASF,OAAO,IAAI,OAAOE,SAASF,OAAO,KAAK,UAAU;YAC7DqB,OAAOG,IAAI,CAAC;QACd;QAEA,iBAAiB;QACjB,IAAI,CAACtB,SAASE,KAAK,IAAI,OAAOF,SAASE,KAAK,KAAK,UAAU;YACzDiB,OAAOG,IAAI,CAAC;QACd,OAAO;YACL,MAAMpB,QAAQF,SAASE,KAAK;YAC5B,IAAI,CAACA,MAAMb,OAAO,IAAI,OAAOa,MAAMb,OAAO,KAAK,UAAU;gBACvD8B,OAAOG,IAAI,CAAC;YACd;QACF;QAEA,sCAAsC;QACtC,IAAIrB,WAAW,eAAe;YAC5B,IAAI,CAACD,SAAS7B,MAAM,IAAI,OAAO6B,SAAS7B,MAAM,KAAK,UAAU;gBAC3DgD,OAAOG,IAAI,CAAC;YACd;QACF;IACF;IAEA,mBAAmB;IACnB,IAAI,CAACD,EAAElB,OAAO,IAAI,OAAOkB,EAAElB,OAAO,KAAK,UAAU;QAC/CgB,OAAOG,IAAI,CAAC;IACd,OAAO;QACL,MAAMtB,WAAWqB,EAAErB,QAAQ;QAC3B,MAAMC,SAASD,UAAUC;QACzB,MAAME,UAAUkB,EAAElB,OAAO;QAEzB,IAAIF,WAAW,eAAe;YAC5B,IAAI,CAACE,QAAQP,SAAS,IAAI,OAAOO,QAAQP,SAAS,KAAK,UAAU;gBAC/DuB,OAAOG,IAAI,CAAC;YACd;YAEA,IAAI,CAACnB,QAAQC,aAAa,IAAI,OAAOD,QAAQC,aAAa,KAAK,UAAU;gBACvEe,OAAOG,IAAI,CAAC;YACd,OAAO;gBACL,MAAMG,OAAOtB,QAAQC,aAAa;gBAElC,IAAI,CAACqB,KAAK3C,IAAI,IAAI,OAAO2C,KAAK3C,IAAI,KAAK,UAAU;oBAC/CqC,OAAOG,IAAI,CAAC;gBACd,OAAO,IAAI,CAACG,KAAK3C,IAAI,CAAC4C,UAAU,CAAC,OAAO;oBACtCP,OAAOG,IAAI,CAAC;gBACd;gBAEA,IAAI,CAACG,KAAKzC,mBAAmB,IAAI,OAAOyC,KAAKzC,mBAAmB,KAAK,UAAU;oBAC7EmC,OAAOG,IAAI,CAAC;gBACd;gBAEA,IAAI,CAACK,MAAMC,OAAO,CAACH,KAAKxC,WAAW,GAAG;oBACpCkC,OAAOG,IAAI,CAAC;gBACd;YACF;QACF,OAAO,IAAIrB,WAAW,uBAAuB;YAC3C,IAAI,CAACE,QAAQe,KAAK,IAAI,OAAOf,QAAQe,KAAK,KAAK,UAAU;gBACvDC,OAAOG,IAAI,CAAC;YACd;QACF;IACF;IAEA,uDAAuD;IACvD,IAAID,EAAEf,UAAU,KAAKD,WAAW;QAC9Bc,OAAOG,IAAI,CAAC;IACd;IAEA,OAAO;QAAEF,OAAOD,OAAOU,MAAM,KAAK;QAAGV;IAAO;AAC9C,EAAC;AAED,OAAO,MAAMW,2BAA2B,CAACnB;IACvC,OAAOoB,OAAOjD,IAAI,CAACkD,KAAKC,SAAS,CAACtB,cAAcuB,QAAQ,CAAC;AAC3D,EAAC;AAED,OAAO,MAAMC,2BAA2B,CAACC;IACvC,OAAOJ,KAAKK,KAAK,CAACN,OAAOjD,IAAI,CAACsD,SAAS,UAAUF,QAAQ,CAAC;AAC5D,EAAC"}

package/dist/models/NeverminedOptions.d.ts

@@ -22,6 +22,11 @@ export interface NeverminedOptions {
      * ZeroDev project id
      */
     zeroDevProjectId?: string;
+    /**
+     * Route the production bundler through ZeroDev's UltraRelay
+     * (`?provider=ULTRA_RELAY`). No effect when `BUNDLER_RPC_URL_OVERRIDE` is set.
+     */
+    useUltraRelay?: boolean;
     /**
      * Contracts version
      */

package/dist/models/NeverminedOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NeverminedOptions.d.ts","sourceRoot":"","sources":["../../src/models/NeverminedOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE9B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IAEpB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B"}
+{"version":3,"file":"NeverminedOptions.d.ts","sourceRoot":"","sources":["../../src/models/NeverminedOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE9B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IAEpB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B"}

package/dist/models/NeverminedOptions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/models/NeverminedOptions.ts"],"sourcesContent":["import { Account } from 'viem'\n\nexport interface NeverminedOptions {\n  chainId: number\n  /**\n   * Ethereum Web3 Provider URL. This Url allows the SDK to connect to a blockchain.\n   * This provider depends on the network where you want to connect (Ethereum Mainnet, Rinkeby, Polygon Matic, etc).\n   * It's possible to use a public available provider or a private/paid one like Infura, Alchemy, etc.\n   */\n  web3ProviderUri?: string\n\n  /**\n   * The Nevermined App URL.\n   */\n  appUrl?: string\n\n  backendUrl?: string\n\n  agentsProxy?: string\n\n  /**\n   * Log level. Defaults to `'info'` when consumed by `Instantiable.abstract.ts`.\n   */\n  logLevel?: string\n\n  accounts?: Account[]\n\n  /**\n   * ZeroDev project id\n   */\n  zeroDevProjectId?: string\n\n  /**\n   * Contracts version\n   */\n  contractsVersion?: string\n}\n"],"names":[],"mappings":"AAEA,WAkCC"}
+{"version":3,"sources":["../../src/models/NeverminedOptions.ts"],"sourcesContent":["import { Account } from 'viem'\n\nexport interface NeverminedOptions {\n  chainId: number\n  /**\n   * Ethereum Web3 Provider URL. This Url allows the SDK to connect to a blockchain.\n   * This provider depends on the network where you want to connect (Ethereum Mainnet, Rinkeby, Polygon Matic, etc).\n   * It's possible to use a public available provider or a private/paid one like Infura, Alchemy, etc.\n   */\n  web3ProviderUri?: string\n\n  /**\n   * The Nevermined App URL.\n   */\n  appUrl?: string\n\n  backendUrl?: string\n\n  agentsProxy?: string\n\n  /**\n   * Log level. Defaults to `'info'` when consumed by `Instantiable.abstract.ts`.\n   */\n  logLevel?: string\n\n  accounts?: Account[]\n\n  /**\n   * ZeroDev project id\n   */\n  zeroDevProjectId?: string\n\n  /**\n   * Route the production bundler through ZeroDev's UltraRelay\n   * (`?provider=ULTRA_RELAY`). No effect when `BUNDLER_RPC_URL_OVERRIDE` is set.\n   */\n  useUltraRelay?: boolean\n\n  /**\n   * Contracts version\n   */\n  contractsVersion?: string\n}\n"],"names":[],"mappings":"AAEA,WAwCC"}

package/dist/nevermined/utils/BlockchainViemUtils.d.ts

@@ -251,9 +251,14 @@ export declare function keccak256Packed(types: any[], values: any[]): string;
 /**
  * Returns the bundler RPC URL. When `BUNDLER_RPC_URL_OVERRIDE` is set
  * (used by tests against a local Alto + anvil-fork stack), it takes precedence
- * over the canonical ZeroDev URL.
+ * over the canonical ZeroDev URL. When `useUltraRelay` is true, the production
+ * URL is routed through ZeroDev's UltraRelay (`?provider=ULTRA_RELAY`); the
+ * override branch is left untouched.
+ * @param useUltraRelay - when true, append `?provider=ULTRA_RELAY` to route the
+ *   UserOperation through ZeroDev's UltraRelay bundler tier. Ignored when
+ *   `BUNDLER_RPC_URL_OVERRIDE` is set.
  */
-export declare function getBundlerRpcUrl(zeroDevProjectId: string, chainId: number): string;
+export declare function getBundlerRpcUrl(zeroDevProjectId: string, chainId: number, useUltraRelay?: boolean): string;
 /**
  * Returns the paymaster RPC URL (ZeroDev-only; the local fork stack uses
  * `ultra-relay` which sponsors via the bundler's executor key without a
@@ -284,9 +289,12 @@ export declare function estimateUserOperationFees(bundlerClient: any, _publicCli
  * @param signer the signer account
  * @param chainId the chain id
  * @param zeroDevProjectId the zero dev project id, you can get it from the ZeroDev dashboard
+ * @param useUltraRelay forwarded straight to `getBundlerRpcUrl` — when true the
+ *   bundler RPC is routed through ZeroDev's UltraRelay. Ignored when
+ *   `BUNDLER_RPC_URL_OVERRIDE` is set.
  * @returns the kernel client
  */
-export declare function createKernelClient(kernelAccount: SmartAccount, chainId: number, zeroDevProjectId: string, publicClient: any): Promise<KernelAccountClient>;
+export declare function createKernelClient(kernelAccount: SmartAccount, chainId: number, zeroDevProjectId: string, publicClient: any, useUltraRelay?: boolean): Promise<KernelAccountClient>;
 export declare function createKernelSmartAccount(signer: Signer, publicClient: PublicClient): Promise<SmartAccount>;
 export declare function getApproval(signer: Signer, publicClient: any, policies: any[]): Promise<string>;
 export declare function useSessionKey(approval: string, signer: Signer, publicClient: any): Promise<import("@zerodev/sdk").CreateKernelAccountReturnType<"0.7">>;

package/dist/nevermined/utils/BlockchainViemUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockchainViemUtils.d.ts","sourceRoot":"","sources":["../../../src/nevermined/utils/BlockchainViemUtils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BlockchainViemUtils.d.ts","sourceRoot":"","sources":["../../../src/nevermined/utils/BlockchainViemUtils.ts"],"names":[],"mappings":"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"}

package/dist/nevermined/utils/BlockchainViemUtils.js

@@ -236,12 +236,18 @@ const TRANSACTION_RECEIPT_POLLING_INTERVAL_MS = 1_500;
 /**
  * Returns the bundler RPC URL. When `BUNDLER_RPC_URL_OVERRIDE` is set
  * (used by tests against a local Alto + anvil-fork stack), it takes precedence
- * over the canonical ZeroDev URL.
- */ export function getBundlerRpcUrl(zeroDevProjectId, chainId) {
+ * over the canonical ZeroDev URL. When `useUltraRelay` is true, the production
+ * URL is routed through ZeroDev's UltraRelay (`?provider=ULTRA_RELAY`); the
+ * override branch is left untouched.
+ * @param useUltraRelay - when true, append `?provider=ULTRA_RELAY` to route the
+ *   UserOperation through ZeroDev's UltraRelay bundler tier. Ignored when
+ *   `BUNDLER_RPC_URL_OVERRIDE` is set.
+ */ export function getBundlerRpcUrl(zeroDevProjectId, chainId, useUltraRelay = false) {
+    const base = `https://rpc.zerodev.app/api/v3/${zeroDevProjectId}/chain/${chainId}`;
     // `||` (not `??`) because Vite replaces missing browser env vars with the
     // empty string at build time; an empty override is equivalent to "no
     // override" for our purposes.
-    return process.env.BUNDLER_RPC_URL_OVERRIDE || `https://rpc.zerodev.app/api/v3/${zeroDevProjectId}/chain/${chainId}`;
+    return process.env.BUNDLER_RPC_URL_OVERRIDE || (useUltraRelay ? `${base}?provider=ULTRA_RELAY` : base);
 }
 /**
  * Returns the paymaster RPC URL (ZeroDev-only; the local fork stack uses
@@ -279,9 +285,12 @@ const TRANSACTION_RECEIPT_POLLING_INTERVAL_MS = 1_500;
  * @param signer the signer account
  * @param chainId the chain id
  * @param zeroDevProjectId the zero dev project id, you can get it from the ZeroDev dashboard
+ * @param useUltraRelay forwarded straight to `getBundlerRpcUrl` — when true the
+ *   bundler RPC is routed through ZeroDev's UltraRelay. Ignored when
+ *   `BUNDLER_RPC_URL_OVERRIDE` is set.
  * @returns the kernel client
- */ export async function createKernelClient(kernelAccount, chainId, zeroDevProjectId, publicClient) {
-    const bundlerRpc = getBundlerRpcUrl(zeroDevProjectId, chainId);
+ */ export async function createKernelClient(kernelAccount, chainId, zeroDevProjectId, publicClient, useUltraRelay = false) {
+    const bundlerRpc = getBundlerRpcUrl(zeroDevProjectId, chainId, useUltraRelay);
     const paymasterRpc = getPaymasterRpcUrl(zeroDevProjectId, chainId);
     return createKernelAccountClient({
         account: kernelAccount,

package/dist/nevermined/utils/BlockchainViemUtils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/nevermined/utils/BlockchainViemUtils.ts"],"sourcesContent":["import { signerToEcdsaValidator } from '@zerodev/ecdsa-validator'\nimport {\n  deserializePermissionAccount,\n  serializePermissionAccount,\n  toPermissionValidator,\n} from '@zerodev/permissions'\nimport { toECDSASigner } from '@zerodev/permissions/signers'\nimport {\n  addressToEmptyAccount,\n  createKernelAccount,\n  createKernelAccountClient,\n  createZeroDevPaymasterClient,\n  getUserOperationGasPrice,\n  KernelAccountClient,\n  type KernelSmartAccountImplementation,\n} from '@zerodev/sdk'\nimport { KERNEL_V3_1, getEntryPoint } from '@zerodev/sdk/constants'\nimport {\n  Address,\n  encodeAbiParameters,\n  getAbiItem,\n  getAddress,\n  getContract,\n  http,\n  isAddress,\n  pad,\n  stringToBytes,\n  stringToHex,\n  toBytes,\n  keccak256 as viemKeccak256,\n  type Abi,\n  type AbiEvent,\n  type AbiFunction,\n  type Account,\n  type PublicClient,\n  type TransactionReceipt,\n} from 'viem'\nimport { SmartAccount } from 'viem/account-abstraction'\nimport {\n  english,\n  generateMnemonic,\n  generatePrivateKey,\n  mnemonicToAccount,\n  privateKeyToAccount,\n} from 'viem/accounts'\nimport { Instantiable, InstantiableConfig, Web3Clients } from '../../Instantiable.abstract.js'\nimport { ContractsError } from '../../errors/NeverminedErrors.js'\nimport { getChain } from '../../utils/Network.js'\nimport { Signer } from '@zerodev/sdk/types'\n\nconst ENTRY_POINT_VERSION = '0.7'\n\n/**\n * Utility class with methods that allow the interaction with the blockchain.\n * This class uses Viem library to interact with the blockchain.\n */\nexport class BlockchainViemUtils extends Instantiable {\n  constructor(config: InstantiableConfig) {\n    super()\n    this.setInstanceConfig(config)\n  }\n}\n\n//////////////////////////\n///// UTILITIES //////////\n//////////////////////////\n\n///// CONTRACTS\n\n// Wait budget for an L2 block to be mined and the receipt to surface.\n// Base / Base Sepolia block time is ~2s; 30s ≈ 15 blocks of headroom.\nconst TRANSACTION_RECEIPT_TIMEOUT_MS = 30_000\nconst TRANSACTION_RECEIPT_POLLING_INTERVAL_MS = 1_500\n\n/**\n * Given a transaction hash, it returns the transaction receipt.\n * Uses viem's `waitForTransactionReceipt` which polls until the receipt is\n * available, retrying on `TransactionReceiptNotFoundError` and handling\n * tx-replacement / reorgs natively.\n * @param txHash - the transaction hash\n * @returns the transaction receipt\n */\nexport async function getTransactionReceipt({\n  txHash,\n  publicClient,\n}: {\n  txHash: `0x${string}`\n  publicClient: PublicClient\n  iteration?: number\n}): Promise<TransactionReceipt> {\n  try {\n    return await publicClient.waitForTransactionReceipt({\n      hash: txHash,\n      timeout: TRANSACTION_RECEIPT_TIMEOUT_MS,\n      pollingInterval: TRANSACTION_RECEIPT_POLLING_INTERVAL_MS,\n      confirmations: 1,\n    })\n  } catch (error) {\n    throw new ContractsError(\n      `Unable to get transaction receipt with hash: ${txHash}. Error: ${error}`,\n    )\n  }\n}\n\n/**\n * Given an already deployed contract address and the ABI, it returns the contract instance.\n *\n * @param contractAddress - the contract address\n * @param abi - the contract artifact\n * @param client - the client to interact with the blockchain\n * @returns a contract instance\n */\nexport async function getContractInstance(contractAddress: string, abi: Abi, client: Web3Clients) {\n  return getContract({\n    abi,\n    address: contractAddress as `0x${string}`,\n    client: { wallet: client.wallet, public: client.public },\n  })\n}\n\n///// ABIs\n\n/**\n * It searchs an ABI function in the ABI.\n * @param abi the ABI of the contract\n * @param funcName the function name\n * @param args the args of the function\n * @returns the function found\n */\nexport function searchAbiFunction(abi: Abi, funcName: string, args: any[] = []): AbiFunction {\n  const func = getAbiItem({ abi, name: funcName, args })\n  if (!func || func.type !== 'function') {\n    throw new ContractsError(`Function \"${funcName}\" is not part of contract`)\n  }\n  return func as AbiFunction\n}\n\n/**\n * It searchs an ABI event in the ABI.\n * @param abi the ABI of the contract\n * @param funcName the event name\n * @returns the event found\n */\nexport function searchAbiEvent(abi: Abi, eventName: string): AbiEvent {\n  const event = getAbiItem({\n    abi,\n    name: eventName,\n  })\n  if (!event || event.type !== 'event') {\n    throw new ContractsError(`Event \"${event}\" is not part of contract`)\n  }\n  return event as AbiEvent\n}\n\n/**\n * It searchs an ABI function in the ABI.\n * @param abi the ABI of the contract\n * @param funcName the function name\n * @param args the args of the function\n * @returns the function found\n */\nexport function getSignatureOfFunction(abi: Abi, funcName: string, args: any[] = []): AbiFunction {\n  return searchAbiFunction(abi, funcName, args)\n}\n\n/**\n * It searchs an ABI function in the ABI and return the inputs.\n * @param abi the ABI of the contract\n * @param funcName the function name\n * @param args the args of the function\n * @returns the function found\n */\nexport function getInputsOfFunction(abi: Abi, funcName: string, args: any[] = []) {\n  return searchAbiFunction(abi, funcName, args).inputs\n}\n\n/**\n * It searchs an ABI function in the ABI and return the inputs formatted.\n * @param abi the ABI of the contract\n * @param funcName the function name\n * @param args the args of the function\n * @returns the function found\n */\nexport function getInputsOfFunctionFormatted(abi: Abi, funcName: string, args: any[] = []) {\n  return searchAbiFunction(abi, funcName, args).inputs.map((input, i) => {\n    return {\n      name: input.name,\n      value: args[i],\n    }\n  })\n}\n\n//////// UTILS\n\n/**\n * Given an address it returns that address in checksum format.\n * @param address the address\n * @returns the same address in checksum format\n */\nexport function getChecksumAddress(address: string): string {\n  return getAddress(address)\n}\n\n/**\n * It checks if the address is a valid address.\n * @param address the address to check\n * @returns true of the address is valid\n */\nexport function isValidAddress(address: string): boolean {\n  return isAddress(address)\n}\n\n/**\n * Encodes a UTF-8 string into a byte array.\n\n * @param message the string to encode\n * @returns the encoded byte array\n */\nexport function getBytes(message: string): Uint8Array {\n  return stringToBytes(message)\n}\n\n/**\n * It pads a value with zeros.\n * @param value the value to pad\n * @param length the expected longitutde of the value\n * @returns the padded value\n */\nexport function zeroPadValue(value: `0x${string}` | Uint8Array, length: number): string {\n  return pad(value, { size: length }) as `0x${string}`\n}\n\n/**\n * Encodes a UTF-8 string into a hex string\n * @param message the string to encode\n * @returns the hex string\n */\nexport function encodeBytes32String(message: string) {\n  return stringToHex(message, { size: 32 })\n}\n\n////// ACCOUNTS\n/**\n * Given a seedphrase, it returns an account.\n * @param seedphrase - the seedphrase to be used to generate the account\n * @param addressIndex - the address index\n * @returns an account\n */\nexport function makeWallet(seedphrase: string, addressIndex = 0): Account {\n  return mnemonicToAccount(seedphrase, { addressIndex })\n}\n\n/**\n * Given a seedphrase generates multiple accounts\n * @param seedphrase - the seedphrase to be used to generate the account\n * @param numAccounts - the number of accounts to create\n * @returns the array of accounts\n */\nexport function makeWallets(seedphrase: string, numAccounts = 10) {\n  const accounts: Account[] = []\n  for (let i = 0; i < numAccounts; i++) {\n    accounts.push(makeWallet(seedphrase, i))\n  }\n  return accounts\n}\n\n/**\n * It generates a random account.\n * @returns a new account\n */\nexport function makeRandomWallet(): Account {\n  const mnemonic = generateMnemonic(english)\n  return makeWallet(mnemonic)\n}\n\n/**\n * It generates a list of random accounts\n * @param numAccounts - the number of accounts to create\n * @returns the array of accounts\n */\nexport function makeRandomWallets(numAccounts = 10): Account[] {\n  const mnemonic = generateMnemonic(english)\n  return makeWallets(mnemonic, numAccounts)\n}\n\n/////// HASHES\n\n/**\n * It hashes a string using keccak256.\n * @param seed the string to hash\n * @returns the hash\n */\nexport function keccak256(seed: string): string {\n  return viemKeccak256(toBytes(seed))\n}\n\n/**\n * It encodes and hashes a list of primitive values into an ABI-encoded hex value.\n * @param types the types of the values\n * @param values the values to encode\n * @returns the hash\n */\nexport function keccak256WithEncode(types: any[], values: any[]): string {\n  const encoded = encodeAbiParameters(types, values as never)\n  return keccak256(encoded)\n}\n\n/**\n * It encodes and hashes a list of primitive values into an ABI-encoded hex value.\n * @param types the types of the values\n * @param values the values to encode\n * @returns the hash\n */\nexport function keccak256Packed(types: any[], values: any[]): string {\n  return keccak256WithEncode(types, values)\n}\n\n/////// ZERO DEV\n\n/**\n * Returns the bundler RPC URL. When `BUNDLER_RPC_URL_OVERRIDE` is set\n * (used by tests against a local Alto + anvil-fork stack), it takes precedence\n * over the canonical ZeroDev URL.\n */\nexport function getBundlerRpcUrl(zeroDevProjectId: string, chainId: number): string {\n  // `||` (not `??`) because Vite replaces missing browser env vars with the\n  // empty string at build time; an empty override is equivalent to \"no\n  // override\" for our purposes.\n  return (\n    process.env.BUNDLER_RPC_URL_OVERRIDE ||\n    `https://rpc.zerodev.app/api/v3/${zeroDevProjectId}/chain/${chainId}`\n  )\n}\n\n/**\n * Returns the paymaster RPC URL (ZeroDev-only; the local fork stack uses\n * `ultra-relay` which sponsors via the bundler's executor key without a\n * paymaster, so this URL is not consulted when `BUNDLER_RPC_URL_OVERRIDE` is\n * set).\n */\nexport function getPaymasterRpcUrl(zeroDevProjectId: string, chainId: number): string {\n  return `https://rpc.zerodev.app/api/v3/${zeroDevProjectId}/chain/${chainId}`\n}\n\n/**\n * Returns true when the kernel client should run in \"relayer mode\" — no\n * paymaster, gas fees zeroed out. Used by tests against a local\n * `ultra-relay` (ZeroDev's fork of Alto) on top of an anvil-fork. The relayer's\n * executor key pays gas directly via `EntryPoint.handleOps`, avoiding the\n * paymaster sponsorship handshake altogether.\n */\nexport function isRelayerMode(): boolean {\n  return Boolean(process.env.BUNDLER_RPC_URL_OVERRIDE)\n}\n\n/**\n * Returns gas prices for UserOperation fee estimation. ZeroDev's bundler\n * exposes a custom `zd_getUserOperationGasPrice` method; standard ERC-4337\n * bundlers do not. In relayer mode the bundler accepts UserOps with zeroed\n * `maxFeePerGas`/`maxPriorityFeePerGas` and pays gas itself.\n */\nexport async function estimateUserOperationFees(\n  bundlerClient: any,\n  _publicClient: any,\n): Promise<{ maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }> {\n  if (isRelayerMode()) {\n    return { maxFeePerGas: 0n, maxPriorityFeePerGas: 0n }\n  }\n  return getUserOperationGasPrice(bundlerClient)\n}\n\n/**\n * It creates a ZeroDev Kernel client.\n * @param signer the signer account\n * @param chainId the chain id\n * @param zeroDevProjectId the zero dev project id, you can get it from the ZeroDev dashboard\n * @returns the kernel client\n */\nexport async function createKernelClient(\n  kernelAccount: SmartAccount,\n  chainId: number,\n  zeroDevProjectId: string,\n  publicClient: any,\n): Promise<KernelAccountClient> {\n  const bundlerRpc = getBundlerRpcUrl(zeroDevProjectId, chainId)\n  const paymasterRpc = getPaymasterRpcUrl(zeroDevProjectId, chainId)\n\n  return createKernelAccountClient({\n    account: kernelAccount,\n    chain: getChain(chainId),\n    bundlerTransport: http(bundlerRpc),\n    client: publicClient,\n    ...(isRelayerMode()\n      ? {}\n      : {\n          paymaster: {\n            getPaymasterData: (userOperation: any) => {\n              const zerodevPaymaster = createZeroDevPaymasterClient({\n                chain: getChain(chainId),\n                transport: http(paymasterRpc),\n              })\n              return zerodevPaymaster.sponsorUserOperation({ userOperation })\n            },\n          },\n        }),\n    userOperation: {\n      estimateFeesPerGas: async ({ bundlerClient }) => {\n        return estimateUserOperationFees(bundlerClient, publicClient)\n      },\n    },\n  })\n}\n\nexport async function createKernelSmartAccount(\n  signer: Signer,\n  publicClient: PublicClient,\n): Promise<SmartAccount> {\n  const ecdsaValidator = await signerToEcdsaValidator(publicClient, {\n    signer: signer,\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  return await createKernelAccount(publicClient, {\n    plugins: {\n      sudo: ecdsaValidator,\n    },\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    kernelVersion: KERNEL_V3_1,\n  })\n}\n\nexport async function getApproval(signer: Signer, publicClient: any, policies: any[]) {\n  const ecdsaValidator = await signerToEcdsaValidator(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    signer,\n    kernelVersion: KERNEL_V3_1,\n  })\n  const emptyAccount = addressToEmptyAccount(signer.address as Address)\n  const emptySessionKeySigner = await toECDSASigner({ signer: emptyAccount })\n\n  const permissionPlugin = await toPermissionValidator(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    signer: emptySessionKeySigner,\n    policies: policies,\n    kernelVersion: KERNEL_V3_1,\n  })\n  const sessionKeyAccount = await createKernelAccount(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    plugins: {\n      sudo: ecdsaValidator,\n      regular: permissionPlugin,\n    },\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  return await serializePermissionAccount(sessionKeyAccount)\n}\n\nexport async function useSessionKey(approval: string, signer: Signer, publicClient: any) {\n  const sessionKeySigner = await toECDSASigner({\n    signer,\n  })\n  const sessionKeyAccount = await deserializePermissionAccount(\n    publicClient,\n    getEntryPoint(ENTRY_POINT_VERSION),\n    KERNEL_V3_1,\n    approval,\n    sessionKeySigner,\n  )\n\n  return sessionKeyAccount\n}\n\nexport async function createSessionKey(signer: Signer, publicClient: any, policies: any[]) {\n  const ecdsaValidator = await signerToEcdsaValidator(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    signer,\n    kernelVersion: KERNEL_V3_1,\n  })\n  const sessionPrivateKey = generatePrivateKey()\n  const masterAccount = privateKeyToAccount(sessionPrivateKey)\n  const sessionKeySigner = await toECDSASigner({\n    signer: masterAccount,\n  })\n\n  const permissionPlugin = await toPermissionValidator(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    signer: sessionKeySigner,\n    policies: policies,\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  const sessionKeyAccount = await createKernelAccount(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    plugins: {\n      sudo: ecdsaValidator,\n      regular: permissionPlugin,\n    },\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  return serializePermissionAccount(sessionKeyAccount, sessionPrivateKey)\n}\n\nexport async function getSessionKey(serializedSessionKey: string, publicClient: any) {\n  const sessionKeyAccount = await deserializePermissionAccount(\n    publicClient,\n    getEntryPoint(ENTRY_POINT_VERSION),\n    KERNEL_V3_1,\n    serializedSessionKey,\n  )\n\n  return sessionKeyAccount\n}\n\n/**\n * Creates a delegated session key for an existing kernel account.\n * The resulting serialized session key can be deserialized into a SmartAccount\n * that shares the same address as the kernel account but enforces the given policies.\n *\n * @param kernelAccount The existing SmartAccount (kernel) to delegate from\n * @param publicClient Viem PublicClient instance\n * @param policies Array of policies to enforce for this session key\n * @returns Serialized session key string\n */\nexport async function createDelegatedSessionKeyFromKernel(\n  kernelAccount: SmartAccount,\n  publicClient: PublicClient,\n  policies: any[],\n): Promise<string> {\n  // 1) Generate ephemeral session private key (used only for the permission plugin)\n  const sessionPrivateKey = generatePrivateKey()\n  const sessionAccount = privateKeyToAccount(sessionPrivateKey)\n\n  // 2) Wrap ephemeral key as ECDSA signer for permissions\n  const sessionKeySigner = await toECDSASigner({ signer: sessionAccount })\n\n  // 3) Create the permission validator plugin\n  const permissionValidator = await toPermissionValidator(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    signer: sessionKeySigner,\n    policies,\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  // 4) Extract the sudo validator from the existing kernel account\n  const kernelAccountTyped = kernelAccount as SmartAccount<KernelSmartAccountImplementation>\n  const sudoValidator = kernelAccountTyped.kernelPluginManager.sudoValidator\n\n  if (!sudoValidator) {\n    throw new Error('Kernel account does not have a sudo validator')\n  }\n\n  // 5) Create a new kernel account with both sudo (from original) and permission validator\n  const sessionKeyAccount = await createKernelAccount(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    plugins: {\n      sudo: sudoValidator, // Use existing sudo validator\n      regular: permissionValidator,\n    },\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  // 6) Serialize the session key account with the ephemeral private key\n  const serialized = await serializePermissionAccount(sessionKeyAccount, sessionPrivateKey)\n\n  return serialized\n}\n\nexport const WalletUtils = {\n  makeWallet,\n  makeWallets,\n  makeRandomWallet,\n  makeRandomWallets,\n}\n"],"names":["signerToEcdsaValidator","deserializePermissionAccount","serializePermissionAccount","toPermissionValidator","toECDSASigner","addressToEmptyAccount","createKernelAccount","createKernelAccountClient","createZeroDevPaymasterClient","getUserOperationGasPrice","KERNEL_V3_1","getEntryPoint","encodeAbiParameters","getAbiItem","getAddress","getContract","http","isAddress","pad","stringToBytes","stringToHex","toBytes","keccak256","viemKeccak256","english","generateMnemonic","generatePrivateKey","mnemonicToAccount","privateKeyToAccount","Instantiable","ContractsError","getChain","ENTRY_POINT_VERSION","BlockchainViemUtils","config","setInstanceConfig","TRANSACTION_RECEIPT_TIMEOUT_MS","TRANSACTION_RECEIPT_POLLING_INTERVAL_MS","getTransactionReceipt","txHash","publicClient","waitForTransactionReceipt","hash","timeout","pollingInterval","confirmations","error","getContractInstance","contractAddress","abi","client","address","wallet","public","searchAbiFunction","funcName","args","func","name","type","searchAbiEvent","eventName","event","getSignatureOfFunction","getInputsOfFunction","inputs","getInputsOfFunctionFormatted","map","input","i","value","getChecksumAddress","isValidAddress","getBytes","message","zeroPadValue","length","size","encodeBytes32String","makeWallet","seedphrase","addressIndex","makeWallets","numAccounts","accounts","push","makeRandomWallet","mnemonic","makeRandomWallets","seed","keccak256WithEncode","types","values","encoded","keccak256Packed","getBundlerRpcUrl","zeroDevProjectId","chainId","process","env","BUNDLER_RPC_URL_OVERRIDE","getPaymasterRpcUrl","isRelayerMode","Boolean","estimateUserOperationFees","bundlerClient","_publicClient","maxFeePerGas","maxPriorityFeePerGas","createKernelClient","kernelAccount","bundlerRpc","paymasterRpc","account","chain","bundlerTransport","paymaster","getPaymasterData","userOperation","zerodevPaymaster","transport","sponsorUserOperation","estimateFeesPerGas","createKernelSmartAccount","signer","ecdsaValidator","entryPoint","kernelVersion","plugins","sudo","getApproval","policies","emptyAccount","emptySessionKeySigner","permissionPlugin","sessionKeyAccount","regular","useSessionKey","approval","sessionKeySigner","createSessionKey","sessionPrivateKey","masterAccount","getSessionKey","serializedSessionKey","createDelegatedSessionKeyFromKernel","sessionAccount","permissionValidator","kernelAccountTyped","sudoValidator","kernelPluginManager","Error","serialized","WalletUtils"],"mappings":"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"}
+{"version":3,"sources":["../../../src/nevermined/utils/BlockchainViemUtils.ts"],"sourcesContent":["import { signerToEcdsaValidator } from '@zerodev/ecdsa-validator'\nimport {\n  deserializePermissionAccount,\n  serializePermissionAccount,\n  toPermissionValidator,\n} from '@zerodev/permissions'\nimport { toECDSASigner } from '@zerodev/permissions/signers'\nimport {\n  addressToEmptyAccount,\n  createKernelAccount,\n  createKernelAccountClient,\n  createZeroDevPaymasterClient,\n  getUserOperationGasPrice,\n  KernelAccountClient,\n  type KernelSmartAccountImplementation,\n} from '@zerodev/sdk'\nimport { KERNEL_V3_1, getEntryPoint } from '@zerodev/sdk/constants'\nimport {\n  Address,\n  encodeAbiParameters,\n  getAbiItem,\n  getAddress,\n  getContract,\n  http,\n  isAddress,\n  pad,\n  stringToBytes,\n  stringToHex,\n  toBytes,\n  keccak256 as viemKeccak256,\n  type Abi,\n  type AbiEvent,\n  type AbiFunction,\n  type Account,\n  type PublicClient,\n  type TransactionReceipt,\n} from 'viem'\nimport { SmartAccount } from 'viem/account-abstraction'\nimport {\n  english,\n  generateMnemonic,\n  generatePrivateKey,\n  mnemonicToAccount,\n  privateKeyToAccount,\n} from 'viem/accounts'\nimport { Instantiable, InstantiableConfig, Web3Clients } from '../../Instantiable.abstract.js'\nimport { ContractsError } from '../../errors/NeverminedErrors.js'\nimport { getChain } from '../../utils/Network.js'\nimport { Signer } from '@zerodev/sdk/types'\n\nconst ENTRY_POINT_VERSION = '0.7'\n\n/**\n * Utility class with methods that allow the interaction with the blockchain.\n * This class uses Viem library to interact with the blockchain.\n */\nexport class BlockchainViemUtils extends Instantiable {\n  constructor(config: InstantiableConfig) {\n    super()\n    this.setInstanceConfig(config)\n  }\n}\n\n//////////////////////////\n///// UTILITIES //////////\n//////////////////////////\n\n///// CONTRACTS\n\n// Wait budget for an L2 block to be mined and the receipt to surface.\n// Base / Base Sepolia block time is ~2s; 30s ≈ 15 blocks of headroom.\nconst TRANSACTION_RECEIPT_TIMEOUT_MS = 30_000\nconst TRANSACTION_RECEIPT_POLLING_INTERVAL_MS = 1_500\n\n/**\n * Given a transaction hash, it returns the transaction receipt.\n * Uses viem's `waitForTransactionReceipt` which polls until the receipt is\n * available, retrying on `TransactionReceiptNotFoundError` and handling\n * tx-replacement / reorgs natively.\n * @param txHash - the transaction hash\n * @returns the transaction receipt\n */\nexport async function getTransactionReceipt({\n  txHash,\n  publicClient,\n}: {\n  txHash: `0x${string}`\n  publicClient: PublicClient\n  iteration?: number\n}): Promise<TransactionReceipt> {\n  try {\n    return await publicClient.waitForTransactionReceipt({\n      hash: txHash,\n      timeout: TRANSACTION_RECEIPT_TIMEOUT_MS,\n      pollingInterval: TRANSACTION_RECEIPT_POLLING_INTERVAL_MS,\n      confirmations: 1,\n    })\n  } catch (error) {\n    throw new ContractsError(\n      `Unable to get transaction receipt with hash: ${txHash}. Error: ${error}`,\n    )\n  }\n}\n\n/**\n * Given an already deployed contract address and the ABI, it returns the contract instance.\n *\n * @param contractAddress - the contract address\n * @param abi - the contract artifact\n * @param client - the client to interact with the blockchain\n * @returns a contract instance\n */\nexport async function getContractInstance(contractAddress: string, abi: Abi, client: Web3Clients) {\n  return getContract({\n    abi,\n    address: contractAddress as `0x${string}`,\n    client: { wallet: client.wallet, public: client.public },\n  })\n}\n\n///// ABIs\n\n/**\n * It searchs an ABI function in the ABI.\n * @param abi the ABI of the contract\n * @param funcName the function name\n * @param args the args of the function\n * @returns the function found\n */\nexport function searchAbiFunction(abi: Abi, funcName: string, args: any[] = []): AbiFunction {\n  const func = getAbiItem({ abi, name: funcName, args })\n  if (!func || func.type !== 'function') {\n    throw new ContractsError(`Function \"${funcName}\" is not part of contract`)\n  }\n  return func as AbiFunction\n}\n\n/**\n * It searchs an ABI event in the ABI.\n * @param abi the ABI of the contract\n * @param funcName the event name\n * @returns the event found\n */\nexport function searchAbiEvent(abi: Abi, eventName: string): AbiEvent {\n  const event = getAbiItem({\n    abi,\n    name: eventName,\n  })\n  if (!event || event.type !== 'event') {\n    throw new ContractsError(`Event \"${event}\" is not part of contract`)\n  }\n  return event as AbiEvent\n}\n\n/**\n * It searchs an ABI function in the ABI.\n * @param abi the ABI of the contract\n * @param funcName the function name\n * @param args the args of the function\n * @returns the function found\n */\nexport function getSignatureOfFunction(abi: Abi, funcName: string, args: any[] = []): AbiFunction {\n  return searchAbiFunction(abi, funcName, args)\n}\n\n/**\n * It searchs an ABI function in the ABI and return the inputs.\n * @param abi the ABI of the contract\n * @param funcName the function name\n * @param args the args of the function\n * @returns the function found\n */\nexport function getInputsOfFunction(abi: Abi, funcName: string, args: any[] = []) {\n  return searchAbiFunction(abi, funcName, args).inputs\n}\n\n/**\n * It searchs an ABI function in the ABI and return the inputs formatted.\n * @param abi the ABI of the contract\n * @param funcName the function name\n * @param args the args of the function\n * @returns the function found\n */\nexport function getInputsOfFunctionFormatted(abi: Abi, funcName: string, args: any[] = []) {\n  return searchAbiFunction(abi, funcName, args).inputs.map((input, i) => {\n    return {\n      name: input.name,\n      value: args[i],\n    }\n  })\n}\n\n//////// UTILS\n\n/**\n * Given an address it returns that address in checksum format.\n * @param address the address\n * @returns the same address in checksum format\n */\nexport function getChecksumAddress(address: string): string {\n  return getAddress(address)\n}\n\n/**\n * It checks if the address is a valid address.\n * @param address the address to check\n * @returns true of the address is valid\n */\nexport function isValidAddress(address: string): boolean {\n  return isAddress(address)\n}\n\n/**\n * Encodes a UTF-8 string into a byte array.\n\n * @param message the string to encode\n * @returns the encoded byte array\n */\nexport function getBytes(message: string): Uint8Array {\n  return stringToBytes(message)\n}\n\n/**\n * It pads a value with zeros.\n * @param value the value to pad\n * @param length the expected longitutde of the value\n * @returns the padded value\n */\nexport function zeroPadValue(value: `0x${string}` | Uint8Array, length: number): string {\n  return pad(value, { size: length }) as `0x${string}`\n}\n\n/**\n * Encodes a UTF-8 string into a hex string\n * @param message the string to encode\n * @returns the hex string\n */\nexport function encodeBytes32String(message: string) {\n  return stringToHex(message, { size: 32 })\n}\n\n////// ACCOUNTS\n/**\n * Given a seedphrase, it returns an account.\n * @param seedphrase - the seedphrase to be used to generate the account\n * @param addressIndex - the address index\n * @returns an account\n */\nexport function makeWallet(seedphrase: string, addressIndex = 0): Account {\n  return mnemonicToAccount(seedphrase, { addressIndex })\n}\n\n/**\n * Given a seedphrase generates multiple accounts\n * @param seedphrase - the seedphrase to be used to generate the account\n * @param numAccounts - the number of accounts to create\n * @returns the array of accounts\n */\nexport function makeWallets(seedphrase: string, numAccounts = 10) {\n  const accounts: Account[] = []\n  for (let i = 0; i < numAccounts; i++) {\n    accounts.push(makeWallet(seedphrase, i))\n  }\n  return accounts\n}\n\n/**\n * It generates a random account.\n * @returns a new account\n */\nexport function makeRandomWallet(): Account {\n  const mnemonic = generateMnemonic(english)\n  return makeWallet(mnemonic)\n}\n\n/**\n * It generates a list of random accounts\n * @param numAccounts - the number of accounts to create\n * @returns the array of accounts\n */\nexport function makeRandomWallets(numAccounts = 10): Account[] {\n  const mnemonic = generateMnemonic(english)\n  return makeWallets(mnemonic, numAccounts)\n}\n\n/////// HASHES\n\n/**\n * It hashes a string using keccak256.\n * @param seed the string to hash\n * @returns the hash\n */\nexport function keccak256(seed: string): string {\n  return viemKeccak256(toBytes(seed))\n}\n\n/**\n * It encodes and hashes a list of primitive values into an ABI-encoded hex value.\n * @param types the types of the values\n * @param values the values to encode\n * @returns the hash\n */\nexport function keccak256WithEncode(types: any[], values: any[]): string {\n  const encoded = encodeAbiParameters(types, values as never)\n  return keccak256(encoded)\n}\n\n/**\n * It encodes and hashes a list of primitive values into an ABI-encoded hex value.\n * @param types the types of the values\n * @param values the values to encode\n * @returns the hash\n */\nexport function keccak256Packed(types: any[], values: any[]): string {\n  return keccak256WithEncode(types, values)\n}\n\n/////// ZERO DEV\n\n/**\n * Returns the bundler RPC URL. When `BUNDLER_RPC_URL_OVERRIDE` is set\n * (used by tests against a local Alto + anvil-fork stack), it takes precedence\n * over the canonical ZeroDev URL. When `useUltraRelay` is true, the production\n * URL is routed through ZeroDev's UltraRelay (`?provider=ULTRA_RELAY`); the\n * override branch is left untouched.\n * @param useUltraRelay - when true, append `?provider=ULTRA_RELAY` to route the\n *   UserOperation through ZeroDev's UltraRelay bundler tier. Ignored when\n *   `BUNDLER_RPC_URL_OVERRIDE` is set.\n */\nexport function getBundlerRpcUrl(\n  zeroDevProjectId: string,\n  chainId: number,\n  useUltraRelay = false,\n): string {\n  const base = `https://rpc.zerodev.app/api/v3/${zeroDevProjectId}/chain/${chainId}`\n  // `||` (not `??`) because Vite replaces missing browser env vars with the\n  // empty string at build time; an empty override is equivalent to \"no\n  // override\" for our purposes.\n  return (\n    process.env.BUNDLER_RPC_URL_OVERRIDE || (useUltraRelay ? `${base}?provider=ULTRA_RELAY` : base)\n  )\n}\n\n/**\n * Returns the paymaster RPC URL (ZeroDev-only; the local fork stack uses\n * `ultra-relay` which sponsors via the bundler's executor key without a\n * paymaster, so this URL is not consulted when `BUNDLER_RPC_URL_OVERRIDE` is\n * set).\n */\nexport function getPaymasterRpcUrl(zeroDevProjectId: string, chainId: number): string {\n  return `https://rpc.zerodev.app/api/v3/${zeroDevProjectId}/chain/${chainId}`\n}\n\n/**\n * Returns true when the kernel client should run in \"relayer mode\" — no\n * paymaster, gas fees zeroed out. Used by tests against a local\n * `ultra-relay` (ZeroDev's fork of Alto) on top of an anvil-fork. The relayer's\n * executor key pays gas directly via `EntryPoint.handleOps`, avoiding the\n * paymaster sponsorship handshake altogether.\n */\nexport function isRelayerMode(): boolean {\n  return Boolean(process.env.BUNDLER_RPC_URL_OVERRIDE)\n}\n\n/**\n * Returns gas prices for UserOperation fee estimation. ZeroDev's bundler\n * exposes a custom `zd_getUserOperationGasPrice` method; standard ERC-4337\n * bundlers do not. In relayer mode the bundler accepts UserOps with zeroed\n * `maxFeePerGas`/`maxPriorityFeePerGas` and pays gas itself.\n */\nexport async function estimateUserOperationFees(\n  bundlerClient: any,\n  _publicClient: any,\n): Promise<{ maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }> {\n  if (isRelayerMode()) {\n    return { maxFeePerGas: 0n, maxPriorityFeePerGas: 0n }\n  }\n  return getUserOperationGasPrice(bundlerClient)\n}\n\n/**\n * It creates a ZeroDev Kernel client.\n * @param signer the signer account\n * @param chainId the chain id\n * @param zeroDevProjectId the zero dev project id, you can get it from the ZeroDev dashboard\n * @param useUltraRelay forwarded straight to `getBundlerRpcUrl` — when true the\n *   bundler RPC is routed through ZeroDev's UltraRelay. Ignored when\n *   `BUNDLER_RPC_URL_OVERRIDE` is set.\n * @returns the kernel client\n */\nexport async function createKernelClient(\n  kernelAccount: SmartAccount,\n  chainId: number,\n  zeroDevProjectId: string,\n  publicClient: any,\n  useUltraRelay = false,\n): Promise<KernelAccountClient> {\n  const bundlerRpc = getBundlerRpcUrl(zeroDevProjectId, chainId, useUltraRelay)\n  const paymasterRpc = getPaymasterRpcUrl(zeroDevProjectId, chainId)\n\n  return createKernelAccountClient({\n    account: kernelAccount,\n    chain: getChain(chainId),\n    bundlerTransport: http(bundlerRpc),\n    client: publicClient,\n    ...(isRelayerMode()\n      ? {}\n      : {\n          paymaster: {\n            getPaymasterData: (userOperation: any) => {\n              const zerodevPaymaster = createZeroDevPaymasterClient({\n                chain: getChain(chainId),\n                transport: http(paymasterRpc),\n              })\n              return zerodevPaymaster.sponsorUserOperation({ userOperation })\n            },\n          },\n        }),\n    userOperation: {\n      estimateFeesPerGas: async ({ bundlerClient }) => {\n        return estimateUserOperationFees(bundlerClient, publicClient)\n      },\n    },\n  })\n}\n\nexport async function createKernelSmartAccount(\n  signer: Signer,\n  publicClient: PublicClient,\n): Promise<SmartAccount> {\n  const ecdsaValidator = await signerToEcdsaValidator(publicClient, {\n    signer: signer,\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  return await createKernelAccount(publicClient, {\n    plugins: {\n      sudo: ecdsaValidator,\n    },\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    kernelVersion: KERNEL_V3_1,\n  })\n}\n\nexport async function getApproval(signer: Signer, publicClient: any, policies: any[]) {\n  const ecdsaValidator = await signerToEcdsaValidator(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    signer,\n    kernelVersion: KERNEL_V3_1,\n  })\n  const emptyAccount = addressToEmptyAccount(signer.address as Address)\n  const emptySessionKeySigner = await toECDSASigner({ signer: emptyAccount })\n\n  const permissionPlugin = await toPermissionValidator(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    signer: emptySessionKeySigner,\n    policies: policies,\n    kernelVersion: KERNEL_V3_1,\n  })\n  const sessionKeyAccount = await createKernelAccount(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    plugins: {\n      sudo: ecdsaValidator,\n      regular: permissionPlugin,\n    },\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  return await serializePermissionAccount(sessionKeyAccount)\n}\n\nexport async function useSessionKey(approval: string, signer: Signer, publicClient: any) {\n  const sessionKeySigner = await toECDSASigner({\n    signer,\n  })\n  const sessionKeyAccount = await deserializePermissionAccount(\n    publicClient,\n    getEntryPoint(ENTRY_POINT_VERSION),\n    KERNEL_V3_1,\n    approval,\n    sessionKeySigner,\n  )\n\n  return sessionKeyAccount\n}\n\nexport async function createSessionKey(signer: Signer, publicClient: any, policies: any[]) {\n  const ecdsaValidator = await signerToEcdsaValidator(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    signer,\n    kernelVersion: KERNEL_V3_1,\n  })\n  const sessionPrivateKey = generatePrivateKey()\n  const masterAccount = privateKeyToAccount(sessionPrivateKey)\n  const sessionKeySigner = await toECDSASigner({\n    signer: masterAccount,\n  })\n\n  const permissionPlugin = await toPermissionValidator(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    signer: sessionKeySigner,\n    policies: policies,\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  const sessionKeyAccount = await createKernelAccount(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    plugins: {\n      sudo: ecdsaValidator,\n      regular: permissionPlugin,\n    },\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  return serializePermissionAccount(sessionKeyAccount, sessionPrivateKey)\n}\n\nexport async function getSessionKey(serializedSessionKey: string, publicClient: any) {\n  const sessionKeyAccount = await deserializePermissionAccount(\n    publicClient,\n    getEntryPoint(ENTRY_POINT_VERSION),\n    KERNEL_V3_1,\n    serializedSessionKey,\n  )\n\n  return sessionKeyAccount\n}\n\n/**\n * Creates a delegated session key for an existing kernel account.\n * The resulting serialized session key can be deserialized into a SmartAccount\n * that shares the same address as the kernel account but enforces the given policies.\n *\n * @param kernelAccount The existing SmartAccount (kernel) to delegate from\n * @param publicClient Viem PublicClient instance\n * @param policies Array of policies to enforce for this session key\n * @returns Serialized session key string\n */\nexport async function createDelegatedSessionKeyFromKernel(\n  kernelAccount: SmartAccount,\n  publicClient: PublicClient,\n  policies: any[],\n): Promise<string> {\n  // 1) Generate ephemeral session private key (used only for the permission plugin)\n  const sessionPrivateKey = generatePrivateKey()\n  const sessionAccount = privateKeyToAccount(sessionPrivateKey)\n\n  // 2) Wrap ephemeral key as ECDSA signer for permissions\n  const sessionKeySigner = await toECDSASigner({ signer: sessionAccount })\n\n  // 3) Create the permission validator plugin\n  const permissionValidator = await toPermissionValidator(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    signer: sessionKeySigner,\n    policies,\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  // 4) Extract the sudo validator from the existing kernel account\n  const kernelAccountTyped = kernelAccount as SmartAccount<KernelSmartAccountImplementation>\n  const sudoValidator = kernelAccountTyped.kernelPluginManager.sudoValidator\n\n  if (!sudoValidator) {\n    throw new Error('Kernel account does not have a sudo validator')\n  }\n\n  // 5) Create a new kernel account with both sudo (from original) and permission validator\n  const sessionKeyAccount = await createKernelAccount(publicClient, {\n    entryPoint: getEntryPoint(ENTRY_POINT_VERSION),\n    plugins: {\n      sudo: sudoValidator, // Use existing sudo validator\n      regular: permissionValidator,\n    },\n    kernelVersion: KERNEL_V3_1,\n  })\n\n  // 6) Serialize the session key account with the ephemeral private key\n  const serialized = await serializePermissionAccount(sessionKeyAccount, sessionPrivateKey)\n\n  return serialized\n}\n\nexport const WalletUtils = {\n  makeWallet,\n  makeWallets,\n  makeRandomWallet,\n  makeRandomWallets,\n}\n"],"names":["signerToEcdsaValidator","deserializePermissionAccount","serializePermissionAccount","toPermissionValidator","toECDSASigner","addressToEmptyAccount","createKernelAccount","createKernelAccountClient","createZeroDevPaymasterClient","getUserOperationGasPrice","KERNEL_V3_1","getEntryPoint","encodeAbiParameters","getAbiItem","getAddress","getContract","http","isAddress","pad","stringToBytes","stringToHex","toBytes","keccak256","viemKeccak256","english","generateMnemonic","generatePrivateKey","mnemonicToAccount","privateKeyToAccount","Instantiable","ContractsError","getChain","ENTRY_POINT_VERSION","BlockchainViemUtils","config","setInstanceConfig","TRANSACTION_RECEIPT_TIMEOUT_MS","TRANSACTION_RECEIPT_POLLING_INTERVAL_MS","getTransactionReceipt","txHash","publicClient","waitForTransactionReceipt","hash","timeout","pollingInterval","confirmations","error","getContractInstance","contractAddress","abi","client","address","wallet","public","searchAbiFunction","funcName","args","func","name","type","searchAbiEvent","eventName","event","getSignatureOfFunction","getInputsOfFunction","inputs","getInputsOfFunctionFormatted","map","input","i","value","getChecksumAddress","isValidAddress","getBytes","message","zeroPadValue","length","size","encodeBytes32String","makeWallet","seedphrase","addressIndex","makeWallets","numAccounts","accounts","push","makeRandomWallet","mnemonic","makeRandomWallets","seed","keccak256WithEncode","types","values","encoded","keccak256Packed","getBundlerRpcUrl","zeroDevProjectId","chainId","useUltraRelay","base","process","env","BUNDLER_RPC_URL_OVERRIDE","getPaymasterRpcUrl","isRelayerMode","Boolean","estimateUserOperationFees","bundlerClient","_publicClient","maxFeePerGas","maxPriorityFeePerGas","createKernelClient","kernelAccount","bundlerRpc","paymasterRpc","account","chain","bundlerTransport","paymaster","getPaymasterData","userOperation","zerodevPaymaster","transport","sponsorUserOperation","estimateFeesPerGas","createKernelSmartAccount","signer","ecdsaValidator","entryPoint","kernelVersion","plugins","sudo","getApproval","policies","emptyAccount","emptySessionKeySigner","permissionPlugin","sessionKeyAccount","regular","useSessionKey","approval","sessionKeySigner","createSessionKey","sessionPrivateKey","masterAccount","getSessionKey","serializedSessionKey","createDelegatedSessionKeyFromKernel","sessionAccount","permissionValidator","kernelAccountTyped","sudoValidator","kernelPluginManager","Error","serialized","WalletUtils"],"mappings":"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"}

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@nevermined-io/core-kit",
-  "version": "0.5.21",
+  "version": "0.5.23",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "e2e": "NODE_OPTIONS='--loader ts-node/esm' mocha --config ./tests/integration/.mocharc.json",
     "e2e:external": "nx e2e:external"
   },
   "exports": {
@@ -46,10 +45,14 @@
         }
       },
       "e2e": {
-        "executor": "nx:run-commands",
+        "executor": "@nx/jest:jest",
         "options": {
-          "command": "tsx ../../node_modules/mocha/bin/mocha.js --config ./tests/integration/.mocharc.json",
-          "cwd": "packages/core-kit"
+          "jestConfig": "packages/core-kit/jest.config.e2e.mjs",
+          "passWithNoTests": true,
+          "runInBand": true,
+          "testMatch": [
+            "**/*.e2e.spec.[jt]s?(x)"
+          ]
         },
         "dependsOn": [
           "^build",
@@ -62,10 +65,14 @@
         ]
       },
       "e2e:external": {
-        "executor": "nx:run-commands",
+        "executor": "@nx/jest:jest",
         "options": {
-          "command": "tsx ../../node_modules/mocha/bin/mocha.js --config ./tests/external/.mocharc.json",
-          "cwd": "packages/core-kit"
+          "jestConfig": "packages/core-kit/jest.config.e2e.mjs",
+          "passWithNoTests": true,
+          "runInBand": true,
+          "testMatch": [
+            "**/*.external.spec.[jt]s?(x)"
+          ]
         },
         "dependsOn": [
           "^build",