@n1xyz/wallet-widget 0.0.35-alpha.0 → 0.0.35-alpha.1

package/dist/src/turnkey/createWalletProvider.js

@@ -0,0 +1,286 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { Chain, WalletInterfaceType, } from "@turnkey/core";
+import { logger } from "../utils/logger";
+import { createTurnkeyError } from "../utils/errors";
+import { normalizeChainId } from "../utils/chain";
+var normalizeMessage = function (value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (value instanceof Uint8Array) {
+        return ("0x" +
+            Array.from(value)
+                .map(function (byte) { return byte.toString(16).padStart(2, "0"); })
+                .join(""));
+    }
+    if (value &&
+        typeof value === "object" &&
+        value.type === "Buffer") {
+        var bufferValue = value;
+        if (!Array.isArray(bufferValue.data)) {
+            throw new Error("Invalid buffer payload");
+        }
+        var dataArray = bufferValue.data;
+        return ("0x" +
+            dataArray
+                .map(function (byte) { return byte.toString(16).padStart(2, "0"); })
+                .join(""));
+    }
+    if (typeof value === "number" || typeof value === "bigint") {
+        return "0x".concat(value.toString(16));
+    }
+    if (typeof value === "boolean") {
+        return value ? "0x1" : "0x0";
+    }
+    throw new Error("Unsupported payload type for personal_sign");
+};
+var getSignature = function (wallet, message) { return __awaiter(void 0, void 0, void 0, function () {
+    var startTime, signStartTime, sig, signDuration, signStartTime, sig, signDuration;
+    var _a, _b, _c, _d;
+    return __generator(this, function (_e) {
+        switch (_e.label) {
+            case 0:
+                startTime = Date.now();
+                logger.debug("[Turnkey] [getSignature] Starting", {
+                    walletAddress: ((_a = wallet.address) === null || _a === void 0 ? void 0 : _a.substring(0, 10)) + "...",
+                    messageLength: message.length,
+                    hasSignMessage: typeof wallet.signMessage === "function",
+                    hasConnectorSignMessage: typeof ((_b = wallet.connector) === null || _b === void 0 ? void 0 : _b.signMessage) === "function",
+                });
+                if (!(typeof wallet.signMessage === "function")) return [3 /*break*/, 2];
+                logger.debug("[Turnkey] [getSignature] Using wallet.signMessage");
+                signStartTime = Date.now();
+                return [4 /*yield*/, wallet.signMessage(message)];
+            case 1:
+                sig = _e.sent();
+                signDuration = Date.now() - signStartTime;
+                if (sig) {
+                    logger.debug("[Turnkey] [getSignature] Signature obtained from wallet.signMessage", {
+                        signatureLength: sig.length,
+                        signDuration: "".concat(signDuration, "ms"),
+                        totalDuration: "".concat(Date.now() - startTime, "ms"),
+                    });
+                    return [2 /*return*/, sig];
+                }
+                logger.debug("[Turnkey] [getSignature] wallet.signMessage returned no signature");
+                _e.label = 2;
+            case 2:
+                if (!(typeof ((_c = wallet.connector) === null || _c === void 0 ? void 0 : _c.signMessage) === "function")) return [3 /*break*/, 4];
+                logger.debug("[Turnkey] [getSignature] Using connector.signMessage");
+                signStartTime = Date.now();
+                return [4 /*yield*/, wallet.connector.signMessage(message, (_d = wallet.address) !== null && _d !== void 0 ? _d : undefined)];
+            case 3:
+                sig = _e.sent();
+                signDuration = Date.now() - signStartTime;
+                if (sig) {
+                    logger.debug("[Turnkey] [getSignature] Signature obtained from connector.signMessage", {
+                        signatureLength: sig.length,
+                        signDuration: "".concat(signDuration, "ms"),
+                        totalDuration: "".concat(Date.now() - startTime, "ms"),
+                    });
+                    return [2 /*return*/, sig];
+                }
+                logger.debug("[Turnkey] [getSignature] connector.signMessage returned no signature");
+                _e.label = 4;
+            case 4:
+                logger.logError(createTurnkeyError('SIGNATURE_FAILED', 'Wallet does not support message signing', {
+                    context: { totalDuration: "".concat(Date.now() - startTime, "ms") },
+                }));
+                throw new Error("Wallet does not support message signing");
+        }
+    });
+}); };
+var createRequestHandler = function (wallet, chainId) {
+    return function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+        var startTime, _c, looksLikeAddress, first, second, shouldSwap, payloadSource, payload, signature;
+        var _d;
+        var method = _b.method, params = _b.params;
+        return __generator(this, function (_e) {
+            switch (_e.label) {
+                case 0:
+                    startTime = Date.now();
+                    logger.debug("[Turnkey] [createRequestHandler] Request received", {
+                        method: method,
+                        hasParams: Boolean(params),
+                        paramsLength: params === null || params === void 0 ? void 0 : params.length,
+                        walletAddress: ((_d = wallet.address) === null || _d === void 0 ? void 0 : _d.substring(0, 10)) + "...",
+                        chainId: chainId,
+                    });
+                    _c = method;
+                    switch (_c) {
+                        case "eth_requestAccounts": return [3 /*break*/, 1];
+                        case "eth_accounts": return [3 /*break*/, 1];
+                        case "eth_chainId": return [3 /*break*/, 2];
+                        case "personal_sign": return [3 /*break*/, 3];
+                    }
+                    return [3 /*break*/, 5];
+                case 1:
+                    {
+                        if (!wallet.address) {
+                            logger.logError(createTurnkeyError('AUTH_FAILED', 'Wallet not connected', {
+                                context: { method: method },
+                            }));
+                            throw new Error("Wallet is not connected to an address");
+                        }
+                        logger.debug("[Turnkey] [createRequestHandler] Returning accounts", {
+                            method: method,
+                            duration: "".concat(Date.now() - startTime, "ms"),
+                        });
+                        return [2 /*return*/, [wallet.address]];
+                    }
+                    _e.label = 2;
+                case 2:
+                    logger.debug("[Turnkey] [createRequestHandler] Returning chain ID", {
+                        method: method,
+                        chainId: chainId,
+                        duration: "".concat(Date.now() - startTime, "ms"),
+                    });
+                    return [2 /*return*/, chainId];
+                case 3:
+                    if (!params || params.length === 0) {
+                        logger.logError(createTurnkeyError('SIGNATURE_FAILED', 'Missing payload for personal_sign', {
+                            context: { method: method },
+                        }));
+                        throw new Error("Missing payload for personal_sign");
+                    }
+                    looksLikeAddress = function (value) {
+                        return typeof value === "string" && /^0x[a-fA-F0-9]{40}$/i.test(value);
+                    };
+                    first = params[0], second = params[1];
+                    shouldSwap = looksLikeAddress(first) && typeof second !== "undefined";
+                    payloadSource = shouldSwap ? second : first;
+                    logger.debug("[Turnkey] [createRequestHandler] Normalizing message for signing", {
+                        method: method,
+                        paramsType: typeof payloadSource,
+                        swapped: shouldSwap,
+                    });
+                    payload = normalizeMessage(payloadSource);
+                    logger.debug("[Turnkey] [createRequestHandler] Getting signature", {
+                        method: method,
+                        payloadLength: payload.length,
+                    });
+                    return [4 /*yield*/, getSignature(wallet, payload)];
+                case 4:
+                    signature = _e.sent();
+                    logger.debug("[Turnkey] [createRequestHandler] Signature obtained", {
+                        method: method,
+                        signatureLength: signature.length,
+                        duration: "".concat(Date.now() - startTime, "ms"),
+                    });
+                    return [2 /*return*/, signature];
+                case 5:
+                    logger.logError(createTurnkeyError('AUTH_FAILED', "Unsupported provider method: ".concat(method), {
+                        context: { method: method, duration: "".concat(Date.now() - startTime, "ms") },
+                    }));
+                    throw new Error("Unsupported provider method: ".concat(method));
+            }
+        });
+    }); };
+};
+/**
+ * Builds a Turnkey WalletProvider from a Dynamic EVM wallet.
+ * Normalizes chain IDs, handles eth_requestAccounts/eth_chainId/personal_sign methods,
+ * and extracts wallet metadata for Turnkey authentication.
+ */
+export function buildWalletProvider(wallet) {
+    return __awaiter(this, void 0, void 0, function () {
+        var startTime, getNetworkStartTime, network, getNetworkDuration, chainId, infoName, eip1193Provider, result, totalDuration;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        return __generator(this, function (_k) {
+            switch (_k.label) {
+                case 0:
+                    startTime = Date.now();
+                    logger.debug("[Turnkey] [buildWalletProvider] Starting", {
+                        hasWallet: Boolean(wallet),
+                        hasAddress: Boolean(wallet === null || wallet === void 0 ? void 0 : wallet.address),
+                        hasConnector: Boolean(wallet === null || wallet === void 0 ? void 0 : wallet.connector),
+                        walletAddress: ((_a = wallet === null || wallet === void 0 ? void 0 : wallet.address) === null || _a === void 0 ? void 0 : _a.substring(0, 10)) + "...",
+                    });
+                    if (!(wallet === null || wallet === void 0 ? void 0 : wallet.address)) {
+                        logger.logError(createTurnkeyError('CONFIG_MISSING', 'Wallet is missing an address'));
+                        throw new Error("Wallet is missing an address");
+                    }
+                    if (!wallet.connector) {
+                        logger.logError(createTurnkeyError('CONFIG_MISSING', 'Wallet connector is not available'));
+                        throw new Error("Wallet connector is not available");
+                    }
+                    getNetworkStartTime = Date.now();
+                    return [4 /*yield*/, ((_c = (_b = wallet.connector).getNetwork) === null || _c === void 0 ? void 0 : _c.call(_b))];
+                case 1:
+                    network = (_e = (_d = (_k.sent())) !== null && _d !== void 0 ? _d : wallet.chain) !== null && _e !== void 0 ? _e : null;
+                    getNetworkDuration = Date.now() - getNetworkStartTime;
+                    logger.debug("[Turnkey] [buildWalletProvider] Got network", {
+                        network: network,
+                        getNetworkDuration: "".concat(getNetworkDuration, "ms"),
+                    });
+                    chainId = normalizeChainId(network);
+                    infoName = (_f = wallet.connector.name) !== null && _f !== void 0 ? _f : "Connected Wallet";
+                    logger.debug("[Turnkey] [buildWalletProvider] Normalized chain ID", {
+                        chainId: chainId,
+                        infoName: infoName,
+                    });
+                    eip1193Provider = {
+                        request: createRequestHandler(wallet, chainId),
+                    };
+                    result = {
+                        interfaceType: WalletInterfaceType.Ethereum,
+                        chainInfo: {
+                            namespace: Chain.Ethereum,
+                            chainId: chainId,
+                        },
+                        info: {
+                            name: infoName,
+                            uuid: (_h = (_g = wallet.id) !== null && _g !== void 0 ? _g : wallet.key) !== null && _h !== void 0 ? _h : wallet.connector.key,
+                            icon: (_j = wallet.connector.metadata) === null || _j === void 0 ? void 0 : _j.icon,
+                        },
+                        provider: eip1193Provider,
+                        connectedAddresses: [wallet.address],
+                    };
+                    totalDuration = Date.now() - startTime;
+                    logger.debug("[Turnkey] [buildWalletProvider] Completed", {
+                        chainId: chainId,
+                        infoName: infoName,
+                        uuid: result.info.uuid,
+                        totalDuration: "".concat(totalDuration, "ms"),
+                    });
+                    return [2 /*return*/, result];
+            }
+        });
+    });
+}
+//# sourceMappingURL=createWalletProvider.js.map

package/dist/src/turnkey/createWalletProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWalletProvider.js","sourceRoot":"","sources":["../../../src/turnkey/createWalletProvider.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Chain,\n  WalletInterfaceType,\n  type WalletProvider,\n  type WalletRpcProvider,\n} from \"@turnkey/core\";\nimport type { DynamicEvmWallet } from \"./types\";\nimport { logger } from \"../utils/logger\";\nimport { createTurnkeyError } from \"../utils/errors\";\nimport { normalizeChainId } from \"../utils/chain\";\n\ntype ProviderRequestArgs = {\n  method: string;\n  params?: unknown[];\n};\n\nconst normalizeMessage = (value: unknown): string => {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (value instanceof Uint8Array) {\n    return (\n      \"0x\" +\n      Array.from(value)\n        .map((byte) => byte.toString(16).padStart(2, \"0\"))\n        .join(\"\")\n    );\n  }\n\n  if (\n    value &&\n    typeof value === \"object\" &&\n    (value as { type?: unknown }).type === \"Buffer\"\n  ) {\n    const bufferValue = value as { data?: unknown };\n    if (!Array.isArray(bufferValue.data)) {\n      throw new Error(\"Invalid buffer payload\");\n    }\n    const dataArray = bufferValue.data as number[];\n    return (\n      \"0x\" +\n      dataArray\n        .map((byte) => byte.toString(16).padStart(2, \"0\"))\n        .join(\"\")\n    );\n  }\n\n  if (typeof value === \"number\" || typeof value === \"bigint\") {\n    return `0x${value.toString(16)}`;\n  }\n\n  if (typeof value === \"boolean\") {\n    return value ? \"0x1\" : \"0x0\";\n  }\n\n  throw new Error(\"Unsupported payload type for personal_sign\");\n};\n\nconst getSignature = async (\n  wallet: DynamicEvmWallet,\n  message: string,\n): Promise<string> => {\n  const startTime = Date.now();\n  logger.debug(\"[Turnkey] [getSignature] Starting\", {\n    walletAddress: wallet.address?.substring(0, 10) + \"...\",\n    messageLength: message.length,\n    hasSignMessage: typeof wallet.signMessage === \"function\",\n    hasConnectorSignMessage: typeof wallet.connector?.signMessage === \"function\",\n  });\n\n  if (typeof wallet.signMessage === \"function\") {\n    logger.debug(\"[Turnkey] [getSignature] Using wallet.signMessage\");\n    const signStartTime = Date.now();\n    const sig = await wallet.signMessage(message);\n    const signDuration = Date.now() - signStartTime;\n    if (sig) {\n      logger.debug(\"[Turnkey] [getSignature] Signature obtained from wallet.signMessage\", {\n        signatureLength: sig.length,\n        signDuration: `${signDuration}ms`,\n        totalDuration: `${Date.now() - startTime}ms`,\n      });\n      return sig;\n    }\n    logger.debug(\"[Turnkey] [getSignature] wallet.signMessage returned no signature\");\n  }\n\n  if (typeof wallet.connector?.signMessage === \"function\") {\n    logger.debug(\"[Turnkey] [getSignature] Using connector.signMessage\");\n    const signStartTime = Date.now();\n    const sig = await wallet.connector.signMessage(message, wallet.address ?? undefined);\n    const signDuration = Date.now() - signStartTime;\n    if (sig) {\n      logger.debug(\"[Turnkey] [getSignature] Signature obtained from connector.signMessage\", {\n        signatureLength: sig.length,\n        signDuration: `${signDuration}ms`,\n        totalDuration: `${Date.now() - startTime}ms`,\n      });\n      return sig;\n    }\n    logger.debug(\"[Turnkey] [getSignature] connector.signMessage returned no signature\");\n  }\n\n  logger.logError(createTurnkeyError('SIGNATURE_FAILED', 'Wallet does not support message signing', {\n    context: { totalDuration: `${Date.now() - startTime}ms` },\n  }));\n  throw new Error(\"Wallet does not support message signing\");\n};\n\nconst createRequestHandler =\n  (wallet: DynamicEvmWallet, chainId: string) =>\n  async ({ method, params }: ProviderRequestArgs) => {\n    const startTime = Date.now();\n    logger.debug(\"[Turnkey] [createRequestHandler] Request received\", {\n      method,\n      hasParams: Boolean(params),\n      paramsLength: params?.length,\n      walletAddress: wallet.address?.substring(0, 10) + \"...\",\n      chainId,\n    });\n\n    switch (method) {\n      case \"eth_requestAccounts\":\n      case \"eth_accounts\": {\n        if (!wallet.address) {\n          logger.logError(createTurnkeyError('AUTH_FAILED', 'Wallet not connected', {\n            context: { method },\n          }));\n          throw new Error(\"Wallet is not connected to an address\");\n        }\n        logger.debug(\"[Turnkey] [createRequestHandler] Returning accounts\", {\n          method,\n          duration: `${Date.now() - startTime}ms`,\n        });\n        return [wallet.address];\n      }\n      case \"eth_chainId\":\n        logger.debug(\"[Turnkey] [createRequestHandler] Returning chain ID\", {\n          method,\n          chainId,\n          duration: `${Date.now() - startTime}ms`,\n        });\n        return chainId;\n      case \"personal_sign\": {\n        if (!params || params.length === 0) {\n          logger.logError(createTurnkeyError('SIGNATURE_FAILED', 'Missing payload for personal_sign', {\n            context: { method },\n          }));\n          throw new Error(\"Missing payload for personal_sign\");\n        }\n        // Some callers send [message, address] while others send [address, message].\n        const looksLikeAddress = (value: unknown) =>\n          typeof value === \"string\" && /^0x[a-fA-F0-9]{40}$/i.test(value);\n        const [first, second] = params;\n        const shouldSwap = looksLikeAddress(first) && typeof second !== \"undefined\";\n\n        const payloadSource = shouldSwap ? second : first;\n\n        logger.debug(\"[Turnkey] [createRequestHandler] Normalizing message for signing\", {\n          method,\n          paramsType: typeof payloadSource,\n          swapped: shouldSwap,\n        });\n\n        const payload = normalizeMessage(payloadSource);\n        logger.debug(\"[Turnkey] [createRequestHandler] Getting signature\", {\n          method,\n          payloadLength: payload.length,\n        });\n        const signature = await getSignature(wallet, payload);\n        logger.debug(\"[Turnkey] [createRequestHandler] Signature obtained\", {\n          method,\n          signatureLength: signature.length,\n          duration: `${Date.now() - startTime}ms`,\n        });\n        return signature;\n      }\n      default:\n        logger.logError(createTurnkeyError('AUTH_FAILED', `Unsupported provider method: ${method}`, {\n          context: { method, duration: `${Date.now() - startTime}ms` },\n        }));\n        throw new Error(`Unsupported provider method: ${method}`);\n    }\n  };\n\n/**\n * Builds a Turnkey WalletProvider from a Dynamic EVM wallet.\n * Normalizes chain IDs, handles eth_requestAccounts/eth_chainId/personal_sign methods,\n * and extracts wallet metadata for Turnkey authentication.\n */\nexport async function buildWalletProvider(\n  wallet: DynamicEvmWallet,\n): Promise<WalletProvider> {\n  const startTime = Date.now();\n  logger.debug(\"[Turnkey] [buildWalletProvider] Starting\", {\n    hasWallet: Boolean(wallet),\n    hasAddress: Boolean(wallet?.address),\n    hasConnector: Boolean(wallet?.connector),\n    walletAddress: wallet?.address?.substring(0, 10) + \"...\",\n  });\n\n  if (!wallet?.address) {\n    logger.logError(createTurnkeyError('CONFIG_MISSING', 'Wallet is missing an address'));\n    throw new Error(\"Wallet is missing an address\");\n  }\n  if (!wallet.connector) {\n    logger.logError(createTurnkeyError('CONFIG_MISSING', 'Wallet connector is not available'));\n    throw new Error(\"Wallet connector is not available\");\n  }\n\n  const getNetworkStartTime = Date.now();\n  const network = (await wallet.connector.getNetwork?.()) ?? wallet.chain ?? null;\n  const getNetworkDuration = Date.now() - getNetworkStartTime;\n  logger.debug(\"[Turnkey] [buildWalletProvider] Got network\", {\n    network,\n    getNetworkDuration: `${getNetworkDuration}ms`,\n  });\n\n  const chainId = normalizeChainId(network);\n  const infoName = wallet.connector.name ?? \"Connected Wallet\";\n  logger.debug(\"[Turnkey] [buildWalletProvider] Normalized chain ID\", {\n    chainId,\n    infoName,\n  });\n\n  const eip1193Provider = {\n    request: createRequestHandler(wallet, chainId),\n  } as WalletRpcProvider;\n\n  const result = {\n    interfaceType: WalletInterfaceType.Ethereum,\n    chainInfo: {\n      namespace: Chain.Ethereum,\n      chainId,\n    },\n    info: {\n      name: infoName,\n      uuid: wallet.id ?? wallet.key ?? wallet.connector.key,\n      icon: wallet.connector.metadata?.icon,\n    },\n    provider: eip1193Provider,\n    connectedAddresses: [wallet.address],\n  };\n\n  const totalDuration = Date.now() - startTime;\n  logger.debug(\"[Turnkey] [buildWalletProvider] Completed\", {\n    chainId,\n    infoName,\n    uuid: result.info.uuid,\n    totalDuration: `${totalDuration}ms`,\n  });\n\n  return result;\n}\n"]}

package/dist/src/turnkey/index.d.ts

@@ -0,0 +1,3 @@
+export { TurnkeyProvider, useTurnkey, TURNKEY_WALLET_NAME, } from "./TurnkeyProvider";
+export type { TurnkeyProviderConfig } from "./types";
+export { TurnkeyAuthState as AuthState } from "./types";

package/dist/src/turnkey/index.js

@@ -0,0 +1,3 @@
+export { TurnkeyProvider, useTurnkey, TURNKEY_WALLET_NAME, } from "./TurnkeyProvider";
+export { TurnkeyAuthState as AuthState } from "./types";
+//# sourceMappingURL=index.js.map

package/dist/src/turnkey/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/turnkey/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,UAAU,EACV,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,IAAI,SAAS,EAAE,MAAM,SAAS,CAAC","sourcesContent":["export {\n  TurnkeyProvider,\n  useTurnkey,\n  TURNKEY_WALLET_NAME,\n} from \"./TurnkeyProvider\";\nexport type { TurnkeyProviderConfig } from \"./types\";\nexport { TurnkeyAuthState as AuthState } from \"./types\";\n"]}

package/dist/src/turnkey/turnkeySessionMachine.d.ts

@@ -0,0 +1,39 @@
+export interface TurnkeySessionSnapshot {
+    status: 'idle' | 'auth_pending' | 'active' | 'refreshing' | 'expired';
+    error?: string;
+    sessionToken?: string;
+    solanaAddress?: string;
+    expiresAt?: number;
+}
+export interface TurnkeySessionMachineOptions {
+    now?: () => number;
+    refreshBufferMs?: number;
+    fallbackSessionTtlMs?: number;
+    schedule?: (fn: () => void, delayMs: number) => {
+        cancel: () => void;
+    };
+}
+export declare class TurnkeySessionMachine {
+    private status;
+    private error?;
+    private sessionToken?;
+    private solanaAddress?;
+    private expiresAt?;
+    private usedNonces;
+    private nonceExpiry;
+    private refreshTimer?;
+    private readonly now;
+    private readonly refreshBufferMs;
+    private readonly fallbackSessionTtlMs;
+    private readonly schedule;
+    constructor(options?: TurnkeySessionMachineOptions);
+    issueNonce(): string;
+    markAuthPending(nonce: string): void;
+    activateSession(params: {
+        sessionToken: string;
+        solanaAddress: string;
+        expiresAt: number;
+    }): void;
+    expire(error?: string): void;
+    getSnapshot(): TurnkeySessionSnapshot;
+}

package/dist/src/turnkey/turnkeySessionMachine.js

@@ -0,0 +1,77 @@
+var TurnkeySessionMachine = /** @class */ (function () {
+    function TurnkeySessionMachine(options) {
+        if (options === void 0) { options = {}; }
+        var _a, _b, _c, _d;
+        this.status = 'idle';
+        this.usedNonces = new Set();
+        this.nonceExpiry = new Map();
+        this.now = (_a = options.now) !== null && _a !== void 0 ? _a : (function () { return Date.now(); });
+        this.refreshBufferMs = (_b = options.refreshBufferMs) !== null && _b !== void 0 ? _b : 5 * 60 * 1000; // 5 minutes default
+        this.fallbackSessionTtlMs = (_c = options.fallbackSessionTtlMs) !== null && _c !== void 0 ? _c : 30 * 60 * 1000; // 30 minutes default
+        this.schedule =
+            (_d = options.schedule) !== null && _d !== void 0 ? _d : (function (fn, delayMs) {
+                var timeoutId = setTimeout(fn, delayMs);
+                return { cancel: function () { return clearTimeout(timeoutId); } };
+            });
+    }
+    TurnkeySessionMachine.prototype.issueNonce = function () {
+        var nonce = crypto.randomUUID();
+        var expiry = this.now() + 5 * 60 * 1000; // 5 minutes TTL
+        this.nonceExpiry.set(nonce, expiry);
+        return nonce;
+    };
+    TurnkeySessionMachine.prototype.markAuthPending = function (nonce) {
+        var expiry = this.nonceExpiry.get(nonce);
+        if (!expiry) {
+            throw new Error('Nonce not found or expired');
+        }
+        if (this.now() > expiry) {
+            throw new Error('Nonce expired');
+        }
+        if (this.usedNonces.has(nonce)) {
+            throw new Error('Nonce has already been used');
+        }
+        this.usedNonces.add(nonce);
+        this.status = 'auth_pending';
+        this.error = undefined;
+    };
+    TurnkeySessionMachine.prototype.activateSession = function (params) {
+        var _this = this;
+        this.sessionToken = params.sessionToken;
+        this.solanaAddress = params.solanaAddress;
+        this.expiresAt = params.expiresAt;
+        this.status = 'active';
+        this.error = undefined;
+        // Schedule refresh before expiry
+        var ttl = params.expiresAt - this.now();
+        var refreshDelay = Math.max(0, ttl - this.refreshBufferMs);
+        if (this.refreshTimer) {
+            this.refreshTimer.cancel();
+        }
+        this.refreshTimer = this.schedule(function () {
+            if (_this.status === 'active') {
+                _this.status = 'refreshing';
+            }
+        }, refreshDelay);
+    };
+    TurnkeySessionMachine.prototype.expire = function (error) {
+        this.status = 'expired';
+        this.error = error;
+        if (this.refreshTimer) {
+            this.refreshTimer.cancel();
+            this.refreshTimer = undefined;
+        }
+    };
+    TurnkeySessionMachine.prototype.getSnapshot = function () {
+        return {
+            status: this.status,
+            error: this.error,
+            sessionToken: this.sessionToken,
+            solanaAddress: this.solanaAddress,
+            expiresAt: this.expiresAt,
+        };
+    };
+    return TurnkeySessionMachine;
+}());
+export { TurnkeySessionMachine };
+//# sourceMappingURL=turnkeySessionMachine.js.map

package/dist/src/turnkey/turnkeySessionMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnkeySessionMachine.js","sourceRoot":"","sources":["../../../src/turnkey/turnkeySessionMachine.ts"],"names":[],"mappings":"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","sourcesContent":["export interface TurnkeySessionSnapshot {\n  status: 'idle' | 'auth_pending' | 'active' | 'refreshing' | 'expired';\n  error?: string;\n  sessionToken?: string;\n  solanaAddress?: string;\n  expiresAt?: number;\n}\n\nexport interface TurnkeySessionMachineOptions {\n  now?: () => number;\n  refreshBufferMs?: number;\n  fallbackSessionTtlMs?: number;\n  schedule?: (fn: () => void, delayMs: number) => {\n    cancel: () => void;\n  };\n}\n\nexport class TurnkeySessionMachine {\n  private status: TurnkeySessionSnapshot['status'] = 'idle';\n  private error?: string;\n  private sessionToken?: string;\n  private solanaAddress?: string;\n  private expiresAt?: number;\n  private usedNonces = new Set<string>();\n  private nonceExpiry = new Map<string, number>();\n  private refreshTimer?: { cancel: () => void };\n  private readonly now: () => number;\n  private readonly refreshBufferMs: number;\n  private readonly fallbackSessionTtlMs: number;\n  private readonly schedule: (fn: () => void, delayMs: number) => {\n    cancel: () => void;\n  };\n\n  constructor(options: TurnkeySessionMachineOptions = {}) {\n    this.now = options.now ?? (() => Date.now());\n    this.refreshBufferMs = options.refreshBufferMs ?? 5 * 60 * 1000; // 5 minutes default\n    this.fallbackSessionTtlMs = options.fallbackSessionTtlMs ?? 30 * 60 * 1000; // 30 minutes default\n    this.schedule =\n      options.schedule ??\n      ((fn, delayMs) => {\n        const timeoutId = setTimeout(fn, delayMs);\n        return { cancel: () => clearTimeout(timeoutId) };\n      });\n  }\n\n  issueNonce(): string {\n    const nonce = crypto.randomUUID();\n    const expiry = this.now() + 5 * 60 * 1000; // 5 minutes TTL\n    this.nonceExpiry.set(nonce, expiry);\n    return nonce;\n  }\n\n  markAuthPending(nonce: string): void {\n    const expiry = this.nonceExpiry.get(nonce);\n    if (!expiry) {\n      throw new Error('Nonce not found or expired');\n    }\n    if (this.now() > expiry) {\n      throw new Error('Nonce expired');\n    }\n    if (this.usedNonces.has(nonce)) {\n      throw new Error('Nonce has already been used');\n    }\n    this.usedNonces.add(nonce);\n    this.status = 'auth_pending';\n    this.error = undefined;\n  }\n\n  activateSession(params: {\n    sessionToken: string;\n    solanaAddress: string;\n    expiresAt: number;\n  }): void {\n    this.sessionToken = params.sessionToken;\n    this.solanaAddress = params.solanaAddress;\n    this.expiresAt = params.expiresAt;\n    this.status = 'active';\n    this.error = undefined;\n    // Schedule refresh before expiry\n    const ttl = params.expiresAt - this.now();\n    const refreshDelay = Math.max(0, ttl - this.refreshBufferMs);\n    if (this.refreshTimer) {\n      this.refreshTimer.cancel();\n    }\n    this.refreshTimer = this.schedule(() => {\n      if (this.status === 'active') {\n        this.status = 'refreshing';\n      }\n    }, refreshDelay);\n  }\n\n  expire(error?: string): void {\n    this.status = 'expired';\n    this.error = error;\n    if (this.refreshTimer) {\n      this.refreshTimer.cancel();\n      this.refreshTimer = undefined;\n    }\n  }\n\n  getSnapshot(): TurnkeySessionSnapshot {\n    return {\n      status: this.status,\n      error: this.error,\n      sessionToken: this.sessionToken,\n      solanaAddress: this.solanaAddress,\n      expiresAt: this.expiresAt,\n    };\n  }\n}\n\n"]}

package/dist/src/turnkey/turnkeySessionStorage.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Internal storage structure for Turnkey session.
+ */
+export interface StoredSessionEntry {
+    sessionKey: string;
+    evmAddress?: string | null;
+    solanaAccount?: {
+        walletId: string;
+        account: {
+            address: string;
+            addressFormat?: string;
+        };
+    } | null;
+    session?: unknown;
+}
+export declare function readTurnkeyClientAddress(): string | null;
+export declare function storeTurnkeyClientAddress(address: string | null): void;
+/**
+ * Stores a Turnkey session key. Replaces any existing session.
+ */
+export declare function storeTurnkeySessionKey(address: string, sessionKey: string, options?: {
+    evmAddress?: string | null;
+    solanaAccount?: {
+        walletId: string;
+        account: {
+            address: string;
+            addressFormat?: string;
+        };
+    } | null;
+    session?: unknown;
+}): void;
+export declare function updateTurnkeyStoredSolanaAccount(address: string, solanaAccount: {
+    walletId: string;
+    account: {
+        address: string;
+        addressFormat?: string;
+    };
+}): void;
+/**
+ * Clears the stored Turnkey session.
+ */
+export declare function clearTurnkeySessionKey(address?: string | null): void;
+/**
+ * Retrieves the stored Turnkey session.
+ * If address is provided, validates that the session belongs to that address.
+ */
+export declare function readTurnkeyStoredSession(address?: string | null): StoredSessionEntry | null;
+export declare function readTurnkeySessionKey(address?: string | null): string | null;