@account-kit/signer 4.0.0-alpha.0

package/dist/esm/client/base.js

@@ -0,0 +1,291 @@
+import { ConnectionConfigSchema } from "@aa-sdk/core";
+import { TurnkeyClient } from "@turnkey/http";
+import EventEmitter from "eventemitter3";
+import { NotAuthenticatedError } from "../errors.js";
+import { base64UrlEncode } from "../utils/base64UrlEncode.js";
+export class BaseSignerClient {
+    constructor(params) {
+        Object.defineProperty(this, "_user", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "connectionConfig", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "turnkeyClient", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "rootOrg", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "eventEmitter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "on", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (event, listener) => {
+                this.eventEmitter.on(event, listener);
+                return () => this.eventEmitter.removeListener(event, listener);
+            }
+        });
+        Object.defineProperty(this, "addPasskey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (options) => {
+                if (!this.user) {
+                    throw new NotAuthenticatedError();
+                }
+                const { attestation, challenge } = await this.getWebAuthnAttestation(options);
+                const { activity } = await this.turnkeyClient.createAuthenticators({
+                    type: "ACTIVITY_TYPE_CREATE_AUTHENTICATORS_V2",
+                    timestampMs: Date.now().toString(),
+                    organizationId: this.user.orgId,
+                    parameters: {
+                        userId: this.user.userId,
+                        authenticators: [
+                            {
+                                attestation,
+                                authenticatorName: `passkey-${Date.now().toString()}`,
+                                challenge: base64UrlEncode(challenge),
+                            },
+                        ],
+                    },
+                });
+                const { authenticatorIds } = await this.pollActivityCompletion(activity, this.user.orgId, "createAuthenticatorsResult");
+                return authenticatorIds;
+            }
+        });
+        Object.defineProperty(this, "whoami", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (orgId = this.user?.orgId) => {
+                if (this.user) {
+                    return this.user;
+                }
+                if (!orgId) {
+                    throw new Error("No orgId provided");
+                }
+                const stampedRequest = await this.turnkeyClient.stampGetWhoami({
+                    organizationId: orgId,
+                });
+                const user = await this.request("/v1/whoami", {
+                    stampedRequest,
+                });
+                const credentialId = (() => {
+                    try {
+                        return JSON.parse(stampedRequest?.stamp.stampHeaderValue)
+                            .credentialId;
+                    }
+                    catch (e) {
+                        return undefined;
+                    }
+                })();
+                this.user = {
+                    ...user,
+                    credentialId,
+                };
+                return this.user;
+            }
+        });
+        Object.defineProperty(this, "lookupUserByEmail", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (email) => {
+                return this.request("/v1/lookup", { email });
+            }
+        });
+        Object.defineProperty(this, "signRawMessage", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (msg) => {
+                if (!this.user) {
+                    throw new NotAuthenticatedError();
+                }
+                const stampedRequest = await this.turnkeyClient.stampSignRawPayload({
+                    organizationId: this.user.orgId,
+                    type: "ACTIVITY_TYPE_SIGN_RAW_PAYLOAD_V2",
+                    timestampMs: Date.now().toString(),
+                    parameters: {
+                        encoding: "PAYLOAD_ENCODING_HEXADECIMAL",
+                        hashFunction: "HASH_FUNCTION_NO_OP",
+                        payload: msg,
+                        signWith: this.user.address,
+                    },
+                });
+                const { signature } = await this.request("/v1/sign-payload", {
+                    stampedRequest,
+                });
+                return signature;
+            }
+        });
+        Object.defineProperty(this, "getUser", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                return this.user ?? null;
+            }
+        });
+        Object.defineProperty(this, "request", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (route, body) => {
+                const url = this.connectionConfig.rpcUrl ?? "https://api.g.alchemy.com";
+                const basePath = "/signer";
+                const headers = new Headers();
+                headers.append("Content-Type", "application/json");
+                if (this.connectionConfig.apiKey) {
+                    headers.append("Authorization", `Bearer ${this.connectionConfig.apiKey}`);
+                }
+                else if (this.connectionConfig.jwt) {
+                    headers.append("Authorization", `Bearer ${this.connectionConfig.jwt}`);
+                }
+                const response = await fetch(`${url}${basePath}${route}`, {
+                    method: "POST",
+                    body: JSON.stringify(body),
+                    headers,
+                });
+                if (!response.ok) {
+                    throw new Error(await response.text());
+                }
+                const json = await response.json();
+                return json;
+            }
+        });
+        Object.defineProperty(this, "exportAsSeedPhrase", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (stamper) => {
+                if (!this.user) {
+                    throw new NotAuthenticatedError();
+                }
+                const { wallets } = await this.turnkeyClient.getWallets({
+                    organizationId: this.user.orgId,
+                });
+                const walletAccounts = await Promise.all(wallets.map(({ walletId }) => this.turnkeyClient.getWalletAccounts({
+                    organizationId: this.user.orgId,
+                    walletId,
+                }))).then((x) => x.flatMap((x) => x.accounts));
+                const walletAccount = walletAccounts.find((x) => x.address === this.user.address);
+                if (!walletAccount) {
+                    throw new Error(`Could not find wallet associated with ${this.user.address}`);
+                }
+                const { activity } = await this.turnkeyClient.exportWallet({
+                    organizationId: this.user.orgId,
+                    type: "ACTIVITY_TYPE_EXPORT_WALLET",
+                    timestampMs: Date.now().toString(),
+                    parameters: {
+                        walletId: walletAccount.walletId,
+                        targetPublicKey: stamper.publicKey(),
+                    },
+                });
+                const { exportBundle } = await this.pollActivityCompletion(activity, this.user.orgId, "exportWalletResult");
+                const result = await stamper.injectWalletExportBundle(exportBundle);
+                if (!result) {
+                    throw new Error("Failed to inject wallet export bundle");
+                }
+                return result;
+            }
+        });
+        Object.defineProperty(this, "exportAsPrivateKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (stamper) => {
+                if (!this.user) {
+                    throw new NotAuthenticatedError();
+                }
+                const { activity } = await this.turnkeyClient.exportWalletAccount({
+                    organizationId: this.user.orgId,
+                    type: "ACTIVITY_TYPE_EXPORT_WALLET_ACCOUNT",
+                    timestampMs: Date.now().toString(),
+                    parameters: {
+                        address: this.user.address,
+                        targetPublicKey: stamper.publicKey(),
+                    },
+                });
+                const { exportBundle } = await this.pollActivityCompletion(activity, this.user.orgId, "exportWalletAccountResult");
+                const result = await stamper.injectKeyExportBundle(exportBundle);
+                if (!result) {
+                    throw new Error("Failed to inject wallet export bundle");
+                }
+                return result;
+            }
+        });
+        Object.defineProperty(this, "pollActivityCompletion", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async (activity, organizationId, resultKey) => {
+                if (activity.status === "ACTIVITY_STATUS_COMPLETED") {
+                    return activity.result[resultKey];
+                }
+                const { activity: { status, id, result }, } = await this.turnkeyClient.getActivity({
+                    activityId: activity.id,
+                    organizationId,
+                });
+                if (status === "ACTIVITY_STATUS_COMPLETED") {
+                    return result[resultKey];
+                }
+                if (status === "ACTIVITY_STATUS_FAILED" ||
+                    status === "ACTIVITY_STATUS_REJECTED" ||
+                    status === "ACTIVITY_STATUS_CONSENSUS_NEEDED") {
+                    throw new Error(`Failed to get activity with with id ${id} (status: ${status})`);
+                }
+                await new Promise((resolve) => setTimeout(resolve, 500));
+                return this.pollActivityCompletion(activity, organizationId, resultKey);
+            }
+        });
+        const { stamper, connection, rootOrgId } = params;
+        this.rootOrg = rootOrgId ?? "24c1acf5-810f-41e0-a503-d5d13fa8e830";
+        this.eventEmitter = new EventEmitter();
+        this.connectionConfig = ConnectionConfigSchema.parse(connection);
+        this.turnkeyClient = new TurnkeyClient({ baseUrl: "https://api.turnkey.com" }, stamper);
+    }
+    get user() {
+        return this._user;
+    }
+    set user(user) {
+        if (user && !this._user) {
+            this.eventEmitter.emit("connected", user);
+        }
+        else if (!user && this._user) {
+            this.eventEmitter.emit("disconnected");
+        }
+        this._user = user;
+    }
+    setStamper(stamper) {
+        this.turnkeyClient.stamper = stamper;
+    }
+    exportWalletInner(params) {
+        switch (params.exportAs) {
+            case "PRIVATE_KEY":
+                return this.exportAsPrivateKey(params.exportStamper);
+            case "SEED_PHRASE":
+                return this.exportAsSeedPhrase(params.exportStamper);
+        }
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/client/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/client/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,YAAY,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AA2B9D,MAAM,OAAgB,gBAAgB;IAOpC,YAAY,MAA8B;QANlC;;;;;WAAwB;QACxB;;;;;WAAmC;QACjC;;;;;WAA6B;QAC7B;;;;;WAAgB;QAChB;;;;;WAAsD;QAiFzD;;;;mBAAK,CACV,KAAQ,EACR,QAAsC,EACtC,EAAE;gBACF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,QAAe,CAAC,CAAC;gBAE7C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,KAAK,EAAE,QAAe,CAAC,CAAC;YACxE,CAAC;WAAC;QAEK;;;;mBAAa,KAAK,EAAE,OAAkC,EAAE,EAAE;gBAC/D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACf,MAAM,IAAI,qBAAqB,EAAE,CAAC;gBACpC,CAAC;gBACD,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAClE,OAAO,CACR,CAAC;gBAEF,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC;oBACjE,IAAI,EAAE,wCAAwC;oBAC9C,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;oBAClC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;oBAC/B,UAAU,EAAE;wBACV,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;wBACxB,cAAc,EAAE;4BACd;gCACE,WAAW;gCACX,iBAAiB,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE;gCACrD,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC;6BACtC;yBACF;qBACF;iBACF,CAAC,CAAC;gBAEH,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAC5D,QAAQ,EACR,IAAI,CAAC,IAAI,CAAC,KAAK,EACf,4BAA4B,CAC7B,CAAC;gBAEF,OAAO,gBAAgB,CAAC;YAC1B,CAAC;WAAC;QAEK;;;;mBAAS,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAiB,EAAE;gBAChE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACd,OAAO,IAAI,CAAC,IAAI,CAAC;gBACnB,CAAC;gBAED,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;gBACvC,CAAC;gBAED,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC;oBAC7D,cAAc,EAAE,KAAK;iBACtB,CAAC,CAAC;gBAEH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;oBAC5C,cAAc;iBACf,CAAC,CAAC;gBAEH,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE;oBACzB,IAAI,CAAC;wBACH,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC;6BACtD,YAAsB,CAAC;oBAC5B,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,OAAO,SAAS,CAAC;oBACnB,CAAC;gBACH,CAAC,CAAC,EAAE,CAAC;gBAEL,IAAI,CAAC,IAAI,GAAG;oBACV,GAAG,IAAI;oBACP,YAAY;iBACb,CAAC;gBAEF,OAAO,IAAI,CAAC,IAAI,CAAC;YACnB,CAAC;WAAC;QAEK;;;;mBAAoB,KAAK,EAAE,KAAa,EAAE,EAAE;gBACjD,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/C,CAAC;WAAC;QAUK;;;;mBAAiB,KAAK,EAAE,GAAQ,EAAE,EAAE;gBACzC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACf,MAAM,IAAI,qBAAqB,EAAE,CAAC;gBACpC,CAAC;gBAED,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC;oBAClE,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;oBAC/B,IAAI,EAAE,mCAAmC;oBACzC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;oBAClC,UAAU,EAAE;wBACV,QAAQ,EAAE,8BAA8B;wBACxC,YAAY,EAAE,qBAAqB;wBACnC,OAAO,EAAE,GAAG;wBACZ,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;qBAC5B;iBACF,CAAC,CAAC;gBAEH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE;oBAC3D,cAAc;iBACf,CAAC,CAAC;gBAEH,OAAO,SAAS,CAAC;YACnB,CAAC;WAAC;QAEK;;;;mBAAU,GAAgB,EAAE;gBACjC,OAAO,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;YAC3B,CAAC;WAAC;QAEK;;;;mBAAU,KAAK,EACpB,KAAQ,EACR,IAAmB,EACS,EAAE;gBAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,IAAI,2BAA2B,CAAC;gBACxE,MAAM,QAAQ,GAAG,SAAS,CAAC;gBAE3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC9B,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;gBACnD,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;oBACjC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,UAAU,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC5E,CAAC;qBAAM,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC;oBACrC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,UAAU,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC;gBACzE,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,GAAG,QAAQ,GAAG,KAAK,EAAE,EAAE;oBACxD,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAC1B,OAAO;iBACR,CAAC,CAAC;gBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;gBACzC,CAAC;gBAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAEnC,OAAO,IAAyB,CAAC;YACnC,CAAC;WAAC;QAKM;;;;mBAAqB,KAAK,EAAE,OAA4B,EAAE,EAAE;gBAClE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACf,MAAM,IAAI,qBAAqB,EAAE,CAAC;gBACpC,CAAC;gBAED,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;oBACtD,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;iBAChC,CAAC,CAAC;gBAEH,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,CACtC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAC3B,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC;oBACnC,cAAc,EAAE,IAAI,CAAC,IAAK,CAAC,KAAK;oBAChC,QAAQ;iBACT,CAAC,CACH,CACF,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAE5C,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,IAAK,CAAC,OAAO,CACxC,CAAC;gBAEF,IAAI,CAAC,aAAa,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CACb,yCAAyC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAC7D,CAAC;gBACJ,CAAC;gBAED,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC;oBACzD,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;oBAC/B,IAAI,EAAE,6BAA6B;oBACnC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;oBAClC,UAAU,EAAE;wBACV,QAAQ,EAAE,aAAc,CAAC,QAAQ;wBACjC,eAAe,EAAE,OAAO,CAAC,SAAS,EAAG;qBACtC;iBACF,CAAC,CAAC;gBAEH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,sBAAsB,CACxD,QAAQ,EACR,IAAI,CAAC,IAAI,CAAC,KAAK,EACf,oBAAoB,CACrB,CAAC;gBAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC;gBAEpE,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;gBAC3D,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC;WAAC;QAEM;;;;mBAAqB,KAAK,EAAE,OAA4B,EAAE,EAAE;gBAClE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACf,MAAM,IAAI,qBAAqB,EAAE,CAAC;gBACpC,CAAC;gBAED,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC;oBAChE,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;oBAC/B,IAAI,EAAE,qCAAqC;oBAC3C,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;oBAClC,UAAU,EAAE;wBACV,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;wBAC1B,eAAe,EAAE,OAAO,CAAC,SAAS,EAAG;qBACtC;iBACF,CAAC,CAAC;gBAEH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,sBAAsB,CACxD,QAAQ,EACR,IAAI,CAAC,IAAI,CAAC,KAAK,EACf,2BAA2B,CAC5B,CAAC;gBAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC;gBAEjE,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;gBAC3D,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC;WAAC;QAEQ;;;;mBAAyB,KAAK,EAKtC,QAEa,EACb,cAAsB,EACtB,SAAY,EAOZ,EAAE;gBACF,IAAI,QAAQ,CAAC,MAAM,KAAK,2BAA2B,EAAE,CAAC;oBACpD,OAAO,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAE,CAAC;gBACrC,CAAC;gBAED,MAAM,EACJ,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GACjC,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC;oBACvC,UAAU,EAAE,QAAQ,CAAC,EAAE;oBACvB,cAAc;iBACf,CAAC,CAAC;gBAEH,IAAI,MAAM,KAAK,2BAA2B,EAAE,CAAC;oBAC3C,OAAO,MAAM,CAAC,SAAS,CAAE,CAAC;gBAC5B,CAAC;gBAED,IACE,MAAM,KAAK,wBAAwB;oBACnC,MAAM,KAAK,0BAA0B;oBACrC,MAAM,KAAK,kCAAkC,EAC7C,CAAC;oBACD,MAAM,IAAI,KAAK,CACb,uCAAuC,EAAE,aAAa,MAAM,GAAG,CAChE,CAAC;gBACJ,CAAC;gBAGD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;gBAEzD,OAAO,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;YAC1E,CAAC;WAAC;QApWA,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAElD,IAAI,CAAC,OAAO,GAAG,SAAS,IAAI,sCAAsC,CAAC;QACnE,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,EAA6B,CAAC;QAClE,IAAI,CAAC,gBAAgB,GAAG,sBAAsB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACjE,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CACpC,EAAE,OAAO,EAAE,yBAAyB,EAAE,EACtC,OAAO,CACR,CAAC;IACJ,CAAC;IAED,IAAc,IAAI;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAc,IAAI,CAAC,IAAsB;QACvC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAES,UAAU,CAAC,OAAiC;QACpD,IAAI,CAAC,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC;IACvC,CAAC;IAES,iBAAiB,CAAC,MAG3B;QACC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACvD,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CA+TF","sourcesContent":["import { type ConnectionConfig, ConnectionConfigSchema } from \"@aa-sdk/core\";\nimport { TurnkeyClient } from \"@turnkey/http\";\nimport EventEmitter from \"eventemitter3\";\nimport type { Hex } from \"viem\";\nimport { NotAuthenticatedError } from \"../errors.js\";\nimport { base64UrlEncode } from \"../utils/base64UrlEncode.js\";\nimport type {\n  AlchemySignerClientEvent,\n  AlchemySignerClientEvents,\n  CreateAccountParams,\n  EmailAuthParams,\n  GetWebAuthnAttestationResult,\n  SignerBody,\n  SignerResponse,\n  SignerRoutes,\n  SignupResponse,\n  User,\n} from \"./types.js\";\n\nexport interface BaseSignerClientParams {\n  stamper: TurnkeyClient[\"stamper\"];\n  connection: ConnectionConfig;\n  rootOrgId?: string;\n  rpId?: string;\n}\n\nexport type ExportWalletStamper = TurnkeyClient[\"stamper\"] & {\n  injectWalletExportBundle(bundle: string): Promise<boolean>;\n  injectKeyExportBundle(bundle: string): Promise<boolean>;\n  publicKey(): string | null;\n};\n\nexport abstract class BaseSignerClient<TExportWalletParams = unknown> {\n  private _user: User | undefined;\n  private connectionConfig: ConnectionConfig;\n  protected turnkeyClient: TurnkeyClient;\n  protected rootOrg: string;\n  protected eventEmitter: EventEmitter<AlchemySignerClientEvents>;\n\n  constructor(params: BaseSignerClientParams) {\n    const { stamper, connection, rootOrgId } = params;\n\n    this.rootOrg = rootOrgId ?? \"24c1acf5-810f-41e0-a503-d5d13fa8e830\";\n    this.eventEmitter = new EventEmitter<AlchemySignerClientEvents>();\n    this.connectionConfig = ConnectionConfigSchema.parse(connection);\n    this.turnkeyClient = new TurnkeyClient(\n      { baseUrl: \"https://api.turnkey.com\" },\n      stamper\n    );\n  }\n\n  protected get user() {\n    return this._user;\n  }\n\n  protected set user(user: User | undefined) {\n    if (user && !this._user) {\n      this.eventEmitter.emit(\"connected\", user);\n    } else if (!user && this._user) {\n      this.eventEmitter.emit(\"disconnected\");\n    }\n\n    this._user = user;\n  }\n\n  protected setStamper(stamper: TurnkeyClient[\"stamper\"]) {\n    this.turnkeyClient.stamper = stamper;\n  }\n\n  protected exportWalletInner(params: {\n    exportStamper: ExportWalletStamper;\n    exportAs: \"SEED_PHRASE\" | \"PRIVATE_KEY\";\n  }): Promise<boolean> {\n    switch (params.exportAs) {\n      case \"PRIVATE_KEY\":\n        return this.exportAsPrivateKey(params.exportStamper);\n      case \"SEED_PHRASE\":\n        return this.exportAsSeedPhrase(params.exportStamper);\n    }\n  }\n\n  // #region ABSTRACT METHODS\n\n  public abstract createAccount(\n    params: CreateAccountParams\n  ): Promise<SignupResponse>;\n\n  public abstract initEmailAuth(\n    params: Omit<EmailAuthParams, \"targetPublicKey\">\n  ): Promise<{ orgId: string }>;\n\n  public abstract completeEmailAuth(params: {\n    bundle: string;\n    orgId: string;\n  }): Promise<User>;\n\n  public abstract disconnect(): Promise<void>;\n\n  public abstract exportWallet(params: TExportWalletParams): Promise<boolean>;\n\n  public abstract lookupUserWithPasskey(user?: User): Promise<User>;\n\n  protected abstract getWebAuthnAttestation(\n    options: CredentialCreationOptions,\n    userDetails?: { username: string }\n  ): Promise<GetWebAuthnAttestationResult>;\n\n  // #endregion\n\n  // #region PUBLIC METHODS\n\n  /**\n   * Listen to events emitted by the client\n   *\n   * @param event the event you want to listen to\n   * @param listener the callback function to execute when an event is fired\n   * @returns a function that will remove the listener when called\n   */\n  public on = <E extends AlchemySignerClientEvent>(\n    event: E,\n    listener: AlchemySignerClientEvents[E]\n  ) => {\n    this.eventEmitter.on(event, listener as any);\n\n    return () => this.eventEmitter.removeListener(event, listener as any);\n  };\n\n  public addPasskey = async (options: CredentialCreationOptions) => {\n    if (!this.user) {\n      throw new NotAuthenticatedError();\n    }\n    const { attestation, challenge } = await this.getWebAuthnAttestation(\n      options\n    );\n\n    const { activity } = await this.turnkeyClient.createAuthenticators({\n      type: \"ACTIVITY_TYPE_CREATE_AUTHENTICATORS_V2\",\n      timestampMs: Date.now().toString(),\n      organizationId: this.user.orgId,\n      parameters: {\n        userId: this.user.userId,\n        authenticators: [\n          {\n            attestation,\n            authenticatorName: `passkey-${Date.now().toString()}`,\n            challenge: base64UrlEncode(challenge),\n          },\n        ],\n      },\n    });\n\n    const { authenticatorIds } = await this.pollActivityCompletion(\n      activity,\n      this.user.orgId,\n      \"createAuthenticatorsResult\"\n    );\n\n    return authenticatorIds;\n  };\n\n  public whoami = async (orgId = this.user?.orgId): Promise<User> => {\n    if (this.user) {\n      return this.user;\n    }\n\n    if (!orgId) {\n      throw new Error(\"No orgId provided\");\n    }\n\n    const stampedRequest = await this.turnkeyClient.stampGetWhoami({\n      organizationId: orgId,\n    });\n\n    const user = await this.request(\"/v1/whoami\", {\n      stampedRequest,\n    });\n\n    const credentialId = (() => {\n      try {\n        return JSON.parse(stampedRequest?.stamp.stampHeaderValue)\n          .credentialId as string;\n      } catch (e) {\n        return undefined;\n      }\n    })();\n\n    this.user = {\n      ...user,\n      credentialId,\n    };\n\n    return this.user;\n  };\n\n  public lookupUserByEmail = async (email: string) => {\n    return this.request(\"/v1/lookup\", { email });\n  };\n\n  /**\n   * This will sign a message with the user's private key, without doing any transformations on the message.\n   * For SignMessage or SignTypedData, the caller should hash the message before calling this method and pass\n   * that result here.\n   *\n   * @param msg the hex representation of the bytes to sign\n   * @returns the signature over the raw hex\n   */\n  public signRawMessage = async (msg: Hex) => {\n    if (!this.user) {\n      throw new NotAuthenticatedError();\n    }\n\n    const stampedRequest = await this.turnkeyClient.stampSignRawPayload({\n      organizationId: this.user.orgId,\n      type: \"ACTIVITY_TYPE_SIGN_RAW_PAYLOAD_V2\",\n      timestampMs: Date.now().toString(),\n      parameters: {\n        encoding: \"PAYLOAD_ENCODING_HEXADECIMAL\",\n        hashFunction: \"HASH_FUNCTION_NO_OP\",\n        payload: msg,\n        signWith: this.user.address,\n      },\n    });\n\n    const { signature } = await this.request(\"/v1/sign-payload\", {\n      stampedRequest,\n    });\n\n    return signature;\n  };\n\n  public getUser = (): User | null => {\n    return this.user ?? null;\n  };\n\n  public request = async <R extends SignerRoutes>(\n    route: R,\n    body: SignerBody<R>\n  ): Promise<SignerResponse<R>> => {\n    const url = this.connectionConfig.rpcUrl ?? \"https://api.g.alchemy.com\";\n    const basePath = \"/signer\";\n\n    const headers = new Headers();\n    headers.append(\"Content-Type\", \"application/json\");\n    if (this.connectionConfig.apiKey) {\n      headers.append(\"Authorization\", `Bearer ${this.connectionConfig.apiKey}`);\n    } else if (this.connectionConfig.jwt) {\n      headers.append(\"Authorization\", `Bearer ${this.connectionConfig.jwt}`);\n    }\n\n    const response = await fetch(`${url}${basePath}${route}`, {\n      method: \"POST\",\n      body: JSON.stringify(body),\n      headers,\n    });\n\n    if (!response.ok) {\n      throw new Error(await response.text());\n    }\n\n    const json = await response.json();\n\n    return json as SignerResponse<R>;\n  };\n\n  // #endregion\n\n  // #region PRIVATE METHODS\n  private exportAsSeedPhrase = async (stamper: ExportWalletStamper) => {\n    if (!this.user) {\n      throw new NotAuthenticatedError();\n    }\n\n    const { wallets } = await this.turnkeyClient.getWallets({\n      organizationId: this.user.orgId,\n    });\n\n    const walletAccounts = await Promise.all(\n      wallets.map(({ walletId }) =>\n        this.turnkeyClient.getWalletAccounts({\n          organizationId: this.user!.orgId,\n          walletId,\n        })\n      )\n    ).then((x) => x.flatMap((x) => x.accounts));\n\n    const walletAccount = walletAccounts.find(\n      (x) => x.address === this.user!.address\n    );\n\n    if (!walletAccount) {\n      throw new Error(\n        `Could not find wallet associated with ${this.user.address}`\n      );\n    }\n\n    const { activity } = await this.turnkeyClient.exportWallet({\n      organizationId: this.user.orgId,\n      type: \"ACTIVITY_TYPE_EXPORT_WALLET\",\n      timestampMs: Date.now().toString(),\n      parameters: {\n        walletId: walletAccount!.walletId,\n        targetPublicKey: stamper.publicKey()!,\n      },\n    });\n\n    const { exportBundle } = await this.pollActivityCompletion(\n      activity,\n      this.user.orgId,\n      \"exportWalletResult\"\n    );\n\n    const result = await stamper.injectWalletExportBundle(exportBundle);\n\n    if (!result) {\n      throw new Error(\"Failed to inject wallet export bundle\");\n    }\n\n    return result;\n  };\n\n  private exportAsPrivateKey = async (stamper: ExportWalletStamper) => {\n    if (!this.user) {\n      throw new NotAuthenticatedError();\n    }\n\n    const { activity } = await this.turnkeyClient.exportWalletAccount({\n      organizationId: this.user.orgId,\n      type: \"ACTIVITY_TYPE_EXPORT_WALLET_ACCOUNT\",\n      timestampMs: Date.now().toString(),\n      parameters: {\n        address: this.user.address,\n        targetPublicKey: stamper.publicKey()!,\n      },\n    });\n\n    const { exportBundle } = await this.pollActivityCompletion(\n      activity,\n      this.user.orgId,\n      \"exportWalletAccountResult\"\n    );\n\n    const result = await stamper.injectKeyExportBundle(exportBundle);\n\n    if (!result) {\n      throw new Error(\"Failed to inject wallet export bundle\");\n    }\n\n    return result;\n  };\n\n  protected pollActivityCompletion = async <\n    T extends keyof Awaited<\n      ReturnType<(typeof this.turnkeyClient)[\"getActivity\"]>\n    >[\"activity\"][\"result\"]\n  >(\n    activity: Awaited<\n      ReturnType<(typeof this.turnkeyClient)[\"getActivity\"]>\n    >[\"activity\"],\n    organizationId: string,\n    resultKey: T\n  ): Promise<\n    NonNullable<\n      Awaited<\n        ReturnType<(typeof this.turnkeyClient)[\"getActivity\"]>\n      >[\"activity\"][\"result\"][T]\n    >\n  > => {\n    if (activity.status === \"ACTIVITY_STATUS_COMPLETED\") {\n      return activity.result[resultKey]!;\n    }\n\n    const {\n      activity: { status, id, result },\n    } = await this.turnkeyClient.getActivity({\n      activityId: activity.id,\n      organizationId,\n    });\n\n    if (status === \"ACTIVITY_STATUS_COMPLETED\") {\n      return result[resultKey]!;\n    }\n\n    if (\n      status === \"ACTIVITY_STATUS_FAILED\" ||\n      status === \"ACTIVITY_STATUS_REJECTED\" ||\n      status === \"ACTIVITY_STATUS_CONSENSUS_NEEDED\"\n    ) {\n      throw new Error(\n        `Failed to get activity with with id ${id} (status: ${status})`\n      );\n    }\n\n    // TODO: add ability to configure this + add exponential backoff\n    await new Promise((resolve) => setTimeout(resolve, 500));\n\n    return this.pollActivityCompletion(activity, organizationId, resultKey);\n  };\n  // #endregion\n}\n"]}

package/dist/esm/client/index.d.ts

@@ -0,0 +1,146 @@
+import { z } from "zod";
+import { BaseSignerClient } from "./base.js";
+import type { CreateAccountParams, CredentialCreationOptionOverrides, EmailAuthParams, ExportWalletParams, User } from "./types.js";
+export declare const AlchemySignerClientParamsSchema: z.ZodObject<{
+    connection: z.ZodUnion<[z.ZodObject<{
+        rpcUrl: z.ZodOptional<z.ZodNever>;
+        apiKey: z.ZodString;
+        jwt: z.ZodOptional<z.ZodNever>;
+    }, "strip", z.ZodTypeAny, {
+        apiKey: string;
+        rpcUrl?: undefined;
+        jwt?: undefined;
+    }, {
+        apiKey: string;
+        rpcUrl?: undefined;
+        jwt?: undefined;
+    }>, z.ZodObject<{
+        rpcUrl: z.ZodOptional<z.ZodNever>;
+        apiKey: z.ZodOptional<z.ZodNever>;
+        jwt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        jwt: string;
+        rpcUrl?: undefined;
+        apiKey?: undefined;
+    }, {
+        jwt: string;
+        rpcUrl?: undefined;
+        apiKey?: undefined;
+    }>, z.ZodObject<{
+        rpcUrl: z.ZodString;
+        apiKey: z.ZodOptional<z.ZodNever>;
+        jwt: z.ZodOptional<z.ZodNever>;
+    }, "strip", z.ZodTypeAny, {
+        rpcUrl: string;
+        apiKey?: undefined;
+        jwt?: undefined;
+    }, {
+        rpcUrl: string;
+        apiKey?: undefined;
+        jwt?: undefined;
+    }>, z.ZodObject<{
+        rpcUrl: z.ZodString;
+        apiKey: z.ZodOptional<z.ZodNever>;
+        jwt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        rpcUrl: string;
+        jwt: string;
+        apiKey?: undefined;
+    }, {
+        rpcUrl: string;
+        jwt: string;
+        apiKey?: undefined;
+    }>]>;
+    iframeConfig: z.ZodObject<{
+        iframeElementId: z.ZodDefault<z.ZodString>;
+        iframeContainerId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        iframeElementId: string;
+        iframeContainerId: string;
+    }, {
+        iframeContainerId: string;
+        iframeElementId?: string | undefined;
+    }>;
+    rpId: z.ZodOptional<z.ZodString>;
+    rootOrgId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    connection: {
+        apiKey: string;
+        rpcUrl?: undefined;
+        jwt?: undefined;
+    } | {
+        jwt: string;
+        rpcUrl?: undefined;
+        apiKey?: undefined;
+    } | {
+        rpcUrl: string;
+        apiKey?: undefined;
+        jwt?: undefined;
+    } | {
+        rpcUrl: string;
+        jwt: string;
+        apiKey?: undefined;
+    };
+    rootOrgId: string;
+    iframeConfig: {
+        iframeElementId: string;
+        iframeContainerId: string;
+    };
+    rpId?: string | undefined;
+}, {
+    connection: {
+        apiKey: string;
+        rpcUrl?: undefined;
+        jwt?: undefined;
+    } | {
+        jwt: string;
+        rpcUrl?: undefined;
+        apiKey?: undefined;
+    } | {
+        rpcUrl: string;
+        apiKey?: undefined;
+        jwt?: undefined;
+    } | {
+        rpcUrl: string;
+        jwt: string;
+        apiKey?: undefined;
+    };
+    iframeConfig: {
+        iframeContainerId: string;
+        iframeElementId?: string | undefined;
+    };
+    rpId?: string | undefined;
+    rootOrgId?: string | undefined;
+}>;
+export type AlchemySignerClientParams = z.input<typeof AlchemySignerClientParamsSchema>;
+export declare class AlchemySignerWebClient extends BaseSignerClient<ExportWalletParams> {
+    private iframeStamper;
+    private webauthnStamper;
+    iframeContainerId: string;
+    constructor(params: AlchemySignerClientParams);
+    createAccount: (params: CreateAccountParams) => Promise<import("./types.js").SignupResponse>;
+    initEmailAuth: (params: Omit<EmailAuthParams, "targetPublicKey">) => Promise<{
+        orgId: string;
+    }>;
+    completeEmailAuth: ({ bundle, orgId, }: {
+        bundle: string;
+        orgId: string;
+    }) => Promise<User>;
+    lookupUserWithPasskey: (user?: User | undefined) => Promise<User>;
+    exportWallet: ({ iframeContainerId, iframeElementId, }: ExportWalletParams) => Promise<boolean>;
+    disconnect: () => Promise<void>;
+    private initIframeStamper;
+    private initWebauthnStamper;
+    protected getWebAuthnAttestation: (options?: CredentialCreationOptionOverrides, userDetails?: {
+        username: string;
+    }) => Promise<{
+        challenge: ArrayBuffer;
+        authenticatorUserId: ArrayBuffer;
+        attestation: {
+            credentialId: string;
+            clientDataJson: string;
+            attestationObject: string;
+            transports: ("AUTHENTICATOR_TRANSPORT_BLE" | "AUTHENTICATOR_TRANSPORT_INTERNAL" | "AUTHENTICATOR_TRANSPORT_NFC" | "AUTHENTICATOR_TRANSPORT_USB" | "AUTHENTICATOR_TRANSPORT_HYBRID")[];
+        };
+    }>;
+}