@getpara/core-sdk 2.0.0-dev.0 → 2.0.0-dev.1

package/dist/types/ParaCore.d.ts

@@ -1,11 +1,12 @@
-import { AuthMethod, BackupKitEmailProps, CurrentWalletIds, EmailTheme, WalletEntity, WalletType, WalletParams, OAuthMethod, OnRampPurchaseCreateParams, OnRampPurchase, TPregenIdentifierType, PregenIds, BiometricLocationHint, TelegramAuthResponse, VerifyTelegramRes, Auth, SupportedWalletTypes, AuthIdentifier, ExternalWalletLoginRes, SessionInfo, PrimaryAuth, PrimaryAuthType } from '@getpara/user-management-client';
+import { AuthMethod, AuthExtras, CurrentWalletIds, EmailTheme, WalletEntity, WalletType, OAuthMethod, TPregenIdentifierType, PregenIds, BiometricLocationHint, TelegramAuthResponse, VerifyTelegramRes, Auth, SupportedWalletTypes, AuthIdentifier, AuthType, ExternalWalletLoginRes, ExternalWalletInfo, PrimaryAuthInfo, SessionInfo, PrimaryAuth, PrimaryAuthType } from '@getpara/user-management-client';
 import type { pki as pkiType } from 'node-forge';
-import { Ctx, Environment, Theme, FullSignatureRes, ExternalWalletInfo, GetWebAuthUrlForLoginParams, AccountSetupResponse, LoginResponse, WalletFilters, WalletTypeProp, Wallet, PortalUrlOptions, ConstructorOpts, RecoveryStatus, CoreAuthInfo, AuthExtras, VerifyExternalWallet, ExternalWalletConnectionType } from './types/index.js';
+import { Ctx, Environment, Theme, FullSignatureRes, GetWebAuthUrlForLoginParams, AccountSetupResponse, LoginResponse, WalletFilters, WalletTypeProp, Wallet, PortalUrlOptions, ConstructorOpts, RecoveryStatus, CoreAuthInfo, PortalUrlType, PortalUrlOptionsV2, CoreMethodParams, CoreMethodResponse, OAuthUrlParams, NewCredentialUrlParams, LoginUrlParams, CoreInterface, VerifyExternalWalletV1, ExternalWalletConnectionType } from './types/index.js';
 import { PlatformUtils } from './PlatformUtils.js';
-export declare abstract class ParaCore {
+export declare abstract class ParaCore implements CoreInterface {
     #private;
     static version?: string;
     ctx: Ctx;
+    protected isNativePasskey: boolean;
     get authInfo(): CoreAuthInfo | undefined;
     get email(): AuthIdentifier<'email'> | undefined;
     get phone(): AuthIdentifier<'phone'> | undefined;
@@ -130,7 +131,7 @@ export declare abstract class ParaCore {
      * Remove all local storage and prefixed session storage.
      * @param {'local' | 'session' | 'secure' | 'all'} type - Type of storage to clear. Defaults to 'all'.
      */
-    clearStorage: (type?: 'local' | 'session' | 'secure' | 'all') => Promise<void>;
+    clearStorage: (type?: CoreMethodParams<'clearStorage'>) => CoreMethodResponse<'clearStorage'>;
     private convertBigInt;
     private convertEncryptionKeyPair;
     private isPortal;
@@ -163,6 +164,7 @@ export declare abstract class ParaCore {
     getWallets(): Record<string, Wallet>;
     getAddress(walletId?: string): string | undefined;
     protected abstract getPlatformUtils(): PlatformUtils;
+    protected constructPortalUrlV2(type: PortalUrlType, opts?: PortalUrlOptionsV2): Promise<string>;
     private constructPortalUrl;
     /**
      * Constructs a new `ParaCore` instance.
@@ -193,6 +195,8 @@ export declare abstract class ParaCore {
         extras?: AuthExtras;
         userId?: string;
     }): Promise<typeof this.authInfo>;
+    protected assertUserId(): string;
+    protected assertIsAuthSet(allowed?: AuthType[]): PrimaryAuthInfo;
     /**
      * Sets the email associated with the `ParaCore` instance.
      * @param email - Email to set.
@@ -307,18 +311,21 @@ export declare abstract class ParaCore {
     shortenLoginLink(link: string): Promise<string>;
     /**
      * Generates a URL for registering a new WebAuth passkey.
+     * @deprecated
      * @param {GetWebAuthUrlForLoginParams} opts the options object
      * @returns - the URL for creating a new passkey
      */
     getWebAuthURLForLogin(opts: GetWebAuthUrlForLoginParams): Promise<string>;
     /**
      * Generates a URL for registering a new user password.
+     * @deprecated
      * @param {GetWebAuthUrlForLoginParams} opts the options object
      * @returns - the URL for creating a new password
      */
     getPasswordURLForLogin(opts: GetWebAuthUrlForLoginParams): Promise<string>;
     /**
      * Generates a URL for registering a new WebAuth passkey for a phone number.
+     * @deprecated
      * @param {Omit<GetWebAuthUrlForLoginParams, 'authType'>} opts the options object
      * @returns - web auth url
      */
@@ -333,11 +340,12 @@ export declare abstract class ParaCore {
      * Fetches the wallets associated with the user.
      * @returns {WalletEntity[]} wallets that were fetched.
      */
-    fetchWallets(): Promise<WalletEntity[]>;
+    fetchWallets(): CoreMethodResponse<'fetchWallets'>;
     private populateWalletAddresses;
     private populatePregenWalletAddresses;
     /**
      * Checks if a user exists for an email address.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} opts.email the email to check.
      * @returns true if user exists, false otherwise.
@@ -347,6 +355,7 @@ export declare abstract class ParaCore {
     }): Promise<boolean>;
     /**
      * Checks if a user exists for a phone number.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} opts.phone - phone number to check.
      * @param {string} opts.countryCode - the country code.
@@ -355,12 +364,14 @@ export declare abstract class ParaCore {
     checkIfUserExistsByPhone(auth: Auth<'phone'>): Promise<boolean>;
     /**
      * Creates a new user.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} opts.email the email to use.
      */
     createUser({ email }: Auth<'email'>): Promise<void>;
     /**
      * Creates a new user with a phone number.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} opts.phone - the phone number to use for creating the user.
      * @param {string} opts.countryCode - the country code to use for creating the user.
@@ -368,6 +379,7 @@ export declare abstract class ParaCore {
     createUserByPhone(auth: Auth<'phone'>): Promise<void>;
     /**
      * Logs in or creates a new user using an external wallet address.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} opts.address the external wallet address to use for identification.
      * @param {WalletType} opts.type type of external wallet to use for identification.
@@ -376,6 +388,7 @@ export declare abstract class ParaCore {
     externalWalletLogin(wallet: ExternalWalletInfo): Promise<ExternalWalletLoginRes>;
     /**
      * Passes the email code obtained from the user for verification.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} verificationCode the six-digit code to check
      * @returns {string} the web auth url for creating a new credential
@@ -383,9 +396,11 @@ export declare abstract class ParaCore {
     verifyEmail({ verificationCode }: {
         verificationCode: string;
     }): Promise<string>;
-    verifyExternalWallet({ address, signedMessage, cosmosPublicKeyHex, cosmosSigner, }: VerifyExternalWallet): Promise<string>;
+    /** @deprecated */
+    verifyExternalWallet({ address, signedMessage, cosmosPublicKeyHex, cosmosSigner, }: VerifyExternalWalletV1): Promise<string>;
     /**
      * Passes the phone code obtained from the user for verification.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} verificationCode the six-digit code to check
      * @returns {string} the web auth url for creating a new credential
@@ -396,12 +411,14 @@ export declare abstract class ParaCore {
     /**
      * Validates the response received from an attempted Telegram login for authenticity, then
      * creates or retrieves the corresponding Para user and prepares the Para instance to sign in with that user.
+     * @deprecated
      * @param authResponse - the response JSON object received from the Telegram widget.
      * @returns `{ isValid: boolean; telegramUserId?: string; userId?: string; isNewUser?: boolean; supportedAuthMethods?: AuthMethod[]; biometricHints?: BiometricLocationHint[] }`
      */
     verifyTelegram(authObject: TelegramAuthResponse): Promise<VerifyTelegramRes>;
     /**
      * Performs 2FA verification.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} opts.email the email to use for performing a 2FA verification.
      * @param {string} opts.verificationCode the verification code to received via 2FA.
@@ -418,6 +435,7 @@ export declare abstract class ParaCore {
     }>;
     /**
      * Performs 2FA verification.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} opts.phone the phone number
      * @param {string} opts.countryCode - the country code
@@ -434,6 +452,7 @@ export declare abstract class ParaCore {
     }>;
     /**
      * Sets up two-factor authentication for the current user.
+     * @deprecated
      * @returns {string} uri - uri to use for setting up 2FA
      * */
     setup2FA(): Promise<{
@@ -441,6 +460,7 @@ export declare abstract class ParaCore {
     }>;
     /**
      * Enables 2FA.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} opts.verificationCode - the verification code received via 2FA.
      */
@@ -449,6 +469,7 @@ export declare abstract class ParaCore {
     }): Promise<void>;
     /**
      * Determines if 2FA has been set up.
+     * @deprecated
      * @returns {Object} `{ isSetup: boolean }` - true if 2FA is setup, false otherwise
      */
     check2FAStatus(): Promise<{
@@ -457,13 +478,15 @@ export declare abstract class ParaCore {
     /**
      * Resend a verification email for the current user.
      */
-    resendVerificationCode(): Promise<void>;
+    resendVerificationCode(): CoreMethodResponse<'resendVerificationCode'>;
     /**
      * Resend a verification SMS for the current user.
+     * @deprecated
      */
     resendVerificationCodeByPhone(): Promise<void>;
     /**
      * Returns a URL for setting up a new WebAuth passkey.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} opts.authType - the auth type to use
      * @param {boolean} opts.isForNewDevice whether the passkey is for a new device of an existing user
@@ -472,6 +495,7 @@ export declare abstract class ParaCore {
     getSetUpBiometricsURL({ authType, isForNewDevice, }?: Pick<PortalUrlOptions, 'authType' | 'isForNewDevice'>): Promise<string>;
     /**
      * Returns a URL for setting up a new WebAuth passkey for a phone number.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {boolean} opts.isForNewDevice whether the passkey is for a new device of an existing user
      * @returns {string} the URL
@@ -479,6 +503,7 @@ export declare abstract class ParaCore {
     getSetUpBiometricsURLForPhone({ isForNewDevice, }?: Pick<PortalUrlOptions, 'isForNewDevice'>): Promise<string>;
     /**
      * Returns a URL for setting up a new password.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {string} opts.authType - the auth type to use
      * @param {boolean} opts.isForNewDevice whether the passkey is for a new device of an existing user
@@ -490,20 +515,23 @@ export declare abstract class ParaCore {
      * Checks if the current session is active.
      * @returns `true` if active, `false` otherwise
      */
-    isSessionActive(): Promise<boolean>;
+    isSessionActive(): CoreMethodResponse<'isSessionActive'>;
     /**
      * Checks if a session is active and a wallet exists.
      * @returns `true` if active, `false` otherwise
      **/
-    isFullyLoggedIn(): Promise<boolean>;
+    isFullyLoggedIn(): CoreMethodResponse<'isFullyLoggedIn'>;
+    /** @deprecated */
     protected supportedAuthMethods(auth: Auth<PrimaryAuthType | 'userId'>): Promise<Set<AuthMethod>>;
     /**
      * Get hints associated with the users stored biometrics.
+     * @deprecated
      * @returns Array containing useragents and AAGuids for stored biometrics
      */
     protected getUserBiometricLocationHints(): Promise<BiometricLocationHint[]>;
     /**
      * Initiates a login.
+     * @deprecated
      * @param {Object} opts the options object
      * @param {String} opts.email - the email to login with
      * @param {boolean} opts.useShortURL - whether to shorten the link
@@ -514,12 +542,14 @@ export declare abstract class ParaCore {
     }): Promise<string>;
     /**
      * Initiates a login.
+     * @deprecated
      * @param email - the email to login with
      * @returns - a set of supported auth methods for the user
      **/
     initiateUserLoginV2(auth: PrimaryAuth): Promise<Set<AuthMethod>>;
     /**
      * Initiates a login.
+     * @deprecated
      * @param opts the options object
      * @param opts.phone the phone number
      * @param opts.countryCode the country code
@@ -530,23 +560,29 @@ export declare abstract class ParaCore {
         useShortUrl?: boolean;
     }): Promise<string>;
     /**
+     * @deprecated
      * Waits for the session to be active.
      **/
     waitForAccountCreation({ popupWindow }?: {
         popupWindow?: Window | null;
     }): Promise<boolean>;
+    /**
+     * @deprecated
+     */
     waitForPasskeyAndCreateWallet({ popupWindow, }?: {
         popupWindow?: Window;
     }): Promise<AccountSetupResponse>;
     /**
      * Initiates a Farcaster login attempt and return the URI for the user to connect.
      * You can create a QR code with this URI that works with Farcaster's mobile app.
+     * @deprecated
      * @return {string} the Farcaster connect URI
      */
     getFarcasterConnectURL(): Promise<string>;
     /**
      * Awaits the response from a user's attempt to log in with Farcaster.
      * If successful, this returns the user's Farcaster username and profile picture and indicates whether the user already exists.
+     * @deprecated
      * @return {Object} `{userExists: boolean; username: string; pfpUrl?: string | null }` - the user's information and whether the user already exists.
      */
     waitForFarcasterStatus(): Promise<{
@@ -557,7 +593,7 @@ export declare abstract class ParaCore {
     }>;
     /**
      * Generates a URL for the user to log in with OAuth using a desire method.
-     *
+     * @deprecated
      * @param {Object} opts the options object
      * @param {OAuthMethod} opts.method the third-party service to use for OAuth.
      * @param {string} [opts.deeplinkUrl] the deeplink to redirect to after the OAuth flow. This is for mobile only.
@@ -570,7 +606,7 @@ export declare abstract class ParaCore {
     /**
      * Awaits the response from a user's attempt to log in with OAuth.
      * If successful, this returns the user's email address and indicates whether the user already exists.
-     *
+     * @deprecated
      * @param {Object} opts the options object.
      * @param {Window} [opts.popupWindow] the popup window being used for login.
      * @return {Object} `{ email?: string; isError?: boolean; userExists: boolean; }` the result data
@@ -584,7 +620,7 @@ export declare abstract class ParaCore {
     }>;
     /**
      * Waits for the session to be active and sets up the user.
-     *
+     * @deprecated
      * @param {Object} opts the options object
      * @param {Window} [opts.popupWindow] the popup window being used for login.
      * @param {boolean} [opts.skipSessionRefresh] whether to skip refreshing the session.
@@ -602,9 +638,7 @@ export declare abstract class ParaCore {
      * @param {boolean} [shouldOpenPopup] - if `true`, the running device will open a popup to reauthenticate the user.
      * @returns a URL for the user to reauthenticate.
      **/
-    refreshSession({ shouldOpenPopup }?: {
-        shouldOpenPopup?: boolean;
-    }): Promise<string>;
+    refreshSession({ shouldOpenPopup, }?: CoreMethodParams<'refreshSession'>): CoreMethodResponse<'refreshSession'>;
     /**
      * Call this method after login to ensure that the user ID is set
      * internally.
@@ -625,7 +659,7 @@ export declare abstract class ParaCore {
      * @param {any[]} opts.temporaryShares optional temporary shares to use for decryption.
      * @param {boolean} [opts.skipSessionRefresh] - whether or not to skip refreshing the session.
      **/
-    setupAfterLogin({ temporaryShares, skipSessionRefresh, }?: {
+    protected setupAfterLogin({ temporaryShares, skipSessionRefresh, }?: {
         temporaryShares?: any[];
         skipSessionRefresh?: boolean;
     }): Promise<void>;
@@ -638,12 +672,7 @@ export declare abstract class ParaCore {
      * @param {boolean} opts.forceRefreshRecovery whether or not to force recovery secret regeneration. Used when regenerating recovery shares.
      * @returns {string} the recovery share.
      **/
-    distributeNewWalletShare({ walletId, userShare, skipBiometricShareCreation, forceRefresh, }: {
-        walletId: string;
-        userShare?: string;
-        skipBiometricShareCreation?: boolean;
-        forceRefresh?: boolean;
-    }): Promise<string>;
+    distributeNewWalletShare({ walletId, userShare, skipBiometricShareCreation, forceRefresh, }: CoreMethodParams<'distributeNewWalletShare'>): CoreMethodResponse<'distributeNewWalletShare'>;
     private waitForWalletAddress;
     /**
      * Waits for a pregen wallet address to be created.
@@ -662,14 +691,7 @@ export declare abstract class ParaCore {
      *
      * @deprecated alias for `createWalletPerType`
      **/
-    createWalletPerMissingType: ({ skipDistribute, types, }?: {
-        skipDistribute?: boolean;
-        types?: WalletType[];
-    }) => Promise<{
-        wallets: Wallet[];
-        walletIds: CurrentWalletIds;
-        recoverySecret?: string;
-    }>;
+    createWalletPerMissingType: ({ skipDistribute, types, }?: CoreMethodParams<'createWalletPerType'>) => CoreMethodResponse<'createWalletPerType'>;
     /**
      * Creates several new wallets with the desired types. If no types are provided, this method
      * will create one for each of the non-optional types specified in the instance's `supportedWalletTypes`
@@ -681,14 +703,7 @@ export declare abstract class ParaCore {
      * @param {WalletType[]} [opts.types] the types of wallets to create.
      * @returns {Object} the wallets created, their ids, and the recovery secret.
      **/
-    createWalletPerType({ skipDistribute, types, }?: {
-        skipDistribute?: boolean;
-        types?: WalletType[];
-    }): Promise<{
-        wallets: Wallet[];
-        walletIds: CurrentWalletIds;
-        recoverySecret?: string;
-    }>;
+    createWalletPerType({ skipDistribute, types, }?: CoreMethodParams<'createWalletPerType'>): CoreMethodResponse<'createWalletPerType'>;
     /**
      * Refresh the current user share for a wallet.
      *
@@ -701,19 +716,7 @@ export declare abstract class ParaCore {
      * @param {boolean} [opts.redistributeBackupEncryptedShares] whether or not to redistribute backup encrypted shares.
      * @returns {Object} the new user share and recovery secret.
      **/
-    refreshShare({ walletId, share, oldPartnerId, newPartnerId, keyShareProtocolId, redistributeBackupEncryptedShares, }: {
-        walletId: string;
-        share: string;
-        oldPartnerId?: string;
-        newPartnerId?: string;
-        keyShareProtocolId?: string;
-        redistributeBackupEncryptedShares?: boolean;
-        emailProps?: BackupKitEmailProps;
-    }): Promise<{
-        signer: string;
-        recoverySecret?: string;
-        protocolId: string;
-    }>;
+    refreshShare({ walletId, share, oldPartnerId, newPartnerId, keyShareProtocolId, redistributeBackupEncryptedShares, }: CoreMethodParams<'refreshShare'>): CoreMethodResponse<'refreshShare'>;
     /**
      * Creates a new wallet.
      * @param {Object} opts the options object.
@@ -721,13 +724,10 @@ export declare abstract class ParaCore {
      * @param {boolean} opts.skipDistribute - if true, recovery share will not be distributed.
      * @returns {[Wallet, string | null]} `[wallet, recoveryShare]` - the wallet object and the new recovery share.
      **/
-    createWallet({ type: _type, skipDistribute, }?: {
-        type?: WalletType;
-        skipDistribute?: boolean;
-    }): Promise<[Wallet, string | null]>;
+    createWallet({ type: _type, skipDistribute, }?: CoreMethodParams<'createWallet'>): CoreMethodResponse<'createWallet'>;
     /**
      * Creates a new pregenerated wallet.
-     *
+     * @deprecated
      * @param {Object} opts the options object.
      * @param {string} opts.pregenIdentifier the identifier associated with the new wallet.
      * @param {TPregenIdentifierType} [opts.pregenIdentifierType] the identifier type. Defaults to `EMAIL`.
@@ -743,6 +743,7 @@ export declare abstract class ParaCore {
      * Creates new pregenerated wallets for each desired type.
      * If no types are provided, this method will create one for each of the non-optional types
      * specified in the instance's `supportedWalletTypes` array that are not already present.
+     * @deprecated
      * @param {Object} opts the options object.
      * @param {string} opts.pregenIdentifier the identifier to associate each wallet with.
      * @param {TPregenIdentifierType} opts.pregenIdentifierType - either `'EMAIL'` or `'PHONE'`.
@@ -756,7 +757,7 @@ export declare abstract class ParaCore {
     }): Promise<Wallet[]>;
     /**
      * Claims a pregenerated wallet.
-     *
+     * @deprecated
      * @param {Object} opts the options object.
      * @param {string} opts.pregenIdentifier string the identifier of the user claiming the wallet
      * @param {TPregenIdentifierType} opts.pregenIdentifierType type of the identifier of the user claiming the wallet
@@ -768,6 +769,7 @@ export declare abstract class ParaCore {
     }): Promise<string | undefined>;
     /**
      * Updates the identifier for a pregen wallet.
+     * @deprecated
      * @param {Object} opts the options object.
      * @param {string} opts.walletId the pregen wallet ID
      * @param {string} opts.newPregenIdentifier the new identtifier
@@ -780,6 +782,7 @@ export declare abstract class ParaCore {
     }): Promise<void>;
     /**
      * Checks if a pregen Wallet exists for the given identifier with the current partner.
+     * @deprecated
      * @param {Object} opts the options object.
      * @param {string} opts.pregenIdentifier string the identifier of the user claiming the wallet
      * @param {TPregenIdentifierType} opts.pregenIdentifierType type of the string of the identifier of the user claiming the wallet
@@ -791,6 +794,7 @@ export declare abstract class ParaCore {
     }): Promise<boolean>;
     /**
      * Get pregen wallets for the given identifier.
+     * @deprecated
      * @param {Object} opts the options object.
      * @param {string} opts.pregenIdentifier - the identifier of the user claiming the wallet
      * @param {TPregenIdentifierType} opts.pregenIdentifierType - type of the identifier of the user claiming the wallet
@@ -805,12 +809,12 @@ export declare abstract class ParaCore {
      * Encodes the current wallets encoded in Base 64.
      * @returns {string} the encoded wallet string
      **/
-    getUserShare(): string | null;
+    getUserShare(): CoreMethodResponse<'getUserShare'>;
     /**
      * Sets the current wallets from a Base 64 string.
      * @param {string} base64Wallet the encoded wallet string
      **/
-    setUserShare(base64Wallets: string | null): Promise<void>;
+    setUserShare(base64Wallets: CoreMethodParams<'setUserShare'>): CoreMethodResponse<'setUserShare'>;
     private getTransactionReviewUrl;
     private getOnRampTransactionUrl;
     /**
@@ -824,12 +828,7 @@ export declare abstract class ParaCore {
      * @param {number} [opts.timeout] optional timeout in milliseconds. If not present, defaults to 30 seconds.
      * @param {string} [opts.cosmosSignDocBase64] the Cosmos `SignDoc` in base64, if applicable
      **/
-    signMessage({ walletId, messageBase64, timeoutMs, cosmosSignDocBase64, }: {
-        walletId: string;
-        messageBase64: string;
-        timeoutMs?: number;
-        cosmosSignDocBase64?: string;
-    }): Promise<FullSignatureRes>;
+    signMessage({ walletId, messageBase64, timeoutMs, cosmosSignDocBase64, isCanceled, onCancel, onPoll, }: CoreMethodParams<'signMessage'>): CoreMethodResponse<'signMessage'>;
     private signMessageInner;
     /**
      * Signs a transaction.
@@ -839,12 +838,7 @@ export declare abstract class ParaCore {
      * @param {string} [opts.chainId] the EVM chain id of the chain the transaction is being sent on, if applicable
      * @param {number} [opts.timeoutMs] the amount of time to wait for the user to sign the transaction, in milliseconds
      **/
-    signTransaction({ walletId, rlpEncodedTxBase64, chainId, timeoutMs, }: {
-        walletId: string;
-        rlpEncodedTxBase64: string;
-        chainId: string;
-        timeoutMs?: number;
-    }): Promise<FullSignatureRes>;
+    signTransaction({ walletId, rlpEncodedTxBase64, chainId, timeoutMs, isCanceled, onCancel, onPoll, }: CoreMethodParams<'signTransaction'>): CoreMethodResponse<'signTransaction'>;
     /**
      * @deprecated
      * Sends a transaction.
@@ -866,13 +860,7 @@ export declare abstract class ParaCore {
      * @param {string} opts.walletId the wallet ID to use for the transaction, where funds will be sent or withdrawn.
      * @param {string} opts.externalWalletAddress the external wallet address to send funds to or withdraw funds from, if using an external wallet.
      **/
-    initiateOnRampTransaction(options: WalletParams & {
-        params: OnRampPurchaseCreateParams;
-        shouldOpenPopup?: boolean;
-    }): Promise<{
-        onRampPurchase: OnRampPurchase;
-        portalUrl: string;
-    }>;
+    initiateOnRampTransaction(options: CoreMethodParams<'initiateOnRampTransaction'>): CoreMethodResponse<'initiateOnRampTransaction'>;
     /**
      * Returns `true` if session was successfully kept alive, `false` otherwise.
      **/
@@ -881,22 +869,37 @@ export declare abstract class ParaCore {
      * Serialize the current session for import by another Para instance.
      * @returns {string} the serialized session
      */
-    exportSession(): string;
+    exportSession(): CoreMethodResponse<'exportSession'>;
     /**
      * Imports a session serialized by another Para instance.
      * @param {string} serializedInstanceBase64 the serialized session
      */
-    importSession(serializedInstanceBase64: string): Promise<void>;
+    importSession(serializedInstanceBase64: CoreMethodParams<'importSession'>): CoreMethodResponse<'importSession'>;
+    /**
+     * @deprecated
+     */
     protected exitAccountCreation(): void;
+    /**
+     * @deprecated
+     */
     protected exitLogin(): void;
+    /**
+     * @deprecated
+     */
     protected exitFarcaster(): void;
+    /**
+     * @deprecated
+     */
     protected exitOAuth(): void;
+    /**
+     * @deprecated
+     */
     protected exitLoops(): void;
     /**
      * Retrieves a token to verify the current session.
      * @returns {Promise<string>} the ID
      **/
-    getVerificationToken(): Promise<string>;
+    getVerificationToken(): CoreMethodResponse<'getVerificationToken'>;
     /**
      * Logs the user out.
      * @param {Object} opts the options object.
@@ -905,6 +908,7 @@ export declare abstract class ParaCore {
     logout({ clearPregenWallets }?: {
         clearPregenWallets?: boolean;
     }): Promise<void>;
+    /** @deprecated */
     protected getSupportedCreateAuthMethods(): Promise<Set<AuthMethod>>;
     /**
      * Converts to a string, removing sensitive data when logging this class.
@@ -912,4 +916,107 @@ export declare abstract class ParaCore {
      * Doesn't work for all types of logging.
      **/
     toString(): string;
+    /** NEW METHODS */
+    protected getNewCredentialAndUrl({ authMethod, isForNewDevice, portalTheme, shorten, }: NewCredentialUrlParams): Promise<{
+        credentialId: string;
+        url: string;
+    }>;
+    protected getLoginUrlV2({ authMethod, shorten, portalTheme, sessionId, }: LoginUrlParams): Promise<string>;
+    protected getOAuthUrlV2({ method, deeplinkUrl }: OAuthUrlParams): Promise<string>;
+    signUpOrLogInV2({ auth, ...urlOptions }: CoreMethodParams<'signUpOrLogInV2'>): CoreMethodResponse<'signUpOrLogInV2'>;
+    verifyNewAccountV2({ verificationCode, ...urlOptions }: CoreMethodParams<'verifyNewAccountV2'>): CoreMethodResponse<'verifyNewAccountV2'>;
+    verifyOAuthV2({ method, deeplinkUrl, isCanceled, onCancel, onPoll, onOAuthUrl, ...urlOptions }: CoreMethodParams<'verifyOAuthV2'>): CoreMethodResponse<'verifyOAuthV2'>;
+    verifyFarcasterV2({ isCanceled, onConnectUri, onCancel, onPoll, ...urlOptions }: CoreMethodParams<'verifyFarcasterV2'>): CoreMethodResponse<'verifyFarcasterV2'>;
+    /**
+     * Validates the response received from an attempted Telegram login for authenticity, then
+     * creates or retrieves the corresponding Para user and prepares the Para instance to sign in with that user.
+     * @param authResponse - the response JSON object received from the Telegram widget.
+     * @returns `{ isValid: boolean; telegramUserId?: string; userId?: string; isNewUser?: boolean; supportedAuthMethods?: AuthMethod[]; biometricHints?: BiometricLocationHint[] }`
+     */
+    verifyTelegramV2({ telegramAuthResponse, ...urlOptions }: CoreMethodParams<'verifyTelegramV2'>): CoreMethodResponse<'verifyTelegramV2'>;
+    /**
+     * Waits for the session to be active and sets up the user.
+     *
+     * @param {Object} opts the options object
+     * @param {Window} [opts.popupWindow] the popup window being used for login.
+     * @param {boolean} [opts.skipSessionRefresh] whether to skip refreshing the session.
+     * @returns {Object} `{ isComplete: boolean; isError: boolean; needsWallet: boolean; partnerId: string; }` the result data
+     **/
+    waitForLoginV2({ isCanceled, onCancel, onPoll, skipSessionRefresh, }?: CoreMethodParams<'waitForLoginV2'>): CoreMethodResponse<'waitForLoginV2'>;
+    waitForSignupV2({ isCanceled, onCancel, onPoll, }: CoreMethodParams<'waitForSignupV2'>): CoreMethodResponse<'waitForSignupV2'>;
+    waitForWalletCreationV2({ isCanceled, onCancel, }?: CoreMethodParams<'waitForWalletCreationV2'>): CoreMethodResponse<'waitForWalletCreationV2'>;
+    loginExternalWalletV2({ externalWallet, ...urlOptions }: CoreMethodParams<'loginExternalWalletV2'>): CoreMethodResponse<'loginExternalWalletV2'>;
+    verifyExternalWalletV2({ externalWallet, signedMessage, cosmosPublicKeyHex, cosmosSigner, ...urlOptions }: CoreMethodParams<'verifyExternalWalletV2'>): CoreMethodResponse<'verifyExternalWalletV2'>;
+    /**
+     * Performs 2FA verification.
+     * @param {Object} opts the options object
+     * @param {string} opts.email the email to use for performing a 2FA verification.
+     * @param {string} opts.verificationCode the verification code to received via 2FA.
+     * @returns {Object} `{ address, initiatedAt, status, userId, walletId }`
+     */
+    verify2faV2({ auth, verificationCode }: CoreMethodParams<'verify2faV2'>): CoreMethodResponse<'verify2faV2'>;
+    /**
+     * Sets up two-factor authentication for the current user.
+     * @returns {string} uri - uri to use for setting up 2FA
+     * */
+    setup2faV2(): CoreMethodResponse<'setup2faV2'>;
+    /**
+     * Enables 2FA.
+     * @param {Object} opts the options object
+     * @param {string} opts.verificationCode - the verification code received via 2FA.
+     */
+    enable2faV2({ verificationCode }: CoreMethodParams<'enable2faV2'>): CoreMethodResponse<'enable2faV2'>;
+    /**
+     * Creates a new pregenerated wallet.
+     *
+     * @param {Object} opts the options object.
+     * @param {string} opts.pregenIdentifier the identifier associated with the new wallet.
+     * @param {TPregenIdentifierType} [opts.pregenIdentifierType] the identifier type. Defaults to `EMAIL`.
+     * @param {WalletType} [opts.type] the type of wallet to create. Defaults to the first non-optional type in the instance's `supportedWalletTypes` array.
+     * @returns {Wallet} the created wallet.
+     **/
+    createPregenWalletV2(opts: CoreMethodParams<'createPregenWalletV2'>): CoreMethodResponse<'createPregenWalletV2'>;
+    /**
+     * Creates new pregenerated wallets for each desired type.
+     * If no types are provided, this method will create one for each of the non-optional types
+     * specified in the instance's `supportedWalletTypes` array that are not already present.
+     * @param {Object} opts the options object.
+     * @param {string} opts.pregenIdentifier the identifier to associate each wallet with.
+     * @param {TPregenIdentifierType} opts.pregenIdentifierType - either `'EMAIL'` or `'PHONE'`.
+     * @param {WalletType[]} [opts.types] the wallet types to create. Defaults to any types the instance supports that are not already present.
+     * @returns {Wallet[]} an array containing the created wallets.
+     **/
+    createPregenWalletPerTypeV2({ types, pregenId, }: CoreMethodParams<'createPregenWalletPerTypeV2'>): CoreMethodResponse<'createPregenWalletPerTypeV2'>;
+    /**
+     * Claims a pregenerated wallet.
+     * @param {Object} opts the options object.
+     * @param {string} opts.pregenIdentifier string the identifier of the user claiming the wallet
+     * @param {TPregenIdentifierType} opts.pregenIdentifierType type of the identifier of the user claiming the wallet
+     * @returns {[Wallet, string | null]} `[wallet, recoveryShare]` - the wallet object and the new recovery share.
+     **/
+    claimPregenWalletsV2({ pregenId, }?: CoreMethodParams<'claimPregenWalletsV2'>): CoreMethodResponse<'claimPregenWalletsV2'>;
+    /**
+     * Updates the identifier for a pregen wallet.
+     * @param {Object} opts the options object.
+     * @param {string} opts.walletId the pregen wallet ID
+     * @param {string} opts.newPregenIdentifier the new identtifier
+     * @param {TPregenIdentifierType} opts.newPregenIdentifierType: the new identifier type
+     **/
+    updatePregenWalletIdentifierV2({ walletId, newPregenId, }: CoreMethodParams<'updatePregenWalletIdentifierV2'>): CoreMethodResponse<'updatePregenWalletIdentifierV2'>;
+    /**
+     * Checks if a pregen Wallet exists for the given identifier with the current partner.
+     * @param {Object} opts the options object.
+     * @param {string} opts.pregenIdentifier string the identifier of the user claiming the wallet
+     * @param {TPregenIdentifierType} opts.pregenIdentifierType type of the string of the identifier of the user claiming the wallet
+     * @returns {boolean} whether the pregen wallet exists
+     **/
+    hasPregenWalletV2({ pregenId }: CoreMethodParams<'hasPregenWalletV2'>): CoreMethodResponse<'hasPregenWalletV2'>;
+    /**
+     * Get pregen wallets for the given identifier.
+     * @param {Object} opts the options object.
+     * @param {string} opts.pregenIdentifier - the identifier of the user claiming the wallet
+     * @param {TPregenIdentifierType} opts.pregenIdentifierType - type of the identifier of the user claiming the wallet
+     * @returns {Promise<WalletEntity[]>} the array of found wallets
+     **/
+    getPregenWalletsV2({ pregenId, }?: CoreMethodParams<'getPregenWalletsV2'>): CoreMethodResponse<'getPregenWalletsV2'>;
 }

package/dist/types/constants.d.ts

@@ -15,3 +15,4 @@ export declare const LOCAL_STORAGE_SESSION_COOKIE: string;
 export declare const SESSION_STORAGE_LOGIN_ENCRYPTION_KEY_PAIR: string;
 export declare const POLLING_INTERVAL_MS = 2000;
 export declare const SHORT_POLLING_INTERVAL_MS = 1000;
+export declare const POLLING_TIMEOUT_MS = 300000;