@getpara/core-sdk 2.0.0-alpha.3 → 2.0.0-alpha.30

package/dist/types/ParaCore.d.ts

@@ -1,12 +1,14 @@
-import { AuthMethod, AuthExtras, CurrentWalletIds, EmailTheme, WalletType, PregenIds, BiometricLocationHint, Auth, SupportedWalletTypes, AuthIdentifier, AuthType, ExternalWalletInfo, PrimaryAuthInfo, SessionInfo, PrimaryAuth, PrimaryAuthType } from '@getpara/user-management-client';
+import { AuthMethod, AuthExtras, CurrentWalletIds, EmailTheme, TWalletType, PregenIds, BiometricLocationHint, Auth, SupportedWalletTypes, AuthIdentifier, AuthType, ExternalWalletInfo, PrimaryAuthInfo, SessionInfo, PrimaryAuth, PrimaryAuthType, AccountMetadata, LinkedAccounts, VerifyLinkParams, VerifyExternalWalletParams, SupportedAccountLinks } from '@getpara/user-management-client';
 import type { pki as pkiType } from 'node-forge';
-import { Ctx, Environment, Theme, WalletFilters, WalletTypeProp, Wallet, PortalUrlOptions, ConstructorOpts, CoreAuthInfo, PortalUrlType, CoreMethodParams, CoreMethodResponse, OAuthUrlParams, NewCredentialUrlParams, LoginUrlParams, CoreInterface, ExternalWalletConnectionType } from './types/index.js';
+import { Ctx, Environment, Theme, WalletFilters, Wallet, PortalUrlOptions, ConstructorOpts, CoreAuthInfo, PortalUrlType, CoreMethodParams, CoreMethodResponse, NewCredentialUrlParams, LoginUrlParams, CoreInterface, ExternalWalletConnectionType, AccountLinkInProgress, InternalMethodParams, InternalMethodResponse } from './types/index.js';
 import { PlatformUtils } from './PlatformUtils.js';
 export declare abstract class ParaCore implements CoreInterface {
     #private;
     static version?: string;
     ctx: Ctx;
     protected isNativePasskey: boolean;
+    protected isPartnerOptional?: boolean;
+    isReady: boolean;
     get authInfo(): CoreAuthInfo | undefined;
     get email(): AuthIdentifier<'email'> | undefined;
     get phone(): AuthIdentifier<'phone'> | undefined;
@@ -15,6 +17,7 @@ export declare abstract class ParaCore implements CoreInterface {
     get externalWalletWithParaAuth(): Wallet | undefined;
     get externalWalletConnectionType(): ExternalWalletConnectionType;
     userId?: string;
+    accountLinkInProgress: AccountLinkInProgress | undefined;
     private sessionCookie?;
     private isAwaitingAccountCreation;
     private isAwaitingLogin;
@@ -25,12 +28,13 @@ export declare abstract class ParaCore implements CoreInterface {
     get isFarcaster(): boolean;
     get isTelegram(): boolean;
     get isExternalWalletAuth(): boolean;
+    get isExternalWalletWithVerification(): boolean;
     get partnerId(): string | undefined;
     /**
      * The IDs of the currently active wallets, for each supported wallet type. Any signer integrations will default to the first viable wallet ID in this dictionary.
      */
     currentWalletIds: CurrentWalletIds;
-    get currentWalletIdsArray(): [string, WalletType][];
+    get currentWalletIdsArray(): [string, TWalletType][];
     get currentWalletIdsUnique(): string[];
     /**
      * Wallets associated with the `ParaCore` instance. Retrieve a particular wallet using `para.wallets[walletId]`.
@@ -114,10 +118,17 @@ export declare abstract class ParaCore implements CoreInterface {
      * @deprecated configure theming through the developer portal
      */
     portalTheme?: Theme;
+    /**
+     * Whether or not to treat external wallets as connections only, skipping all Para functionality.
+     */
+    externalWalletConnectionOnly?: boolean;
     private disableProviderModal?;
+    private fetchPregenWalletsOverride?;
+    get isNoWalletConfig(): boolean;
     get supportedWalletTypes(): SupportedWalletTypes;
     get cosmosPrefix(): string | undefined;
-    get isWalletTypeEnabled(): Partial<Record<WalletType, boolean>>;
+    get supportedAccountLinks(): SupportedAccountLinks;
+    get isWalletTypeEnabled(): Partial<Record<TWalletType, boolean>>;
     private platformUtils;
     private localStorageGetItem;
     private localStorageSetItem;
@@ -131,7 +142,7 @@ export declare abstract class ParaCore implements CoreInterface {
      * Remove all local storage and prefixed session storage.
      * @param {'local' | 'session' | 'secure' | 'all'} type - Type of storage to clear. Defaults to 'all'.
      */
-    clearStorage: (type?: CoreMethodParams<'clearStorage'>) => CoreMethodResponse<'clearStorage'>;
+    clearStorage: (type?: CoreMethodParams<"clearStorage">) => CoreMethodResponse<"clearStorage">;
     private convertBigInt;
     private convertEncryptionKeyPair;
     private isPortal;
@@ -147,12 +158,14 @@ export declare abstract class ParaCore implements CoreInterface {
      * @param {string} walletId the ID of the wallet address to display.
      * @param {object} options additional options for formatting the address.
      * @param {boolean} options.truncate whether to truncate the address.
-     * @param {WalletType} options.addressType the type of address to display.
+     * @param {TWalletType} options.addressType the type of address to display.
      * @returns the formatted address
      */
     getDisplayAddress(walletId: string, options?: {
         truncate?: boolean;
-        addressType?: WalletTypeProp | undefined;
+        addressType?: TWalletType | undefined;
+        cosmosPrefix?: string;
+        targetLength?: number;
     } | undefined): string;
     /**
      * Returns a unique hash for a wallet suitable for use as an identicon seed.
@@ -160,10 +173,11 @@ export declare abstract class ParaCore implements CoreInterface {
      * @param {boolean} options.addressType used to format the hash for another wallet type.
      * @returns the identicon hash string
      */
-    getIdenticonHash(walletId: string, overrideType?: WalletType): string | undefined;
+    getIdenticonHash(walletId: string, overrideType?: TWalletType): string | undefined;
     getWallets(): Record<string, Wallet>;
     getAddress(walletId?: string): string | undefined;
     protected abstract getPlatformUtils(): PlatformUtils;
+    abstract isPasskeySupported(): Promise<boolean>;
     protected constructPortalUrl(type: PortalUrlType, opts?: PortalUrlOptions): Promise<string>;
     /**
      * Constructs a new `ParaCore` instance.
@@ -173,6 +187,8 @@ export declare abstract class ParaCore implements CoreInterface {
      * @returns - A new ParaCore instance.
      */
     constructor(env: Environment, apiKey: string, opts?: ConstructorOpts);
+    private trackError;
+    private wrapMethodsWithErrorTracking;
     private initializeFromStorage;
     private updateAuthInfoFromStorage;
     private updateUserIdFromStorage;
@@ -190,13 +206,13 @@ export declare abstract class ParaCore implements CoreInterface {
      * Init only needs to be called for storage that is async.
      */
     init(): Promise<void>;
+    protected abstract ready(): Promise<void>;
     protected setAuth(auth: PrimaryAuth, { extras, userId }?: {
         extras?: AuthExtras;
         userId?: string;
     }): Promise<typeof this.authInfo>;
     protected assertUserId(): string;
     protected assertIsAuthSet(allowed?: AuthType[]): PrimaryAuthInfo;
-    assertIsUser: any;
     /**
      * Sets the email associated with the `ParaCore` instance.
      * @param email - Email to set.
@@ -212,7 +228,7 @@ export declare abstract class ParaCore implements CoreInterface {
      * @param phone - Phone number to set.
      * @param countryCode - Country Code to set.
      */
-    setPhone(phone: `+${number}` | string, countryCode?: string): Promise<void>;
+    setPhoneNumber(phone: `+${number}` | string, countryCode?: string): Promise<void>;
     /**
      * Sets the farcaster username associated with the `ParaCore` instance.
      * @param farcasterUsername - Farcaster Username to set.
@@ -223,7 +239,7 @@ export declare abstract class ParaCore implements CoreInterface {
      * @param externalAddress - External wallet address to set.
      * @param externalType - Type of external wallet to set.
      */
-    setExternalWallet({ address, type, provider, addressBech32, withFullParaAuth }: ExternalWalletInfo): Promise<void>;
+    setExternalWallet(externalWallet: ExternalWalletInfo[] | ExternalWalletInfo): Promise<void>;
     /**
      * Sets the user id associated with the `ParaCore` instance.
      * @param userId - User id to set.
@@ -250,6 +266,7 @@ export declare abstract class ParaCore implements CoreInterface {
      * @returns - userId associated with the `ParaCore` instance.
      */
     getUserId(): string | undefined;
+    getAuthInfo(): CoreAuthInfo | undefined;
     /**
      * Gets the email associated with the `ParaCore` instance.
      * @returns - email associated with the `ParaCore` instance.
@@ -270,6 +287,13 @@ export declare abstract class ParaCore implements CoreInterface {
         sessionLookupId?: string;
         newDeviceSessionLookupId?: string;
     }): Promise<void>;
+    /**
+     * Fetches the most recent OAuth account metadata for the signed-in user.
+     * If applicable, this will include the user's most recent metadata from their Google, Apple, Facebook, X, Discord, Farcaster, or Telegram account, the last time they signed in to your app.
+     * @deprecated use `para.getLinkedAccounts({ withMetadata: true })` instead.
+     * @returns {Promise<AccountMetadata>} the user's account metadata.
+     */
+    getAccountMetadata(): Promise<AccountMetadata>;
     /**
      * Validates that a wallet ID is present on the instance, usable, and matches the desired filters.
      * If no ID is passed, this will instead return the first valid, usable wallet ID that matches the filters.
@@ -286,14 +310,14 @@ export declare abstract class ParaCore implements CoreInterface {
      * @returns {string} the wallet ID originally passed, or the one found.
      */
     findWalletByAddress(address: string, filter?: WalletFilters | undefined): any;
-    findWallet(idOrAddress?: string, overrideType?: WalletTypeProp, filter?: WalletFilters): Omit<Wallet, 'signer'> | undefined;
-    get availableWallets(): Pick<Wallet, 'id' | 'type' | 'name' | 'address' | 'isExternal'>[];
+    findWallet(idOrAddress?: string, overrideType?: TWalletType, filter?: WalletFilters): Omit<Wallet, 'signer'> | undefined;
+    get availableWallets(): Pick<Wallet, 'id' | 'type' | 'name' | 'address' | 'isExternal' | 'externalProviderId' | 'isExternalConnectionOnly'>[];
     /**
      * Retrieves all usable wallets with the provided type (`'EVM' | 'COSMOS' | 'SOLANA'`)
      * @param {string} type the wallet type to filter by.
      * @returns {Wallet[]} an array of matching wallets.
      */
-    getWalletsByType(type: WalletTypeProp): Wallet[];
+    getWalletsByType(type: CoreMethodParams<'getWalletsByType'>): CoreMethodResponse<'getWalletsByType'>;
     private assertIsValidWalletId;
     private assertIsValidWalletType;
     private getMissingTypes;
@@ -318,10 +342,47 @@ export declare abstract class ParaCore implements CoreInterface {
     fetchWallets(): CoreMethodResponse<'fetchWallets'>;
     private populateWalletAddresses;
     private populatePregenWalletAddresses;
+    /**
+     * Logs in or creates a new user using an external wallet address.
+     * @param {Object} opts the options object
+     * @param {string} opts.address the external wallet address to use for identification.
+     * @param {TWalletType} opts.type type of external wallet to use for identification.
+     * @param {string} opts.provider the name of the provider for the external wallet.
+     */
+    loginExternalWallet({ externalWallet, ...urlOptions }: CoreMethodParams<'loginExternalWallet'>): CoreMethodResponse<'loginExternalWallet'>;
+    verifyExternalWallet({ externalWallet, signedMessage, cosmosPublicKeyHex, cosmosSigner, ...urlOptions }: CoreMethodParams<'verifyExternalWallet'>): CoreMethodResponse<'verifyExternalWallet'>;
+    protected verifyExternalWalletLink(opts: InternalMethodParams<'verifyExternalWalletLink'>): InternalMethodResponse<'verifyExternalWalletLink'>;
+    protected verifyTelegramProcess(opts: CoreMethodParams<'verifyTelegram'> & {
+        isLinkAccount: false;
+    }): CoreMethodResponse<'verifyTelegram'>;
+    protected verifyTelegramProcess(opts: InternalMethodParams<'verifyTelegramLink'> & {
+        isLinkAccount: true;
+    }): InternalMethodResponse<'verifyTelegramLink'>;
+    verifyTelegram(opts: CoreMethodParams<'verifyTelegram'>): CoreMethodResponse<'verifyTelegram'>;
+    protected verifyTelegramLink(opts: InternalMethodParams<'verifyTelegramLink'>): InternalMethodResponse<'verifyTelegramLink'>;
+    /**
+     * 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 }`
+     */
+    verify2fa({ auth, verificationCode }: CoreMethodParams<'verify2fa'>): CoreMethodResponse<'verify2fa'>;
+    /**
+     * Sets up two-factor authentication for the current user.
+     * @returns {string} uri - uri to use for setting up 2FA
+     * */
+    setup2fa(): CoreMethodResponse<'setup2fa'>;
+    /**
+     * Enables 2FA.
+     * @param {Object} opts the options object
+     * @param {string} opts.verificationCode - the verification code received via 2FA.
+     */
+    enable2fa({ verificationCode }: CoreMethodParams<'enable2fa'>): CoreMethodResponse<'enable2fa'>;
     /**
      * Resend a verification email for the current user.
      */
-    resendVerificationCode(): CoreMethodResponse<'resendVerificationCode'>;
+    resendVerificationCode({ type: reason, }: CoreMethodParams<'resendVerificationCode'>): CoreMethodResponse<'resendVerificationCode'>;
     /**
      * Checks if the current session is active.
      * @returns `true` if active, `false` otherwise
@@ -332,6 +393,7 @@ export declare abstract class ParaCore implements CoreInterface {
      * @returns `true` if active, `false` otherwise
      **/
     isFullyLoggedIn(): CoreMethodResponse<'isFullyLoggedIn'>;
+    get isGuestMode(): boolean;
     protected supportedAuthMethods(auth: Auth<PrimaryAuthType | 'userId'>): Promise<Set<AuthMethod>>;
     /**
      * Get hints associated with the users stored biometrics.
@@ -339,6 +401,45 @@ export declare abstract class ParaCore implements CoreInterface {
      * @returns Array containing useragents and AAGuids for stored biometrics
      */
     protected getUserBiometricLocationHints(): Promise<BiometricLocationHint[]>;
+    /**
+     * Waits for the session to be active.
+     **/
+    waitForSignup({ isCanceled, onCancel, onPoll, }: CoreMethodParams<'waitForSignup'>): CoreMethodResponse<'waitForSignup'>;
+    waitForWalletCreation({ isCanceled, onCancel, }?: CoreMethodParams<'waitForWalletCreation'>): CoreMethodResponse<'waitForWalletCreation'>;
+    /**
+     * Initiates a Farcaster login attempt and returns the URL for the user to connect.
+     * You can create a QR code with this URI that works with Farcaster's mobile app.
+     * @return {string} the Farcaster connect URI
+     */
+    getFarcasterConnectUri({ appScheme }?: {
+        appScheme?: string;
+    }): CoreMethodResponse<'getFarcasterConnectUri'>;
+    protected verifyFarcasterProcess(opts: CoreMethodParams<'verifyFarcaster'> & {
+        isLinkAccount: false;
+    }): CoreMethodResponse<'verifyFarcaster'>;
+    protected verifyFarcasterProcess(opts: InternalMethodParams<'verifyFarcasterLink'> & {
+        isLinkAccount: true;
+    }): InternalMethodResponse<'verifyFarcasterLink'>;
+    verifyFarcaster(opts: CoreMethodParams<'verifyFarcaster'>): CoreMethodResponse<'verifyFarcaster'>;
+    protected verifyFarcasterLink(opts: InternalMethodParams<'verifyFarcasterLink'>): InternalMethodResponse<'verifyFarcasterLink'>;
+    getOAuthUrl(opts: CoreMethodParams<'getOAuthUrl'>): CoreMethodResponse<'getOAuthUrl'>;
+    protected verifyOAuthProcess(_: InternalMethodParams<'verifyOAuthLink'> & {
+        isLinkAccount: true;
+    }): InternalMethodResponse<'verifyOAuthLink'>;
+    protected verifyOAuthProcess(_: CoreMethodParams<'verifyOAuth'> & {
+        isLinkAccount: false;
+    }): CoreMethodResponse<'verifyOAuth'>;
+    verifyOAuth(opts: CoreMethodParams<'verifyOAuth'>): CoreMethodResponse<'verifyOAuth'>;
+    protected verifyOAuthLink(opts: InternalMethodParams<'verifyOAuthLink'>): InternalMethodResponse<'verifyOAuthLink'>;
+    /**
+     * 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
+     **/
+    waitForLogin({ isCanceled, onCancel, onPoll, skipSessionRefresh, }?: CoreMethodParams<'waitForLogin'>): CoreMethodResponse<'waitForLogin'>;
     /**
      * Updates the session with the user management server, possibly
      * opening a popup to refresh the session.
@@ -400,7 +501,7 @@ export declare abstract class ParaCore implements CoreInterface {
      *
      * @deprecated alias for `createWalletPerType`
      **/
-    createWalletPerMissingType: ({ skipDistribute, types, }?: CoreMethodParams<'createWalletPerType'>) => CoreMethodResponse<'createWalletPerType'>;
+    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`
@@ -409,7 +510,7 @@ export declare abstract class ParaCore implements CoreInterface {
      *
      * @param {Object} [opts] the options object.
      * @param {boolean} [opts.skipDistribute] if `true`, the wallets' recovery share will not be distributed.
-     * @param {WalletType[]} [opts.types] the types of wallets to create.
+     * @param {TWalletType[]} [opts.types] the types of wallets to create.
      * @returns {Object} the wallets created, their ids, and the recovery secret.
      **/
     createWalletPerType({ skipDistribute, types, }?: CoreMethodParams<'createWalletPerType'>): CoreMethodResponse<'createWalletPerType'>;
@@ -429,11 +530,56 @@ export declare abstract class ParaCore implements CoreInterface {
     /**
      * Creates a new wallet.
      * @param {Object} opts the options object.
-     * @param {WalletType} opts.type the type of wallet to create.
+     * @param {TWalletType} opts.type the type of wallet to create.
      * @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, }?: CoreMethodParams<'createWallet'>): CoreMethodResponse<'createWallet'>;
+    createPregenWallet(opts: CoreMethodParams<'createPregenWallet'>): CoreMethodResponse<'createPregenWallet'>;
+    /**
+     * 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 {TWalletType[]} [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.
+     **/
+    createPregenWalletPerType({ types, pregenId, }: CoreMethodParams<'createPregenWalletPerType'>): CoreMethodResponse<'createPregenWalletPerType'>;
+    /**
+     * 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.
+     **/
+    claimPregenWallets({ pregenId, }?: CoreMethodParams<'claimPregenWallets'>): CoreMethodResponse<'claimPregenWallets'>;
+    /**
+     * 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
+     **/
+    updatePregenWalletIdentifier({ walletId, newPregenId, }: CoreMethodParams<'updatePregenWalletIdentifier'>): CoreMethodResponse<'updatePregenWalletIdentifier'>;
+    /**
+     * 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
+     **/
+    hasPregenWallet({ pregenId }: CoreMethodParams<'hasPregenWallet'>): CoreMethodResponse<'hasPregenWallet'>;
+    /**
+     * 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
+     **/
+    getPregenWallets({ pregenId }?: CoreMethodParams<'getPregenWallets'>): CoreMethodResponse<'getPregenWallets'>;
+    createGuestWallets(): CoreMethodResponse<'createGuestWallets'>;
     private encodeWalletBase64;
     /**
      * Encodes the current wallets encoded in Base 64.
@@ -447,6 +593,7 @@ export declare abstract class ParaCore implements CoreInterface {
     setUserShare(base64Wallets: CoreMethodParams<'setUserShare'>): CoreMethodResponse<'setUserShare'>;
     private getTransactionReviewUrl;
     private getOnRampTransactionUrl;
+    getWalletBalance: ({ walletId, rpcUrl, }: CoreMethodParams<"getWalletBalance">) => CoreMethodResponse<"getWalletBalance">;
     /**
      * Signs a message using one of the current wallets.
      *
@@ -485,34 +632,21 @@ export declare abstract class ParaCore implements CoreInterface {
     keepSessionAlive(): Promise<boolean>;
     /**
      * Serialize the current session for import by another Para instance.
+     * @param {boolean} excludeSigners - whether or not to exclude the signer from the exported wallets.
      * @returns {string} the serialized session
      */
-    exportSession(): CoreMethodResponse<'exportSession'>;
+    exportSession({ excludeSigners }?: CoreMethodParams<'exportSession'>): CoreMethodResponse<'exportSession'>;
     /**
      * Imports a session serialized by another Para instance.
      * @param {string} serializedInstanceBase64 the serialized session
      */
     importSession(serializedInstanceBase64: CoreMethodParams<'importSession'>): CoreMethodResponse<'importSession'>;
-    /**
-     * @deprecated
-     */
-    /**
-     * @deprecated
-     */
-    /**
-     * @deprecated
-     */
-    /**
-     * @deprecated
-     */
-    /**
-     * @deprecated
-     */
     /**
      * Retrieves a token to verify the current session.
      * @returns {Promise<string>} the ID
      **/
     getVerificationToken(): CoreMethodResponse<'getVerificationToken'>;
+    issueJwt({ keyIndex }?: CoreMethodParams<'issueJwt'>): CoreMethodResponse<'issueJwt'>;
     /**
      * Logs the user out.
      * @param {Object} opts the options object.
@@ -521,18 +655,17 @@ export declare abstract class ParaCore implements CoreInterface {
     logout({ clearPregenWallets }?: {
         clearPregenWallets?: boolean;
     }): Promise<void>;
-    /** @deprecated */
-    protected getSupportedCreateAuthMethods(): Promise<Set<AuthMethod>>;
+    protected get toStringAdditions(): Record<string, unknown>;
     /**
      * Converts to a string, removing sensitive data when logging this class.
      *
      * Doesn't work for all types of logging.
      **/
     toString(): string;
-    /** NEW METHODS */
+    protected devLog(...s: string[]): void;
     protected getNewCredentialAndUrl({ authMethod, isForNewDevice, portalTheme, shorten, }?: NewCredentialUrlParams): Promise<{
         credentialId: string;
-        url: string;
+        url?: string;
     }>;
     /**
      * Returns a Para Portal URL for logging in with a WebAuth passkey or a password.
@@ -543,101 +676,13 @@ export declare abstract class ParaCore implements CoreInterface {
      * @returns {SignUpOrLogInResponse} an object in the form of either: `{ stage: 'verify' }` or `{ stage: 'login'; passkeyUrl?: string; passwordUrl?: string; biometricHints?: BiometricLocationHint[] }`
      */
     protected getLoginUrl({ authMethod, shorten, portalTheme, sessionId, }: LoginUrlParams): Promise<string>;
-    protected getOAuthUrl({ method, deeplinkUrl }: OAuthUrlParams): Promise<string>;
     signUpOrLogIn({ auth, ...urlOptions }: CoreMethodParams<'signUpOrLogIn'>): CoreMethodResponse<'signUpOrLogIn'>;
     verifyNewAccount({ verificationCode, ...urlOptions }: CoreMethodParams<'verifyNewAccount'>): CoreMethodResponse<'verifyNewAccount'>;
-    verifyOAuth({ method, deeplinkUrl, isCanceled, onCancel, onPoll, onOAuthUrl, ...urlOptions }: CoreMethodParams<'verifyOAuth'>): CoreMethodResponse<'verifyOAuth'>;
-    verifyFarcaster({ isCanceled, onConnectUri, onCancel, onPoll, ...urlOptions }: CoreMethodParams<'verifyFarcaster'>): CoreMethodResponse<'verifyFarcaster'>;
-    /**
-     * 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[] }`
-     */
-    verifyTelegram({ telegramAuthResponse, ...urlOptions }: CoreMethodParams<'verifyTelegram'>): CoreMethodResponse<'verifyTelegram'>;
-    /**
-     * 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
-     **/
-    waitForLogin({ isCanceled, onCancel, onPoll, skipSessionRefresh, }?: CoreMethodParams<'waitForLogin'>): CoreMethodResponse<'waitForLogin'>;
-    waitForSignup({ isCanceled, onCancel, onPoll, }: CoreMethodParams<'waitForSignup'>): CoreMethodResponse<'waitForSignup'>;
-    waitForWalletCreation({ isCanceled, onCancel, }?: CoreMethodParams<'waitForWalletCreation'>): CoreMethodResponse<'waitForWalletCreation'>;
-    loginExternalWallet({ externalWallet, ...urlOptions }: CoreMethodParams<'loginExternalWallet'>): CoreMethodResponse<'loginExternalWallet'>;
-    verifyExternalWallet({ externalWallet, signedMessage, cosmosPublicKeyHex, cosmosSigner, ...urlOptions }: CoreMethodParams<'verifyExternalWallet'>): CoreMethodResponse<'verifyExternalWallet'>;
-    /**
-     * 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 }`
-     */
-    verify2fa({ auth, verificationCode }: CoreMethodParams<'verify2fa'>): CoreMethodResponse<'verify2fa'>;
-    /**
-     * Sets up two-factor authentication for the current user.
-     * @returns {string} uri - uri to use for setting up 2FA
-     * */
-    setup2fa(): CoreMethodResponse<'setup2fa'>;
-    /**
-     * Enables 2FA.
-     * @param {Object} opts the options object
-     * @param {string} opts.verificationCode - the verification code received via 2FA.
-     */
-    enable2fa({ verificationCode }: CoreMethodParams<'enable2fa'>): CoreMethodResponse<'enable2fa'>;
-    /**
-     * 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.
-     **/
-    createPregenWallet(opts: CoreMethodParams<'createPregenWallet'>): CoreMethodResponse<'createPregenWallet'>;
-    /**
-     * 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.
-     **/
-    createPregenWalletPerType({ types, pregenId, }: CoreMethodParams<'createPregenWalletPerType'>): CoreMethodResponse<'createPregenWalletPerType'>;
-    /**
-     * 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.
-     **/
-    claimPregenWallets({ pregenId, }?: CoreMethodParams<'claimPregenWallets'>): CoreMethodResponse<'claimPregenWallets'>;
-    /**
-     * 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
-     **/
-    updatePregenWalletIdentifier({ walletId, newPregenId, }: CoreMethodParams<'updatePregenWalletIdentifier'>): CoreMethodResponse<'updatePregenWalletIdentifier'>;
-    /**
-     * 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
-     **/
-    hasPregenWallet({ pregenId }: CoreMethodParams<'hasPregenWallet'>): CoreMethodResponse<'hasPregenWallet'>;
-    /**
-     * 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
-     **/
-    getPregenWallets({ pregenId }?: CoreMethodParams<'getPregenWallets'>): CoreMethodResponse<'getPregenWallets'>;
+    getLinkedAccounts({ withMetadata, }?: CoreMethodParams<'getLinkedAccounts'>): CoreMethodResponse<'getLinkedAccounts'>;
+    protected linkAccount(opts: InternalMethodParams<'linkAccount'>): InternalMethodResponse<'linkAccount'>;
+    protected unlinkAccount({ linkedAccountId, }: InternalMethodParams<'unlinkAccount'>): InternalMethodResponse<'unlinkAccount'>;
+    protected verifyLink({ accountLinkInProgress, ...opts }?: {
+        accountLinkInProgress?: AccountLinkInProgress;
+    } & Partial<Pick<VerifyLinkParams, 'verificationCode' | 'telegramAuthResponse'> & VerifyExternalWalletParams>): Promise<LinkedAccounts>;
+    protected verifyEmailOrPhoneLink({ verificationCode, }: InternalMethodParams<'verifyEmailOrPhoneLink'>): InternalMethodResponse<'verifyEmailOrPhoneLink'>;
 }

package/dist/types/PlatformUtils.d.ts

@@ -1,11 +1,10 @@
-/// <reference types="node" />
-/// <reference types="node" />
-import { BackupKitEmailProps, TPregenIdentifierType, WalletType } from '@getpara/user-management-client';
+import { BackupKitEmailProps, TPregenIdentifierType, TWalletType, SDKType } from '@getpara/user-management-client';
 import { Ctx, PopupType, SignatureRes } from './types/index.js';
 import { StorageUtils } from './StorageUtils.js';
 export interface PlatformUtils {
+    sdkType: SDKType;
     getPrivateKey(ctx: Ctx, userId: string, walletId: string, share: string, sessionCookie: string): Promise<string>;
-    keygen(ctx: Ctx, userId: string, type: Exclude<WalletType, WalletType.SOLANA>, secretKey: string | null, // should be acceptable as null in RN as we don't pre-gen them
+    keygen(ctx: Ctx, userId: string, type: Exclude<TWalletType, 'SOLANA'>, secretKey: string | null, // should be acceptable as null in RN as we don't pre-gen them
     sessionCookie: string, emailProps?: BackupKitEmailProps): Promise<{
         signer: string;
         walletId: string;
@@ -14,7 +13,7 @@ export interface PlatformUtils {
         signer: string;
         protocolId?: string;
     }>;
-    preKeygen(ctx: Ctx, partnerId: string, pregenIdentifier: string, pregenIdentifierType: TPregenIdentifierType, type: Exclude<WalletType, WalletType.SOLANA>, secretKey: string | null, // should be acceptable as null in RN as we don't pre-gen them
+    preKeygen(ctx: Ctx, partnerId: string, pregenIdentifier: string, pregenIdentifierType: TPregenIdentifierType, type: Exclude<TWalletType, 'SOLANA'>, secretKey: string | null, // should be acceptable as null in RN as we don't pre-gen them
     sessionCookie: string): Promise<{
         signer: string;
         walletId: string;

package/dist/types/constants.d.ts

@@ -1,18 +1,21 @@
 export declare const PARA_CORE_VERSION: string;
 export declare const PREFIX = "@CAPSULE/";
-export declare const LOCAL_STORAGE_AUTH_INFO: string;
-export declare const LOCAL_STORAGE_EMAIL: string;
-export declare const LOCAL_STORAGE_PHONE: string;
-export declare const LOCAL_STORAGE_COUNTRY_CODE: string;
-export declare const LOCAL_STORAGE_FARCASTER_USERNAME: string;
-export declare const LOCAL_STORAGE_TELEGRAM_USER_ID: string;
-export declare const LOCAL_STORAGE_USER_ID: string;
-export declare const LOCAL_STORAGE_ED25519_WALLETS: string;
-export declare const LOCAL_STORAGE_WALLETS: string;
-export declare const LOCAL_STORAGE_EXTERNAL_WALLETS: string;
-export declare const LOCAL_STORAGE_CURRENT_WALLET_IDS: string;
-export declare const LOCAL_STORAGE_SESSION_COOKIE: string;
-export declare const SESSION_STORAGE_LOGIN_ENCRYPTION_KEY_PAIR: string;
+export declare const LOCAL_STORAGE_AUTH_INFO = "@CAPSULE/authInfo";
+export declare const LOCAL_STORAGE_EMAIL = "@CAPSULE/e-mail";
+export declare const LOCAL_STORAGE_PHONE = "@CAPSULE/phone";
+export declare const LOCAL_STORAGE_COUNTRY_CODE = "@CAPSULE/countryCode";
+export declare const LOCAL_STORAGE_FARCASTER_USERNAME = "@CAPSULE/farcasterUsername";
+export declare const LOCAL_STORAGE_TELEGRAM_USER_ID = "@CAPSULE/telegramUserId";
+export declare const LOCAL_STORAGE_EXTERNAL_WALLET_USER_ID = "@CAPSULE/externalWalletUserId";
+export declare const LOCAL_STORAGE_USER_ID = "@CAPSULE/userId";
+export declare const LOCAL_STORAGE_ED25519_WALLETS = "@CAPSULE/ed25519Wallets";
+export declare const LOCAL_STORAGE_WALLETS = "@CAPSULE/wallets";
+export declare const LOCAL_STORAGE_EXTERNAL_WALLETS = "@CAPSULE/externalWallets";
+export declare const LOCAL_STORAGE_CURRENT_WALLET_IDS = "@CAPSULE/currentWalletIds";
+export declare const LOCAL_STORAGE_SESSION_COOKIE = "@CAPSULE/sessionCookie";
+export declare const SESSION_STORAGE_LOGIN_ENCRYPTION_KEY_PAIR = "@CAPSULE/loginEncryptionKeyPair";
 export declare const POLLING_INTERVAL_MS = 2000;
 export declare const SHORT_POLLING_INTERVAL_MS = 1000;
 export declare const POLLING_TIMEOUT_MS = 300000;
+export declare const EXTERNAL_WALLET_CONNECTION_ONLY_USER_ID = "EXTERNAL_WALLET_CONNECTION_ONLY";
+export declare const ACCOUNT_LINK_CONFLICT = "Account already linked";

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 import { ParaCore } from './ParaCore.js';
-export { type AuthInfo, type PrimaryAuthInfo, type VerifiedAuthInfo, AuthMethod, type AuthExtras, type CurrentWalletIds, EmailTheme, type PartnerEntity, type WalletEntity, Network, WalletType, WalletScheme, OnRampAsset, OnRampPurchaseType, OnRampProvider, OnRampPurchaseStatus, type OnRampConfig, type OnRampAllowedAssets, type OnRampPurchase, OAuthMethod, type SupportedWalletTypes, type TPregenIdentifierType, type PregenIds, NON_ED25519, PREGEN_IDENTIFIER_TYPES, } from '@getpara/user-management-client';
-export { OnRampMethod, PopupType, PregenIdentifierType, RecoveryStatus, type AuthStateSignup, type AuthStateVerify, type AuthStateLogin, type AuthState, type OAuthResponse, type CoreAuthInfo, type ProviderAssetInfo, type SignatureRes, type FullSignatureRes, type SuccessfulSignatureRes, type DeniedSignatureRes, type DeniedSignatureResWithUrl, type OnRampAssetInfo, type Theme, type Wallet, } from './types/index.js';
+export { type Auth, type AuthInfo, type PrimaryAuthInfo, type VerifiedAuthInfo, type VerifiedAuth, AuthMethod, type AuthExtras, type CurrentWalletIds, EmailTheme, type PartnerEntity, type WalletEntity, Network, WalletType, type TWalletType, WalletScheme, type TWalletScheme, OnRampAsset, OnRampPurchaseType, OnRampProvider, OnRampPurchaseStatus, type OnRampConfig, type OnRampAllowedAssets, type OnRampPurchase, OAuthMethod, type TOAuthMethod, type TLinkedAccountType, type SupportedAccountLinks, type SupportedWalletTypes, type TPregenIdentifierType, type PregenIds, type LinkedAccount, type LinkedAccounts, type TExternalWallet, type ExternalWalletInfo, type PregenAuth, type Setup2faResponse, type TelegramAuthResponse, type VerifyExternalWalletParams, NON_ED25519, PREGEN_IDENTIFIER_TYPES, WALLET_TYPES, WALLET_SCHEMES, OAUTH_METHODS, LINKED_ACCOUNT_TYPES, EXTERNAL_WALLET_TYPES, EVM_WALLETS, SOLANA_WALLETS, COSMOS_WALLETS, } from '@getpara/user-management-client';
+export { OnRampMethod, PopupType, PregenIdentifierType, RecoveryStatus, type AuthStateSignup, type AuthStateVerify, type AuthStateLogin, type AuthState, type OAuthResponse, type CoreAuthInfo, type ProviderAssetInfo, type SignatureRes, type FullSignatureRes, type SuccessfulSignatureRes, type DeniedSignatureRes, type DeniedSignatureResWithUrl, type OnRampAssetInfo, type Theme, type Wallet, type GetWalletBalanceParams, type AccountLinkInProgress, AccountLinkError, type InternalInterface, } from './types/index.js';
 export * from './types/coreApi.js';
 export * from './types/events.js';
 export * from './types/config.js';
@@ -19,7 +19,7 @@ export * from './utils/formatting.js';
 export * from './utils/polling.js';
 export * from './utils/phone.js';
 export { isWalletSupported } from './utils/wallet.js';
-export { getOnRampAssets, getOnRampNetworks, toAssetInfoArray } from './utils/onRamps.js';
+export { getNetworkPrefix, getOnRampAssets, getOnRampNetworks, toAssetInfoArray } from './utils/onRamps.js';
 export { getPortalBaseURL } from './utils/url.js';
 export { retrieve as transmissionUtilsRetrieve } from './transmission/transmissionUtils.js';
 export declare const paraVersion: string;

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

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 export declare class KeyContainer {
     walletId: string;
     keyshare: 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"
+}