@aa-sdk/core 4.0.0-alpha.9 → 4.0.0-beta.0

package/dist/esm/actions/smartAccount/buildUserOperation.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildUserOperation.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/buildUserOperation.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AA6BvE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAWtC,MAA4C,EAC5C,IAA0E;IAE1E,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,EACxB,oBAAoB,EACpB,MAAM,CACP,CAAC;IACJ,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CACnD,mBAAmB,CAAC,MAAM,EAAE;QAC1B,EAAE,EAAE,GAAG;QACP,SAAS;QACT,OAAO;QACP,OAAO;KACR,CAAC,CACH,CAAC;AACJ,CAAC","sourcesContent":["import type { Chain, Client, Transport } from \"viem\";\nimport {\n  type GetEntryPointFromAccount,\n  type SmartContractAccount,\n} from \"../../account/smartContractAccount.js\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport type { UserOperationStruct } from \"../../types.js\";\nimport { _initUserOperation } from \"./internal/initUserOperation.js\";\nimport { _runMiddlewareStack } from \"./internal/runMiddlewareStack.js\";\nimport type {\n  BuildUserOperationParameters,\n  UserOperationContext,\n} from \"./types\";\n\n/**\n * Builds a user operation using the provided client and operation parameters. Ensures that the account exists and the client is compatible.\n *\n * @example\n * ```ts\n * import { createSmartAccountClient } from \"@aa-sdk/core\";\n *\n * // smart account client is already extended with buildUserOperation\n * const client = createSmartAccountClient(...);\n * const result = await client.buildUserOperation({\n *  uo: {\n *    target: \"0x...\",\n *    data: \"0x...\", // or \"0x\",\n *    value: 0n, // optional\n *  },\n *  account, // only required if the client above is not connected to an account\n * });\n * ```\n *\n * @param {Client<TTransport, TChain, TAccount>} client the client instance used to build the user operation\n * @param {BuildUserOperationParameters<TAccount, TContext, TEntryPointVersion>} args the parameters required to build the user operation, including account, overrides, and context\n * @returns {Promise<UserOperationStruct<TEntryPointVersion>>} a promise that resolves to a `UserOperationStruct` object containing the built user operation details\n */\nexport async function buildUserOperation<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined,\n  TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>\n>(\n  client: Client<TTransport, TChain, TAccount>,\n  args: BuildUserOperationParameters<TAccount, TContext, TEntryPointVersion>\n): Promise<UserOperationStruct<TEntryPointVersion>> {\n  const { account = client.account, overrides, context } = args;\n  if (!account) {\n    throw new AccountNotFoundError();\n  }\n\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"buildUserOperation\",\n      client\n    );\n  }\n\n  return _initUserOperation(client, args).then((_uo) =>\n    _runMiddlewareStack(client, {\n      uo: _uo,\n      overrides,\n      account,\n      context,\n    })\n  );\n}\n"]}
+{"version":3,"file":"buildUserOperation.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/buildUserOperation.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAMvE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAWtC,MAA4C,EAC5C,IAA0E;IAE1E,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,EACxB,oBAAoB,EACpB,MAAM,CACP,CAAC;IACJ,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CACnD,mBAAmB,CAAC,MAAM,EAAE;QAC1B,EAAE,EAAE,GAAG;QACP,SAAS;QACT,OAAO;QACP,OAAO;KACR,CAAC,CACH,CAAC;AACJ,CAAC","sourcesContent":["import type { Chain, Client, Transport } from \"viem\";\nimport {\n  type GetEntryPointFromAccount,\n  type SmartContractAccount,\n} from \"../../account/smartContractAccount.js\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport type { UserOperationStruct } from \"../../types.js\";\nimport { _initUserOperation } from \"./internal/initUserOperation.js\";\nimport { _runMiddlewareStack } from \"./internal/runMiddlewareStack.js\";\nimport type {\n  BuildUserOperationParameters,\n  UserOperationContext,\n} from \"./types\";\n\n/**\n * Builds a user operation using the provided client and operation parameters. Ensures that the account exists and the client is compatible.\n *\n * @example\n * ```ts\n * import { createSmartAccountClient } from \"@aa-sdk/core\";\n *\n * // smart account client is already extended with buildUserOperation\n * const client = createSmartAccountClient(...);\n * const result = await client.buildUserOperation({\n *  uo: {\n *    target: \"0x...\",\n *    data: \"0x...\", // or \"0x\",\n *    value: 0n, // optional\n *  },\n *  account, // only required if the client above is not connected to an account\n * });\n * ```\n *\n * @param {Client<TTransport, TChain, TAccount>} client the client instance used to build the user operation\n * @param {BuildUserOperationParameters<TAccount, TContext, TEntryPointVersion>} args the parameters required to build the user operation, including account, overrides, and context\n * @returns {Promise<UserOperationStruct<TEntryPointVersion>>} a promise that resolves to a `UserOperationStruct` object containing the built user operation details\n */\nexport async function buildUserOperation<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined,\n  TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>\n>(\n  client: Client<TTransport, TChain, TAccount>,\n  args: BuildUserOperationParameters<TAccount, TContext, TEntryPointVersion>\n): Promise<UserOperationStruct<TEntryPointVersion>> {\n  const { account = client.account, overrides, context } = args;\n  if (!account) {\n    throw new AccountNotFoundError();\n  }\n\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"buildUserOperation\",\n      client\n    );\n  }\n\n  return _initUserOperation(client, args).then((_uo) =>\n    _runMiddlewareStack(client, {\n      uo: _uo,\n      overrides,\n      account,\n      context,\n    })\n  );\n}\n"]}

package/dist/esm/actions/smartAccount/buildUserOperationFromTx.d.ts

@@ -2,4 +2,43 @@ import { type Chain, type Client, type SendTransactionParameters, type Transport
 import type { GetEntryPointFromAccount, SmartContractAccount } from "../../account/smartContractAccount.js";
 import type { UserOperationOverrides, UserOperationStruct } from "../../types.js";
 import type { UserOperationContext } from "./types.js";
+/**
+ * Performs `buildUserOperationFromTx` in batch and builds into a single, yet to be signed `UserOperation` (UO) struct. The output user operation struct will be filled with all gas fields (and paymaster data if a paymaster is used) based on the transactions data (`to`, `data`, `value`, `maxFeePerGas`, `maxPriorityFeePerGas`) computed using the configured `ClientMiddlewares` on the `SmartAccountClient`
+ *
+ * @example
+ * ```ts
+ * import type { RpcTransactionRequest } from "viem";
+ * import { smartAccountClient } from "./smartAccountClient";
+ * // [!code focus:99]
+ * // buildUserOperationFromTx converts a traditional Ethereum transaction and returns
+ * // the unsigned user operation struct after constructing the user operation struct
+ * // through the middleware pipeline
+ * const tx: RpcTransactionRequest = {
+ *   from, // ignored
+ *   to,
+ *   data: encodeFunctionData({
+ *     abi: ContractABI.abi,
+ *     functionName: "func",
+ *     args: [arg1, arg2, ...],
+ *   }),
+ * };
+ * const uoStruct = await smartAccountClient.buildUserOperationFromTx(tx);
+ *
+ * // signUserOperation signs the above unsigned user operation struct built
+ * // using the account connected to the smart account client
+ * const request = await smartAccountClient.signUserOperation({ uoStruct });
+ *
+ * // You can use the BundlerAction `sendRawUserOperation` (packages/core/src/actions/bundler/sendRawUserOperation.ts)
+ * // to send the signed user operation request to the bundler, requesting the bundler to send the signed uo to the
+ * // EntryPoint contract pointed at by the entryPoint address parameter
+ * const entryPointAddress = client.account.getEntryPoint().address;
+ * const uoHash = await smartAccountClient.sendRawUserOperation({ request, entryPoint: entryPointAddress });
+ * ```
+ *
+ * @param {Client<Transport, TChain, TAccount>} client the smart account client to use for RPC requests
+ * @param {SendTransactionParameters} args the send tx parameters
+ * @param {UserOperationOverrides} overrides optional overrides to use for any of the fields
+ * @param {TContext} context if the smart account client requires additinoal context for building UOs
+ * @returns {Promise<UserOperationStruct<TEntryPointVersion>>} a Promise containing the built user operation
+ */
 export declare function buildUserOperationFromTx<TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartContractAccount | undefined = SmartContractAccount | undefined, TChainOverride extends Chain | undefined = Chain | undefined, TContext extends UserOperationContext | undefined = UserOperationContext | undefined, TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>>(client: Client<Transport, TChain, TAccount>, args: SendTransactionParameters<TChain, TAccount, TChainOverride>, overrides?: UserOperationOverrides<TEntryPointVersion>, context?: TContext): Promise<UserOperationStruct<TEntryPointVersion>>;

package/dist/esm/actions/smartAccount/buildUserOperationFromTx.js

@@ -4,6 +4,45 @@ import { AccountNotFoundError } from "../../errors/account.js";
 import { IncompatibleClientError } from "../../errors/client.js";
 import { TransactionMissingToParamError } from "../../errors/transaction.js";
 import { buildUserOperation } from "./buildUserOperation.js";
+/**
+ * Performs `buildUserOperationFromTx` in batch and builds into a single, yet to be signed `UserOperation` (UO) struct. The output user operation struct will be filled with all gas fields (and paymaster data if a paymaster is used) based on the transactions data (`to`, `data`, `value`, `maxFeePerGas`, `maxPriorityFeePerGas`) computed using the configured `ClientMiddlewares` on the `SmartAccountClient`
+ *
+ * @example
+ * ```ts
+ * import type { RpcTransactionRequest } from "viem";
+ * import { smartAccountClient } from "./smartAccountClient";
+ * // [!code focus:99]
+ * // buildUserOperationFromTx converts a traditional Ethereum transaction and returns
+ * // the unsigned user operation struct after constructing the user operation struct
+ * // through the middleware pipeline
+ * const tx: RpcTransactionRequest = {
+ *   from, // ignored
+ *   to,
+ *   data: encodeFunctionData({
+ *     abi: ContractABI.abi,
+ *     functionName: "func",
+ *     args: [arg1, arg2, ...],
+ *   }),
+ * };
+ * const uoStruct = await smartAccountClient.buildUserOperationFromTx(tx);
+ *
+ * // signUserOperation signs the above unsigned user operation struct built
+ * // using the account connected to the smart account client
+ * const request = await smartAccountClient.signUserOperation({ uoStruct });
+ *
+ * // You can use the BundlerAction `sendRawUserOperation` (packages/core/src/actions/bundler/sendRawUserOperation.ts)
+ * // to send the signed user operation request to the bundler, requesting the bundler to send the signed uo to the
+ * // EntryPoint contract pointed at by the entryPoint address parameter
+ * const entryPointAddress = client.account.getEntryPoint().address;
+ * const uoHash = await smartAccountClient.sendRawUserOperation({ request, entryPoint: entryPointAddress });
+ * ```
+ *
+ * @param {Client<Transport, TChain, TAccount>} client the smart account client to use for RPC requests
+ * @param {SendTransactionParameters} args the send tx parameters
+ * @param {UserOperationOverrides} overrides optional overrides to use for any of the fields
+ * @param {TContext} context if the smart account client requires additinoal context for building UOs
+ * @returns {Promise<UserOperationStruct<TEntryPointVersion>>} a Promise containing the built user operation
+ */
 export async function buildUserOperationFromTx(client, args, overrides, context) {
     const { account = client.account, ...request } = args;
     if (!account || typeof account === "string") {

package/dist/esm/actions/smartAccount/buildUserOperationFromTx.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildUserOperationFromTx.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/buildUserOperationFromTx.ts"],"names":[],"mappings":"AAAA,OAAO,EAKN,MAAM,MAAM,CAAC;AAKd,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAK7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AA0C7D,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAW5C,MAA2C,EAC3C,IAAiE,EACjE,SAAsD,EACtD,OAAkB;IAElB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;IACtD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,8BAA8B,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,CACP,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,GAAG,SAAS;QACZ,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;QACrE,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;YAChD,CAAC,CAAC,OAAO,CAAC,oBAAoB;YAC9B,CAAC,CAAC,SAAS;KACgC,CAAC;IAEhD,OAAO,kBAAkB,CAAC,MAAM,EAAE;QAChC,EAAE,EAAE;YACF,MAAM,EAAE,OAAO,CAAC,EAAE;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;SAC1C;QACD,OAAO,EAAE,OAA+B;QACxC,OAAO;QACP,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n  type Chain,\n  type Client,\n  type SendTransactionParameters,\n  type Transport,\n} from \"viem\";\nimport type {\n  GetEntryPointFromAccount,\n  SmartContractAccount,\n} from \"../../account/smartContractAccount.js\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport { TransactionMissingToParamError } from \"../../errors/transaction.js\";\nimport type {\n  UserOperationOverrides,\n  UserOperationStruct,\n} from \"../../types.js\";\nimport { buildUserOperation } from \"./buildUserOperation.js\";\nimport type { UserOperationContext } from \"./types.js\";\n\n/**\n * Performs `buildUserOperationFromTx` in batch and builds into a single, yet to be signed `UserOperation` (UO) struct. The output user operation struct will be filled with all gas fields (and paymaster data if a paymaster is used) based on the transactions data (`to`, `data`, `value`, `maxFeePerGas`, `maxPriorityFeePerGas`) computed using the configured `ClientMiddlewares` on the `SmartAccountClient`\n *\n * @example\n * ```ts\n * import type { RpcTransactionRequest } from \"viem\";\n * import { smartAccountClient } from \"./smartAccountClient\";\n * // [!code focus:99]\n * // buildUserOperationFromTx converts a traditional Ethereum transaction and returns\n * // the unsigned user operation struct after constructing the user operation struct\n * // through the middleware pipeline\n * const tx: RpcTransactionRequest = {\n *   from, // ignored\n *   to,\n *   data: encodeFunctionData({\n *     abi: ContractABI.abi,\n *     functionName: \"func\",\n *     args: [arg1, arg2, ...],\n *   }),\n * };\n * const uoStruct = await smartAccountClient.buildUserOperationFromTx(tx);\n *\n * // signUserOperation signs the above unsigned user operation struct built\n * // using the account connected to the smart account client\n * const request = await smartAccountClient.signUserOperation({ uoStruct });\n *\n * // You can use the BundlerAction `sendRawUserOperation` (packages/core/src/actions/bundler/sendRawUserOperation.ts)\n * // to send the signed user operation request to the bundler, requesting the bundler to send the signed uo to the\n * // EntryPoint contract pointed at by the entryPoint address parameter\n * const entryPointAddress = client.account.getEntryPoint().address;\n * const uoHash = await smartAccountClient.sendRawUserOperation({ request, entryPoint: entryPointAddress });\n * ```\n *\n * @param {Client<Transport, TChain, TAccount>} client the smart account client to use for RPC requests\n * @param {SendTransactionParameters} args the send tx parameters\n * @param {UserOperationOverrides} overrides optional overrides to use for any of the fields\n * @param {TContext} context if the smart account client requires additinoal context for building UOs\n * @returns {Promise<UserOperationStruct<TEntryPointVersion>>} a Promise containing the built user operation\n */\nexport async function buildUserOperationFromTx<\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TChainOverride extends Chain | undefined = Chain | undefined,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined,\n  TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>\n>(\n  client: Client<Transport, TChain, TAccount>,\n  args: SendTransactionParameters<TChain, TAccount, TChainOverride>,\n  overrides?: UserOperationOverrides<TEntryPointVersion>,\n  context?: TContext\n): Promise<UserOperationStruct<TEntryPointVersion>> {\n  const { account = client.account, ...request } = args;\n  if (!account || typeof account === \"string\") {\n    throw new AccountNotFoundError();\n  }\n\n  if (!request.to) {\n    throw new TransactionMissingToParamError();\n  }\n\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"buildUserOperationFromTx\",\n      client\n    );\n  }\n\n  const _overrides = {\n    ...overrides,\n    maxFeePerGas: request.maxFeePerGas ? request.maxFeePerGas : undefined,\n    maxPriorityFeePerGas: request.maxPriorityFeePerGas\n      ? request.maxPriorityFeePerGas\n      : undefined,\n  } as UserOperationOverrides<TEntryPointVersion>;\n\n  return buildUserOperation(client, {\n    uo: {\n      target: request.to,\n      data: request.data ?? \"0x\",\n      value: request.value ? request.value : 0n,\n    },\n    account: account as SmartContractAccount,\n    context,\n    overrides: _overrides,\n  });\n}\n"]}
+{"version":3,"file":"buildUserOperationFromTx.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/buildUserOperationFromTx.ts"],"names":[],"mappings":"AAAA,OAAO,EAKN,MAAM,MAAM,CAAC;AAKd,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAK7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAW5C,MAA2C,EAC3C,IAAiE,EACjE,SAAsD,EACtD,OAAkB;IAElB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;IACtD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,8BAA8B,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,CACP,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,GAAG,SAAS;QACZ,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;QACrE,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;YAChD,CAAC,CAAC,OAAO,CAAC,oBAAoB;YAC9B,CAAC,CAAC,SAAS;KACgC,CAAC;IAEhD,OAAO,kBAAkB,CAAC,MAAM,EAAE;QAChC,EAAE,EAAE;YACF,MAAM,EAAE,OAAO,CAAC,EAAE;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;SAC1C;QACD,OAAO,EAAE,OAA+B;QACxC,OAAO;QACP,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n  type Chain,\n  type Client,\n  type SendTransactionParameters,\n  type Transport,\n} from \"viem\";\nimport type {\n  GetEntryPointFromAccount,\n  SmartContractAccount,\n} from \"../../account/smartContractAccount.js\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport { TransactionMissingToParamError } from \"../../errors/transaction.js\";\nimport type {\n  UserOperationOverrides,\n  UserOperationStruct,\n} from \"../../types.js\";\nimport { buildUserOperation } from \"./buildUserOperation.js\";\nimport type { UserOperationContext } from \"./types.js\";\n\n/**\n * Performs `buildUserOperationFromTx` in batch and builds into a single, yet to be signed `UserOperation` (UO) struct. The output user operation struct will be filled with all gas fields (and paymaster data if a paymaster is used) based on the transactions data (`to`, `data`, `value`, `maxFeePerGas`, `maxPriorityFeePerGas`) computed using the configured `ClientMiddlewares` on the `SmartAccountClient`\n *\n * @example\n * ```ts\n * import type { RpcTransactionRequest } from \"viem\";\n * import { smartAccountClient } from \"./smartAccountClient\";\n * // [!code focus:99]\n * // buildUserOperationFromTx converts a traditional Ethereum transaction and returns\n * // the unsigned user operation struct after constructing the user operation struct\n * // through the middleware pipeline\n * const tx: RpcTransactionRequest = {\n *   from, // ignored\n *   to,\n *   data: encodeFunctionData({\n *     abi: ContractABI.abi,\n *     functionName: \"func\",\n *     args: [arg1, arg2, ...],\n *   }),\n * };\n * const uoStruct = await smartAccountClient.buildUserOperationFromTx(tx);\n *\n * // signUserOperation signs the above unsigned user operation struct built\n * // using the account connected to the smart account client\n * const request = await smartAccountClient.signUserOperation({ uoStruct });\n *\n * // You can use the BundlerAction `sendRawUserOperation` (packages/core/src/actions/bundler/sendRawUserOperation.ts)\n * // to send the signed user operation request to the bundler, requesting the bundler to send the signed uo to the\n * // EntryPoint contract pointed at by the entryPoint address parameter\n * const entryPointAddress = client.account.getEntryPoint().address;\n * const uoHash = await smartAccountClient.sendRawUserOperation({ request, entryPoint: entryPointAddress });\n * ```\n *\n * @param {Client<Transport, TChain, TAccount>} client the smart account client to use for RPC requests\n * @param {SendTransactionParameters} args the send tx parameters\n * @param {UserOperationOverrides} overrides optional overrides to use for any of the fields\n * @param {TContext} context if the smart account client requires additinoal context for building UOs\n * @returns {Promise<UserOperationStruct<TEntryPointVersion>>} a Promise containing the built user operation\n */\nexport async function buildUserOperationFromTx<\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TChainOverride extends Chain | undefined = Chain | undefined,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined,\n  TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>\n>(\n  client: Client<Transport, TChain, TAccount>,\n  args: SendTransactionParameters<TChain, TAccount, TChainOverride>,\n  overrides?: UserOperationOverrides<TEntryPointVersion>,\n  context?: TContext\n): Promise<UserOperationStruct<TEntryPointVersion>> {\n  const { account = client.account, ...request } = args;\n  if (!account || typeof account === \"string\") {\n    throw new AccountNotFoundError();\n  }\n\n  if (!request.to) {\n    throw new TransactionMissingToParamError();\n  }\n\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"buildUserOperationFromTx\",\n      client\n    );\n  }\n\n  const _overrides = {\n    ...overrides,\n    maxFeePerGas: request.maxFeePerGas ? request.maxFeePerGas : undefined,\n    maxPriorityFeePerGas: request.maxPriorityFeePerGas\n      ? request.maxPriorityFeePerGas\n      : undefined,\n  } as UserOperationOverrides<TEntryPointVersion>;\n\n  return buildUserOperation(client, {\n    uo: {\n      target: request.to,\n      data: request.data ?? \"0x\",\n      value: request.value ? request.value : 0n,\n    },\n    account: account as SmartContractAccount,\n    context,\n    overrides: _overrides,\n  });\n}\n"]}

package/dist/esm/actions/smartAccount/buildUserOperationFromTxs.d.ts

@@ -1,4 +1,58 @@
 import { type Chain, type Client, type Transport } from "viem";
 import type { GetEntryPointFromAccount, SmartContractAccount } from "../../account/smartContractAccount";
 import type { BuildTransactionParameters, BuildUserOperationFromTransactionsResult, UserOperationContext } from "./types";
+/**
+ * Performs `buildUserOperationFromTx` in batch and builds into a single,
+ * yet to be signed `UserOperation` (UO) struct. The output user operation struct
+ * will be filled with all gas fields (and paymaster data if a paymaster is used)
+ * based on the transactions data (`to`, `data`, `value`, `maxFeePerGas`,
+ * `maxPriorityFeePerGas`) computed using the configured ClientMiddlewares on the SmartAccountClient.
+ *
+ * @example
+ * ```ts
+ * import type { RpcTransactionRequest } from "viem";
+ * import { smartAccountClient } from "./smartAccountClient";
+ *
+ * const requests: RpcTransactionRequest[] = [
+ *   {
+ *     from, // ignored
+ *     to,
+ *     data: encodeFunctionData({
+ *       abi: ContractABI.abi,
+ *       functionName: "func",
+ *       args: [arg1, arg2, ...],
+ *     }),
+ *   },
+ *   {
+ *     from, // ignored
+ *     to,
+ *     data: encodeFunctionData({
+ *       abi: ContractABI.abi,
+ *       functionName: "func",
+ *       args: [arg1, arg2, ...],
+ *     }),
+ *   },
+ * ];
+ * const uoStruct = await smartAccountClient.buildUserOperationFromTxs({
+ *   requests,
+ * });
+ *
+ * // signUserOperation signs the above unsigned user operation struct built
+ * // using the account connected to the smart account client
+ * const request = await smartAccountClient.signUserOperation({ uoStruct });
+ *
+ * // You can use the BundlerAction `sendRawUserOperation` (packages/core/src/actions/bundler/sendRawUserOperation.ts)
+ * // to send the signed user operation request to the bundler, requesting the bundler to send the signed uo to the
+ * // EntryPoint contract pointed at by the entryPoint address parameter
+ * const entryPointAddress = client.account.getEntryPoint().address;
+ * const uoHash = await smartAccountClient.sendRawUserOperation({
+ *   request,
+ *   entryPoint: entryPointAddress,
+ * });
+ * ```
+ *
+ * @param {Client<TTransport, TChain, TAccount>} client the smart account client to use to make RPC calls
+ * @param {BuildTransactionParameters} args  an object containing the requests to build as well as, the account if not hoisted, the context, the overrides, and optionally a flag to enable signing of the UO via the underlying middleware
+ * @returns {Promise<BuildUserOperationFromTransactionsResult<TEntryPointVersion>>} a Promise containing the built user operation
+ */
 export declare function buildUserOperationFromTxs<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartContractAccount | undefined = SmartContractAccount | undefined, TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>, TContext extends UserOperationContext | undefined = UserOperationContext | undefined>(client: Client<TTransport, TChain, TAccount>, args: BuildTransactionParameters<TAccount, TContext, TEntryPointVersion>): Promise<BuildUserOperationFromTransactionsResult<TEntryPointVersion>>;

package/dist/esm/actions/smartAccount/buildUserOperationFromTxs.js

@@ -5,6 +5,60 @@ import { IncompatibleClientError } from "../../errors/client.js";
 import { TransactionMissingToParamError } from "../../errors/transaction.js";
 import { bigIntMax } from "../../utils/index.js";
 import { buildUserOperation } from "./buildUserOperation.js";
+/**
+ * Performs `buildUserOperationFromTx` in batch and builds into a single,
+ * yet to be signed `UserOperation` (UO) struct. The output user operation struct
+ * will be filled with all gas fields (and paymaster data if a paymaster is used)
+ * based on the transactions data (`to`, `data`, `value`, `maxFeePerGas`,
+ * `maxPriorityFeePerGas`) computed using the configured ClientMiddlewares on the SmartAccountClient.
+ *
+ * @example
+ * ```ts
+ * import type { RpcTransactionRequest } from "viem";
+ * import { smartAccountClient } from "./smartAccountClient";
+ *
+ * const requests: RpcTransactionRequest[] = [
+ *   {
+ *     from, // ignored
+ *     to,
+ *     data: encodeFunctionData({
+ *       abi: ContractABI.abi,
+ *       functionName: "func",
+ *       args: [arg1, arg2, ...],
+ *     }),
+ *   },
+ *   {
+ *     from, // ignored
+ *     to,
+ *     data: encodeFunctionData({
+ *       abi: ContractABI.abi,
+ *       functionName: "func",
+ *       args: [arg1, arg2, ...],
+ *     }),
+ *   },
+ * ];
+ * const uoStruct = await smartAccountClient.buildUserOperationFromTxs({
+ *   requests,
+ * });
+ *
+ * // signUserOperation signs the above unsigned user operation struct built
+ * // using the account connected to the smart account client
+ * const request = await smartAccountClient.signUserOperation({ uoStruct });
+ *
+ * // You can use the BundlerAction `sendRawUserOperation` (packages/core/src/actions/bundler/sendRawUserOperation.ts)
+ * // to send the signed user operation request to the bundler, requesting the bundler to send the signed uo to the
+ * // EntryPoint contract pointed at by the entryPoint address parameter
+ * const entryPointAddress = client.account.getEntryPoint().address;
+ * const uoHash = await smartAccountClient.sendRawUserOperation({
+ *   request,
+ *   entryPoint: entryPointAddress,
+ * });
+ * ```
+ *
+ * @param {Client<TTransport, TChain, TAccount>} client the smart account client to use to make RPC calls
+ * @param {BuildTransactionParameters} args  an object containing the requests to build as well as, the account if not hoisted, the context, the overrides, and optionally a flag to enable signing of the UO via the underlying middleware
+ * @returns {Promise<BuildUserOperationFromTransactionsResult<TEntryPointVersion>>} a Promise containing the built user operation
+ */
 export async function buildUserOperationFromTxs(client, args) {
     const { account = client.account, requests, overrides, context } = args;
     if (!account) {
@@ -51,6 +105,7 @@ export async function buildUserOperationFromTxs(client, args) {
     });
     return {
         uoStruct,
+        // TODO: in v4 major version update, remove these as below parameters are not needed
         batch,
         overrides: _overrides,
     };

package/dist/esm/actions/smartAccount/buildUserOperationFromTxs.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildUserOperationFromTxs.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/buildUserOperationFromTxs.ts"],"names":[],"mappings":"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","sourcesContent":["import { fromHex, type Chain, type Client, type Transport } from \"viem\";\nimport type {\n  GetEntryPointFromAccount,\n  SmartContractAccount,\n} from \"../../account/smartContractAccount\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport { TransactionMissingToParamError } from \"../../errors/transaction.js\";\nimport type { UserOperationOverrides } from \"../../types\";\nimport { bigIntMax } from \"../../utils/index.js\";\nimport { buildUserOperation } from \"./buildUserOperation.js\";\nimport type {\n  BuildTransactionParameters,\n  BuildUserOperationFromTransactionsResult,\n  UserOperationContext,\n} from \"./types\";\n\n/**\n * Performs `buildUserOperationFromTx` in batch and builds into a single,\n * yet to be signed `UserOperation` (UO) struct. The output user operation struct\n * will be filled with all gas fields (and paymaster data if a paymaster is used)\n * based on the transactions data (`to`, `data`, `value`, `maxFeePerGas`,\n * `maxPriorityFeePerGas`) computed using the configured ClientMiddlewares on the SmartAccountClient.\n *\n * @example\n * ```ts\n * import type { RpcTransactionRequest } from \"viem\";\n * import { smartAccountClient } from \"./smartAccountClient\";\n *\n * const requests: RpcTransactionRequest[] = [\n *   {\n *     from, // ignored\n *     to,\n *     data: encodeFunctionData({\n *       abi: ContractABI.abi,\n *       functionName: \"func\",\n *       args: [arg1, arg2, ...],\n *     }),\n *   },\n *   {\n *     from, // ignored\n *     to,\n *     data: encodeFunctionData({\n *       abi: ContractABI.abi,\n *       functionName: \"func\",\n *       args: [arg1, arg2, ...],\n *     }),\n *   },\n * ];\n * const uoStruct = await smartAccountClient.buildUserOperationFromTxs({\n *   requests,\n * });\n *\n * // signUserOperation signs the above unsigned user operation struct built\n * // using the account connected to the smart account client\n * const request = await smartAccountClient.signUserOperation({ uoStruct });\n *\n * // You can use the BundlerAction `sendRawUserOperation` (packages/core/src/actions/bundler/sendRawUserOperation.ts)\n * // to send the signed user operation request to the bundler, requesting the bundler to send the signed uo to the\n * // EntryPoint contract pointed at by the entryPoint address parameter\n * const entryPointAddress = client.account.getEntryPoint().address;\n * const uoHash = await smartAccountClient.sendRawUserOperation({\n *   request,\n *   entryPoint: entryPointAddress,\n * });\n * ```\n *\n * @param {Client<TTransport, TChain, TAccount>} client the smart account client to use to make RPC calls\n * @param {BuildTransactionParameters} args  an object containing the requests to build as well as, the account if not hoisted, the context, the overrides, and optionally a flag to enable signing of the UO via the underlying middleware\n * @returns {Promise<BuildUserOperationFromTransactionsResult<TEntryPointVersion>>} a Promise containing the built user operation\n */\nexport async function buildUserOperationFromTxs<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined\n>(\n  client: Client<TTransport, TChain, TAccount>,\n  args: BuildTransactionParameters<TAccount, TContext, TEntryPointVersion>\n): Promise<BuildUserOperationFromTransactionsResult<TEntryPointVersion>> {\n  const { account = client.account, requests, overrides, context } = args;\n  if (!account) {\n    throw new AccountNotFoundError();\n  }\n\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"buildUserOperationFromTxs\",\n      client\n    );\n  }\n\n  const batch = requests.map((request) => {\n    if (!request.to) {\n      throw new TransactionMissingToParamError();\n    }\n\n    return {\n      target: request.to,\n      data: request.data ?? \"0x\",\n      value: request.value ? fromHex(request.value, \"bigint\") : 0n,\n    };\n  });\n\n  const mfpgOverridesInTx = () =>\n    requests\n      .filter((x) => x.maxFeePerGas != null)\n      .map((x) => fromHex(x.maxFeePerGas!, \"bigint\"));\n  const maxFeePerGas =\n    overrides?.maxFeePerGas != null\n      ? overrides?.maxFeePerGas\n      : mfpgOverridesInTx().length > 0\n      ? bigIntMax(...mfpgOverridesInTx())\n      : undefined;\n\n  const mpfpgOverridesInTx = () =>\n    requests\n      .filter((x) => x.maxPriorityFeePerGas != null)\n      .map((x) => fromHex(x.maxPriorityFeePerGas!, \"bigint\"));\n  const maxPriorityFeePerGas =\n    overrides?.maxPriorityFeePerGas != null\n      ? overrides?.maxPriorityFeePerGas\n      : mpfpgOverridesInTx().length > 0\n      ? bigIntMax(...mpfpgOverridesInTx())\n      : undefined;\n\n  const _overrides = {\n    maxFeePerGas,\n    maxPriorityFeePerGas,\n  } as UserOperationOverrides<TEntryPointVersion>;\n\n  const uoStruct = await buildUserOperation(client, {\n    uo: batch,\n    account,\n    context,\n    overrides: _overrides,\n  });\n\n  return {\n    uoStruct,\n    // TODO: in v4 major version update, remove these as below parameters are not needed\n    batch,\n    overrides: _overrides,\n  };\n}\n"]}
+{"version":3,"file":"buildUserOperationFromTxs.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/buildUserOperationFromTxs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA2C,MAAM,MAAM,CAAC;AAKxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAO7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAW7C,MAA4C,EAC5C,IAAwE;IAExE,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACxE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,EACxB,2BAA2B,EAC3B,MAAM,CACP,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACrC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,8BAA8B,EAAE,CAAC;QAC7C,CAAC;QAED,OAAO;YACL,MAAM,EAAE,OAAO,CAAC,EAAE;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;SAC7D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAC7B,QAAQ;SACL,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,YAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpD,MAAM,YAAY,GAChB,SAAS,EAAE,YAAY,IAAI,IAAI;QAC7B,CAAC,CAAC,SAAS,EAAE,YAAY;QACzB,CAAC,CAAC,iBAAiB,EAAE,CAAC,MAAM,GAAG,CAAC;YAChC,CAAC,CAAC,SAAS,CAAC,GAAG,iBAAiB,EAAE,CAAC;YACnC,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAC9B,QAAQ;SACL,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB,IAAI,IAAI,CAAC;SAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAqB,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC5D,MAAM,oBAAoB,GACxB,SAAS,EAAE,oBAAoB,IAAI,IAAI;QACrC,CAAC,CAAC,SAAS,EAAE,oBAAoB;QACjC,CAAC,CAAC,kBAAkB,EAAE,CAAC,MAAM,GAAG,CAAC;YACjC,CAAC,CAAC,SAAS,CAAC,GAAG,kBAAkB,EAAE,CAAC;YACpC,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,UAAU,GAAG;QACjB,YAAY;QACZ,oBAAoB;KACyB,CAAC;IAEhD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE;QAChD,EAAE,EAAE,KAAK;QACT,OAAO;QACP,OAAO;QACP,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ;QACR,oFAAoF;QACpF,KAAK;QACL,SAAS,EAAE,UAAU;KACtB,CAAC;AACJ,CAAC","sourcesContent":["import { fromHex, type Chain, type Client, type Transport } from \"viem\";\nimport type {\n  GetEntryPointFromAccount,\n  SmartContractAccount,\n} from \"../../account/smartContractAccount\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport { TransactionMissingToParamError } from \"../../errors/transaction.js\";\nimport type { UserOperationOverrides } from \"../../types\";\nimport { bigIntMax } from \"../../utils/index.js\";\nimport { buildUserOperation } from \"./buildUserOperation.js\";\nimport type {\n  BuildTransactionParameters,\n  BuildUserOperationFromTransactionsResult,\n  UserOperationContext,\n} from \"./types\";\n\n/**\n * Performs `buildUserOperationFromTx` in batch and builds into a single,\n * yet to be signed `UserOperation` (UO) struct. The output user operation struct\n * will be filled with all gas fields (and paymaster data if a paymaster is used)\n * based on the transactions data (`to`, `data`, `value`, `maxFeePerGas`,\n * `maxPriorityFeePerGas`) computed using the configured ClientMiddlewares on the SmartAccountClient.\n *\n * @example\n * ```ts\n * import type { RpcTransactionRequest } from \"viem\";\n * import { smartAccountClient } from \"./smartAccountClient\";\n *\n * const requests: RpcTransactionRequest[] = [\n *   {\n *     from, // ignored\n *     to,\n *     data: encodeFunctionData({\n *       abi: ContractABI.abi,\n *       functionName: \"func\",\n *       args: [arg1, arg2, ...],\n *     }),\n *   },\n *   {\n *     from, // ignored\n *     to,\n *     data: encodeFunctionData({\n *       abi: ContractABI.abi,\n *       functionName: \"func\",\n *       args: [arg1, arg2, ...],\n *     }),\n *   },\n * ];\n * const uoStruct = await smartAccountClient.buildUserOperationFromTxs({\n *   requests,\n * });\n *\n * // signUserOperation signs the above unsigned user operation struct built\n * // using the account connected to the smart account client\n * const request = await smartAccountClient.signUserOperation({ uoStruct });\n *\n * // You can use the BundlerAction `sendRawUserOperation` (packages/core/src/actions/bundler/sendRawUserOperation.ts)\n * // to send the signed user operation request to the bundler, requesting the bundler to send the signed uo to the\n * // EntryPoint contract pointed at by the entryPoint address parameter\n * const entryPointAddress = client.account.getEntryPoint().address;\n * const uoHash = await smartAccountClient.sendRawUserOperation({\n *   request,\n *   entryPoint: entryPointAddress,\n * });\n * ```\n *\n * @param {Client<TTransport, TChain, TAccount>} client the smart account client to use to make RPC calls\n * @param {BuildTransactionParameters} args  an object containing the requests to build as well as, the account if not hoisted, the context, the overrides, and optionally a flag to enable signing of the UO via the underlying middleware\n * @returns {Promise<BuildUserOperationFromTransactionsResult<TEntryPointVersion>>} a Promise containing the built user operation\n */\nexport async function buildUserOperationFromTxs<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined\n>(\n  client: Client<TTransport, TChain, TAccount>,\n  args: BuildTransactionParameters<TAccount, TContext, TEntryPointVersion>\n): Promise<BuildUserOperationFromTransactionsResult<TEntryPointVersion>> {\n  const { account = client.account, requests, overrides, context } = args;\n  if (!account) {\n    throw new AccountNotFoundError();\n  }\n\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"buildUserOperationFromTxs\",\n      client\n    );\n  }\n\n  const batch = requests.map((request) => {\n    if (!request.to) {\n      throw new TransactionMissingToParamError();\n    }\n\n    return {\n      target: request.to,\n      data: request.data ?? \"0x\",\n      value: request.value ? fromHex(request.value, \"bigint\") : 0n,\n    };\n  });\n\n  const mfpgOverridesInTx = () =>\n    requests\n      .filter((x) => x.maxFeePerGas != null)\n      .map((x) => fromHex(x.maxFeePerGas!, \"bigint\"));\n  const maxFeePerGas =\n    overrides?.maxFeePerGas != null\n      ? overrides?.maxFeePerGas\n      : mfpgOverridesInTx().length > 0\n      ? bigIntMax(...mfpgOverridesInTx())\n      : undefined;\n\n  const mpfpgOverridesInTx = () =>\n    requests\n      .filter((x) => x.maxPriorityFeePerGas != null)\n      .map((x) => fromHex(x.maxPriorityFeePerGas!, \"bigint\"));\n  const maxPriorityFeePerGas =\n    overrides?.maxPriorityFeePerGas != null\n      ? overrides?.maxPriorityFeePerGas\n      : mpfpgOverridesInTx().length > 0\n      ? bigIntMax(...mpfpgOverridesInTx())\n      : undefined;\n\n  const _overrides = {\n    maxFeePerGas,\n    maxPriorityFeePerGas,\n  } as UserOperationOverrides<TEntryPointVersion>;\n\n  const uoStruct = await buildUserOperation(client, {\n    uo: batch,\n    account,\n    context,\n    overrides: _overrides,\n  });\n\n  return {\n    uoStruct,\n    // TODO: in v4 major version update, remove these as below parameters are not needed\n    batch,\n    overrides: _overrides,\n  };\n}\n"]}

package/dist/esm/actions/smartAccount/checkGasSponsorshipEligibility.d.ts

@@ -1,4 +1,32 @@
 import type { Chain, Client, Transport } from "viem";
 import type { SmartContractAccount } from "../../account/smartContractAccount.js";
 import type { SendUserOperationParameters, UserOperationContext } from "./types";
+/**
+ * This function verifies the eligibility of the connected account for gas sponsorship concerning the upcoming `UserOperation` (UO) that is intended to be sent.
+ * Internally, this method invokes `buildUserOperation`, which navigates through the middleware pipeline, including the `PaymasterMiddleware`. Its purpose is to construct the UO struct meant for transmission to the bundler. Following the construction of the UO struct, this function verifies if the resulting structure contains a non-empty `paymasterAndData` field.
+ * You can utilize this method before sending the user operation to confirm its eligibility for gas sponsorship. Depending on the outcome, it allows you to tailor the user experience accordingly, based on eligibility.
+ *
+ * @example
+ * ```ts
+ * import { smartAccountClient } from "./smartAccountClient";
+ * // [!code focus:99]
+ * const eligible = await smartAccountClient.checkGasSponsorshipEligibility({
+ *   uo: {
+ *     data: "0xCalldata",
+ *     target: "0xTarget",
+ *     value: 0n,
+ *   },
+ * });
+ *
+ * console.log(
+ *   `User Operation is ${
+ *     eligible ? "eligible" : "ineligible"
+ *   } for gas sponsorship.`
+ * );
+ * ```
+ *
+ * @param {Client<TTransport, TChain, TAccount>} client the smart account client to use for making RPC calls
+ * @param {SendUserOperationParameters} args containing the user operation, account, context, and overrides
+ * @returns {Promise<boolean>} a Promise containing a boolean indicating if the account is elgibile for sponsorship
+ */
 export declare function checkGasSponsorshipEligibility<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartContractAccount | undefined = SmartContractAccount | undefined, TContext extends UserOperationContext | undefined = UserOperationContext | undefined>(client: Client<TTransport, TChain, TAccount>, args: SendUserOperationParameters<TAccount, TContext>): Promise<boolean>;

package/dist/esm/actions/smartAccount/checkGasSponsorshipEligibility.js

@@ -2,6 +2,34 @@ import { isBaseSmartAccountClient } from "../../client/isSmartAccountClient.js";
 import { AccountNotFoundError } from "../../errors/account.js";
 import { IncompatibleClientError } from "../../errors/client.js";
 import { buildUserOperation } from "./buildUserOperation.js";
+/**
+ * This function verifies the eligibility of the connected account for gas sponsorship concerning the upcoming `UserOperation` (UO) that is intended to be sent.
+ * Internally, this method invokes `buildUserOperation`, which navigates through the middleware pipeline, including the `PaymasterMiddleware`. Its purpose is to construct the UO struct meant for transmission to the bundler. Following the construction of the UO struct, this function verifies if the resulting structure contains a non-empty `paymasterAndData` field.
+ * You can utilize this method before sending the user operation to confirm its eligibility for gas sponsorship. Depending on the outcome, it allows you to tailor the user experience accordingly, based on eligibility.
+ *
+ * @example
+ * ```ts
+ * import { smartAccountClient } from "./smartAccountClient";
+ * // [!code focus:99]
+ * const eligible = await smartAccountClient.checkGasSponsorshipEligibility({
+ *   uo: {
+ *     data: "0xCalldata",
+ *     target: "0xTarget",
+ *     value: 0n,
+ *   },
+ * });
+ *
+ * console.log(
+ *   `User Operation is ${
+ *     eligible ? "eligible" : "ineligible"
+ *   } for gas sponsorship.`
+ * );
+ * ```
+ *
+ * @param {Client<TTransport, TChain, TAccount>} client the smart account client to use for making RPC calls
+ * @param {SendUserOperationParameters} args containing the user operation, account, context, and overrides
+ * @returns {Promise<boolean>} a Promise containing a boolean indicating if the account is elgibile for sponsorship
+ */
 export function checkGasSponsorshipEligibility(client, args) {
     const { account = client.account, overrides, context } = args;
     if (!account) {

package/dist/esm/actions/smartAccount/checkGasSponsorshipEligibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkGasSponsorshipEligibility.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/checkGasSponsorshipEligibility.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAkC7D,MAAM,UAAU,8BAA8B,CAU5C,MAA4C,EAC5C,IAAqD;IAErD,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE9D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,EACxB,gCAAgC,EAChC,MAAM,CACP,CAAC;IACJ,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,EAAE;QAChC,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,OAAO;QACP,SAAS;QACT,OAAO;KACR,CAAC;SACC,IAAI,CAAC,CAAC,mBAAmB,EAAE,EAAE,CAC5B,OAAO,CAAC,aAAa,EAAE,CAAC,OAAO,KAAK,OAAO;QACzC,CAAC,CAAE,mBAAoD;aAClD,gBAAgB,KAAK,IAAI;YAC3B,mBAAoD;iBAClD,gBAAgB,KAAK,IAAI;QAC9B,CAAC,CAAE,mBAAoD;aAClD,aAAa,KAAK,IAAI;YACxB,mBAAoD;iBAClD,aAAa,KAAK,IAAI,CAC9B;SACA,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC","sourcesContent":["import type { Chain, Client, Transport } from \"viem\";\nimport type { SmartContractAccount } from \"../../account/smartContractAccount.js\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport type { UserOperationStruct } from \"../../types.js\";\nimport { buildUserOperation } from \"./buildUserOperation.js\";\nimport type {\n  SendUserOperationParameters,\n  UserOperationContext,\n} from \"./types\";\n\n/**\n * This function verifies the eligibility of the connected account for gas sponsorship concerning the upcoming `UserOperation` (UO) that is intended to be sent.\n * Internally, this method invokes `buildUserOperation`, which navigates through the middleware pipeline, including the `PaymasterMiddleware`. Its purpose is to construct the UO struct meant for transmission to the bundler. Following the construction of the UO struct, this function verifies if the resulting structure contains a non-empty `paymasterAndData` field.\n * You can utilize this method before sending the user operation to confirm its eligibility for gas sponsorship. Depending on the outcome, it allows you to tailor the user experience accordingly, based on eligibility.\n *\n * @example\n * ```ts\n * import { smartAccountClient } from \"./smartAccountClient\";\n * // [!code focus:99]\n * const eligible = await smartAccountClient.checkGasSponsorshipEligibility({\n *   uo: {\n *     data: \"0xCalldata\",\n *     target: \"0xTarget\",\n *     value: 0n,\n *   },\n * });\n *\n * console.log(\n *   `User Operation is ${\n *     eligible ? \"eligible\" : \"ineligible\"\n *   } for gas sponsorship.`\n * );\n * ```\n *\n * @param {Client<TTransport, TChain, TAccount>} client the smart account client to use for making RPC calls\n * @param {SendUserOperationParameters} args containing the user operation, account, context, and overrides\n * @returns {Promise<boolean>} a Promise containing a boolean indicating if the account is elgibile for sponsorship\n */\nexport function checkGasSponsorshipEligibility<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined\n>(\n  client: Client<TTransport, TChain, TAccount>,\n  args: SendUserOperationParameters<TAccount, TContext>\n): Promise<boolean> {\n  const { account = client.account, overrides, context } = args;\n\n  if (!account) {\n    throw new AccountNotFoundError();\n  }\n\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"checkGasSponsorshipEligibility\",\n      client\n    );\n  }\n\n  return buildUserOperation(client, {\n    uo: args.uo,\n    account,\n    overrides,\n    context,\n  })\n    .then((userOperationStruct) =>\n      account.getEntryPoint().version === \"0.6.0\"\n        ? (userOperationStruct as UserOperationStruct<\"0.6.0\">)\n            .paymasterAndData !== \"0x\" &&\n          (userOperationStruct as UserOperationStruct<\"0.6.0\">)\n            .paymasterAndData !== null\n        : (userOperationStruct as UserOperationStruct<\"0.7.0\">)\n            .paymasterData !== \"0x\" &&\n          (userOperationStruct as UserOperationStruct<\"0.7.0\">)\n            .paymasterData !== null\n    )\n    .catch(() => false);\n}\n"]}
+{"version":3,"file":"checkGasSponsorshipEligibility.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/checkGasSponsorshipEligibility.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,8BAA8B,CAU5C,MAA4C,EAC5C,IAAqD;IAErD,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE9D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,EACxB,gCAAgC,EAChC,MAAM,CACP,CAAC;IACJ,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,EAAE;QAChC,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,OAAO;QACP,SAAS;QACT,OAAO;KACR,CAAC;SACC,IAAI,CAAC,CAAC,mBAAmB,EAAE,EAAE,CAC5B,OAAO,CAAC,aAAa,EAAE,CAAC,OAAO,KAAK,OAAO;QACzC,CAAC,CAAE,mBAAoD;aAClD,gBAAgB,KAAK,IAAI;YAC3B,mBAAoD;iBAClD,gBAAgB,KAAK,IAAI;QAC9B,CAAC,CAAE,mBAAoD;aAClD,aAAa,KAAK,IAAI;YACxB,mBAAoD;iBAClD,aAAa,KAAK,IAAI,CAC9B;SACA,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC","sourcesContent":["import type { Chain, Client, Transport } from \"viem\";\nimport type { SmartContractAccount } from \"../../account/smartContractAccount.js\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport type { UserOperationStruct } from \"../../types.js\";\nimport { buildUserOperation } from \"./buildUserOperation.js\";\nimport type {\n  SendUserOperationParameters,\n  UserOperationContext,\n} from \"./types\";\n\n/**\n * This function verifies the eligibility of the connected account for gas sponsorship concerning the upcoming `UserOperation` (UO) that is intended to be sent.\n * Internally, this method invokes `buildUserOperation`, which navigates through the middleware pipeline, including the `PaymasterMiddleware`. Its purpose is to construct the UO struct meant for transmission to the bundler. Following the construction of the UO struct, this function verifies if the resulting structure contains a non-empty `paymasterAndData` field.\n * You can utilize this method before sending the user operation to confirm its eligibility for gas sponsorship. Depending on the outcome, it allows you to tailor the user experience accordingly, based on eligibility.\n *\n * @example\n * ```ts\n * import { smartAccountClient } from \"./smartAccountClient\";\n * // [!code focus:99]\n * const eligible = await smartAccountClient.checkGasSponsorshipEligibility({\n *   uo: {\n *     data: \"0xCalldata\",\n *     target: \"0xTarget\",\n *     value: 0n,\n *   },\n * });\n *\n * console.log(\n *   `User Operation is ${\n *     eligible ? \"eligible\" : \"ineligible\"\n *   } for gas sponsorship.`\n * );\n * ```\n *\n * @param {Client<TTransport, TChain, TAccount>} client the smart account client to use for making RPC calls\n * @param {SendUserOperationParameters} args containing the user operation, account, context, and overrides\n * @returns {Promise<boolean>} a Promise containing a boolean indicating if the account is elgibile for sponsorship\n */\nexport function checkGasSponsorshipEligibility<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined\n>(\n  client: Client<TTransport, TChain, TAccount>,\n  args: SendUserOperationParameters<TAccount, TContext>\n): Promise<boolean> {\n  const { account = client.account, overrides, context } = args;\n\n  if (!account) {\n    throw new AccountNotFoundError();\n  }\n\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"checkGasSponsorshipEligibility\",\n      client\n    );\n  }\n\n  return buildUserOperation(client, {\n    uo: args.uo,\n    account,\n    overrides,\n    context,\n  })\n    .then((userOperationStruct) =>\n      account.getEntryPoint().version === \"0.6.0\"\n        ? (userOperationStruct as UserOperationStruct<\"0.6.0\">)\n            .paymasterAndData !== \"0x\" &&\n          (userOperationStruct as UserOperationStruct<\"0.6.0\">)\n            .paymasterAndData !== null\n        : (userOperationStruct as UserOperationStruct<\"0.7.0\">)\n            .paymasterData !== \"0x\" &&\n          (userOperationStruct as UserOperationStruct<\"0.7.0\">)\n            .paymasterData !== null\n    )\n    .catch(() => false);\n}\n"]}

package/dist/esm/actions/smartAccount/dropAndReplaceUserOperation.d.ts

@@ -2,4 +2,26 @@ import type { Chain, Client, Transport } from "viem";
 import type { GetEntryPointFromAccount, SmartContractAccount } from "../../account/smartContractAccount";
 import type { SendUserOperationResult } from "../../client/types";
 import type { DropAndReplaceUserOperationParameters, UserOperationContext } from "./types";
+/**
+ * Drops an existing user operation and replaces it with a new one while ensuring the appropriate fees and overrides are applied.
+ *
+ * @example
+ * ```ts
+ * import {
+ *  createSmartAccountClient,
+ * } from "@aa-sdk/core";
+ *
+ * // smart account client is already extended with dropAndReplaceUserOperation
+ * const client = createSmartAccountClient(...);
+ * const { request } = await client.sendUserOperation(...);
+ * const result = await client.dropAndReplaceUserOperation({
+ *  uoToDrop: request,
+ *  account, // only required if the client above is not connected to an account
+ * });
+ * ```
+ *
+ * @param {Client<TTransport, TChain, TAccount>} client The client instance with the transport, chain, and account information
+ * @param {DropAndReplaceUserOperationParameters<TAccount, TContext>} args The parameters required for dropping and replacing the user operation including the account, operation to drop, overrides, and context
+ * @returns {Promise<SendUserOperationResult<TEntryPointVersion>>} A promise that resolves to the result of sending the new user operation
+ */
 export declare function dropAndReplaceUserOperation<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartContractAccount | undefined = SmartContractAccount | undefined, TContext extends UserOperationContext | undefined = UserOperationContext | undefined, TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>>(client: Client<TTransport, TChain, TAccount>, args: DropAndReplaceUserOperationParameters<TAccount, TContext>): Promise<SendUserOperationResult<TEntryPointVersion>>;

package/dist/esm/actions/smartAccount/dropAndReplaceUserOperation.js

@@ -1,9 +1,31 @@
 import { isBaseSmartAccountClient } from "../../client/isSmartAccountClient.js";
 import { AccountNotFoundError } from "../../errors/account.js";
 import { IncompatibleClientError } from "../../errors/client.js";
-import { bigIntMax, bigIntMultiply } from "../../utils/index.js";
+import { bigIntMax, bigIntMultiply, resolveProperties, } from "../../utils/index.js";
 import { _runMiddlewareStack } from "./internal/runMiddlewareStack.js";
 import { _sendUserOperation } from "./internal/sendUserOperation.js";
+/**
+ * Drops an existing user operation and replaces it with a new one while ensuring the appropriate fees and overrides are applied.
+ *
+ * @example
+ * ```ts
+ * import {
+ *  createSmartAccountClient,
+ * } from "@aa-sdk/core";
+ *
+ * // smart account client is already extended with dropAndReplaceUserOperation
+ * const client = createSmartAccountClient(...);
+ * const { request } = await client.sendUserOperation(...);
+ * const result = await client.dropAndReplaceUserOperation({
+ *  uoToDrop: request,
+ *  account, // only required if the client above is not connected to an account
+ * });
+ * ```
+ *
+ * @param {Client<TTransport, TChain, TAccount>} client The client instance with the transport, chain, and account information
+ * @param {DropAndReplaceUserOperationParameters<TAccount, TContext>} args The parameters required for dropping and replacing the user operation including the account, operation to drop, overrides, and context
+ * @returns {Promise<SendUserOperationResult<TEntryPointVersion>>} A promise that resolves to the result of sending the new user operation
+ */
 export async function dropAndReplaceUserOperation(client, args) {
     const { account = client.account, uoToDrop, overrides, context } = args;
     if (!account) {
@@ -35,11 +57,10 @@ export async function dropAndReplaceUserOperation(client, args) {
             callData: uoToDrop.callData,
             signature: await account.getDummySignature(),
         });
-    const { maxFeePerGas, maxPriorityFeePerGas } = await _runMiddlewareStack(client, {
-        uo: uoToSubmit,
-        overrides,
-        account,
-    });
+    // If the fee estimator is not the one estimating fees, then this won't work
+    // however, we have migrated to using erc7677middleware for alchemy paymaster flows
+    // and most of the other paymasters we've seen don't do fee estimation
+    const { maxFeePerGas, maxPriorityFeePerGas } = await resolveProperties(await client.middleware.feeEstimator(uoToSubmit, { account, client }));
     const _overrides = {
         ...overrides,
         maxFeePerGas: bigIntMax(BigInt(maxFeePerGas ?? 0n), bigIntMultiply(uoToDrop.maxFeePerGas, 1.1)),

package/dist/esm/actions/smartAccount/dropAndReplaceUserOperation.js.map

@@ -1 +1 @@
-{"version":3,"file":"dropAndReplaceUserOperation.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/dropAndReplaceUserOperation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAMjE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AA4BrE,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAW/C,MAA4C,EAC5C,IAA+D;IAE/D,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACxE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,EACxB,6BAA6B,EAC7B,MAAM,CACP,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAE3C,MAAM,UAAU,GAAG,CACjB,UAAU,CAAC,OAAO,KAAK,OAAO;QAC5B,CAAC,CAAC;YACE,QAAQ,EAAG,QAA0C,CAAC,QAAQ;YAC9D,MAAM,EAAG,QAA0C,CAAC,MAAM;YAC1D,KAAK,EAAG,QAA0C,CAAC,KAAK;YACxD,QAAQ,EAAG,QAA0C,CAAC,QAAQ;YAC9D,SAAS,EAAE,MAAM,OAAO,CAAC,iBAAiB,EAAE;SAC7C;QACH,CAAC,CAAC;YACE,GAAG,CAAE,QAA0C,CAAC,OAAO;gBACtD,QAA0C,CAAC,WAAW;gBACrD,CAAC,CAAC;oBACE,OAAO,EAAG,QAA0C,CAAC,OAAO;oBAC5D,WAAW,EAAG,QAA0C;yBACrD,WAAW;iBACf;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,EAAG,QAA0C,CAAC,MAAM;YAC1D,KAAK,EAAG,QAA0C,CAAC,KAAK;YACxD,QAAQ,EAAG,QAA0C,CAAC,QAAQ;YAC9D,SAAS,EAAE,MAAM,OAAO,CAAC,iBAAiB,EAAE;SAC7C,CACqC,CAAC;IAI7C,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAAG,MAAM,mBAAmB,CACtE,MAAM,EACN;QACE,EAAE,EAAE,UAAU;QACd,SAAS;QACT,OAAO;KACR,CACF,CAAC;IAEF,MAAM,UAAU,GAAG;QACjB,GAAG,SAAS;QACZ,YAAY,EAAE,SAAS,CACrB,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,EAC1B,cAAc,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,CAC3C;QACD,oBAAoB,EAAE,SAAS,CAC7B,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAC,EAClC,cAAc,CAAC,QAAQ,CAAC,oBAAoB,EAAE,GAAG,CAAC,CACnD;KAC4C,CAAC;IAEhD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE;QACjD,EAAE,EAAE,UAAU;QACd,SAAS,EAAE,UAAU;QACrB,OAAO;KACR,CAAC,CAAC;IAEH,OAAO,kBAAkB,CAAC,MAAM,EAAE;QAChC,QAAQ,EAAE,QAAQ;QAClB,OAAO;QACP,OAAO;QACP,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Chain, Client, Transport } from \"viem\";\nimport type {\n  GetEntryPointFromAccount,\n  SmartContractAccount,\n} from \"../../account/smartContractAccount\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport type { SendUserOperationResult } from \"../../client/types\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport type {\n  UserOperationOverrides,\n  UserOperationRequest,\n  UserOperationStruct,\n} from \"../../types\";\nimport { bigIntMax, bigIntMultiply } from \"../../utils/index.js\";\nimport { _runMiddlewareStack } from \"./internal/runMiddlewareStack.js\";\nimport { _sendUserOperation } from \"./internal/sendUserOperation.js\";\nimport type {\n  DropAndReplaceUserOperationParameters,\n  UserOperationContext,\n} from \"./types\";\n\n/**\n * Drops an existing user operation and replaces it with a new one while ensuring the appropriate fees and overrides are applied.\n *\n * @example\n * ```ts\n * import {\n *  createSmartAccountClient,\n * } from \"@aa-sdk/core\";\n *\n * // smart account client is already extended with dropAndReplaceUserOperation\n * const client = createSmartAccountClient(...);\n * const { request } = await client.sendUserOperation(...);\n * const result = await client.dropAndReplaceUserOperation({\n *  uoToDrop: request,\n *  account, // only required if the client above is not connected to an account\n * });\n * ```\n *\n * @param {Client<TTransport, TChain, TAccount>} client The client instance with the transport, chain, and account information\n * @param {DropAndReplaceUserOperationParameters<TAccount, TContext>} args The parameters required for dropping and replacing the user operation including the account, operation to drop, overrides, and context\n * @returns {Promise<SendUserOperationResult<TEntryPointVersion>>} A promise that resolves to the result of sending the new user operation\n */\nexport async function dropAndReplaceUserOperation<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined,\n  TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>\n>(\n  client: Client<TTransport, TChain, TAccount>,\n  args: DropAndReplaceUserOperationParameters<TAccount, TContext>\n): Promise<SendUserOperationResult<TEntryPointVersion>> {\n  const { account = client.account, uoToDrop, overrides, context } = args;\n  if (!account) {\n    throw new AccountNotFoundError();\n  }\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"dropAndReplaceUserOperation\",\n      client\n    );\n  }\n\n  const entryPoint = account.getEntryPoint();\n\n  const uoToSubmit = (\n    entryPoint.version === \"0.6.0\"\n      ? {\n          initCode: (uoToDrop as UserOperationRequest<\"0.6.0\">).initCode,\n          sender: (uoToDrop as UserOperationRequest<\"0.6.0\">).sender,\n          nonce: (uoToDrop as UserOperationRequest<\"0.6.0\">).nonce,\n          callData: (uoToDrop as UserOperationRequest<\"0.6.0\">).callData,\n          signature: await account.getDummySignature(),\n        }\n      : {\n          ...((uoToDrop as UserOperationRequest<\"0.7.0\">).factory &&\n          (uoToDrop as UserOperationRequest<\"0.7.0\">).factoryData\n            ? {\n                factory: (uoToDrop as UserOperationRequest<\"0.7.0\">).factory,\n                factoryData: (uoToDrop as UserOperationRequest<\"0.7.0\">)\n                  .factoryData,\n              }\n            : {}),\n          sender: (uoToDrop as UserOperationRequest<\"0.7.0\">).sender,\n          nonce: (uoToDrop as UserOperationRequest<\"0.7.0\">).nonce,\n          callData: (uoToDrop as UserOperationRequest<\"0.7.0\">).callData,\n          signature: await account.getDummySignature(),\n        }\n  ) as UserOperationStruct<TEntryPointVersion>;\n\n  // Run once to get the fee estimates\n  // This can happen at any part of the middleware stack, so we want to run it all\n  const { maxFeePerGas, maxPriorityFeePerGas } = await _runMiddlewareStack(\n    client,\n    {\n      uo: uoToSubmit,\n      overrides,\n      account,\n    }\n  );\n\n  const _overrides = {\n    ...overrides,\n    maxFeePerGas: bigIntMax(\n      BigInt(maxFeePerGas ?? 0n),\n      bigIntMultiply(uoToDrop.maxFeePerGas, 1.1)\n    ),\n    maxPriorityFeePerGas: bigIntMax(\n      BigInt(maxPriorityFeePerGas ?? 0n),\n      bigIntMultiply(uoToDrop.maxPriorityFeePerGas, 1.1)\n    ),\n  } as UserOperationOverrides<TEntryPointVersion>;\n\n  const uoToSend = await _runMiddlewareStack(client, {\n    uo: uoToSubmit,\n    overrides: _overrides,\n    account,\n  });\n\n  return _sendUserOperation(client, {\n    uoStruct: uoToSend,\n    account,\n    context,\n    overrides: _overrides,\n  });\n}\n"]}
+{"version":3,"file":"dropAndReplaceUserOperation.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/dropAndReplaceUserOperation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAMjE,OAAO,EACL,SAAS,EACT,cAAc,EACd,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAMrE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAW/C,MAA4C,EAC5C,IAA+D;IAE/D,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACxE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,EACxB,6BAA6B,EAC7B,MAAM,CACP,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAE3C,MAAM,UAAU,GAAG,CACjB,UAAU,CAAC,OAAO,KAAK,OAAO;QAC5B,CAAC,CAAC;YACE,QAAQ,EAAG,QAA0C,CAAC,QAAQ;YAC9D,MAAM,EAAG,QAA0C,CAAC,MAAM;YAC1D,KAAK,EAAG,QAA0C,CAAC,KAAK;YACxD,QAAQ,EAAG,QAA0C,CAAC,QAAQ;YAC9D,SAAS,EAAE,MAAM,OAAO,CAAC,iBAAiB,EAAE;SAC7C;QACH,CAAC,CAAC;YACE,GAAG,CAAE,QAA0C,CAAC,OAAO;gBACtD,QAA0C,CAAC,WAAW;gBACrD,CAAC,CAAC;oBACE,OAAO,EAAG,QAA0C,CAAC,OAAO;oBAC5D,WAAW,EAAG,QAA0C;yBACrD,WAAW;iBACf;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,EAAG,QAA0C,CAAC,MAAM;YAC1D,KAAK,EAAG,QAA0C,CAAC,KAAK;YACxD,QAAQ,EAAG,QAA0C,CAAC,QAAQ;YAC9D,SAAS,EAAE,MAAM,OAAO,CAAC,iBAAiB,EAAE;SAC7C,CACqC,CAAC;IAE7C,4EAA4E;IAC5E,mFAAmF;IACnF,sEAAsE;IACtE,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAAG,MAAM,iBAAiB,CACpE,MAAM,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CACtE,CAAC;IAEF,MAAM,UAAU,GAAG;QACjB,GAAG,SAAS;QACZ,YAAY,EAAE,SAAS,CACrB,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,EAC1B,cAAc,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,CAC3C;QACD,oBAAoB,EAAE,SAAS,CAC7B,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAC,EAClC,cAAc,CAAC,QAAQ,CAAC,oBAAoB,EAAE,GAAG,CAAC,CACnD;KAC4C,CAAC;IAEhD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE;QACjD,EAAE,EAAE,UAAU;QACd,SAAS,EAAE,UAAU;QACrB,OAAO;KACR,CAAC,CAAC;IAEH,OAAO,kBAAkB,CAAC,MAAM,EAAE;QAChC,QAAQ,EAAE,QAAQ;QAClB,OAAO;QACP,OAAO;QACP,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Chain, Client, Transport } from \"viem\";\nimport type {\n  GetEntryPointFromAccount,\n  SmartContractAccount,\n} from \"../../account/smartContractAccount\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport type { SendUserOperationResult } from \"../../client/types\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport type {\n  UserOperationOverrides,\n  UserOperationRequest,\n  UserOperationStruct,\n} from \"../../types\";\nimport {\n  bigIntMax,\n  bigIntMultiply,\n  resolveProperties,\n} from \"../../utils/index.js\";\nimport { _runMiddlewareStack } from \"./internal/runMiddlewareStack.js\";\nimport { _sendUserOperation } from \"./internal/sendUserOperation.js\";\nimport type {\n  DropAndReplaceUserOperationParameters,\n  UserOperationContext,\n} from \"./types\";\n\n/**\n * Drops an existing user operation and replaces it with a new one while ensuring the appropriate fees and overrides are applied.\n *\n * @example\n * ```ts\n * import {\n *  createSmartAccountClient,\n * } from \"@aa-sdk/core\";\n *\n * // smart account client is already extended with dropAndReplaceUserOperation\n * const client = createSmartAccountClient(...);\n * const { request } = await client.sendUserOperation(...);\n * const result = await client.dropAndReplaceUserOperation({\n *  uoToDrop: request,\n *  account, // only required if the client above is not connected to an account\n * });\n * ```\n *\n * @param {Client<TTransport, TChain, TAccount>} client The client instance with the transport, chain, and account information\n * @param {DropAndReplaceUserOperationParameters<TAccount, TContext>} args The parameters required for dropping and replacing the user operation including the account, operation to drop, overrides, and context\n * @returns {Promise<SendUserOperationResult<TEntryPointVersion>>} A promise that resolves to the result of sending the new user operation\n */\nexport async function dropAndReplaceUserOperation<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined,\n  TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>\n>(\n  client: Client<TTransport, TChain, TAccount>,\n  args: DropAndReplaceUserOperationParameters<TAccount, TContext>\n): Promise<SendUserOperationResult<TEntryPointVersion>> {\n  const { account = client.account, uoToDrop, overrides, context } = args;\n  if (!account) {\n    throw new AccountNotFoundError();\n  }\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"dropAndReplaceUserOperation\",\n      client\n    );\n  }\n\n  const entryPoint = account.getEntryPoint();\n\n  const uoToSubmit = (\n    entryPoint.version === \"0.6.0\"\n      ? {\n          initCode: (uoToDrop as UserOperationRequest<\"0.6.0\">).initCode,\n          sender: (uoToDrop as UserOperationRequest<\"0.6.0\">).sender,\n          nonce: (uoToDrop as UserOperationRequest<\"0.6.0\">).nonce,\n          callData: (uoToDrop as UserOperationRequest<\"0.6.0\">).callData,\n          signature: await account.getDummySignature(),\n        }\n      : {\n          ...((uoToDrop as UserOperationRequest<\"0.7.0\">).factory &&\n          (uoToDrop as UserOperationRequest<\"0.7.0\">).factoryData\n            ? {\n                factory: (uoToDrop as UserOperationRequest<\"0.7.0\">).factory,\n                factoryData: (uoToDrop as UserOperationRequest<\"0.7.0\">)\n                  .factoryData,\n              }\n            : {}),\n          sender: (uoToDrop as UserOperationRequest<\"0.7.0\">).sender,\n          nonce: (uoToDrop as UserOperationRequest<\"0.7.0\">).nonce,\n          callData: (uoToDrop as UserOperationRequest<\"0.7.0\">).callData,\n          signature: await account.getDummySignature(),\n        }\n  ) as UserOperationStruct<TEntryPointVersion>;\n\n  // If the fee estimator is not the one estimating fees, then this won't work\n  // however, we have migrated to using erc7677middleware for alchemy paymaster flows\n  // and most of the other paymasters we've seen don't do fee estimation\n  const { maxFeePerGas, maxPriorityFeePerGas } = await resolveProperties(\n    await client.middleware.feeEstimator(uoToSubmit, { account, client })\n  );\n\n  const _overrides = {\n    ...overrides,\n    maxFeePerGas: bigIntMax(\n      BigInt(maxFeePerGas ?? 0n),\n      bigIntMultiply(uoToDrop.maxFeePerGas, 1.1)\n    ),\n    maxPriorityFeePerGas: bigIntMax(\n      BigInt(maxPriorityFeePerGas ?? 0n),\n      bigIntMultiply(uoToDrop.maxPriorityFeePerGas, 1.1)\n    ),\n  } as UserOperationOverrides<TEntryPointVersion>;\n\n  const uoToSend = await _runMiddlewareStack(client, {\n    uo: uoToSubmit,\n    overrides: _overrides,\n    account,\n  });\n\n  return _sendUserOperation(client, {\n    uoStruct: uoToSend,\n    account,\n    context,\n    overrides: _overrides,\n  });\n}\n"]}

package/dist/esm/actions/smartAccount/estimateUserOperationGas.d.ts

@@ -2,4 +2,17 @@ import type { Chain, Client, Transport } from "viem";
 import { type GetEntryPointFromAccount, type SmartContractAccount } from "../../account/smartContractAccount.js";
 import type { UserOperationEstimateGasResponse } from "../../types.js";
 import type { SendUserOperationParameters, UserOperationContext } from "./types.js";
+/**
+ * Description SmartAccountClientAction for estimating the gas cost of a user operation
+ *
+ * @async
+ * @template {Transport} TTransport
+ * @template {Chain | undefined} TChain
+ * @template {SmartContractAccount | undefined} TAccount
+ * @template {UserOperationContext | undefined} TContext
+ * @template {GetEntryPointFromAccount<TAccount>} TEntryPointVersion
+ * @param {Client<TTransport, TChain, TAccount>} client smart account client
+ * @param {SendUserOperationParameters<TAccount, TContext>} args send user operation parameters
+ * @returns {Promise<UserOperationEstimateGasResponse<TEntryPointVersion>>}user operation gas estimate response
+ */
 export declare function estimateUserOperationGas<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartContractAccount | undefined = SmartContractAccount | undefined, TContext extends UserOperationContext | undefined = UserOperationContext | undefined, TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>>(client: Client<TTransport, TChain, TAccount>, args: SendUserOperationParameters<TAccount, TContext>): Promise<UserOperationEstimateGasResponse<TEntryPointVersion>>;

package/dist/esm/actions/smartAccount/estimateUserOperationGas.js

@@ -4,6 +4,19 @@ import { AccountNotFoundError } from "../../errors/account.js";
 import { IncompatibleClientError } from "../../errors/client.js";
 import { deepHexlify, resolveProperties } from "../../utils/index.js";
 import { _initUserOperation } from "./internal/initUserOperation.js";
+/**
+ * Description SmartAccountClientAction for estimating the gas cost of a user operation
+ *
+ * @async
+ * @template {Transport} TTransport
+ * @template {Chain | undefined} TChain
+ * @template {SmartContractAccount | undefined} TAccount
+ * @template {UserOperationContext | undefined} TContext
+ * @template {GetEntryPointFromAccount<TAccount>} TEntryPointVersion
+ * @param {Client<TTransport, TChain, TAccount>} client smart account client
+ * @param {SendUserOperationParameters<TAccount, TContext>} args send user operation parameters
+ * @returns {Promise<UserOperationEstimateGasResponse<TEntryPointVersion>>}user operation gas estimate response
+ */
 export async function estimateUserOperationGas(client, args) {
     const { account = client.account, overrides } = args;
     if (!account) {

package/dist/esm/actions/smartAccount/estimateUserOperationGas.js.map

@@ -1 +1 @@
-{"version":3,"file":"estimateUserOperationGas.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/estimateUserOperationGas.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAmBrE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAW5C,MAA4C,EAC5C,IAAqD;IAErD,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,CACP,CAAC;IACJ,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC,wBAAwB,CACpC,OAAO,EACP,OAAO,CAAC,aAAa,EAAE,CAAC,OAAO,EAC/B,SAAS,EAAE,aAAa,CACzB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Chain, Client, Transport } from \"viem\";\nimport {\n  type GetEntryPointFromAccount,\n  type SmartContractAccount,\n} from \"../../account/smartContractAccount.js\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport type { UserOperationEstimateGasResponse } from \"../../types.js\";\nimport { deepHexlify, resolveProperties } from \"../../utils/index.js\";\nimport { _initUserOperation } from \"./internal/initUserOperation.js\";\nimport type {\n  SendUserOperationParameters,\n  UserOperationContext,\n} from \"./types.js\";\n\n/**\n * Description SmartAccountClientAction for estimating the gas cost of a user operation\n *\n * @async\n * @template {Transport} TTransport\n * @template {Chain | undefined} TChain\n * @template {SmartContractAccount | undefined} TAccount\n * @template {UserOperationContext | undefined} TContext\n * @template {GetEntryPointFromAccount<TAccount>} TEntryPointVersion\n * @param {Client<TTransport, TChain, TAccount>} client smart account client\n * @param {SendUserOperationParameters<TAccount, TContext>} args send user operation parameters\n * @returns {Promise<UserOperationEstimateGasResponse<TEntryPointVersion>>}user operation gas estimate response\n */\nexport async function estimateUserOperationGas<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined,\n  TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>\n>(\n  client: Client<TTransport, TChain, TAccount>,\n  args: SendUserOperationParameters<TAccount, TContext>\n): Promise<UserOperationEstimateGasResponse<TEntryPointVersion>> {\n  const { account = client.account, overrides } = args;\n  if (!account) {\n    throw new AccountNotFoundError();\n  }\n\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"estimateUserOperationGas\",\n      client\n    );\n  }\n\n  return _initUserOperation(client, args).then(async (struct) => {\n    const request = deepHexlify(await resolveProperties(struct));\n    return client.estimateUserOperationGas(\n      request,\n      account.getEntryPoint().address,\n      overrides?.stateOverride\n    );\n  });\n}\n"]}
+{"version":3,"file":"estimateUserOperationGas.js","sourceRoot":"","sources":["../../../../src/actions/smartAccount/estimateUserOperationGas.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAMrE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAW5C,MAA4C,EAC5C,IAAqD;IAErD,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAC/B,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,CACP,CAAC;IACJ,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC,wBAAwB,CACpC,OAAO,EACP,OAAO,CAAC,aAAa,EAAE,CAAC,OAAO,EAC/B,SAAS,EAAE,aAAa,CACzB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Chain, Client, Transport } from \"viem\";\nimport {\n  type GetEntryPointFromAccount,\n  type SmartContractAccount,\n} from \"../../account/smartContractAccount.js\";\nimport { isBaseSmartAccountClient } from \"../../client/isSmartAccountClient.js\";\nimport { AccountNotFoundError } from \"../../errors/account.js\";\nimport { IncompatibleClientError } from \"../../errors/client.js\";\nimport type { UserOperationEstimateGasResponse } from \"../../types.js\";\nimport { deepHexlify, resolveProperties } from \"../../utils/index.js\";\nimport { _initUserOperation } from \"./internal/initUserOperation.js\";\nimport type {\n  SendUserOperationParameters,\n  UserOperationContext,\n} from \"./types.js\";\n\n/**\n * Description SmartAccountClientAction for estimating the gas cost of a user operation\n *\n * @async\n * @template {Transport} TTransport\n * @template {Chain | undefined} TChain\n * @template {SmartContractAccount | undefined} TAccount\n * @template {UserOperationContext | undefined} TContext\n * @template {GetEntryPointFromAccount<TAccount>} TEntryPointVersion\n * @param {Client<TTransport, TChain, TAccount>} client smart account client\n * @param {SendUserOperationParameters<TAccount, TContext>} args send user operation parameters\n * @returns {Promise<UserOperationEstimateGasResponse<TEntryPointVersion>>}user operation gas estimate response\n */\nexport async function estimateUserOperationGas<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartContractAccount | undefined =\n    | SmartContractAccount\n    | undefined,\n  TContext extends UserOperationContext | undefined =\n    | UserOperationContext\n    | undefined,\n  TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>\n>(\n  client: Client<TTransport, TChain, TAccount>,\n  args: SendUserOperationParameters<TAccount, TContext>\n): Promise<UserOperationEstimateGasResponse<TEntryPointVersion>> {\n  const { account = client.account, overrides } = args;\n  if (!account) {\n    throw new AccountNotFoundError();\n  }\n\n  if (!isBaseSmartAccountClient(client)) {\n    throw new IncompatibleClientError(\n      \"BaseSmartAccountClient\",\n      \"estimateUserOperationGas\",\n      client\n    );\n  }\n\n  return _initUserOperation(client, args).then(async (struct) => {\n    const request = deepHexlify(await resolveProperties(struct));\n    return client.estimateUserOperationGas(\n      request,\n      account.getEntryPoint().address,\n      overrides?.stateOverride\n    );\n  });\n}\n"]}

package/dist/esm/actions/smartAccount/internal/initUserOperation.d.ts

@@ -4,4 +4,17 @@ import type { BaseSmartAccountClient } from "../../../client/smartAccountClient.
 import type { UserOperationStruct } from "../../../types.js";
 import { type Deferrable } from "../../../utils/index.js";
 import type { BuildUserOperationParameters, SendUserOperationParameters, UserOperationContext } from "../types.js";
+/**
+ * Description internal action function of SmartAccountClient for initializing
+ * a user operation for the sender account
+ *
+ * @template {Transport} TTransport
+ * @template {Chain | undefined} TChain
+ * @template {SmartContractAccount | undefined} TAccount
+ * @template {UserOperationContext | undefined} TContext
+ * @template {GetEntryPointFromAccount} TEntryPointVersion
+ * @param {BaseSmartAccountClient<TTransport, TChain, TAccount>} client smart account client
+ * @param {SendUserOperationParameters<TAccount, TContext, TEntryPointVersion> | BuildUserOperationParameters<TAccount, TContext, TEntryPointVersion>} args send user operation parameters
+ * @returns {Promise<Deferrable<UserOperationStruct<TEntryPointVersion>>>} initialized user operation struct
+ */
 export declare function _initUserOperation<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartContractAccount | undefined = SmartContractAccount | undefined, TContext extends UserOperationContext | undefined = UserOperationContext | undefined, TEntryPointVersion extends GetEntryPointFromAccount<TAccount> = GetEntryPointFromAccount<TAccount>>(client: BaseSmartAccountClient<TTransport, TChain, TAccount>, args: SendUserOperationParameters<TAccount, TContext, TEntryPointVersion> | BuildUserOperationParameters<TAccount, TContext, TEntryPointVersion>): Promise<Deferrable<UserOperationStruct<TEntryPointVersion>>>;