@account-kit/smart-contracts 4.8.0 → 4.10.0

package/src/light-account/clients/multiOwnerLightAccount.ts

@@ -1,5 +1,6 @@
 import {
   createSmartAccountClient,
+  type NotType,
   type SmartAccountClient,
   type SmartAccountClientActions,
   type SmartAccountClientConfig,
@@ -8,14 +9,19 @@ import {
 } from "@aa-sdk/core";
 import { type Chain, type CustomTransport, type Transport } from "viem";
 import {
+  multiOwnerLightAccountClientActions,
   createMultiOwnerLightAccount,
   type CreateMultiOwnerLightAccountParams,
   type MultiOwnerLightAccount,
-} from "../accounts/multiOwner.js";
-import {
-  multiOwnerLightAccountClientActions,
   type MultiOwnerLightAccountClientActions,
-} from "../decorators/multiOwnerLightAccount.js";
+  type AlchemyMultiOwnerLightAccountClientConfig,
+} from "@account-kit/smart-contracts";
+import {
+  isAlchemyTransport,
+  createAlchemySmartAccountClient,
+  type AlchemySmartAccountClient,
+  type AlchemyTransport,
+} from "@account-kit/infra";
 
 export type CreateMultiOwnerLightAccountClientParams<
   TTransport extends Transport = Transport,
@@ -36,11 +42,37 @@ export type CreateMultiOwnerLightAccountClientParams<
     "transport" | "account" | "chain"
   >;
 
+export type CreateMultiOwnerLightAccountClientDynamicTransportParams<
+  TTransport extends Transport = Transport,
+  TChain extends Chain | undefined = Chain | undefined,
+  TSigner extends SmartAccountSigner = SmartAccountSigner
+> =
+  | (AlchemyMultiOwnerLightAccountClientConfig<TSigner> & {
+      transport: AlchemyTransport;
+    })
+  | CreateMultiOwnerLightAccountClientParams<TTransport, TChain, TSigner>;
+
+export async function createMultiOwnerLightAccountClient<
+  TSigner extends SmartAccountSigner = SmartAccountSigner
+>(
+  params: AlchemyMultiOwnerLightAccountClientConfig<TSigner> & {
+    transport: AlchemyTransport;
+  }
+): Promise<
+  AlchemySmartAccountClient<
+    Chain | undefined,
+    MultiOwnerLightAccount<TSigner>,
+    MultiOwnerLightAccountClientActions<TSigner>
+  >
+>;
+
 export function createMultiOwnerLightAccountClient<
+  TTransport extends Transport = Transport,
   TChain extends Chain | undefined = Chain | undefined,
   TSigner extends SmartAccountSigner = SmartAccountSigner
 >(
-  args: CreateMultiOwnerLightAccountClientParams<Transport, TChain, TSigner>
+  args: CreateMultiOwnerLightAccountClientParams<TTransport, TChain, TSigner> &
+    NotType<TTransport, AlchemyTransport>
 ): Promise<
   SmartAccountClient<
     CustomTransport,
@@ -71,12 +103,28 @@ export function createMultiOwnerLightAccountClient<
  * });
  * ```
  *
- * @param {CreateMultiOwnerLightAccountClientParams} params the configuration for creating the multi-owner light account client
+ * @example
+ * ```ts
+ * import { createMultiOwnerLightAccountClient } from "@account-kit/smart-contracts";
+ * import { sepolia, alchemy } from "@account-kit/infra";
+ * import { LocalAccountSigner } from "@aa-sdk/core";
+ * import { generatePrivateKey } from "viem"
+ *
+ * const lightAccountClient = await createMultiOwnerLightAccountClient({
+ *  transport: alchemy({
+ *    apiKey: "your-api-key",
+ *  }),
+ *  chain: sepolia
+ *  signer: LocalAccountSigner.privateKeyToAccountSigner(generatePrivateKey())
+ * });
+ * ```
+ *
+ * @param {CreateMultiOwnerLightAccountClientDynamicTransportParams} params the configuration for creating the multi-owner light / alchemy account client with the provided parameters transport
  * @returns {Promise<SmartAccountClient>} a promise that resolves to a `SmartAccountClient` containing the created account client and relevant methods
  */
 export async function createMultiOwnerLightAccountClient(
-  params: CreateMultiOwnerLightAccountClientParams
-): Promise<SmartAccountClient> {
+  params: CreateMultiOwnerLightAccountClientDynamicTransportParams
+): Promise<SmartAccountClient | AlchemySmartAccountClient> {
   const { transport, chain } = params;
 
   const lightAccount = await createMultiOwnerLightAccount({
@@ -84,6 +132,14 @@ export async function createMultiOwnerLightAccountClient(
     transport,
     chain,
   });
+  if (isAlchemyTransport(transport, chain)) {
+    return createAlchemySmartAccountClient({
+      ...params,
+      transport,
+      chain,
+      account: lightAccount,
+    }).extend(multiOwnerLightAccountClientActions);
+  }
 
   return createSmartAccountClient({
     ...params,

package/src/ma-v2/client/client.ts

@@ -1,8 +1,9 @@
 import {
-  createSmartAccountClient,
   type SmartAccountClient,
   type SmartAccountSigner,
   type SmartAccountClientConfig,
+  type NotType,
+  createSmartAccountClient,
 } from "@aa-sdk/core";
 import { type Chain, type Transport } from "viem";
 
@@ -11,10 +12,18 @@ import {
   type CreateSMAV2AccountParams,
   type MAV2Account,
 } from "../account/semiModularAccountV2.js";
-
+import {
+  createAlchemySmartAccountClient,
+  isAlchemyTransport,
+  type AlchemySmartAccountClientConfig,
+  type AlchemyTransport,
+} from "@account-kit/infra";
+import type { LightAccount } from "../../light-account/accounts/account.js";
 export type SMAV2AccountClient<
-  TSigner extends SmartAccountSigner = SmartAccountSigner
-> = SmartAccountClient<Transport, Chain, MAV2Account<TSigner>>;
+  TSigner extends SmartAccountSigner = SmartAccountSigner,
+  TChain extends Chain = Chain,
+  TTransport extends Transport | AlchemyTransport = Transport
+> = SmartAccountClient<TTransport, TChain, MAV2Account<TSigner>>;
 
 export type CreateSMAV2AccountClientParams<
   TTransport extends Transport = Transport,
@@ -25,13 +34,34 @@ export type CreateSMAV2AccountClientParams<
     SmartAccountClientConfig<TTransport, TChain>,
     "transport" | "account" | "chain"
   >;
+export type CreateSMAV2AlchemyAccountClientParams<
+  TTransport extends Transport = Transport,
+  TChain extends Chain = Chain,
+  TSigner extends SmartAccountSigner = SmartAccountSigner
+> = Omit<
+  CreateSMAV2AccountClientParams<TTransport, TChain, TSigner>,
+  "transport"
+> &
+  Omit<
+    AlchemySmartAccountClientConfig<TChain, LightAccount<TSigner>>,
+    "account"
+  > & { paymasterAndData?: never; dummyPaymasterAndData?: never };
 
 export function createSMAV2AccountClient<
   TChain extends Chain = Chain,
   TSigner extends SmartAccountSigner = SmartAccountSigner
 >(
-  args: CreateSMAV2AccountClientParams<Transport, TChain, TSigner>
-): Promise<SMAV2AccountClient<TSigner>>;
+  args: CreateSMAV2AlchemyAccountClientParams<AlchemyTransport, TChain, TSigner>
+): Promise<SMAV2AccountClient<TSigner, TChain, AlchemyTransport>>;
+
+export function createSMAV2AccountClient<
+  TTransport extends Transport = Transport,
+  TChain extends Chain = Chain,
+  TSigner extends SmartAccountSigner = SmartAccountSigner
+>(
+  args: CreateSMAV2AccountClientParams<TTransport, TChain, TSigner> &
+    NotType<TTransport, AlchemyTransport>
+): Promise<SMAV2AccountClient<TSigner, TChain>>;
 
 /**
  * Creates a SMAv2 account client using the provided configuration parameters.
@@ -52,10 +82,13 @@ export function createSMAV2AccountClient<
  *
  * const transport = http(RPC_URL);
  *
+ * const policyId = "...";
+ *
  * const SMAV2SignerAccountClient = await createSMAV2AccountClient({
  *  chain,
  *  signer,
  *  transport,
+ *  policyId, // NOTE: you may only pass in a gas policy ID if you provide an Alchemy transport!
  * });
  * ```
  *
@@ -65,7 +98,20 @@ export function createSMAV2AccountClient<
 export async function createSMAV2AccountClient(
   config: CreateSMAV2AccountClientParams
 ): Promise<SmartAccountClient> {
-  const smaV2Account = await createSMAV2Account(config);
+  const { transport, chain } = config;
+  const smaV2Account = await createSMAV2Account({
+    ...config,
+    transport,
+    chain,
+  });
+  if (isAlchemyTransport(transport, chain)) {
+    return createAlchemySmartAccountClient({
+      ...config,
+      transport,
+      chain,
+      account: smaV2Account,
+    });
+  }
 
   return createSmartAccountClient({
     ...config,

package/src/msca/client/alchemyClient.ts

@@ -1,14 +1,10 @@
 import type { SmartAccountSigner } from "@aa-sdk/core";
 import {
-  createAlchemySmartAccountClient,
   type AlchemySmartAccountClient,
   type AlchemySmartAccountClientConfig,
 } from "@account-kit/infra";
 import {
-  accountLoupeActions,
-  createMultiOwnerModularAccount,
-  multiOwnerPluginActions,
-  pluginManagerActions,
+  createMultiOwnerModularAccountClient,
   type AccountLoupeActions,
   type CreateMultiOwnerModularAccountParams,
   type LightAccount,
@@ -59,27 +55,12 @@ export function createModularAccountAlchemyClient<
  *  signer: LocalAccountSigner.privateKeyToAccountSigner(generatePrivateKey())
  * });
  * ```
- *
+ * @deprecated Use createModularAccountClient instead of this function, we are switching based on the transport
  * @param {AlchemyModularAccountClientConfig} config The configuration for creating the Alchemy client
  * @returns {Promise<AlchemySmartAccountClient>} A promise that resolves to an `AlchemySmartAccountClient` configured with the desired plugins and actions
  */
 export async function createModularAccountAlchemyClient(
   config: AlchemyModularAccountClientConfig
 ): Promise<AlchemySmartAccountClient> {
-  const { transport, chain, opts } = config;
-
-  const account = await createMultiOwnerModularAccount({
-    ...config,
-    transport,
-    chain,
-  });
-
-  return createAlchemySmartAccountClient({
-    ...config,
-    account,
-    opts,
-  })
-    .extend(multiOwnerPluginActions)
-    .extend(pluginManagerActions)
-    .extend(accountLoupeActions);
+  return createMultiOwnerModularAccountClient(config);
 }

package/src/msca/client/client.ts

@@ -1,6 +1,7 @@
 import {
   createSmartAccountClient,
   smartAccountClientActions,
+  type NotType,
   type SmartAccountClient,
   type SmartAccountClientRpcSchema,
   type SmartAccountSigner,
@@ -35,8 +36,16 @@ import {
   type MultisigUserOperationContext,
 } from "../plugins/multisig/index.js";
 import { multisigSignatureMiddleware } from "../plugins/multisig/middleware.js";
+import type { AlchemyModularAccountClientConfig } from "./alchemyClient.js";
+import {
+  createAlchemySmartAccountClient,
+  isAlchemyTransport,
+  type AlchemySmartAccountClient,
+  type AlchemyTransport,
+} from "@account-kit/infra";
+import type { AlchemyMultisigAccountClientConfig } from "./multiSigAlchemyClient.js";
 
-export type CreateMultiOwnerModularAccountClientParams<
+export type CreateMultiOwnerModularAccountClientWithoutAlchemyParams<
   TTransport extends Transport = Transport,
   TChain extends Chain | undefined = Chain | undefined,
   TSigner extends SmartAccountSigner = SmartAccountSigner
@@ -45,8 +54,19 @@ export type CreateMultiOwnerModularAccountClientParams<
   "transport" | "chain"
 > &
   Omit<CreateLightAccountClientParams<TTransport, TChain, TSigner>, "account">;
+export type CreateMultiOwnerModularAccountClientParams<
+  TTransport extends Transport = Transport,
+  TChain extends Chain | undefined = Chain | undefined,
+  TSigner extends SmartAccountSigner = SmartAccountSigner
+> =
+  | CreateMultiOwnerModularAccountClientWithoutAlchemyParams<
+      TTransport,
+      TChain,
+      TSigner
+    >
+  | AlchemyModularAccountClientConfig<TSigner>;
 
-export type CreateMultisigModularAccountClientParams<
+export type CreateMultisigModularAccountClientWithoutAlchemyParams<
   TTransport extends Transport = Transport,
   TChain extends Chain | undefined = Chain | undefined,
   TSigner extends SmartAccountSigner = SmartAccountSigner
@@ -56,11 +76,45 @@ export type CreateMultisigModularAccountClientParams<
 > &
   Omit<CreateLightAccountClientParams<TTransport, TChain, TSigner>, "account">;
 
+export type CreateMultisigModularAccountClientParams<
+  TTransport extends Transport = Transport,
+  TChain extends Chain | undefined = Chain | undefined,
+  TSigner extends SmartAccountSigner = SmartAccountSigner
+> =
+  | CreateMultisigModularAccountClientWithoutAlchemyParams<
+      TTransport,
+      TChain,
+      TSigner
+    >
+  | AlchemyMultisigAccountClientConfig<TSigner>;
+
+export function createMultiOwnerModularAccountClient<
+  TSigner extends SmartAccountSigner = SmartAccountSigner
+>(
+  params: AlchemyModularAccountClientConfig<TSigner> & {
+    transport: AlchemyTransport;
+  }
+): Promise<
+  AlchemySmartAccountClient<
+    Chain | undefined,
+    MultiOwnerModularAccount<TSigner>,
+    MultiOwnerPluginActions<MultiOwnerModularAccount<TSigner>> &
+      PluginManagerActions<MultiOwnerModularAccount<TSigner>> &
+      AccountLoupeActions<MultiOwnerModularAccount<TSigner>>
+  >
+>;
+
 export function createMultiOwnerModularAccountClient<
+  TTransport extends Transport = Transport,
   TChain extends Chain | undefined = Chain | undefined,
   TSigner extends SmartAccountSigner = SmartAccountSigner
 >(
-  args: CreateMultiOwnerModularAccountClientParams<Transport, TChain, TSigner>
+  args: CreateMultiOwnerModularAccountClientParams<
+    TTransport,
+    TChain,
+    TSigner
+  > &
+    NotType<TTransport, AlchemyTransport>
 ): Promise<
   SmartAccountClient<
     CustomTransport,
@@ -89,6 +143,19 @@ export function createMultiOwnerModularAccountClient<
  *  signer: LocalAccountSigner.privateKeyToAccountSigner(generatePrivateKey())
  * });
  * ```
+ * @example
+ * ```ts
+ * import { createMultiOwnerModularAccountClient } from "@account-kit/smart-contracts";
+ * import { sepolia, alchemy } from "@account-kit/infra";
+ * import { LocalAccountSigner } from "@aa-sdk/core";
+ * import { generatePrivateKey } from "viem"
+ *
+ * const alchemyAccountClient = await createMultiOwnerModularAccountClient({
+ *  transport: alchemy({ apiKey: "your-api-key" }),
+ *  chain: sepolia,
+ *  signer: LocalAccountSigner.privateKeyToAccountSigner(generatePrivateKey())
+ * });
+ * ```
  *
  * @param {CreateMultiOwnerModularAccountClientParams} config The parameters for creating the multi-owner modular account client
  * @returns {Promise<SmartAccountClient>} A promise that resolves to a `SmartAccountClient` instance with extended plugin actions
@@ -97,12 +164,28 @@ export async function createMultiOwnerModularAccountClient({
   transport,
   chain,
   ...params
-}: CreateMultiOwnerModularAccountClientParams): Promise<SmartAccountClient> {
+}: CreateMultiOwnerModularAccountClientParams): Promise<
+  SmartAccountClient | AlchemySmartAccountClient
+> {
   const modularAccount = await createMultiOwnerModularAccount({
     ...params,
     transport,
     chain,
   });
+  if (isAlchemyTransport(transport, chain)) {
+    const { opts } = params;
+
+    return createAlchemySmartAccountClient({
+      ...params,
+      account: modularAccount,
+      transport,
+      chain,
+      opts,
+    })
+      .extend(multiOwnerPluginActions)
+      .extend(pluginManagerActions)
+      .extend(accountLoupeActions);
+  }
 
   return createSmartAccountClient({
     ...params,
@@ -116,10 +199,27 @@ export async function createMultiOwnerModularAccountClient({
 }
 
 export function createMultisigModularAccountClient<
+  TSigner extends SmartAccountSigner = SmartAccountSigner
+>(
+  params: AlchemyMultisigAccountClientConfig<TSigner>
+): Promise<
+  AlchemySmartAccountClient<
+    Chain | undefined,
+    MultisigModularAccount<TSigner>,
+    MultisigPluginActions<MultisigModularAccount<TSigner>> &
+      PluginManagerActions<MultisigModularAccount<TSigner>> &
+      AccountLoupeActions<MultisigModularAccount<TSigner>>,
+    MultisigUserOperationContext
+  >
+>;
+
+export function createMultisigModularAccountClient<
+  TTransport extends Transport = Transport,
   TChain extends Chain | undefined = Chain | undefined,
   TSigner extends SmartAccountSigner = SmartAccountSigner
 >(
-  args: CreateMultisigModularAccountClientParams<Transport, TChain, TSigner>
+  args: CreateMultisigModularAccountClientParams<TTransport, TChain, TSigner> &
+    NotType<TTransport, AlchemyTransport>
 ): Promise<
   SmartAccountClient<
     CustomTransport,
@@ -152,6 +252,21 @@ export function createMultisigModularAccountClient<
  *  threshold: 2, // 2 of N signatures
  * });
  * ```
+ * @example
+ * ```ts
+ * import { createMultisigModularAccountClient } from "@account-kit/smart-contracts";
+ * import { sepolia } from "@account-kit/infra";
+ * import { LocalAccountSigner } from "@aa-sdk/core";
+ * import { generatePrivateKey } from "viem"
+ *
+ * const alchemyAccountClient = await createMultisigModularAccountClient({
+ *  transport: alchemy({ apiKey: "your-api-key" }),
+ *  chain: sepolia,
+ *  signer: LocalAccountSigner.privateKeyToAccountSigner(generatePrivateKey()),
+ *  owners: [...], // other owners on the account
+ *  threshold: 2, // 2 of N signatures
+ * });
+ * ```
  *
  * @param {CreateMultisigModularAccountClientParams} config the parameters for configuring the multisig modular account client
  * @returns {Promise<SmartAccountClient<Transport, Chain, MultisigModularAccount<SmartAccountSigner>, {}, SmartAccountClientRpcSchema, MultisigUserOperationContext>>} a promise that resolves to a `SmartAccountClient` object extended with the multisig modular account and additional actions
@@ -161,20 +276,49 @@ export async function createMultisigModularAccountClient({
   chain,
   ...params
 }: CreateMultisigModularAccountClientParams): Promise<
-  SmartAccountClient<
-    Transport,
-    Chain,
-    MultisigModularAccount<SmartAccountSigner>,
-    {},
-    SmartAccountClientRpcSchema,
-    MultisigUserOperationContext
-  >
+  | SmartAccountClient<
+      Transport,
+      Chain,
+      MultisigModularAccount<SmartAccountSigner>,
+      {},
+      SmartAccountClientRpcSchema,
+      MultisigUserOperationContext
+    >
+  | AlchemySmartAccountClient<
+      Chain | undefined,
+      MultisigModularAccount<SmartAccountSigner>,
+      MultisigPluginActions<MultisigModularAccount<SmartAccountSigner>> &
+        PluginManagerActions<MultisigModularAccount<SmartAccountSigner>> &
+        AccountLoupeActions<MultisigModularAccount<SmartAccountSigner>>,
+      MultisigUserOperationContext
+    >
 > {
   const modularAccount = await createMultisigModularAccount({
     ...params,
     transport,
     chain,
   });
+  if (isAlchemyTransport(transport, chain)) {
+    // Need to fit the type into this since the previous multiSigAlchemyClient had it at this point, but without an Value as Type should be safe
+    // And the createAlchemySmartAccountClient signUserOperation could not infer without this
+    let config: AlchemyMultisigAccountClientConfig = {
+      ...params,
+      chain,
+      transport,
+    };
+    const { opts } = config;
+
+    return createAlchemySmartAccountClient({
+      ...config,
+      account: modularAccount,
+      opts,
+      signUserOperation: multisigSignatureMiddleware,
+    })
+      .extend(smartAccountClientActions)
+      .extend(multisigPluginActions)
+      .extend(pluginManagerActions)
+      .extend(accountLoupeActions);
+  }
 
   const client = createSmartAccountClient({
     ...params,

package/src/msca/client/multiSigAlchemyClient.ts

@@ -1,18 +1,11 @@
+import { type SmartAccountSigner } from "@aa-sdk/core";
 import {
-  smartAccountClientActions,
-  type SmartAccountSigner,
-} from "@aa-sdk/core";
-import {
-  createAlchemySmartAccountClient,
   type AlchemySmartAccountClient,
   type AlchemySmartAccountClientConfig,
+  type AlchemyTransport,
 } from "@account-kit/infra";
 import {
-  accountLoupeActions,
-  createMultisigModularAccount,
-  multisigPluginActions,
-  multisigSignatureMiddleware,
-  pluginManagerActions,
+  createMultisigModularAccountClient,
   type AccountLoupeActions,
   type CreateMultisigModularAccountParams,
   type LightAccount,
@@ -38,7 +31,7 @@ export type AlchemyMultisigAccountClientConfig<
       MultisigUserOperationContext
     >,
     "account"
-  >;
+  > & { transport: AlchemyTransport };
 
 export function createMultisigAccountAlchemyClient<
   TSigner extends SmartAccountSigner = SmartAccountSigner
@@ -74,6 +67,7 @@ export function createMultisigAccountAlchemyClient<
  * });
  * ```
  *
+ * @deprecated Use createModularAccountClient instead of this function, we are switching based on the transport
  * @param {AlchemyMultisigAccountClientConfig} config The configuration for the Alchemy multisig account client
  * @returns {Promise<AlchemySmartAccountClient<Transport, Chain | undefined, MultisigModularAccount<SmartAccountSigner>, MultisigPluginActions<MultisigModularAccount<SmartAccountSigner>> & PluginManagerActions<MultisigModularAccount<SmartAccountSigner>> & AccountLoupeActions<MultisigModularAccount<SmartAccountSigner>>, MultisigUserOperationContext>>} A promise that resolves to an Alchemy Smart Account Client for multisig accounts with extended functionalities.
  */
@@ -89,22 +83,5 @@ export async function createMultisigAccountAlchemyClient(
     MultisigUserOperationContext
   >
 > {
-  const { transport, opts, chain } = config;
-
-  const account = await createMultisigModularAccount({
-    ...config,
-    transport,
-    chain,
-  });
-
-  return createAlchemySmartAccountClient({
-    ...config,
-    account,
-    opts,
-    signUserOperation: multisigSignatureMiddleware,
-  })
-    .extend(smartAccountClientActions)
-    .extend(multisigPluginActions)
-    .extend(pluginManagerActions)
-    .extend(accountLoupeActions);
+  return createMultisigModularAccountClient(config);
 }