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

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 "@alchemy/wallet-api-types/rpc";
+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 \"@alchemy/wallet-api-types/rpc\";\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/formatSign.d.ts

@@ -0,0 +1,28 @@
+import type { Static } from "@sinclair/typebox";
+import type { wallet_formatSign } from "@alchemy/wallet-api-types/rpc";
+import type { InnerWalletApiClient, WithoutChainId } from "../../types.ts";
+import { type Address, type IsUndefined } from "viem";
+export type FormatSignParams<TAccount extends Address | undefined = Address | undefined> = Omit<WithoutChainId<Static<(typeof wallet_formatSign)["properties"]["Request"]["properties"]["params"]>[0]>, "from"> & (IsUndefined<TAccount> extends true ? {
+    from: Address;
+} : {
+    from?: never;
+});
+export type FormatSignResult = Static<typeof wallet_formatSign>["ReturnType"];
+/**
+ * Formats a signature request for signing messages or transactions.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {FormatSignParams} params - Parameters for formatting the signature
+ * @returns {Promise<FormatSignResult>} A Promise that resolves to the formatSign result containing the formatted signature.
+ *
+ * @example
+ * // Formats a signature
+ * const result = await client.formatSign({
+ *    from: "0x1234...",
+ *    signature: {
+ *      type: "ecdsa",
+ *      data: "0xabcd..."
+ *    },
+ * });
+ */
+export declare function formatSign<TAccount extends Address | undefined = Address | undefined>(client: InnerWalletApiClient, params: FormatSignParams<TAccount>): Promise<FormatSignResult>;

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

@@ -0,0 +1,30 @@
+import { toHex } from "viem";
+import { AccountNotFoundError } from "@aa-sdk/core";
+/**
+ * Formats a signature request for signing messages or transactions.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {FormatSignParams} params - Parameters for formatting the signature
+ * @returns {Promise<FormatSignResult>} A Promise that resolves to the formatSign result containing the formatted signature.
+ *
+ * @example
+ * // Formats a signature
+ * const result = await client.formatSign({
+ *    from: "0x1234...",
+ *    signature: {
+ *      type: "ecdsa",
+ *      data: "0xabcd..."
+ *    },
+ * });
+ */
+export async function formatSign(client, params) {
+    const from = params.from ?? client.account?.address;
+    if (!from) {
+        throw new AccountNotFoundError();
+    }
+    return client.request({
+        method: "wallet_formatSign",
+        params: [{ ...params, from, chainId: toHex(client.chain.id) }],
+    });
+}
+//# sourceMappingURL=formatSign.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatSign.js","sourceRoot":"","sources":["../../../../src/client/actions/formatSign.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAkC,MAAM,MAAM,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAgBpD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAG9B,MAA4B,EAC5B,MAAkC;IAElC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;IACpD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC;QACpB,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Static } from \"@sinclair/typebox\";\nimport type { wallet_formatSign } from \"@alchemy/wallet-api-types/rpc\";\nimport type { InnerWalletApiClient, WithoutChainId } from \"../../types.ts\";\nimport { toHex, type Address, type IsUndefined } from \"viem\";\nimport { AccountNotFoundError } from \"@aa-sdk/core\";\n\nexport type FormatSignParams<\n  TAccount extends Address | undefined = Address | undefined,\n> = Omit<\n  WithoutChainId<\n    Static<\n      (typeof wallet_formatSign)[\"properties\"][\"Request\"][\"properties\"][\"params\"]\n    >[0]\n  >,\n  \"from\"\n> &\n  (IsUndefined<TAccount> extends true ? { from: Address } : { from?: never });\n\nexport type FormatSignResult = Static<typeof wallet_formatSign>[\"ReturnType\"];\n\n/**\n * Formats a signature request for signing messages or transactions.\n *\n * @param {InnerWalletApiClient} client - The wallet API client to use for the request\n * @param {FormatSignParams} params - Parameters for formatting the signature\n * @returns {Promise<FormatSignResult>} A Promise that resolves to the formatSign result containing the formatted signature.\n *\n * @example\n * // Formats a signature\n * const result = await client.formatSign({\n *    from: \"0x1234...\",\n *    signature: {\n *      type: \"ecdsa\",\n *      data: \"0xabcd...\"\n *    },\n * });\n */\nexport async function formatSign<\n  TAccount extends Address | undefined = Address | undefined,\n>(\n  client: InnerWalletApiClient,\n  params: FormatSignParams<TAccount>,\n): Promise<FormatSignResult> {\n  const from = params.from ?? client.account?.address;\n  if (!from) {\n    throw new AccountNotFoundError();\n  }\n\n  return client.request({\n    method: \"wallet_formatSign\",\n    params: [{ ...params, from, chainId: toHex(client.chain.id) }],\n  });\n}\n"]}

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

@@ -1,6 +1,24 @@
-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;
-export declare function getCallsStatus<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined>(client: InnerWalletApiClient<TAccount>, params: GetCallsStatusParams): Promise<GetCallsStatusResult>;
+/**
+ * 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(client: InnerWalletApiClient, params: GetCallsStatusParams): Promise<GetCallsStatusResult>;

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

@@ -1,3 +1,22 @@
+/**
+ * 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 async function getCallsStatus(client, params) {
     return await client.request({
         method: "wallet_getCallsStatus",

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":"AAUA;;;;;;;;;;;;;;;;;;GAkBG;AACH,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 {\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  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,8 +1,8 @@
-import { type Address, type Hex, type IsUndefined, type JsonRpcAccount } from "viem";
-import type { InnerWalletApiClient } from "../../types";
-import type { SmartAccountSigner } from "@aa-sdk/core";
-import type { CreateSessionParams } from "../../isomorphic/actions/createSession";
-export type GrantPermissionsParams<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined> = Omit<CreateSessionParams, "account" | "chainId"> & (IsUndefined<TAccount> extends true ? {
+import { type SmartAccountSigner } from "@aa-sdk/core";
+import { type Address, type Hex, type IsUndefined } from "viem";
+import type { CreateSessionParams } from "../../isomorphic/actions/createSession.ts";
+import type { InnerWalletApiClient } from "../../types.ts";
+export type GrantPermissionsParams<TAccount extends Address | undefined = Address | undefined> = Omit<CreateSessionParams, "account" | "chainId" | "entityId"> & (IsUndefined<TAccount> extends true ? {
     account: Address;
 } : {
     account?: never;
@@ -10,4 +10,61 @@ export type GrantPermissionsParams<TAccount extends JsonRpcAccount<Address> | un
 export type GrantPermissionsResult = {
     context: Hex;
 };
-export declare function grantPermissions<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined>(client: InnerWalletApiClient<TAccount>, signer: SmartAccountSigner, params: GrantPermissionsParams<TAccount>): Promise<GrantPermissionsResult>;
+/**
+ * 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.expirySec - 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 preparedCalls = 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 signedCalls = await client.signPreparedCalls(
+ *   sessionKey,
+ *   preparedCalls,
+ * );
+ *
+ * // Send the prepared call using the session key
+ * const result = await client.sendPreparedCalls({
+ *   ...signedCalls,
+ *   capabilities: {
+ *     permissions,
+ *   },
+ * });
+ */
+export declare function grantPermissions<TAccount extends Address | undefined = Address | undefined>(client: InnerWalletApiClient, signer: SmartAccountSigner, params: GrantPermissionsParams<TAccount>): Promise<GrantPermissionsResult>;

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

@@ -1,10 +1,70 @@
-import { toHex, } from "viem";
+import { AccountNotFoundError } from "@aa-sdk/core";
+import { toHex } from "viem";
+/**
+ * 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.expirySec - 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 preparedCalls = 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 signedCalls = await client.signPreparedCalls(
+ *   sessionKey,
+ *   preparedCalls,
+ * );
+ *
+ * // Send the prepared call using the session key
+ * const result = await client.sendPreparedCalls({
+ *   ...signedCalls,
+ *   capabilities: {
+ *     permissions,
+ *   },
+ * });
+ */
 export async function grantPermissions(client, signer, params) {
-    if (client.account && !params.account) {
-        params.account = client.account.address;
+    const account = params.account ?? client.account?.address;
+    if (!account) {
+        throw new AccountNotFoundError();
     }
     return client.grantPermissions(signer, {
         ...params,
+        account,
         chainId: toHex(client.chain.id),
     });
 }

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,EAAE,oBAAoB,EAA2B,MAAM,cAAc,CAAC;AAC7E,OAAO,EAA4C,KAAK,EAAE,MAAM,MAAM,CAAC;AAevE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAGpC,MAA4B,EAC5B,MAA0B,EAC1B,MAAwC;IAExC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE;QACrC,GAAG,MAAM;QACT,OAAO;QACP,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;KAChC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { AccountNotFoundError, type SmartAccountSigner } from \"@aa-sdk/core\";\nimport { type Address, type Hex, type IsUndefined, toHex } from \"viem\";\nimport type { CreateSessionParams } from \"../../isomorphic/actions/createSession.ts\";\nimport type { InnerWalletApiClient } from \"../../types.ts\";\n\nexport type GrantPermissionsParams<\n  TAccount extends Address | undefined = Address | undefined,\n> = Omit<CreateSessionParams, \"account\" | \"chainId\" | \"entityId\"> &\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.expirySec - 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 preparedCalls = 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 signedCalls = await client.signPreparedCalls(\n *   sessionKey,\n *   preparedCalls,\n * );\n *\n * // Send the prepared call using the session key\n * const result = await client.sendPreparedCalls({\n *   ...signedCalls,\n *   capabilities: {\n *     permissions,\n *   },\n * });\n */\nexport async function grantPermissions<\n  TAccount extends Address | undefined = Address | undefined,\n>(\n  client: InnerWalletApiClient,\n  signer: SmartAccountSigner,\n  params: GrantPermissionsParams<TAccount>,\n): Promise<GrantPermissionsResult> {\n  const account = params.account ?? client.account?.address;\n  if (!account) {\n    throw new AccountNotFoundError();\n  }\n\n  return client.grantPermissions(signer, {\n    ...params,\n    account,\n    chainId: toHex(client.chain.id),\n  });\n}\n"]}

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

@@ -1,6 +1,34 @@
 import type { Static } from "@sinclair/typebox";
-import type { wallet_listAccounts } from "../../rpc/request";
-import type { InnerWalletApiClient } from "../../types";
-export type ListAccountsParams = Static<typeof wallet_listAccounts>["Request"]["params"][0];
+import type { wallet_listAccounts } from "@alchemy/wallet-api-types/rpc";
+import type { InnerWalletApiClient } from "../../types.ts";
+import type { SmartAccountSigner } from "@aa-sdk/core";
+import type { Address } from "viem";
+export type ListAccountsParams = Omit<Static<typeof wallet_listAccounts>["Request"]["params"][0], "signerAddress"> & {
+    signerAddress?: Address;
+};
 export type ListAccountsResult = Static<typeof wallet_listAccounts>["ReturnType"];
-export declare function listAccounts(client: InnerWalletApiClient, params: ListAccountsParams): Promise<ListAccountsResult>;
+/**
+ * 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, signer: SmartAccountSigner, params: ListAccountsParams): Promise<ListAccountsResult>;

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

@@ -1,4 +1,37 @@
-export async function listAccounts(client, params) {
-    return client.request({ method: "wallet_listAccounts", params: [params] });
+/**
+ * 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, signer, params) {
+    const signerAddress = params.signerAddress ?? (await signer.getAddress());
+    return client.request({
+        method: "wallet_listAccounts",
+        params: [
+            {
+                ...params,
+                signerAddress,
+            },
+        ],
+    });
 }
 //# sourceMappingURL=listAccounts.js.map

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":"AAeA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA4B,EAC5B,MAA0B,EAC1B,MAA0B;IAE1B,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,CAAC,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAE1E,OAAO,MAAM,CAAC,OAAO,CAAC;QACpB,MAAM,EAAE,qBAAqB;QAC7B,MAAM,EAAE;YACN;gBACE,GAAG,MAAM;gBACT,aAAa;aACd;SACF;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Static } from \"@sinclair/typebox\";\nimport type { wallet_listAccounts } from \"@alchemy/wallet-api-types/rpc\";\nimport type { InnerWalletApiClient } from \"../../types.ts\";\nimport type { SmartAccountSigner } from \"@aa-sdk/core\";\nimport type { Address } from \"viem\";\n\nexport type ListAccountsParams = Omit<\n  Static<typeof wallet_listAccounts>[\"Request\"][\"params\"][0],\n  \"signerAddress\"\n> & { signerAddress?: Address };\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  signer: SmartAccountSigner,\n  params: ListAccountsParams,\n): Promise<ListAccountsResult> {\n  const signerAddress = params.signerAddress ?? (await signer.getAddress());\n\n  return client.request({\n    method: \"wallet_listAccounts\",\n    params: [\n      {\n        ...params,\n        signerAddress,\n      },\n    ],\n  });\n}\n"]}

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

@@ -1,15 +1,41 @@
-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 Address, type IsUndefined } from "viem";
+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;
 } : {
-    account?: never;
+    account?: Address;
 };
-export type PrepareCallsParams<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined> = Omit<IsomorphicPrepareCallsParams, "from" | "chainId"> & (IsUndefined<TAccount> extends true ? {
+export type PrepareCallsParams<TAccount extends Address | undefined = Address | undefined> = Omit<IsomorphicPrepareCallsParams, "from" | "chainId"> & (IsUndefined<TAccount> extends true ? {
     from: Address;
 } : {
     from?: never;
 });
 export type PrepareCallsResult = IsomorphicPrepareCallsResult;
-export declare function prepareCalls<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined>(client: InnerWalletApiClient<TAccount>, params: PrepareCallsParams<TAccount>): Promise<PrepareCallsResult>;
+/**
+ * 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 sponsored 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 Address | undefined = Address | undefined>(client: InnerWalletApiClient, params: PrepareCallsParams<TAccount>): Promise<PrepareCallsResult>;

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

@@ -1,17 +1,51 @@
-import { toHex, } from "viem";
+import { AccountNotFoundError } from "@aa-sdk/core";
+import { toHex } from "viem";
+/**
+ * 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 sponsored user operation call
+ * const result = await client.prepareCalls({
+ *   calls: [{
+ *     to: "0x1234...",
+ *     data: "0xabcdef...",
+ *     value: "0x0"
+ *   }],
+ *   capabilities: {
+ *     paymasterService: { policyId: "your-policy-id" }
+ *   }
+ * });
+ */
 export async function prepareCalls(client, params) {
+    const from = params.from ?? client.account?.address;
+    if (!from) {
+        throw new AccountNotFoundError();
+    }
     if (client.policyId && !params.capabilities?.paymasterService) {
         params.capabilities = {
             ...params.capabilities,
             paymasterService: { policyId: client.policyId },
         };
     }
-    if (client.account && !params.from) {
-        params.from = client.account.address;
-    }
     return await client.request({
         method: "wallet_prepareCalls",
-        params: [{ ...params, chainId: toHex(client.chain.id) }],
+        params: [
+            {
+                ...params,
+                chainId: toHex(client.chain.id),
+                from,
+            },
+        ],
     });
 }
 //# sourceMappingURL=prepareCalls.js.map

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,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,KAAK,EAAkC,MAAM,MAAM,CAAC;AAmB7D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAGhC,MAA4B,EAC5B,MAAoC;IAEpC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;IACpD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,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,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;QAC1B,MAAM,EAAE,qBAAqB;QAC7B,MAAM,EAAE;YACN;gBACE,GAAG,MAAM;gBACT,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,IAAI;aACL;SACF;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { AccountNotFoundError } from \"@aa-sdk/core\";\nimport { toHex, type Address, type IsUndefined } 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?: Address };\n\nexport type PrepareCallsParams<\n  TAccount extends Address | undefined = Address | 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 sponsored 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 Address | undefined = Address | undefined,\n>(\n  client: InnerWalletApiClient,\n  params: PrepareCallsParams<TAccount>,\n): Promise<PrepareCallsResult> {\n  const from = params.from ?? client.account?.address;\n  if (!from) {\n    throw new AccountNotFoundError();\n  }\n\n  if (client.policyId && !params.capabilities?.paymasterService) {\n    params.capabilities = {\n      ...params.capabilities,\n      paymasterService: { policyId: client.policyId },\n    };\n  }\n\n  return await client.request({\n    method: \"wallet_prepareCalls\",\n    params: [\n      {\n        ...params,\n        chainId: toHex(client.chain.id),\n        from,\n      },\n    ],\n  });\n}\n"]}

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

@@ -0,0 +1,25 @@
+import type { InnerWalletApiClient } from "../../types.ts";
+import { type Address, type IsUndefined } from "viem";
+import type { PrepareSignParams as IsomorphicPrepareSignParams, PrepareSignResult as IsomorphicPrepareSignResult } from "../../isomorphic/actions/prepareSign.ts";
+export type PrepareSignParams<TAccount extends Address | undefined = Address | undefined> = Omit<IsomorphicPrepareSignParams, "from" | "chainId"> & (IsUndefined<TAccount> extends true ? {
+    from: Address;
+} : {
+    from?: never;
+});
+export type PrepareSignResult = IsomorphicPrepareSignResult;
+/**
+ * Prepares a signature request for signing messages or transactions.
+ *
+ * @param {InnerWalletApiClient} client - The wallet API client to use for the request
+ * @param {PrepareSignParams} params - Parameters for preparing the signature request
+ * @returns {Promise<PrepareSignResult>} A Promise that resolves to the prepare sign result containing a signature request
+ *
+ * @example
+ * // Prepare a message to be signed
+ * const result = await client.prepareSign({
+ *    from: "0x1234...",
+ *    type: "personal_sign",
+ *    data: "Hello, world!",
+ * });
+ */
+export declare function prepareSign<TAccount extends Address | undefined = Address | undefined>(client: InnerWalletApiClient, params: PrepareSignParams<TAccount>): Promise<PrepareSignResult>;