@account-kit/signer 4.0.0-alpha.9 → 4.0.0-beta.1

package/dist/esm/base.js

@@ -6,7 +6,20 @@ import { createStore } from "zustand/vanilla";
 import { NotAuthenticatedError } from "./errors.js";
 import { SessionManager, } from "./session/manager.js";
 import { AlchemySignerStatus, } from "./types.js";
+/**
+ * Base abstract class for Alchemy Signer, providing authentication and session management for smart accounts.
+ * Implements the `SmartAccountAuthenticator` interface and handles various signer events.
+ */
 export class BaseAlchemySigner {
+    /**
+     * Initializes an instance with the provided client and session configuration.
+     * This function sets up the internal store, initializes the session manager,
+     * registers listeners and initializes the session manager to manage session state.
+     *
+     * @param {BaseAlchemySignerParams<TClient>} param0 Object containing the client and session configuration
+     * @param {TClient} param0.client The client instance to be used internally
+     * @param {SessionConfig} param0.sessionConfig Configuration for managing sessions
+     */
     constructor({ client, sessionConfig }) {
         Object.defineProperty(this, "signerType", {
             enumerable: true,
@@ -32,11 +45,21 @@ export class BaseAlchemySigner {
             writable: true,
             value: void 0
         });
+        /**
+         * Allows you to subscribe to events emitted by the signer
+         *
+         * @param {AlchemySignerEvent} event the event to subscribe to
+         * @param {AlchemySignerEvents[AlchemySignerEvent]} listener the function to run when the event is emitted
+         * @returns {() => void} a function to remove the listener
+         */
         Object.defineProperty(this, "on", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: (event, listener) => {
+                // NOTE: we're using zustand here to handle this because we are able to use the fireImmediately
+                // option which deals with a possible race condition where the listener is added after the event
+                // is fired. In the Client and SessionManager we use EventEmitter because it's easier to handle internally
                 switch (event) {
                     case "connected":
                         return this.store.subscribe(({ status }) => status, (status) => status === AlchemySignerStatus.CONNECTED &&
@@ -51,6 +74,33 @@ export class BaseAlchemySigner {
                 }
             }
         });
+        /**
+         * Authenticate a user with either an email or a passkey and create a session for that user
+         *
+         * @example
+         * ```ts
+         * import { AlchemyWebSigner } from "@account-kit/signer";
+         *
+         * const signer = new AlchemyWebSigner({
+         *  client: {
+         *    connection: {
+         *      rpcUrl: "/api/rpc",
+         *    },
+         *    iframeConfig: {
+         *      iframeContainerId: "alchemy-signer-iframe-container",
+         *    },
+         *  },
+         * });
+         *
+         * const result = await signer.authenticate({
+         *  type: "email",
+         *  email: "foo@mail.com",
+         * });
+         * ```
+         *
+         * @param {AuthParams} params - undefined if passkey login, otherwise an object with email and bundle to resolve
+         * @returns {Promise<User>} the user that was authenticated
+         */
         Object.defineProperty(this, "authenticate", {
             enumerable: true,
             configurable: true,
@@ -62,6 +112,29 @@ export class BaseAlchemySigner {
                 return this.authenticateWithPasskey(params);
             }
         });
+        /**
+         * Clear a user session and log them out
+         *
+         * @example
+         * ```ts
+         * import { AlchemyWebSigner } from "@account-kit/signer";
+         *
+         * const signer = new AlchemyWebSigner({
+         *  client: {
+         *    connection: {
+         *      rpcUrl: "/api/rpc",
+         *    },
+         *    iframeConfig: {
+         *      iframeContainerId: "alchemy-signer-iframe-container",
+         *    },
+         *  },
+         * });
+         *
+         * await signer.disconnect();
+         * ```
+         *
+         * @returns {Promise<void>} a promise that resolves when the user is logged out
+         */
         Object.defineProperty(this, "disconnect", {
             enumerable: true,
             configurable: true,
@@ -70,6 +143,33 @@ export class BaseAlchemySigner {
                 await this.inner.disconnect();
             }
         });
+        /**
+         * Gets the current logged in user
+         * If a user has an ongoing session, it will use that session and
+         * try to authenticate
+         *
+         * @example
+         * ```ts
+         * import { AlchemyWebSigner } from "@account-kit/signer";
+         *
+         * const signer = new AlchemyWebSigner({
+         *  client: {
+         *    connection: {
+         *      rpcUrl: "/api/rpc",
+         *    },
+         *    iframeConfig: {
+         *      iframeContainerId: "alchemy-signer-iframe-container",
+         *    },
+         *  },
+         * });
+         *
+         * // throws if not logged in
+         * const user = await signer.getAuthDetails();
+         * ```
+         *
+         * @throws if there is no user logged in
+         * @returns {Promise<User>} the current user
+         */
         Object.defineProperty(this, "getAuthDetails", {
             enumerable: true,
             configurable: true,
@@ -82,6 +182,11 @@ export class BaseAlchemySigner {
                 return this.inner.whoami();
             }
         });
+        /**
+         * Retrieves the address of the current user by calling the `whoami` method on `this.inner`.
+         *
+         * @returns {Promise<string>} A promise that resolves to the address of the current user.
+         */
         Object.defineProperty(this, "getAddress", {
             enumerable: true,
             configurable: true,
@@ -91,6 +196,30 @@ export class BaseAlchemySigner {
                 return address;
             }
         });
+        /**
+         * Signs a raw message after hashing it.
+         *
+         * @example
+         * ```ts
+         * import { AlchemyWebSigner } from "@account-kit/signer";
+         *
+         * const signer = new AlchemyWebSigner({
+         *  client: {
+         *    connection: {
+         *      rpcUrl: "/api/rpc",
+         *    },
+         *    iframeConfig: {
+         *      iframeContainerId: "alchemy-signer-iframe-container",
+         *    },
+         *  },
+         * });
+         *
+         * const signature = await signer.signMessage("Hello, world!");
+         * ```
+         *
+         * @param {string} msg the message to be hashed and then signed
+         * @returns {Promise<string>} a promise that resolves to the signed message
+         */
         Object.defineProperty(this, "signMessage", {
             enumerable: true,
             configurable: true,
@@ -100,6 +229,35 @@ export class BaseAlchemySigner {
                 return this.inner.signRawMessage(messageHash);
             }
         });
+        /**
+         * Signs a typed message by first hashing it and then signing the hashed message using the `signRawMessage` method.
+         *
+         * @example
+         * ```ts
+         * import { AlchemyWebSigner } from "@account-kit/signer";
+         *
+         * const signer = new AlchemyWebSigner({
+         *  client: {
+         *    connection: {
+         *      rpcUrl: "/api/rpc",
+         *    },
+         *    iframeConfig: {
+         *      iframeContainerId: "alchemy-signer-iframe-container",
+         *    },
+         *  },
+         * });
+         *
+         * const signature = await signer.signTypedData({
+         *  domain: {},
+         *  types: {},
+         *  primaryType: "",
+         *  message: {},
+         * });
+         * ```
+         *
+         * @param {TypedDataDefinition<TTypedData, TPrimaryType>} params The parameters for the typed message to be hashed and signed
+         * @returns {Promise<any>} A promise that resolves to the signed message
+         */
         Object.defineProperty(this, "signTypedData", {
             enumerable: true,
             configurable: true,
@@ -109,6 +267,36 @@ export class BaseAlchemySigner {
                 return this.inner.signRawMessage(messageHash);
             }
         });
+        /**
+         * Serializes a transaction, signs it with a raw message, and then returns the serialized transaction with the signature.
+         *
+         * @example
+         * ```ts
+         * import { AlchemyWebSigner } from "@account-kit/signer";
+         *
+         * const signer = new AlchemyWebSigner({
+         *  client: {
+         *    connection: {
+         *      rpcUrl: "/api/rpc",
+         *    },
+         *    iframeConfig: {
+         *      iframeContainerId: "alchemy-signer-iframe-container",
+         *    },
+         *  },
+         * });
+         *
+         * const tx = await signer.signTransaction({
+         *  to: "0x1234",
+         *  value: "0x1234",
+         *  data: "0x1234",
+         * });
+         * ```
+         *
+         * @param {Transaction} tx the transaction to be serialized and signed
+         * @param {{serializer?: SerializeTransactionFn}} args options for serialization
+         * @param {() => Hex} [args.serializer] an optional serializer function. If not provided, the default `serializeTransaction` function will be used
+         * @returns {Promise<string>} a promise that resolves to the serialized transaction with the signature
+         */
         Object.defineProperty(this, "signTransaction", {
             enumerable: true,
             configurable: true,
@@ -125,6 +313,30 @@ export class BaseAlchemySigner {
                 return serializeFn(tx, signature);
             }
         });
+        /**
+         * Unauthenticated call to look up a user's organizationId by email
+         *
+         * @example
+         * ```ts
+         * import { AlchemyWebSigner } from "@account-kit/signer";
+         *
+         * const signer = new AlchemyWebSigner({
+         *  client: {
+         *    connection: {
+         *      rpcUrl: "/api/rpc",
+         *    },
+         *    iframeConfig: {
+         *      iframeContainerId: "alchemy-signer-iframe-container",
+         *    },
+         *  },
+         * });
+         *
+         * const result = await signer.getUser("foo@mail.com");
+         * ```
+         *
+         * @param {string} email the email to lookup
+         * @returns {Promise<{orgId: string}>} the organization id for the user if they exist
+         */
         Object.defineProperty(this, "getUser", {
             enumerable: true,
             configurable: true,
@@ -139,6 +351,30 @@ export class BaseAlchemySigner {
                 };
             }
         });
+        /**
+         * Adds a passkey to the user's account
+         *
+         * @example
+         * ```ts
+         * import { AlchemyWebSigner } from "@account-kit/signer";
+         *
+         * const signer = new AlchemyWebSigner({
+         *  client: {
+         *    connection: {
+         *      rpcUrl: "/api/rpc",
+         *    },
+         *    iframeConfig: {
+         *      iframeContainerId: "alchemy-signer-iframe-container",
+         *    },
+         *  },
+         * });
+         *
+         * const result = await signer.addPasskey()
+         * ```
+         *
+         * @param {CredentialCreationOptions | undefined} params optional parameters for the passkey creation
+         * @returns {Promise<string[]>} an array of the authenticator ids added to the user
+         */
         Object.defineProperty(this, "addPasskey", {
             enumerable: true,
             configurable: true,
@@ -147,6 +383,33 @@ export class BaseAlchemySigner {
                 return this.inner.addPasskey(params ?? {});
             }
         });
+        /**
+         * Used to export the wallet for a given user
+         * If the user is authenticated with an Email, this will return a seed phrase
+         * If the user is authenticated with a Passkey, this will return a private key
+         *
+         * @example
+         * ```ts
+         * import { AlchemyWebSigner } from "@account-kit/signer";
+         *
+         * const signer = new AlchemyWebSigner({
+         *  client: {
+         *    connection: {
+         *      rpcUrl: "/api/rpc",
+         *    },
+         *    iframeConfig: {
+         *      iframeContainerId: "alchemy-signer-iframe-container",
+         *    },
+         *  },
+         * });
+         *
+         * // the params passed to this are different based on the specific signer
+         * const result = signer.exportWallet()
+         * ```
+         *
+         * @param {unknown} params export wallet parameters
+         * @returns {boolean} true if the wallet was exported successfully
+         */
         Object.defineProperty(this, "exportWallet", {
             enumerable: true,
             configurable: true,
@@ -155,11 +418,38 @@ export class BaseAlchemySigner {
                 return this.inner.exportWallet(params);
             }
         });
+        /**
+         * This method lets you adapt your AlchemySigner to a viem LocalAccount, which
+         * will let you use the signer as an EOA directly.
+         *
+         * @example
+         * ```ts
+         * import { AlchemyWebSigner } from "@account-kit/signer";
+         *
+         * const signer = new AlchemyWebSigner({
+         *  client: {
+         *    connection: {
+         *      rpcUrl: "/api/rpc",
+         *    },
+         *    iframeConfig: {
+         *      iframeContainerId: "alchemy-signer-iframe-container",
+         *    },
+         *  },
+         * });
+         *
+         * const account = signer.toViemAccount();
+         * ```
+         *
+         * @throws if your signer is not authenticated
+         * @returns {LocalAccount} a LocalAccount object that can be used with viem's wallet client
+         */
         Object.defineProperty(this, "toViemAccount", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: () => {
+                // if we want this method to be synchronous, then we need to do this check here
+                // otherwise we can use the sessionManager to get the user
                 if (!this.inner.getUser()) {
                     throw new NotAuthenticatedError();
                 }
@@ -192,6 +482,8 @@ export class BaseAlchemySigner {
                         });
                     this.sessionManager.setTemporarySession({ orgId });
                     this.store.setState({ status: AlchemySignerStatus.AWAITING_EMAIL_AUTH });
+                    // We wait for the session manager to emit a connected event if
+                    // cross tab sessions are permitted
                     return new Promise((resolve) => {
                         const removeListener = this.sessionManager.on("connected", (session) => {
                             resolve(session.user);
@@ -221,8 +513,17 @@ export class BaseAlchemySigner {
             writable: true,
             value: async (args) => {
                 let user;
-                if (args.createNew) {
+                const shouldCreateNew = async () => {
+                    if ("email" in args) {
+                        const existingUser = await this.getUser(args.email);
+                        return existingUser == null;
+                    }
+                    return args.createNew;
+                };
+                if (await shouldCreateNew()) {
                     const result = await this.inner.createAccount(args);
+                    // account creation for passkeys returns the whoami response so we don't have to
+                    // call it again after signup
                     user = {
                         address: result.address,
                         userId: result.userId,
@@ -273,6 +574,9 @@ export class BaseAlchemySigner {
             user: null,
             status: AlchemySignerStatus.INITIALIZING,
         })));
+        // NOTE: it's important that the session manager share a client
+        // with the signer. The SessionManager leverages the Signer's client
+        // to manage session state.
         this.sessionManager = new SessionManager({
             ...sessionConfig,
             client: this.inner,
@@ -281,7 +585,9 @@ export class BaseAlchemySigner {
             user: null,
             status: AlchemySignerStatus.INITIALIZING,
         })));
+        // register listeners first
         this.registerListeners();
+        // then initialize so that we can catch those events
         this.sessionManager.initialize();
     }
 }

package/dist/esm/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/base.ts"],"names":[],"mappings":"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","sourcesContent":["import { takeBytes, type SmartAccountAuthenticator } from \"@aa-sdk/core\";\nimport {\n  hashMessage,\n  hashTypedData,\n  keccak256,\n  serializeTransaction,\n  type CustomSource,\n  type Hex,\n  type LocalAccount,\n  type SignableMessage,\n  type TypedData,\n  type TypedDataDefinition,\n} from \"viem\";\nimport { toAccount } from \"viem/accounts\";\nimport type { Mutate, StoreApi } from \"zustand\";\nimport { subscribeWithSelector } from \"zustand/middleware\";\nimport { createStore } from \"zustand/vanilla\";\nimport type { BaseSignerClient } from \"./client/base\";\nimport type { User } from \"./client/types\";\nimport { NotAuthenticatedError } from \"./errors.js\";\nimport {\n  SessionManager,\n  type SessionManagerParams,\n} from \"./session/manager.js\";\nimport type { AuthParams } from \"./signer\";\nimport {\n  AlchemySignerStatus,\n  type AlchemySignerEvent,\n  type AlchemySignerEvents,\n} from \"./types.js\";\n\nexport interface BaseAlchemySignerParams<TClient extends BaseSignerClient> {\n  client: TClient;\n  sessionConfig?: Omit<SessionManagerParams, \"client\">;\n}\n\ntype AlchemySignerStore = {\n  user: User | null;\n  status: AlchemySignerStatus;\n};\n\ntype InternalStore = Mutate<\n  StoreApi<AlchemySignerStore>,\n  [[\"zustand/subscribeWithSelector\", never]]\n>;\n\n/**\n * Base abstract class for Alchemy Signer, providing authentication and session management for smart accounts.\n * Implements the `SmartAccountAuthenticator` interface and handles various signer events.\n */\nexport abstract class BaseAlchemySigner<TClient extends BaseSignerClient>\n  implements SmartAccountAuthenticator<AuthParams, User, TClient>\n{\n  signerType: string = \"alchemy-signer\";\n  inner: TClient;\n  private sessionManager: SessionManager;\n  private store: InternalStore;\n\n  /**\n   * Initializes an instance with the provided client and session configuration.\n   * This function sets up the internal store, initializes the session manager,\n   * registers listeners and initializes the session manager to manage session state.\n   *\n   * @param {BaseAlchemySignerParams<TClient>} param0 Object containing the client and session configuration\n   * @param {TClient} param0.client The client instance to be used internally\n   * @param {SessionConfig} param0.sessionConfig Configuration for managing sessions\n   */\n  constructor({ client, sessionConfig }: BaseAlchemySignerParams<TClient>) {\n    this.inner = client;\n    this.store = createStore(\n      subscribeWithSelector(\n        () =>\n          ({\n            user: null,\n            status: AlchemySignerStatus.INITIALIZING,\n          } satisfies AlchemySignerStore)\n      )\n    );\n    // NOTE: it's important that the session manager share a client\n    // with the signer. The SessionManager leverages the Signer's client\n    // to manage session state.\n    this.sessionManager = new SessionManager({\n      ...sessionConfig,\n      client: this.inner,\n    });\n    this.store = createStore(\n      subscribeWithSelector(\n        () =>\n          ({\n            user: null,\n            status: AlchemySignerStatus.INITIALIZING,\n          } satisfies AlchemySignerStore)\n      )\n    );\n    // register listeners first\n    this.registerListeners();\n    // then initialize so that we can catch those events\n    this.sessionManager.initialize();\n  }\n\n  /**\n   * Allows you to subscribe to events emitted by the signer\n   *\n   * @param {AlchemySignerEvent} event the event to subscribe to\n   * @param {AlchemySignerEvents[AlchemySignerEvent]} listener the function to run when the event is emitted\n   * @returns {() => void} a function to remove the listener\n   */\n  on = <E extends AlchemySignerEvent>(\n    event: E,\n    listener: AlchemySignerEvents[E]\n  ) => {\n    // NOTE: we're using zustand here to handle this because we are able to use the fireImmediately\n    // option which deals with a possible race condition where the listener is added after the event\n    // is fired. In the Client and SessionManager we use EventEmitter because it's easier to handle internally\n    switch (event) {\n      case \"connected\":\n        return this.store.subscribe(\n          ({ status }) => status,\n          (status) =>\n            status === AlchemySignerStatus.CONNECTED &&\n            (listener as AlchemySignerEvents[\"connected\"])(\n              this.store.getState().user!\n            ),\n          { fireImmediately: true }\n        );\n      case \"disconnected\":\n        return this.store.subscribe(\n          ({ status }) => status,\n          (status) =>\n            status === AlchemySignerStatus.DISCONNECTED &&\n            (listener as AlchemySignerEvents[\"disconnected\"])(),\n          { fireImmediately: true }\n        );\n      case \"statusChanged\":\n        return this.store.subscribe(\n          ({ status }) => status,\n          listener as AlchemySignerEvents[\"statusChanged\"],\n          { fireImmediately: true }\n        );\n      default:\n        throw new Error(`Uknown event type ${event}`);\n    }\n  };\n\n  /**\n   * Authenticate a user with either an email or a passkey and create a session for that user\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const result = await signer.authenticate({\n   *  type: \"email\",\n   *  email: \"foo@mail.com\",\n   * });\n   * ```\n   *\n   * @param {AuthParams} params - undefined if passkey login, otherwise an object with email and bundle to resolve\n   * @returns {Promise<User>} the user that was authenticated\n   */\n  authenticate: (params: AuthParams) => Promise<User> = async (params) => {\n    if (params.type === \"email\") {\n      return this.authenticateWithEmail(params);\n    }\n\n    return this.authenticateWithPasskey(params);\n  };\n\n  /**\n   * Clear a user session and log them out\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * await signer.disconnect();\n   * ```\n   *\n   * @returns {Promise<void>} a promise that resolves when the user is logged out\n   */\n  disconnect: () => Promise<void> = async () => {\n    await this.inner.disconnect();\n  };\n\n  /**\n   * Gets the current logged in user\n   * If a user has an ongoing session, it will use that session and\n   * try to authenticate\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * // throws if not logged in\n   * const user = await signer.getAuthDetails();\n   * ```\n   *\n   * @throws if there is no user logged in\n   * @returns {Promise<User>} the current user\n   */\n  getAuthDetails = async (): Promise<User> => {\n    const sessionUser = await this.sessionManager.getSessionUser();\n    if (sessionUser != null) {\n      return sessionUser;\n    }\n\n    return this.inner.whoami();\n  };\n\n  /**\n   * Retrieves the address of the current user by calling the `whoami` method on `this.inner`.\n   *\n   * @returns {Promise<string>} A promise that resolves to the address of the current user.\n   */\n  getAddress: () => Promise<`0x${string}`> = async () => {\n    const { address } = await this.inner.whoami();\n\n    return address;\n  };\n\n  /**\n   * Signs a raw message after hashing it.\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const signature = await signer.signMessage(\"Hello, world!\");\n   * ```\n   *\n   * @param {string} msg the message to be hashed and then signed\n   * @returns {Promise<string>} a promise that resolves to the signed message\n   */\n  signMessage: (msg: SignableMessage) => Promise<`0x${string}`> = async (\n    msg\n  ) => {\n    const messageHash = hashMessage(msg);\n\n    return this.inner.signRawMessage(messageHash);\n  };\n\n  /**\n   * Signs a typed message by first hashing it and then signing the hashed message using the `signRawMessage` method.\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const signature = await signer.signTypedData({\n   *  domain: {},\n   *  types: {},\n   *  primaryType: \"\",\n   *  message: {},\n   * });\n   * ```\n   *\n   * @param {TypedDataDefinition<TTypedData, TPrimaryType>} params The parameters for the typed message to be hashed and signed\n   * @returns {Promise<any>} A promise that resolves to the signed message\n   */\n  signTypedData: <\n    const TTypedData extends TypedData | { [key: string]: unknown },\n    TPrimaryType extends keyof TTypedData | \"EIP712Domain\" = keyof TTypedData\n  >(\n    params: TypedDataDefinition<TTypedData, TPrimaryType>\n  ) => Promise<Hex> = async (params) => {\n    const messageHash = hashTypedData(params);\n\n    return this.inner.signRawMessage(messageHash);\n  };\n\n  /**\n   * Serializes a transaction, signs it with a raw message, and then returns the serialized transaction with the signature.\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const tx = await signer.signTransaction({\n   *  to: \"0x1234\",\n   *  value: \"0x1234\",\n   *  data: \"0x1234\",\n   * });\n   * ```\n   *\n   * @param {Transaction} tx the transaction to be serialized and signed\n   * @param {{serializer?: SerializeTransactionFn}} args options for serialization\n   * @param {() => Hex} [args.serializer] an optional serializer function. If not provided, the default `serializeTransaction` function will be used\n   * @returns {Promise<string>} a promise that resolves to the serialized transaction with the signature\n   */\n  signTransaction: CustomSource[\"signTransaction\"] = async (tx, args) => {\n    const serializeFn = args?.serializer ?? serializeTransaction;\n    const serializedTx = serializeFn(tx);\n    const signatureHex = await this.inner.signRawMessage(\n      keccak256(serializedTx)\n    );\n\n    const signature = {\n      r: takeBytes(signatureHex, { count: 32 }),\n      s: takeBytes(signatureHex, { count: 32, offset: 32 }),\n      v: BigInt(takeBytes(signatureHex, { count: 1, offset: 64 })),\n    };\n\n    return serializeFn(tx, signature);\n  };\n\n  /**\n   * Unauthenticated call to look up a user's organizationId by email\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const result = await signer.getUser(\"foo@mail.com\");\n   * ```\n   *\n   * @param {string} email the email to lookup\n   * @returns {Promise<{orgId: string}>} the organization id for the user if they exist\n   */\n  getUser: (email: string) => Promise<{ orgId: string } | null> = async (\n    email\n  ) => {\n    const result = await this.inner.lookupUserByEmail(email);\n\n    if (result.orgId == null) {\n      return null;\n    }\n\n    return {\n      orgId: result.orgId,\n    };\n  };\n\n  /**\n   * Adds a passkey to the user's account\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const result = await signer.addPasskey()\n   * ```\n   *\n   * @param {CredentialCreationOptions | undefined} params optional parameters for the passkey creation\n   * @returns {Promise<string[]>} an array of the authenticator ids added to the user\n   */\n  addPasskey: (params?: CredentialCreationOptions) => Promise<string[]> =\n    async (params) => {\n      return this.inner.addPasskey(params ?? {});\n    };\n\n  /**\n   * Used to export the wallet for a given user\n   * If the user is authenticated with an Email, this will return a seed phrase\n   * If the user is authenticated with a Passkey, this will return a private key\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * // the params passed to this are different based on the specific signer\n   * const result = signer.exportWallet()\n   * ```\n   *\n   * @param {unknown} params export wallet parameters\n   * @returns {boolean} true if the wallet was exported successfully\n   */\n  exportWallet: (\n    params: Parameters<(typeof this.inner)[\"exportWallet\"]>[0]\n  ) => Promise<boolean> = async (params) => {\n    return this.inner.exportWallet(params);\n  };\n\n  /**\n   * This method lets you adapt your AlchemySigner to a viem LocalAccount, which\n   * will let you use the signer as an EOA directly.\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const account = signer.toViemAccount();\n   * ```\n   *\n   * @throws if your signer is not authenticated\n   * @returns {LocalAccount} a LocalAccount object that can be used with viem's wallet client\n   */\n  toViemAccount = (): LocalAccount => {\n    // if we want this method to be synchronous, then we need to do this check here\n    // otherwise we can use the sessionManager to get the user\n    if (!this.inner.getUser()) {\n      throw new NotAuthenticatedError();\n    }\n\n    return toAccount({\n      address: this.inner.getUser()!.address,\n      signMessage: (msg) => this.signMessage(msg.message),\n      signTypedData: <\n        const typedData extends TypedData | Record<string, unknown>,\n        primaryType extends keyof typedData | \"EIP712Domain\" = keyof typedData\n      >(\n        typedDataDefinition: TypedDataDefinition<typedData, primaryType>\n      ) => this.signTypedData<typedData, primaryType>(typedDataDefinition),\n      signTransaction: this.signTransaction,\n    });\n  };\n\n  private authenticateWithEmail = async (\n    params: Extract<AuthParams, { type: \"email\" }>\n  ): Promise<User> => {\n    if (\"email\" in params) {\n      const existingUser = await this.getUser(params.email);\n\n      const { orgId } = existingUser\n        ? await this.inner.initEmailAuth({\n            email: params.email,\n            expirationSeconds: this.sessionManager.expirationTimeMs,\n            redirectParams: params.redirectParams,\n          })\n        : await this.inner.createAccount({\n            type: \"email\",\n            email: params.email,\n            expirationSeconds: this.sessionManager.expirationTimeMs,\n            redirectParams: params.redirectParams,\n          });\n\n      this.sessionManager.setTemporarySession({ orgId });\n      this.store.setState({ status: AlchemySignerStatus.AWAITING_EMAIL_AUTH });\n\n      // We wait for the session manager to emit a connected event if\n      // cross tab sessions are permitted\n      return new Promise<User>((resolve) => {\n        const removeListener = this.sessionManager.on(\n          \"connected\",\n          (session) => {\n            resolve(session.user);\n            removeListener();\n          }\n        );\n      });\n    } else {\n      const temporarySession = params.orgId\n        ? { orgId: params.orgId }\n        : this.sessionManager.getTemporarySession();\n\n      if (!temporarySession) {\n        this.store.setState({ status: AlchemySignerStatus.DISCONNECTED });\n        throw new Error(\"Could not find email auth init session!\");\n      }\n\n      const user = await this.inner.completeEmailAuth({\n        bundle: params.bundle,\n        orgId: temporarySession.orgId,\n      });\n\n      return user;\n    }\n  };\n\n  private authenticateWithPasskey = async (\n    args: Extract<AuthParams, { type: \"passkey\" }>\n  ) => {\n    let user: User;\n    if (args.createNew) {\n      const result = await this.inner.createAccount(args);\n      // account creation for passkeys returns the whoami response so we don't have to\n      // call it again after signup\n      user = {\n        address: result.address!,\n        userId: result.userId!,\n        orgId: result.orgId,\n      };\n    } else {\n      user = await this.inner.lookupUserWithPasskey();\n      if (!user) {\n        this.store.setState({ status: AlchemySignerStatus.DISCONNECTED });\n        throw new Error(\"No user found\");\n      }\n    }\n\n    return user;\n  };\n\n  private registerListeners = () => {\n    this.sessionManager.on(\"connected\", (session) => {\n      this.store.setState({\n        user: session.user,\n        status: AlchemySignerStatus.CONNECTED,\n      });\n    });\n\n    this.sessionManager.on(\"disconnected\", () => {\n      this.store.setState({\n        user: null,\n        status: AlchemySignerStatus.DISCONNECTED,\n      });\n    });\n\n    this.sessionManager.on(\"initialized\", () => {\n      this.store.setState((state) => ({\n        status: state.user\n          ? AlchemySignerStatus.CONNECTED\n          : AlchemySignerStatus.DISCONNECTED,\n      }));\n    });\n\n    this.inner.on(\"authenticating\", () => {\n      this.store.setState({ status: AlchemySignerStatus.AUTHENTICATING });\n    });\n  };\n}\n"]}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/base.ts"],"names":[],"mappings":"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","sourcesContent":["import { takeBytes, type SmartAccountAuthenticator } from \"@aa-sdk/core\";\nimport {\n  hashMessage,\n  hashTypedData,\n  keccak256,\n  serializeTransaction,\n  type CustomSource,\n  type Hex,\n  type LocalAccount,\n  type SignableMessage,\n  type TypedData,\n  type TypedDataDefinition,\n} from \"viem\";\nimport { toAccount } from \"viem/accounts\";\nimport type { Mutate, StoreApi } from \"zustand\";\nimport { subscribeWithSelector } from \"zustand/middleware\";\nimport { createStore } from \"zustand/vanilla\";\nimport type { BaseSignerClient } from \"./client/base\";\nimport type { User } from \"./client/types\";\nimport { NotAuthenticatedError } from \"./errors.js\";\nimport {\n  SessionManager,\n  type SessionManagerParams,\n} from \"./session/manager.js\";\nimport type { AuthParams } from \"./signer\";\nimport {\n  AlchemySignerStatus,\n  type AlchemySignerEvent,\n  type AlchemySignerEvents,\n} from \"./types.js\";\n\nexport interface BaseAlchemySignerParams<TClient extends BaseSignerClient> {\n  client: TClient;\n  sessionConfig?: Omit<SessionManagerParams, \"client\">;\n}\n\ntype AlchemySignerStore = {\n  user: User | null;\n  status: AlchemySignerStatus;\n};\n\ntype InternalStore = Mutate<\n  StoreApi<AlchemySignerStore>,\n  [[\"zustand/subscribeWithSelector\", never]]\n>;\n\n/**\n * Base abstract class for Alchemy Signer, providing authentication and session management for smart accounts.\n * Implements the `SmartAccountAuthenticator` interface and handles various signer events.\n */\nexport abstract class BaseAlchemySigner<TClient extends BaseSignerClient>\n  implements SmartAccountAuthenticator<AuthParams, User, TClient>\n{\n  signerType: string = \"alchemy-signer\";\n  inner: TClient;\n  private sessionManager: SessionManager;\n  private store: InternalStore;\n\n  /**\n   * Initializes an instance with the provided client and session configuration.\n   * This function sets up the internal store, initializes the session manager,\n   * registers listeners and initializes the session manager to manage session state.\n   *\n   * @param {BaseAlchemySignerParams<TClient>} param0 Object containing the client and session configuration\n   * @param {TClient} param0.client The client instance to be used internally\n   * @param {SessionConfig} param0.sessionConfig Configuration for managing sessions\n   */\n  constructor({ client, sessionConfig }: BaseAlchemySignerParams<TClient>) {\n    this.inner = client;\n    this.store = createStore(\n      subscribeWithSelector(\n        () =>\n          ({\n            user: null,\n            status: AlchemySignerStatus.INITIALIZING,\n          } satisfies AlchemySignerStore)\n      )\n    );\n    // NOTE: it's important that the session manager share a client\n    // with the signer. The SessionManager leverages the Signer's client\n    // to manage session state.\n    this.sessionManager = new SessionManager({\n      ...sessionConfig,\n      client: this.inner,\n    });\n    this.store = createStore(\n      subscribeWithSelector(\n        () =>\n          ({\n            user: null,\n            status: AlchemySignerStatus.INITIALIZING,\n          } satisfies AlchemySignerStore)\n      )\n    );\n    // register listeners first\n    this.registerListeners();\n    // then initialize so that we can catch those events\n    this.sessionManager.initialize();\n  }\n\n  /**\n   * Allows you to subscribe to events emitted by the signer\n   *\n   * @param {AlchemySignerEvent} event the event to subscribe to\n   * @param {AlchemySignerEvents[AlchemySignerEvent]} listener the function to run when the event is emitted\n   * @returns {() => void} a function to remove the listener\n   */\n  on = <E extends AlchemySignerEvent>(\n    event: E,\n    listener: AlchemySignerEvents[E]\n  ) => {\n    // NOTE: we're using zustand here to handle this because we are able to use the fireImmediately\n    // option which deals with a possible race condition where the listener is added after the event\n    // is fired. In the Client and SessionManager we use EventEmitter because it's easier to handle internally\n    switch (event) {\n      case \"connected\":\n        return this.store.subscribe(\n          ({ status }) => status,\n          (status) =>\n            status === AlchemySignerStatus.CONNECTED &&\n            (listener as AlchemySignerEvents[\"connected\"])(\n              this.store.getState().user!\n            ),\n          { fireImmediately: true }\n        );\n      case \"disconnected\":\n        return this.store.subscribe(\n          ({ status }) => status,\n          (status) =>\n            status === AlchemySignerStatus.DISCONNECTED &&\n            (listener as AlchemySignerEvents[\"disconnected\"])(),\n          { fireImmediately: true }\n        );\n      case \"statusChanged\":\n        return this.store.subscribe(\n          ({ status }) => status,\n          listener as AlchemySignerEvents[\"statusChanged\"],\n          { fireImmediately: true }\n        );\n      default:\n        throw new Error(`Uknown event type ${event}`);\n    }\n  };\n\n  /**\n   * Authenticate a user with either an email or a passkey and create a session for that user\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const result = await signer.authenticate({\n   *  type: \"email\",\n   *  email: \"foo@mail.com\",\n   * });\n   * ```\n   *\n   * @param {AuthParams} params - undefined if passkey login, otherwise an object with email and bundle to resolve\n   * @returns {Promise<User>} the user that was authenticated\n   */\n  authenticate: (params: AuthParams) => Promise<User> = async (params) => {\n    if (params.type === \"email\") {\n      return this.authenticateWithEmail(params);\n    }\n\n    return this.authenticateWithPasskey(params);\n  };\n\n  /**\n   * Clear a user session and log them out\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * await signer.disconnect();\n   * ```\n   *\n   * @returns {Promise<void>} a promise that resolves when the user is logged out\n   */\n  disconnect: () => Promise<void> = async () => {\n    await this.inner.disconnect();\n  };\n\n  /**\n   * Gets the current logged in user\n   * If a user has an ongoing session, it will use that session and\n   * try to authenticate\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * // throws if not logged in\n   * const user = await signer.getAuthDetails();\n   * ```\n   *\n   * @throws if there is no user logged in\n   * @returns {Promise<User>} the current user\n   */\n  getAuthDetails = async (): Promise<User> => {\n    const sessionUser = await this.sessionManager.getSessionUser();\n    if (sessionUser != null) {\n      return sessionUser;\n    }\n\n    return this.inner.whoami();\n  };\n\n  /**\n   * Retrieves the address of the current user by calling the `whoami` method on `this.inner`.\n   *\n   * @returns {Promise<string>} A promise that resolves to the address of the current user.\n   */\n  getAddress: () => Promise<`0x${string}`> = async () => {\n    const { address } = await this.inner.whoami();\n\n    return address;\n  };\n\n  /**\n   * Signs a raw message after hashing it.\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const signature = await signer.signMessage(\"Hello, world!\");\n   * ```\n   *\n   * @param {string} msg the message to be hashed and then signed\n   * @returns {Promise<string>} a promise that resolves to the signed message\n   */\n  signMessage: (msg: SignableMessage) => Promise<`0x${string}`> = async (\n    msg\n  ) => {\n    const messageHash = hashMessage(msg);\n\n    return this.inner.signRawMessage(messageHash);\n  };\n\n  /**\n   * Signs a typed message by first hashing it and then signing the hashed message using the `signRawMessage` method.\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const signature = await signer.signTypedData({\n   *  domain: {},\n   *  types: {},\n   *  primaryType: \"\",\n   *  message: {},\n   * });\n   * ```\n   *\n   * @param {TypedDataDefinition<TTypedData, TPrimaryType>} params The parameters for the typed message to be hashed and signed\n   * @returns {Promise<any>} A promise that resolves to the signed message\n   */\n  signTypedData: <\n    const TTypedData extends TypedData | Record<string, unknown>,\n    TPrimaryType extends keyof TTypedData | \"EIP712Domain\" = keyof TTypedData\n  >(\n    params: TypedDataDefinition<TTypedData, TPrimaryType>\n  ) => Promise<Hex> = async (params) => {\n    const messageHash = hashTypedData(params);\n\n    return this.inner.signRawMessage(messageHash);\n  };\n\n  /**\n   * Serializes a transaction, signs it with a raw message, and then returns the serialized transaction with the signature.\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const tx = await signer.signTransaction({\n   *  to: \"0x1234\",\n   *  value: \"0x1234\",\n   *  data: \"0x1234\",\n   * });\n   * ```\n   *\n   * @param {Transaction} tx the transaction to be serialized and signed\n   * @param {{serializer?: SerializeTransactionFn}} args options for serialization\n   * @param {() => Hex} [args.serializer] an optional serializer function. If not provided, the default `serializeTransaction` function will be used\n   * @returns {Promise<string>} a promise that resolves to the serialized transaction with the signature\n   */\n  signTransaction: CustomSource[\"signTransaction\"] = async (tx, args) => {\n    const serializeFn = args?.serializer ?? serializeTransaction;\n    const serializedTx = serializeFn(tx);\n    const signatureHex = await this.inner.signRawMessage(\n      keccak256(serializedTx)\n    );\n\n    const signature = {\n      r: takeBytes(signatureHex, { count: 32 }),\n      s: takeBytes(signatureHex, { count: 32, offset: 32 }),\n      v: BigInt(takeBytes(signatureHex, { count: 1, offset: 64 })),\n    };\n\n    return serializeFn(tx, signature);\n  };\n\n  /**\n   * Unauthenticated call to look up a user's organizationId by email\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const result = await signer.getUser(\"foo@mail.com\");\n   * ```\n   *\n   * @param {string} email the email to lookup\n   * @returns {Promise<{orgId: string}>} the organization id for the user if they exist\n   */\n  getUser: (email: string) => Promise<{ orgId: string } | null> = async (\n    email\n  ) => {\n    const result = await this.inner.lookupUserByEmail(email);\n\n    if (result.orgId == null) {\n      return null;\n    }\n\n    return {\n      orgId: result.orgId,\n    };\n  };\n\n  /**\n   * Adds a passkey to the user's account\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const result = await signer.addPasskey()\n   * ```\n   *\n   * @param {CredentialCreationOptions | undefined} params optional parameters for the passkey creation\n   * @returns {Promise<string[]>} an array of the authenticator ids added to the user\n   */\n  addPasskey: (params?: CredentialCreationOptions) => Promise<string[]> =\n    async (params) => {\n      return this.inner.addPasskey(params ?? {});\n    };\n\n  /**\n   * Used to export the wallet for a given user\n   * If the user is authenticated with an Email, this will return a seed phrase\n   * If the user is authenticated with a Passkey, this will return a private key\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * // the params passed to this are different based on the specific signer\n   * const result = signer.exportWallet()\n   * ```\n   *\n   * @param {unknown} params export wallet parameters\n   * @returns {boolean} true if the wallet was exported successfully\n   */\n  exportWallet: (\n    params: Parameters<(typeof this.inner)[\"exportWallet\"]>[0]\n  ) => Promise<boolean> = async (params) => {\n    return this.inner.exportWallet(params);\n  };\n\n  /**\n   * This method lets you adapt your AlchemySigner to a viem LocalAccount, which\n   * will let you use the signer as an EOA directly.\n   *\n   * @example\n   * ```ts\n   * import { AlchemyWebSigner } from \"@account-kit/signer\";\n   *\n   * const signer = new AlchemyWebSigner({\n   *  client: {\n   *    connection: {\n   *      rpcUrl: \"/api/rpc\",\n   *    },\n   *    iframeConfig: {\n   *      iframeContainerId: \"alchemy-signer-iframe-container\",\n   *    },\n   *  },\n   * });\n   *\n   * const account = signer.toViemAccount();\n   * ```\n   *\n   * @throws if your signer is not authenticated\n   * @returns {LocalAccount} a LocalAccount object that can be used with viem's wallet client\n   */\n  toViemAccount = (): LocalAccount => {\n    // if we want this method to be synchronous, then we need to do this check here\n    // otherwise we can use the sessionManager to get the user\n    if (!this.inner.getUser()) {\n      throw new NotAuthenticatedError();\n    }\n\n    return toAccount({\n      address: this.inner.getUser()!.address,\n      signMessage: (msg) => this.signMessage(msg.message),\n      signTypedData: <\n        const typedData extends TypedData | Record<string, unknown>,\n        primaryType extends keyof typedData | \"EIP712Domain\" = keyof typedData\n      >(\n        typedDataDefinition: TypedDataDefinition<typedData, primaryType>\n      ) => this.signTypedData<typedData, primaryType>(typedDataDefinition),\n      signTransaction: this.signTransaction,\n    });\n  };\n\n  private authenticateWithEmail = async (\n    params: Extract<AuthParams, { type: \"email\" }>\n  ): Promise<User> => {\n    if (\"email\" in params) {\n      const existingUser = await this.getUser(params.email);\n\n      const { orgId } = existingUser\n        ? await this.inner.initEmailAuth({\n            email: params.email,\n            expirationSeconds: this.sessionManager.expirationTimeMs,\n            redirectParams: params.redirectParams,\n          })\n        : await this.inner.createAccount({\n            type: \"email\",\n            email: params.email,\n            expirationSeconds: this.sessionManager.expirationTimeMs,\n            redirectParams: params.redirectParams,\n          });\n\n      this.sessionManager.setTemporarySession({ orgId });\n      this.store.setState({ status: AlchemySignerStatus.AWAITING_EMAIL_AUTH });\n\n      // We wait for the session manager to emit a connected event if\n      // cross tab sessions are permitted\n      return new Promise<User>((resolve) => {\n        const removeListener = this.sessionManager.on(\n          \"connected\",\n          (session) => {\n            resolve(session.user);\n            removeListener();\n          }\n        );\n      });\n    } else {\n      const temporarySession = params.orgId\n        ? { orgId: params.orgId }\n        : this.sessionManager.getTemporarySession();\n\n      if (!temporarySession) {\n        this.store.setState({ status: AlchemySignerStatus.DISCONNECTED });\n        throw new Error(\"Could not find email auth init session!\");\n      }\n\n      const user = await this.inner.completeEmailAuth({\n        bundle: params.bundle,\n        orgId: temporarySession.orgId,\n      });\n\n      return user;\n    }\n  };\n\n  private authenticateWithPasskey = async (\n    args: Extract<AuthParams, { type: \"passkey\" }>\n  ) => {\n    let user: User;\n    const shouldCreateNew = async () => {\n      if (\"email\" in args) {\n        const existingUser = await this.getUser(args.email);\n        return existingUser == null;\n      }\n\n      return args.createNew;\n    };\n\n    if (await shouldCreateNew()) {\n      const result = await this.inner.createAccount(\n        args as Extract<\n          AuthParams,\n          { type: \"passkey\" } & ({ email: string } | { createNew: true })\n        >\n      );\n      // account creation for passkeys returns the whoami response so we don't have to\n      // call it again after signup\n      user = {\n        address: result.address!,\n        userId: result.userId!,\n        orgId: result.orgId,\n      };\n    } else {\n      user = await this.inner.lookupUserWithPasskey();\n      if (!user) {\n        this.store.setState({ status: AlchemySignerStatus.DISCONNECTED });\n        throw new Error(\"No user found\");\n      }\n    }\n\n    return user;\n  };\n\n  private registerListeners = () => {\n    this.sessionManager.on(\"connected\", (session) => {\n      this.store.setState({\n        user: session.user,\n        status: AlchemySignerStatus.CONNECTED,\n      });\n    });\n\n    this.sessionManager.on(\"disconnected\", () => {\n      this.store.setState({\n        user: null,\n        status: AlchemySignerStatus.DISCONNECTED,\n      });\n    });\n\n    this.sessionManager.on(\"initialized\", () => {\n      this.store.setState((state) => ({\n        status: state.user\n          ? AlchemySignerStatus.CONNECTED\n          : AlchemySignerStatus.DISCONNECTED,\n      }));\n    });\n\n    this.inner.on(\"authenticating\", () => {\n      this.store.setState({ status: AlchemySignerStatus.AUTHENTICATING });\n    });\n  };\n}\n"]}