@getpara/core-sdk 2.24.0 → 3.0.0-alpha.0

package/dist/esm/services/SignupFlowService.js

@@ -31,29 +31,44 @@ class SignupFlowService extends BaseAuthFlowService {
         signupAuthMethods
       });
       if (isPasskey) {
-        const { url: passkeyUrl, credentialId: passkeyId } = yield this.services.authService.getNewCredentialAndUrl({
+        const {
+          url: passkeyUrl,
+          fullUrl: passkeyFullUrl,
+          credentialId: passkeyId
+        } = yield this.services.authService.getNewCredentialAndUrl({
           authMethod: "PASSKEY",
           shorten
         });
         if (passkeyUrl) signupState.passkeyUrl = passkeyUrl;
+        if (passkeyFullUrl) signupState.passkeyFullUrl = passkeyFullUrl;
         signupState.passkeyId = passkeyId;
       }
       if (isPassword) {
-        const { url: passwordUrl, credentialId: passwordId } = yield this.services.authService.getNewCredentialAndUrl({
+        const {
+          url: passwordUrl,
+          fullUrl: passwordFullUrl,
+          credentialId: passwordId
+        } = yield this.services.authService.getNewCredentialAndUrl({
           authMethod: "PASSWORD",
           portalTheme,
           shorten
         });
         signupState.passwordUrl = passwordUrl;
+        if (passwordFullUrl) signupState.passwordFullUrl = passwordFullUrl;
         signupState.passwordId = passwordId;
       }
       if (isPIN) {
-        const { url: pinUrl, credentialId: pinId } = yield this.services.authService.getNewCredentialAndUrl({
+        const {
+          url: pinUrl,
+          fullUrl: pinFullUrl,
+          credentialId: pinId
+        } = yield this.services.authService.getNewCredentialAndUrl({
           authMethod: "PIN",
           portalTheme,
           shorten
         });
         signupState.pinUrl = pinUrl;
+        if (pinFullUrl) signupState.pinFullUrl = pinFullUrl;
         signupState.pinId = pinId;
       }
       return signupState;

package/dist/esm/services/VerificationFlowService.js

@@ -23,14 +23,19 @@ class VerificationFlowService extends BaseAuthFlowService {
       this.services.authService.isEnclaveUser = isSLOPossible;
       yield this.paraCoreInterface.localStorageSetItem(LOCAL_STORAGE_IS_ENCLAVE_USER, JSON.stringify(isSLOPossible));
       const isExternalWalletFullAuth = (_a = serverAuthState.externalWallet) == null ? void 0 : _a.withFullParaAuth;
-      return __spreadValues(__spreadValues({}, serverAuthState), isSLOPossible || isExternalWalletFullAuth ? {
-        loginUrl: yield this.services.portalUrlService.getLoginUrl({
+      let loginUrl;
+      let loginFullUrl;
+      if (isSLOPossible || isExternalWalletFullAuth) {
+        const result = yield this.services.portalUrlService.getLoginUrl({
           authMethod: AuthMethod.BASIC_LOGIN,
           sessionId: sessionLookupId,
           shorten,
           portalTheme
-        })
-      } : {});
+        });
+        loginUrl = result.url;
+        loginFullUrl = result.fullUrl;
+      }
+      return __spreadValues(__spreadValues({}, serverAuthState), loginUrl ? { loginUrl, loginFullUrl } : {});
     });
     this.performVerifyNewAccount = (params) => __async(this, null, function* () {
       this.services.authService.assertIsAuthSet(["email", "phone"]);

package/dist/esm/services/WalletService.js

@@ -127,6 +127,8 @@ class WalletService {
       yield this.setCurrentWalletIds(updatedWalletIds, options);
     });
     this.setCurrentWalletIds = (_0, ..._1) => __async(this, [_0, ..._1], function* (currentWalletIds, { needsWallet = false, sessionLookupId, newDeviceSessionLookupId } = {}) {
+      var _a;
+      const hasChanged = JSON.stringify((_a = this.currentWalletIds) != null ? _a : {}) !== JSON.stringify(currentWalletIds != null ? currentWalletIds : {});
       this.currentWalletIds = currentWalletIds;
       yield __privateGet(this, _paraCoreInterface).localStorageSetItem(
         LOCAL_STORAGE_CURRENT_WALLET_IDS,
@@ -141,7 +143,9 @@ class WalletService {
           newDeviceSessionLookupId
         );
       }
-      dispatchEvent(ParaEvent.WALLETS_CHANGE_EVENT, null);
+      if (hasChanged) {
+        dispatchEvent(ParaEvent.WALLETS_CHANGE_EVENT, null);
+      }
     });
     this.createWallet = (..._0) => __async(this, [..._0], function* ({ type: _type, skipDistribute = false } = {}) {
       var _a, _b;
@@ -393,6 +397,9 @@ class WalletService {
     this.getWalletBalance = (_0) => __async(this, [_0], function* ({ walletId, rpcUrl }) {
       return (yield __privateGet(this, _paraCoreInterface).ctx.client.getWalletBalance({ walletId, rpcUrl })).balance;
     });
+    this.requestFaucet = (_0) => __async(this, [_0], function* ({ walletId, chain }) {
+      return yield __privateGet(this, _paraCoreInterface).ctx.client.requestFaucet({ walletId, chain });
+    });
     __privateAdd(this, _encodeWalletBase64, (wallet) => {
       const walletJson = JSON.stringify(wallet);
       const base64Wallet = Buffer.from(walletJson).toString("base64");

package/dist/esm/state/CoreStateManager.js

@@ -80,7 +80,7 @@ const _CoreStateManager = class _CoreStateManager {
    * Extracts all data needed by UI consumers from authStateResult.
    */
   computeAuthStateInfo(authContext, walletContext) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I;
     const defaultAuthStateInfo = {
       userId: null,
       isPasskeySupported: false,
@@ -89,11 +89,15 @@ const _CoreStateManager = class _CoreStateManager {
       hasPassword: false,
       hasPin: false,
       passkeyUrl: null,
+      passkeyFullUrl: null,
       passkeyKnownDeviceUrl: null,
       passwordUrl: null,
       pinUrl: null,
+      passwordFullUrl: null,
+      pinFullUrl: null,
       passkeyId: null,
       verificationUrl: null,
+      verificationFullUrl: null,
       externalWalletVerification: null,
       recoverySecret: null,
       isNewUser: false
@@ -123,10 +127,14 @@ const _CoreStateManager = class _CoreStateManager {
     let hasPin = false;
     let isPasskeySupported = false;
     let passkeyUrl = null;
+    let passkeyFullUrl = null;
     let passkeyKnownDeviceUrl = null;
     let passwordUrl = null;
     let pinUrl = null;
+    let passwordFullUrl = null;
+    let pinFullUrl = null;
     let verificationUrl = null;
+    let verificationFullUrl = null;
     let passkeyHints = null;
     let passkeyId = null;
     if (stage === "login") {
@@ -137,24 +145,31 @@ const _CoreStateManager = class _CoreStateManager {
       hasPin = authMethods.includes("PIN");
       isPasskeySupported = (_k = loginState.isPasskeySupported) != null ? _k : false;
       passkeyUrl = (_l = loginState.passkeyUrl) != null ? _l : null;
-      passkeyKnownDeviceUrl = (_m = loginState.passkeyKnownDeviceUrl) != null ? _m : null;
-      passwordUrl = (_n = loginState.passwordUrl) != null ? _n : null;
-      pinUrl = (_o = loginState.pinUrl) != null ? _o : null;
-      passkeyHints = (_p = loginState.biometricHints) != null ? _p : null;
+      passkeyFullUrl = (_m = loginState.passkeyFullUrl) != null ? _m : null;
+      passkeyKnownDeviceUrl = (_n = loginState.passkeyKnownDeviceUrl) != null ? _n : null;
+      passwordUrl = (_o = loginState.passwordUrl) != null ? _o : null;
+      pinUrl = (_p = loginState.pinUrl) != null ? _p : null;
+      passwordFullUrl = (_q = loginState.passwordFullUrl) != null ? _q : null;
+      pinFullUrl = (_r = loginState.pinFullUrl) != null ? _r : null;
+      passkeyHints = (_s = loginState.biometricHints) != null ? _s : null;
     } else if (stage === "signup") {
       const signupState = authStateResult;
-      const authMethods = (_q = signupState.signupAuthMethods) != null ? _q : [];
+      const authMethods = (_t = signupState.signupAuthMethods) != null ? _t : [];
       hasPasskey = authMethods.includes("PASSKEY");
       hasPassword = authMethods.includes("PASSWORD");
       hasPin = authMethods.includes("PIN");
-      isPasskeySupported = (_r = signupState.isPasskeySupported) != null ? _r : false;
-      passkeyUrl = (_s = signupState.passkeyUrl) != null ? _s : null;
-      passwordUrl = (_t = signupState.passwordUrl) != null ? _t : null;
-      pinUrl = (_u = signupState.pinUrl) != null ? _u : null;
-      passkeyId = (_v = signupState.passkeyId) != null ? _v : null;
+      isPasskeySupported = (_u = signupState.isPasskeySupported) != null ? _u : false;
+      passkeyUrl = (_v = signupState.passkeyUrl) != null ? _v : null;
+      passkeyFullUrl = (_w = signupState.passkeyFullUrl) != null ? _w : null;
+      passwordUrl = (_x = signupState.passwordUrl) != null ? _x : null;
+      pinUrl = (_y = signupState.pinUrl) != null ? _y : null;
+      passwordFullUrl = (_z = signupState.passwordFullUrl) != null ? _z : null;
+      pinFullUrl = (_A = signupState.pinFullUrl) != null ? _A : null;
+      passkeyId = (_B = signupState.passkeyId) != null ? _B : null;
     } else if (stage === "verify") {
       const verifyState = authStateResult;
-      verificationUrl = (_w = verifyState.loginUrl) != null ? _w : null;
+      verificationUrl = (_C = verifyState.loginUrl) != null ? _C : null;
+      verificationFullUrl = (_D = verifyState.loginFullUrl) != null ? _D : null;
     }
     return {
       userId,
@@ -164,15 +179,19 @@ const _CoreStateManager = class _CoreStateManager {
       hasPassword,
       hasPin,
       passkeyUrl,
+      passkeyFullUrl,
       passkeyKnownDeviceUrl,
       passwordUrl,
       pinUrl,
+      passwordFullUrl,
+      pinFullUrl,
       passkeyId,
       verificationUrl,
+      verificationFullUrl,
       externalWalletVerification: externalWalletVerification ? {
-        signatureVerificationMessage: (_x = externalWalletVerification.signatureVerificationMessage) != null ? _x : "",
-        walletAddress: (_z = (_y = externalWalletVerification.externalWallet) == null ? void 0 : _y.address) != null ? _z : "",
-        walletType: (_B = (_A = externalWalletVerification.externalWallet) == null ? void 0 : _A.type) != null ? _B : ""
+        signatureVerificationMessage: (_E = externalWalletVerification.signatureVerificationMessage) != null ? _E : "",
+        walletAddress: (_G = (_F = externalWalletVerification.externalWallet) == null ? void 0 : _F.address) != null ? _G : "",
+        walletType: (_I = (_H = externalWalletVerification.externalWallet) == null ? void 0 : _H.type) != null ? _I : ""
       } : null,
       recoverySecret,
       isNewUser
@@ -202,6 +221,7 @@ const _CoreStateManager = class _CoreStateManager {
       newWalletsResult: (walletMachineState == null ? void 0 : walletMachineState.context.newWalletsResult) || null,
       externalWalletSignVerification: (authMachineState == null ? void 0 : authMachineState.context.externalWalletSignVerification) || null,
       isNewUser: (authMachineState == null ? void 0 : authMachineState.context.isNewUser) || false,
+      selectedOAuthMethod: (authMachineState == null ? void 0 : authMachineState.context.selectedOAuthMethod) || null,
       // Wallet process
       guestWallets: (walletMachineState == null ? void 0 : walletMachineState.context.guestWallets) || null
     };
@@ -229,11 +249,11 @@ const _CoreStateManager = class _CoreStateManager {
   }
   statesEqual(state1, state2) {
     var _a, _b;
-    return state1.phase === state2.phase && state1.authStatePhase === state2.authStatePhase && state1.walletStatePhase === state2.walletStatePhase && state1.isLoading === state2.isLoading && state1.isReady === state2.isReady && state1.isNewUser === state2.isNewUser && state1.needsWallet === state2.needsWallet && ((_a = state1.error) == null ? void 0 : _a.message) === ((_b = state2.error) == null ? void 0 : _b.message) && state1.authStateResult === state2.authStateResult && state1.newWalletsResult === state2.newWalletsResult && state1.guestWallets === state2.guestWallets && state1.externalWalletSignVerification === state2.externalWalletSignVerification && this.authStateInfoEqual(state1.authStateInfo, state2.authStateInfo);
+    return state1.phase === state2.phase && state1.authStatePhase === state2.authStatePhase && state1.walletStatePhase === state2.walletStatePhase && state1.isLoading === state2.isLoading && state1.isReady === state2.isReady && state1.isNewUser === state2.isNewUser && state1.needsWallet === state2.needsWallet && ((_a = state1.error) == null ? void 0 : _a.message) === ((_b = state2.error) == null ? void 0 : _b.message) && state1.authStateResult === state2.authStateResult && state1.newWalletsResult === state2.newWalletsResult && state1.guestWallets === state2.guestWallets && state1.externalWalletSignVerification === state2.externalWalletSignVerification && state1.selectedOAuthMethod === state2.selectedOAuthMethod && this.authStateInfoEqual(state1.authStateInfo, state2.authStateInfo);
   }
   authStateInfoEqual(a, b) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _i;
-    return a.userId === b.userId && a.isPasskeySupported === b.isPasskeySupported && a.hasPasskey === b.hasPasskey && a.hasPassword === b.hasPassword && a.hasPin === b.hasPin && a.passkeyUrl === b.passkeyUrl && a.passkeyKnownDeviceUrl === b.passkeyKnownDeviceUrl && a.passwordUrl === b.passwordUrl && a.pinUrl === b.pinUrl && a.passkeyId === b.passkeyId && a.verificationUrl === b.verificationUrl && a.recoverySecret === b.recoverySecret && a.isNewUser === b.isNewUser && ((_a = a.externalWalletVerification) == null ? void 0 : _a.signatureVerificationMessage) === ((_b = b.externalWalletVerification) == null ? void 0 : _b.signatureVerificationMessage) && ((_c = a.externalWalletVerification) == null ? void 0 : _c.walletAddress) === ((_d = b.externalWalletVerification) == null ? void 0 : _d.walletAddress) && ((_e = a.externalWalletVerification) == null ? void 0 : _e.walletType) === ((_f = b.externalWalletVerification) == null ? void 0 : _f.walletType) && ((_g = a.passkeyHints) == null ? void 0 : _g.length) === ((_h = b.passkeyHints) == null ? void 0 : _h.length) && ((_i = a.passkeyHints) != null ? _i : []).every(
+    return a.userId === b.userId && a.isPasskeySupported === b.isPasskeySupported && a.hasPasskey === b.hasPasskey && a.hasPassword === b.hasPassword && a.hasPin === b.hasPin && a.passkeyUrl === b.passkeyUrl && a.passkeyFullUrl === b.passkeyFullUrl && a.passkeyKnownDeviceUrl === b.passkeyKnownDeviceUrl && a.passwordUrl === b.passwordUrl && a.passwordFullUrl === b.passwordFullUrl && a.pinUrl === b.pinUrl && a.pinFullUrl === b.pinFullUrl && a.passkeyId === b.passkeyId && a.verificationUrl === b.verificationUrl && a.verificationFullUrl === b.verificationFullUrl && a.recoverySecret === b.recoverySecret && a.isNewUser === b.isNewUser && ((_a = a.externalWalletVerification) == null ? void 0 : _a.signatureVerificationMessage) === ((_b = b.externalWalletVerification) == null ? void 0 : _b.signatureVerificationMessage) && ((_c = a.externalWalletVerification) == null ? void 0 : _c.walletAddress) === ((_d = b.externalWalletVerification) == null ? void 0 : _d.walletAddress) && ((_e = a.externalWalletVerification) == null ? void 0 : _e.walletType) === ((_f = b.externalWalletVerification) == null ? void 0 : _f.walletType) && ((_g = a.passkeyHints) == null ? void 0 : _g.length) === ((_h = b.passkeyHints) == null ? void 0 : _h.length) && ((_i = a.passkeyHints) != null ? _i : []).every(
       (hint, i) => hint.useragent === b.passkeyHints[i].useragent && hint.aaguid === b.passkeyHints[i].aaguid
     );
   }

package/dist/esm/state/machines/authStateMachine.js

@@ -114,6 +114,7 @@ function createAuthStateMachine(paraCoreInterface) {
         shouldAutoCreateWallets: false,
         skipSessionRefreshOnSetup: false,
         isLegacy: false,
+        selectedOAuthMethod: null,
         retryAttempts: {},
         externalWalletInfo: void 0,
         externalWalletSignVerification: void 0
@@ -175,8 +176,12 @@ function createAuthStateMachine(paraCoreInterface) {
       shouldAutoCreateWallets: false,
       skipSessionRefreshOnSetup: false,
       isLegacy: false,
+      selectedOAuthMethod: null,
       retryAttempts: {}
     }),
+    on: {
+      LOGOUT: { target: ".unauthenticated", actions: ["resetState"] }
+    },
     states: {
       checking_state: {
         invoke: {
@@ -212,6 +217,7 @@ function createAuthStateMachine(paraCoreInterface) {
         }
       },
       unauthenticated: {
+        entry: [assign({ selectedOAuthMethod: null })],
         on: __spreadProps(__spreadValues({}, AUTH_RESTART_TRANSITIONS), {
           INITIALIZE_GUEST_MODE: "guest_mode",
           SESSION_IMPORTED: "authenticated"
@@ -335,6 +341,12 @@ function createAuthStateMachine(paraCoreInterface) {
                 };
               }
               return null;
+            },
+            selectedOAuthMethod: ({ event }) => {
+              if (event.type === "AUTHENTICATE_OAUTH") {
+                return event.data.method;
+              }
+              return null;
             }
           }),
           "setIsLegacy"

package/dist/esm/types/coreApi.js

@@ -47,6 +47,7 @@ const PARA_CORE_METHODS = [
   "signTransaction",
   "initiateOnRampTransaction",
   "getWalletBalance",
+  "requestFaucet",
   "issueJwt",
   "getLinkedAccounts",
   "accountLinkInProgress",

package/dist/types/ParaCore.d.ts

@@ -1,9 +1,9 @@
-import { AuthMethod, AuthExtras, CurrentWalletIds, EmailTheme, PartnerEntity, TWalletType, PregenIds, BiometricLocationHint, Auth, SupportedWalletTypes, AuthIdentifier, AuthType, ExternalWalletInfo, PrimaryAuthInfo, SessionInfo, PrimaryAuth, PrimaryAuthType, AccountMetadata, LinkedAccounts, VerifyLinkParams, VerifyExternalWalletParams as VerifyExternalWalletParamsServer, SupportedAccountLinks, OnRampPurchase, BalancesConfig, Theme, IssueJwtParams, TWalletScheme } 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 as VerifyExternalWalletParamsServer, SupportedAccountLinks, OnRampPurchase, BalancesConfig, IssueJwtParams, TWalletScheme } from '@getpara/user-management-client';
 import type { pki as pkiType } from 'node-forge';
-import { Ctx, Environment, Wallet, ConstructorOpts, CoreAuthInfo, CoreMethodParams, CoreMethodResponse, CoreInterface, AccountLinkInProgress, InternalMethodParams, InternalMethodResponse, OAuthResponse, AvailableWallet } from './types/index.js';
+import { Ctx, Environment, Wallet, ConstructorOpts, CoreAuthInfo, CoreMethodParams, CoreMethodResponse, CoreInterface, AccountLinkInProgress, InternalMethodParams, InternalMethodResponse, OAuthResponse, AvailableWallet, PortalTheme } from './types/index.js';
 import { PlatformUtils } from './PlatformUtils.js';
 import { AuthServiceInterface, ExternalWalletServiceInterface, PollingServiceInterface, PortalUrlServiceInterface, PregenWalletServiceInterface, SessionManagementServiceInterface, StateMachineInterface, WalletServiceInterface } from './types/serviceInterfaces.js';
-import type { WaitForLoginParams, WaitForLoginResponse, WaitForSignupParams, WaitForWalletCreationParams, VerifyFarcasterParams, VerifyFarcasterResponse, VerifyNewAccountParams, VerifyTelegramParams, AddCredentialParams, GetNewCredentialAndUrlParams, GetNewCredentialAndUrlResponse, LoginExternalWalletParams, ResendVerificationCodeParams, SignUpOrLogInParams, VerifyOAuthProcessParams, VerifyOAuthProcessResponse, GetLoginUrlParams, GetOAuthUrlParams, PortalUrlOptions, PortalUrlType, ClaimPregenWalletsParams, CreatePregenWalletParams, CreatePregenWalletPerTypeParams, GetPregenWalletsParams, HasPregenWalletParams, UpdatePregenWalletIdentifierParams, CreateWalletParams, CreateWalletPerTypeParams, DistributeNewWalletShareParams, FindWalletByAddressParams, FindWalletIdParams, FindWalletParams, GetDisplayAddressParams, GetIdenticonHashParams, GetWalletBalanceParams, GetWalletsByTypeParams, RefreshShareParams, SetCurrentWalletIdsParams, SetWalletsParams, RefreshSessionParams, VerifyExternalWalletParams, InitExternalWalletProviderParams, ConnectExternalWalletParams, ExternalSignMessageParams, AuthenticateWithEmailOrPhoneParams, AuthenticateWithOAuthParams } from './services/types';
+import type { WaitForLoginParams, WaitForLoginResponse, WaitForSignupParams, WaitForWalletCreationParams, VerifyFarcasterParams, VerifyFarcasterResponse, VerifyNewAccountParams, VerifyTelegramParams, AddCredentialParams, GetNewCredentialAndUrlParams, GetNewCredentialAndUrlResponse, LoginExternalWalletParams, ResendVerificationCodeParams, SignUpOrLogInParams, VerifyOAuthProcessParams, VerifyOAuthProcessResponse, GetLoginUrlParams, GetOAuthUrlParams, PortalUrlOptions, PortalUrlType, ClaimPregenWalletsParams, CreatePregenWalletParams, CreatePregenWalletPerTypeParams, GetPregenWalletsParams, HasPregenWalletParams, UpdatePregenWalletIdentifierParams, CreateWalletParams, CreateWalletPerTypeParams, DistributeNewWalletShareParams, FindWalletByAddressParams, FindWalletIdParams, FindWalletParams, GetDisplayAddressParams, GetIdenticonHashParams, GetWalletBalanceParams, GetWalletsByTypeParams, RequestFaucetParams, RequestFaucetResponse, RefreshShareParams, SetCurrentWalletIdsParams, SetWalletsParams, RefreshSessionParams, VerifyExternalWalletParams, InitExternalWalletProviderParams, ConnectExternalWalletParams, ExternalSignMessageParams, AuthenticateWithEmailOrPhoneParams, AuthenticateWithOAuthParams } from './services/types';
 import { CorePhase, StateSnapshot } from './state/types/core.js';
 import { AuthPhase } from './state/types/auth.js';
 import { WalletPhase } from './state/types/wallet.js';
@@ -198,7 +198,7 @@ export declare abstract class ParaCore implements CoreInterface {
      * Theme to use for the portal
      * WARNING: This theme will override portal options set within the developer portal.
      */
-    portalTheme?: Theme;
+    portalTheme?: PortalTheme;
     /**
      * Whether or not to treat external wallets as connections only, skipping all Para functionality.
      */
@@ -258,7 +258,7 @@ export declare abstract class ParaCore implements CoreInterface {
     getAddress(walletId?: string): string | undefined;
     protected abstract getPlatformUtils(): PlatformUtils;
     abstract isPasskeySupported(): Promise<boolean>;
-    protected constructPortalUrl(type: PortalUrlType, opts?: PortalUrlOptions): Promise<string>;
+    protected constructPortalUrl(type: PortalUrlType, opts?: PortalUrlOptions): Promise<import("./services/types").ConstructPortalUrlResult>;
     static resolveEnvironment(env: Environment | undefined, apiKey: string | undefined): Environment;
     /**
      * Constructs a new `ParaCore` instance.
@@ -746,6 +746,14 @@ export declare abstract class ParaCore implements CoreInterface {
     private getTransactionReviewUrl;
     private getOnRampTransactionUrl;
     getWalletBalance(params: GetWalletBalanceParams): Promise<string>;
+    /**
+     * Requests testnet funds from the faucet for the specified wallet.
+     * @param {RequestFaucetParams} params the options object.
+     * @param {string} params.walletId the id of the wallet to fund.
+     * @param {string} [params.chain] optional chain identifier to target a specific testnet.
+     * @returns the faucet transaction details, including the transaction hash and amount sent.
+     */
+    requestFaucet(params: RequestFaucetParams): Promise<RequestFaucetResponse>;
     /**
      * Signs a message using one of the current wallets.
      *
@@ -838,7 +846,7 @@ export declare abstract class ParaCore implements CoreInterface {
      * @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
-     * @param {Theme} opts.portalTheme the Para Portal theme to apply to the password creation URL, if other than the default theme
+     * @param {PortalTheme} opts.portalTheme the Para Portal theme to apply to the password creation URL, if other than the default theme
      * @returns {SignUpOrLogInResponse} an object in the form of either: `{ stage: 'verify' }` or `{ stage: 'login'; passkeyUrl?: string; passwordUrl?: string; biometricHints?: BiometricLocationHint[] }`
      */
     protected getLoginUrl(params: GetLoginUrlParams): Promise<string>;
@@ -858,6 +866,8 @@ export declare abstract class ParaCore implements CoreInterface {
         config?: BalancesConfig;
         refetch?: boolean;
     }): Promise<import("@getpara/user-management-client").ProfileBalance>;
-    protected sendLoginCode(): Promise<void>;
+    protected sendLoginCode(): Promise<{
+        userId: string;
+    }>;
     exportPrivateKey(args?: CoreMethodParams<'exportPrivateKey'>): CoreMethodResponse<'exportPrivateKey'>;
 }

package/dist/types/services/WalletService.d.ts

@@ -5,7 +5,7 @@ import { AuthService } from './AuthService.js';
 import { PollingService } from './PollingService.js';
 import { PregenWalletService } from './PregenWalletService.js';
 import { ExternalWalletService } from './ExternalWalletService.js';
-import type { AssertIsValidWalletIdMethod, AssertIsValidWalletTypeMethod, CreateWalletMethod, CreateWalletPerTypeMethod, DistributeNewWalletShareMethod, FetchWalletsMethod, FindWalletByAddressMethod, FindWalletIdMethod, FindWalletMethod, GetDisplayAddressMethod, GetIdenticonHashMethod, GetTypesToCreateMethod, GetUserShareMethod, GetWalletBalanceMethod, GetWalletsByTypeMethod, IsWalletOwnedMethod, IsWalletSupportedMethod, IsWalletUsableMethod, RefreshShareMethod, SetCurrentWalletIdsMethod, SetUserShareMethod, SetWalletsMethod } from './types/WalletServiceTypes.js';
+import type { AssertIsValidWalletIdMethod, AssertIsValidWalletTypeMethod, CreateWalletMethod, CreateWalletPerTypeMethod, DistributeNewWalletShareMethod, FetchWalletsMethod, FindWalletByAddressMethod, FindWalletIdMethod, FindWalletMethod, GetDisplayAddressMethod, GetIdenticonHashMethod, GetTypesToCreateMethod, GetUserShareMethod, GetWalletBalanceMethod, GetWalletsByTypeMethod, RequestFaucetMethod, IsWalletOwnedMethod, IsWalletSupportedMethod, IsWalletUsableMethod, RefreshShareMethod, SetCurrentWalletIdsMethod, SetUserShareMethod, SetWalletsMethod } from './types/WalletServiceTypes.js';
 export declare class WalletService {
     #private;
     get wallets(): Record<string, Wallet>;
@@ -48,6 +48,7 @@ export declare class WalletService {
     assertIsValidWalletType: AssertIsValidWalletTypeMethod;
     fetchWallets: FetchWalletsMethod;
     getWalletBalance: GetWalletBalanceMethod;
+    requestFaucet: RequestFaucetMethod;
     getUserShare: GetUserShareMethod;
     setUserShare: SetUserShareMethod;
     distributeNewWalletShare: DistributeNewWalletShareMethod;

package/dist/types/services/types/AuthServiceTypes.d.ts

@@ -18,8 +18,10 @@ export interface OAuthRedirectCallbacks {
     /**
      * Called when an OAuth URL is generated for redirect.
      * If this is provided onOAuthPopup will not be called.
+     * @param url - The (possibly shortened) URL
+     * @param fullUrl - The full unshortened URL, for preloaded iframe navigation
      */
-    onOAuthUrl?: (url: string) => void;
+    onOAuthUrl?: (url: string, fullUrl?: string) => void;
 }
 export type SetAuthMethod = (_: PrimaryAuth, __?: {
     extras?: AuthExtras;
@@ -133,6 +135,7 @@ export interface GetNewCredentialAndUrlParams extends WithCustomTheme, WithShort
 export interface GetNewCredentialAndUrlResponse {
     credentialId: string;
     url?: string;
+    fullUrl?: string;
 }
 export type GetNewCredentialAndUrlMethod = (_?: GetNewCredentialAndUrlParams) => Promise<GetNewCredentialAndUrlResponse>;
 export interface AddCredentialParams {

package/dist/types/services/types/PortalUrlServiceTypes.d.ts

@@ -1,5 +1,5 @@
-import type { TAuthMethod, Theme, TOAuthMethod } from '@getpara/user-management-client';
-import type { AccountLinkInProgress, WithAuthMethod, WithCustomTheme, WithSessionId, WithShorten } from '../../types/index.js';
+import type { TAuthMethod, TOAuthMethod } from '@getpara/user-management-client';
+import type { AccountLinkInProgress, PortalTheme, WithAuthMethod, WithCustomTheme, WithSessionId, WithShorten } from '../../types/index.js';
 type Device = {
     sessionId: string;
     encryptionKey: string;
@@ -11,7 +11,7 @@ export type PortalUrlOptions = {
     thisDevice?: Device;
     newDevice?: Device;
     sessionId?: string;
-    portalTheme?: Theme;
+    portalTheme?: PortalTheme;
     pathId?: string;
     shorten?: boolean;
     isEmbedded?: boolean;
@@ -23,9 +23,13 @@ export type PortalUrlOptions = {
     addNewCredentialPasskeyId?: string;
     useLegacyUrl?: boolean;
 };
-export type ConstructPortalUrlMethod = (type: PortalUrlType, opts?: PortalUrlOptions) => Promise<string>;
+export type ConstructPortalUrlResult = {
+    url: string;
+    fullUrl: string;
+};
+export type ConstructPortalUrlMethod = (type: PortalUrlType, opts?: PortalUrlOptions) => Promise<ConstructPortalUrlResult>;
 export type GetLoginUrlParams = WithAuthMethod & WithCustomTheme & WithShorten & WithSessionId;
-export type GetLoginUrlMethod = (_: GetLoginUrlParams) => Promise<string>;
+export type GetLoginUrlMethod = (_: GetLoginUrlParams) => Promise<ConstructPortalUrlResult>;
 export type BaseOAuthUrlParams = {
     /**
      * The third-party OAuth service.

package/dist/types/services/types/WalletServiceTypes.d.ts

@@ -106,4 +106,16 @@ export interface DistributeNewWalletShareParams {
     forceRefresh?: boolean;
 }
 export type DistributeNewWalletShareMethod = (_: DistributeNewWalletShareParams) => Promise<string>;
+export interface RequestFaucetParams {
+    walletId: string;
+    chain?: string;
+}
+export interface RequestFaucetResponse {
+    transactionHash: string;
+    amount: string;
+    chain: string;
+    walletId: string;
+    address: string;
+}
+export type RequestFaucetMethod = (_: RequestFaucetParams) => Promise<RequestFaucetResponse>;
 export {};

package/dist/types/state/machines/authStateMachine.d.ts

@@ -623,8 +623,15 @@ export declare function createAuthStateMachine(paraCoreInterface: StateMachineIn
         shouldAutoCreateWallets: false;
         skipSessionRefreshOnSetup: false;
         isLegacy: false;
+        selectedOAuthMethod: any;
         retryAttempts: {};
     };
+    readonly on: {
+        readonly LOGOUT: {
+            readonly target: ".unauthenticated";
+            readonly actions: readonly ["resetState"];
+        };
+    };
     readonly states: {
         readonly checking_state: {
             readonly invoke: {
@@ -660,6 +667,110 @@ export declare function createAuthStateMachine(paraCoreInterface: StateMachineIn
             };
         };
         readonly unauthenticated: {
+            readonly entry: readonly [import("xstate").ActionFunction<AuthContext, AuthEvents, AuthEvents, undefined, import("xstate").Values<{
+                connectExternalWallet: {
+                    src: "connectExternalWallet";
+                    logic: import("xstate").PromiseActorLogic<import("../../index.js").PerformConnectExternalWalletResponse, import("../../index.js").ConnectExternalWalletParams, import("xstate").EventObject>;
+                    id: string;
+                };
+                verifyNewAccount: {
+                    src: "verifyNewAccount";
+                    logic: import("xstate").PromiseActorLogic<{
+                        authState: ServerAuthState;
+                        opts: import("../../types/util.js").WithCustomTheme & import("../../types/util.js").WithUseShortUrls;
+                    }, import("../../services/types/VerificationFlowServiceTypes.js").PerformVerifyNewAccountParams, import("xstate").EventObject>;
+                    id: string;
+                };
+                verifyExternalWallet: {
+                    src: "verifyExternalWallet";
+                    logic: import("xstate").PromiseActorLogic<{
+                        authState: ServerAuthState;
+                        opts: import("../../types/util.js").WithCustomTheme & import("../../types/util.js").WithUseShortUrls;
+                    }, import("../../services/types/VerificationFlowServiceTypes.js").VerifyExternalWalletParams, import("xstate").EventObject>;
+                    id: string;
+                };
+                authenticateWithEmailOrPhone: {
+                    src: "authenticateWithEmailOrPhone";
+                    logic: import("xstate").PromiseActorLogic<{
+                        authState: ServerAuthState;
+                        opts: import("../../types/util.js").WithCustomTheme & import("../../types/util.js").WithUseShortUrls;
+                    }, import("../../index.js").SignUpOrLogInParams, import("xstate").EventObject>;
+                    id: string;
+                };
+                polling: {
+                    src: "polling";
+                    logic: import("xstate").CallbackActorLogic<any, import("../../index.js").PollingConfig<any>, import("xstate").EventObject>;
+                    id: string;
+                };
+                checkUserState: {
+                    src: "checkUserState";
+                    logic: import("xstate").PromiseActorLogic<{
+                        isAuthenticated: boolean;
+                        isFullyLoggedIn: boolean;
+                        isGuestMode: boolean;
+                    }, {}, import("xstate").EventObject>;
+                    id: string;
+                };
+                authenticateWithExternalWallet: {
+                    src: "authenticateWithExternalWallet";
+                    logic: import("xstate").PromiseActorLogic<{
+                        authState: ServerAuthState;
+                        opts: import("../../types/util.js").WithCustomTheme & import("../../types/util.js").WithUseShortUrls;
+                    }, import("../../index.js").LoginExternalWalletParams, import("xstate").EventObject>;
+                    id: string;
+                };
+                authenticateWithTelegram: {
+                    src: "authenticateWithTelegram";
+                    logic: import("xstate").PromiseActorLogic<AuthenticationOutput, import("../../index.js").WaitForTelegramEventParams, import("xstate").EventObject>;
+                    id: string;
+                };
+                authenticateWithTelegramLegacy: {
+                    src: "authenticateWithTelegramLegacy";
+                    logic: import("xstate").PromiseActorLogic<{
+                        authState: ServerAuthState;
+                        opts: import("../../types/util.js").WithCustomTheme & import("../../types/util.js").WithUseShortUrls;
+                    }, import("../../services/types/VerificationFlowServiceTypes.js").VerifyTelegramParams, import("xstate").EventObject>;
+                    id: string;
+                };
+                authenticateWithFarcaster: {
+                    src: "authenticateWithFarcaster";
+                    logic: import("xstate").PromiseActorLogic<AuthenticationOutput, import("../../index.js").WaitForFarcasterEventParams, import("xstate").EventObject>;
+                    id: string;
+                };
+                authenticateWithFarcasterLegacy: {
+                    src: "authenticateWithFarcasterLegacy";
+                    logic: import("xstate").PromiseActorLogic<import("../../services/types/VerificationFlowServiceTypes.js").PerformVerifyFarcasterResponse, import("../../services/types/VerificationFlowServiceTypes.js").VerifyFarcasterParams, import("xstate").EventObject>;
+                    id: string;
+                };
+                processAuthentication: {
+                    src: "processAuthentication";
+                    logic: import("xstate").PromiseActorLogic<AuthState, {
+                        authState: ServerAuthState;
+                        opts: import("../../types/util.js").WithCustomTheme & import("../../types/util.js").WithUseShortUrls & {
+                            sessionLookupId?: string;
+                            isFromExternalWallet?: boolean;
+                        };
+                    }, import("xstate").EventObject>;
+                    id: string;
+                };
+                signExternalWalletVerification: {
+                    src: "signExternalWalletVerification";
+                    logic: import("xstate").PromiseActorLogic<BaseVerifyExternalWalletParams, import("../../index.js").ExternalSignMessageParams & {
+                        externalWallet: import("@getpara/user-management-client").ExternalWalletInfo;
+                    }, import("xstate").EventObject>;
+                    id: string;
+                };
+                switchExternalWallet: {
+                    src: "switchExternalWallet";
+                    logic: import("xstate").PromiseActorLogic<import("../../index.js").PerformSwitchExternalWalletResponse, import("../../index.js").WatchWalletChangeCallbackParams, import("xstate").EventObject>;
+                    id: string;
+                };
+                logoutActor: {
+                    src: "logoutActor";
+                    logic: import("xstate").PromiseActorLogic<void, {}, import("xstate").EventObject>;
+                    id: string;
+                };
+            }>, never, never, never, never>];
             readonly on: {
                 readonly INITIALIZE_GUEST_MODE: "guest_mode";
                 readonly SESSION_IMPORTED: "authenticated";
@@ -731,7 +842,7 @@ export declare function createAuthStateMachine(paraCoreInterface: StateMachineIn
                         data: {
                             authState: ServerAuthState;
                             sessionLookupId: string;
-                            portalTheme: import("@getpara/user-management-client").Theme;
+                            portalTheme: import("../../types/util.js").PortalTheme;
                             useShortUrls: boolean;
                         };
                         finished: boolean;