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

package/dist/types/isomorphic/utils/supportsFeature.d.ts

@@ -0,0 +1,5 @@
+import type { StaticDecode } from "@sinclair/typebox";
+import type { TypeSerializedInitcode } from "@alchemy/wallet-api-types";
+export type Feature = "permissions";
+export declare function supportsFeature(counterfactualInfo: StaticDecode<typeof TypeSerializedInitcode>, feature: Feature): boolean;
+//# sourceMappingURL=supportsFeature.d.ts.map

package/dist/types/isomorphic/utils/supportsFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportsFeature.d.ts","sourceRoot":"","sources":["../../../../src/isomorphic/utils/supportsFeature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAExE,MAAM,MAAM,OAAO,GAAG,aAAa,CAAC;AAkBpC,wBAAgB,eAAe,CAC7B,kBAAkB,EAAE,YAAY,CAAC,OAAO,sBAAsB,CAAC,EAC/D,OAAO,EAAE,OAAO,GACf,OAAO,CAST"}

package/dist/types/local/client.d.ts

@@ -1,4 +1,4 @@
-import { type Address, type JsonRpcAccount } from "viem";
-import type { CreateInnerClientParams, InnerWalletApiClient } from "../types";
-export declare function createLocalClient<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined>(params: CreateInnerClientParams<TAccount>): InnerWalletApiClient<TAccount>;
+import { type Address } from "viem";
+import type { CreateInnerClientParams, InnerWalletApiClient } from "../types.ts";
+export declare function createLocalClient<TAccount extends Address | undefined = Address | undefined>(params: CreateInnerClientParams<TAccount>): InnerWalletApiClient;
 //# sourceMappingURL=client.d.ts.map

package/dist/types/local/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/local/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,MAAM,CAAC;AAW/E,OAAO,KAAK,EACV,uBAAuB,EAEvB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAWlB,wBAAgB,iBAAiB,CAC/B,QAAQ,SAAS,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,GAChD,cAAc,CAAC,OAAO,CAAC,GACvB,SAAS,EACb,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/local/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAY1D,OAAO,KAAK,EACV,uBAAuB,EAEvB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAWrB,wBAAgB,iBAAiB,CAC/B,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,EAC1D,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG,oBAAoB,CAAC"}

package/dist/types/remote/client.d.ts

@@ -1,4 +1,10 @@
-import { type Address, type JsonRpcAccount } from "viem";
-import type { CreateInnerClientParams, InnerWalletApiClient } from "../types";
-export declare function createRemoteClient<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined>(params: CreateInnerClientParams<TAccount>): InnerWalletApiClient<TAccount>;
+import { type Address } from "viem";
+import type { CreateInnerClientParams, InnerWalletApiClient } from "../types.ts";
+/**
+ * This is a low-level client just used to make RPC requests in remote mode
+ * This should be wrapped by a higher-level smart account client that provides actions
+ * that uses this client under the hood
+ * @returns
+ */
+export declare function createRemoteClient<TAccount extends Address | undefined = Address | undefined>(params: CreateInnerClientParams<TAccount>): InnerWalletApiClient;
 //# sourceMappingURL=client.d.ts.map

package/dist/types/remote/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/remote/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,MAAM,CAAC;AAI/E,OAAO,KAAK,EACV,uBAAuB,EAEvB,oBAAoB,EAErB,MAAM,UAAU,CAAC;AAElB,wBAAgB,kBAAkB,CAChC,QAAQ,SAAS,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,GAChD,cAAc,CAAC,OAAO,CAAC,GACvB,SAAS,EACb,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/remote/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAK1D,OAAO,KAAK,EACV,uBAAuB,EAEvB,oBAAoB,EAErB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,EAC1D,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG,oBAAoB,CAAC"}

package/dist/types/types.d.ts

@@ -1,22 +1,20 @@
+import type { SmartAccountSigner, SmartContractAccount } from "@aa-sdk/core";
 import type { AlchemyTransport } from "@account-kit/infra";
-import type { Address, Chain, Client, Hex, IsUndefined, JsonRpcAccount, Transport } from "viem";
-import type { WalletServerViemRpcSchema } from "./rpc/schema";
-import type { SmartAccountSigner } from "@aa-sdk/core";
-import type { GrantPermissionsParams, GrantPermissionsResult } from "./client/actions/grantPermissions";
-export type CreateInnerClientParams<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined> = {
+import type { Address, Chain, Client, Hex, JsonRpcAccount, Transport } from "viem";
+import type { GrantPermissionsParams, GrantPermissionsResult } from "./client/actions/grantPermissions.ts";
+import type { RequestAccountParams } from "./client/actions/requestAccount.ts";
+import type { WalletServerViemRpcSchema } from "@alchemy/wallet-api-types/rpc";
+export type CreateInnerClientParams<TAccount extends Address | undefined = Address | undefined> = {
     chain: Chain;
     transport: AlchemyTransport;
     policyId?: string;
-} & (IsUndefined<TAccount> extends true ? {
-    account?: never;
-} : {
-    account: Address;
-});
-export type InnerWalletApiClientBase<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined, TExtend extends {
+    account?: TAccount | Address | undefined;
+};
+export type InnerWalletApiClientBase<TExtend extends {
     [key: string]: unknown;
 } | undefined = {
     [key: string]: unknown;
-} | undefined> = Client<Transport, Chain, TAccount, WalletServerViemRpcSchema, {
+} | undefined> = Client<Transport, Chain, JsonRpcAccount<Address> | undefined, WalletServerViemRpcSchema, {
     policyId?: string;
 } & TExtend>;
 export type InnerClientActions = {
@@ -24,5 +22,21 @@ export type InnerClientActions = {
         chainId: Hex;
     }) => Promise<GrantPermissionsResult>;
 };
-export type InnerWalletApiClient<TAccount extends JsonRpcAccount<Address> | undefined = JsonRpcAccount<Address> | undefined> = InnerWalletApiClientBase<TAccount, InnerClientActions>;
+export type CachedAccount = {
+    account: SmartContractAccount;
+    requestParams: RequestAccountParams;
+};
+export type InternalState = {
+    setAccount: (account: CachedAccount) => void;
+    getAccount: () => CachedAccount | undefined;
+};
+export type InnerWalletApiClient = InnerWalletApiClientBase<InnerClientActions & {
+    internal: InternalState;
+}>;
+export type WithoutChainId<T> = T extends {
+    chainId: Hex;
+} ? Omit<T, "chainId"> : T;
+export type WithoutRawPayload<T> = T extends {
+    rawPayload: Hex;
+} ? Omit<T, "rawPayload"> : T;
 //# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EACV,OAAO,EACP,KAAK,EACL,MAAM,EACN,GAAG,EACH,WAAW,EACX,cAAc,EACd,SAAS,EACV,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,mCAAmC,CAAC;AAE3C,MAAM,MAAM,uBAAuB,CACjC,QAAQ,SAAS,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,GAChD,cAAc,CAAC,OAAO,CAAC,GACvB,SAAS,IACX;IACF,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,IAAI,GACnC;IACE,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB,GACD;IACE,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAEP,MAAM,MAAM,wBAAwB,CAClC,QAAQ,SAAS,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,GAChD,cAAc,CAAC,OAAO,CAAC,GACvB,SAAS,EACb,OAAO,SAAS;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,SAAS,GAClD;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC1B,SAAS,IACX,MAAM,CACR,SAAS,EACT,KAAK,EACL,QAAQ,EACR,yBAAyB,EACzB;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAChC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,EAAE,CAChB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,sBAAsB,GAAG;QAAE,OAAO,EAAE,GAAG,CAAA;KAAE,KAC9C,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC9B,QAAQ,SAAS,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,GAChD,cAAc,CAAC,OAAO,CAAC,GACvB,SAAS,IACX,wBAAwB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EACV,OAAO,EACP,KAAK,EACL,MAAM,EACN,GAAG,EACH,cAAc,EACd,SAAS,EACV,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/E,MAAM,MAAM,uBAAuB,CACjC,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,IACxD;IACF,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAClC,OAAO,SAAS;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,SAAS,GAClD;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC1B,SAAS,IACX,MAAM,CACR,SAAS,EACT,KAAK,EACL,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,EACnC,yBAAyB,EACzB;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAChC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,EAAE,CAChB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,sBAAsB,GAAG;QAAE,OAAO,EAAE,GAAG,CAAA;KAAE,KAC9C,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,aAAa,EAAE,oBAAoB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,UAAU,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,CACzD,kBAAkB,GAAG;IAAE,QAAQ,EAAE,aAAa,CAAA;CAAE,CACjD,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,OAAO,EAAE,GAAG,CAAA;CAAE,GACtD,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,GAClB,CAAC,CAAC;AAEN,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,UAAU,EAAE,GAAG,CAAA;CAAE,GAC5D,IAAI,CAAC,CAAC,EAAE,YAAY,CAAC,GACrB,CAAC,CAAC"}

package/dist/types/utils.d.ts

@@ -1,4 +1,5 @@
 import { type Hex } from "viem";
+export type Expect<T extends true> = T;
 export declare const assertNever: (_val: never, msg: string) => never;
 /** If the value is already Hex, it is returned unchanged. If it's a string, number or bigint, it's converted. */
 export declare const castToHex: (val: string | number | bigint | Hex) => Hex;

package/dist/types/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAE9C,eAAO,MAAM,WAAW,GAAI,MAAM,KAAK,EAAE,KAAK,MAAM,KAAG,KAEtD,CAAC;AAEF,iHAAiH;AACjH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,GAAG,KAAG,GAK/D,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAE9C,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;AAEvC,eAAO,MAAM,WAAW,GAAI,MAAM,KAAK,EAAE,KAAK,MAAM,KAAG,KAEtD,CAAC;AAEF,iHAAiH;AACjH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,GAAG,KAAG,GAK/D,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@account-kit/wallet-client",
   "private": false,
   "type": "module",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.10",
   "main": "./dist/esm/exports/index.js",
   "module": "./dist/esm/exports/index.js",
   "types": "./dist/types/exports/index.d.ts",
@@ -51,22 +51,25 @@
   },
   "devDependencies": {
     "@repo/configs": "workspace:*",
+    "@types/deep-equal": "^1.0.4",
     "eslint-plugin-import": "^2.31.0"
   },
   "peerDependencies": {
     "typescript": "^5.8.2"
   },
   "dependencies": {
-    "@aa-sdk/core": "^4.29.0",
-    "@account-kit/infra": "^4.29.0",
-    "@account-kit/smart-contracts": "^4.29.0",
+    "@aa-sdk/core": "^4.43.1",
+    "@account-kit/infra": "^4.43.1",
+    "@account-kit/smart-contracts": "^4.43.1",
+    "@alchemy/wallet-api-types": "0.1.0-alpha.10",
     "@sinclair/typebox": "^0.34.33",
+    "deep-equal": "^2.2.3",
     "ox": "^0.6.12",
-    "viem": "^2.26.2"
+    "viem": "2.29.2"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "gitHead": "416ad43cc11800162cf60b14f6eb8262f3de83b5"
+  "gitHead": "e2a5d2c48c0036868b0529639890192ef1cf5455"
 }

package/src/client/actions/createAccount.ts

@@ -1,8 +1,8 @@
 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<
@@ -16,6 +16,31 @@ 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 async function createAccount(
   client: InnerWalletApiClient,
   signer: SmartAccountSigner,

package/src/client/actions/formatSign.ts

@@ -0,0 +1,53 @@
+import type { Static } from "@sinclair/typebox";
+import type { wallet_formatSign } from "@alchemy/wallet-api-types/rpc";
+import type { InnerWalletApiClient, WithoutChainId } from "../../types.ts";
+import { toHex, type Address, type IsUndefined } from "viem";
+import { AccountNotFoundError } from "@aa-sdk/core";
+
+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 async function formatSign<
+  TAccount extends Address | undefined = Address | undefined,
+>(
+  client: InnerWalletApiClient,
+  params: FormatSignParams<TAccount>,
+): Promise<FormatSignResult> {
+  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) }],
+  });
+}

package/src/client/actions/getCallsStatus.ts

@@ -1,23 +1,32 @@
-import type { Address, JsonRpcAccount } from "viem";
 import type {
   GetCallsStatusParams as IsomorphicGetCallsStatusParams,
   GetCallsStatusResponse as IsomorphicGetCallsStatusResult,
-} from "../../isomorphic/actions/getCallsStatus";
-import type { InnerWalletApiClient } from "../../types";
+} from "../../isomorphic/actions/getCallsStatus.ts";
+import type { InnerWalletApiClient } from "../../types.ts";
 
 export type GetCallsStatusParams = IsomorphicGetCallsStatusParams;
 
 export type GetCallsStatusResult = IsomorphicGetCallsStatusResult;
 
-export async 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 async function getCallsStatus(
   client: InnerWalletApiClient,
   params: GetCallsStatusParams,

package/src/client/actions/grantPermissions.ts

@@ -1,19 +1,11 @@
-import {
-  type Address,
-  type Hex,
-  type IsUndefined,
-  type JsonRpcAccount,
-  toHex,
-} from "viem";
-import type { InnerWalletApiClient } from "../../types";
-import type { SmartAccountSigner } from "@aa-sdk/core";
-import type { CreateSessionParams } from "../../isomorphic/actions/createSession";
+import { AccountNotFoundError, type SmartAccountSigner } from "@aa-sdk/core";
+import { type Address, type Hex, type IsUndefined, toHex } from "viem";
+import type { CreateSessionParams } from "../../isomorphic/actions/createSession.ts";
+import type { InnerWalletApiClient } from "../../types.ts";
 
 export type GrantPermissionsParams<
-  TAccount extends JsonRpcAccount<Address> | undefined =
-    | JsonRpcAccount<Address>
-    | undefined,
-> = Omit<CreateSessionParams, "account" | "chainId"> &
+  TAccount extends Address | undefined = Address | undefined,
+> = Omit<CreateSessionParams, "account" | "chainId" | "entityId"> &
   (IsUndefined<TAccount> extends true
     ? { account: Address }
     : { account?: never });
@@ -22,27 +14,78 @@ 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.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<
-  TAccount extends JsonRpcAccount<Address> | undefined =
-    | JsonRpcAccount<Address>
-    | undefined,
+  TAccount extends Address | undefined = Address | undefined,
 >(
-  client: InnerWalletApiClient<TAccount>,
-  signer: SmartAccountSigner,
-  params: GrantPermissionsParams<TAccount>,
-): Promise<GrantPermissionsResult>;
-
-export async function grantPermissions(
   client: InnerWalletApiClient,
   signer: SmartAccountSigner,
-  params: GrantPermissionsParams,
+  params: GrantPermissionsParams<TAccount>,
 ): Promise<GrantPermissionsResult> {
-  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/src/client/actions/listAccounts.ts

@@ -1,18 +1,56 @@
 import type { Static } from "@sinclair/typebox";
-import type { wallet_listAccounts } from "../../rpc/request";
-import type { InnerWalletApiClient } from "../../types";
+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 = Static<
-  typeof wallet_listAccounts
->["Request"]["params"][0];
+export type ListAccountsParams = Omit<
+  Static<typeof wallet_listAccounts>["Request"]["params"][0],
+  "signerAddress"
+> & { signerAddress?: Address };
 
 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 async function listAccounts(
   client: InnerWalletApiClient,
+  signer: SmartAccountSigner,
   params: ListAccountsParams,
 ): Promise<ListAccountsResult> {
-  return client.request({ method: "wallet_listAccounts", params: [params] });
+  const signerAddress = params.signerAddress ?? (await signer.getAddress());
+
+  return client.request({
+    method: "wallet_listAccounts",
+    params: [
+      {
+        ...params,
+        signerAddress,
+      },
+    ],
+  });
 }

package/src/client/actions/prepareCalls.ts

@@ -1,42 +1,60 @@
-import {
-  toHex,
-  type Address,
-  type IsUndefined,
-  type JsonRpcAccount,
-} from "viem";
+import { AccountNotFoundError } from "@aa-sdk/core";
+import { toHex, type Address, type IsUndefined } from "viem";
 import type {
   PrepareCallsParams as IsomorphicPrepareCallsParams,
   PrepareCallsResult as IsomorphicPrepareCallsResult,
-} from "../../isomorphic/actions/prepareCalls";
-import type { InnerWalletApiClient } from "../../types";
+} 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,
+  TAccount extends Address | undefined = Address | undefined,
 > = Omit<IsomorphicPrepareCallsParams, "from" | "chainId"> &
   (IsUndefined<TAccount> extends true ? { from: Address } : { 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 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<
-  TAccount extends JsonRpcAccount<Address> | undefined =
-    | JsonRpcAccount<Address>
-    | undefined,
+  TAccount extends Address | undefined = Address | undefined,
 >(
-  client: InnerWalletApiClient<TAccount>,
-  params: PrepareCallsParams<TAccount>,
-): Promise<PrepareCallsResult>;
-
-export async function prepareCalls(
   client: InnerWalletApiClient,
-  params: PrepareCallsParams,
+  params: PrepareCallsParams<TAccount>,
 ): Promise<PrepareCallsResult> {
+  const from = params.from ?? client.account?.address;
+  if (!from) {
+    throw new AccountNotFoundError();
+  }
+
   if (client.policyId && !params.capabilities?.paymasterService) {
     params.capabilities = {
       ...params.capabilities,
@@ -44,12 +62,14 @@ export async function prepareCalls(
     };
   }
 
-  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,
+      },
+    ],
   });
 }

package/src/client/actions/prepareSign.ts

@@ -0,0 +1,46 @@
+import type { InnerWalletApiClient } from "../../types.ts";
+import { toHex, type Address, type IsUndefined } from "viem";
+import type {
+  PrepareSignParams as IsomorphicPrepareSignParams,
+  PrepareSignResult as IsomorphicPrepareSignResult,
+} from "../../isomorphic/actions/prepareSign.ts";
+import { AccountNotFoundError } from "@aa-sdk/core";
+
+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 async function prepareSign<
+  TAccount extends Address | undefined = Address | undefined,
+>(
+  client: InnerWalletApiClient,
+  params: PrepareSignParams<TAccount>,
+): Promise<PrepareSignResult> {
+  const from = params.from ?? client.account?.address;
+  if (!from) {
+    throw new AccountNotFoundError();
+  }
+
+  return client.request({
+    method: "wallet_prepareSign",
+    params: [{ ...params, from, chainId: toHex(client.chain.id) }],
+  });
+}