@account-kit/wallet-client 0.1.0-alpha.1 → 0.1.0-alpha.2

package/dist/esm/capabilities/permissions/mav2.d.ts

@@ -1,7 +1,7 @@
 import type { Static } from "@sinclair/typebox";
 import { type Hex } from "viem";
-import type { PermissionsData } from ".";
-import type { KeySigner } from "../../schemas";
+import type { PermissionsData } from "./index.ts";
+import type { KeySigner } from "../../schemas.ts";
 export declare const SESSION_ID_LENGTH_BYTES = 16;
 export declare const ENTITY_ID_LENGTH_BYTES = 4;
 export declare const PermissionsContextVersion: {

package/dist/esm/capabilities/permissions/mav2.js.map

@@ -1 +1 @@
-{"version":3,"file":"mav2.js","sourceRoot":"","sources":["../../../../src/capabilities/permissions/mav2.ts"],"names":[],"mappings":"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","sourcesContent":["import { PermissionType } from \"@account-kit/smart-contracts/experimental\";\nimport type { Static } from \"@sinclair/typebox\";\nimport { concatHex, sliceHex, type Hex } from \"viem\";\nimport type { PermissionsData } from \".\";\nimport type { KeySigner } from \"../../schemas\";\nimport { assertNever } from \"../../utils.js\";\n\nexport const SESSION_ID_LENGTH_BYTES = 16;\nexport const ENTITY_ID_LENGTH_BYTES = 4;\n\nexport const PermissionsContextVersion = {\n  REMOTE_MODE_DEFERRED_ACTION: \"0x00\",\n  LOCAL_MODE_DEFERRED_ACTION: \"0x01\",\n  NON_DEFERRED_ACTION: \"0x02\",\n} as const;\n\ntype ContextVersionHex =\n  (typeof PermissionsContextVersion)[keyof typeof PermissionsContextVersion];\n\ntype DecodedPermissionsContext = {\n  contextVersion: keyof typeof PermissionsContextVersion;\n} & (\n  | {\n      contextVersion: \"REMOTE_MODE_DEFERRED_ACTION\";\n      sessionId: Hex;\n      signature: Hex;\n      deferredAction?: never;\n    }\n  | {\n      contextVersion: \"LOCAL_MODE_DEFERRED_ACTION\";\n      deferredAction: Hex;\n      sessionId?: never;\n      signature?: never;\n    }\n  | {\n      contextVersion: \"NON_DEFERRED_ACTION\";\n      deferredAction?: never;\n      sessionId?: never;\n      signature?: never;\n      entityId: Hex;\n      isGlobalValidation: boolean;\n    }\n);\n\nexport const encodePermissionsContext = (\n  context: DecodedPermissionsContext,\n): Hex => {\n  switch (context.contextVersion) {\n    case \"REMOTE_MODE_DEFERRED_ACTION\":\n      return concatHex([\n        PermissionsContextVersion.REMOTE_MODE_DEFERRED_ACTION,\n        context.sessionId,\n        context.signature,\n      ]);\n    case \"LOCAL_MODE_DEFERRED_ACTION\":\n      return concatHex([\n        PermissionsContextVersion.LOCAL_MODE_DEFERRED_ACTION,\n        context.deferredAction,\n      ]);\n    case \"NON_DEFERRED_ACTION\":\n      return concatHex([\n        PermissionsContextVersion.NON_DEFERRED_ACTION,\n        context.isGlobalValidation ? \"0x01\" : \"0x00\",\n        context.entityId,\n      ]);\n    default:\n      return assertNever(context, \"Unexpected context version\");\n  }\n};\n\nexport const decodePermissionsContext = (\n  input: Hex,\n): DecodedPermissionsContext => {\n  const contextVersion = sliceHex(input, 0, 1) as ContextVersionHex;\n  switch (contextVersion) {\n    case \"0x00\": {\n      const sessionId = sliceHex(input, 1, SESSION_ID_LENGTH_BYTES + 1);\n      const signature = sliceHex(input, SESSION_ID_LENGTH_BYTES + 1);\n      return {\n        contextVersion: \"REMOTE_MODE_DEFERRED_ACTION\",\n        sessionId,\n        signature,\n      };\n    }\n    case \"0x01\": {\n      const deferredAction = sliceHex(input, 1);\n      return {\n        contextVersion: \"LOCAL_MODE_DEFERRED_ACTION\",\n        deferredAction,\n      };\n    }\n    case \"0x02\": {\n      const isGlobalValidation = sliceHex(input, 1, 2) === \"0x01\";\n      const entityId = sliceHex(input, 2, ENTITY_ID_LENGTH_BYTES + 2);\n      return {\n        contextVersion: \"NON_DEFERRED_ACTION\",\n        isGlobalValidation,\n        entityId,\n      };\n    }\n    default:\n      return assertNever(\n        contextVersion,\n        `Unexpected context version: ${contextVersion}`,\n      );\n  }\n};\n\nexport const prefixSignatureKeyType = (\n  sig: Hex,\n  type: KeySigner[\"type\"],\n): Hex => {\n  switch (type) {\n    case \"secp256k1\":\n      return concatHex([\"0x00\", sig]);\n    case \"contract\":\n      return concatHex([\"0x01\", sig]);\n    default:\n      return assertNever(type, \"Unexpected session key type\");\n  }\n};\n\nexport const isGlobalValidation = (\n  data: Pick<Static<typeof PermissionsData>, \"permissions\">,\n): boolean => {\n  return data.permissions.some((p) => p.type === PermissionType.ROOT);\n};\n"]}
+{"version":3,"file":"mav2.js","sourceRoot":"","sources":["../../../../src/capabilities/permissions/mav2.ts"],"names":[],"mappings":"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","sourcesContent":["import { PermissionType } from \"@account-kit/smart-contracts/experimental\";\nimport type { Static } from \"@sinclair/typebox\";\nimport { concatHex, sliceHex, type Hex } from \"viem\";\nimport type { PermissionsData } from \"./index.ts\";\nimport type { KeySigner } from \"../../schemas.ts\";\nimport { assertNever } from \"../../utils.js\";\n\nexport const SESSION_ID_LENGTH_BYTES = 16;\nexport const ENTITY_ID_LENGTH_BYTES = 4;\n\nexport const PermissionsContextVersion = {\n  REMOTE_MODE_DEFERRED_ACTION: \"0x00\",\n  LOCAL_MODE_DEFERRED_ACTION: \"0x01\",\n  NON_DEFERRED_ACTION: \"0x02\",\n} as const;\n\ntype ContextVersionHex =\n  (typeof PermissionsContextVersion)[keyof typeof PermissionsContextVersion];\n\ntype DecodedPermissionsContext = {\n  contextVersion: keyof typeof PermissionsContextVersion;\n} & (\n  | {\n      contextVersion: \"REMOTE_MODE_DEFERRED_ACTION\";\n      sessionId: Hex;\n      signature: Hex;\n      deferredAction?: never;\n    }\n  | {\n      contextVersion: \"LOCAL_MODE_DEFERRED_ACTION\";\n      deferredAction: Hex;\n      sessionId?: never;\n      signature?: never;\n    }\n  | {\n      contextVersion: \"NON_DEFERRED_ACTION\";\n      deferredAction?: never;\n      sessionId?: never;\n      signature?: never;\n      entityId: Hex;\n      isGlobalValidation: boolean;\n    }\n);\n\nexport const encodePermissionsContext = (\n  context: DecodedPermissionsContext,\n): Hex => {\n  switch (context.contextVersion) {\n    case \"REMOTE_MODE_DEFERRED_ACTION\":\n      return concatHex([\n        PermissionsContextVersion.REMOTE_MODE_DEFERRED_ACTION,\n        context.sessionId,\n        context.signature,\n      ]);\n    case \"LOCAL_MODE_DEFERRED_ACTION\":\n      return concatHex([\n        PermissionsContextVersion.LOCAL_MODE_DEFERRED_ACTION,\n        context.deferredAction,\n      ]);\n    case \"NON_DEFERRED_ACTION\":\n      return concatHex([\n        PermissionsContextVersion.NON_DEFERRED_ACTION,\n        context.isGlobalValidation ? \"0x01\" : \"0x00\",\n        context.entityId,\n      ]);\n    default:\n      return assertNever(context, \"Unexpected context version\");\n  }\n};\n\nexport const decodePermissionsContext = (\n  input: Hex,\n): DecodedPermissionsContext => {\n  const contextVersion = sliceHex(input, 0, 1) as ContextVersionHex;\n  switch (contextVersion) {\n    case \"0x00\": {\n      const sessionId = sliceHex(input, 1, SESSION_ID_LENGTH_BYTES + 1);\n      const signature = sliceHex(input, SESSION_ID_LENGTH_BYTES + 1);\n      return {\n        contextVersion: \"REMOTE_MODE_DEFERRED_ACTION\",\n        sessionId,\n        signature,\n      };\n    }\n    case \"0x01\": {\n      const deferredAction = sliceHex(input, 1);\n      return {\n        contextVersion: \"LOCAL_MODE_DEFERRED_ACTION\",\n        deferredAction,\n      };\n    }\n    case \"0x02\": {\n      const isGlobalValidation = sliceHex(input, 1, 2) === \"0x01\";\n      const entityId = sliceHex(input, 2, ENTITY_ID_LENGTH_BYTES + 2);\n      return {\n        contextVersion: \"NON_DEFERRED_ACTION\",\n        isGlobalValidation,\n        entityId,\n      };\n    }\n    default:\n      return assertNever(\n        contextVersion,\n        `Unexpected context version: ${contextVersion}`,\n      );\n  }\n};\n\nexport const prefixSignatureKeyType = (\n  sig: Hex,\n  type: KeySigner[\"type\"],\n): Hex => {\n  switch (type) {\n    case \"secp256k1\":\n      return concatHex([\"0x00\", sig]);\n    case \"contract\":\n      return concatHex([\"0x01\", sig]);\n    default:\n      return assertNever(type, \"Unexpected session key type\");\n  }\n};\n\nexport const isGlobalValidation = (\n  data: Pick<Static<typeof PermissionsData>, \"permissions\">,\n): boolean => {\n  return data.permissions.some((p) => p.type === PermissionType.ROOT);\n};\n"]}

package/dist/esm/client/actions/createAccount.d.ts

@@ -1,10 +1,35 @@
 import type { SmartAccountSigner } from "@aa-sdk/core";
 import type { Static } from "@sinclair/typebox";
 import type { Address } from "abitype";
-import type { wallet_createAccount } from "../../rpc/request";
-import type { InnerWalletApiClient } from "../../types";
+import type { wallet_createAccount } from "../../rpc/request.ts";
+import type { InnerWalletApiClient } from "../../types.ts";
 export type CreateAccountParams = Omit<Extract<Static<typeof wallet_createAccount>["Request"]["params"][0], {
     signerAddress: Address;
 }>, "signerAddress">;
 export type CreateAccountResult = Static<typeof wallet_createAccount>["ReturnType"];
+/**
+ * Creates a new account for the provided signer using the wallet API client.
+ * This method is primarily used to import existing accounts.
+ * For most cases, you should use requestAccount instead.
+ * If the account already exists, an error will be thrown.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {SmartAccountSigner} signer - The signer that will be associated with the account
+ * @param {CreateAccountParams} params - Parameters for creating the account
+ * @param {string} [params.id] - Optional UUID v4 identifier for the account
+ * @param {object} params.creationOptions - Options for account creation
+ * @param {string} [params.creationOptions.accountType] - Currently only "sma-b" (Modular Account v2) is supported
+ * @param {string} [params.creationOptions.salt] - Optional hex string to use as salt for account creation
+ * @returns {Promise<CreateAccountResult>} A Promise that resolves to the created account information
+ *
+ * @example
+ * // Create a new account with a custom salt
+ * const account = await client.createAccount({
+ *   creationOptions: {
+ *     accountType: "sma-b",
+ *     salt: "0x04"
+ *   }
+ * });
+ * console.log(`Created account at address: ${account.accountAddress}`);
+ */
 export declare function createAccount(client: InnerWalletApiClient, signer: SmartAccountSigner, params: CreateAccountParams): Promise<CreateAccountResult>;

package/dist/esm/client/actions/createAccount.js

@@ -1,3 +1,28 @@
+/**
+ * Creates a new account for the provided signer using the wallet API client.
+ * This method is primarily used to import existing accounts.
+ * For most cases, you should use requestAccount instead.
+ * If the account already exists, an error will be thrown.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {SmartAccountSigner} signer - The signer that will be associated with the account
+ * @param {CreateAccountParams} params - Parameters for creating the account
+ * @param {string} [params.id] - Optional UUID v4 identifier for the account
+ * @param {object} params.creationOptions - Options for account creation
+ * @param {string} [params.creationOptions.accountType] - Currently only "sma-b" (Modular Account v2) is supported
+ * @param {string} [params.creationOptions.salt] - Optional hex string to use as salt for account creation
+ * @returns {Promise<CreateAccountResult>} A Promise that resolves to the created account information
+ *
+ * @example
+ * // Create a new account with a custom salt
+ * const account = await client.createAccount({
+ *   creationOptions: {
+ *     accountType: "sma-b",
+ *     salt: "0x04"
+ *   }
+ * });
+ * console.log(`Created account at address: ${account.accountAddress}`);
+ */
 export async function createAccount(client, signer, params) {
     return client.request({
         method: "wallet_createAccount",

package/dist/esm/client/actions/createAccount.js.map

@@ -1 +1 @@
-{"version":3,"file":"createAccount.js","sourceRoot":"","sources":["../../../../src/client/actions/createAccount.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAA4B,EAC5B,MAA0B,EAC1B,MAA2B;IAE3B,OAAO,MAAM,CAAC,OAAO,CAAC;QACpB,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC,UAAU,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;KAClE,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { SmartAccountSigner } from \"@aa-sdk/core\";\nimport type { Static } from \"@sinclair/typebox\";\nimport type { Address } from \"abitype\";\nimport type { wallet_createAccount } from \"../../rpc/request\";\nimport type { InnerWalletApiClient } from \"../../types\";\n\nexport type CreateAccountParams = Omit<\n  Extract<\n    Static<typeof wallet_createAccount>[\"Request\"][\"params\"][0],\n    { signerAddress: Address }\n  >,\n  \"signerAddress\"\n>;\n\nexport type CreateAccountResult = Static<\n  typeof wallet_createAccount\n>[\"ReturnType\"];\n\nexport async function createAccount(\n  client: InnerWalletApiClient,\n  signer: SmartAccountSigner,\n  params: CreateAccountParams,\n): Promise<CreateAccountResult> {\n  return client.request({\n    method: \"wallet_createAccount\",\n    params: [{ signerAddress: await signer.getAddress(), ...params }],\n  });\n}\n"]}
+{"version":3,"file":"createAccount.js","sourceRoot":"","sources":["../../../../src/client/actions/createAccount.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAA4B,EAC5B,MAA0B,EAC1B,MAA2B;IAE3B,OAAO,MAAM,CAAC,OAAO,CAAC;QACpB,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC,UAAU,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;KAClE,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { SmartAccountSigner } from \"@aa-sdk/core\";\nimport type { Static } from \"@sinclair/typebox\";\nimport type { Address } from \"abitype\";\nimport type { wallet_createAccount } from \"../../rpc/request.ts\";\nimport type { InnerWalletApiClient } from \"../../types.ts\";\n\nexport type CreateAccountParams = Omit<\n  Extract<\n    Static<typeof wallet_createAccount>[\"Request\"][\"params\"][0],\n    { signerAddress: Address }\n  >,\n  \"signerAddress\"\n>;\n\nexport type CreateAccountResult = Static<\n  typeof wallet_createAccount\n>[\"ReturnType\"];\n\n/**\n * Creates a new account for the provided signer using the wallet API client.\n * This method is primarily used to import existing accounts.\n * For most cases, you should use requestAccount instead.\n * If the account already exists, an error will be thrown.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {SmartAccountSigner} signer - The signer that will be associated with the account\n * @param {CreateAccountParams} params - Parameters for creating the account\n * @param {string} [params.id] - Optional UUID v4 identifier for the account\n * @param {object} params.creationOptions - Options for account creation\n * @param {string} [params.creationOptions.accountType] - Currently only \"sma-b\" (Modular Account v2) is supported\n * @param {string} [params.creationOptions.salt] - Optional hex string to use as salt for account creation\n * @returns {Promise<CreateAccountResult>} A Promise that resolves to the created account information\n *\n * @example\n * // Create a new account with a custom salt\n * const account = await client.createAccount({\n *   creationOptions: {\n *     accountType: \"sma-b\",\n *     salt: \"0x04\"\n *   }\n * });\n * console.log(`Created account at address: ${account.accountAddress}`);\n */\nexport async function createAccount(\n  client: InnerWalletApiClient,\n  signer: SmartAccountSigner,\n  params: CreateAccountParams,\n): Promise<CreateAccountResult> {\n  return client.request({\n    method: \"wallet_createAccount\",\n    params: [{ signerAddress: await signer.getAddress(), ...params }],\n  });\n}\n"]}

package/dist/esm/client/actions/getCallsStatus.d.ts

@@ -1,6 +1,25 @@
 import type { Address, JsonRpcAccount } from "viem";
-import type { GetCallsStatusParams as IsomorphicGetCallsStatusParams, GetCallsStatusResponse as IsomorphicGetCallsStatusResult } from "../../isomorphic/actions/getCallsStatus";
-import type { InnerWalletApiClient } from "../../types";
+import type { GetCallsStatusParams as IsomorphicGetCallsStatusParams, GetCallsStatusResponse as IsomorphicGetCallsStatusResult } from "../../isomorphic/actions/getCallsStatus.ts";
+import type { InnerWalletApiClient } from "../../types.ts";
 export type GetCallsStatusParams = IsomorphicGetCallsStatusParams;
 export type GetCallsStatusResult = IsomorphicGetCallsStatusResult;
+/**
+ * Gets the status of a prepared call by its ID.
+ * This method is used to check the execution status of calls sent via sendPreparedCalls.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {GetCallsStatusParams} params - The ID of the prepared call to check
+ * @returns {Promise<GetCallsStatusResult>} A Promise that resolves to the status information including:
+ *   - id: The hex ID of the call
+ *   - chainId: The chain ID in hex format
+ *   - status: The current status of the batch execution
+ *   - receipts: Optional array of transaction receipts if the batch has been executed
+ *
+ * @example
+ * // After sending prepared calls
+ * const sendResult = await client.sendPreparedCalls({...});
+ *
+ * // Check the status of the first call ID
+ * const status = await client.getCallsStatus(sendResult.preparedCallIds[0]);
+ */
 export declare function getCallsStatus<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined>(client: InnerWalletApiClient<TAccount>, params: GetCallsStatusParams): Promise<GetCallsStatusResult>;

package/dist/esm/client/actions/getCallsStatus.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCallsStatus.js","sourceRoot":"","sources":["../../../../src/client/actions/getCallsStatus.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA4B,EAC5B,MAA4B;IAE5B,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;QAC1B,MAAM,EAAE,uBAAuB;QAC/B,MAAM,EAAE,CAAC,MAAM,CAAC;KACjB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Address, JsonRpcAccount } from \"viem\";\nimport type {\n  GetCallsStatusParams as IsomorphicGetCallsStatusParams,\n  GetCallsStatusResponse as IsomorphicGetCallsStatusResult,\n} from \"../../isomorphic/actions/getCallsStatus\";\nimport type { InnerWalletApiClient } from \"../../types\";\n\nexport type GetCallsStatusParams = IsomorphicGetCallsStatusParams;\n\nexport type GetCallsStatusResult = IsomorphicGetCallsStatusResult;\n\nexport async function getCallsStatus<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n>(\n  client: InnerWalletApiClient<TAccount>,\n  params: GetCallsStatusParams,\n): Promise<GetCallsStatusResult>;\n\nexport async function getCallsStatus(\n  client: InnerWalletApiClient,\n  params: GetCallsStatusParams,\n): Promise<GetCallsStatusResult> {\n  return await client.request({\n    method: \"wallet_getCallsStatus\",\n    params: [params],\n  });\n}\n"]}
+{"version":3,"file":"getCallsStatus.js","sourceRoot":"","sources":["../../../../src/client/actions/getCallsStatus.ts"],"names":[],"mappings":"AAuCA,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA4B,EAC5B,MAA4B;IAE5B,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;QAC1B,MAAM,EAAE,uBAAuB;QAC/B,MAAM,EAAE,CAAC,MAAM,CAAC;KACjB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Address, JsonRpcAccount } from \"viem\";\nimport type {\n  GetCallsStatusParams as IsomorphicGetCallsStatusParams,\n  GetCallsStatusResponse as IsomorphicGetCallsStatusResult,\n} from \"../../isomorphic/actions/getCallsStatus.ts\";\nimport type { InnerWalletApiClient } from \"../../types.ts\";\n\nexport type GetCallsStatusParams = IsomorphicGetCallsStatusParams;\n\nexport type GetCallsStatusResult = IsomorphicGetCallsStatusResult;\n\n/**\n * Gets the status of a prepared call by its ID.\n * This method is used to check the execution status of calls sent via sendPreparedCalls.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {GetCallsStatusParams} params - The ID of the prepared call to check\n * @returns {Promise<GetCallsStatusResult>} A Promise that resolves to the status information including:\n *   - id: The hex ID of the call\n *   - chainId: The chain ID in hex format\n *   - status: The current status of the batch execution\n *   - receipts: Optional array of transaction receipts if the batch has been executed\n *\n * @example\n * // After sending prepared calls\n * const sendResult = await client.sendPreparedCalls({...});\n *\n * // Check the status of the first call ID\n * const status = await client.getCallsStatus(sendResult.preparedCallIds[0]);\n */\nexport async function getCallsStatus<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n>(\n  client: InnerWalletApiClient<TAccount>,\n  params: GetCallsStatusParams,\n): Promise<GetCallsStatusResult>;\n\nexport async function getCallsStatus(\n  client: InnerWalletApiClient,\n  params: GetCallsStatusParams,\n): Promise<GetCallsStatusResult> {\n  return await client.request({\n    method: \"wallet_getCallsStatus\",\n    params: [params],\n  });\n}\n"]}

package/dist/esm/client/actions/grantPermissions.d.ts

@@ -1,7 +1,7 @@
 import { type Address, type Hex, type IsUndefined, type JsonRpcAccount } from "viem";
-import type { InnerWalletApiClient } from "../../types";
+import type { InnerWalletApiClient } from "../../types.ts";
 import type { SmartAccountSigner } from "@aa-sdk/core";
-import type { CreateSessionParams } from "../../isomorphic/actions/createSession";
+import type { CreateSessionParams } from "../../isomorphic/actions/createSession.ts";
 export type GrantPermissionsParams<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined> = Omit<CreateSessionParams, "account" | "chainId"> & (IsUndefined<TAccount> extends true ? {
     account: Address;
 } : {
@@ -10,4 +10,62 @@ export type GrantPermissionsParams<TAccount extends JsonRpcAccount<Address> | un
 export type GrantPermissionsResult = {
     context: Hex;
 };
+/**
+ * Grants permissions to a smart account by creating a session.
+ * This allows another key to perform operations on behalf of the account.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {SmartAccountSigner} signer - The signer of the smart account
+ * @param {GrantPermissionsParams} params - The parameters for granting permissions
+ * @param {Address} [params.account] - The account address (required if client was not initialized with an account)
+ * @param {number} params.expiry - Unix timestamp when the permissions expire
+ * @param {object} params.key - The session key information
+ * @param {string} params.key.publicKey - The public key of the session key
+ * @param {string} params.key.type - The type of the key (e.g., "secp256k1")
+ * @param {Array} params.permissions - Array of permission objects defining what the session key can do
+ * @returns {Promise<GrantPermissionsResult>} A Promise that resolves to the result containing a context identifier
+ * @returns {Hex} result.context - A hex identifier for the granted permissions context
+ *
+ * @example
+ * // Create a session key and grant root permissions
+ * const sessionKey = LocalAccountSigner.generatePrivateKeySigner();
+ * const account = await client.requestAccount();
+ *
+ * const permissions = await client.grantPermissions({
+ *   account: account.address,
+ *   expiry: Math.floor(Date.now() / 1000) + 60 * 60, // 1 hour from now
+ *   key: {
+ *     publicKey: await sessionKey.getAddress(),
+ *     type: "secp256k1",
+ *   },
+ *   permissions: [{ type: "root" }],
+ * });
+ *
+ * // Use the permissions to prepare a call
+ * const preparedUO = await client.prepareCalls({
+ *   calls: [{ to: zeroAddress, value: "0x0" }],
+ *   from: account.address,
+ *   capabilities: {
+ *     paymasterService: {
+ *       policyId: "your-paymaster-policy-id",
+ *     },
+ *     permissions,
+ *   },
+ * });
+ *
+ * // Sign with the session key
+ * const signature = await signSignatureRequest(
+ *   sessionKey,
+ *   preparedUO.signatureRequest,
+ * );
+ *
+ * // Send the prepared call using the session key
+ * const result = await client.sendPreparedCalls({
+ *   ...preparedUO,
+ *   signature,
+ *   capabilities: {
+ *     permissions,
+ *   },
+ * });
+ */
 export declare function grantPermissions<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined>(client: InnerWalletApiClient<TAccount>, signer: SmartAccountSigner, params: GrantPermissionsParams<TAccount>): Promise<GrantPermissionsResult>;

package/dist/esm/client/actions/grantPermissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"grantPermissions.js","sourceRoot":"","sources":["../../../../src/client/actions/grantPermissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,GACN,MAAM,MAAM,CAAC;AA4Bd,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA4B,EAC5B,MAA0B,EAC1B,MAA8B;IAE9B,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAC1C,CAAC;IAED,OAAO,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE;QACrC,GAAG,MAAM;QACT,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;KAChC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n  type Address,\n  type Hex,\n  type IsUndefined,\n  type JsonRpcAccount,\n  toHex,\n} from \"viem\";\nimport type { InnerWalletApiClient } from \"../../types\";\nimport type { SmartAccountSigner } from \"@aa-sdk/core\";\nimport type { CreateSessionParams } from \"../../isomorphic/actions/createSession\";\n\nexport type GrantPermissionsParams<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n> = Omit<CreateSessionParams, \"account\" | \"chainId\"> &\n  (IsUndefined<TAccount> extends true\n    ? { account: Address }\n    : { account?: never });\n\nexport type GrantPermissionsResult = {\n  context: Hex;\n};\n\nexport async function grantPermissions<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n>(\n  client: InnerWalletApiClient<TAccount>,\n  signer: SmartAccountSigner,\n  params: GrantPermissionsParams<TAccount>,\n): Promise<GrantPermissionsResult>;\n\nexport async function grantPermissions(\n  client: InnerWalletApiClient,\n  signer: SmartAccountSigner,\n  params: GrantPermissionsParams,\n): Promise<GrantPermissionsResult> {\n  if (client.account && !params.account) {\n    params.account = client.account.address;\n  }\n\n  return client.grantPermissions(signer, {\n    ...params,\n    chainId: toHex(client.chain.id),\n  });\n}\n"]}
+{"version":3,"file":"grantPermissions.js","sourceRoot":"","sources":["../../../../src/client/actions/grantPermissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,GACN,MAAM,MAAM,CAAC;AAsFd,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA4B,EAC5B,MAA0B,EAC1B,MAA8B;IAE9B,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAC1C,CAAC;IAED,OAAO,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE;QACrC,GAAG,MAAM;QACT,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;KAChC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n  type Address,\n  type Hex,\n  type IsUndefined,\n  type JsonRpcAccount,\n  toHex,\n} from \"viem\";\nimport type { InnerWalletApiClient } from \"../../types.ts\";\nimport type { SmartAccountSigner } from \"@aa-sdk/core\";\nimport type { CreateSessionParams } from \"../../isomorphic/actions/createSession.ts\";\n\nexport type GrantPermissionsParams<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n> = Omit<CreateSessionParams, \"account\" | \"chainId\"> &\n  (IsUndefined<TAccount> extends true\n    ? { account: Address }\n    : { account?: never });\n\nexport type GrantPermissionsResult = {\n  context: Hex;\n};\n\n/**\n * Grants permissions to a smart account by creating a session.\n * This allows another key to perform operations on behalf of the account.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {SmartAccountSigner} signer - The signer of the smart account\n * @param {GrantPermissionsParams} params - The parameters for granting permissions\n * @param {Address} [params.account] - The account address (required if client was not initialized with an account)\n * @param {number} params.expiry - Unix timestamp when the permissions expire\n * @param {object} params.key - The session key information\n * @param {string} params.key.publicKey - The public key of the session key\n * @param {string} params.key.type - The type of the key (e.g., \"secp256k1\")\n * @param {Array} params.permissions - Array of permission objects defining what the session key can do\n * @returns {Promise<GrantPermissionsResult>} A Promise that resolves to the result containing a context identifier\n * @returns {Hex} result.context - A hex identifier for the granted permissions context\n *\n * @example\n * // Create a session key and grant root permissions\n * const sessionKey = LocalAccountSigner.generatePrivateKeySigner();\n * const account = await client.requestAccount();\n *\n * const permissions = await client.grantPermissions({\n *   account: account.address,\n *   expiry: Math.floor(Date.now() / 1000) + 60 * 60, // 1 hour from now\n *   key: {\n *     publicKey: await sessionKey.getAddress(),\n *     type: \"secp256k1\",\n *   },\n *   permissions: [{ type: \"root\" }],\n * });\n *\n * // Use the permissions to prepare a call\n * const preparedUO = await client.prepareCalls({\n *   calls: [{ to: zeroAddress, value: \"0x0\" }],\n *   from: account.address,\n *   capabilities: {\n *     paymasterService: {\n *       policyId: \"your-paymaster-policy-id\",\n *     },\n *     permissions,\n *   },\n * });\n *\n * // Sign with the session key\n * const signature = await signSignatureRequest(\n *   sessionKey,\n *   preparedUO.signatureRequest,\n * );\n *\n * // Send the prepared call using the session key\n * const result = await client.sendPreparedCalls({\n *   ...preparedUO,\n *   signature,\n *   capabilities: {\n *     permissions,\n *   },\n * });\n */\nexport async function grantPermissions<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n>(\n  client: InnerWalletApiClient<TAccount>,\n  signer: SmartAccountSigner,\n  params: GrantPermissionsParams<TAccount>,\n): Promise<GrantPermissionsResult>;\n\nexport async function grantPermissions(\n  client: InnerWalletApiClient,\n  signer: SmartAccountSigner,\n  params: GrantPermissionsParams,\n): Promise<GrantPermissionsResult> {\n  if (client.account && !params.account) {\n    params.account = client.account.address;\n  }\n\n  return client.grantPermissions(signer, {\n    ...params,\n    chainId: toHex(client.chain.id),\n  });\n}\n"]}

package/dist/esm/client/actions/listAccounts.d.ts

@@ -1,6 +1,30 @@
 import type { Static } from "@sinclair/typebox";
-import type { wallet_listAccounts } from "../../rpc/request";
-import type { InnerWalletApiClient } from "../../types";
+import type { wallet_listAccounts } from "../../rpc/request.ts";
+import type { InnerWalletApiClient } from "../../types.ts";
 export type ListAccountsParams = Static<typeof wallet_listAccounts>["Request"]["params"][0];
 export type ListAccountsResult = Static<typeof wallet_listAccounts>["ReturnType"];
+/**
+ * Lists all smart accounts for a given signer using the wallet API client.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {ListAccountsParams} params - Parameters for listing accounts
+ * @param {string} params.signerAddress - The address of the signer to list accounts for
+ * @param {number} [params.limit] - Optional maximum number of accounts to return (default: 100, max: 100)
+ * @param {string} [params.after] - Optional pagination cursor for fetching subsequent pages
+ * @returns {Promise<ListAccountsResult>} A Promise that resolves to the list of accounts and pagination metadata
+ *
+ * @example
+ * // Fetch the first page of accounts
+ * const firstPage = await client.listAccounts({
+ *   signerAddress: "0x123...",
+ *   limit: 10
+ * });
+ *
+ * // If an 'after' cursor exists, use it to fetch the next page
+ * const nextPage = await client.listAccounts({
+ *   signerAddress: "0x123...",
+ *   limit: 10,
+ *   after: firstPage.meta.after
+ * });
+ */
 export declare function listAccounts(client: InnerWalletApiClient, params: ListAccountsParams): Promise<ListAccountsResult>;

package/dist/esm/client/actions/listAccounts.js

@@ -1,3 +1,27 @@
+/**
+ * Lists all smart accounts for a given signer using the wallet API client.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {ListAccountsParams} params - Parameters for listing accounts
+ * @param {string} params.signerAddress - The address of the signer to list accounts for
+ * @param {number} [params.limit] - Optional maximum number of accounts to return (default: 100, max: 100)
+ * @param {string} [params.after] - Optional pagination cursor for fetching subsequent pages
+ * @returns {Promise<ListAccountsResult>} A Promise that resolves to the list of accounts and pagination metadata
+ *
+ * @example
+ * // Fetch the first page of accounts
+ * const firstPage = await client.listAccounts({
+ *   signerAddress: "0x123...",
+ *   limit: 10
+ * });
+ *
+ * // If an 'after' cursor exists, use it to fetch the next page
+ * const nextPage = await client.listAccounts({
+ *   signerAddress: "0x123...",
+ *   limit: 10,
+ *   after: firstPage.meta.after
+ * });
+ */
 export async function listAccounts(client, params) {
     return client.request({ method: "wallet_listAccounts", params: [params] });
 }

package/dist/esm/client/actions/listAccounts.js.map

@@ -1 +1 @@
-{"version":3,"file":"listAccounts.js","sourceRoot":"","sources":["../../../../src/client/actions/listAccounts.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA4B,EAC5B,MAA0B;IAE1B,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC7E,CAAC","sourcesContent":["import type { Static } from \"@sinclair/typebox\";\nimport type { wallet_listAccounts } from \"../../rpc/request\";\nimport type { InnerWalletApiClient } from \"../../types\";\n\nexport type ListAccountsParams = Static<\n  typeof wallet_listAccounts\n>[\"Request\"][\"params\"][0];\n\nexport type ListAccountsResult = Static<\n  typeof wallet_listAccounts\n>[\"ReturnType\"];\n\nexport async function listAccounts(\n  client: InnerWalletApiClient,\n  params: ListAccountsParams,\n): Promise<ListAccountsResult> {\n  return client.request({ method: \"wallet_listAccounts\", params: [params] });\n}\n"]}
+{"version":3,"file":"listAccounts.js","sourceRoot":"","sources":["../../../../src/client/actions/listAccounts.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA4B,EAC5B,MAA0B;IAE1B,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC7E,CAAC","sourcesContent":["import type { Static } from \"@sinclair/typebox\";\nimport type { wallet_listAccounts } from \"../../rpc/request.ts\";\nimport type { InnerWalletApiClient } from \"../../types.ts\";\n\nexport type ListAccountsParams = Static<\n  typeof wallet_listAccounts\n>[\"Request\"][\"params\"][0];\n\nexport type ListAccountsResult = Static<\n  typeof wallet_listAccounts\n>[\"ReturnType\"];\n\n/**\n * Lists all smart accounts for a given signer using the wallet API client.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {ListAccountsParams} params - Parameters for listing accounts\n * @param {string} params.signerAddress - The address of the signer to list accounts for\n * @param {number} [params.limit] - Optional maximum number of accounts to return (default: 100, max: 100)\n * @param {string} [params.after] - Optional pagination cursor for fetching subsequent pages\n * @returns {Promise<ListAccountsResult>} A Promise that resolves to the list of accounts and pagination metadata\n *\n * @example\n * // Fetch the first page of accounts\n * const firstPage = await client.listAccounts({\n *   signerAddress: \"0x123...\",\n *   limit: 10\n * });\n *\n * // If an 'after' cursor exists, use it to fetch the next page\n * const nextPage = await client.listAccounts({\n *   signerAddress: \"0x123...\",\n *   limit: 10,\n *   after: firstPage.meta.after\n * });\n */\nexport async function listAccounts(\n  client: InnerWalletApiClient,\n  params: ListAccountsParams,\n): Promise<ListAccountsResult> {\n  return client.request({ method: \"wallet_listAccounts\", params: [params] });\n}\n"]}

package/dist/esm/client/actions/prepareCalls.d.ts

@@ -1,6 +1,6 @@
 import { type Address, type IsUndefined, type JsonRpcAccount } from "viem";
-import type { PrepareCallsParams as IsomorphicPrepareCallsParams, PrepareCallsResult as IsomorphicPrepareCallsResult } from "../../isomorphic/actions/prepareCalls";
-import type { InnerWalletApiClient } from "../../types";
+import type { PrepareCallsParams as IsomorphicPrepareCallsParams, PrepareCallsResult as IsomorphicPrepareCallsResult } from "../../isomorphic/actions/prepareCalls.ts";
+import type { InnerWalletApiClient } from "../../types.ts";
 export type GetAccountParam<TAccount> = IsUndefined<TAccount> extends true ? {
     account: Address;
 } : {
@@ -12,4 +12,30 @@ export type PrepareCallsParams<TAccount extends JsonRpcAccount<Address> | undefi
     from?: never;
 });
 export type PrepareCallsResult = IsomorphicPrepareCallsResult;
+/**
+ * Prepares a set of contract calls for execution by building a user operation.
+ * Returns the built user operation and a signature request that needs to be signed
+ * before submitting to sendPreparedCalls.
+ *
+ * @param {InnerWalletApiClient<TAccount>} client - The wallet API client to use for the request
+ * @param {PrepareCallsParams<TAccount>} params - Parameters for preparing calls
+ * @param {Array<{to: Address, data?: Hex, value?: Hex}>} params.calls - Array of contract calls to execute
+ * @param {Address} [params.from] - The address to execute the calls from (required if the client wasn't initialized with an account)
+ * @param {object} [params.capabilities] - Optional capabilities to include with the request
+ * @returns {Promise<PrepareCallsResult>} A Promise that resolves to the prepared calls result containing
+ * the user operation data and signature request
+ *
+ * @example
+ * // Prepare a sponosored user operation call
+ * const result = await client.prepareCalls({
+ *   calls: [{
+ *     to: "0x1234...",
+ *     data: "0xabcdef...",
+ *     value: "0x0"
+ *   }],
+ *   capabilities: {
+ *     paymasterService: { policyId: "your-policy-id" }
+ *   }
+ * });
+ */
 export declare function prepareCalls<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined>(client: InnerWalletApiClient<TAccount>, params: PrepareCallsParams<TAccount>): Promise<PrepareCallsResult>;

package/dist/esm/client/actions/prepareCalls.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepareCalls.js","sourceRoot":"","sources":["../../../../src/client/actions/prepareCalls.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,GAIN,MAAM,MAAM,CAAC;AA8Bd,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA4B,EAC5B,MAA0B;IAE1B,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,gBAAgB,EAAE,CAAC;QAC9D,MAAM,CAAC,YAAY,GAAG;YACpB,GAAG,MAAM,CAAC,YAAY;YACtB,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;SAChD,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IACvC,CAAC;IAED,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;QAC1B,MAAM,EAAE,qBAAqB;QAC7B,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n  toHex,\n  type Address,\n  type IsUndefined,\n  type JsonRpcAccount,\n} from \"viem\";\nimport type {\n  PrepareCallsParams as IsomorphicPrepareCallsParams,\n  PrepareCallsResult as IsomorphicPrepareCallsResult,\n} from \"../../isomorphic/actions/prepareCalls\";\nimport type { InnerWalletApiClient } from \"../../types\";\n\nexport type GetAccountParam<TAccount> =\n  IsUndefined<TAccount> extends true\n    ? { account: Address }\n    : { account?: never };\n\nexport type PrepareCallsParams<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n> = Omit<IsomorphicPrepareCallsParams, \"from\" | \"chainId\"> &\n  (IsUndefined<TAccount> extends true ? { from: Address } : { from?: never });\n\nexport type PrepareCallsResult = IsomorphicPrepareCallsResult;\n\nexport async function prepareCalls<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n>(\n  client: InnerWalletApiClient<TAccount>,\n  params: PrepareCallsParams<TAccount>,\n): Promise<PrepareCallsResult>;\n\nexport async function prepareCalls(\n  client: InnerWalletApiClient,\n  params: PrepareCallsParams,\n): Promise<PrepareCallsResult> {\n  if (client.policyId && !params.capabilities?.paymasterService) {\n    params.capabilities = {\n      ...params.capabilities,\n      paymasterService: { policyId: client.policyId },\n    };\n  }\n\n  if (client.account && !params.from) {\n    params.from = client.account.address;\n  }\n\n  return await client.request({\n    method: \"wallet_prepareCalls\",\n    params: [{ ...params, chainId: toHex(client.chain.id) }],\n  });\n}\n"]}
+{"version":3,"file":"prepareCalls.js","sourceRoot":"","sources":["../../../../src/client/actions/prepareCalls.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,GAIN,MAAM,MAAM,CAAC;AAwDd,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA4B,EAC5B,MAA0B;IAE1B,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,gBAAgB,EAAE,CAAC;QAC9D,MAAM,CAAC,YAAY,GAAG;YACpB,GAAG,MAAM,CAAC,YAAY;YACtB,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;SAChD,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IACvC,CAAC;IAED,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;QAC1B,MAAM,EAAE,qBAAqB;QAC7B,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n  toHex,\n  type Address,\n  type IsUndefined,\n  type JsonRpcAccount,\n} from \"viem\";\nimport type {\n  PrepareCallsParams as IsomorphicPrepareCallsParams,\n  PrepareCallsResult as IsomorphicPrepareCallsResult,\n} from \"../../isomorphic/actions/prepareCalls.ts\";\nimport type { InnerWalletApiClient } from \"../../types.ts\";\n\nexport type GetAccountParam<TAccount> =\n  IsUndefined<TAccount> extends true\n    ? { account: Address }\n    : { account?: never };\n\nexport type PrepareCallsParams<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n> = Omit<IsomorphicPrepareCallsParams, \"from\" | \"chainId\"> &\n  (IsUndefined<TAccount> extends true ? { from: Address } : { from?: never });\n\nexport type PrepareCallsResult = IsomorphicPrepareCallsResult;\n\n/**\n * Prepares a set of contract calls for execution by building a user operation.\n * Returns the built user operation and a signature request that needs to be signed\n * before submitting to sendPreparedCalls.\n *\n * @param {InnerWalletApiClient<TAccount>} client - The wallet API client to use for the request\n * @param {PrepareCallsParams<TAccount>} params - Parameters for preparing calls\n * @param {Array<{to: Address, data?: Hex, value?: Hex}>} params.calls - Array of contract calls to execute\n * @param {Address} [params.from] - The address to execute the calls from (required if the client wasn't initialized with an account)\n * @param {object} [params.capabilities] - Optional capabilities to include with the request\n * @returns {Promise<PrepareCallsResult>} A Promise that resolves to the prepared calls result containing\n * the user operation data and signature request\n *\n * @example\n * // Prepare a sponosored user operation call\n * const result = await client.prepareCalls({\n *   calls: [{\n *     to: \"0x1234...\",\n *     data: \"0xabcdef...\",\n *     value: \"0x0\"\n *   }],\n *   capabilities: {\n *     paymasterService: { policyId: \"your-policy-id\" }\n *   }\n * });\n */\nexport async function prepareCalls<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n>(\n  client: InnerWalletApiClient<TAccount>,\n  params: PrepareCallsParams<TAccount>,\n): Promise<PrepareCallsResult>;\n\nexport async function prepareCalls(\n  client: InnerWalletApiClient,\n  params: PrepareCallsParams,\n): Promise<PrepareCallsResult> {\n  if (client.policyId && !params.capabilities?.paymasterService) {\n    params.capabilities = {\n      ...params.capabilities,\n      paymasterService: { policyId: client.policyId },\n    };\n  }\n\n  if (client.account && !params.from) {\n    params.from = client.account.address;\n  }\n\n  return await client.request({\n    method: \"wallet_prepareCalls\",\n    params: [{ ...params, chainId: toHex(client.chain.id) }],\n  });\n}\n"]}

package/dist/esm/client/actions/requestAccount.d.ts

@@ -1,4 +1,4 @@
-import type { SmartAccountSigner, SmartContractAccount } from "@aa-sdk/core";
+import { type SmartAccountSigner, type SmartContractAccount } from "@aa-sdk/core";
 import type { Static } from "@sinclair/typebox";
 import type { Address } from "abitype";
 import { type IsUndefined, type JsonRpcAccount } from "viem";
@@ -6,6 +6,25 @@ import type { wallet_requestAccount } from "../../rpc/request.js";
 import type { InnerWalletApiClient } from "../../types.js";
 export type RequestAccountParams<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined> = IsUndefined<TAccount> extends true ? Omit<Extract<Static<typeof wallet_requestAccount>["Request"]["params"][0], {
     signerAddress: Address;
-}>, "signerAddress" | "includeCounterfactualInfo"> : never;
+}>, "signerAddress" | "includeCounterfactualInfo"> & {
+    accountAddress?: Address;
+} : never;
 export type RequestAccountResult = SmartContractAccount;
+/**
+ * Requests an account for the provided signer using the wallet API client.
+ * If an account already exists for the signer, it will always return that account unless a new ID is specified.
+ * If an account already exists, the creationHint will be ignored.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {SmartAccountSigner} signer - The signer that will be associated with the account
+ * @param {RequestAccountParams} [params] - Optional parameters for requesting a specific account
+ * @param {string} [params.id] - Optional identifier for the account. If specified, a new account with this ID will be created even if one already exists for the signer
+ * @param {object} [params.creationHint] - Optional hints to guide account creation. These are ignored if an account already exists
+ * @returns {Promise<RequestAccountResult>} A Promise that resolves to a SmartContractAccount instance
+ *
+ * @example
+ * // Request an account with default parameters using a local signer
+ * const signer = LocalAccountSigner.privateKeyToAccountSigner("0x...");
+ * const account = await client.requestAccount(signer);
+ */
 export declare function requestAccount<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined>(client: InnerWalletApiClient<TAccount>, signer: SmartAccountSigner, params?: RequestAccountParams<TAccount>): Promise<RequestAccountResult>;

package/dist/esm/client/actions/requestAccount.js

@@ -1,11 +1,13 @@
+import {} from "@aa-sdk/core";
 import { Value } from "@sinclair/typebox/value";
+import deepEqual from "deep-equal";
 import { custom } from "viem";
 import { createAccount } from "../../isomorphic/utils/createAccount.js";
 import { TypeSerializedInitcode } from "../../schemas.js";
 export async function requestAccount(client, signer, params) {
-    const args = client.account && !params
+    const args = (client.account && !params) || params?.accountAddress
         ? {
-            accountAddress: client.account.address,
+            accountAddress: params?.accountAddress ?? client.account.address,
             includeCounterfactualInfo: true,
         }
         : {
@@ -13,16 +15,25 @@ export async function requestAccount(client, signer, params) {
             signerAddress: await signer.getAddress(),
             includeCounterfactualInfo: true,
         };
+    const cachedAccount = client.internal.getAccount();
+    if (cachedAccount &&
+        ((args.accountAddress &&
+            cachedAccount.account.address === args.accountAddress) ||
+            deepEqual(cachedAccount.requestParams, args, { strict: true }))) {
+        return cachedAccount.account;
+    }
     const { counterfactualInfo, accountAddress } = await client.request({
         method: "wallet_requestAccount",
         params: [args],
     });
-    return createAccount({
+    const account = await createAccount({
         accountAddress: accountAddress,
         counterfactualInfo: Value.Parse(TypeSerializedInitcode, counterfactualInfo),
         chain: client.chain,
         transport: custom(client.transport),
         signer,
     });
+    client.internal.setAccount({ account, requestParams: args });
+    return account;
 }
 //# sourceMappingURL=requestAccount.js.map

package/dist/esm/client/actions/requestAccount.js.map

@@ -1 +1 @@
-{"version":3,"file":"requestAccount.js","sourceRoot":"","sources":["../../../../src/client/actions/requestAccount.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAyC,MAAM,MAAM,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AA+B1D,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA4B,EAC5B,MAA0B,EAC1B,MAA6B;IAE7B,MAAM,IAAI,GACR,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM;QACvB,CAAC,CAAC;YACE,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;YACtC,yBAAyB,EAAE,IAAI;SAChC;QACH,CAAC,CAAC;YACE,GAAG,MAAM;YACT,aAAa,EAAE,MAAM,MAAM,CAAC,UAAU,EAAE;YACxC,yBAAyB,EAAE,IAAI;SAChC,CAAC;IAER,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAClE,MAAM,EAAE,uBAAuB;QAC/B,MAAM,EAAE,CAAC,IAAI,CAAC;KACf,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC;QACnB,cAAc,EAAE,cAAc;QAC9B,kBAAkB,EAAE,KAAK,CAAC,KAAK,CAC7B,sBAAsB,EACtB,kBAAmB,CACpB;QACD,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACnC,MAAM;KACP,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { SmartAccountSigner, SmartContractAccount } from \"@aa-sdk/core\";\nimport type { Static } from \"@sinclair/typebox\";\nimport { Value } from \"@sinclair/typebox/value\";\nimport type { Address } from \"abitype\";\nimport { custom, type IsUndefined, type JsonRpcAccount } from \"viem\";\nimport { createAccount } from \"../../isomorphic/utils/createAccount.js\";\nimport type { wallet_requestAccount } from \"../../rpc/request.js\";\nimport { TypeSerializedInitcode } from \"../../schemas.js\";\nimport type { InnerWalletApiClient } from \"../../types.js\";\n\nexport type RequestAccountParams<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n> =\n  IsUndefined<TAccount> extends true\n    ? Omit<\n        Extract<\n          Static<typeof wallet_requestAccount>[\"Request\"][\"params\"][0],\n          { signerAddress: Address }\n        >,\n        \"signerAddress\" | \"includeCounterfactualInfo\"\n      >\n    : never;\n\n// TODO: this could be more specific potentially :shrug:\nexport type RequestAccountResult = SmartContractAccount;\n\nexport function requestAccount<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n>(\n  client: InnerWalletApiClient<TAccount>,\n  signer: SmartAccountSigner,\n  params?: RequestAccountParams<TAccount>,\n): Promise<RequestAccountResult>;\n\nexport async function requestAccount(\n  client: InnerWalletApiClient,\n  signer: SmartAccountSigner,\n  params?: RequestAccountParams,\n): Promise<RequestAccountResult> {\n  const args =\n    client.account && !params\n      ? {\n          accountAddress: client.account.address,\n          includeCounterfactualInfo: true,\n        }\n      : {\n          ...params,\n          signerAddress: await signer.getAddress(),\n          includeCounterfactualInfo: true,\n        };\n\n  const { counterfactualInfo, accountAddress } = await client.request({\n    method: \"wallet_requestAccount\",\n    params: [args],\n  });\n\n  return createAccount({\n    accountAddress: accountAddress,\n    counterfactualInfo: Value.Parse(\n      TypeSerializedInitcode,\n      counterfactualInfo!,\n    ),\n    chain: client.chain,\n    transport: custom(client.transport),\n    signer,\n  });\n}\n"]}
+{"version":3,"file":"requestAccount.js","sourceRoot":"","sources":["../../../../src/client/actions/requestAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAEhD,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAyC,MAAM,MAAM,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAgD1D,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA4B,EAC5B,MAA0B,EAC1B,MAA6B;IAE7B,MAAM,IAAI,GACR,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,EAAE,cAAc;QACnD,CAAC,CAAC;YACE,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,MAAM,CAAC,OAAQ,CAAC,OAAO;YACjE,yBAAyB,EAAE,IAAI;SAChC;QACH,CAAC,CAAC;YACE,GAAG,MAAM;YACT,aAAa,EAAE,MAAM,MAAM,CAAC,UAAU,EAAE;YACxC,yBAAyB,EAAE,IAAI;SAChC,CAAC;IAER,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACnD,IACE,aAAa;QACb,CAAC,CAAC,IAAI,CAAC,cAAc;YACnB,aAAa,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,cAAc,CAAC;YACtD,SAAS,CAAC,aAAa,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EACjE,CAAC;QACD,OAAO,aAAa,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAClE,MAAM,EAAE,uBAAuB;QAC/B,MAAM,EAAE,CAAC,IAAI,CAAC;KACf,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC;QAClC,cAAc,EAAE,cAAc;QAC9B,kBAAkB,EAAE,KAAK,CAAC,KAAK,CAC7B,sBAAsB,EACtB,kBAAmB,CACpB;QACD,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACnC,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7D,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import {\n  type SmartAccountSigner,\n  type SmartContractAccount,\n} from \"@aa-sdk/core\";\nimport type { Static } from \"@sinclair/typebox\";\nimport { Value } from \"@sinclair/typebox/value\";\nimport type { Address } from \"abitype\";\nimport deepEqual from \"deep-equal\";\nimport { custom, type IsUndefined, type JsonRpcAccount } from \"viem\";\nimport { createAccount } from \"../../isomorphic/utils/createAccount.js\";\nimport type { wallet_requestAccount } from \"../../rpc/request.js\";\nimport { TypeSerializedInitcode } from \"../../schemas.js\";\nimport type { InnerWalletApiClient } from \"../../types.js\";\n\nexport type RequestAccountParams<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n> =\n  IsUndefined<TAccount> extends true\n    ? Omit<\n        Extract<\n          Static<typeof wallet_requestAccount>[\"Request\"][\"params\"][0],\n          { signerAddress: Address }\n        >,\n        \"signerAddress\" | \"includeCounterfactualInfo\"\n      > & { accountAddress?: Address }\n    : never;\n\n// TODO: this could be more specific potentially :shrug:\nexport type RequestAccountResult = SmartContractAccount;\n\n/**\n * Requests an account for the provided signer using the wallet API client.\n * If an account already exists for the signer, it will always return that account unless a new ID is specified.\n * If an account already exists, the creationHint will be ignored.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {SmartAccountSigner} signer - The signer that will be associated with the account\n * @param {RequestAccountParams} [params] - Optional parameters for requesting a specific account\n * @param {string} [params.id] - Optional identifier for the account. If specified, a new account with this ID will be created even if one already exists for the signer\n * @param {object} [params.creationHint] - Optional hints to guide account creation. These are ignored if an account already exists\n * @returns {Promise<RequestAccountResult>} A Promise that resolves to a SmartContractAccount instance\n *\n * @example\n * // Request an account with default parameters using a local signer\n * const signer = LocalAccountSigner.privateKeyToAccountSigner(\"0x...\");\n * const account = await client.requestAccount(signer);\n */\nexport function requestAccount<\n  TAccount extends JsonRpcAccount<Address> | undefined =\n    | JsonRpcAccount<Address>\n    | undefined,\n>(\n  client: InnerWalletApiClient<TAccount>,\n  signer: SmartAccountSigner,\n  params?: RequestAccountParams<TAccount>,\n): Promise<RequestAccountResult>;\n\nexport async function requestAccount(\n  client: InnerWalletApiClient,\n  signer: SmartAccountSigner,\n  params?: RequestAccountParams,\n): Promise<RequestAccountResult> {\n  const args =\n    (client.account && !params) || params?.accountAddress\n      ? {\n          accountAddress: params?.accountAddress ?? client.account!.address,\n          includeCounterfactualInfo: true,\n        }\n      : {\n          ...params,\n          signerAddress: await signer.getAddress(),\n          includeCounterfactualInfo: true,\n        };\n\n  const cachedAccount = client.internal.getAccount();\n  if (\n    cachedAccount &&\n    ((args.accountAddress &&\n      cachedAccount.account.address === args.accountAddress) ||\n      deepEqual(cachedAccount.requestParams, args, { strict: true }))\n  ) {\n    return cachedAccount.account;\n  }\n\n  const { counterfactualInfo, accountAddress } = await client.request({\n    method: \"wallet_requestAccount\",\n    params: [args],\n  });\n\n  const account = await createAccount({\n    accountAddress: accountAddress,\n    counterfactualInfo: Value.Parse(\n      TypeSerializedInitcode,\n      counterfactualInfo!,\n    ),\n    chain: client.chain,\n    transport: custom(client.transport),\n    signer,\n  });\n\n  client.internal.setAccount({ account, requestParams: args });\n\n  return account;\n}\n"]}

package/dist/esm/client/actions/sendPreparedCalls.d.ts

@@ -1,6 +1,43 @@
 import type { Static, StaticDecode } from "@sinclair/typebox";
-import type { wallet_sendPreparedCalls } from "../../rpc/request";
-import type { InnerWalletApiClient } from "../../types";
+import type { wallet_sendPreparedCalls } from "../../rpc/request.ts";
+import type { InnerWalletApiClient } from "../../types.ts";
 export type SendPreparedCallsParams = Omit<StaticDecode<typeof wallet_sendPreparedCalls>["Request"]["params"][0], "chainId">;
 export type SendPreparedCallsResult = Static<typeof wallet_sendPreparedCalls>["ReturnType"];
+/**
+ * Sends prepared calls by submitting a signed user operation.
+ * This method is used after signing the signature request returned from prepareCalls.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {SendPreparedCallsParams} params - Parameters for sending prepared calls
+ * @param {string} params.type - The user operation type ('user-operation-v060' or 'user-operation-v070')
+ * @param {object} params.data - The user operation data without signature
+ * @param {string} params.chainId - The chain ID in hex format
+ * @param {object} params.signature - The signature object
+ * @param {string} params.signature.type - The signature type (must be 'ecdsa')
+ * @param {string} params.signature.signature - The hex-encoded signature value
+ * @param {object} [params.capabilities] - Optional capabilities to include with the request
+ * @returns {Promise<SendPreparedCallsResult>} A Promise that resolves to the result containing the prepared call IDs
+ *
+ * @example
+ * // First prepare the calls
+ * const preparedCalls = await client.prepareCalls({
+ *   calls: [{
+ *     to: "0x1234...",
+ *     data: "0xabcdef...",
+ *     value: "0x0"
+ *   }],
+ *   capabilities: {
+ *     paymasterService: { policyId: "your-policy-id" }
+ *   }
+ * });
+ *
+ * // Sign the signature request using signSignatureRequest with your signer
+ * const signedRequest = await client.signSignatureRequest(preparedCalls.signatureRequest);
+ *
+ * // Then send the prepared calls with the signature
+ * const result = await client.sendPreparedCalls({
+ *   ...preparedCalls,
+ *   signature: signedRequest.signature,
+ * });
+ */
 export declare function sendPreparedCalls(client: InnerWalletApiClient, params: SendPreparedCallsParams): Promise<SendPreparedCallsResult>;

package/dist/esm/client/actions/sendPreparedCalls.js

@@ -1,4 +1,41 @@
 import { toHex } from "viem";
+/**
+ * Sends prepared calls by submitting a signed user operation.
+ * This method is used after signing the signature request returned from prepareCalls.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {SendPreparedCallsParams} params - Parameters for sending prepared calls
+ * @param {string} params.type - The user operation type ('user-operation-v060' or 'user-operation-v070')
+ * @param {object} params.data - The user operation data without signature
+ * @param {string} params.chainId - The chain ID in hex format
+ * @param {object} params.signature - The signature object
+ * @param {string} params.signature.type - The signature type (must be 'ecdsa')
+ * @param {string} params.signature.signature - The hex-encoded signature value
+ * @param {object} [params.capabilities] - Optional capabilities to include with the request
+ * @returns {Promise<SendPreparedCallsResult>} A Promise that resolves to the result containing the prepared call IDs
+ *
+ * @example
+ * // First prepare the calls
+ * const preparedCalls = await client.prepareCalls({
+ *   calls: [{
+ *     to: "0x1234...",
+ *     data: "0xabcdef...",
+ *     value: "0x0"
+ *   }],
+ *   capabilities: {
+ *     paymasterService: { policyId: "your-policy-id" }
+ *   }
+ * });
+ *
+ * // Sign the signature request using signSignatureRequest with your signer
+ * const signedRequest = await client.signSignatureRequest(preparedCalls.signatureRequest);
+ *
+ * // Then send the prepared calls with the signature
+ * const result = await client.sendPreparedCalls({
+ *   ...preparedCalls,
+ *   signature: signedRequest.signature,
+ * });
+ */
 export async function sendPreparedCalls(client, params) {
     return client.request({
         method: "wallet_sendPreparedCalls",

package/dist/esm/client/actions/sendPreparedCalls.js.map

@@ -1 +1 @@
-{"version":3,"file":"sendPreparedCalls.js","sourceRoot":"","sources":["../../../../src/client/actions/sendPreparedCalls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAa7B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA4B,EAC5B,MAA+B;IAE/B,OAAO,MAAM,CAAC,OAAO,CAAC;QACpB,MAAM,EAAE,0BAA0B;QAClC,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Static, StaticDecode } from \"@sinclair/typebox\";\nimport { toHex } from \"viem\";\nimport type { wallet_sendPreparedCalls } from \"../../rpc/request\";\nimport type { InnerWalletApiClient } from \"../../types\";\n\nexport type SendPreparedCallsParams = Omit<\n  StaticDecode<typeof wallet_sendPreparedCalls>[\"Request\"][\"params\"][0],\n  \"chainId\"\n>;\n\nexport type SendPreparedCallsResult = Static<\n  typeof wallet_sendPreparedCalls\n>[\"ReturnType\"];\n\nexport async function sendPreparedCalls(\n  client: InnerWalletApiClient,\n  params: SendPreparedCallsParams,\n): Promise<SendPreparedCallsResult> {\n  return client.request({\n    method: \"wallet_sendPreparedCalls\",\n    params: [{ ...params, chainId: toHex(client.chain.id) }],\n  });\n}\n"]}
+{"version":3,"file":"sendPreparedCalls.js","sourceRoot":"","sources":["../../../../src/client/actions/sendPreparedCalls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAa7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA4B,EAC5B,MAA+B;IAE/B,OAAO,MAAM,CAAC,OAAO,CAAC;QACpB,MAAM,EAAE,0BAA0B;QAClC,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Static, StaticDecode } from \"@sinclair/typebox\";\nimport { toHex } from \"viem\";\nimport type { wallet_sendPreparedCalls } from \"../../rpc/request.ts\";\nimport type { InnerWalletApiClient } from \"../../types.ts\";\n\nexport type SendPreparedCallsParams = Omit<\n  StaticDecode<typeof wallet_sendPreparedCalls>[\"Request\"][\"params\"][0],\n  \"chainId\"\n>;\n\nexport type SendPreparedCallsResult = Static<\n  typeof wallet_sendPreparedCalls\n>[\"ReturnType\"];\n\n/**\n * Sends prepared calls by submitting a signed user operation.\n * This method is used after signing the signature request returned from prepareCalls.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {SendPreparedCallsParams} params - Parameters for sending prepared calls\n * @param {string} params.type - The user operation type ('user-operation-v060' or 'user-operation-v070')\n * @param {object} params.data - The user operation data without signature\n * @param {string} params.chainId - The chain ID in hex format\n * @param {object} params.signature - The signature object\n * @param {string} params.signature.type - The signature type (must be 'ecdsa')\n * @param {string} params.signature.signature - The hex-encoded signature value\n * @param {object} [params.capabilities] - Optional capabilities to include with the request\n * @returns {Promise<SendPreparedCallsResult>} A Promise that resolves to the result containing the prepared call IDs\n *\n * @example\n * // First prepare the calls\n * const preparedCalls = await client.prepareCalls({\n *   calls: [{\n *     to: \"0x1234...\",\n *     data: \"0xabcdef...\",\n *     value: \"0x0\"\n *   }],\n *   capabilities: {\n *     paymasterService: { policyId: \"your-policy-id\" }\n *   }\n * });\n *\n * // Sign the signature request using signSignatureRequest with your signer\n * const signedRequest = await client.signSignatureRequest(preparedCalls.signatureRequest);\n *\n * // Then send the prepared calls with the signature\n * const result = await client.sendPreparedCalls({\n *   ...preparedCalls,\n *   signature: signedRequest.signature,\n * });\n */\nexport async function sendPreparedCalls(\n  client: InnerWalletApiClient,\n  params: SendPreparedCallsParams,\n): Promise<SendPreparedCallsResult> {\n  return client.request({\n    method: \"wallet_sendPreparedCalls\",\n    params: [{ ...params, chainId: toHex(client.chain.id) }],\n  });\n}\n"]}