@getpara/core-sdk 2.0.0-alpha.5 → 2.0.0-alpha.51

package/dist/esm/constants.js

@@ -1,6 +1,7 @@
 import "./chunk-7B52C2XE.js";
-const PARA_CORE_VERSION = "2.0.0-alpha.3";
+const PARA_CORE_VERSION = "2.0.0-alpha.51";
 const PREFIX = "@CAPSULE/";
+const PARA_PREFIX = "@PARA/";
 const LOCAL_STORAGE_AUTH_INFO = `${PREFIX}authInfo`;
 const LOCAL_STORAGE_EMAIL = `${PREFIX}e-mail`;
 const LOCAL_STORAGE_PHONE = `${PREFIX}phone`;
@@ -19,7 +20,9 @@ const POLLING_INTERVAL_MS = 2e3;
 const SHORT_POLLING_INTERVAL_MS = 1e3;
 const POLLING_TIMEOUT_MS = 3e5;
 const EXTERNAL_WALLET_CONNECTION_ONLY_USER_ID = "EXTERNAL_WALLET_CONNECTION_ONLY";
+const ACCOUNT_LINK_CONFLICT = "Account already linked";
 export {
+  ACCOUNT_LINK_CONFLICT,
   EXTERNAL_WALLET_CONNECTION_ONLY_USER_ID,
   LOCAL_STORAGE_AUTH_INFO,
   LOCAL_STORAGE_COUNTRY_CODE,
@@ -35,6 +38,7 @@ export {
   LOCAL_STORAGE_USER_ID,
   LOCAL_STORAGE_WALLETS,
   PARA_CORE_VERSION,
+  PARA_PREFIX,
   POLLING_INTERVAL_MS,
   POLLING_TIMEOUT_MS,
   PREFIX,

package/dist/esm/index.js

@@ -4,27 +4,36 @@ import {
   AuthMethod,
   EmailTheme,
   Network,
+  WalletType,
+  WalletScheme,
   OnRampAsset,
   OnRampPurchaseType,
   OnRampProvider,
   OnRampPurchaseStatus,
+  OAuthMethod,
   NON_ED25519,
   PREGEN_IDENTIFIER_TYPES,
   WALLET_TYPES,
   WALLET_SCHEMES,
-  OAUTH_METHODS
+  OAUTH_METHODS,
+  LINKED_ACCOUNT_TYPES,
+  EXTERNAL_WALLET_TYPES,
+  EVM_WALLETS,
+  SOLANA_WALLETS,
+  COSMOS_WALLETS
 } from "@getpara/user-management-client";
 import {
   OnRampMethod,
   PopupType,
   PregenIdentifierType,
-  RecoveryStatus
+  RecoveryStatus,
+  AccountLinkError
 } from "./types/index.js";
 export * from "./types/coreApi.js";
 export * from "./types/events.js";
 export * from "./types/config.js";
 import { getPortalDomain, entityToWallet, constructUrl, shortenUrl } from "./utils/index.js";
-import { PREFIX } from "./constants.js";
+import { PREFIX, PARA_PREFIX } from "./constants.js";
 import { distributeNewShare } from "./shares/shareDistribution.js";
 import { KeyContainer } from "./shares/KeyContainer.js";
 import { getBaseUrl, initClient } from "./external/userManagementClient.js";
@@ -59,24 +68,34 @@ import { retrieve } from "./transmission/transmissionUtils.js";
 const paraVersion = ParaCore.version;
 var src_default = ParaCore;
 export {
+  AccountLinkError,
   AuthMethod,
+  COSMOS_WALLETS,
+  EVM_WALLETS,
+  EXTERNAL_WALLET_TYPES,
   EmailTheme,
   KeyContainer,
+  LINKED_ACCOUNT_TYPES,
   NON_ED25519,
   Network,
   OAUTH_METHODS,
+  OAuthMethod,
   OnRampAsset,
   OnRampMethod,
   OnRampProvider,
   OnRampPurchaseStatus,
   OnRampPurchaseType,
+  PARA_PREFIX as PARA_STORAGE_PREFIX,
   PREGEN_IDENTIFIER_TYPES,
   PopupType,
   PregenIdentifierType,
   RecoveryStatus,
+  SOLANA_WALLETS,
   PREFIX as STORAGE_PREFIX,
   WALLET_SCHEMES,
   WALLET_TYPES,
+  WalletScheme,
+  WalletType,
   constructUrl,
   decryptPrivateKey,
   decryptPrivateKeyAndDecryptShare,

package/dist/esm/types/auth.js

@@ -0,0 +1,11 @@
+import "../chunk-7B52C2XE.js";
+var AccountLinkError = /* @__PURE__ */ ((AccountLinkError2) => {
+  AccountLinkError2["NotAuthenticated"] = "No user is currently authenticated";
+  AccountLinkError2["Conflict"] = "Account already linked";
+  AccountLinkError2["Canceled"] = "Account linking was canceled";
+  AccountLinkError2["Unknown"] = "An unknown error occurred";
+  return AccountLinkError2;
+})(AccountLinkError || {});
+export {
+  AccountLinkError
+};

package/dist/esm/types/coreApi.js

@@ -45,8 +45,24 @@ const PARA_CORE_METHODS = [
   "signMessage",
   "signTransaction",
   "initiateOnRampTransaction",
-  "getWalletBalance"
+  "getWalletBalance",
+  "issueJwt",
+  "getLinkedAccounts",
+  "accountLinkInProgress"
+];
+const PARA_INTERNAL_METHODS = [
+  "linkAccount",
+  "unlinkAccount",
+  "verifyEmailOrPhoneLink",
+  "verifyOAuthLink",
+  "verifyFarcasterLink",
+  "verifyTelegramLink",
+  "verifyExternalWalletLink",
+  "accountLinkInProgress",
+  "prepareLogin",
+  "sendLoginCode"
 ];
 export {
-  PARA_CORE_METHODS
+  PARA_CORE_METHODS,
+  PARA_INTERNAL_METHODS
 };

package/dist/esm/types/index.js

@@ -1,4 +1,5 @@
 import "../chunk-7B52C2XE.js";
+export * from "./auth.js";
 export * from "./config.js";
 export * from "./coreApi.js";
 export * from "./wallet.js";

package/dist/esm/utils/formatting.js

@@ -64,11 +64,13 @@ function truncateAddress(str, addressType, {
   return `${str.slice(0, minimum + margin)}...${str.slice(-1 * margin)}`;
 }
 export {
+  compressPubkey,
   decimalToHex,
   getCosmosAddress,
   hexStringToBase64,
   hexToDecimal,
   hexToSignature,
   hexToUint8Array,
+  rawSecp256k1PubkeyToRawAddress,
   truncateAddress
 };

package/dist/esm/utils/phone.js

@@ -22,7 +22,18 @@ function formatPhoneNumber(phone, countryCode, { forDisplay = false } = {}) {
 function displayPhoneNumber(phone, countryCode) {
   return formatPhoneNumber(phone, countryCode, { forDisplay: true });
 }
+function splitPhoneNumber(phone) {
+  const parsedNumber = parsePhoneNumberFromString(phone);
+  if (parsedNumber == null ? void 0 : parsedNumber.isValid()) {
+    return {
+      phone: parsedNumber.nationalNumber.replace(/\D/g, ""),
+      countryCode: `+${parsedNumber.countryCallingCode}`
+    };
+  }
+  throw new Error("Invalid phone number");
+}
 export {
   displayPhoneNumber,
-  formatPhoneNumber
+  formatPhoneNumber,
+  splitPhoneNumber
 };

package/dist/types/ParaCore.d.ts

@@ -1,12 +1,14 @@
-import { AuthMethod, AuthExtras, CurrentWalletIds, EmailTheme, TWalletType, PregenIds, BiometricLocationHint, Auth, SupportedWalletTypes, AuthIdentifier, AuthType, ExternalWalletInfo, PrimaryAuthInfo, SessionInfo, PrimaryAuth, PrimaryAuthType, AccountMetadata } from '@getpara/user-management-client';
+import { AuthMethod, AuthExtras, CurrentWalletIds, EmailTheme, PartnerEntity, TWalletType, PregenIds, BiometricLocationHint, Auth, SupportedWalletTypes, AuthIdentifier, AuthType, ExternalWalletInfo, PrimaryAuthInfo, SessionInfo, PrimaryAuth, PrimaryAuthType, AccountMetadata, LinkedAccounts, VerifyLinkParams, VerifyExternalWalletParams, SupportedAccountLinks, OnRampPurchase } from '@getpara/user-management-client';
 import type { pki as pkiType } from 'node-forge';
-import { Ctx, Environment, Theme, WalletFilters, Wallet, PortalUrlOptions, ConstructorOpts, CoreAuthInfo, PortalUrlType, CoreMethodParams, CoreMethodResponse, 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;
@@ -14,18 +16,24 @@ export declare abstract class ParaCore implements CoreInterface {
     get telegramUserId(): AuthIdentifier<'telegram'> | undefined;
     get externalWalletWithParaAuth(): Wallet | undefined;
     get externalWalletConnectionType(): ExternalWalletConnectionType;
+    protected partner?: PartnerEntity;
     userId?: string;
+    accountLinkInProgress: AccountLinkInProgress | undefined;
     private sessionCookie?;
     private isAwaitingAccountCreation;
     private isAwaitingLogin;
     private isAwaitingFarcaster;
     private isAwaitingOAuth;
+    private isWorkerInitialized;
     get isEmail(): boolean;
     get isPhone(): boolean;
     get isFarcaster(): boolean;
     get isTelegram(): boolean;
     get isExternalWalletAuth(): boolean;
+    get isExternalWalletWithVerification(): boolean;
     get partnerId(): string | undefined;
+    protected get partnerName(): string | undefined;
+    protected get partnerLogo(): 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.
      */
@@ -119,11 +127,17 @@ export declare abstract class ParaCore implements CoreInterface {
      */
     externalWalletConnectionOnly?: boolean;
     private disableProviderModal?;
+    private fetchPregenWalletsOverride?;
     get isNoWalletConfig(): boolean;
     get supportedWalletTypes(): SupportedWalletTypes;
     get cosmosPrefix(): string | undefined;
+    get supportedAccountLinks(): SupportedAccountLinks;
     get isWalletTypeEnabled(): Partial<Record<TWalletType, boolean>>;
-    private platformUtils;
+    protected onRampPopup: {
+        window: Window;
+        onRampPurchase: OnRampPurchase;
+    } | undefined;
+    protected platformUtils: PlatformUtils;
     private localStorageGetItem;
     private localStorageSetItem;
     private localStorageRemoveItem;
@@ -136,10 +150,10 @@ 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;
+    protected isPortal(envOverride?: Environment): boolean;
     private isParaConnect;
     private requireApiKey;
     private isWalletSupported;
@@ -171,15 +185,18 @@ export declare abstract class ParaCore implements CoreInterface {
     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>;
+    static resolveEnvironment(env: Environment | undefined, apiKey: string | undefined): Environment;
     /**
      * Constructs a new `ParaCore` instance.
-     * @param env - `Environment` to use.
+     * @param env - `Environment` to use. Optional if the apiKey contains an environment prefix (e.g., "prod_your_api_key"). Updated API keys can be found at https://developer.getpara.com.
      * @param apiKey - API key to use.
      * @param opts - Additional constructor options; see `ConstructorOpts`.
      * @returns - A new ParaCore instance.
      */
-    constructor(env: Environment, apiKey: string, opts?: ConstructorOpts);
+    constructor(env: Environment | undefined, apiKey: string, opts?: ConstructorOpts);
+    constructor(apiKey: string, opts?: ConstructorOpts);
     private trackError;
     private wrapMethodsWithErrorTracking;
     private initializeFromStorage;
@@ -190,6 +207,7 @@ export declare abstract class ParaCore implements CoreInterface {
     private updateSessionCookieFromStorage;
     private updateLoginEncryptionKeyPairFromStorage;
     private updateExternalWalletsFromStorage;
+    protected initializeWorker: () => Promise<void>;
     touchSession(regenerate?: boolean): Promise<SessionInfo>;
     private getVerificationEmailProps;
     private getBackupKitEmailProps;
@@ -199,11 +217,19 @@ export declare abstract class ParaCore implements CoreInterface {
      * Init only needs to be called for storage that is async.
      */
     init(): Promise<void>;
+    /**
+     * Call this method to perform initial setup for the `ParaCore` instance.
+     *
+     * This method will be called automatically if you use the React `ParaProvider` or when you call any methods that request an updated session.
+     */
+    abstract ready(): Promise<void>;
     protected setAuth(auth: PrimaryAuth, { extras, userId }?: {
         extras?: AuthExtras;
         userId?: string;
     }): Promise<typeof this.authInfo>;
-    protected assertUserId(): string;
+    protected assertUserId({ allowGuestMode }?: {
+        allowGuestMode?: boolean;
+    }): string;
     protected assertIsAuthSet(allowed?: AuthType[]): PrimaryAuthInfo;
     /**
      * Sets the email associated with the `ParaCore` instance.
@@ -231,7 +257,8 @@ 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>;
+    protected addExternalWallets(externalWallets: ExternalWalletInfo[]): Promise<void>;
     /**
      * Sets the user id associated with the `ParaCore` instance.
      * @param userId - User id to set.
@@ -282,6 +309,7 @@ export declare abstract class ParaCore implements CoreInterface {
     /**
      * 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>;
@@ -302,7 +330,7 @@ export declare abstract class ParaCore implements CoreInterface {
      */
     findWalletByAddress(address: string, filter?: WalletFilters | undefined): any;
     findWallet(idOrAddress?: string, overrideType?: TWalletType, filter?: WalletFilters): Omit<Wallet, 'signer'> | undefined;
-    get availableWallets(): Pick<Wallet, 'id' | 'type' | 'name' | 'address' | 'isExternal'>[];
+    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.
@@ -342,13 +370,15 @@ export declare abstract class ParaCore implements CoreInterface {
      */
     loginExternalWallet({ externalWallet, ...urlOptions }: CoreMethodParams<'loginExternalWallet'>): CoreMethodResponse<'loginExternalWallet'>;
     verifyExternalWallet({ externalWallet, signedMessage, cosmosPublicKeyHex, cosmosSigner, ...urlOptions }: CoreMethodParams<'verifyExternalWallet'>): CoreMethodResponse<'verifyExternalWallet'>;
-    /**
-     * 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'>;
+    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
@@ -371,7 +401,7 @@ export declare abstract class ParaCore implements CoreInterface {
     /**
      * 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
@@ -383,6 +413,9 @@ export declare abstract class ParaCore implements CoreInterface {
      **/
     isFullyLoggedIn(): CoreMethodResponse<'isFullyLoggedIn'>;
     get isGuestMode(): boolean;
+    /**
+     * Get the auth methods available to an existing user
+     */
     protected supportedAuthMethods(auth: Auth<PrimaryAuthType | 'userId'>): Promise<Set<AuthMethod>>;
     /**
      * Get hints associated with the users stored biometrics.
@@ -396,35 +429,30 @@ export declare abstract class ParaCore implements CoreInterface {
     waitForSignup({ isCanceled, onCancel, onPoll, }: CoreMethodParams<'waitForSignup'>): CoreMethodResponse<'waitForSignup'>;
     waitForWalletCreation({ isCanceled, onCancel, }?: CoreMethodParams<'waitForWalletCreation'>): CoreMethodResponse<'waitForWalletCreation'>;
     /**
-     * Initiates a Farcaster login attempt and return the URI for the user to connect.
+     * 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(): CoreMethodResponse<'getFarcasterConnectUri'>;
-    /**
-     * 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.
-     * @return {Object} `{userExists: boolean; username: string; pfpUrl?: string | null }` - the user's information and whether the user already exists.
-     */
-    verifyFarcaster({ isCanceled, onConnectUri, onCancel, onPoll, ...urlOptions }: CoreMethodParams<'verifyFarcaster'>): CoreMethodResponse<'verifyFarcaster'>;
-    /**
-     * Generates a URL for the user to log in with OAuth using a desire method.
-     *
-     * @param {Object} opts the options object
-     * @param {TOAuthMethod} 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.
-     * @returns {string} the URL for the user to log in with OAuth.
-     */
-    getOAuthUrl({ method, deeplinkUrl, ...params }: CoreMethodParams<'getOAuthUrl'>): CoreMethodResponse<'getOAuthUrl'>;
-    /**
-     * 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.
-     *
-     * @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
-     */
-    verifyOAuth({ method, deeplinkUrl, isCanceled, onCancel, onPoll, onOAuthUrl, ...urlOptions }: CoreMethodParams<'verifyOAuth'>): CoreMethodResponse<'verifyOAuth'>;
+    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.
      *
@@ -495,7 +523,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`
@@ -587,7 +615,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'>;
+    getWalletBalance: ({ walletId, rpcUrl, }: CoreMethodParams<"getWalletBalance">) => CoreMethodResponse<"getWalletBalance">;
     /**
      * Signs a message using one of the current wallets.
      *
@@ -640,6 +668,7 @@ export declare abstract class ParaCore implements CoreInterface {
      * @returns {Promise<string>} the ID
      **/
     getVerificationToken(): CoreMethodResponse<'getVerificationToken'>;
+    issueJwt({ keyIndex }?: CoreMethodParams<'issueJwt'>): CoreMethodResponse<'issueJwt'>;
     /**
      * Logs the user out.
      * @param {Object} opts the options object.
@@ -648,20 +677,20 @@ 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;
+    protected devLog(...s: string[]): void;
     protected getNewCredentialAndUrl({ authMethod, isForNewDevice, portalTheme, shorten, }?: NewCredentialUrlParams): Promise<{
         credentialId: string;
         url?: string;
     }>;
     /**
-     * Returns a Para Portal URL for logging in with a WebAuth passkey or a password.
+     * Returns a Para Portal URL for logging in with a WebAuth passkey, password or PIN.
      * @param {Object} opts the options object
      * @param {String} opts.auth - the user auth to sign up or log in with, in the form ` { email: string } | { phone: `+${number}` } `
      * @param {boolean} opts.useShortUrls - whether to shorten the generated portal URLs
@@ -669,6 +698,15 @@ 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 prepareLogin(): InternalMethodResponse<'prepareLogin'>;
     signUpOrLogIn({ auth, ...urlOptions }: CoreMethodParams<'signUpOrLogIn'>): CoreMethodResponse<'signUpOrLogIn'>;
     verifyNewAccount({ verificationCode, ...urlOptions }: CoreMethodParams<'verifyNewAccount'>): CoreMethodResponse<'verifyNewAccount'>;
+    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'>;
+    protected sendLoginCode(): Promise<void>;
 }

package/dist/types/PlatformUtils.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import { BackupKitEmailProps, TPregenIdentifierType, TWalletType, SDKType } from '@getpara/user-management-client';
 import { Ctx, PopupType, SignatureRes } from './types/index.js';
 import { StorageUtils } from './StorageUtils.js';
@@ -44,5 +42,6 @@ export interface PlatformUtils {
     disableProviderModal?: boolean;
     openPopup(popupUrl: string, opts?: {
         type: PopupType;
-    }): Window;
+    }): Promise<Window>;
+    initializeWorker(ctx: Ctx): Promise<void>;
 }

package/dist/types/constants.d.ts

@@ -1,20 +1,22 @@
 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_EXTERNAL_WALLET_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 PARA_PREFIX = "@PARA/";
+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,11 +1,11 @@
 import { ParaCore } from './ParaCore.js';
-export { type AuthInfo, type PrimaryAuthInfo, type VerifiedAuthInfo, AuthMethod, type AuthExtras, type CurrentWalletIds, EmailTheme, type PartnerEntity, type WalletEntity, Network, type TWalletType, type TWalletScheme, OnRampAsset, OnRampPurchaseType, OnRampProvider, OnRampPurchaseStatus, type OnRampConfig, type OnRampAllowedAssets, type OnRampPurchase, type TOAuthMethod, type SupportedWalletTypes, type TPregenIdentifierType, type PregenIds, NON_ED25519, PREGEN_IDENTIFIER_TYPES, WALLET_TYPES, WALLET_SCHEMES, OAUTH_METHODS, } 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, } 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';
 export { getPortalDomain, entityToWallet, constructUrl, shortenUrl } from './utils/index.js';
-export { PREFIX as STORAGE_PREFIX } from './constants.js';
+export { PREFIX as STORAGE_PREFIX, PARA_PREFIX as PARA_STORAGE_PREFIX } from './constants.js';
 export { distributeNewShare } from './shares/shareDistribution.js';
 export { KeyContainer } from './shares/KeyContainer.js';
 export type { PlatformUtils } from './PlatformUtils.js';

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"
+}

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

@@ -1,5 +1,5 @@
 import { AxiosInstance } from 'axios';
-import Client, { EmailTheme, Network, OnRampAsset, OnRampProvider, TWalletScheme, TWalletType } from '@getpara/user-management-client';
+import Client, { EmailTheme, Network, OnRampAsset, OnRampProvider, PregenAuth, TWalletScheme, TWalletType } from '@getpara/user-management-client';
 import { Theme } from './theme.js';
 export declare enum Environment {
     DEV = "DEV",
@@ -140,4 +140,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;
+    }>;
 }