@turnkey/core 1.0.0-beta.6 → 1.1.0

package/dist/__clients__/core.d.ts

@@ -1,13 +1,20 @@
 import { TurnkeySDKClientBase } from "../__generated__/sdk-client-base";
-import { TDeleteSubOrganizationResponse, Session, TStampLoginResponse, v1AddressFormat, v1Attestation, v1Pagination, v1SignRawPayloadResult, v1TransactionType, v1User, ProxyTGetWalletKitConfigResponse, v1WalletAccountParams, v1PayloadEncoding, v1HashFunction, v1Curve, v1PrivateKey, WalletAuthResult, BaseAuthResult, AuthAction, PasskeyAuthResult } from "@turnkey/sdk-types";
-import { ExportBundle, StamperType, TurnkeySDKClientConfig, WalletAccount, Wallet, OtpType, CreateSubOrgParams, Chain, WalletManagerBase, WalletProvider, SwitchableChain } from "../__types__/base";
+import { type TDeleteSubOrganizationResponse, type Session, type TStampLoginResponse, type v1SignRawPayloadResult, type v1User, type ProxyTGetWalletKitConfigResponse, type v1PrivateKey, type WalletAuthResult, type BaseAuthResult, AuthAction, type PasskeyAuthResult } from "@turnkey/sdk-types";
+import { Chain, type ExportBundle, type TurnkeySDKClientConfig, type WalletAccount, type Wallet, type WalletManagerBase, type WalletProvider, type CreatePasskeyParams, type CreatePasskeyResult, type LogoutParams, type LoginWithPasskeyParams, type SignUpWithPasskeyParams, type SwitchWalletAccountChainParams, type LoginWithWalletParams, type SignUpWithWalletParams, type LoginOrSignupWithWalletParams, type InitOtpParams, type VerifyOtpParams, type VerifyOtpResult, type LoginWithOtpParams, type SignUpWithOtpParams, type CompleteOtpParams, type CompleteOauthParams, type LoginWithOauthParams, type SignUpWithOauthParams, type FetchWalletsParams, type FetchWalletAccountsParams, type FetchPrivateKeysParams, type SignMessageParams, type SignTransactionParams, type SignAndSendTransactionParams, type FetchUserParams, type FetchOrCreateP256ApiKeyUserParams, type FetchOrCreatePoliciesParams, type FetchOrCreatePoliciesResult, type UpdateUserEmailParams, type RemoveUserEmailParams, type UpdateUserPhoneNumberParams, type RemoveUserPhoneNumberParams, type UpdateUserNameParams, type AddOauthProviderParams, type RemoveOauthProvidersParams, type AddPasskeyParams, type RemovePasskeyParams, type CreateWalletParams, type CreateWalletAccountsParams, type ExportWalletParams, type ExportPrivateKeyParams, type ExportWalletAccountParams, type ImportWalletParams, type ImportPrivateKeyParams, type DeleteSubOrganizationParams, type StoreSessionParams, type ClearSessionParams, type RefreshSessionParams, type GetSessionParams, type SetActiveSessionParams, type CreateApiKeyPairParams } from "../__types__";
 import { CrossPlatformApiKeyStamper } from "../__stampers__/api/base";
 import { CrossPlatformPasskeyStamper } from "../__stampers__/passkey/base";
+/**
+ * @internal
+ * Gathers all public methods exposed in our core client and turns it into a type that
+ * can be used to extend clients created for other packages built off core
+ *
+ * Should be used to keep any packages that extend this core package in sync with each
+ * other, meaning any new additions to core should also be reflected in those packages
+ */
 type PublicMethods<T> = {
-    [K in keyof T as K extends string | number | symbol ? K extends "init" | "constructor" | "config" | "httpClient" | "user" | "wallets" ? never : K : never]: T[K] extends (...args: any[]) => any ? T[K] : never;
+    [K in keyof T as T[K] extends Function ? K : never]: T[K];
 };
-/**@internal */
-export type TurnkeyClientMethods = PublicMethods<TurnkeyClient>;
+export type TurnkeyClientMethods = Omit<PublicMethods<TurnkeyClient>, "init" | "config" | "httpClient" | "constructor">;
 export declare class TurnkeyClient {
     config: TurnkeySDKClientConfig;
     httpClient: TurnkeySDKClientBase;
@@ -25,21 +32,11 @@ export declare class TurnkeyClient {
      * - The resulting attestation and challenge can be used to register the passkey with Turnkey.
      *
      * @param params.name - display name for the passkey (defaults to a generated name based on the current timestamp).
-     * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
      * @param params.challenge - challenge string to use for passkey registration. If not provided, a new challenge will be generated.
-     * @returns A promise that resolves to an object containing:
-     *   - attestation: attestation object returned from the passkey creation process.
-     *   - encodedChallenge: encoded challenge string used for passkey registration.
+     * @returns A promise that resolves to {@link CreatePasskeyResult}
      * @throws {TurnkeyError} If there is an error during passkey creation, or if the platform is unsupported.
      */
-    createPasskey: (params?: {
-        name?: string;
-        stampWith?: StamperType | undefined;
-        challenge?: string;
-    }) => Promise<{
-        attestation: v1Attestation;
-        encodedChallenge: string;
-    }>;
+    createPasskey: (params: CreatePasskeyParams) => Promise<CreatePasskeyResult>;
     /**
      * Logs out the current client session.
      *
@@ -51,9 +48,7 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves when the logout process is complete.
      * @throws {TurnkeyError} If there is no active session or if there is an error during the logout process.
      */
-    logout: (params?: {
-        sessionKey?: string;
-    }) => Promise<void>;
+    logout: (params?: LogoutParams) => Promise<void>;
     /**
      * Logs in a user using a passkey, optionally specifying the public key, session key, and session expiration.
      *
@@ -66,16 +61,13 @@ export declare class TurnkeyClient {
      * @param params.publicKey - public key to use for authentication. If not provided, a new key pair will be generated.
      * @param params.sessionKey - session key to use for session creation (defaults to the default session key).
      * @param params.expirationSeconds - session expiration time in seconds (defaults to the configured default).
+     * @param params.organizationId - organization ID to target (defaults to the session's organization ID or the parent organization ID).
      * @returns A promise that resolves to a {@link PasskeyAuthResult}, which includes:
      *          - `sessionToken`: the signed JWT session token.
      *          - `credentialId`: an empty string.
      * @throws {TurnkeyError} If there is an error during the passkey login process or if the user cancels the passkey prompt.
      */
-    loginWithPasskey: (params?: {
-        publicKey?: string;
-        sessionKey?: string;
-        expirationSeconds?: string;
-    }) => Promise<PasskeyAuthResult>;
+    loginWithPasskey: (params?: LoginWithPasskeyParams) => Promise<PasskeyAuthResult>;
     /**
      * Signs up a user using a passkey, creating a new sub-organization and session.
      *
@@ -90,18 +82,13 @@ export declare class TurnkeyClient {
      * @param params.sessionKey - session key to use for storing the session (defaults to the default session key).
      * @param params.expirationSeconds - session expiration time in seconds (defaults to the configured default).
      * @param params.challenge - challenge string to use for passkey registration. If not provided, a new challenge will be generated.
+     * @param params.organizationId - organization ID to target (defaults to the session's organization ID or the parent organization ID).
      * @returns A promise that resolves to a {@link PasskeyAuthResult}, which includes:
      *          - `sessionToken`: the signed JWT session token.
      *          - `credentialId`: the credential ID associated with the passkey created.
      * @throws {TurnkeyError} If there is an error during passkey creation, sub-organization creation, or session storage.
      */
-    signUpWithPasskey: (params?: {
-        createSubOrgParams?: CreateSubOrgParams;
-        sessionKey?: string;
-        passkeyDisplayName?: string;
-        expirationSeconds?: string;
-        challenge?: string;
-    }) => Promise<PasskeyAuthResult>;
+    signUpWithPasskey: (params?: SignUpWithPasskeyParams) => Promise<PasskeyAuthResult>;
     /**
      * Retrieves wallet providers from the initialized wallet manager.
      *
@@ -112,17 +99,17 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves to an array of wallet providers.
      * @throws {TurnkeyError} If the wallet manager is uninitialized or provider retrieval fails.
      */
-    getWalletProviders: (chain?: Chain) => Promise<WalletProvider[]>;
+    fetchWalletProviders: (chain?: Chain) => Promise<WalletProvider[]>;
     /**
      * Connects the specified wallet account.
      *
      * - Requires the wallet manager and its connector to be initialized.
      *
      * @param walletProvider - wallet provider to connect.
-     * @returns A promise that resolves once the wallet account is connected.
+     * @returns A promise that resolves with the connected wallet's address.
      * @throws {TurnkeyError} If the wallet manager is uninitialized or the connection fails.
      */
-    connectWalletAccount: (walletProvider: WalletProvider) => Promise<void>;
+    connectWalletAccount: (walletProvider: WalletProvider) => Promise<string>;
     /**
      * Disconnects the specified wallet account.
      *
@@ -144,16 +131,12 @@ export declare class TurnkeyClient {
      *
      * @param params.walletAccount - The wallet account whose provider should be switched.
      * @param params.chainOrId - The target chain, specified as a chain ID string or a SwitchableChain object.
-     * @param params.walletProviders - Optional list of wallet providers to search; falls back to `getWalletProviders()` if omitted.
+     * @param params.walletProviders - Optional list of wallet providers to search; falls back to `fetchWalletProviders()` if omitted.
      * @returns A promise that resolves once the chain switch is complete.
      *
      * @throws {TurnkeyError} If the wallet manager is uninitialized, the provider is not connected, or the switch fails.
      */
-    switchWalletAccountChain: (params: {
-        walletAccount: WalletAccount;
-        chainOrId: string | SwitchableChain;
-        walletProviders?: WalletProvider[] | undefined;
-    }) => Promise<void>;
+    switchWalletAccountChain: (params: SwitchWalletAccountChainParams) => Promise<void>;
     /**
      * Logs in a user using the specified wallet provider.
      *
@@ -167,17 +150,13 @@ export declare class TurnkeyClient {
      * @param params.publicKey - optional public key to associate with the session (generated if not provided).
      * @param params.sessionKey - optional key to store the session under (defaults to the default session key).
      * @param params.expirationSeconds - optional session expiration time in seconds (defaults to the configured default).
+     * @param params.organizationId - organization ID to target (defaults to the session's organization ID or the parent organization ID).
      * @returns A promise that resolves to a {@link WalletAuthResult}, which includes:
      *          - `sessionToken`: the signed JWT session token.
      *          - `address`: the authenticated wallet address.
      * @throws {TurnkeyError} If the wallet stamper is uninitialized, a public key cannot be found or generated, or login fails.
      */
-    loginWithWallet: (params: {
-        walletProvider: WalletProvider;
-        publicKey?: string;
-        sessionKey?: string;
-        expirationSeconds?: string;
-    }) => Promise<WalletAuthResult>;
+    loginWithWallet: (params: LoginWithWalletParams) => Promise<WalletAuthResult>;
     /**
      * Signs up a user using a wallet, creating a new sub-organization and session.
      *
@@ -191,17 +170,13 @@ export declare class TurnkeyClient {
      * @param params.createSubOrgParams - parameters for creating a sub-organization (e.g., authenticators, user metadata).
      * @param params.sessionKey - session key to use for storing the session (defaults to the default session key).
      * @param params.expirationSeconds - session expiration time in seconds (defaults to the configured default).
+     * @param params.organizationId - organization ID to target (defaults to the session's organization ID or the parent organization ID).
      * @returns A promise that resolves to a {@link WalletAuthResult}, which includes:
      *          - `sessionToken`: the signed JWT session token.
      *          - `address`: the authenticated wallet address.
      * @throws {TurnkeyError} If there is an error during wallet authentication, sub-organization creation, session storage, or cleanup.
      */
-    signUpWithWallet: (params: {
-        walletProvider: WalletProvider;
-        createSubOrgParams?: CreateSubOrgParams;
-        sessionKey?: string;
-        expirationSeconds?: string;
-    }) => Promise<WalletAuthResult>;
+    signUpWithWallet: (params: SignUpWithWalletParams) => Promise<WalletAuthResult>;
     /**
      * Logs in an existing user or signs up a new user using a wallet, creating a new sub-organization if needed.
      *
@@ -216,18 +191,14 @@ export declare class TurnkeyClient {
      * @param params.createSubOrgParams - optional parameters for creating a sub-organization (e.g., authenticators, user metadata).
      * @param params.sessionKey - session key to use for storing the session (defaults to the default session key).
      * @param params.expirationSeconds - session expiration time in seconds (defaults to the configured default).
+     * @param params.organizationId - organization ID to target (defaults to the session's organization ID or the parent organization ID).
      * @returns A promise that resolves to an object containing:
      *          - `sessionToken`: the signed JWT session token.
      *          - `address`: the authenticated wallet address.
      *          - `action`: whether the flow resulted in a login or signup ({@link AuthAction}).
      * @throws {TurnkeyError} If there is an error during wallet authentication, sub-organization creation, or session storage.
      */
-    loginOrSignupWithWallet: (params: {
-        walletProvider: WalletProvider;
-        createSubOrgParams?: CreateSubOrgParams;
-        sessionKey?: string;
-        expirationSeconds?: string;
-    }) => Promise<WalletAuthResult & {
+    loginOrSignupWithWallet: (params: LoginOrSignupWithWalletParams) => Promise<WalletAuthResult & {
         action: AuthAction;
     }>;
     /**
@@ -239,13 +210,11 @@ export declare class TurnkeyClient {
      *
      * @param params.otpType - type of OTP to initialize (OtpType.Email or OtpType.Sms).
      * @param params.contact - contact information for the user (e.g., email address or phone number).
+     * @param params.organizationId - optional organization ID to target (defaults to the session's organization ID or the parent organization ID).
      * @returns A promise that resolves to the OTP ID required for verification.
      * @throws {TurnkeyError} If there is an error during the OTP initialization process or if the maximum number of OTPs has been reached.
      */
-    initOtp: (params: {
-        otpType: OtpType;
-        contact: string;
-    }) => Promise<string>;
+    initOtp: (params: InitOtpParams) => Promise<string>;
     /**
      * Verifies the OTP code sent to the user.
      *
@@ -263,15 +232,7 @@ export declare class TurnkeyClient {
      *   - verificationToken: verification token to be used for login or sign-up.
      * @throws {TurnkeyError} If there is an error during the OTP verification process, such as an invalid code or network failure.
      */
-    verifyOtp: (params: {
-        otpId: string;
-        otpCode: string;
-        contact: string;
-        otpType: OtpType;
-    }) => Promise<{
-        subOrganizationId: string;
-        verificationToken: string;
-    }>;
+    verifyOtp: (params: VerifyOtpParams) => Promise<VerifyOtpResult>;
     /**
      * Logs in a user using an OTP verification token.
      *
@@ -289,12 +250,7 @@ export declare class TurnkeyClient {
      *          - `sessionToken`: the signed JWT session token.
      * @throws {TurnkeyError} If there is an error during the OTP login process or if key pair cleanup fails.
      */
-    loginWithOtp: (params: {
-        verificationToken: string;
-        publicKey?: string;
-        invalidateExisting?: boolean;
-        sessionKey?: string;
-    }) => Promise<BaseAuthResult>;
+    loginWithOtp: (params: LoginWithOtpParams) => Promise<BaseAuthResult>;
     /**
      * Signs up a user using an OTP verification token.
      *
@@ -314,14 +270,7 @@ export declare class TurnkeyClient {
      *          - `sessionToken`: the signed JWT session token.
      * @throws {TurnkeyError} If there is an error during the OTP sign-up process or session storage.
      */
-    signUpWithOtp: (params: {
-        verificationToken: string;
-        contact: string;
-        otpType: OtpType;
-        createSubOrgParams?: CreateSubOrgParams;
-        invalidateExisting?: boolean;
-        sessionKey?: string;
-    }) => Promise<BaseAuthResult>;
+    signUpWithOtp: (params: SignUpWithOtpParams) => Promise<BaseAuthResult>;
     /**
      * Completes the OTP authentication flow by verifying the OTP code and then either signing up or logging in the user.
      *
@@ -345,16 +294,7 @@ export declare class TurnkeyClient {
      *          - `action`: whether the flow resulted in a login or signup ({@link AuthAction}).
      * @throws {TurnkeyError} If there is an error during OTP verification, sign-up, or login.
      */
-    completeOtp: (params: {
-        otpId: string;
-        otpCode: string;
-        contact: string;
-        otpType: OtpType;
-        publicKey?: string;
-        invalidateExisting?: boolean;
-        sessionKey?: string;
-        createSubOrgParams?: CreateSubOrgParams;
-    }) => Promise<BaseAuthResult & {
+    completeOtp: (params: CompleteOtpParams) => Promise<BaseAuthResult & {
         verificationToken: string;
         action: AuthAction;
     }>;
@@ -378,14 +318,7 @@ export declare class TurnkeyClient {
      *          - `action`: whether the flow resulted in a login or signup ({@link AuthAction}).
      * @throws {TurnkeyError} If there is an error during the OAuth completion process, such as account lookup, sign-up, or login.
      */
-    completeOauth: (params: {
-        oidcToken: string;
-        publicKey: string;
-        providerName?: string;
-        sessionKey?: string;
-        invalidateExisting?: boolean;
-        createSubOrgParams?: CreateSubOrgParams;
-    }) => Promise<BaseAuthResult & {
+    completeOauth: (params: CompleteOauthParams) => Promise<BaseAuthResult & {
         action: AuthAction;
     }>;
     /**
@@ -404,12 +337,7 @@ export declare class TurnkeyClient {
      *          - `sessionToken`: the signed JWT session token.
      * @throws {TurnkeyError} If there is an error during the OAuth login process or if key pair cleanup fails.
      */
-    loginWithOauth: (params: {
-        oidcToken: string;
-        publicKey: string;
-        invalidateExisting?: boolean;
-        sessionKey?: string;
-    }) => Promise<BaseAuthResult>;
+    loginWithOauth: (params: LoginWithOauthParams) => Promise<BaseAuthResult>;
     /**
      * Signs up a user using OAuth authentication.
      *
@@ -427,13 +355,7 @@ export declare class TurnkeyClient {
      *          - `sessionToken`: the signed JWT session token.
      * @throws {TurnkeyError} If there is an error during the OAuth sign-up or login process.
      */
-    signUpWithOauth: (params: {
-        oidcToken: string;
-        publicKey: string;
-        providerName: string;
-        createSubOrgParams?: CreateSubOrgParams;
-        sessionKey?: string;
-    }) => Promise<BaseAuthResult>;
+    signUpWithOauth: (params: SignUpWithOauthParams) => Promise<BaseAuthResult>;
     /**
      * Fetches all wallets for the current user, including both embedded and connected wallets.
      *
@@ -443,15 +365,15 @@ export declare class TurnkeyClient {
      * - Returns both embedded and connected wallets in a single array, each with their respective accounts populated.
      * - Optionally allows stamping the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
      *
-     * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
      * @param params.walletProviders - array of wallet providers to use for fetching wallets.
+     * @param params.organizationId - organization ID to target (defaults to the session's organization ID).
+     * @param params.userId - user ID to target (defaults to the session's user ID).
+     * @param params.connectedOnly - if true, fetches only connected wallets; if false or undefined, fetches both embedded and connected wallets.
+     * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
      * @returns A promise that resolves to an array of `Wallet` objects.
      * @throws {TurnkeyError} If no active session is found or if there is an error fetching wallets.
      */
-    fetchWallets: (params?: {
-        walletProviders?: WalletProvider[] | undefined;
-        stampWith?: StamperType | undefined;
-    }) => Promise<Wallet[]>;
+    fetchWallets: (params?: FetchWalletsParams) => Promise<Wallet[]>;
     /**
      * Fetches all accounts for a specific wallet, including both embedded and connected wallet accounts.
      *
@@ -465,15 +387,13 @@ export declare class TurnkeyClient {
      * @param params.walletProviders - list of wallet providers to filter by (used for connected wallets).
      * @param params.paginationOptions - pagination options for embedded wallets.
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @param params.organizationId - organization ID to target (defaults to the session's organization ID).
+     * @param params.userId - user ID to target (defaults to the session's user ID).
+     *
      * @returns A promise that resolves to an array of `v1WalletAccount` objects.
      * @throws {TurnkeyError} If no active session is found or if there is an error fetching wallet accounts.
      */
-    fetchWalletAccounts: (params: {
-        wallet: Wallet;
-        walletProviders?: WalletProvider[];
-        paginationOptions?: v1Pagination;
-        stampWith?: StamperType | undefined;
-    }) => Promise<WalletAccount[]>;
+    fetchWalletAccounts: (params: FetchWalletAccountsParams) => Promise<WalletAccount[]>;
     /**
      * Fetches all private keys for the current user.
      *
@@ -481,97 +401,103 @@ export declare class TurnkeyClient {
      * - Supports stamping the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
      *
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @param params.organizationId - organization ID to target (defaults to the session's organization ID).
      * @returns A promise that resolves to an array of `v1PrivateKey` objects.
      * @throws {TurnkeyError} If no active session is found or if there is an error fetching private keys.
      */
-    fetchPrivateKeys: (params?: {
-        stampWith?: StamperType | undefined;
-    }) => Promise<v1PrivateKey[]>;
+    fetchPrivateKeys: (params?: FetchPrivateKeysParams) => Promise<v1PrivateKey[]>;
     /**
      * Signs a message using the specified wallet account.
      *
-     * - Supports both embedded and connected wallets.
-     * - For **connected wallets**:
+     * Behavior differs depending on the wallet type:
+     *
+     * - **Connected wallets**
      *   - Delegates signing to the wallet provider’s native signing method.
-     *   - **Important:** For Ethereum wallets (e.g., MetaMask), signatures follow [EIP-191](https://eips.ethereum.org/EIPS/eip-191).
-     *     The message is automatically prefixed with `"\x19Ethereum Signed Message:\n" + message length`
-     *     before signing. As a result, this signature **cannot be used as a raw transaction signature**
-     *     or broadcast on-chain.
-     * - For **embedded wallets**, uses the Turnkey API to sign the message directly.
-     * - Automatically handles message encoding and hashing based on the wallet account’s address format,
+     *   - *Ethereum*: signatures always follow [EIP-191](https://eips.ethereum.org/EIPS/eip-191).
+     *     - The wallet automatically prefixes messages with
+     *       `"\x19Ethereum Signed Message:\n" + message length` before signing.
+     *     - As a result, these signatures cannot be used as raw transaction signatures or broadcast on-chain.
+     *     - If `addEthereumPrefix` is set to `false`, an error is thrown because connected Ethereum wallets always prefix.
+     *   - *Other chains*: follows the native connected wallet behavior.
+     *
+     * - **Embedded wallets**
+     *   - Uses the Turnkey API to sign the message directly.
+     *   - Supports optional `addEthereumPrefix`:
+     *     - If `true` (default for Ethereum), the message is prefixed before signing.
+     *     - If `false`, the raw message is signed without any prefix.
+     *
+     * Additional details:
+     * - Automatically handles encoding and hashing based on the wallet account’s address format,
      *   unless explicitly overridden.
+     * - Optionally allows stamping with a specific stamper
+     *   (`StamperType.Passkey`, `StamperType.ApiKey`, or `StamperType.Wallet`).
      *
-     * @param params.message - message to sign.
+     * @param params.message - plaintext (UTF-8) message to sign.
      * @param params.walletAccount - wallet account to use for signing.
-     * @param params.encoding - override for the payload encoding (defaults to the encoding appropriate for the address type).
-     * @param params.hashFunction - override for the hash function (defaults to the hash function appropriate for the address type).
-     * @param params.stampWith - stamper to tag the signing request (e.g., Passkey, ApiKey, or Wallet).
-     * @param params.addEthereumPrefix - whether to prefix the message with Ethereum's `"\x19Ethereum Signed Message:\n"` string.
-     *   - If `true` (default for Ethereum), the message is prefixed before signing.
-     *   - If `false`:
-     *     - Connected wallets will throw an error because they always prefix automatically.
-     *     - Embedded wallets will sign the raw message without any prefix.
-     *
-     * @returns A promise resolving to a `v1SignRawPayloadResult` containing the signature and metadata.
-     * @throws {TurnkeyError} If signing fails, if the wallet account does not support signing, or if the response is invalid.
+     * @param params.encoding - override for payload encoding (defaults to the encoding appropriate for the address format).
+     * @param params.hashFunction - override for hash function (defaults to the function appropriate for the address format).
+     * @param params.stampWith - optional stamper for the signing request.
+     * @param params.addEthereumPrefix - whether to prefix the message with Ethereum’s
+     *   `"\x19Ethereum Signed Message:\n"` string (default: `true` for Ethereum).
+     * @param params.organizationId - organization ID to target (defaults to the session's organization ID).
+     *
+     * @returns A promise that resolves to a `v1SignRawPayloadResult` containing the signature and metadata.
+     * @throws {TurnkeyError} If signing fails, the wallet type does not support message signing, or the response is invalid.
      */
-    signMessage: (params: {
-        message: string;
-        walletAccount: WalletAccount;
-        encoding?: v1PayloadEncoding;
-        hashFunction?: v1HashFunction;
-        stampWith?: StamperType | undefined;
-        addEthereumPrefix?: boolean;
-    }) => Promise<v1SignRawPayloadResult>;
+    signMessage: (params: SignMessageParams) => Promise<v1SignRawPayloadResult>;
     /**
      * Signs a transaction using the specified wallet account.
      *
-     * - This function signs a blockchain transaction using the provided wallet address and transaction data.
-     * - Supports all Turnkey-supported blockchain networks (e.g., Ethereum, Solana, Tron).
-     * - Automatically determines the appropriate signing method based on the transaction type.
-     * - Delegates signing to the Turnkey API, which returns the signed transaction and related metadata.
-     * - Optionally allows stamping the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * Behavior differs depending on the type of wallet:
+     *
+     * - **Connected wallets**
+     *   - Ethereum: does not support raw transaction signing. Calling this function will throw an error instructing you to use `signAndSendTransaction` instead.
+     *   - Solana: supports raw transaction signing via the connected wallet provider.
+     *   - Other chains: not supported; will throw an error.
+     *
+     * - **Embedded wallets**
+     *   - Delegates signing to the Turnkey API, which returns the signed transaction.
+     *   - Supports all Turnkey-supported transaction types (e.g., Ethereum, Solana, Tron).
+     *   - Optionally allows stamping with a specific stamper (`StamperType.Passkey`, `StamperType.ApiKey`, or `StamperType.Wallet`).
      *
-     * @param params.walletAccount - wallet account to use for signing the transaction.
-     * @param params.unsignedTransaction - unsigned transaction data (serialized as a string) to be signed.
+     * @param params.walletAccount - wallet account to use for signing.
+     * @param params.unsignedTransaction - unsigned transaction data as a serialized
+     *   string in the canonical encoding for the given `transactionType`.
      * @param params.transactionType - type of transaction (e.g., "TRANSACTION_TYPE_ETHEREUM", "TRANSACTION_TYPE_SOLANA", "TRANSACTION_TYPE_TRON").
-     * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
-     * @returns A promise that resolves to a `TSignTransactionResponse` object containing the signed transaction and any additional signing metadata.
-     * @throws {TurnkeyError} If there is an error signing the transaction or if the response is invalid.
+     * @param params.stampWith - stamper to use for signing (`StamperType.Passkey`, `StamperType.ApiKey`, or `StamperType.Wallet`).
+     * @param params.organizationId - organization ID to target (defaults to the session's organization ID).
+     * @returns A promise that resolves to the signed transaction string.
+     * @throws {TurnkeyError} If the wallet type is unsupported, signing fails, or the response is invalid.
      */
-    signTransaction: (params: {
-        unsignedTransaction: string;
-        transactionType: v1TransactionType;
-        walletAccount: WalletAccount;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string>;
+    signTransaction: (params: SignTransactionParams) => Promise<string>;
     /**
      * Signs and broadcasts a transaction using the specified wallet account.
      *
-     * - For **connected wallets**:
-     *   - Calls the wallet’s native `signAndSendTransaction` method.
-     *   - Does **not** require an `rpcUrl`.
+     * Behavior differs depending on the type of wallet:
      *
-     * - For **embedded wallets**:
+     * - **Connected wallets**
+     *   - *Ethereum*: delegates to the wallet’s native `signAndSendTransaction` method.
+     *     - Does **not** require an `rpcUrl` (the wallet handles broadcasting).
+     *   - *Solana*: signs the transaction locally with the connected wallet, but requires an `rpcUrl` to broadcast it.
+     *   - Other chains: not supported; will throw an error.
+     *
+     * - **Embedded wallets**
      *   - Signs the transaction using the Turnkey API.
-     *   - Requires an `rpcUrl` to broadcast the transaction.
-     *   - Broadcasts the transaction using a JSON-RPC client.
-     *
-     * @param params.walletAccount - wallet account to use for signing and sending.
-     * @param params.unsignedTransaction - unsigned transaction (serialized string).
-     * @param params.transactionType - transaction type (e.g., "TRANSACTION_TYPE_SOLANA").
-     * @param params.rpcUrl - required for embedded wallets to broadcast the signed transaction.
-     * @param params.stampWith - optional stamper to tag the signing request.
+     *   - Requires an `rpcUrl` to broadcast the signed transaction, since Turnkey does not broadcast directly.
+     *   - Broadcasts the transaction using a JSON-RPC client and returns the resulting transaction hash/signature.
+     *   - Optionally allows stamping with a specific stamper (`StamperType.Passkey`, `StamperType.ApiKey`, or `StamperType.Wallet`).
+     *
+     * @param params.walletAccount - wallet account to use for signing and broadcasting.
+     * @param params.unsignedTransaction - unsigned transaction data as a serialized
+     *   string in the canonical encoding for the given `transactionType`.
+     * @param params.transactionType - type of transaction (e.g., `"TRANSACTION_TYPE_SOLANA"`, `"TRANSACTION_TYPE_ETHEREUM"`).
+     * @param params.rpcUrl - JSON-RPC endpoint used for broadcasting (required for Solana connected wallets and all embedded wallets).
+     * @param params.stampWith - optional stamper to use when signing (`StamperType.Passkey`, `StamperType.ApiKey`, or `StamperType.Wallet`).
+     * @param params.organizationId - **Only for Turnkey embedded wallets**: organization ID to target (defaults to the session's organization ID).
      * @returns A promise that resolves to a transaction signature or hash.
-     * @throws {TurnkeyError} If signing or broadcasting fails.
+     * @throws {TurnkeyError} If the wallet type is unsupported, or if signing/broadcasting fails.
      */
-    signAndSendTransaction: (params: {
-        unsignedTransaction: string;
-        transactionType: v1TransactionType;
-        walletAccount: WalletAccount;
-        rpcUrl?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string>;
+    signAndSendTransaction: (params: SignAndSendTransactionParams) => Promise<string>;
     /**
      * Fetches the user details for the current session or a specified user.
      *
@@ -587,11 +513,46 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves to a `v1User` object containing the user details.
      * @throws {TurnkeyError} If there is no active session, if there is no userId, or if there is an error fetching user details.
      */
-    fetchUser: (params?: {
-        organizationId?: string;
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<v1User>;
+    fetchUser: (params?: FetchUserParams) => Promise<v1User>;
+    /**
+     * Fetches an existing user by P-256 API key public key, or creates a new one if none exists.
+     *
+     * - This function is idempotent: multiple calls with the same `publicKey` will always return the same user.
+     * - Attempts to find a user whose API keys include the given P-256 public key.
+     * - If a matching user is found, it is returned as-is.
+     * - If no matching user is found, a new user is created with the given public key as a P-256 API key.
+     *
+     * @param params.publicKey - the P-256 public key to use for lookup and creation.
+     * @param params.createParams.userName - optional username to assign if creating a new user (defaults to `"Public Key User"`).
+     * @param params.createParams.apiKeyName - optional API key name to assign if creating a new API key (defaults to `public-key-user-${publicKey}`).
+     * @param params.organizationId - organization ID to specify the sub-organization (defaults to the current session's organizationId).
+     * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @returns A promise that resolves to the existing or newly created {@link v1User}.
+     * @throws {TurnkeyError} If there is no active session, if the input is invalid, if user retrieval fails, or if user creation fails.
+     */
+    fetchOrCreateP256ApiKeyUser: (params: FetchOrCreateP256ApiKeyUserParams) => Promise<v1User>;
+    /**
+     * Fetches each requested policy if it exists, or creates it if it does not.
+     *
+     * - This function is idempotent: multiple calls with the same policies will not create duplicates.
+     * - For every policy in the request:
+     *   - If it already exists, it is returned with its `policyId`.
+     *   - If it does not exist, it is created and returned with its new `policyId`.
+     *
+     * @param params.policies - the list of policies to fetch or create.
+     * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @param params.organizationId - organization ID to specify the sub-organization (defaults to the current session's organizationId).
+     * @returns A promise that resolves to an array of objects, each containing:
+     *          - `policyId`: the unique identifier of the policy.
+     *          - `policyName`: human-readable name of the policy.
+     *          - `effect`: the instruction to DENY or ALLOW an activity.
+     *          - `condition`: (optional) the condition expression that triggers the effect.
+     *          - `consensus`: (optional) the consensus expression that triggers the effect.
+     *          - `notes`: (optional) developer notes or description for the policy.
+     * @throws {TurnkeyError} If there is no active session, if the input is invalid,
+     *                        if fetching policies fails, or if creating policies fails.
+     */
+    fetchOrCreatePolicies: (params: FetchOrCreatePoliciesParams) => Promise<FetchOrCreatePoliciesResult>;
     /**
      * Updates the user's email address.
      *
@@ -605,15 +566,11 @@ export declare class TurnkeyClient {
      * @param params.verificationToken - verification token from OTP email verification (required if verifying the email).
      * @param params.userId - user ID to update a specific user's email (defaults to the current session's userId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @param params.organizationId - organization ID to specify the sub-organization (defaults to the current session's organizationId).
      * @returns A promise that resolves to the userId of the updated user.
      * @throws {TurnkeyError} If there is no active session, if the userId is missing, or if there is an error updating or verifying the user email.
      */
-    updateUserEmail: (params: {
-        email: string;
-        verificationToken?: string;
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string>;
+    updateUserEmail: (params: UpdateUserEmailParams) => Promise<string>;
     /**
      * Removes the user's email address.
      *
@@ -624,13 +581,11 @@ export declare class TurnkeyClient {
      *
      * @param params.userId - user ID to remove a specific user's email address (defaults to the current session's userId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @param params.organizationId - organization ID to specify the sub-organization (defaults to the current session's organizationId).
      * @returns A promise that resolves to the userId of the user whose email was removed.
      * @throws {TurnkeyError} If there is no active session, if the userId is missing, or if there is an error removing the user email.
      */
-    removeUserEmail: (params?: {
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string>;
+    removeUserEmail: (params?: RemoveUserEmailParams) => Promise<string>;
     /**
      * Updates the user's phone number.
      *
@@ -644,15 +599,11 @@ export declare class TurnkeyClient {
      * @param params.verificationToken - verification token from OTP phone verification (required if verifying the phone number).
      * @param params.userId - user ID to update a specific user's phone number (defaults to the current session's userId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @param params.organizationId - organization ID to specify the sub-organization (defaults to the current session's organizationId).
      * @returns A promise that resolves to the userId of the updated user.
      * @throws {TurnkeyError} If there is no active session, if the userId is missing, or if there is an error updating or verifying the user phone number.
      */
-    updateUserPhoneNumber: (params: {
-        phoneNumber: string;
-        verificationToken?: string;
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string>;
+    updateUserPhoneNumber: (params: UpdateUserPhoneNumberParams) => Promise<string>;
     /**
      * Removes the user's phone number.
      *
@@ -663,13 +614,11 @@ export declare class TurnkeyClient {
      *
      * @param params.userId - user ID to remove a specific user's phone number (defaults to the current session's userId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @param params.organizationId - organization ID to specify the sub-organization (defaults to the current session's organizationId).
      * @returns A promise that resolves to the userId of the user whose phone number was removed.
      * @throws {TurnkeyError} If there is no active session, if the userId is missing, or if there is an error removing the user phone number.
      */
-    removeUserPhoneNumber: (params?: {
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string>;
+    removeUserPhoneNumber: (params?: RemoveUserPhoneNumberParams) => Promise<string>;
     /**
      * Updates the user's name.
      *
@@ -682,14 +631,11 @@ export declare class TurnkeyClient {
      * @param params.userName - new name to set for the user.
      * @param params.userId - user ID to update a specific user's name (defaults to the current session's userId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @param params.organizationId - organization ID to specify the sub-organization (defaults to the current session's organizationId).
      * @returns A promise that resolves to the userId of the updated user.
      * @throws {TurnkeyError} If there is no active session, if the userId is missing, or if there is an error updating the user name.
      */
-    updateUserName: (params: {
-        userName: string;
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string>;
+    updateUserName: (params: UpdateUserNameParams) => Promise<string>;
     /**
      * Adds an OAuth provider to the user.
      *
@@ -702,17 +648,13 @@ export declare class TurnkeyClient {
      *
      * @param params.providerName - name of the OAuth provider to add (e.g., "Google", "Apple").
      * @param params.oidcToken - OIDC token for the OAuth provider.
+     * @param params.organizationId - organization ID to specify the sub-organization (defaults to the current session's organizationId).
      * @param params.userId - user ID to add the provider for a specific user (defaults to current session's userId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
      * @returns A promise that resolves to an array of provider IDs associated with the user.
      * @throws {TurnkeyError} If there is no active session, if the account already exists, or if there is an error adding the OAuth provider.
      */
-    addOauthProvider: (params: {
-        providerName: string;
-        oidcToken: string;
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string[]>;
+    addOauthProvider: (params: AddOauthProviderParams) => Promise<string[]>;
     /**
      * Removes a list of OAuth providers from the user.
      *
@@ -725,14 +667,11 @@ export declare class TurnkeyClient {
      * @param params.providerIds - IDs of the OAuth providers to remove.
      * @param params.userId - user ID to remove the provider for a specific user (defaults to the current session's userId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @param params.organizationId - organization ID to specify the sub-organization (defaults to the current session's organizationId).
      * @returns A promise that resolves to an array of provider IDs that were removed.
      * @throws {TurnkeyError} If there is no active session, if the userId is missing, or if there is an error removing the OAuth provider.
      */
-    removeOauthProviders: (params: {
-        providerIds: string[];
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string[]>;
+    removeOauthProviders: (params: RemoveOauthProvidersParams) => Promise<string[]>;
     /**
      * Adds a new passkey authenticator for the user.
      *
@@ -746,15 +685,11 @@ export declare class TurnkeyClient {
      * @param params.displayName - display name of the passkey (defaults to the value of `name`).
      * @param params.userId - user ID to add the passkey for a specific user (defaults to the current session's userId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @param params.organizationId - organization ID to specify the sub-organization (defaults to the current session's organizationId).
      * @returns A promise that resolves to an array of authenticator IDs for the newly added passkey(s).
      * @throws {TurnkeyError} If there is no active session, if passkey creation fails, or if there is an error adding the passkey.
      */
-    addPasskey: (params?: {
-        name?: string;
-        displayName?: string;
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string[]>;
+    addPasskey: (params?: AddPasskeyParams) => Promise<string[]>;
     /**
      * Removes passkeys (authenticator) from the user.
      *
@@ -767,14 +702,11 @@ export declare class TurnkeyClient {
      * @param params.authenticatorIds - IDs of the authenticators (passkeys) to remove.
      * @param params.userId - user ID to remove the passkeys for a specific user (defaults to the current session's userId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
+     * @param params.organizationId - organization ID to specify the sub-organization (defaults to the current session's organizationId).
      * @returns A promise that resolves to an array of authenticator IDs that were removed.
      * @throws {TurnkeyError} If there is no active session, if the userId is missing, or if there is an error removing the passkeys.
      */
-    removePasskeys: (params: {
-        authenticatorIds: string[];
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string[]>;
+    removePasskeys: (params: RemovePasskeyParams) => Promise<string[]>;
     /**
      * Creates a new wallet for sub-organization.
      *
@@ -794,13 +726,7 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves to the ID of the newly created wallet.
      * @throws {TurnkeyError} If there is no active session or if there is an error creating the wallet.
      */
-    createWallet: (params: {
-        walletName: string;
-        accounts?: v1WalletAccountParams[] | v1AddressFormat[];
-        organizationId?: string;
-        mnemonicLength?: number;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string>;
+    createWallet: (params: CreateWalletParams) => Promise<string>;
     /**
      * Creates new accounts in the specified wallet.
      *
@@ -818,12 +744,7 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves to an array of addresses for the newly created accounts.
      * @throws {TurnkeyError} If there is no active session, if the wallet does not exist, or if there is an error creating the wallet accounts.
      */
-    createWalletAccounts: (params: {
-        accounts: v1WalletAccountParams[] | v1AddressFormat[];
-        walletId: string;
-        organizationId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string[]>;
+    createWalletAccounts: (params: CreateWalletAccountsParams) => Promise<string[]>;
     /**
      * Exports a wallet as an encrypted bundle.
      *
@@ -841,12 +762,7 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves to an `ExportBundle` object containing the encrypted wallet seed phrase and metadata.
      * @throws {TurnkeyError} If there is no active session, if the targetPublicKey is missing, or if there is an error exporting the wallet.
      */
-    exportWallet: (params: {
-        walletId: string;
-        targetPublicKey: string;
-        organizationId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<ExportBundle>;
+    exportWallet: (params: ExportWalletParams) => Promise<ExportBundle>;
     /**
      * Exports a private key as an encrypted bundle.
      *
@@ -863,12 +779,7 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves to an `ExportBundle` object containing the encrypted private key and metadata.
      * @throws {TurnkeyError} If there is no active session, if the targetPublicKey is missing, or if there is an error exporting the private key.
      */
-    exportPrivateKey: (params: {
-        privateKeyId: string;
-        targetPublicKey: string;
-        organizationId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<ExportBundle>;
+    exportPrivateKey: (params: ExportPrivateKeyParams) => Promise<ExportBundle>;
     /**
      * Exports a wallet account as an encrypted bundle.
      *
@@ -886,12 +797,7 @@ export declare class TurnkeyClient {
      * @throws {TurnkeyError} If there is no active session, if the targetPublicKey is missing, or if there is an error exporting the wallet account.
      *
      */
-    exportWalletAccount: (params: {
-        address: string;
-        targetPublicKey: string;
-        organizationId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<ExportBundle>;
+    exportWalletAccount: (params: ExportWalletAccountParams) => Promise<ExportBundle>;
     /**
      * Imports a wallet from an encrypted bundle.
      *
@@ -905,18 +811,13 @@ export declare class TurnkeyClient {
      * @param params.encryptedBundle - encrypted bundle containing the wallet seed phrase and metadata.
      * @param params.walletName - name of the wallet to create upon import.
      * @param params.accounts - array of account parameters to create in the imported wallet (defaults to standard Ethereum and Solana accounts).
+     * @param params.organizationId - organization ID to import the wallet under a specific sub-organization (wallet will be associated with the sub-organization).
      * @param params.userId - user ID to import the wallet for a specific user (defaults to the current session's userId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
      * @returns A promise that resolves to the ID of the imported wallet.
      * @throws {TurnkeyError} If there is no active session, if the encrypted bundle is invalid, or if there is an error importing the wallet.
      */
-    importWallet: (params: {
-        encryptedBundle: string;
-        walletName: string;
-        accounts?: v1WalletAccountParams[];
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string>;
+    importWallet: (params: ImportWalletParams) => Promise<string>;
     /**
      * Imports a private key from an encrypted bundle.
      *
@@ -932,19 +833,13 @@ export declare class TurnkeyClient {
      * @param params.privateKeyName - name of the private key to create upon import.
      * @param params.curve - the cryptographic curve used to generate a given private key
      * @param params.addressFormat - address format of the private key to import.
+     * @param params.organizationId - organization ID to import the private key under a specific sub-organization (private key will be associated with the sub-organization).
      * @param params.userId - user ID to import the wallet for a specific user (defaults to the current session's userId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
      * @returns A promise that resolves to the ID of the imported wallet.
      * @throws {TurnkeyError} If there is no active session, if the encrypted bundle is invalid, or if there is an error importing the wallet.
      */
-    importPrivateKey: (params: {
-        encryptedBundle: string;
-        privateKeyName: string;
-        curve: v1Curve;
-        addressFormats: v1AddressFormat[];
-        userId?: string;
-        stampWith?: StamperType | undefined;
-    }) => Promise<string>;
+    importPrivateKey: (params: ImportPrivateKeyParams) => Promise<string>;
     /**
      * Deletes the current sub-organization (sub-org) for the active session.
      *
@@ -955,14 +850,12 @@ export declare class TurnkeyClient {
      * - Optionally allows stamping the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
      *
      * @param params.deleteWithoutExport - flag to delete the sub-organization without requiring all wallets to be exported first (defaults to false).
+     * @param params.organizationId - organization ID to delete a specific sub-organization (defaults to the current session's organizationId).
      * @param params.stampWith - parameter to stamp the request with a specific stamper.
      * @returns A promise that resolves to a `TDeleteSubOrganizationResponse` object containing the result of the deletion.
      * @throws {TurnkeyError} If there is no active session or if there is an error deleting the sub-organization.
      */
-    deleteSubOrganization: (params?: {
-        deleteWithoutExport?: boolean;
-        stampWith?: StamperType | undefined;
-    }) => Promise<TDeleteSubOrganizationResponse>;
+    deleteSubOrganization: (params?: DeleteSubOrganizationParams) => Promise<TDeleteSubOrganizationResponse>;
     /**
      * Stores a session token and updates the session associated with the specified session key, or by default the active session.
      *
@@ -977,10 +870,7 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves when the session is successfully stored.
      * @throws {TurnkeyError} If there is an error storing the session or cleaning up key pairs.
      */
-    storeSession: (params: {
-        sessionToken: string;
-        sessionKey?: string;
-    }) => Promise<void>;
+    storeSession: (params: StoreSessionParams) => Promise<void>;
     /**
      * Clears the session associated with the specified session key, or the active session by default.
      *
@@ -993,9 +883,7 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves when the session is successfully cleared.
      * @throws {TurnkeyError} If the session does not exist or if there is an error clearing the session.
      */
-    clearSession: (params?: {
-        sessionKey?: string;
-    }) => Promise<void>;
+    clearSession: (params?: ClearSessionParams) => Promise<void>;
     /**
      * Clears all sessions and resets the active session state.
      *
@@ -1026,13 +914,7 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves to a `TStampLoginResponse` object containing the refreshed session details.
      * @throws {TurnkeyError} If the session key does not exist, if there is no active session, or if there is an error refreshing the session.
      */
-    refreshSession: (params?: {
-        expirationSeconds?: string;
-        publicKey?: string;
-        sessionKey?: string;
-        invalidateExisitng?: boolean;
-        stampWith?: StamperType | undefined;
-    }) => Promise<TStampLoginResponse | undefined>;
+    refreshSession: (params?: RefreshSessionParams) => Promise<TStampLoginResponse | undefined>;
     /**
      * Retrieves the session associated with the specified session key, or the active session by default.
      *
@@ -1044,9 +926,7 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves to a `Session` object containing the session details, or undefined if not found.
      * @throws {TurnkeyError} If there is an error retrieving the session from storage.
      */
-    getSession: (params?: {
-        sessionKey?: string;
-    }) => Promise<Session | undefined>;
+    getSession: (params?: GetSessionParams) => Promise<Session | undefined>;
     /**
      * Retrieves all sessions stored in persistent storage.
      *
@@ -1071,9 +951,7 @@ export declare class TurnkeyClient {
      * @returns A promise that resolves when the active session key is successfully set.
      * @throws {TurnkeyError} If the client is not initialized or if there is an error setting the active session key.
      */
-    setActiveSession: (params: {
-        sessionKey: string;
-    }) => Promise<void>;
+    setActiveSession: (params: SetActiveSessionParams) => Promise<void>;
     /**
      * Retrieves the active session key currently set in persistent storage.
      *
@@ -1112,13 +990,7 @@ export declare class TurnkeyClient {
      * @returnparams.s A promise that resolves to the public key of the created or provided API key pair as a string.
      * @throws {TurnkeyError} If the API key stamper is not initialized or if there is an error during key pair creation or storage.
      */
-    createApiKeyPair: (params?: {
-        externalKeyPair?: CryptoKeyPair | {
-            publicKey: string;
-            privateKey: string;
-        };
-        storeOverride?: boolean;
-    }) => Promise<string>;
+    createApiKeyPair: (params?: CreateApiKeyPairParams) => Promise<string>;
     /**
      * Fetches the WalletKit proxy authentication configuration from the auth proxy.
      *