@0xkey-io/core 0.1.0

package/dist/__wallet__/web/native/solana.mjs

@@ -0,0 +1,212 @@
+import { getWallets } from '@wallet-standard/app';
+import { uint8ArrayFromHexString, uint8ArrayToHexString, bs58 } from '@0xkey-io/encoding';
+import { SignIntent, WalletInterfaceType, Chain } from '../../../__types__/enums.mjs';
+import { withTimeoutFallback } from '../../../utils.mjs';
+
+/**
+ * Abstract base class for Solana wallet implementations using Wallet Standard.
+ *
+ * Provides shared logic for:
+ * - Provider discovery via `@wallet-standard/app` (`getWallets()`).
+ * - Connecting via `standard:connect` and disconnecting via `standard:disconnect`.
+ * - Public key retrieval from the wallet's account address (base58 → hex).
+ */
+class BaseSolanaWallet {
+    constructor() {
+        this.interfaceType = WalletInterfaceType.Solana;
+        /**
+         * Retrieves the ed25519 public key for the active account as hex (no 0x prefix).
+         *
+         * - Ensures the wallet is connected (calls `standard:connect` if needed).
+         * - Decodes the Wallet Standard account address (base58) to raw bytes.
+         *
+         * @param provider - The wallet provider to use.
+         * @returns Hex-encoded ed25519 public key (no 0x prefix).
+         * @throws {Error} If no account is available.
+         */
+        this.getPublicKey = async (provider) => {
+            const wallet = asSolana(provider);
+            await connectAccount(wallet);
+            const account = wallet.accounts[0];
+            if (!account) {
+                throw new Error("No account in wallet");
+            }
+            const rawBytes = bs58.decode(account.address);
+            return uint8ArrayToHexString(rawBytes);
+        };
+        /**
+         * Discovers Solana-capable Wallet Standard providers.
+         *
+         * - Uses `getWallets().get()` and filters wallets with at least one `chains` entry
+         *   starting with `"solana:"`.
+         * - For each wallet, collects branding info and any currently connected addresses.
+         *
+         * @returns A list of discovered Solana `WalletProvider`s (may be empty).
+         */
+        this.getProviders = async () => {
+            const discovered = [];
+            const walletsApi = getWallets();
+            const providers = walletsApi
+                .get()
+                .filter((w) => w.chains?.some((c) => c.startsWith("solana:")));
+            await Promise.all(providers.map(async (wallet) => {
+                // wrap account access in a timeout to prevent hanging providers from blocking discovery
+                const connectedAddresses = await withTimeoutFallback((async () => {
+                    try {
+                        return wallet.accounts?.map((a) => a.address) ?? [];
+                    }
+                    catch {
+                        return [];
+                    }
+                })(), []);
+                discovered.push({
+                    interfaceType: WalletInterfaceType.Solana,
+                    chainInfo: {
+                        namespace: Chain.Solana,
+                    },
+                    // Some wallet providers include leading whitespace in their icon URLs.
+                    // Next.js 15+ and other frameworks are strict about URL formatting,
+                    // so we trim
+                    info: {
+                        name: wallet.name,
+                        ...(wallet.icon && { icon: wallet.icon.trim() }),
+                    },
+                    provider: wallet,
+                    connectedAddresses,
+                });
+            }));
+            return discovered;
+        };
+        /**
+         * Connects the wallet account, prompting the user if necessary.
+         *
+         * - Calls `standard:connect` only if no accounts are present. This will prompt the user to connect their wallet.
+         *
+         * @param provider - The wallet provider to connect.
+         * @returns A promise that resolves with the connected wallet's address.
+         * @throws {Error} If the wallet does not implement `standard:connect`.
+         */
+        this.connectWalletAccount = async (provider) => {
+            const wallet = asSolana(provider);
+            return await connectAccount(wallet);
+        };
+        /**
+         * Disconnects the wallet account using Wallet Standard.
+         *
+         * - Calls `standard:disconnect` if implemented.
+         * - Throws if the wallet does not implement `standard:disconnect`.
+         *
+         * @param provider - The wallet provider to disconnect.
+         * @returns A promise that resolves once the wallet disconnects.
+         * @throws {Error} If `standard:disconnect` is not supported by the wallet.
+         */
+        this.disconnectWalletAccount = async (provider) => {
+            const wallet = asSolana(provider);
+            const disconnectFeature = wallet.features["standard:disconnect"];
+            if (disconnectFeature) {
+                await disconnectFeature.disconnect();
+            }
+            else {
+                throw new Error("Wallet does not support standard:disconnect");
+            }
+        };
+    }
+}
+/**
+ * Signs a message or transaction with the connected Solana wallet.
+ *
+ * - Ensures the wallet is connected (may prompt via `standard:connect` if its not).
+ * - `SignMessage` → `solana:signMessage` (returns hex signature).
+ * - `SignTransaction` → `solana:signTransaction` (returns hex signature).
+ *
+ * @param payload - UTF-8 string (for message) or hex string (for transaction bytes).
+ * @param provider - The wallet provider to use.
+ * @param intent - The signing intent.
+ * @returns Hex-encoded signature (no 0x prefix).
+ * @throws {Error} If the provider lacks required features or intent is unsupported.
+ */
+class SolanaWallet extends BaseSolanaWallet {
+    constructor() {
+        super(...arguments);
+        this.sign = async (payload, provider, intent) => {
+            const wallet = asSolana(provider);
+            await connectAccount(wallet);
+            const account = wallet.accounts[0];
+            if (!account)
+                throw new Error("No account available");
+            switch (intent) {
+                case SignIntent.SignMessage: {
+                    const signFeature = wallet.features["solana:signMessage"];
+                    if (!signFeature)
+                        throw new Error("Provider does not support solana:signMessage");
+                    const data = new TextEncoder().encode(payload);
+                    const results = await signFeature.signMessage({
+                        account,
+                        message: data,
+                    });
+                    if (!results?.length || !results[0]?.signature) {
+                        throw new Error("No signature returned from signMessage");
+                    }
+                    return uint8ArrayToHexString(results[0].signature);
+                }
+                case SignIntent.SignTransaction: {
+                    const signFeature = wallet.features["solana:signTransaction"];
+                    if (!signFeature)
+                        throw new Error("Provider does not support solana:signTransaction");
+                    const data = uint8ArrayFromHexString(payload);
+                    const results = await signFeature.signTransaction({
+                        account,
+                        transaction: data,
+                    });
+                    if (!results?.length || !results[0]?.signedTransaction) {
+                        throw new Error("No signature returned from signTransaction");
+                    }
+                    return uint8ArrayToHexString(results[0].signedTransaction);
+                }
+                default:
+                    throw new Error(`Unsupported sign intent: ${intent}`);
+            }
+        };
+    }
+}
+/**
+ * Casts a WalletRpcProvider to a Wallet Standard Solana wallet.
+ *
+ * - Validates presence of the Wallet Standard `features` map and `solana:signMessage`.
+ * - Use this before calling Solana-specific features (signMessage, signTransaction, etc.).
+ *
+ * @param provider - The wallet provider to cast.
+ * @returns The Wallet Standard wallet object.
+ * @throws {Error} If the provider is not a Wallet Standard Solana wallet.
+ */
+const asSolana = (provider) => {
+    if (provider.provider &&
+        "features" in provider.provider &&
+        "solana:signMessage" in provider.provider.features) {
+        return provider.provider;
+    }
+    throw new Error("Expected a Wallet-Standard provider (Solana wallet)");
+};
+/**
+ * Ensures the given Wallet Standard wallet has at least one connected account.
+ *
+ * - If accounts already exist, resolves immediately.
+ * - If not, attempts `standard:connect`, which may prompt the user.
+ *
+ * @param wallet - The Wallet Standard wallet to connect.
+ * @returns A promise that resolves with the connected wallet's address.
+ * @throws {Error} If the wallet does not implement `standard:connect`.
+ */
+const connectAccount = async (wallet) => {
+    if (wallet.accounts.length)
+        return wallet.accounts[0].address;
+    const stdConnect = wallet.features["standard:connect"];
+    if (stdConnect) {
+        await stdConnect.connect();
+        return wallet.accounts[0].address;
+    }
+    throw new Error("Wallet is not connected and does not implement standard:connect");
+};
+
+export { BaseSolanaWallet, SolanaWallet };
+//# sourceMappingURL=solana.mjs.map

package/dist/__wallet__/web/native/solana.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana.mjs","sources":["../../../../src/__wallet__/web/native/solana.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/** @internal */
+export { ApiKeyStamper, signWithApiKey, type TApiKeyStamperConfig, } from "@0xkey-io/api-key-stamper";
+/** @internal */
+export { type TWebauthnStamperConfig, WebauthnStamper, } from "@0xkey-io/webauthn-stamper";
+export { ZeroXKeyClient, type ZeroXKeyClientMethods } from "./__clients__/core";
+export { type ZeroXKeySDKClientBase } from "./__generated__/sdk-client-base";
+export * from "./__types__/auth";
+export * from "./__types__/config";
+export * from "./__types__/enums";
+export * from "./__types__/error";
+export * from "./__types__/export";
+export * from "./__types__/external-wallets";
+export * from "./__types__/http";
+export * from "./__types__/method-types/import-export-params";
+export * from "./__types__/method-types/shared";
+/**@internal */
+export { generateWalletAccountsFromAddressFormat, isEthereumProvider, isSolanaProvider, getAuthProxyConfig, sendSignedRequest, decodeVerificationToken, getClientSignatureMessageForLogin, getClientSignatureMessageForSignup, addressFormatConfig, } from "./utils";
+export * from "@0xkey-io/sdk-types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,gBAAgB;AAChB,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,2BAA2B,CAAC;AAGnC,gBAAgB;AAChB,OAAO,EACL,KAAK,sBAAsB,EAC3B,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAG7E,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,+CAA+C,CAAC;AAC9D,cAAc,iCAAiC,CAAC;AAEhD,eAAe;AACf,OAAO,EACL,uCAAuC,EACvC,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,iCAAiC,EACjC,kCAAkC,EAClC,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,83 @@
+'use strict';
+
+var apiKeyStamper = require('@0xkey-io/api-key-stamper');
+var webauthnStamper = require('@0xkey-io/webauthn-stamper');
+var core = require('./__clients__/core.js');
+var auth = require('./__types__/auth.js');
+var enums = require('./__types__/enums.js');
+var error = require('./__types__/error.js');
+var http = require('./__types__/http.js');
+var sdkTypes = require('@0xkey-io/sdk-types');
+var utils = require('./utils.js');
+
+
+
+Object.defineProperty(exports, "ApiKeyStamper", {
+	enumerable: true,
+	get: function () { return apiKeyStamper.ApiKeyStamper; }
+});
+Object.defineProperty(exports, "signWithApiKey", {
+	enumerable: true,
+	get: function () { return apiKeyStamper.signWithApiKey; }
+});
+Object.defineProperty(exports, "WebauthnStamper", {
+	enumerable: true,
+	get: function () { return webauthnStamper.WebauthnStamper; }
+});
+exports.ZeroXKeyClient = core.ZeroXKeyClient;
+exports.DEFAULT_SESSION_EXPIRATION_IN_SECONDS = auth.DEFAULT_SESSION_EXPIRATION_IN_SECONDS;
+Object.defineProperty(exports, "Chain", {
+	enumerable: true,
+	get: function () { return enums.Chain; }
+});
+Object.defineProperty(exports, "Curve", {
+	enumerable: true,
+	get: function () { return enums.Curve; }
+});
+Object.defineProperty(exports, "FilterType", {
+	enumerable: true,
+	get: function () { return enums.FilterType; }
+});
+Object.defineProperty(exports, "OtpType", {
+	enumerable: true,
+	get: function () { return enums.OtpType; }
+});
+exports.OtpTypeToFilterTypeMap = enums.OtpTypeToFilterTypeMap;
+Object.defineProperty(exports, "SessionKey", {
+	enumerable: true,
+	get: function () { return enums.SessionKey; }
+});
+Object.defineProperty(exports, "SignIntent", {
+	enumerable: true,
+	get: function () { return enums.SignIntent; }
+});
+Object.defineProperty(exports, "StamperType", {
+	enumerable: true,
+	get: function () { return enums.StamperType; }
+});
+Object.defineProperty(exports, "WalletInterfaceType", {
+	enumerable: true,
+	get: function () { return enums.WalletInterfaceType; }
+});
+Object.defineProperty(exports, "WalletSource", {
+	enumerable: true,
+	get: function () { return enums.WalletSource; }
+});
+exports.ZeroXKeyRequestError = error.ZeroXKeyRequestError;
+exports.TERMINAL_ACTIVITY_STATUSES = http.TERMINAL_ACTIVITY_STATUSES;
+exports.addressFormatConfig = utils.addressFormatConfig;
+exports.decodeVerificationToken = utils.decodeVerificationToken;
+exports.generateWalletAccountsFromAddressFormat = utils.generateWalletAccountsFromAddressFormat;
+exports.getAuthProxyConfig = utils.getAuthProxyConfig;
+exports.getClientSignatureMessageForLogin = utils.getClientSignatureMessageForLogin;
+exports.getClientSignatureMessageForSignup = utils.getClientSignatureMessageForSignup;
+exports.isEthereumProvider = utils.isEthereumProvider;
+exports.isSolanaProvider = utils.isSolanaProvider;
+exports.sendSignedRequest = utils.sendSignedRequest;
+Object.keys(sdkTypes).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return sdkTypes[k]; }
+	});
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.mjs

@@ -0,0 +1,10 @@
+export { ApiKeyStamper, signWithApiKey } from '@0xkey-io/api-key-stamper';
+export { WebauthnStamper } from '@0xkey-io/webauthn-stamper';
+export { ZeroXKeyClient } from './__clients__/core.mjs';
+export { DEFAULT_SESSION_EXPIRATION_IN_SECONDS } from './__types__/auth.mjs';
+export { Chain, Curve, FilterType, OtpType, OtpTypeToFilterTypeMap, SessionKey, SignIntent, StamperType, WalletInterfaceType, WalletSource } from './__types__/enums.mjs';
+export { ZeroXKeyRequestError } from './__types__/error.mjs';
+export { TERMINAL_ACTIVITY_STATUSES } from './__types__/http.mjs';
+export * from '@0xkey-io/sdk-types';
+export { addressFormatConfig, decodeVerificationToken, generateWalletAccountsFromAddressFormat, getAuthProxyConfig, getClientSignatureMessageForLogin, getClientSignatureMessageForSignup, isEthereumProvider, isSolanaProvider, sendSignedRequest } from './utils.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/utils.d.ts

@@ -0,0 +1,160 @@
+import { type v1AddressFormat, type v1HashFunction, type v1PayloadEncoding, type Session, type externaldatav1Timestamp, type ProxyTSignupBody, type v1ApiKeyParamsV2, type v1AuthenticatorParamsV2, type v1WalletAccountParams, type v1WalletAccount, type v1OauthProviderParams, type v1SignRawPayloadResult, type v1TransactionType, type ProxyTGetWalletKitConfigResponse, type v1User, type v1CreatePolicyIntentV3, type VerificationToken, ZeroXKeyErrorCodes } from "@0xkey-io/sdk-types";
+import { type CreateSubOrgParams, type WalletProvider, Chain, EvmChainInfo, SolanaChainInfo, EmbeddedWallet, StamperType, TSignedRequest } from "./__types__";
+import type { ZeroXKeySDKClientBase } from "./__generated__/sdk-client-base";
+type AddressFormatConfig = {
+    encoding: v1PayloadEncoding;
+    hashFunction: v1HashFunction;
+    defaultAccounts: v1WalletAccountParams[] | null;
+    displayName: string;
+};
+export declare const addressFormatConfig: Record<v1AddressFormat, AddressFormatConfig>;
+export declare const googleISS = "https://accounts.google.com";
+export declare const isReactNative: () => boolean;
+export declare const isWeb: () => boolean;
+export declare const generateRandomBuffer: () => ArrayBuffer;
+export declare const bytesToHex: (bytes: Uint8Array) => string;
+export declare const toExternalTimestamp: (date?: Date) => externaldatav1Timestamp;
+export declare function getActiveSessionOrThrowIfRequired(stampWith: StamperType | undefined, getActiveSession: () => Promise<Session | undefined>): Promise<Session | undefined>;
+export declare function parseSession(token: string | Session): Session;
+export declare function getHashFunction(addressFormat: v1AddressFormat): v1HashFunction;
+export declare function getEncodingType(addressFormat: v1AddressFormat): v1PayloadEncoding;
+export declare function getEncodedMessage(payloadEncoding: v1PayloadEncoding, rawMessage: Uint8Array): string;
+export declare function hexSignedTxToBase58(hex: string): string;
+export declare const broadcastTransaction: (params: {
+    signedTransaction: string;
+    rpcUrl: string;
+    transactionType: v1TransactionType;
+}) => Promise<string>;
+export declare function splitSignature(signature: string, addressFormat: v1AddressFormat): v1SignRawPayloadResult;
+export declare function isWalletAccountArray(arr: any[]): arr is v1WalletAccountParams[];
+export declare function createWalletAccountFromAddressFormat(addressFormat: v1AddressFormat): v1WalletAccountParams;
+/**@internal */
+export declare function generateWalletAccountsFromAddressFormat(params: {
+    addresses: v1AddressFormat[];
+    existingWalletAccounts?: v1WalletAccount[];
+}): v1WalletAccountParams[];
+export declare function buildSignUpBody(params: {
+    createSubOrgParams: CreateSubOrgParams | undefined;
+}): ProxyTSignupBody;
+/**
+ * Extracts the public key from a ZeroXKey stamp header value.
+ * @param stampHeaderValue - The base64url encoded stamp header value
+ * @returns The public key as a hex string
+ */
+export declare function getPublicKeyFromStampHeader(stampHeaderValue: string): string;
+/**@internal */
+export declare function getPolicySignature(policy: v1CreatePolicyIntentV3): string;
+/**@internal */
+export declare function isEthereumProvider(provider: WalletProvider): provider is WalletProvider & {
+    chainInfo: EvmChainInfo;
+};
+/**@internal */
+export declare function isSolanaProvider(provider: WalletProvider): provider is WalletProvider & {
+    chainInfo: SolanaChainInfo;
+};
+/** @internal */
+export declare function getCurveTypeFromProvider(provider: WalletProvider): "API_KEY_CURVE_SECP256K1" | "API_KEY_CURVE_ED25519";
+/** @internal */
+export declare function getSignatureSchemeFromProvider(provider: WalletProvider): "SIGNATURE_SCHEME_TK_API_SECP256K1_EIP191" | "SIGNATURE_SCHEME_TK_API_ED25519";
+/** @internal */
+export declare function findWalletProviderFromAddress(address: string, providers: WalletProvider[]): WalletProvider | undefined;
+/**
+ * Derives a wallet address from a given public key and chain.
+ *
+ * @param chain - "ethereum" or "solana"
+ * @param publicKey - The raw public key string (can be compressed or uncompressed)
+ * @returns The derived wallet address
+ */
+export declare function addressFromPublicKey(chain: Chain, publicKey: string): string;
+/**@internal */
+export declare function getAuthenticatorAddresses(user: v1User): {
+    ethereum: string[];
+    solana: string[];
+};
+/**@internal */
+export declare function getAuthProxyConfig(authProxyConfigId: string, authProxyUrl?: string | undefined): Promise<ProxyTGetWalletKitConfigResponse>;
+/**
+ * Submits a signed request to ZeroXKey.
+ *
+ * You can pass in the SignedRequest returned by any of the SDK's
+ * stamping methods (stampStampLogin, stampGetPolicies, etc.).
+ *
+ * @deprecated Use `httpClient.sendSignedRequest()` instead, which includes
+ * automatic activity polling and result extraction.
+ *
+ * @param signedRequest A SignedRequest object returned by a stamping method.
+ * @returns The parsed JSON response from ZeroXKey.
+ * @throws ZeroXKeyNetworkError if the request fails.
+ */
+export declare function sendSignedRequest<T = any>(signedRequest: TSignedRequest): Promise<T>;
+/**
+ * @internal
+ * Executes an async function with error handling.
+ *
+ * @param fn The async function to execute with error handling
+ * @param errorOptions Options for customizing error handling
+ * @param errorOptions.catchFn Optional function to execute in the catch block
+ * @param errorOptions.errorMessage The default error message to use if no custom message is found
+ * @param errorOptions.errorCode The default error code to use if no custom message is found
+ * @param errorOptions.customErrorsByCodes Optional mapping of error codes to custom messages, if you're trying to target a specific error code and surface a custom message, use this
+ * @param errorOptions.customErrorsByMessages Optional mapping of error messages to custom messages, if you're trying to target a specific error message and surface a custom message, use this
+ * @param finallyFn Optional function to execute in the finally block
+ * @returns The result of the async function or throws an error
+ */
+export declare function withZeroXKeyErrorHandling<T>(fn: () => Promise<T>, catchOptions: {
+    catchFn?: () => Promise<void>;
+    errorMessage: string;
+    errorCode: ZeroXKeyErrorCodes;
+    customErrorsByCodes?: Partial<Record<ZeroXKeyErrorCodes, {
+        message: string;
+        code: ZeroXKeyErrorCodes;
+    }>>;
+    customErrorsByMessages?: Record<string, {
+        message: string;
+        code: ZeroXKeyErrorCodes;
+    }>;
+}, finallyOptions?: {
+    finallyFn: () => Promise<void>;
+}): Promise<T>;
+/**
+ * @internal
+ *
+ * Asserts that the provided key pair is a valid P-256 ECDSA key pair.
+ * @param pair The key pair to validate.
+ */
+export declare function assertValidP256ECDSAKeyPair(pair: CryptoKeyPair): Promise<void>;
+export declare function isValidPasskeyName(name: string): string;
+export declare function mapAccountsToWallet(accounts: v1WalletAccount[], walletMap: Map<string, EmbeddedWallet>): EmbeddedWallet[];
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, label: string): Promise<T>;
+export declare function fetchAllWalletAccountsWithCursor(httpClient: ZeroXKeySDKClientBase, organizationId: string, stampWith?: StamperType): Promise<v1WalletAccount[]>;
+export declare function decodeVerificationToken(verificationToken: string): VerificationToken;
+export declare function getClientSignatureMessageForLogin({ verificationToken, sessionPublicKey, }: {
+    verificationToken: string;
+    sessionPublicKey?: string;
+}): {
+    message: string;
+    publicKey: string;
+};
+export declare function getClientSignatureMessageForSignup({ verificationToken, email, phoneNumber, apiKeys, authenticators, oauthProviders, }: {
+    verificationToken: string;
+    email?: string;
+    phoneNumber?: string;
+    apiKeys?: v1ApiKeyParamsV2[];
+    authenticators?: v1AuthenticatorParamsV2[];
+    oauthProviders?: v1OauthProviderParams[];
+}): {
+    message: string;
+    publicKey: string;
+};
+/**
+ * Wraps a promise with a timeout. If the promise doesn't resolve within
+ * the specified duration, it resolves to the fallback value instead of throwing.
+ *
+ * @param promise - The promise to wrap.
+ * @param fallback - Value to return if the timeout is reached.
+ * @param timeoutMs - Timeout duration in milliseconds. Defaults to 1000ms.
+ * @returns The result of the promise, or the fallback if timed out.
+ */
+export declare const withTimeoutFallback: <T>(promise: Promise<T>, fallback: T, timeoutMs?: number) => Promise<T>;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}