diff --git a/README.md b/README.md
index 55f4ae6..bb27be8 100644
--- a/README.md
+++ b/README.md
@@ -21,8 +21,9 @@ Checkout the official [Web3Auth Documentation](https://web3auth.io/docs) and [SD
## ⏪ Requirements
-- For iOS, only iOS 12+ supported since we requires ASWebAuthenticationSession.
-
+- Node.js 22+
+- npm 10+
+- For iOS, only iOS 12+ is supported since we require `ASWebAuthenticationSession`.
- For Android, Custom Tab support is required.
## Selecting your Workflow
@@ -30,7 +31,7 @@ Checkout the official [Web3Auth Documentation](https://web3auth.io/docs) and [SD
In React Native, you have the choice to use one of the following workflows:
- **Bare Workflow**: Your React Native app is entirely built on your own machine. You can customize your app with Swift/Kotlin native modules.
-- **Expo Managed Workflow**: Your React Native Expo app is built on your Expo's cloud, so you don't have control over the native modules used in the app.
+- **Expo Managed Workflow**: Your React Native Expo app is built on Expo's cloud, so you don't have control over the native modules used in the app.
## ⚡ Installation
@@ -38,104 +39,243 @@ In React Native, you have the choice to use one of the following workflows:
npm install @web3auth/react-native-sdk
```
+Install the workflow-specific browser and secure storage packages next.
+
+### Bare workflow dependencies
+
+```sh
+npm install @toruslabs/react-native-web-browser react-native-encrypted-storage
+npm install --save-optional react-native-quick-crypto
+```
+
+### Expo managed workflow dependencies
+
+```sh
+npx expo install expo-web-browser expo-secure-store expo-linking expo-constants
+npm install --save-optional react-native-quick-crypto
+```
+
+`react-native-quick-crypto` is optional but recommended. Without it, Metro falls back to `crypto-browserify`.
+
+## 🛠️ Metro & Entry Setup
+
+Web3Auth requires Metro polyfills and a setup import before any other app code.
+
+### Metro configuration
+
+Wrap your Metro config with `withWeb3Auth`:
+
+**Bare**
+
+```js
+const { getDefaultConfig } = require("@react-native/metro-config");
+const { withWeb3Auth } = require("@web3auth/react-native-sdk/metro-config");
+
+const config = getDefaultConfig(__dirname);
+
+module.exports = withWeb3Auth(config);
+```
+
+**Expo**
+
+```js
+const { getDefaultConfig } = require("expo/metro-config");
+const { withWeb3Auth } = require("@web3auth/react-native-sdk/metro-config");
+
+const config = getDefaultConfig(__dirname);
+
+module.exports = withWeb3Auth(config);
+```
+
+### Entry point setup
+
+Import the setup module first in your root entry file (`index.js` / `index.ts`):
+
+```js
+import "@web3auth/react-native-sdk/setup";
+
+// ... rest of your app entry
+```
+
## 🌟 Configuration
### Configure your Web3Auth project
-Hop on to the [Web3Auth Dashboard](https://dashboard.web3auth.io/) and create a new project. Use the Client ID of the project to start your integration.
+Hop on to the [Web3Auth Dashboard](https://dashboard.web3auth.io/) and create a new project. Use the **Client ID** of the project to start your integration.
-- Add `{YOUR_APP_PACKAGE_NAME}://auth` to **Whitelist URLs**.
+- Choose a custom URL scheme for your app (for example `web3authrnexample`). This does **not** have to match your Android package name or iOS bundle identifier.
+- Add the exact `redirectUrl` you will pass to the SDK (for example `web3authrnexample://auth`) to **Whitelist URLs**.
+- Copy the **Client ID** for usage later.
-- Copy the Project ID for usage later.
+### Bare workflow — Android intent-filter
-### Expo Managed Workflow
+The scheme portion of `redirectUrl` must be registered in `AndroidManifest.xml` so the auth browser can return to your app.
-When using our SDK with a Expo-based React Native app (aka managed workflow, you have to install the `expo-web-browser` package as a `WebBrowser` implementation.)
+Inside your `MainActivity`, add a browsable deep-link intent filter:
-```sh
-expo install expo-web-browser
+```xml
+
+
+
+
+
```
-To allow the SDK to work with exported Expo Android apps, you need to place a designated scheme into `app.json`, like below:
+Replace `web3authrnexample` with the scheme used in your `redirectUrl`.
-```js
+### Bare workflow — iOS CFBundleURLTypes
+
+Register the same scheme in your iOS `Info.plist` via `CFBundleURLTypes`:
+
+```xml
+CFBundleURLTypes
+
+
+ CFBundleURLName
+ web3authrnexample
+ CFBundleURLSchemes
+
+ web3authrnexample
+
+
+
+```
+
+### Expo managed workflow — scheme & redirectUrl
+
+When using Expo, install the Expo browser/storage packages (see Installation) and declare a scheme in `app.json`:
+
+```json
{
"expo": {
- "scheme": "web3authexposample"
+ "scheme": "web3authexpoexample"
}
}
```
-### Bare workflow Configuration
+Derive `redirectUrl` with `expo-linking`. Expo Go and standalone/dev-client builds produce different URLs — whitelist **both** in the dashboard:
-When using our SDK with a bare workflow React Native app, you have to install a `WebBrowser` implementation made by us.
+```js
+import Constants, { AppOwnership } from "expo-constants";
+import * as Linking from "expo-linking";
-```sh
-npm install --save @toruslabs/react-native-web-browser
+const redirectUrl =
+ Constants.appOwnership === AppOwnership.Expo || Constants.appOwnership === AppOwnership.Guest
+ ? Linking.createURL("web3auth", {})
+ : Linking.createURL("web3auth", { scheme: "web3authexpoexample" });
```
-#### Android
+Standalone builds resolve to a URL like `web3authexpoexample://web3auth`. Expo Go resolves to an `exp://…/--/web3auth` URL for your current session.
-- The `scheme` parameter in the `redirectUrl` is specificable, and has to be added into the `AndroidManifest.xml`.
+### Register the redirect URL in the dashboard
-```xml
-
- uiConsole(userInfo)} />
+ uiConsole({ userInfo, isAuthorized, accessToken })} />
getIdentityToken().then(uiConsole)} />
+ getAccessToken().then(uiConsole)} />
+ getAuthTokenInfo().then(uiConsole)} />
+ refreshSession().then((ok) => uiConsole(ok ? "session refreshed" : "session refresh failed"))}
+ />
showWalletUI()} />
request("personal_sign", ["Hello World", "0x"]).then(uiConsole)} />
Use Account Abstraction:
-
// IMP END - Login
);
@@ -111,16 +106,18 @@ function HomeScreen({ useAccountAbstraction, onToggleAA }: HomeScreenProps) {
return (
- uiConsole(userInfo)} />
+ uiConsole({ userInfo, isAuthorized, accessToken })} />
getIdentityToken().then(uiConsole)} />
- showWalletUI()} />
+ getAccessToken().then(uiConsole)} />
+ getAuthTokenInfo().then(uiConsole)} />
request('personal_sign', ['Hello World', '0x']).then(uiConsole)}
+ title="Refresh Session"
+ onPress={() => refreshSession().then((ok) => uiConsole(ok ? "session refreshed" : "session refresh failed"))}
/>
+ showWalletUI()} />
+ request("personal_sign", ["Hello World", "0x"]).then(uiConsole)} />
{
+ public async getAuthTokenInfo(): Promise {
if (!this.currentSessionId) throw LoginError.userNotLoggedIn();
- // Citadel-stored idToken is authoritative; fall back to session state for SFA.
- return (await this.sessionManager.getIdToken()) ?? this.state.userInfo?.idToken ?? null;
+
+ const trackData = { connector: "auth" };
+ try {
+ this.analytics.track({
+ event: ANALYTICS_EVENTS.IDENTITY_TOKEN_STARTED,
+ properties: trackData,
+ });
+ // Citadel-stored idToken is authoritative; fall back to session state for SFA.
+ const idToken = (await this.sessionManager.getIdToken()) ?? this.state.userInfo?.idToken ?? null;
+ this.analytics.track({
+ event: ANALYTICS_EVENTS.IDENTITY_TOKEN_COMPLETED,
+ properties: trackData,
+ });
+ return { idToken };
+ } catch (e) {
+ this.analytics.track({
+ event: ANALYTICS_EVENTS.IDENTITY_TOKEN_FAILED,
+ properties: {
+ ...trackData,
+ ...getErrorAnalyticsProperties(e),
+ },
+ });
+ throw e;
+ }
+ }
+
+ /** @deprecated Use {@link getAuthTokenInfo} instead. */
+ public async getIdentityToken(): Promise {
+ const { idToken } = await this.getAuthTokenInfo();
+ return idToken;
}
public async refreshSession(): Promise {
@@ -849,8 +841,7 @@ class Web3Auth implements IWeb3Auth {
// session may already be invalid on the server
log.error("Error during session refresh: ", e);
}
- this.currentSessionId = null;
- this.updateState({ currentChainId: this.currentChainId });
+ await this.clearLocalSessionState();
throw LoginError.userNotLoggedIn();
}
this.updateState({ ...data, currentChainId: this.currentChainId });
@@ -945,8 +936,9 @@ class Web3Auth implements IWeb3Auth {
}
}
- // if AA is enabled, filter out chains that are not AA-supported
- if (this.options.accountAbstractionConfig) {
+ // if AA is enabled and smart account is not 7702, validate AA-supported chains/bundlers
+ const is7702SmartAccount = this.options.accountAbstractionConfig?.smartAccountEipStandard === SMART_ACCOUNT_EIP_STANDARD.EIP_7702;
+ if (this.options.accountAbstractionConfig && !is7702SmartAccount) {
// write a for loop over accountAbstractionConfig.chains and check if the chainId is valid
if (this.options.accountAbstractionConfig.chains.length === 0) {
log.error("Please configure chains for smart accounts on dashboard at https://dashboard.web3auth.io");
@@ -992,9 +984,9 @@ class Web3Auth implements IWeb3Auth {
if (!isAAEnabled) return;
// merge smart account config from project config with core options, core options will take precedence over project config
- const smartAccountsConfig = (projectConfig?.smartAccounts || {}) as SmartAccountsConfig;
- const aaChainMap = new Map();
- const allAaChains = [...(smartAccountsConfig?.chains || []), ...(this.options.accountAbstractionConfig?.chains || [])];
+ const { walletScope, eipStandard, ...configWithoutWalletScope } = (projectConfig?.smartAccounts || {}) as SmartAccountsConfig;
+ const aaChainMap = new Map();
+ const allAaChains = [...(configWithoutWalletScope?.chains || []), ...(this.options.accountAbstractionConfig?.chains || [])];
for (const chain of allAaChains) {
const existingChain = aaChainMap.get(chain.chainId);
if (!existingChain) aaChainMap.set(chain.chainId, chain);
@@ -1005,9 +997,36 @@ class Web3Auth implements IWeb3Auth {
this.options.accountAbstractionConfig === null
? undefined
: {
- ...deepmerge(smartAccountsConfig || {}, this.options.accountAbstractionConfig || {}),
+ smartAccountEipStandard: eipStandard,
+ ...deepmerge(configWithoutWalletScope || {}, this.options.accountAbstractionConfig || {}),
chains: Array.from(aaChainMap.values()),
};
+
+ // if eipStandard is 7702, validate smart account type
+ const { smartAccountEipStandard, smartAccountType } = (this.options.accountAbstractionConfig || {}) as {
+ smartAccountEipStandard?: string;
+ smartAccountType?: string;
+ };
+ const is7702SmartAccount = smartAccountEipStandard === SMART_ACCOUNT_EIP_STANDARD.EIP_7702;
+ if (is7702SmartAccount && smartAccountType && !(EIP7702_SUPPORTED_SMART_ACCOUNT_TYPES as readonly string[]).includes(smartAccountType)) {
+ throw InitializationError.invalidParams(
+ `Smart account type "${smartAccountType}" does not support EIP-7702. Supported: ${EIP7702_SUPPORTED_SMART_ACCOUNT_TYPES.join(", ")}`
+ );
+ }
+
+ // determine if we should use AA with external wallet
+ if (this.options.useAAWithExternalWallet === undefined) {
+ this.options.useAAWithExternalWallet = walletScope === SMART_ACCOUNT_WALLET_SCOPE.ALL;
+ }
+ }
+
+ protected initSessionTimeConfig(projectConfig: ProjectConfig) {
+ if (this.options.sessionTime) return;
+ if (projectConfig.sessionTime) {
+ this.options.sessionTime = projectConfig.sessionTime;
+ return;
+ }
+ this.options.sessionTime = 86400;
}
protected async getWallet(privateKey: string): Promise {
@@ -1028,7 +1047,9 @@ class Web3Auth implements IWeb3Auth {
const signer = ethersWallet.connect(new JsonRpcProvider(this.currentChain.rpcTarget));
let aaProvider: AccountAbstractionProvider | null = null;
- if (this.options.accountAbstractionConfig) {
+ const is7702SmartAccount = this.options.accountAbstractionConfig?.smartAccountEipStandard === SMART_ACCOUNT_EIP_STANDARD.EIP_7702;
+ // EIP-7702 uses EOA + 5792/7702 RPC only; skip ERC-4337 AA provider wrapping
+ if (this.options.accountAbstractionConfig && !is7702SmartAccount) {
const aaChainIds = new Set(this.options.accountAbstractionConfig?.chains?.map((chain) => chain.chainId) || []);
aaProvider = await accountAbstractionProvider({
accountAbstractionConfig: this.options.accountAbstractionConfig,
@@ -1059,6 +1080,7 @@ class Web3Auth implements IWeb3Auth {
enableReceiveButton = true,
enableShowAllTokensButton = true,
enableConfirmationModal = false,
+ enableDefiPositionsDisplay = true,
portfolioWidgetPosition = "bottom-left",
defaultPortfolio = "token",
} = walletUi || {};
@@ -1072,6 +1094,7 @@ class Web3Auth implements IWeb3Auth {
hideSwap: !enableSwapButton,
hideShowAllTokens: !enableShowAllTokensButton,
hideWalletConnect: !enableWalletConnect,
+ hideDefiPositionsDisplay: !enableDefiPositionsDisplay,
buttonPosition: portfolioWidgetPosition,
defaultPortfolio,
};
@@ -1123,61 +1146,118 @@ class Web3Auth implements IWeb3Auth {
properties: analyticsProperties,
});
- // check for share
- if (this.options.authConnectionConfig) {
- const authConnectionConfigItem = this.options.authConnectionConfig[0];
- if (authConnectionConfigItem) {
- const share = await this.keyStore.get(authConnectionConfigItem.authConnectionId);
- if (share) {
- loginParams.dappShare = share;
+ try {
+ // check for share
+ if (this.options.authConnectionConfig) {
+ const authConnectionConfigItem = this.options.authConnectionConfig[0];
+ if (authConnectionConfigItem) {
+ const share = await this.keyStore.get(authConnectionConfigItem.authConnectionId);
+ if (share) {
+ loginParams.dappShare = share;
+ }
}
}
- }
- const dataObject: AuthRequestPayload = {
- actionType: AUTH_ACTIONS.LOGIN,
- options: this.options,
- params: loginParams,
- };
+ const dataObject: AuthRequestPayload = {
+ actionType: AUTH_ACTIONS.LOGIN,
+ options: this.options,
+ params: loginParams,
+ };
- const result = await this.authHandler(`${this.baseUrl}/start`, dataObject);
+ const result = await this.authHandler(`${this.baseUrl}/start`, dataObject);
- if (result.type !== "success" || !result.url) {
- log.error(`[Web3Auth] login flow failed with error type ${result.type}`);
- throw LoginError.loginFailed(`login flow failed with error type ${result.type}`);
- }
+ if (result.type !== "success" || !result.url) {
+ log.error(`[Web3Auth] login flow failed with error type ${result.type}`);
+ throw LoginError.loginFailed(`login flow failed with error type ${result.type}`);
+ }
- // Persist citadel tokens from the v11 redirect; do not write a legacy KeyStore "sessionId".
- const { sessionId, accessToken, refreshToken, idToken, error } = getHashQueryParams(result.url);
- if (error || !sessionId) {
- throw LoginError.loginFailed(error || "SessionId is missing");
- }
+ // Persist citadel tokens from the v11 redirect; do not write a legacy KeyStore "sessionId".
+ const { sessionId, accessToken, refreshToken, idToken, error } = getHashQueryParams(result.url);
+ if (error || !sessionId) {
+ throw LoginError.loginFailed(error || "SessionId is missing");
+ }
- await this.sessionManager.setTokens({
- sessionId: add0x(sessionId),
- accessToken: accessToken || "",
- refreshToken: refreshToken || "",
- idToken: idToken || "",
- });
- this.currentSessionId = sessionId;
+ await this.sessionManager.setTokens({
+ sessionId: add0x(sessionId),
+ accessToken: accessToken || "",
+ refreshToken: refreshToken || "",
+ idToken: idToken || "",
+ });
+ this.currentSessionId = sessionId;
- await this.refreshSession();
+ await this.refreshSession();
+
+ const { userInfo } = this.state;
+ if (userInfo?.dappShare?.length > 0) {
+ await this.keyStore.set(userInfo.groupedAuthConnectionId || userInfo.authConnectionId, userInfo.dappShare);
+ }
- const { userInfo } = this.state;
- if (userInfo?.dappShare?.length > 0) {
- await this.keyStore.set(userInfo.groupedAuthConnectionId || userInfo.authConnectionId, userInfo.dappShare);
+ const finalPrivKey = this.getFinalPrivKey();
+ if (!finalPrivKey) throw LoginError.loginFailed("final private key not found");
+ const walletResult = await this.getWallet(finalPrivKey);
+
+ this.analytics.track({
+ event: ANALYTICS_EVENTS.CONNECTION_COMPLETED,
+ properties: analyticsProperties,
+ });
+
+ return walletResult;
+ } catch (e) {
+ this.analytics.track({
+ event: ANALYTICS_EVENTS.CONNECTION_FAILED,
+ properties: {
+ ...analyticsProperties,
+ ...getErrorAnalyticsProperties(e),
+ },
+ });
+ throw e;
}
+ }
- const finalPrivKey = this.getFinalPrivKey();
- if (!finalPrivKey) throw LoginError.loginFailed("final private key not found");
- const walletResult = await this.getWallet(finalPrivKey);
+ /**
+ * Clears local session, provider, and signer state and notifies listeners.
+ * Used by logout and failed session refresh; does not perform remote logout.
+ */
+ private async clearLocalSessionState(): Promise {
+ this.currentSessionId = null;
- this.analytics.track({
- event: ANALYTICS_EVENTS.CONNECTION_COMPLETED,
- properties: analyticsProperties,
+ // re-setup commonJRPCProvider
+ this.commonJRPCProvider.removeAllListeners();
+ await this.setupCommonJRPCProvider();
+ this.signer = null;
+
+ this.updateState({
+ privKey: "",
+ coreKitKey: "",
+ coreKitEd25519PrivKey: "",
+ ed25519PrivKey: "",
+ walletKey: "",
+ oAuthPrivateKey: "",
+ tKey: "",
+ metadataNonce: "",
+ keyMode: undefined,
+ userInfo: {
+ name: "",
+ profileImage: "",
+ dappShare: "",
+ idToken: "",
+ oAuthIdToken: "",
+ oAuthAccessToken: "",
+ appState: "",
+ email: "",
+ userId: "",
+ authConnection: "",
+ authConnectionId: "",
+ groupedAuthConnectionId: "",
+ isMfaEnabled: false,
+ },
+ authToken: "",
+ sessionId: "",
+ signatures: [],
+ currentChainId: this.currentChainId,
});
- return walletResult;
+ this.emit("disconnected");
}
/**
@@ -1408,7 +1488,8 @@ class Web3Auth implements IWeb3Auth {
const data = await this.sessionManager.authorize();
return data ?? {};
- } catch {
+ } catch (e) {
+ log.error("Error during session authorize: ", e);
return {};
}
}
diff --git a/src/base/analytics.ts b/src/base/analytics.ts
index b04cede..51486ae 100644
--- a/src/base/analytics.ts
+++ b/src/base/analytics.ts
@@ -2,7 +2,15 @@ import { log } from "./loglevel";
import { SegmentHTTP, Traits } from "./segmentHttp";
const SEGMENT_WRITE_KEY = "f6LbNqCeVRf512ggdME4b6CyflhF1tsX";
-// const SEGMENT_WRITE_KEY_DEV = "rpE5pCcpA6ME2oFu2TbuVydhOXapjHs3";
+const SEGMENT_WRITE_KEY_DEV = "rpE5pCcpA6ME2oFu2TbuVydhOXapjHs3";
+
+export type AnalyticsOptions = {
+ /**
+ * When true, analytics are sent even in `__DEV__` builds using the development Segment write key.
+ * Has no effect when analytics are disabled via `disable()`.
+ */
+ enableAnalyticsInDev?: boolean;
+};
export class Analytics {
private segment: SegmentHTTP;
@@ -11,7 +19,16 @@ export class Analytics {
private enabled: boolean = true;
+ private enableAnalyticsInDev: boolean = false;
+
+ constructor(options: AnalyticsOptions = {}) {
+ this.enableAnalyticsInDev = Boolean(options.enableAnalyticsInDev);
+ }
+
public init(): void {
+ if (!this.enabled) {
+ return;
+ }
if (this.isSkipped()) {
return;
}
@@ -19,7 +36,8 @@ export class Analytics {
throw new Error("Analytics already initialized");
}
- this.segment = new SegmentHTTP(SEGMENT_WRITE_KEY);
+ const writeKey = __DEV__ && this.enableAnalyticsInDev ? SEGMENT_WRITE_KEY_DEV : SEGMENT_WRITE_KEY;
+ this.segment = new SegmentHTTP(writeKey);
}
public enable(): void {
@@ -72,19 +90,12 @@ export class Analytics {
}
private isSkipped() {
- // const dappOrigin = window.location.origin;
-
- // // skip if the protocol is not http or https
- // if (dappOrigin.startsWith("http://")) {
- // return true;
- // }
- // // skip if dapp contains localhost
- // if (dappOrigin.includes("localhost")) {
- // return true;
- // }
-
- // return false;
- return __DEV__;
+ // Default: skip all analytics in React Native `__DEV__` builds.
+ // QA can opt in with `enableAnalyticsInDev` (uses the development Segment key).
+ if (__DEV__ && !this.enableAnalyticsInDev) {
+ return true;
+ }
+ return false;
}
}
@@ -106,6 +117,7 @@ export const ANALYTICS_EVENTS = {
MFA_ENABLEMENT_COMPLETED: "MFA Enablement Completed",
MFA_ENABLEMENT_FAILED: "MFA Enablement Failed",
MFA_MANAGEMENT_STARTED: "MFA Management Started",
+ MFA_MANAGEMENT_SELECTED: "MFA Management Selected",
MFA_MANAGEMENT_COMPLETED: "MFA Management Completed",
MFA_MANAGEMENT_FAILED: "MFA Management Failed",
// Login Modal
diff --git a/src/base/hooks/index.ts b/src/base/hooks/index.ts
index 6e632bc..df1b7d1 100644
--- a/src/base/hooks/index.ts
+++ b/src/base/hooks/index.ts
@@ -5,7 +5,13 @@ export interface IBaseWeb3AuthHookContext {
isInitializing: boolean;
initError: unknown;
isConnected: boolean;
+ isAuthorized: boolean;
+ accessToken: string | null;
isMFAEnabled: boolean;
provider: IProvider | null;
setIsMFAEnabled(isMFAEnabled: boolean): void;
+ /** Update citadel access token + authorization without a full session resync. */
+ setAccessTokenState(token: string | null): void;
+ /** Re-read citadel session fields from the core SDK into React context. */
+ syncSessionState(): Promise;
}
diff --git a/src/metro/global-shim.js b/src/metro/global-shim.js
index e2271d7..870abfd 100644
--- a/src/metro/global-shim.js
+++ b/src/metro/global-shim.js
@@ -110,4 +110,21 @@
Event.prototype.stopPropagation = function () {};
global.Event = Event;
}
+
+ // Minimal MessageEvent polyfill for @web3auth/auth postMessageStream, which reads
+ // MessageEvent.prototype at module-load time (Hermes has no browser MessageEvent global).
+ if (typeof global.MessageEvent === "undefined") {
+ function MessageEvent(type, options) {
+ global.Event.call(this, type, options);
+ options = options || {};
+ this.data = options.data !== undefined ? options.data : null;
+ this.origin = options.origin || "";
+ this.lastEventId = options.lastEventId || "";
+ this.source = options.source || null;
+ this.ports = options.ports || [];
+ }
+ MessageEvent.prototype = Object.create(global.Event.prototype);
+ MessageEvent.prototype.constructor = MessageEvent;
+ global.MessageEvent = MessageEvent;
+ }
})();
diff --git a/src/react/context/web3AuthInnerContext.ts b/src/react/context/web3AuthInnerContext.ts
index 98ce734..bfa9442 100644
--- a/src/react/context/web3AuthInnerContext.ts
+++ b/src/react/context/web3AuthInnerContext.ts
@@ -1,6 +1,7 @@
import { type IProvider } from "@web3auth/no-modal";
-import { createContext, createElement, PropsWithChildren, useEffect, useMemo, useState } from "react";
+import { createContext, createElement, PropsWithChildren, useCallback, useEffect, useMemo, useState } from "react";
+import { ANALYTICS_INTEGRATION_TYPE } from "../../base";
import Web3Auth from "../../Web3Auth";
import { IWeb3AuthInnerContext, Web3AuthProviderProps } from "../interfaces";
@@ -16,21 +17,62 @@ export function Web3AuthInnerProvider(params: PropsWithChildren(false);
const [isMFAEnabled, setIsMFAEnabled] = useState(false);
const [isConnected, setIsConnected] = useState(false);
+ const [isAuthorized, setIsAuthorized] = useState(false);
+ const [accessToken, setAccessToken] = useState(null);
const web3Auth = useMemo(() => {
setProvider(null);
setIsConnected(false);
+ setIsAuthorized(false);
+ setAccessToken(null);
+ setIsMFAEnabled(false);
return new Web3Auth(webBrowser, storage, web3AuthOptions);
}, [web3AuthOptions, webBrowser, storage]);
+ const clearSessionSnapshot = useCallback(() => {
+ setIsConnected(false);
+ setIsAuthorized(false);
+ setAccessToken(null);
+ setIsMFAEnabled(false);
+ setProvider(null);
+ }, []);
+
+ const setAccessTokenState = useCallback((token: string | null) => {
+ setAccessToken(token);
+ setIsAuthorized(Boolean(token));
+ }, []);
+
+ const syncSessionState = useCallback(async () => {
+ if (!web3Auth?.connected) {
+ clearSessionSnapshot();
+ return;
+ }
+
+ setIsConnected(true);
+ setProvider(web3Auth.provider);
+
+ try {
+ const userInfo = web3Auth.userInfo();
+ setIsMFAEnabled(Boolean(userInfo?.isMfaEnabled));
+ } catch {
+ setIsMFAEnabled(false);
+ }
+
+ try {
+ // Citadel sessions expose an access token; SFA sessions stay connected but not authorized.
+ const token = await web3Auth.getAccessToken();
+ setAccessTokenState(token);
+ } catch {
+ setAccessTokenState(null);
+ }
+ }, [web3Auth, clearSessionSnapshot, setAccessTokenState]);
+
useEffect(() => {
const connectedListener = () => {
- setIsConnected(true);
- setProvider(web3Auth.provider);
+ void syncSessionState();
};
const disconnectedListener = () => {
- setIsConnected(false);
- setProvider(null);
+ clearSessionSnapshot();
};
web3Auth.on("connected", connectedListener);
@@ -40,7 +82,7 @@ export function Web3AuthInnerProvider(params: PropsWithChildren {
const controller = new AbortController();
@@ -48,8 +90,13 @@ export function Web3AuthInnerProvider(params: PropsWithChildren {
controller.abort();
};
- }, [web3Auth, config]);
+ }, [web3Auth, config, syncSessionState]);
const value = useMemo(() => {
return {
web3Auth,
isConnected,
+ isAuthorized,
+ accessToken,
isInitialized,
provider,
isInitializing,
initError,
isMFAEnabled,
setIsMFAEnabled,
+ setAccessTokenState,
+ syncSessionState,
};
- }, [web3Auth, isConnected, isMFAEnabled, setIsMFAEnabled, isInitialized, provider, isInitializing, initError]);
+ }, [
+ web3Auth,
+ isConnected,
+ isAuthorized,
+ accessToken,
+ isMFAEnabled,
+ setIsMFAEnabled,
+ setAccessTokenState,
+ syncSessionState,
+ isInitialized,
+ provider,
+ isInitializing,
+ initError,
+ ]);
return createElement(Web3AuthInnerContext.Provider, { value }, children);
}
diff --git a/src/react/hooks/index.ts b/src/react/hooks/index.ts
index 43e748f..fa20a8e 100644
--- a/src/react/hooks/index.ts
+++ b/src/react/hooks/index.ts
@@ -1,7 +1,9 @@
export * from "./useAccessToken";
+export * from "./useAuthTokenInfo";
export * from "./useEnableMFA";
export * from "./useIdentityToken";
export * from "./useManageMFA";
+export * from "./useRefreshSession";
export * from "./useSignatureRequest";
export * from "./useWalletUI";
export * from "./useWeb3Auth";
diff --git a/src/react/hooks/useAccessToken.ts b/src/react/hooks/useAccessToken.ts
index 5be644c..bcd4031 100644
--- a/src/react/hooks/useAccessToken.ts
+++ b/src/react/hooks/useAccessToken.ts
@@ -1,4 +1,4 @@
-import { useCallback, useEffect, useState } from "react";
+import { useCallback, useState } from "react";
import { Web3authRNError } from "../../errors";
import { useWeb3AuthInner } from "./useWeb3AuthInner";
@@ -6,37 +6,32 @@ import { useWeb3AuthInner } from "./useWeb3AuthInner";
export interface IUseAccessToken {
loading: boolean;
error: Web3authRNError | null;
+ accessToken: string | null;
+ /** @deprecated Use {@link accessToken} instead. */
token: string | null;
getAccessToken: () => Promise;
}
-export const useAccessToken = () => {
- const { web3Auth, isConnected } = useWeb3AuthInner();
+export const useAccessToken = (): IUseAccessToken => {
+ const { web3Auth, accessToken, setAccessTokenState } = useWeb3AuthInner();
const [loading, setLoading] = useState(false);
const [error, setError] = useState(null);
- const [token, setToken] = useState(null);
const getAccessToken = useCallback(async () => {
setLoading(true);
setError(null);
try {
- const accessToken = await web3Auth.getAccessToken();
- setToken(accessToken);
- return accessToken;
+ const nextAccessToken = await web3Auth.getAccessToken();
+ setAccessTokenState(nextAccessToken);
+ return nextAccessToken;
} catch (error) {
setError(error as Web3authRNError);
+ return null;
} finally {
setLoading(false);
}
- return null;
- }, [web3Auth]);
+ }, [web3Auth, setAccessTokenState]);
- useEffect(() => {
- if (!isConnected && token) {
- setToken(null);
- }
- }, [isConnected, token]);
-
- return { loading, error, token, getAccessToken };
+ return { loading, error, accessToken, token: accessToken, getAccessToken };
};
diff --git a/src/react/hooks/useAuthTokenInfo.ts b/src/react/hooks/useAuthTokenInfo.ts
new file mode 100644
index 0000000..ee128c1
--- /dev/null
+++ b/src/react/hooks/useAuthTokenInfo.ts
@@ -0,0 +1,45 @@
+import { useCallback, useEffect, useState } from "react";
+
+import { Web3authRNError } from "../../errors";
+import { useWeb3AuthInner } from "./useWeb3AuthInner";
+
+export interface IUseAuthTokenInfo {
+ loading: boolean;
+ error: Web3authRNError | null;
+ token: string | null;
+ getAuthTokenInfo: () => Promise;
+}
+
+export const useAuthTokenInfo = (): IUseAuthTokenInfo => {
+ const { web3Auth, isAuthorized } = useWeb3AuthInner();
+
+ const [loading, setLoading] = useState(false);
+ const [error, setError] = useState(null);
+ const [token, setToken] = useState(null);
+
+ const getAuthTokenInfo = useCallback(async () => {
+ setLoading(true);
+ setError(null);
+ try {
+ const authTokenInfo = await web3Auth.getAuthTokenInfo();
+ if (authTokenInfo?.idToken) {
+ setToken(authTokenInfo.idToken);
+ }
+ return authTokenInfo?.idToken ?? null;
+ } catch (error) {
+ setError(error as Web3authRNError);
+ return null;
+ } finally {
+ setLoading(false);
+ }
+ }, [web3Auth]);
+
+ useEffect(() => {
+ if (!web3Auth) return;
+ if (!isAuthorized && token) {
+ setToken(null);
+ }
+ }, [isAuthorized, token, web3Auth]);
+
+ return { loading, error, token, getAuthTokenInfo };
+};
diff --git a/src/react/hooks/useEnableMFA.ts b/src/react/hooks/useEnableMFA.ts
index da66ba7..f1e7a6b 100644
--- a/src/react/hooks/useEnableMFA.ts
+++ b/src/react/hooks/useEnableMFA.ts
@@ -10,7 +10,7 @@ export interface IUseEnableMFA {
}
export const useEnableMFA = (): IUseEnableMFA => {
- const { web3Auth } = useWeb3AuthInner();
+ const { web3Auth, setIsMFAEnabled, syncSessionState } = useWeb3AuthInner();
const [loading, setLoading] = useState(false);
const [error, setError] = useState(null);
@@ -19,13 +19,18 @@ export const useEnableMFA = (): IUseEnableMFA => {
setLoading(true);
setError(null);
try {
- await web3Auth.enableMFA();
+ const enabled = await web3Auth.enableMFA();
+ if (enabled) {
+ setIsMFAEnabled(true);
+ }
+ // Refresh rotated citadel tokens / MFA flags into the provider snapshot.
+ await syncSessionState();
} catch (error) {
setError(error as Web3authRNError);
} finally {
setLoading(false);
}
- }, [web3Auth]);
+ }, [web3Auth, setIsMFAEnabled, syncSessionState]);
return { loading, error, enableMFA };
};
diff --git a/src/react/hooks/useIdentityToken.ts b/src/react/hooks/useIdentityToken.ts
index 27dd5b7..d80a8a4 100644
--- a/src/react/hooks/useIdentityToken.ts
+++ b/src/react/hooks/useIdentityToken.ts
@@ -1,43 +1,22 @@
-import { useCallback, useEffect, useState } from "react";
-
-import { Web3authRNError } from "../../errors";
-import { useWeb3AuthInner } from "./useWeb3AuthInner";
+import { IUseAuthTokenInfo, useAuthTokenInfo } from "./useAuthTokenInfo";
export interface IUseIdentityToken {
loading: boolean;
- error: Web3authRNError | null;
+ error: IUseAuthTokenInfo["error"];
token: string | null;
getIdentityToken: () => Promise;
}
-export const useIdentityToken = () => {
- const { web3Auth, isConnected } = useWeb3AuthInner();
-
- const [loading, setLoading] = useState(false);
- const [error, setError] = useState(null);
- const [token, setToken] = useState(null);
-
- const getIdentityToken = useCallback(async () => {
- setLoading(true);
- setError(null);
- try {
- const idToken = await web3Auth.getIdentityToken();
- if (idToken) {
- setToken(idToken);
- }
- return idToken;
- } catch (error) {
- setError(error as Web3authRNError);
- } finally {
- setLoading(false);
- }
- }, [web3Auth]);
-
- useEffect(() => {
- if (!isConnected && token) {
- setToken(null);
- }
- }, [isConnected, token]);
+/**
+ * @deprecated Use {@link useAuthTokenInfo} instead.
+ */
+export const useIdentityToken = (): IUseIdentityToken => {
+ const { loading, error, token, getAuthTokenInfo } = useAuthTokenInfo();
- return { loading, error, token, getIdentityToken };
+ return {
+ loading,
+ error,
+ token,
+ getIdentityToken: getAuthTokenInfo,
+ };
};
diff --git a/src/react/hooks/useManageMFA.ts b/src/react/hooks/useManageMFA.ts
index 7a86511..395ec0e 100644
--- a/src/react/hooks/useManageMFA.ts
+++ b/src/react/hooks/useManageMFA.ts
@@ -10,7 +10,7 @@ export interface IUseManageMFA {
}
export const useManageMFA = (): IUseManageMFA => {
- const { web3Auth } = useWeb3AuthInner();
+ const { web3Auth, syncSessionState } = useWeb3AuthInner();
const [loading, setLoading] = useState(false);
const [error, setError] = useState(null);
@@ -20,12 +20,14 @@ export const useManageMFA = (): IUseManageMFA => {
setError(null);
try {
await web3Auth.manageMFA();
+ // Redirect may rotate citadel tokens; resync MFA + authorization snapshot.
+ await syncSessionState();
} catch (error) {
setError(error as Web3authRNError);
} finally {
setLoading(false);
}
- }, [web3Auth]);
+ }, [web3Auth, syncSessionState]);
return { loading, error, manageMFA };
};
diff --git a/src/react/hooks/useRefreshSession.ts b/src/react/hooks/useRefreshSession.ts
new file mode 100644
index 0000000..6235080
--- /dev/null
+++ b/src/react/hooks/useRefreshSession.ts
@@ -0,0 +1,35 @@
+import { useCallback, useState } from "react";
+
+import { Web3authRNError } from "../../errors";
+import { useWeb3AuthInner } from "./useWeb3AuthInner";
+
+export interface IUseRefreshSession {
+ loading: boolean;
+ error: Web3authRNError | null;
+ refreshSession: () => Promise;
+}
+
+export const useRefreshSession = (): IUseRefreshSession => {
+ const { web3Auth, syncSessionState } = useWeb3AuthInner();
+
+ const [loading, setLoading] = useState(false);
+ const [error, setError] = useState(null);
+
+ const refreshSession = useCallback(async () => {
+ setLoading(true);
+ setError(null);
+ try {
+ await web3Auth.refreshSession();
+ await syncSessionState();
+ return true;
+ } catch (error) {
+ // Core clears local session + emits disconnected on refresh failure.
+ setError(error as Web3authRNError);
+ return false;
+ } finally {
+ setLoading(false);
+ }
+ }, [web3Auth, syncSessionState]);
+
+ return { loading, error, refreshSession };
+};
diff --git a/src/react/hooks/useWeb3Auth.ts b/src/react/hooks/useWeb3Auth.ts
index a6eee9f..6c0e61e 100644
--- a/src/react/hooks/useWeb3Auth.ts
+++ b/src/react/hooks/useWeb3Auth.ts
@@ -1,13 +1,15 @@
import { IWeb3AuthInnerContext } from "../interfaces";
import { useWeb3AuthInner } from "./useWeb3AuthInner";
-export type IUseWeb3Auth = Omit;
+export type IUseWeb3Auth = Omit;
export const useWeb3Auth = (): IUseWeb3Auth => {
- const { initError, isConnected, isInitialized, isInitializing, provider, web3Auth } = useWeb3AuthInner();
+ const { initError, isConnected, isAuthorized, accessToken, isInitialized, isInitializing, provider, web3Auth } = useWeb3AuthInner();
return {
initError,
isConnected,
+ isAuthorized,
+ accessToken,
isInitialized,
isInitializing,
provider,
diff --git a/src/react/hooks/useWeb3AuthConnect.ts b/src/react/hooks/useWeb3AuthConnect.ts
index 0ee2121..b2186f6 100644
--- a/src/react/hooks/useWeb3AuthConnect.ts
+++ b/src/react/hooks/useWeb3AuthConnect.ts
@@ -22,7 +22,11 @@ export const useWeb3AuthConnect = (): IUseWeb3AuthConnect => {
setLoading(true);
setError(null);
try {
- return await web3Auth.connectTo(params);
+ const loginParams: SdkLoginParams = {
+ ...params,
+ loginSource: params.loginSource ?? "web3auth-react-native",
+ };
+ return await web3Auth.connectTo(loginParams);
} catch (error) {
setError(error as Web3authRNError);
return null;
diff --git a/src/react/hooks/useWeb3AuthUser.ts b/src/react/hooks/useWeb3AuthUser.ts
index dfb583e..7f240a2 100644
--- a/src/react/hooks/useWeb3AuthUser.ts
+++ b/src/react/hooks/useWeb3AuthUser.ts
@@ -23,30 +23,27 @@ export const useWeb3AuthUser = (): IUseWeb3AuthUser => {
setLoading(true);
setError(null);
try {
- const userInfo = web3Auth.userInfo();
- setUserInfo(userInfo);
- return userInfo;
+ const nextUserInfo = web3Auth.userInfo();
+ setUserInfo(nextUserInfo);
+ setIsMFAEnabled(Boolean(nextUserInfo?.isMfaEnabled));
+ return nextUserInfo;
} catch (error) {
setError(error as Web3authRNError);
+ return null;
} finally {
setLoading(false);
}
- }, [web3Auth]);
+ }, [web3Auth, setIsMFAEnabled]);
useEffect(() => {
- const saveUserInfo = async () => {
- const userInfo = await getUserInfo();
- setUserInfo(userInfo);
- setIsMFAEnabled(userInfo?.isMfaEnabled || false);
- };
-
- if (isConnected && !userInfo) saveUserInfo();
+ if (isConnected && !userInfo) {
+ void getUserInfo();
+ }
if (!isConnected && userInfo) {
setUserInfo(null);
- setIsMFAEnabled(false);
}
- }, [isConnected, userInfo, getUserInfo, setIsMFAEnabled]);
+ }, [isConnected, userInfo, getUserInfo]);
return { loading, error, userInfo, isMFAEnabled, getUserInfo };
};
diff --git a/src/types/interface.ts b/src/types/interface.ts
index be2dc15..47ac1bf 100644
--- a/src/types/interface.ts
+++ b/src/types/interface.ts
@@ -34,6 +34,17 @@ type SdkSpecificInitParams = {
enableLogging?: boolean;
useCoreKitKey?: boolean;
walletSdkURL?: string;
+ /**
+ * Disable all Segment analytics (identify/track). Always takes precedence over
+ * {@link enableAnalyticsInDev}.
+ */
+ disableAnalytics?: boolean;
+ /**
+ * Send analytics in `__DEV__` builds using the development Segment write key.
+ * Ignored when {@link disableAnalytics} is true. Production/release builds
+ * already send analytics by default.
+ */
+ enableAnalyticsInDev?: boolean;
};
type SdkInitParamsBase = Omit &
@@ -43,6 +54,11 @@ type SdkInitParamsBase = Omit Promise;
userInfo: () => State["userInfo"];
getAccessToken: () => Promise;
+ getAuthTokenInfo: () => Promise;
+ /** @deprecated Use {@link getAuthTokenInfo} instead. */
getIdentityToken: () => Promise;
refreshSession: () => Promise;
enableMFA: () => Promise;
@@ -140,8 +162,9 @@ export interface WalletUiConfig {
enableSendButton?: boolean;
enableSwapButton?: boolean;
enableReceiveButton?: boolean;
+ enableDefiPositionsDisplay?: boolean;
portfolioWidgetPosition?: BUTTON_POSITION_TYPE;
- defaultPortfolio?: "token" | "nft";
+ defaultPortfolio?: "token" | "nft" | "defi";
}
export interface LoginModalConfig {
diff --git a/src/utils.ts b/src/utils.ts
index 54adcc3..0d991a6 100644
--- a/src/utils.ts
+++ b/src/utils.ts
@@ -1,11 +1,15 @@
+import { CHAIN_NAMESPACES } from "@toruslabs/base-controllers";
import { DASHBOARD_PUBLIC_API_MAP } from "@toruslabs/constants";
+import { type AccountAbstractionMultiChainConfig } from "@toruslabs/ethereum-controllers";
import { get } from "@toruslabs/http-helpers";
import { decodeBase64Url } from "@toruslabs/metadata-helpers";
-import { BUILD_ENV, type BUILD_ENV_TYPE, type WEB3AUTH_NETWORK_TYPE } from "@web3auth/auth";
+import { BUILD_ENV, type BUILD_ENV_TYPE, type WEB3AUTH_NETWORK_TYPE, type WhiteLabelData } from "@web3auth/auth";
+import { getCaipChainId } from "@web3auth/no-modal";
import log from "loglevel";
import { URL, URLSearchParams } from "react-native-url-polyfill";
-import { ProjectConfig } from "./types/interface";
+import { Web3authRNError } from "./errors";
+import { ProjectConfig, type SdkInitParams, type WalletServicesConfig } from "./types/interface";
export function constructURL(params: { baseURL: string; query?: Record; hash?: Record }): string {
const { baseURL, query, hash } = params;
@@ -95,13 +99,15 @@ export function generateRecordId(): string {
export const fetchProjectConfig = async (
clientId: string,
web3AuthNetwork: WEB3AUTH_NETWORK_TYPE,
- buildEnv?: BUILD_ENV_TYPE
+ buildEnv?: BUILD_ENV_TYPE,
+ aaProvider?: string
): Promise => {
try {
const url = new URL(`${DASHBOARD_PUBLIC_API_MAP[buildEnv ?? BUILD_ENV.PRODUCTION]}/api/v2/configuration`);
url.searchParams.append("project_id", clientId);
url.searchParams.append("network", web3AuthNetwork);
if (buildEnv) url.searchParams.append("build_env", buildEnv);
+ if (aaProvider) url.searchParams.append("aa_provider", aaProvider);
const res = await get(url.href);
return res;
} catch (e) {
@@ -120,3 +126,108 @@ export const fetchProjectConfig = async (
throw new Error(`Failed to fetch project config: ${(e as Error).message}`);
}
};
+
+export const getHostname = (url?: string): string => {
+ if (!url) return "";
+ try {
+ return new URL(url).hostname;
+ } catch {
+ return "";
+ }
+};
+
+export const getWhitelabelAnalyticsProperties = (uiConfig?: WhiteLabelData) => {
+ return {
+ whitelabel_app_name: uiConfig?.appName,
+ whitelabel_app_url: uiConfig?.appUrl,
+ whitelabel_logo_light_enabled: Boolean(uiConfig?.logoLight),
+ whitelabel_logo_dark_enabled: Boolean(uiConfig?.logoDark),
+ whitelabel_default_language: uiConfig?.defaultLanguage,
+ whitelabel_theme_mode: uiConfig?.mode,
+ whitelabel_use_logo_loader: uiConfig?.useLogoLoader,
+ whitelabel_theme_primary: uiConfig?.theme?.primary,
+ whitelabel_theme_on_primary: uiConfig?.theme?.onPrimary,
+ whitelabel_tnc_link_enabled: Boolean(uiConfig?.tncLink),
+ whitelabel_privacy_policy_enabled: Boolean(uiConfig?.privacyPolicy),
+ };
+};
+
+export const getAaAnalyticsProperties = (accountAbstractionConfig?: AccountAbstractionMultiChainConfig | null) => {
+ const bundlerHostnames = Array.from(
+ new Set(accountAbstractionConfig?.chains?.map((chain) => getHostname(chain.bundlerConfig?.url)).filter(Boolean))
+ );
+ const paymasterHostnames = Array.from(
+ new Set(accountAbstractionConfig?.chains?.map((chain) => getHostname(chain.paymasterConfig?.url)).filter(Boolean))
+ );
+ return {
+ aa_smart_account_type: accountAbstractionConfig?.smartAccountType,
+ aa_chain_ids: accountAbstractionConfig?.chains?.map((chain) =>
+ getCaipChainId({ chainId: chain.chainId, chainNamespace: CHAIN_NAMESPACES.EIP155 })
+ ),
+ aa_bundler_urls: bundlerHostnames,
+ aa_paymaster_urls: paymasterHostnames,
+ aa_paymaster_enabled: paymasterHostnames.length > 0,
+ aa_paymaster_context_enabled: accountAbstractionConfig?.chains?.some((chain) => chain.bundlerConfig?.paymasterContext),
+ aa_erc20_paymaster_enabled: accountAbstractionConfig?.chains?.some(
+ (chain) => (chain.bundlerConfig?.paymasterContext as { token?: string } | undefined)?.token
+ ),
+ };
+};
+
+export const getWalletServicesAnalyticsProperties = (walletServicesConfig?: WalletServicesConfig) => {
+ return {
+ ws_confirmation_strategy: walletServicesConfig?.confirmationStrategy,
+ ws_enable_key_export: walletServicesConfig?.enableKeyExport,
+ ws_show_widget_button: walletServicesConfig?.whiteLabel?.showWidgetButton,
+ ws_button_position: walletServicesConfig?.whiteLabel?.buttonPosition,
+ ws_hide_nft_display: walletServicesConfig?.whiteLabel?.hideNftDisplay,
+ ws_hide_token_display: walletServicesConfig?.whiteLabel?.hideTokenDisplay,
+ ws_hide_transfers: walletServicesConfig?.whiteLabel?.hideTransfers,
+ ws_hide_topup: walletServicesConfig?.whiteLabel?.hideTopup,
+ ws_hide_receive: walletServicesConfig?.whiteLabel?.hideReceive,
+ ws_hide_swap: walletServicesConfig?.whiteLabel?.hideSwap,
+ ws_hide_show_all_tokens: walletServicesConfig?.whiteLabel?.hideShowAllTokens,
+ ws_hide_wallet_connect: walletServicesConfig?.whiteLabel?.hideWalletConnect,
+ ws_hide_defi_positions_display: walletServicesConfig?.whiteLabel?.hideDefiPositionsDisplay,
+ ws_default_portfolio: walletServicesConfig?.whiteLabel?.defaultPortfolio,
+ };
+};
+
+export const getErrorAnalyticsProperties = (error: unknown): { error_message?: string; error_code?: number } => {
+ try {
+ const code = error instanceof Web3authRNError ? error.code : (error as { code?: number } | null)?.code;
+ const message =
+ error instanceof Error
+ ? error.message
+ : (error as { message?: string } | null)?.message || (error as { toString?: () => string } | null)?.toString?.() || String(error);
+ return { error_message: message, error_code: code };
+ } catch {
+ return { error_message: "Unknown error", error_code: undefined };
+ }
+};
+
+export const getInitializationTrackData = (options: SdkInitParams): Record => {
+ try {
+ const defaultChain = options.chains?.find((chain) => chain.chainId === options.defaultChainId);
+ const rpcHostnames = Array.from(new Set(options.chains?.map((chain) => getHostname(chain.rpcTarget)).filter(Boolean)));
+ return {
+ chain_ids: options.chains?.map((chain) => getCaipChainId(chain)),
+ chain_names: options.chains?.map((chain) => chain.displayName),
+ chain_rpc_targets: rpcHostnames,
+ default_chain_id: defaultChain ? getCaipChainId(defaultChain) : undefined,
+ default_chain_name: defaultChain?.displayName,
+ logging_enabled: options.enableLogging,
+ session_time: options.sessionTime,
+ sfa_key_enabled: options.useCoreKitKey,
+ auth_build_env: options.buildEnv,
+ auth_mfa_settings: Object.keys(options.mfaSettings || {}),
+ aa_enabled_for_external_wallets: options.accountAbstractionConfig ? options.useAAWithExternalWallet : undefined,
+ ...getWhitelabelAnalyticsProperties(options.whiteLabel),
+ ...getAaAnalyticsProperties(options.accountAbstractionConfig),
+ ...getWalletServicesAnalyticsProperties(options.walletServicesConfig),
+ };
+ } catch (error) {
+ log.error("Failed to get initialization track data", error);
+ return {};
+ }
+};