@getpara/core-sdk 2.0.0-alpha.6 → 2.0.0-alpha.61

package/dist/types/shares/enclave.d.ts

@@ -0,0 +1,81 @@
+import UserManagementClient from '@getpara/user-management-client';
+export interface ShareData {
+    userId: string;
+    walletId: string;
+    walletScheme: string;
+    partnerId?: string;
+    protocolId?: string;
+    signer: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface ShareQuery {
+    userId: string;
+    walletId?: string;
+    partnerId?: string;
+}
+export interface EncryptedPayload {
+    encryptedData: string;
+    keyId: string;
+    algorithm: string;
+    ephemeral: string;
+}
+/**
+ * Enclave client for secure key share operations
+ * Handles encryption/decryption and communication with the enclave service
+ */
+export declare class EnclaveClient {
+    private userManagementClient;
+    private enclavePublicKey;
+    private frontendKeyPair;
+    private retrieveJwt;
+    private persistJwt;
+    private retrieveRefreshJwt;
+    private persistRefreshJwt;
+    constructor({ userManagementClient, retrieveJwt, persistJwt, retrieveRefreshJwt, persistRefreshJwt, }: {
+        userManagementClient: UserManagementClient;
+        retrieveJwt: () => string;
+        persistJwt: (jwt: string) => void;
+        retrieveRefreshJwt: () => string;
+        persistRefreshJwt: (refreshJwt: string) => void;
+    });
+    private refreshJwt;
+    private withJwtRefreshRetry;
+    private issueEnclaveJwt;
+    /**
+     * Generate a P-256 keypair for the frontend to receive encrypted responses
+     */
+    private generateFrontendKeyPair;
+    /**
+     * Get the enclave's public key from the user-management service
+     */
+    private getEnclavePublicKey;
+    /**
+     * Import a PEM-formatted public key for use with Web Crypto API
+     */
+    private importPublicKeyFromPEM;
+    /**
+     * Export a public key to PEM format
+     */
+    private exportPublicKeyToPEM;
+    /**
+     * Encrypt data using P-256 ECIES for the enclave
+     */
+    private encryptForEnclave;
+    /**
+     * Decrypt response encrypted for the frontend
+     */
+    private decryptForFrontend;
+    /**
+     * Persist key shares to the enclave
+     * @param shares Array of share data to persist
+     */
+    private persistShares;
+    /**
+     * Retrieve key shares from the enclave
+     * @param query Query parameters for finding shares (single query or array of queries)
+     */
+    private retrieveShares;
+    retrieveSharesWithRetry(query: ShareQuery[]): Promise<ShareData[]>;
+    persistSharesWithRetry(shares: ShareData[]): Promise<any>;
+}

package/dist/types/shares/shareDistribution.d.ts

@@ -1,6 +1,6 @@
-import { BackupKitEmailProps } from '@getpara/user-management-client';
+import { BackupKitEmailProps, TWalletScheme } from '@getpara/user-management-client';
 import { Ctx } from '../types/index.js';
-export declare function distributeNewShare({ ctx, userId, walletId, userShare, ignoreRedistributingBackupEncryptedShare, emailProps, partnerId, protocolId, }: {
+export declare function distributeNewShare({ ctx, userId, walletId, userShare, ignoreRedistributingBackupEncryptedShare, emailProps, partnerId, protocolId, isEnclaveUser, walletScheme, }: {
     ctx: Ctx;
     userId: string;
     walletId: string;
@@ -9,4 +9,6 @@ export declare function distributeNewShare({ ctx, userId, walletId, userShare, i
     emailProps?: BackupKitEmailProps;
     partnerId?: string;
     protocolId?: string;
+    isEnclaveUser: boolean;
+    walletScheme: TWalletScheme;
 }): Promise<string>;

package/dist/types/types/assets.d.ts

@@ -0,0 +1,14 @@
+import { TNetwork, TOnRampAsset } from '@getpara/user-management-client';
+import { Wallet } from './wallet.js';
+export type AssetTransferType = 'INBOUND' | 'OUTBOUND';
+export type AssetTransfer = {
+    wallet: Omit<Wallet, 'signer'>;
+    type: AssetTransferType;
+    sourceAddress: string;
+    destinationAddress: string;
+    asset: TOnRampAsset;
+    network: TNetwork;
+    quantity: string;
+    chainId?: string;
+    contractAddress?: string;
+};

package/dist/types/types/auth.d.ts

@@ -0,0 +1,16 @@
+import { ExternalWalletInfo, TLinkedAccountType } from '@getpara/user-management-client';
+export type AccountLinkInProgress = {
+    id: string;
+    type: TLinkedAccountType;
+    identifier?: string;
+    isComplete: boolean;
+    externalWallet?: ExternalWalletInfo & {
+        signatureVerificationMessage: string;
+    };
+};
+export declare enum AccountLinkError {
+    NotAuthenticated = "No user is currently authenticated",
+    Conflict = "Account already linked",
+    Canceled = "Account linking was canceled",
+    Unknown = "An unknown error occurred"
+}

package/dist/types/types/config.d.ts

@@ -1,6 +1,6 @@
 import { AxiosInstance } from 'axios';
-import Client, { EmailTheme, Network, OnRampAsset, OnRampProvider, TWalletScheme, TWalletType } from '@getpara/user-management-client';
-import { Theme } from './theme.js';
+import Client, { EmailTheme, Network, OnRampAsset, OnRampProvider, PregenAuth, TWalletScheme, TWalletType, Theme } from '@getpara/user-management-client';
+import { EnclaveClient } from '../shares/enclave.js';
 export declare enum Environment {
     DEV = "DEV",
     SANDBOX = "SANDBOX",
@@ -13,6 +13,7 @@ export interface Ctx {
     env: Environment;
     apiKey: string;
     client: Client;
+    enclaveClient?: EnclaveClient;
     disableWorkers?: boolean;
     offloadMPCComputationURL?: string;
     mpcComputationClient?: AxiosInstance;
@@ -140,4 +141,12 @@ export interface ConstructorOpts {
      * Partner ID set in the Para Portal to track analytics for legacy SDK versions. This variable is unused outside of the Para Portal.
      */
     portalPartnerId?: string;
+    /**
+     * An optional function that fetches the pregenerated wallets for a given identifier so a user can claim them on account creation.
+     */
+    fetchPregenWalletsOverride?: (opts: {
+        pregenId: PregenAuth;
+    }) => Promise<{
+        userShare?: string;
+    }>;
 }

package/dist/types/types/coreApi.d.ts

@@ -1,24 +1,48 @@
-import { BackupKitEmailProps, CurrentWalletIds, ExternalWalletInfo, OnRampPurchase, OnRampPurchaseCreateParams, PregenAuth, Setup2faResponse, TelegramAuthResponse, VerifiedAuth, VerifyExternalWalletParams, WalletEntity, WalletParams, TWalletType } from '@getpara/user-management-client';
-import { AuthStateLogin, AuthStateVerify, OAuthResponse, AuthStateBaseParams, WithCustomTheme, WithUseShortUrls, Verify2faResponse, AuthStateSignup, AuthStateVerifyOrLogin, OAuthUrlParams, StorageType, PollParams, CoreAuthInfo, GetWalletBalanceParams, GetWalletBalanceResponse } from './methods.js';
+import { BackupKitEmailProps, CurrentWalletIds, ExternalWalletInfo, OnRampPurchase, OnRampPurchaseCreateParams, PregenAuth, Setup2faResponse, VerifiedAuth, VerifyExternalWalletParams, WalletEntity, WalletParams, TWalletType, IssueJwtParams, IssueJwtResponse, TLinkedAccountType, LinkedAccounts } from '@getpara/user-management-client';
+import { AuthStateLogin, AuthStateVerify, OAuthResponse, AuthStateBaseParams, WithCustomTheme, WithUseShortUrls, Verify2faResponse, AuthStateSignup, AuthStateVerifyOrLogin, OAuthUrlParams, StorageType, PollParams, CoreAuthInfo, GetWalletBalanceParams, GetWalletBalanceResponse, FarcasterParams, TelegramParams, OAuthParams } from './methods.js';
 import { ParaCore } from '../ParaCore.js';
 import { FullSignatureRes, Wallet } from './wallet.js';
-export declare const PARA_CORE_METHODS: readonly ["getAuthInfo", "signUpOrLogIn", "verifyNewAccount", "waitForLogin", "waitForSignup", "waitForWalletCreation", "getOAuthUrl", "verifyOAuth", "getFarcasterConnectUri", "verifyFarcaster", "verifyTelegram", "resendVerificationCode", "loginExternalWallet", "verifyExternalWallet", "setup2fa", "enable2fa", "verify2fa", "logout", "clearStorage", "isSessionActive", "isFullyLoggedIn", "refreshSession", "keepSessionAlive", "exportSession", "importSession", "getVerificationToken", "getWallets", "getWalletsByType", "fetchWallets", "createWallet", "createWalletPerType", "getPregenWallets", "hasPregenWallet", "updatePregenWalletIdentifier", "createPregenWallet", "createPregenWalletPerType", "claimPregenWallets", "createGuestWallets", "distributeNewWalletShare", "getUserShare", "setUserShare", "refreshShare", "signMessage", "signTransaction", "initiateOnRampTransaction", "getWalletBalance"];
+import { AccountLinkInProgress } from './auth.js';
+export declare const PARA_CORE_METHODS: readonly ["getAuthInfo", "signUpOrLogIn", "verifyNewAccount", "waitForLogin", "waitForSignup", "waitForWalletCreation", "getOAuthUrl", "verifyOAuth", "getFarcasterConnectUri", "verifyFarcaster", "verifyTelegram", "resendVerificationCode", "loginExternalWallet", "verifyExternalWallet", "setup2fa", "enable2fa", "verify2fa", "logout", "clearStorage", "isSessionActive", "isFullyLoggedIn", "refreshSession", "keepSessionAlive", "exportSession", "importSession", "getVerificationToken", "getWallets", "getWalletsByType", "fetchWallets", "createWallet", "createWalletPerType", "getPregenWallets", "hasPregenWallet", "updatePregenWalletIdentifier", "createPregenWallet", "createPregenWalletPerType", "claimPregenWallets", "createGuestWallets", "distributeNewWalletShare", "getUserShare", "setUserShare", "refreshShare", "signMessage", "signTransaction", "initiateOnRampTransaction", "getWalletBalance", "issueJwt", "getLinkedAccounts", "accountLinkInProgress"];
+export declare const PARA_INTERNAL_METHODS: readonly ["linkAccount", "unlinkAccount", "verifyEmailOrPhoneLink", "verifyOAuthLink", "verifyFarcasterLink", "verifyTelegramLink", "verifyExternalWalletLink", "accountLinkInProgress", "prepareLogin", "sendLoginCode"];
 export type CoreMethodName = (typeof PARA_CORE_METHODS)[number];
 export type CoreMethodParams<method extends CoreMethodName & keyof CoreMethods> = CoreMethods[method] extends {
     params: infer P;
 } ? P : never;
+export type CoreMethodIsGetter<method extends CoreMethodName & keyof CoreMethods> = CoreMethods[method] extends {
+    isGetter: true;
+} ? true : false;
 export type CoreMethodResponse<method extends CoreMethodName & keyof CoreMethods> = CoreMethods[method] extends {
     response: infer R;
 } ? CoreMethods[method] extends {
     sync: true;
 } ? R : Promise<R> : void;
-export type CoreMethod<method extends CoreMethodName & keyof CoreMethods> = CoreMethodParams<method> extends void | never ? () => CoreMethodResponse<method> : (_?: CoreMethodParams<method>) => CoreMethodResponse<method>;
+export type CoreMethod<method extends CoreMethodName & keyof CoreMethods> = CoreMethodIsGetter<method> extends true ? Awaited<CoreMethodResponse<method>> : CoreMethodParams<method> extends void | never ? () => CoreMethodResponse<method> : (_?: CoreMethodParams<method>) => CoreMethodResponse<method>;
 export type CoreAction<method extends CoreMethodName & keyof CoreMethods> = CoreMethodParams<method> extends void | never ? (_?: ParaCore) => CoreMethodResponse<method> : (_?: ParaCore, __?: CoreMethodParams<method>) => CoreMethodResponse<method>;
+export type InternalMethodName = (typeof PARA_INTERNAL_METHODS)[number];
+export type InternalMethodParams<method extends InternalMethodName & keyof InternalMethods> = InternalMethods[method] extends {
+    params: infer P;
+} ? P : never;
+export type InternalMethodIsGetter<method extends InternalMethodName & keyof InternalMethods> = InternalMethods[method] extends {
+    isGetter: true;
+} ? true : false;
+export type InternalMethodResponse<method extends InternalMethodName & keyof InternalMethods> = InternalMethods[method] extends {
+    response: infer R;
+} ? InternalMethods[method] extends {
+    sync: true;
+} ? R : Promise<R> : void;
+export type InternalMethod<method extends InternalMethodName & keyof InternalMethods> = InternalMethodIsGetter<method> extends true ? Awaited<InternalMethodResponse<method>> : InternalMethodParams<method> extends void | never ? () => InternalMethodResponse<method> : (_?: InternalMethodParams<method>) => InternalMethodResponse<method>;
+export type InternalAction<method extends InternalMethodName & keyof InternalMethods> = InternalMethodParams<method> extends void | never ? (_?: ParaCore) => InternalMethodResponse<method> : (_?: ParaCore, __?: InternalMethodParams<method>) => InternalMethodResponse<method>;
 export type CoreMethods = Record<CoreMethodName, {
     params?: unknown;
     response?: unknown;
     sync?: true;
 }> & {
+    accountLinkInProgress: {
+        params: never;
+        response: AccountLinkInProgress;
+        isGetter: true;
+    };
     getAuthInfo: {
         params: void;
         response: CoreAuthInfo | undefined;
@@ -94,21 +118,12 @@ export type CoreMethods = Record<CoreMethodName, {
     getOAuthUrl: {
         params: OAuthUrlParams & {
             sessionLookupId?: string;
+            encryptionKey?: string;
         };
         response: string;
     };
     verifyOAuth: {
-        params: AuthStateBaseParams & OAuthUrlParams & PollParams & {
-            /**
-             * A function returning a boolean, indicating whether the OAuth process should be cancelled.
-             */
-            isCanceled?: () => boolean;
-            /**
-             * A callback function that will be invoked with the OAuth URL when it is available.
-             * For example, you can use this to open the URL in a new window or tab.
-             */
-            onOAuthUrl?: (url: string) => void;
-        };
+        params: AuthStateBaseParams & OAuthParams;
         response: OAuthResponse;
     };
     getFarcasterConnectUri: {
@@ -116,26 +131,11 @@ export type CoreMethods = Record<CoreMethodName, {
         response: string;
     };
     verifyFarcaster: {
-        params: AuthStateBaseParams & PollParams & {
-            /**
-             * A function returning a boolean, indicating whether the Farcaster login process should be cancelled.
-             */
-            isCanceled?: () => boolean;
-            /**
-             * A callback function that will be invoked with the Farcaster Connect URI when it is available.
-             * You will need to display the URI as a QR code.
-             */
-            onConnectUri?: (uri: string) => void;
-        };
+        params: AuthStateBaseParams & FarcasterParams;
         response: OAuthResponse;
     };
     verifyTelegram: {
-        params: AuthStateBaseParams & {
-            /**
-             * The response received from the Telegram login bot.
-             */
-            telegramAuthResponse: TelegramAuthResponse;
-        };
+        params: AuthStateBaseParams & TelegramParams;
         response: OAuthResponse;
     };
     loginExternalWallet: {
@@ -143,16 +143,18 @@ export type CoreMethods = Record<CoreMethodName, {
             /**
              * The external wallet information to use for login.
              */
-            externalWallet: ExternalWalletInfo;
+            externalWallet: ExternalWalletInfo | ExternalWalletInfo[];
         };
         response: AuthStateVerifyOrLogin;
     };
     verifyExternalWallet: {
         params: AuthStateBaseParams & VerifyExternalWalletParams;
-        response: AuthStateSignup;
+        response: AuthStateSignup | AuthStateLogin;
     };
     resendVerificationCode: {
-        params: void;
+        params: {
+            type?: 'SIGNUP' | 'LINK_ACCOUNT' | 'LOGIN';
+        } | undefined;
         response: void;
     };
     logout: {
@@ -469,7 +471,70 @@ export type CoreMethods = Record<CoreMethodName, {
         params: GetWalletBalanceParams;
         response: GetWalletBalanceResponse;
     };
+    issueJwt: {
+        params: IssueJwtParams;
+        response: IssueJwtResponse;
+    };
+    getLinkedAccounts: {
+        params: {
+            withMetadata?: boolean;
+        };
+        response: LinkedAccounts & {
+            userId: string;
+        };
+    };
+};
+export type InternalMethods = {
+    linkAccount: {
+        params: {
+            auth: VerifiedAuth;
+        } | {
+            externalWallet: ExternalWalletInfo;
+        } | {
+            type: TLinkedAccountType | 'X';
+        };
+        response: AccountLinkInProgress;
+    };
+    unlinkAccount: {
+        params: {
+            linkedAccountId: string;
+        };
+        response: LinkedAccounts;
+    };
+    verifyEmailOrPhoneLink: {
+        params: {
+            verificationCode?: string;
+        };
+        response: LinkedAccounts;
+    };
+    verifyOAuthLink: {
+        params: OAuthParams;
+        response: LinkedAccounts;
+    };
+    verifyFarcasterLink: {
+        params: FarcasterParams;
+        response: LinkedAccounts;
+    };
+    verifyTelegramLink: {
+        params: TelegramParams;
+        response: LinkedAccounts;
+    };
+    verifyExternalWalletLink: {
+        params: Omit<VerifyExternalWalletParams, 'externalWallet'>;
+        response: LinkedAccounts;
+    };
+    prepareLogin: {
+        params: void;
+        response: string;
+    };
+    sendLoginCode: {
+        params: void;
+        response: void;
+    };
 };
 export type CoreInterface = {
-    [key in keyof CoreMethods]: CoreMethod<key>;
+    [key in keyof CoreMethods]: Partial<CoreMethod<key>>;
+};
+export type InternalInterface = {
+    [key in keyof InternalMethods]: Partial<InternalMethod<key>>;
 };

package/dist/types/types/events.d.ts

@@ -1,7 +1,8 @@
-import { CurrentWalletIds } from '@getpara/user-management-client';
+import { CurrentWalletIds, OnRampPurchase } from '@getpara/user-management-client';
 import { FullSignatureRes } from './wallet.js';
 import { Wallet } from './wallet.js';
 import { CoreMethodResponse } from './coreApi.js';
+import { AssetTransfer } from './assets.js';
 export declare enum ParaEvent {
     LOGIN_EVENT = "paraLogin",
     ACCOUNT_CREATION_EVENT = "paraAccountCreation",
@@ -13,7 +14,9 @@ export declare enum ParaEvent {
     WALLETS_CHANGE_EVENT = "paraWalletsChange",
     WALLET_CREATED = "paraWalletCreated",
     PREGEN_WALLET_CLAIMED = "paraPregenWalletClaimed",
-    GUEST_WALLETS_CREATED = "paraGuestWalletsCreated"
+    GUEST_WALLETS_CREATED = "paraGuestWalletsCreated",
+    ASSET_TRANSFERRED = "paraAssetTransferred",
+    ONRAMP_TRANSACTION_COMPLETE = "paraOnRampTransactionComplete"
 }
 export type BaseEvent<T> = {
     data: T;
@@ -48,3 +51,5 @@ export type PregenWalletClaimedResponse = {
 };
 export type PregenWalletClaimedEvent = CustomEventInit<BaseEvent<WalletCreatedResponse>>;
 export type GuestWalletsCreatedEvent = CustomEventInit<BaseEvent<CoreMethodResponse<'createGuestWallets'>>>;
+export type AssetTransferredEvent = CustomEventInit<BaseEvent<AssetTransfer>>;
+export type OnRampTransactionCompleteResponse = CustomEventInit<BaseEvent<OnRampPurchase>>;

package/dist/types/types/index.d.ts

@@ -1,10 +1,7 @@
+export * from './auth.js';
 export * from './config.js';
 export * from './coreApi.js';
 export * from './wallet.js';
 export * from './methods.js';
-export * from './theme.js';
-export * from './onRamps.js';
 export * from './popup.js';
-export * from './recovery.js';
 export * from './events.js';
-export { Network, OnRampAsset, OnRampProvider, OnRampPurchaseStatus, type OnRampPurchase, } from '@getpara/user-management-client';

package/dist/types/types/methods.d.ts

@@ -1,6 +1,4 @@
-import { PrimaryAuthInfo, ServerAuthStateLogin, ServerAuthStateSignup, AuthMethod, ServerAuthStateVerify, VerifiedAuth, AuthExtras, TOAuthMethod, TWalletType } from '@getpara/user-management-client';
-import { Theme } from './theme.js';
-import { RecoveryStatus } from './recovery.js';
+import { PrimaryAuthInfo, ServerAuthStateLogin, ServerAuthStateSignup, AuthMethod, ServerAuthStateVerify, VerifiedAuth, AuthExtras, RecoveryStatus, Theme, TOAuthMethod, TWalletType, TelegramAuthResponse, VerifyThirdPartyAuth, ServerAuthStateDone } from '@getpara/user-management-client';
 import { Wallet } from './wallet.js';
 type Device = {
     sessionId: string;
@@ -14,7 +12,7 @@ export type VerifyExternalWalletV1 = {
     cosmosPublicKeyHex?: string;
     cosmosSigner?: string;
 };
-export type PortalUrlType = 'createAuth' | 'createPassword' | 'loginAuth' | 'loginPassword' | 'txReview' | 'onRamp';
+export type PortalUrlType = 'createAuth' | 'createPassword' | 'loginAuth' | 'loginPassword' | 'txReview' | 'onRamp' | 'telegramLogin' | 'createPIN' | 'loginPIN' | 'oAuth' | 'oAuthCallback' | 'loginOTP' | 'telegramLoginVerify' | 'loginFarcaster';
 export type PortalUrlOptions = {
     params?: Record<string, string | undefined | null>;
     isForNewDevice?: boolean;
@@ -24,10 +22,14 @@ export type PortalUrlOptions = {
     portalTheme?: Theme;
     pathId?: string;
     shorten?: boolean;
+    isEmbedded?: boolean;
+    oAuthMethod?: OAuthUrlParams['method'];
+    appScheme?: string;
+    encryptionKey?: string;
 };
 export type WithAuthMethod = {
     /**
-     * Which authorization method to use for the URL, either `'passkey'` or `'passwprd'`.
+     * Which authorization method to use for the URL, either `'passkey'` or `'password'`.
      */
     authMethod?: Uppercase<AuthMethod>;
 };
@@ -49,6 +51,12 @@ export type WithShorten = {
      */
     shorten?: boolean;
 };
+export type WithIsPasskeySupported = {
+    /**
+     * Whether the current device supports WebAuth passkeys.
+     */
+    isPasskeySupported: boolean;
+};
 export type PollParams = {
     /**
      * A callback function that will be invoked on each method poll.
@@ -59,6 +67,25 @@ export type PollParams = {
      */
     onCancel?: () => void;
 };
+export type FarcasterParams = PollParams & {
+    /**
+     * A function returning a boolean, indicating whether the Farcaster login process should be cancelled.
+     */
+    isCanceled?: () => boolean;
+    /**
+     * A callback function that will be invoked with the Farcaster Connect URI when it is available.
+     * You will need to display the URI as a QR code.
+     */
+    onConnectUri?: (uri: string) => void;
+    serverAuthState?: VerifyThirdPartyAuth;
+};
+export type TelegramParams = {
+    /**
+     * The response received from the Telegram login bot.
+     */
+    telegramAuthResponse?: TelegramAuthResponse;
+    serverAuthState?: VerifyThirdPartyAuth;
+};
 export type LoginUrlParams = WithAuthMethod & WithCustomTheme & WithShorten & {
     sessionId?: string;
 };
@@ -74,13 +101,35 @@ export type OAuthUrlParams = {
      */
     method: Exclude<TOAuthMethod, 'TELEGRAM' | 'FARCASTER'>;
     /**
-     * The deeplink URL to redirect to after OAuth is complete.
+     * The app scheme to redirect to after OAuth is complete.
+     */
+    appScheme?: string;
+};
+export type OAuthParams = OAuthUrlParams & PollParams & {
+    /**
+     * A function returning a boolean, indicating whether the OAuth process should be cancelled.
+     */
+    isCanceled?: () => boolean;
+    /**
+     * A callback function that will be invoked with the OAuth URL when it is available.
+     * For example, you can use this to open the URL in a new window or tab.
+     *
+     * You should pass one of `onOAuthUrl` or `onOAuthPopup`, not both.
+     */
+    onOAuthUrl?: (url: string) => void;
+    /**
+     * A callback function that will be invoked with the OAuth popup window when it is available.
+     * If supplied, a window will automatically be opened for you if running on an applicable platform.
+     *
+     * You should pass one of `onOAuthUrl` or `onOAuthPopup`, not both.
      */
-    deeplinkUrl?: string;
+    onOAuthPopup?: (popup: Window) => void;
 };
 export type AuthStateBaseParams = WithCustomTheme & WithUseShortUrls;
-export type AuthStateVerify = ServerAuthStateVerify;
-export type AuthStateLogin = Omit<ServerAuthStateLogin, 'loginAuthMethods'> & {
+export type AuthStateVerify = ServerAuthStateVerify & {
+    loginUrl?: string;
+};
+export type AuthStateLogin = Omit<ServerAuthStateLogin, 'loginAuthMethods'> & WithIsPasskeySupported & {
     /**
      * A Para Portal URL for logging in via a WebAuth passkey. For best compatibility, you should open this URL in a new window or tab.
      */
@@ -93,8 +142,16 @@ export type AuthStateLogin = Omit<ServerAuthStateLogin, 'loginAuthMethods'> & {
      * A Para Portal URL for logging in via a password.
      */
     passwordUrl?: string;
+    /**
+     * A Para Portal URL for logging in via a PIN.
+     */
+    pinUrl?: string;
+    /**
+     * Supported login auth methods for this session.
+     */
+    loginAuthMethods?: AuthMethod[];
 };
-export type AuthStateSignup = Omit<ServerAuthStateSignup, 'signupAuthMethods'> & {
+export type AuthStateSignup = Omit<ServerAuthStateSignup, 'signupAuthMethods'> & WithIsPasskeySupported & {
     /**
      * A Para Portal URL for creating a new WebAuth passkey.
      */
@@ -103,6 +160,10 @@ export type AuthStateSignup = Omit<ServerAuthStateSignup, 'signupAuthMethods'> &
      * A Para Portal URL for creating a new user password.
      */
     passwordUrl?: string;
+    /**
+     * A Para Portal URL for creating a new user PIN.
+     */
+    pinUrl?: string;
     /**
      * The Para system ID for the newly generated passkey.
      */
@@ -111,11 +172,22 @@ export type AuthStateSignup = Omit<ServerAuthStateSignup, 'signupAuthMethods'> &
      * The Para system ID for the newly generated password.
      */
     passwordId?: string;
+    /**
+     * The Para system ID for the newly generated PIN.
+     */
+    pinId?: string;
+    /**
+     * Supported signup auth methods for this session.
+     */
+    signupAuthMethods?: AuthMethod[];
+};
+export type AuthStateDone = Omit<ServerAuthStateDone, 'authMethods'> & {
+    authMethods: AuthMethod[];
 };
 export type AuthStateVerifyOrLogin = AuthStateVerify | AuthStateLogin;
-export type AuthStateSignupOrLogin = AuthStateSignup | AuthStateLogin;
-export type OAuthResponse = AuthStateSignupOrLogin;
-export type AuthState = AuthStateVerify | AuthStateLogin | AuthStateSignup;
+export type AuthStateSignupOrLoginOrDone = AuthStateSignup | AuthStateLogin | AuthStateDone;
+export type OAuthResponse = AuthStateSignupOrLoginOrDone;
+export type AuthState = AuthStateVerify | AuthStateLogin | AuthStateSignup | AuthStateDone;
 export type Verify2faParams = {
     auth: VerifiedAuth;
     verificationCode: string;

package/dist/types/types/wallet.d.ts

@@ -1,5 +1,5 @@
-import { EmbeddedWalletType, ExternalWalletType, PartnerEntity, TPregenIdentifierType, TWalletScheme } from '@getpara/user-management-client';
-export interface Wallet {
+import { IWalletEntity, PartnerEntity, TPregenIdentifierType, TWalletScheme, TWalletType } from '@getpara/user-management-client';
+export interface Wallet extends Omit<IWalletEntity, 'createdAt' | 'updatedAt' | 'lastUsedAt' | 'scheme' | 'type' | 'userId' | 'keyGenComplete'> {
     createdAt?: string;
     id: string;
     name?: string;
@@ -8,7 +8,7 @@ export interface Wallet {
     addressSecondary?: string;
     publicKey?: string;
     scheme?: TWalletScheme;
-    type?: EmbeddedWalletType | ExternalWalletType;
+    type?: TWalletType;
     isPregen?: boolean;
     pregenIdentifier?: string;
     pregenIdentifierType?: TPregenIdentifierType;
@@ -20,6 +20,9 @@ export interface Wallet {
     lastUsedPartnerId?: string;
     isExternal?: boolean;
     isExternalWithParaAuth?: boolean;
+    externalProviderId?: string;
+    isExternalWithVerification?: boolean;
+    isExternalConnectionOnly?: boolean;
     ensName?: string | null;
     ensAvatar?: string | null;
 }
@@ -39,4 +42,4 @@ export interface DeniedSignatureResWithUrl extends DeniedSignatureRes {
 }
 export type SignatureRes = SuccessfulSignatureRes | DeniedSignatureRes;
 export type FullSignatureRes = SuccessfulSignatureRes | DeniedSignatureResWithUrl;
-export type ExternalWalletConnectionType = 'NONE' | 'CONNECTION_ONLY' | 'AUTHENTICATED';
+export type ExternalWalletConnectionType = 'NONE' | 'CONNECTION_ONLY' | 'AUTHENTICATED' | 'VERIFICATION';

package/dist/types/utils/config.d.ts

@@ -0,0 +1,7 @@
+import { BalancesConfig } from '@getpara/user-management-client';
+/**
+ * Validates if an object is a valid BalancesConfig
+ * @param obj - The object to validate
+ * @returns True if the object is a valid BalancesConfig, false otherwise
+ */
+export declare function validateBalancesConfig(obj: any): obj is BalancesConfig;

package/dist/types/utils/formatting.d.ts

@@ -1,4 +1,4 @@
-import { TWalletType } from '@getpara/user-management-client';
+import { AssetValue, TWalletType } from '@getpara/user-management-client';
 export type Hex = `0x${string}`;
 export interface Signature {
     r: Hex;
@@ -10,8 +10,19 @@ export declare function hexToSignature(hexSig: string): Signature;
 export declare function hexToUint8Array(hex: string): Uint8Array;
 export declare function hexToDecimal(hex: string): string;
 export declare function decimalToHex(decimal: string): Hex;
+export declare function compressPubkey(pubkey: Uint8Array): Uint8Array;
+export declare function rawSecp256k1PubkeyToRawAddress(pubkeyData: Uint8Array): Uint8Array;
 export declare function getCosmosAddress(publicKey: string, prefix: string): string;
 export declare function truncateAddress(str: string, addressType: TWalletType, { prefix, targetLength, }?: {
     prefix?: string;
     targetLength?: number;
 }): string;
+export declare function formatCurrency(value?: AssetValue, { fallback }?: {
+    fallback?: string;
+}): string;
+export declare function formatAssetQuantity({ quantity, symbol, decimals, fallback, }: {
+    quantity?: number;
+    symbol?: string;
+    decimals?: number;
+    fallback?: string;
+}): string;

package/dist/types/utils/index.d.ts

@@ -1,4 +1,5 @@
 export * from './autobind.js';
+export * from './config.js';
 export * from './events.js';
 export * from './formatting.js';
 export * from './json.js';