@dynamic-labs-sdk/client 1.12.2 → 1.14.0

package/dist/{InvalidParamError-B0nAZ6Ei.esm.js → InvalidParamError-DZjc7Tjc.esm.js}

@@ -2,7 +2,7 @@ import { AuthStorageEnum, Configuration, JwtVerifiedCredentialFormatEnum, SDKApi
 
 //#region package.json
 var name = "@dynamic-labs-sdk/client";
-var version = "1.12.2";
+var version = "1.14.0";
 var dependencies = {
 	"@dynamic-labs-sdk/assert-package-version": "workspace:*",
 	"@dynamic-labs-wallet/browser-wallet-client": "1.0.39",
@@ -17,7 +17,7 @@ var dependencies = {
 
 //#endregion
 //#region src/client/core/getCore/getCore.ts
-/** @not-instrumented */
+/** @notInstrumented */
 const getCore = (client) => {
 	return client.__core;
 };
@@ -108,14 +108,14 @@ let numOfInitializedClients = 0;
 *
 * If more than one instance of DynamicClient was initialized, you should not use this function.
 * Instead, you should pass the client instance you stored to the function that needs it.
-* @not-instrumented
+* @notInstrumented
 */
 const getDefaultClient = () => {
 	if (!defaultClient) throw new ClientNotFoundError();
 	if (numOfInitializedClients > 1) getCore(defaultClient).logger.debug("Multiple instances of DynamicClient found. If you are only using one client (recommended), make sure you are not calling \"createDynamicClient\" multiple times. If you are using multiple clients, make sure you are passing which client to use as the last param of all Dynamic functions.");
 	return defaultClient;
 };
-/** @not-instrumented */
+/** @notInstrumented */
 const setDefaultClient = (client) => {
 	defaultClient = client;
 	numOfInitializedClients++;
@@ -141,7 +141,7 @@ const CLIENT_SDK_NAME = "ClientSDK";
 //#endregion
 //#region src/utils/randomString/randomString.ts
 const DEFAULT_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-/** @not-instrumented */
+/** @notInstrumented */
 const randomString = ({ chars = DEFAULT_CHARS, length }) => {
 	const bytes = new Uint8Array(length);
 	crypto.getRandomValues(bytes);
@@ -151,679 +151,226 @@ const randomString = ({ chars = DEFAULT_CHARS, length }) => {
 };
 
 //#endregion
-//#region src/modules/auth/extractSessionId/extractSessionId.ts
+//#region src/modules/auth/getElevatedAccessToken/getElevatedAccessToken.ts
 /**
-* Extracts the session ID (`sid` claim) from a JWT token string.
+* Gets an elevated access token by scope.
 *
-* Decodes the base64url-encoded payload segment of the token and reads the
-* `sid` field. This is used to correlate instrumentation events with the
-* authenticated session, without ever forwarding the full token.
+* This function retrieves an elevated access token that contains the specified scope.
+* Expired tokens are automatically filtered out.
 *
-* Returns `null` when no token is present, when the token is malformed, or
-* when the payload does not contain a `sid` claim.
-* @not-instrumented
+* By default, if the token has `singleUse: true`, it will be automatically
+* consumed (removed from state) after retrieval. Pass `consume: false` to
+* check for token existence without consuming it.
+*
+* @param params - The parameters object.
+* @param params.scope - The scope to match (e.g., 'wallet:export').
+* @param params.consume - Whether to consume single-use tokens (default: true).
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The elevated access token if found and not expired, or undefined if not found or expired.
+*
+* @example
+* ```typescript
+* // Retrieve and consume (default)
+* const token = getElevatedAccessToken({ scope: 'wallet:export' });
+*
+* // Check existence without consuming
+* const token = getElevatedAccessToken({ scope: 'credential:unlink', consume: false });
+* ```
+* @notInstrumented
 */
-const extractSessionId = (token) => {
-	try {
-		const payload = token.split(".")[1];
-		return JSON.parse(atob(payload)).sid ?? null;
-	} catch {
-		return null;
+const getElevatedAccessToken = ({ consume = true, scope }, client = getDefaultClient()) => {
+	const core = getCore(client);
+	const now = /* @__PURE__ */ new Date();
+	const elevatedAccessTokens = core.state.get().elevatedAccessTokens || [];
+	const validTokens = elevatedAccessTokens.filter((token$1) => !token$1.expiresAt || token$1.expiresAt > now);
+	if (validTokens.length !== elevatedAccessTokens.length) core.state.set({ elevatedAccessTokens: validTokens });
+	const token = validTokens.find((token$1) => token$1.scopes.includes(scope));
+	if (!token) return;
+	if (consume && token.singleUse) {
+		const updatedTokens = validTokens.filter((t) => t !== token);
+		core.state.set({ elevatedAccessTokens: updatedTokens });
 	}
+	return token.token;
 };
 
 //#endregion
-//#region src/utils/getOperatingSystem/getOperatingSystem.ts
-/**
-* Detects the operating system from `navigator.userAgent` for web environments.
-*
-* The React Native bundler (Metro) resolves `getOperatingSystem.native.ts`
-* instead when building for React Native, which uses `Platform.OS` directly.
-*
-* Falls back to `'unknown'` when `navigator` is unavailable (SSR, service
-* workers) or when the user-agent string doesn't match a known OS pattern.
-* @not-instrumented
-*/
-const getOperatingSystem = () => {
-	try {
-		const ua = navigator.userAgent;
-		if (/iPhone|iPad|iPod/.test(ua)) return "ios";
-		if (/Android/.test(ua)) return "android";
-		if (/Windows/.test(ua)) return "windows";
-		if (/Macintosh|Mac OS X/.test(ua)) return "macos";
-		if (/Linux/.test(ua)) return "linux";
-		return "unknown";
-	} catch {
-		return "unknown";
+//#region src/errors/ValueMustBeDefinedError.ts
+var ValueMustBeDefinedError = class extends BaseError {
+	constructor(message) {
+		super({
+			cause: null,
+			code: "value_must_be_defined_error",
+			docsUrl: null,
+			name: "ValueMustBeDefined",
+			shortMessage: message
+		});
 	}
 };
 
 //#endregion
-//#region src/utils/getPlatform/getPlatform.ts
+//#region src/utils/assertDefined/assertDefined.ts
 /**
-* Returns the platform the SDK is running on.
+* Asserts that a value is not null or undefined, throwing an error if it is.
+* This function acts as a type guard, narrowing the type to exclude null and undefined.
 *
-* This is the web implementation — the React Native bundler resolves
-* `getPlatform.native.ts` instead when building for React Native, which
-* returns `'react-native'`.
-* @not-instrumented
+* @template T - The type of the value being checked
+* @param value - The value to check for null or undefined
+* @param message - The error message to throw if the value is null or undefined
+* @throws Throws an error with the provided message if value is null or undefined
+* @example
+* ```typescript
+* const maybeString: string | null = getValue();
+* assertDefined(maybeString, 'String value is required');
+* // maybeString is now typed as string (null is excluded)
+* ```
 */
-const getPlatform = () => "web";
+function assertDefined(value, message) {
+	if (value === null || value === void 0) throw new ValueMustBeDefinedError(message);
+}
 
 //#endregion
-//#region src/utils/getUserAgent/getUserAgent.ts
+//#region src/modules/projectSettings/isCookieEnabled/isCookieEnabled.ts
 /**
-* Returns the browser's `navigator.userAgent` string for inclusion in
-* instrumentation events.
-*
-* Falls back to an empty string in environments where `navigator` is not
-* available (e.g., Node.js SSR, service workers) so that callers never need
-* to guard against undefined.
-* @not-instrumented
+* Returns true if the client is using Dynamic cookies or a BYO JWT cookie.
+* @notInstrumented
 */
-const getUserAgent = () => {
-	try {
-		return navigator.userAgent;
-	} catch {
-		return "";
+const isCookieEnabled = (client) => {
+	assertDefined(client.projectSettings, "Project settings are not defined");
+	const securitySettings = client.projectSettings.security;
+	if (!securitySettings) return false;
+	const dynamicCookiesEnabled = (securitySettings.auth?.storage || []).includes(AuthStorageEnum.Cookie);
+	const byoJwtCookieEnabled = Boolean(securitySettings.externalAuth?.cookieName);
+	return dynamicCookiesEnabled || byoJwtCookieEnabled;
+};
+
+//#endregion
+//#region src/modules/sessionKeys/getSessionKeys/getSessionKeys.ts
+/** @notInstrumented */
+const getSessionKeys = (client) => {
+	const publicKey = getCore(client).state.get().sessionKeys;
+	if (!publicKey) return;
+	return { publicKey };
+};
+
+//#endregion
+//#region src/errors/APIError/APIError.ts
+var APIError = class APIError extends BaseError {
+	status;
+	constructor(message, code, status) {
+		super({
+			cause: null,
+			code,
+			docsUrl: null,
+			name: "APIError",
+			shortMessage: message
+		});
+		this.status = status;
+	}
+	static async fromResponse(response) {
+		try {
+			const errorBody = await response.clone().json();
+			if (errorBody && "error" in errorBody && typeof errorBody.error === "string") {
+				const errorCode = "code" in errorBody && typeof errorBody.code === "string" ? errorBody.code : "unknown_error";
+				return new APIError(errorBody.error, errorCode, response.status);
+			}
+			return null;
+		} catch {
+			return null;
+		}
 	}
 };
 
 //#endregion
-//#region src/services/instrumentation/constants.ts
+//#region src/errors/InvalidExternalAuthError.ts
+var InvalidExternalAuthError = class extends BaseError {
+	constructor({ cause }) {
+		super({
+			cause,
+			code: "invalid_external_auth_error",
+			docsUrl: "https://www.dynamic.xyz/docs/external-auth/third-party-auth-overview",
+			name: "InvalidExternalAuthError",
+			shortMessage: "Error authenticating with external JWT"
+		});
+	}
+};
+
+//#endregion
+//#region src/errors/LinkCredentialError.ts
+var LinkCredentialError = class extends BaseError {
+	constructor({ cause }) {
+		super({
+			cause,
+			code: "link_credential_error",
+			docsUrl: null,
+			name: "LinkCredentialError",
+			shortMessage: "The credential you are trying to link is associated with another account and cannot be reassigned."
+		});
+	}
+};
+
+//#endregion
+//#region src/errors/MfaInvalidOtpError.ts
+var MfaInvalidOtpError = class extends BaseError {
+	constructor({ cause }) {
+		super({
+			cause,
+			code: "mfa_invalid_otp_error",
+			docsUrl: null,
+			name: "MfaInvalidOtpError",
+			shortMessage: "Invalid OTP"
+		});
+	}
+};
+
+//#endregion
+//#region src/errors/MfaRateLimitedError.ts
+var MfaRateLimitedError = class extends BaseError {
+	constructor({ cause }) {
+		super({
+			cause,
+			code: "mfa_rate_limited_error",
+			docsUrl: null,
+			name: "MfaRateLimitedError",
+			shortMessage: "Rate limited"
+		});
+	}
+};
+
+//#endregion
+//#region src/errors/SandboxMaximumThresholdReachedError.ts
+var SandboxMaximumThresholdReachedError = class extends BaseError {
+	constructor({ cause }) {
+		super({
+			cause,
+			code: "sandbox_maximum_threshold_reached_error",
+			docsUrl: "https://www.dynamic.xyz/docs/developer-dashboard/sandbox-vs-live#sandbox-vs-live",
+			name: "SandboxMaximumThresholdReachedError",
+			shortMessage: "Your sandbox environment has reached the maximum MAU. Please use a live environment for production traffic."
+		});
+	}
+};
+
+//#endregion
+//#region src/modules/apiClient/utils/clientErrorMapper/clientErrorMapper.ts
 /**
-* Default key-based PII scrubber list, lowercased and matched against the
-* lowercased object key.
+* Default error mapper for the client that handles common API error codes.
 *
-* Two complementary mechanisms cover credential leakage:
+* This mapper transforms specific API error codes into more specific error types:
+* - `mfa_invalid_code` → `MfaInvalidOtpError`
+* - `mfa_rate_limited` → `MfaRateLimitedError`
 *
-* 1. Explicit keys listed here — matched exactly (case-insensitive). Use this
-*    for keys that don't end in a generic credential suffix (e.g. `mnemonic`,
-*    `seed`, `verificationCode`, `keyShare`).
-* 2. Suffix matching in {@link scrubParameters} for the credential suffixes
-*    enumerated by {@link PII_KEY_SUFFIXES} — catches any field whose name
-*    ends in `token` or `jwt` (e.g. `mfaToken`, `minifiedJwt`, `accessToken`,
-*    `idToken`, `captchaToken`, …) without needing to enumerate them here.
-*/
-const DEFAULT_PII_FIELDS = [
-	"password",
-	"token",
-	"secret",
-	"privateKey",
-	"privateJwk",
-	"mnemonic",
-	"seed",
-	"keyShare",
-	"keyShares",
-	"email",
-	"phone",
-	"ssn",
-	"address",
-	"authorization",
-	"verificationCode",
-	"recoveryCodes",
-	"codeVerifier",
-	"pkce",
-	"bearer",
-	"apiKey"
-];
-/**
-* Lowercased suffixes used by {@link scrubParameters} to match credential-like
-* keys without enumerating every variant (e.g. `mfaToken`, `accessToken`,
-* `refreshToken`, `legacyToken`, `minifiedJwt`). Only suffixes that are
-* unambiguously credentials belong here — `key` (matches `publicKey`) and
-* `code` (matches `countryCode`) are too broad and must not be added.
-*/
-const PII_KEY_SUFFIXES = ["token", "jwt"];
-const REDACTED_VALUE = "[REDACTED]";
-const MAX_STRING_LENGTH = 500;
-const TRUNCATED_SUFFIX = "...[truncated]";
-/**
-* Label prefix for binary data placeholders. The full placeholder includes the
-* byte length, e.g. `[Binary:16 bytes]`, so consumers can gauge data size
-* without the actual bytes appearing in logs.
-*/
-const BINARY_LABEL = "Binary";
-/**
-* Placeholder emitted when a circular reference is detected in the value tree.
-* Using a named constant makes it easy to search for or filter in downstream
-* log tooling.
-*/
-const CIRCULAR_VALUE = "[Circular]";
-
-//#endregion
-//#region src/services/instrumentation/scrubParameters/scrubParameters.ts
-/**
-* Returns true when `key` should be redacted based on the configured PII
-* field list. A key matches when its lowercased form either equals one of
-* `piiFieldsLower` exactly, or ends in one of the curated credential
-* suffixes in {@link PII_KEY_SUFFIXES} (currently `token` and `jwt`). The
-* suffix check is what catches `mfaToken`, `minifiedJwt`, `accessToken`,
-* etc. without needing every variant enumerated explicitly.
-*/
-const keyMatchesPiiField = ({ keyLower, piiFieldsLower }) => {
-	if (piiFieldsLower.includes(keyLower)) return true;
-	return PII_KEY_SUFFIXES.some((suffix) => keyLower.endsWith(suffix));
-};
-const scrubString = ({ key, piiFieldsLower, redactAll, value }) => {
-	if (keyMatchesPiiField({
-		keyLower: key.toLowerCase(),
-		piiFieldsLower
-	})) return REDACTED_VALUE;
-	if (redactAll) return REDACTED_VALUE;
-	if (value.length > MAX_STRING_LENGTH) return value.slice(0, MAX_STRING_LENGTH) + TRUNCATED_SUFFIX;
-	return value;
-};
-const scrubArray = ({ context, value }) => {
-	if (context.visited.has(value)) return [CIRCULAR_VALUE];
-	context.visited.add(value);
-	const result = value.map((item, index) => scrubValue({
-		context,
-		key: String(index),
-		value: item
-	}));
-	context.visited.delete(value);
-	return result;
-};
-const scrubObject = ({ context, value }) => {
-	if (context.visited.has(value)) return { [CIRCULAR_VALUE]: true };
-	context.visited.add(value);
-	const result = Object.create(null);
-	for (const key of Object.keys(value)) result[key] = scrubValue({
-		context,
-		key,
-		value: value[key]
-	});
-	context.visited.delete(value);
-	return result;
-};
-const scrubValue = ({ context, key, value }) => {
-	if (value === null || value === void 0) return value;
-	if (value instanceof Uint8Array) return `[${BINARY_LABEL}:${value.byteLength} bytes]`;
-	if (keyMatchesPiiField({
-		keyLower: key.toLowerCase(),
-		piiFieldsLower: context.piiFieldsLower
-	})) return REDACTED_VALUE;
-	if (typeof value === "string") return scrubString({
-		key,
-		piiFieldsLower: context.piiFieldsLower,
-		redactAll: context.redactAll,
-		value
-	});
-	if (Array.isArray(value)) return scrubArray({
-		context,
-		value
-	});
-	if (value instanceof Set) {
-		if (context.visited.has(value)) return [CIRCULAR_VALUE];
-		context.visited.add(value);
-		const setResult = scrubArray({
-			context,
-			value: [...value]
-		});
-		context.visited.delete(value);
-		return setResult;
-	}
-	if (value instanceof Map) {
-		if (context.visited.has(value)) return { [CIRCULAR_VALUE]: true };
-		context.visited.add(value);
-		const asObject = Object.create(null);
-		for (const [k, v] of value.entries()) asObject[String(k)] = v;
-		const mapResult = scrubObject({
-			context,
-			value: asObject
-		});
-		context.visited.delete(value);
-		return mapResult;
-	}
-	if (value instanceof WeakMap) return "[WeakMap]";
-	if (value instanceof WeakSet) return "[WeakSet]";
-	if (value instanceof Date) return value.toISOString();
-	if (value instanceof Error) return `[Error: ${value.message}]`;
-	if (typeof value === "object") return scrubObject({
-		context,
-		value
-	});
-	return value;
-};
-/** @not-instrumented */
-const scrubParameters = ({ piiFields, redactAll, value }) => {
-	return scrubObject({
-		context: {
-			piiFieldsLower: piiFields.map((field) => field.toLowerCase()),
-			redactAll,
-			visited: /* @__PURE__ */ new WeakSet()
-		},
-		value
-	});
-};
-
-//#endregion
-//#region src/services/instrumentation/instrumentFunction/extractParams/extractParams.ts
-/**
-* Normalises the raw positional arguments of an instrumented function call
-* into a flat `Record<string, unknown>` suitable for structured logging.
-*
-* ## Why this is needed
-*
-* Instrumented functions are wrapped with `(...args: unknown[])`, so their
-* parameters arrive as an array. Logging a raw array loses the semantic names
-* of each argument. This function recovers a named representation:
-*
-* - **No arguments** → `{}`
-* - **Single plain-object argument** → that object is returned as-is, because
-*   SDK functions follow the single-object-parameter convention, so the object
-*   already carries named keys (`{ amount, to }`, etc.).
-* - **Everything else** (multiple args, a single primitive, a single array) →
-*   each value is indexed as `arg0`, `arg1`, …
-*
-* ## Why arrays are NOT treated as plain objects
-*
-* `typeof [] === 'object'` and `[] !== null`, so without the `Array.isArray`
-* guard a single-array argument would be returned as-is. That would produce
-* an object with numeric string keys (`{ '0': ..., '1': ... }`), which is
-* misleading and inconsistent with how multi-arg calls are handled. Instead,
-* arrays fall through to the indexed `arg0` path.
-* @not-instrumented
-*/
-const extractParams = (args) => {
-	if (args.length === 0) return {};
-	if (args.length === 1 && typeof args[0] === "object" && args[0] !== null && !Array.isArray(args[0])) return args[0];
-	const result = {};
-	for (let i = 0; i < args.length; i++) result[`arg${i}`] = args[i];
-	return result;
-};
-
-//#endregion
-//#region src/services/instrumentation/instrumentFunction/scrubResolvedValue/scrubResolvedValue.ts
-/**
-* Scrubs a resolved return value of any type before logging it.
-* Routes through `scrubParameters` by wrapping the value so that strings,
-* arrays, Dates, Errors, and all other types are handled identically to
-* nested object fields.
-* @not-instrumented
-*/
-const scrubResolvedValue = ({ piiFields, redactAll, value }) => scrubParameters({
-	piiFields,
-	redactAll,
-	value: { result: value }
-}).result;
-
-//#endregion
-//#region src/services/instrumentation/instrumentFunction/instrumentFunction.ts
-const serializeError = (error) => {
-	if (error instanceof Error) return {
-		message: error.message,
-		name: error.name,
-		stack: error.stack
-	};
-	return {
-		message: String(error),
-		name: "UnknownError"
-	};
-};
-/**
-* Wraps a function so that each invocation emits a structured
-* `FunctionInstrumentationEvent` at three lifecycle points:
-*
-* - **started** — immediately before the function body executes, with the
-*   PII-scrubbed call parameters.
-* - **resolved** — after the function (or its returned Promise) settles
-*   successfully, with the PII-scrubbed return value.
-* - **rejected** — if the function throws synchronously or its returned
-*   Promise rejects.
-*
-* The original return value (or thrown error) is always forwarded to the
-* caller unchanged — instrumentation is purely observational.
-*
-* ## Usage
-*
-* ```ts
-* const transfer = instrumentFunction({
-*   fn: rawTransfer,
-*   functionName: 'transfer',
-*   getCore: () => core,
-* });
-*
-* // When called, three events are emitted automatically:
-* await transfer({ amount: 1, to: '0xabc' });
-* ```
-*
-* ## How functions are wrapped
-*
-* `instrumentFunction` is not called manually in application code. Instead,
-* the esbuild instrumentation plugin (`tools/instrumentation-plugin`) injects
-* it at build time: any exported function annotated with `@instrumented` in its
-* JSDoc is automatically wrapped by the plugin during the build step.
-* The plugin strips the original `export`, renames the function, and re-exports
-* it under the original name via `instrumentFunction(...)` — so the public API
-* is unchanged and no call sites need to be updated.
-*
-* ## Opting out
-*
-* Instrumentation is skipped entirely when:
-* - `getCore()` returns `undefined` (SDK not initialised), or
-* - `core.instrumentation.config.enabled` is `false`.
-*
-* In both cases the original function is called directly with no overhead.
-*
-* ## PII scrubbing
-*
-* All string values whose key appears in `piiFields` are replaced with
-* `"[redacted]"` before events are emitted. Pass `redactAll: true` to redact
-* every field, regardless of key name.
-* @not-instrumented
-*/
-const instrumentFunction = ({ fn, functionName, getCore: getCore$1, redactAll }) => {
-	const wrapped = (...args) => {
-		const core = getCore$1();
-		if (!core) return fn(...args);
-		if (!core.instrumentation.config.enabled) return fn(...args);
-		const instrumentation = core.instrumentation;
-		const state = core.state.get();
-		const baseEvent = {
-			environmentId: core.environmentId,
-			functionName,
-			operatingSystem: getOperatingSystem(),
-			parameters: scrubParameters({
-				piiFields: instrumentation.config.piiFields,
-				redactAll,
-				value: extractParams(args)
-			}),
-			platform: getPlatform(),
-			registeredExtensionKeys: Array.from(core.extensions),
-			sdkSessionId: core.sdkSessionId,
-			sdkVersion: core.version,
-			status: "info",
-			tokenSessionId: state.token ? extractSessionId(state.token) : null,
-			userAgent: getUserAgent(),
-			userId: state.user?.id ?? null
-		};
-		instrumentation.logFunction({
-			...baseEvent,
-			phase: "started",
-			timestamp: (/* @__PURE__ */ new Date()).toISOString()
-		});
-		try {
-			const result = fn(...args);
-			if (result instanceof Promise) return result.then((value) => {
-				instrumentation.logFunction({
-					...baseEvent,
-					phase: "resolved",
-					resolvedValue: scrubResolvedValue({
-						piiFields: instrumentation.config.piiFields,
-						redactAll,
-						value
-					}),
-					timestamp: (/* @__PURE__ */ new Date()).toISOString()
-				});
-				return value;
-			}).catch((error) => {
-				instrumentation.logFunction({
-					...baseEvent,
-					phase: "rejected",
-					rejectedError: serializeError(error),
-					timestamp: (/* @__PURE__ */ new Date()).toISOString()
-				});
-				throw error;
-			});
-			instrumentation.logFunction({
-				...baseEvent,
-				phase: "resolved",
-				resolvedValue: scrubResolvedValue({
-					piiFields: instrumentation.config.piiFields,
-					redactAll,
-					value: result
-				}),
-				timestamp: (/* @__PURE__ */ new Date()).toISOString()
-			});
-			return result;
-		} catch (error) {
-			instrumentation.logFunction({
-				...baseEvent,
-				phase: "rejected",
-				rejectedError: serializeError(error),
-				timestamp: (/* @__PURE__ */ new Date()).toISOString()
-			});
-			throw error;
-		}
-	};
-	return wrapped;
-};
-
-//#endregion
-//#region src/modules/auth/getElevatedAccessToken/getElevatedAccessToken.ts
-/**
-* Gets an elevated access token by scope.
-*
-* This function retrieves an elevated access token that contains the specified scope.
-* Expired tokens are automatically filtered out.
-*
-* By default, if the token has `singleUse: true`, it will be automatically
-* consumed (removed from state) after retrieval. Pass `consume: false` to
-* check for token existence without consuming it.
-*
-* @param params - The parameters object.
-* @param params.scope - The scope to match (e.g., 'wallet:export').
-* @param params.consume - Whether to consume single-use tokens (default: true).
-* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns The elevated access token if found and not expired, or undefined if not found or expired.
-*
-* @example
-* ```typescript
-* // Retrieve and consume (default)
-* const token = getElevatedAccessToken({ scope: 'wallet:export' });
-*
-* // Check existence without consuming
-* const token = getElevatedAccessToken({ scope: 'credential:unlink', consume: false });
-* ```
-* @not-instrumented
-*/
-const getElevatedAccessToken = ({ consume = true, scope }, client = getDefaultClient()) => {
-	const core = getCore(client);
-	const now = /* @__PURE__ */ new Date();
-	const elevatedAccessTokens = core.state.get().elevatedAccessTokens || [];
-	const validTokens = elevatedAccessTokens.filter((token$1) => !token$1.expiresAt || token$1.expiresAt > now);
-	if (validTokens.length !== elevatedAccessTokens.length) core.state.set({ elevatedAccessTokens: validTokens });
-	const token = validTokens.find((token$1) => token$1.scopes.includes(scope));
-	if (!token) return;
-	if (consume && token.singleUse) {
-		const updatedTokens = validTokens.filter((t) => t !== token);
-		core.state.set({ elevatedAccessTokens: updatedTokens });
-	}
-	return token.token;
-};
-const __getElevatedAccessToken_impl = getElevatedAccessToken;
-const __getElevatedAccessToken_wrapped = instrumentFunction({
-	fn: __getElevatedAccessToken_impl,
-	functionName: "getElevatedAccessToken",
-	getCore: () => {
-		try {
-			return getCore(getDefaultClient());
-		} catch {
-			return;
-		}
-	}
-});
-
-//#endregion
-//#region src/errors/ValueMustBeDefinedError.ts
-var ValueMustBeDefinedError = class extends BaseError {
-	constructor(message) {
-		super({
-			cause: null,
-			code: "value_must_be_defined_error",
-			docsUrl: null,
-			name: "ValueMustBeDefined",
-			shortMessage: message
-		});
-	}
-};
-
-//#endregion
-//#region src/utils/assertDefined/assertDefined.ts
-/**
-* Asserts that a value is not null or undefined, throwing an error if it is.
-* This function acts as a type guard, narrowing the type to exclude null and undefined.
-*
-* @template T - The type of the value being checked
-* @param value - The value to check for null or undefined
-* @param message - The error message to throw if the value is null or undefined
-* @throws Throws an error with the provided message if value is null or undefined
-* @example
-* ```typescript
-* const maybeString: string | null = getValue();
-* assertDefined(maybeString, 'String value is required');
-* // maybeString is now typed as string (null is excluded)
-* ```
-*/
-function assertDefined(value, message) {
-	if (value === null || value === void 0) throw new ValueMustBeDefinedError(message);
-}
-
-//#endregion
-//#region src/modules/projectSettings/isCookieEnabled/isCookieEnabled.ts
-/**
-* Returns true if the client is using Dynamic cookies or a BYO JWT cookie.
-* @not-instrumented
-*/
-const isCookieEnabled = (client) => {
-	assertDefined(client.projectSettings, "Project settings are not defined");
-	const securitySettings = client.projectSettings.security;
-	if (!securitySettings) return false;
-	const dynamicCookiesEnabled = (securitySettings.auth?.storage || []).includes(AuthStorageEnum.Cookie);
-	const byoJwtCookieEnabled = Boolean(securitySettings.externalAuth?.cookieName);
-	return dynamicCookiesEnabled || byoJwtCookieEnabled;
-};
-
-//#endregion
-//#region src/modules/sessionKeys/getSessionKeys/getSessionKeys.ts
-/** @not-instrumented */
-const getSessionKeys = (client) => {
-	const publicKey = getCore(client).state.get().sessionKeys;
-	if (!publicKey) return;
-	return { publicKey };
-};
-
-//#endregion
-//#region src/errors/APIError/APIError.ts
-var APIError = class APIError extends BaseError {
-	status;
-	constructor(message, code, status) {
-		super({
-			cause: null,
-			code,
-			docsUrl: null,
-			name: "APIError",
-			shortMessage: message
-		});
-		this.status = status;
-	}
-	static async fromResponse(response) {
-		try {
-			const errorBody = await response.clone().json();
-			if (errorBody && "error" in errorBody && typeof errorBody.error === "string") {
-				const errorCode = "code" in errorBody && typeof errorBody.code === "string" ? errorBody.code : "unknown_error";
-				return new APIError(errorBody.error, errorCode, response.status);
-			}
-			return null;
-		} catch {
-			return null;
-		}
-	}
-};
-
-//#endregion
-//#region src/errors/InvalidExternalAuthError.ts
-var InvalidExternalAuthError = class extends BaseError {
-	constructor({ cause }) {
-		super({
-			cause,
-			code: "invalid_external_auth_error",
-			docsUrl: "https://www.dynamic.xyz/docs/external-auth/third-party-auth-overview",
-			name: "InvalidExternalAuthError",
-			shortMessage: "Error authenticating with external JWT"
-		});
-	}
-};
-
-//#endregion
-//#region src/errors/LinkCredentialError.ts
-var LinkCredentialError = class extends BaseError {
-	constructor({ cause }) {
-		super({
-			cause,
-			code: "link_credential_error",
-			docsUrl: null,
-			name: "LinkCredentialError",
-			shortMessage: "The credential you are trying to link is associated with another account and cannot be reassigned."
-		});
-	}
-};
-
-//#endregion
-//#region src/errors/MfaInvalidOtpError.ts
-var MfaInvalidOtpError = class extends BaseError {
-	constructor({ cause }) {
-		super({
-			cause,
-			code: "mfa_invalid_otp_error",
-			docsUrl: null,
-			name: "MfaInvalidOtpError",
-			shortMessage: "Invalid OTP"
-		});
-	}
-};
-
-//#endregion
-//#region src/errors/MfaRateLimitedError.ts
-var MfaRateLimitedError = class extends BaseError {
-	constructor({ cause }) {
-		super({
-			cause,
-			code: "mfa_rate_limited_error",
-			docsUrl: null,
-			name: "MfaRateLimitedError",
-			shortMessage: "Rate limited"
-		});
-	}
-};
-
-//#endregion
-//#region src/errors/SandboxMaximumThresholdReachedError.ts
-var SandboxMaximumThresholdReachedError = class extends BaseError {
-	constructor({ cause }) {
-		super({
-			cause,
-			code: "sandbox_maximum_threshold_reached_error",
-			docsUrl: "https://www.dynamic.xyz/docs/developer-dashboard/sandbox-vs-live#sandbox-vs-live",
-			name: "SandboxMaximumThresholdReachedError",
-			shortMessage: "Your sandbox environment has reached the maximum MAU. Please use a live environment for production traffic."
-		});
-	}
-};
-
-//#endregion
-//#region src/modules/apiClient/utils/clientErrorMapper/clientErrorMapper.ts
-/**
-* Default error mapper for the client that handles common API error codes.
-*
-* This mapper transforms specific API error codes into more specific error types:
-* - `mfa_invalid_code` → `MfaInvalidOtpError`
-* - `mfa_rate_limited` → `MfaRateLimitedError`
-*
-* @param error - The error to be mapped
-* @returns A transformed error if the error code matches a known pattern, or null if no transformation is needed
-*
-* @example
-* ```typescript
-* // This will be automatically applied to all API errors
-* const apiClient = createApiClient({}, client);
-*
-* // The clientErrorMapper will automatically convert mfa_invalid_code errors
-* // to MfaInvalidOtpError instances
-* ```
-* @not-instrumented
+* @param error - The error to be mapped
+* @returns A transformed error if the error code matches a known pattern, or null if no transformation is needed
+*
+* @example
+* ```typescript
+* // This will be automatically applied to all API errors
+* const apiClient = createApiClient({}, client);
+*
+* // The clientErrorMapper will automatically convert mfa_invalid_code errors
+* // to MfaInvalidOtpError instances
+* ```
+* @notInstrumented
 */
 const clientErrorMapper = (error) => {
 	if (error instanceof APIError) {
@@ -844,7 +391,7 @@ const clientErrorMapper = (error) => {
 *
 * @param options.errorMappers - Array of error mappers to apply to API errors
 * @returns A middleware function that handles error conversion and mapping
-* @not-instrumented
+* @notInstrumented
 */
 const createConvertToApiErrorMiddleware = ({ errorMappers = [] }) => ({ post: async (context) => {
 	if (context.response.status >= 400) {
@@ -872,7 +419,7 @@ const createConvertToApiErrorMiddleware = ({ errorMappers = [] }) => ({ post: as
 * Pops the first nonce from the prefetched pool. When the pool is running low
 * (≤1 remaining after pop) a background refetch is triggered. If the pool is
 * empty, nonces are fetched on-demand before returning.
-* @not-instrumented
+* @notInstrumented
 */
 const getNonce = async (client) => {
 	const core = getCore(client);
@@ -889,7 +436,7 @@ const getNonce = async (client) => {
 
 //#endregion
 //#region src/modules/deviceRegistration/getDeviceSigner/getDeviceSigner.ts
-/** @not-instrumented */
+/** @notInstrumented */
 const getDeviceSigner = async (client) => {
 	const { deviceSigner, keychain } = getCore(client);
 	/**
@@ -907,7 +454,7 @@ const getDeviceSigner = async (client) => {
 
 //#endregion
 //#region src/modules/deviceRegistration/getHeadersForNonceSignedByDeviceSigners/getHeadersForNonceSignedByDeviceSigners.ts
-/** @not-instrumented */
+/** @notInstrumented */
 const getHeadersForNonceSignedByDeviceSigners = async (client) => {
 	const { projectSettings } = client;
 	assertDefined(projectSettings, "Project settings not found");
@@ -930,7 +477,7 @@ const getHeadersForNonceSignedByDeviceSigners = async (client) => {
 
 //#endregion
 //#region src/modules/apiClient/utils/deviceSignatureHeadersMiddleware/createDeviceSignatureHeadersMiddleware.ts
-/** @not-instrumented */
+/** @notInstrumented */
 const createDeviceSignatureHeadersMiddleware = (client) => {
 	return { pre: async (context) => {
 		/**
@@ -968,7 +515,7 @@ var UnauthorizedError = class extends BaseError {
 
 //#endregion
 //#region src/modules/apiClient/utils/unauthorizedMiddleware/createUnauthorizedMiddleware.ts
-/** @not-instrumented */
+/** @notInstrumented */
 const createUnauthorizedMiddleware = () => ({ post: async (context) => {
 	if (context.response.status === 401) {
 		let cause = null;
@@ -987,7 +534,7 @@ const createUnauthorizedMiddleware = () => ({ post: async (context) => {
 * Returns a new instance of the SDK API client.
 *
 * This is not meant for storing, as it is very light we can create it whenever needed.
-* @not-instrumented
+* @notInstrumented
 */
 const createApiClient = (options = {}, client) => {
 	const core = getCore(client);
@@ -1009,7 +556,7 @@ const createApiClient = (options = {}, client) => {
 	if (client.projectSettings && isCookieEnabled(client)) settings.credentials = "include";
 	if (options.includeMfaToken && coreState.mfaToken) settings.headers[MFA_TOKEN_HEADER] = coreState.mfaToken;
 	if (options.elevatedAccessTokenScope) {
-		const elevatedToken = __getElevatedAccessToken_wrapped({ scope: options.elevatedAccessTokenScope }, client);
+		const elevatedToken = getElevatedAccessToken({ scope: options.elevatedAccessTokenScope }, client);
 		if (elevatedToken) settings.headers[ELEVATED_ACCESS_TOKEN_HEADER] = elevatedToken;
 	}
 	const sessionPublicKey = getSessionKeys(client)?.publicKey;
@@ -1044,7 +591,7 @@ const createApiClient = (options = {}, client) => {
 * Concurrent refills are coalesced behind a single in-flight promise so that
 * simultaneous callers share one `GET /nonces` round-trip instead of each
 * issuing their own (which would inflate the pool and hammer the backend).
-* @not-instrumented
+* @notInstrumented
 */
 const fetchAndStoreNonces = async (client) => {
 	const core = getCore(client);
@@ -1073,7 +620,7 @@ const fetchAndStoreNonces = async (client) => {
 //#region src/utils/setCookie/setCookie.ts
 /**
 * Sefelly sets the cookie in the browser.
-* @not-instrumented
+* @notInstrumented
 */
 const setCookie = (cookie) => {
 	document.cookie = cookie;
@@ -1091,7 +638,7 @@ const setCookie = (cookie) => {
 * @param params.listener - The callback function to execute when the event is fired.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A function that can be called to remove the listener.
-* @not-instrumented
+* @notInstrumented
 * @hook Event listeners are error-prone to wire up by hand with useEffect.
 */
 const onEvent = ({ event, listener }, client = getDefaultClient()) => {
@@ -1110,7 +657,7 @@ const onEvent = ({ event, listener }, client = getDefaultClient()) => {
 * @param params.event - The event name to remove the listener from.
 * @param params.listener - The callback function to remove.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @not-instrumented
+* @notInstrumented
 */
 const offEvent = ({ event, listener }, client = getDefaultClient()) => {
 	const { eventEmitter } = getCore(client);
@@ -1126,7 +673,7 @@ const offEvent = ({ event, listener }, client = getDefaultClient()) => {
 * @param params.listener - The callback function to execute when the event is fired.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A function that can be called to remove the listener before it fires.
-* @not-instrumented
+* @notInstrumented
 * @hook Event listeners are error-prone to wire up by hand with useEffect.
 */
 const onceEvent = ({ event, listener }, client = getDefaultClient()) => {
@@ -1145,7 +692,7 @@ const onceEvent = ({ event, listener }, client = getDefaultClient()) => {
 * @param params.event - The event name to emit.
 * @param params.args - The arguments to pass to event listeners.
 * @param client - The Dynamic client instance.
-* @not-instrumented
+* @notInstrumented
 */
 const emitEvent = ({ event, args }, client) => {
 	const { eventEmitter } = getCore(client);
@@ -1168,7 +715,7 @@ var InvalidWalletProviderKeyError = class extends BaseError {
 
 //#endregion
 //#region src/modules/wallets/walletProvider/splitWalletProviderKey/splitWalletProviderKey.ts
-/** @not-instrumented */
+/** @notInstrumented */
 const splitWalletProviderKey = (walletProviderKey) => {
 	const [normalizedWalletNameWithChain, walletProviderType, suffix, ...rest] = walletProviderKey.split(":");
 	if (!normalizedWalletNameWithChain || !Object.values(WalletProviderEnum).includes(walletProviderType) || rest.length > 0) throw new InvalidWalletProviderKeyError(walletProviderKey);
@@ -1181,7 +728,7 @@ const splitWalletProviderKey = (walletProviderKey) => {
 
 //#endregion
 //#region src/modules/wallets/utils/normalizeAddress/normalizeAddress.ts
-/** @not-instrumented */
+/** @notInstrumented */
 const normalizeAddress = ({ address, chain }) => {
 	let normalizedAddress = address;
 	if (normalizedAddress?.startsWith("0x")) normalizedAddress = normalizedAddress.slice(2);
@@ -1191,7 +738,7 @@ const normalizeAddress = ({ address, chain }) => {
 
 //#endregion
 //#region src/modules/wallets/utils/formatWalletAccountId/formatWalletAccountId.ts
-/** @not-instrumented */
+/** @notInstrumented */
 const formatWalletAccountId = ({ address, chain, walletProviderKey }) => {
 	const { normalizedWalletNameWithChain } = splitWalletProviderKey(walletProviderKey);
 	return `${normalizedWalletNameWithChain}:${normalizeAddress({
@@ -1202,7 +749,7 @@ const formatWalletAccountId = ({ address, chain, walletProviderKey }) => {
 
 //#endregion
 //#region src/modules/wallets/utils/convertUnverifiedWalletAccountToWalletAccount/convertUnverifiedWalletAccountToWalletAccount.ts
-/** @not-instrumented */
+/** @notInstrumented */
 const convertUnverifiedWalletAccountToWalletAccount = ({ unverifiedWalletAccount }) => ({
 	address: unverifiedWalletAccount.address,
 	addressesWithTypes: unverifiedWalletAccount.addressesWithTypes,
@@ -1312,313 +859,756 @@ const CHAINS_INFO_MAP = {
 };
 
 //#endregion
-//#region src/utils/getChainFromVerifiedCredentialChain/getChainFromVerifiedCredentialChain.ts
-/** @not-instrumented */
-const getChainFromVerifiedCredentialChain = (verifiedCredentialChain) => {
-	const chain = Object.keys(CHAINS_INFO_MAP).find((chain$1) => CHAINS_INFO_MAP[chain$1].verifiedCredentialChainName === verifiedCredentialChain);
-	assertDefined(chain, `Unknown chain: ${verifiedCredentialChain}`);
-	return chain;
+//#region src/utils/getChainFromVerifiedCredentialChain/getChainFromVerifiedCredentialChain.ts
+/** @notInstrumented */
+const getChainFromVerifiedCredentialChain = (verifiedCredentialChain) => {
+	const chain = Object.keys(CHAINS_INFO_MAP).find((chain$1) => CHAINS_INFO_MAP[chain$1].verifiedCredentialChainName === verifiedCredentialChain);
+	assertDefined(chain, `Unknown chain: ${verifiedCredentialChain}`);
+	return chain;
+};
+
+//#endregion
+//#region src/modules/wallets/utils/normalizeWalletNameWithChain/normalizeWalletNameWithChain.ts
+/**
+* Format the raw wallet name and chain to get the value we can use for
+* verified credentials' `walletName` field.
+* @notInstrumented
+*/
+const normalizeWalletNameWithChain = ({ displayName, chain }) => {
+	const sanitizedWalletName = displayName.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+	const chainLowered = chain.toLocaleLowerCase();
+	if (sanitizedWalletName.endsWith(chainLowered)) return sanitizedWalletName;
+	return `${sanitizedWalletName}${chainLowered}`;
+};
+
+//#endregion
+//#region src/modules/wallets/utils/formatWalletProviderKey/formatWalletProviderKey.ts
+/**
+* Assembles the wallet provider key from the wallet name, chain, and wallet provider type.
+*
+* The suffix is optional and can be used to add a uniquely identifying string to the key, which
+* might be necessary for some wallet providers (like Wallet Connect).
+*
+* IMPORTANT: Do NOT add a suffix unless absolutely necessary, as it will cause the wallet account
+* to not be able to find its wallet provider when connecting to a new device (it won't be possible
+* to determine the full key just from the Verified Credential data).
+* @notInstrumented
+*/
+const formatWalletProviderKey = ({ suffix, chain, displayName, walletProviderType }) => {
+	return `${normalizeWalletNameWithChain({
+		chain,
+		displayName
+	})}:${walletProviderType}${suffix ? `:${suffix}` : ""}`;
+};
+
+//#endregion
+//#region src/modules/wallets/walletProvider/walletProviderKeyMap/getWalletProviderKeyFromVerifiedCredential/getWalletProviderKeyFromVerifiedCredential.ts
+/** @notInstrumented */
+const getWalletProviderKeyFromVerifiedCredential = ({ verifiedCredential }, client) => {
+	const { walletProviderKeyMap } = getCore(client).state.get();
+	const storedWalletProviderKey = walletProviderKeyMap[verifiedCredential.id];
+	if (storedWalletProviderKey) return { walletProviderKey: storedWalletProviderKey };
+	/**
+	* We fallback to comprising the wallet provider key from walletName and walletProvider.
+	*
+	* Some wallet provider types (like Wallet Connect) also use a special suffix for their wallet provider
+	* keys, so this won't be enough for them.
+	* Therefore, for those specific wallet providers, the wallet account will remain without a wallet provider
+	* and will require reconnection.
+	* Read walletProvider.types.ts for more info.
+	*/
+	assertDefined(verifiedCredential.walletName, `Failed to get wallet provider for verified credential with ID ${verifiedCredential.id}: missing walletName`);
+	assertDefined(verifiedCredential.walletProvider, `Failed to get wallet provider for verified credential with ID ${verifiedCredential.id}: missing walletProvider`);
+	assertDefined(verifiedCredential.chain, `Failed to get wallet provider for verified credential with ID ${verifiedCredential.id}: missing chain`);
+	return { walletProviderKey: formatWalletProviderKey({
+		chain: getChainFromVerifiedCredentialChain(verifiedCredential.chain),
+		displayName: verifiedCredential.walletName,
+		walletProviderType: verifiedCredential.walletProvider
+	}) };
+};
+
+//#endregion
+//#region src/modules/wallets/utils/convertVerifiedCredentialToWalletAccount/convertVerifiedCredentialToWalletAccount.ts
+/** @notInstrumented */
+const convertVerifiedCredentialToWalletAccount = ({ verifiedCredential }, client) => {
+	assertDefined(verifiedCredential.address, "Missing address in verified credential");
+	assertDefined(verifiedCredential.chain, "Missing chain in verified credential");
+	const chain = getChainFromVerifiedCredentialChain(verifiedCredential.chain);
+	const { walletProviderKey } = getWalletProviderKeyFromVerifiedCredential({ verifiedCredential }, client);
+	const walletAccountId = formatWalletAccountId({
+		address: verifiedCredential.address,
+		chain,
+		walletProviderKey
+	});
+	return {
+		address: verifiedCredential.address,
+		addressesWithTypes: verifiedCredential.walletAdditionalAddresses,
+		chain,
+		hardwareWalletVendor: verifiedCredential.walletProperties?.hardwareWallet,
+		id: walletAccountId,
+		lastSelectedAt: verifiedCredential.lastSelectedAt ?? null,
+		verifiedCredentialId: verifiedCredential.id,
+		walletProviderKey
+	};
+};
+
+//#endregion
+//#region src/modules/wallets/getWalletAccounts/getWalletAccountsFromState/getWalletAccountsFromState.ts
+/** @notInstrumented */
+const getWalletAccountsFromState = ({ unverifiedWalletAccounts, user }, client) => {
+	const walletAccountsMap = /* @__PURE__ */ new Map();
+	/**
+	* Handle the unverified wallet accounts before the user verified credentials
+	* so the later verified wallet accounts can override the unverified wallet accounts
+	*/
+	unverifiedWalletAccounts.forEach((unverifiedWalletAccount) => {
+		const walletAccount = convertUnverifiedWalletAccountToWalletAccount({ unverifiedWalletAccount });
+		walletAccountsMap.set(walletAccount.id, walletAccount);
+	});
+	(user?.verifiedCredentials ?? []).filter((verified) => verified.format === JwtVerifiedCredentialFormatEnum.Blockchain).forEach((verifiedWalletAccount) => {
+		try {
+			const walletAccount = convertVerifiedCredentialToWalletAccount({ verifiedCredential: verifiedWalletAccount }, client);
+			walletAccountsMap.set(walletAccount.id, walletAccount);
+		} catch (error) {
+			/**
+			* A verified credential can be missing the data required to resolve its
+			* wallet provider (e.g. a legacy credential without a walletName). Skip
+			* it instead of throwing so a single unconvertible credential does not
+			* abort the whole mapping — which, during client initialization, would
+			* otherwise fail init and leave the app stuck loading. The wallet stays
+			* absent until the user reconnects it.
+			*/
+			getCore(client).logger.debug(`Skipping verified credential ${verifiedWalletAccount.id}: unable to convert to wallet account`, error);
+		}
+	});
+	return Array.from(walletAccountsMap.values());
+};
+
+//#endregion
+//#region src/modules/wallets/getWalletAccounts/getWalletAccounts.ts
+/**
+* Retrieves all wallet accounts associated with the current session.
+*
+* This function returns both verified and unverified wallet accounts,
+* combining data from user credentials and local unverified accounts.
+* You can differentiate between verified and unverified wallet accounts by
+* checking the `verifiedCredentialId` property.
+*
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns An array of wallet accounts associated with the session.
+* @notInstrumented
+* @hook Exposed as a hook so consumers get the reactive list of wallet accounts.
+*/
+const getWalletAccounts = (client = getDefaultClient()) => {
+	const { unverifiedWalletAccounts, user } = getCore(client).state.get();
+	return getWalletAccountsFromState({
+		unverifiedWalletAccounts,
+		user
+	}, client);
+};
+
+//#endregion
+//#region src/errors/NoWalletProviderFoundError.ts
+var NoWalletProviderFoundError = class extends BaseError {
+	constructor({ walletProviderKey }) {
+		super({
+			cause: null,
+			code: "no_wallet_provider_found_error",
+			docsUrl: null,
+			name: "NoWalletProviderFoundError",
+			shortMessage: `No wallet provider found with key: ${walletProviderKey}`
+		});
+	}
 };
 
 //#endregion
-//#region src/modules/wallets/utils/normalizeWalletNameWithChain/normalizeWalletNameWithChain.ts
+//#region src/services/runtimeServices/createRuntimeServiceAccessKey/createRuntimeServiceAccessKey.ts
 /**
-* Format the raw wallet name and chain to get the value we can use for
-* verified credentials' `walletName` field.
-* @not-instrumented
+* Creates a service accessor function that manages service instantiation and caching.
+* The returned function will either retrieve an existing service from the registry or
+* create a new one using the provided builder function.
+*
+* @template - The type of service to be created/accessed
+* @param key - Unique identifier for the service in the registry
+* @param builder - Function that creates the service instance when called with a DynamicClient
+* @notInstrumented
 */
-const normalizeWalletNameWithChain = ({ displayName, chain }) => {
-	const sanitizedWalletName = displayName.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
-	const chainLowered = chain.toLocaleLowerCase();
-	if (sanitizedWalletName.endsWith(chainLowered)) return sanitizedWalletName;
-	return `${sanitizedWalletName}${chainLowered}`;
+const createRuntimeServiceAccessKey = (key, builder) => (client) => {
+	const { runtimeServices } = getCore(client);
+	const currentService = runtimeServices.getByKey(key);
+	if (currentService) return currentService;
+	const service = builder(client);
+	runtimeServices.register(key, service);
+	return service;
 };
 
 //#endregion
-//#region src/modules/wallets/utils/formatWalletProviderKey/formatWalletProviderKey.ts
+//#region src/modules/wallets/walletProviderRegistry/createWalletProviderRegistry/createWalletProviderRegistry.ts
 /**
-* Assembles the wallet provider key from the wallet name, chain, and wallet provider type.
+* Creates a new wallet provider registry that manages wallet providers with priority-based registration.
 *
-* The suffix is optional and can be used to add a uniquely identifying string to the key, which
-* might be necessary for some wallet providers (like Wallet Connect).
+* @returns The wallet provider registry instance
 *
-* IMPORTANT: Do NOT add a suffix unless absolutely necessary, as it will cause the wallet account
-* to not be able to find its wallet provider when connecting to a new device (it won't be possible
-* to determine the full key just from the Verified Credential data).
-* @not-instrumented
+* @example
+* ```typescript
+* const registry = createWalletProviderRegistry();
+*
+* registry.register({
+*   priority: WalletProviderPriority.WALLET_SDK,
+*   walletProvider: myWalletProvider
+* });
+*
+* const provider = registry.getByKey('my-wallet-key');
+* const providers = registry.listProviders();
+* ```
+* @notInstrumented
 */
-const formatWalletProviderKey = ({ suffix, chain, displayName, walletProviderType }) => {
-	return `${normalizeWalletNameWithChain({
-		chain,
-		displayName
-	})}:${walletProviderType}${suffix ? `:${suffix}` : ""}`;
+const createWalletProviderRegistry = (client) => {
+	const registry = /* @__PURE__ */ new Map();
+	return {
+		getByKey: (key) => registry.get(key)?.walletProvider,
+		listProviderEntries: () => Array.from(registry.values()),
+		listProviders: () => Array.from(registry.values()).map((v) => v.walletProvider),
+		register: (args) => {
+			const existingEntry = registry.get(args.walletProvider.key);
+			if (existingEntry) {
+				if (existingEntry.priority < args.priority) {
+					registry.set(args.walletProvider.key, args);
+					emitEvent({
+						args: { walletProviderKey: args.walletProvider.key },
+						event: "walletProviderChanged"
+					}, client);
+				}
+			} else {
+				registry.set(args.walletProvider.key, args);
+				emitEvent({
+					args: { walletProvider: args.walletProvider },
+					event: "walletProviderRegistered"
+				}, client);
+				emitEvent({
+					args: { walletProviderKey: args.walletProvider.key },
+					event: "walletProviderChanged"
+				}, client);
+			}
+		},
+		unregister: (key) => {
+			registry.delete(key);
+			emitEvent({
+				args: { walletProviderKey: key },
+				event: "walletProviderUnregistered"
+			}, client);
+		}
+	};
 };
 
 //#endregion
-//#region src/modules/wallets/walletProvider/walletProviderKeyMap/getWalletProviderKeyFromVerifiedCredential/getWalletProviderKeyFromVerifiedCredential.ts
-/** @not-instrumented */
-const getWalletProviderKeyFromVerifiedCredential = ({ verifiedCredential }, client) => {
-	const { walletProviderKeyMap } = getCore(client).state.get();
-	const storedWalletProviderKey = walletProviderKeyMap[verifiedCredential.id];
-	if (storedWalletProviderKey) return { walletProviderKey: storedWalletProviderKey };
+//#region src/modules/wallets/walletProviderRegistry/getWalletProviderRegistry/getWalletProviderRegistry.ts
+/**
+* This function provides access to a shared instance of the wallet provider registry.
+*
+* It ensures that the same registry instance is used throughout the client to maintaining
+* consistency of registered wallet providers across different parts of the codebase.
+*
+* @returns The wallet provider registry instance
+*
+* @example
+* ```typescript
+* // Get the registry instance
+* const registry = getWalletProviderRegistry();
+*
+* // Register a wallet provider
+* registry.register({
+*   priority: WalletProviderPriority.WALLET_SDK,
+*   walletProvider: myWalletProvider
+* });
+*
+* // Retrieve a specific provider
+* const provider = registry.getByKey('metamaskevm');
+* ```
+*/
+const getWalletProviderRegistry = createRuntimeServiceAccessKey("walletProviderRegistry", (client) => createWalletProviderRegistry(client));
+
+//#endregion
+//#region src/modules/wallets/walletProviderRegistry/walletProviderRegistry.types.ts
+let WalletProviderPriority = /* @__PURE__ */ function(WalletProviderPriority$1) {
 	/**
-	* We fallback to comprising the wallet provider key from walletName and walletProvider.
-	*
-	* Some wallet provider types (like Wallet Connect) also use a special suffix for their wallet provider
-	* keys, so this won't be enough for them.
-	* Therefore, for those specific wallet providers, the wallet account will remain without a wallet provider
-	* and will require reconnection.
-	* Read walletProvider.types.ts for more info.
+	* Highest priority should be used by wallet providers that implement
+	* the most reliable wallet integration.
+	* example: The SDK provided by the wallet provider.
 	*/
-	assertDefined(verifiedCredential.walletName, `Failed to get wallet provider for verified credential with ID ${verifiedCredential.id}: missing walletName`);
-	assertDefined(verifiedCredential.walletProvider, `Failed to get wallet provider for verified credential with ID ${verifiedCredential.id}: missing walletProvider`);
-	assertDefined(verifiedCredential.chain, `Failed to get wallet provider for verified credential with ID ${verifiedCredential.id}: missing chain`);
-	return { walletProviderKey: formatWalletProviderKey({
-		chain: getChainFromVerifiedCredentialChain(verifiedCredential.chain),
-		displayName: verifiedCredential.walletName,
-		walletProviderType: verifiedCredential.walletProvider
-	}) };
+	WalletProviderPriority$1[WalletProviderPriority$1["WALLET_SDK"] = 100] = "WALLET_SDK";
+	/**
+	* Medium priority should be used by wallet providers that implement
+	* a wallet integration via some reliable standard.
+	* example: A wallet provider that uses EIP6963 announcement.
+	*/
+	WalletProviderPriority$1[WalletProviderPriority$1["WALLET_SELF_ANNOUNCEMENT_STANDARD"] = 50] = "WALLET_SELF_ANNOUNCEMENT_STANDARD";
+	/**
+	* Low priority should be used by wallet providers that implement
+	* a wallet integration on a less reliable standard.
+	* example: A wallet provider that uses window.ethereum, where the
+	* window key can be overridden by other extensions.
+	*/
+	WalletProviderPriority$1[WalletProviderPriority$1["WINDOW_INJECT"] = 20] = "WINDOW_INJECT";
+	return WalletProviderPriority$1;
+}({});
+
+//#endregion
+//#region src/modules/wallets/utils/getWalletProviderFromWalletAccount/getWalletProviderFromWalletAccount.ts
+/** @notInstrumented */
+const getWalletProviderFromWalletAccount = ({ walletAccount }, client) => {
+	const walletProvider = getWalletProviderRegistry(client).getByKey(walletAccount.walletProviderKey);
+	if (!walletProvider) throw new NoWalletProviderFoundError({ walletProviderKey: walletAccount.walletProviderKey });
+	return walletProvider;
 };
 
 //#endregion
-//#region src/modules/wallets/utils/convertVerifiedCredentialToWalletAccount/convertVerifiedCredentialToWalletAccount.ts
-/** @not-instrumented */
-const convertVerifiedCredentialToWalletAccount = ({ verifiedCredential }, client) => {
-	assertDefined(verifiedCredential.address, "Missing address in verified credential");
-	assertDefined(verifiedCredential.chain, "Missing chain in verified credential");
-	const chain = getChainFromVerifiedCredentialChain(verifiedCredential.chain);
-	const { walletProviderKey } = getWalletProviderKeyFromVerifiedCredential({ verifiedCredential }, client);
-	const walletAccountId = formatWalletAccountId({
-		address: verifiedCredential.address,
-		chain,
-		walletProviderKey
-	});
-	return {
-		address: verifiedCredential.address,
-		addressesWithTypes: verifiedCredential.walletAdditionalAddresses,
-		chain,
-		hardwareWalletVendor: verifiedCredential.walletProperties?.hardwareWallet,
-		id: walletAccountId,
-		lastSelectedAt: verifiedCredential.lastSelectedAt ?? null,
-		verifiedCredentialId: verifiedCredential.id,
-		walletProviderKey
-	};
+//#region src/modules/auth/consts.ts
+const DYNAMIC_AUTH_COOKIE_NAME = "DYNAMIC_JWT_TOKEN";
+
+//#endregion
+//#region src/modules/auth/extractSessionId/extractSessionId.ts
+/**
+* Extracts the session ID (`sid` claim) from a JWT token string.
+*
+* Decodes the base64url-encoded payload segment of the token and reads the
+* `sid` field. This is used to correlate instrumentation events with the
+* authenticated session, without ever forwarding the full token.
+*
+* Returns `null` when no token is present, when the token is malformed, or
+* when the payload does not contain a `sid` claim.
+* @notInstrumented
+*/
+const extractSessionId = (token) => {
+	try {
+		const payload = token.split(".")[1];
+		return JSON.parse(atob(payload)).sid ?? null;
+	} catch {
+		return null;
+	}
+};
+
+//#endregion
+//#region src/utils/getOperatingSystem/getOperatingSystem.ts
+/**
+* Detects the operating system from `navigator.userAgent` for web environments.
+*
+* The React Native bundler (Metro) resolves `getOperatingSystem.native.ts`
+* instead when building for React Native, which uses `Platform.OS` directly.
+*
+* Falls back to `'unknown'` when `navigator` is unavailable (SSR, service
+* workers) or when the user-agent string doesn't match a known OS pattern.
+* @notInstrumented
+*/
+const getOperatingSystem = () => {
+	try {
+		const ua = navigator.userAgent;
+		if (/iPhone|iPad|iPod/.test(ua)) return "ios";
+		if (/Android/.test(ua)) return "android";
+		if (/Windows/.test(ua)) return "windows";
+		if (/Macintosh|Mac OS X/.test(ua)) return "macos";
+		if (/Linux/.test(ua)) return "linux";
+		return "unknown";
+	} catch {
+		return "unknown";
+	}
 };
 
 //#endregion
-//#region src/modules/wallets/getWalletAccounts/getWalletAccountsFromState/getWalletAccountsFromState.ts
-/** @not-instrumented */
-const getWalletAccountsFromState = ({ unverifiedWalletAccounts, user }, client) => {
-	const walletAccountsMap = /* @__PURE__ */ new Map();
-	/**
-	* Handle the unverified wallet accounts before the user verified credentials
-	* so the later verified wallet accounts can override the unverified wallet accounts
-	*/
-	unverifiedWalletAccounts.forEach((unverifiedWalletAccount) => {
-		const walletAccount = convertUnverifiedWalletAccountToWalletAccount({ unverifiedWalletAccount });
-		walletAccountsMap.set(walletAccount.id, walletAccount);
-	});
-	(user?.verifiedCredentials ?? []).filter((verified) => verified.format === JwtVerifiedCredentialFormatEnum.Blockchain).forEach((verifiedWalletAccount) => {
-		try {
-			const walletAccount = convertVerifiedCredentialToWalletAccount({ verifiedCredential: verifiedWalletAccount }, client);
-			walletAccountsMap.set(walletAccount.id, walletAccount);
-		} catch (error) {
-			/**
-			* A verified credential can be missing the data required to resolve its
-			* wallet provider (e.g. a legacy credential without a walletName). Skip
-			* it instead of throwing so a single unconvertible credential does not
-			* abort the whole mapping — which, during client initialization, would
-			* otherwise fail init and leave the app stuck loading. The wallet stays
-			* absent until the user reconnects it.
-			*/
-			getCore(client).logger.debug(`Skipping verified credential ${verifiedWalletAccount.id}: unable to convert to wallet account`, error);
-		}
-	});
-	return Array.from(walletAccountsMap.values());
+//#region src/utils/getPlatform/getPlatform.ts
+/**
+* Returns the platform the SDK is running on.
+*
+* This is the web implementation — the React Native bundler resolves
+* `getPlatform.native.ts` instead when building for React Native, which
+* returns `'react-native'`.
+* @notInstrumented
+*/
+const getPlatform = () => "web";
+
+//#endregion
+//#region src/utils/getUserAgent/getUserAgent.ts
+/**
+* Returns the browser's `navigator.userAgent` string for inclusion in
+* instrumentation events.
+*
+* Falls back to an empty string in environments where `navigator` is not
+* available (e.g., Node.js SSR, service workers) so that callers never need
+* to guard against undefined.
+* @notInstrumented
+*/
+const getUserAgent = () => {
+	try {
+		return navigator.userAgent;
+	} catch {
+		return "";
+	}
 };
 
 //#endregion
-//#region src/modules/wallets/getWalletAccounts/getWalletAccounts.ts
+//#region src/services/instrumentation/constants.ts
 /**
-* Retrieves all wallet accounts associated with the current session.
+* Default key-based PII scrubber list, lowercased and matched against the
+* lowercased object key.
 *
-* This function returns both verified and unverified wallet accounts,
-* combining data from user credentials and local unverified accounts.
-* You can differentiate between verified and unverified wallet accounts by
-* checking the `verifiedCredentialId` property.
+* Two complementary mechanisms cover credential leakage:
 *
-* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns An array of wallet accounts associated with the session.
-* @not-instrumented
-* @hook Exposed as a hook so consumers get the reactive list of wallet accounts.
+* 1. Explicit keys listed here — matched exactly (case-insensitive). Use this
+*    for keys that don't end in a generic credential suffix (e.g. `mnemonic`,
+*    `seed`, `verificationCode`, `keyShare`).
+* 2. Suffix matching in {@link scrubParameters} for the credential suffixes
+*    enumerated by {@link PII_KEY_SUFFIXES} — catches any field whose name
+*    ends in `token` or `jwt` (e.g. `mfaToken`, `minifiedJwt`, `accessToken`,
+*    `idToken`, `captchaToken`, …) without needing to enumerate them here.
 */
-const getWalletAccounts = (client = getDefaultClient()) => {
-	const { unverifiedWalletAccounts, user } = getCore(client).state.get();
-	return getWalletAccountsFromState({
-		unverifiedWalletAccounts,
-		user
-	}, client);
-};
+const DEFAULT_PII_FIELDS = [
+	"password",
+	"token",
+	"secret",
+	"privateKey",
+	"privateJwk",
+	"mnemonic",
+	"seed",
+	"keyShare",
+	"keyShares",
+	"email",
+	"phone",
+	"ssn",
+	"address",
+	"authorization",
+	"verificationCode",
+	"recoveryCodes",
+	"codeVerifier",
+	"pkce",
+	"bearer",
+	"apiKey",
+	"alias",
+	"publicIdentifier"
+];
+/**
+* Lowercased suffixes used by {@link scrubParameters} to match credential-like
+* keys without enumerating every variant (e.g. `mfaToken`, `accessToken`,
+* `refreshToken`, `legacyToken`, `minifiedJwt`). Only suffixes that are
+* unambiguously credentials belong here — `key` (matches `publicKey`) and
+* `code` (matches `countryCode`) are too broad and must not be added.
+*/
+const PII_KEY_SUFFIXES = ["token", "jwt"];
+const REDACTED_VALUE = "[REDACTED]";
+const MAX_STRING_LENGTH = 500;
+const TRUNCATED_SUFFIX = "...[truncated]";
+/**
+* Label prefix for binary data placeholders. The full placeholder includes the
+* byte length, e.g. `[Binary:16 bytes]`, so consumers can gauge data size
+* without the actual bytes appearing in logs.
+*/
+const BINARY_LABEL = "Binary";
+/**
+* Placeholder emitted when a circular reference is detected in the value tree.
+* Using a named constant makes it easy to search for or filter in downstream
+* log tooling.
+*/
+const CIRCULAR_VALUE = "[Circular]";
 
 //#endregion
-//#region src/errors/NoWalletProviderFoundError.ts
-var NoWalletProviderFoundError = class extends BaseError {
-	constructor({ walletProviderKey }) {
-		super({
-			cause: null,
-			code: "no_wallet_provider_found_error",
-			docsUrl: null,
-			name: "NoWalletProviderFoundError",
-			shortMessage: `No wallet provider found with key: ${walletProviderKey}`
+//#region src/services/instrumentation/scrubParameters/scrubParameters.ts
+/**
+* Returns true when `key` should be redacted based on the configured PII
+* field list. A key matches when its lowercased form either equals one of
+* `piiFieldsLower` exactly, or ends in one of the curated credential
+* suffixes in {@link PII_KEY_SUFFIXES} (currently `token` and `jwt`). The
+* suffix check is what catches `mfaToken`, `minifiedJwt`, `accessToken`,
+* etc. without needing every variant enumerated explicitly.
+*/
+const keyMatchesPiiField = ({ keyLower, piiFieldsLower }) => {
+	if (piiFieldsLower.includes(keyLower)) return true;
+	return PII_KEY_SUFFIXES.some((suffix) => keyLower.endsWith(suffix));
+};
+const scrubString = ({ key, piiFieldsLower, redactAll, value }) => {
+	if (keyMatchesPiiField({
+		keyLower: key.toLowerCase(),
+		piiFieldsLower
+	})) return REDACTED_VALUE;
+	if (redactAll) return REDACTED_VALUE;
+	if (value.length > MAX_STRING_LENGTH) return value.slice(0, MAX_STRING_LENGTH) + TRUNCATED_SUFFIX;
+	return value;
+};
+const scrubArray = ({ context, value }) => {
+	if (context.visited.has(value)) return [CIRCULAR_VALUE];
+	context.visited.add(value);
+	const result = value.map((item, index) => scrubValue({
+		context,
+		key: String(index),
+		value: item
+	}));
+	context.visited.delete(value);
+	return result;
+};
+const scrubObject = ({ context, value }) => {
+	if (context.visited.has(value)) return { [CIRCULAR_VALUE]: true };
+	context.visited.add(value);
+	const result = Object.create(null);
+	for (const key of Object.keys(value)) result[key] = scrubValue({
+		context,
+		key,
+		value: value[key]
+	});
+	context.visited.delete(value);
+	return result;
+};
+const scrubValue = ({ context, key, value }) => {
+	if (value === null || value === void 0) return value;
+	if (value instanceof Uint8Array) return `[${BINARY_LABEL}:${value.byteLength} bytes]`;
+	if (keyMatchesPiiField({
+		keyLower: key.toLowerCase(),
+		piiFieldsLower: context.piiFieldsLower
+	})) return REDACTED_VALUE;
+	if (typeof value === "string") return scrubString({
+		key,
+		piiFieldsLower: context.piiFieldsLower,
+		redactAll: context.redactAll,
+		value
+	});
+	if (Array.isArray(value)) return scrubArray({
+		context,
+		value
+	});
+	if (value instanceof Set) {
+		if (context.visited.has(value)) return [CIRCULAR_VALUE];
+		context.visited.add(value);
+		const setResult = scrubArray({
+			context,
+			value: [...value]
+		});
+		context.visited.delete(value);
+		return setResult;
+	}
+	if (value instanceof Map) {
+		if (context.visited.has(value)) return { [CIRCULAR_VALUE]: true };
+		context.visited.add(value);
+		const asObject = Object.create(null);
+		for (const [k, v] of value.entries()) asObject[String(k)] = v;
+		const mapResult = scrubObject({
+			context,
+			value: asObject
 		});
+		context.visited.delete(value);
+		return mapResult;
 	}
+	if (value instanceof WeakMap) return "[WeakMap]";
+	if (value instanceof WeakSet) return "[WeakSet]";
+	if (value instanceof Date) return value.toISOString();
+	if (value instanceof Error) return `[Error: ${value.message}]`;
+	if (typeof value === "object") return scrubObject({
+		context,
+		value
+	});
+	return value;
+};
+/** @notInstrumented */
+const scrubParameters = ({ piiFields, redactAll, value }) => {
+	return scrubObject({
+		context: {
+			piiFieldsLower: piiFields.map((field) => field.toLowerCase()),
+			redactAll,
+			visited: /* @__PURE__ */ new WeakSet()
+		},
+		value
+	});
 };
 
 //#endregion
-//#region src/services/runtimeServices/createRuntimeServiceAccessKey/createRuntimeServiceAccessKey.ts
+//#region src/services/instrumentation/instrumentFunction/extractParams/extractParams.ts
 /**
-* Creates a service accessor function that manages service instantiation and caching.
-* The returned function will either retrieve an existing service from the registry or
-* create a new one using the provided builder function.
+* Normalises the raw positional arguments of an instrumented function call
+* into a flat `Record<string, unknown>` suitable for structured logging.
 *
-* @template - The type of service to be created/accessed
-* @param key - Unique identifier for the service in the registry
-* @param builder - Function that creates the service instance when called with a DynamicClient
-* @not-instrumented
+* ## Why this is needed
+*
+* Instrumented functions are wrapped with `(...args: unknown[])`, so their
+* parameters arrive as an array. Logging a raw array loses the semantic names
+* of each argument. This function recovers a named representation:
+*
+* - **No arguments** → `{}`
+* - **Single plain-object argument** → that object is returned as-is, because
+*   SDK functions follow the single-object-parameter convention, so the object
+*   already carries named keys (`{ amount, to }`, etc.).
+* - **Everything else** (multiple args, a single primitive, a single array) →
+*   each value is indexed as `arg0`, `arg1`, …
+*
+* ## Why arrays are NOT treated as plain objects
+*
+* `typeof [] === 'object'` and `[] !== null`, so without the `Array.isArray`
+* guard a single-array argument would be returned as-is. That would produce
+* an object with numeric string keys (`{ '0': ..., '1': ... }`), which is
+* misleading and inconsistent with how multi-arg calls are handled. Instead,
+* arrays fall through to the indexed `arg0` path.
+* @notInstrumented
 */
-const createRuntimeServiceAccessKey = (key, builder) => (client) => {
-	const { runtimeServices } = getCore(client);
-	const currentService = runtimeServices.getByKey(key);
-	if (currentService) return currentService;
-	const service = builder(client);
-	runtimeServices.register(key, service);
-	return service;
+const extractParams = (args) => {
+	if (args.length === 0) return {};
+	if (args.length === 1 && typeof args[0] === "object" && args[0] !== null && !Array.isArray(args[0])) return args[0];
+	const result = {};
+	for (let i = 0; i < args.length; i++) result[`arg${i}`] = args[i];
+	return result;
 };
 
 //#endregion
-//#region src/modules/wallets/walletProviderRegistry/createWalletProviderRegistry/createWalletProviderRegistry.ts
+//#region src/services/instrumentation/instrumentFunction/scrubResolvedValue/scrubResolvedValue.ts
 /**
-* Creates a new wallet provider registry that manages wallet providers with priority-based registration.
-*
-* @returns The wallet provider registry instance
-*
-* @example
-* ```typescript
-* const registry = createWalletProviderRegistry();
-*
-* registry.register({
-*   priority: WalletProviderPriority.WALLET_SDK,
-*   walletProvider: myWalletProvider
-* });
-*
-* const provider = registry.getByKey('my-wallet-key');
-* const providers = registry.listProviders();
-* ```
-* @not-instrumented
+* Scrubs a resolved return value of any type before logging it.
+* Routes through `scrubParameters` by wrapping the value so that strings,
+* arrays, Dates, Errors, and all other types are handled identically to
+* nested object fields.
+* @notInstrumented
 */
-const createWalletProviderRegistry = (client) => {
-	const registry = /* @__PURE__ */ new Map();
+const scrubResolvedValue = ({ piiFields, redactAll, value }) => scrubParameters({
+	piiFields,
+	redactAll,
+	value: { result: value }
+}).result;
+
+//#endregion
+//#region src/services/instrumentation/instrumentFunction/instrumentFunction.ts
+const serializeError = (error) => {
+	if (error instanceof Error) return {
+		message: error.message,
+		name: error.name,
+		stack: error.stack
+	};
 	return {
-		getByKey: (key) => registry.get(key)?.walletProvider,
-		listProviderEntries: () => Array.from(registry.values()),
-		listProviders: () => Array.from(registry.values()).map((v) => v.walletProvider),
-		register: (args) => {
-			const existingEntry = registry.get(args.walletProvider.key);
-			if (existingEntry) {
-				if (existingEntry.priority < args.priority) {
-					registry.set(args.walletProvider.key, args);
-					emitEvent({
-						args: { walletProviderKey: args.walletProvider.key },
-						event: "walletProviderChanged"
-					}, client);
-				}
-			} else {
-				registry.set(args.walletProvider.key, args);
-				emitEvent({
-					args: { walletProvider: args.walletProvider },
-					event: "walletProviderRegistered"
-				}, client);
-				emitEvent({
-					args: { walletProviderKey: args.walletProvider.key },
-					event: "walletProviderChanged"
-				}, client);
-			}
-		},
-		unregister: (key) => {
-			registry.delete(key);
-			emitEvent({
-				args: { walletProviderKey: key },
-				event: "walletProviderUnregistered"
-			}, client);
-		}
+		message: String(error),
+		name: "UnknownError"
 	};
 };
-
-//#endregion
-//#region src/modules/wallets/walletProviderRegistry/getWalletProviderRegistry/getWalletProviderRegistry.ts
 /**
-* This function provides access to a shared instance of the wallet provider registry.
+* Wraps a function so that each invocation emits a structured
+* `FunctionInstrumentationEvent` at three lifecycle points:
 *
-* It ensures that the same registry instance is used throughout the client to maintaining
-* consistency of registered wallet providers across different parts of the codebase.
+* - **started** — immediately before the function body executes, with the
+*   PII-scrubbed call parameters.
+* - **resolved** — after the function (or its returned Promise) settles
+*   successfully, with the PII-scrubbed return value.
+* - **rejected** — if the function throws synchronously or its returned
+*   Promise rejects.
 *
-* @returns The wallet provider registry instance
+* The original return value (or thrown error) is always forwarded to the
+* caller unchanged — instrumentation is purely observational.
 *
-* @example
-* ```typescript
-* // Get the registry instance
-* const registry = getWalletProviderRegistry();
+* ## Usage
 *
-* // Register a wallet provider
-* registry.register({
-*   priority: WalletProviderPriority.WALLET_SDK,
-*   walletProvider: myWalletProvider
+* ```ts
+* const transfer = instrumentFunction({
+*   fn: rawTransfer,
+*   functionName: 'transfer',
+*   getCore: () => core,
 * });
 *
-* // Retrieve a specific provider
-* const provider = registry.getByKey('metamaskevm');
+* // When called, three events are emitted automatically:
+* await transfer({ amount: 1, to: '0xabc' });
 * ```
+*
+* ## How functions are wrapped
+*
+* `instrumentFunction` is not called manually in application code. Instead,
+* the esbuild instrumentation plugin (`tools/instrumentation-plugin`) injects
+* it at build time: any exported function annotated with `@instrumented` in its
+* JSDoc is automatically wrapped by the plugin during the build step.
+* The plugin strips the original `export`, renames the function, and re-exports
+* it under the original name via `instrumentFunction(...)` — so the public API
+* is unchanged and no call sites need to be updated.
+*
+* ## Opting out
+*
+* Instrumentation is skipped entirely when:
+* - `getCore()` returns `undefined` (SDK not initialised), or
+* - `core.instrumentation.config.enabled` is `false`.
+*
+* In both cases the original function is called directly with no overhead.
+*
+* ## PII scrubbing
+*
+* All string values whose key appears in `piiFields` are replaced with
+* `"[redacted]"` before events are emitted. Pass `redactAll: true` to redact
+* every field, regardless of key name.
+* @notInstrumented
 */
-const getWalletProviderRegistry = createRuntimeServiceAccessKey("walletProviderRegistry", (client) => createWalletProviderRegistry(client));
-
-//#endregion
-//#region src/modules/wallets/walletProviderRegistry/walletProviderRegistry.types.ts
-let WalletProviderPriority = /* @__PURE__ */ function(WalletProviderPriority$1) {
-	/**
-	* Highest priority should be used by wallet providers that implement
-	* the most reliable wallet integration.
-	* example: The SDK provided by the wallet provider.
-	*/
-	WalletProviderPriority$1[WalletProviderPriority$1["WALLET_SDK"] = 100] = "WALLET_SDK";
-	/**
-	* Medium priority should be used by wallet providers that implement
-	* a wallet integration via some reliable standard.
-	* example: A wallet provider that uses EIP6963 announcement.
-	*/
-	WalletProviderPriority$1[WalletProviderPriority$1["WALLET_SELF_ANNOUNCEMENT_STANDARD"] = 50] = "WALLET_SELF_ANNOUNCEMENT_STANDARD";
-	/**
-	* Low priority should be used by wallet providers that implement
-	* a wallet integration on a less reliable standard.
-	* example: A wallet provider that uses window.ethereum, where the
-	* window key can be overridden by other extensions.
-	*/
-	WalletProviderPriority$1[WalletProviderPriority$1["WINDOW_INJECT"] = 20] = "WINDOW_INJECT";
-	return WalletProviderPriority$1;
-}({});
-
-//#endregion
-//#region src/modules/wallets/utils/getWalletProviderFromWalletAccount/getWalletProviderFromWalletAccount.ts
-/** @not-instrumented */
-const getWalletProviderFromWalletAccount = ({ walletAccount }, client) => {
-	const walletProvider = getWalletProviderRegistry(client).getByKey(walletAccount.walletProviderKey);
-	if (!walletProvider) throw new NoWalletProviderFoundError({ walletProviderKey: walletAccount.walletProviderKey });
-	return walletProvider;
+const instrumentFunction = ({ fn, functionName, getCore: getCore$1, redactAll }) => {
+	const wrapped = (...args) => {
+		const core = getCore$1();
+		if (!core) return fn(...args);
+		if (!core.instrumentation.config.enabled) return fn(...args);
+		const instrumentation = core.instrumentation;
+		const state = core.state.get();
+		const baseEvent = {
+			environmentId: core.environmentId,
+			functionName,
+			operatingSystem: getOperatingSystem(),
+			parameters: scrubParameters({
+				piiFields: instrumentation.config.piiFields,
+				redactAll,
+				value: extractParams(args)
+			}),
+			platform: getPlatform(),
+			registeredExtensionKeys: Array.from(core.extensions),
+			sdkSessionId: core.sdkSessionId,
+			sdkVersion: core.version,
+			status: "info",
+			tokenSessionId: state.token ? extractSessionId(state.token) : null,
+			userAgent: getUserAgent(),
+			userId: state.user?.id ?? null
+		};
+		instrumentation.logFunction({
+			...baseEvent,
+			phase: "started",
+			timestamp: (/* @__PURE__ */ new Date()).toISOString()
+		});
+		try {
+			const result = fn(...args);
+			if (result instanceof Promise) return result.then((value) => {
+				instrumentation.logFunction({
+					...baseEvent,
+					phase: "resolved",
+					resolvedValue: scrubResolvedValue({
+						piiFields: instrumentation.config.piiFields,
+						redactAll,
+						value
+					}),
+					timestamp: (/* @__PURE__ */ new Date()).toISOString()
+				});
+				return value;
+			}).catch((error) => {
+				instrumentation.logFunction({
+					...baseEvent,
+					phase: "rejected",
+					rejectedError: serializeError(error),
+					timestamp: (/* @__PURE__ */ new Date()).toISOString()
+				});
+				throw error;
+			});
+			instrumentation.logFunction({
+				...baseEvent,
+				phase: "resolved",
+				resolvedValue: scrubResolvedValue({
+					piiFields: instrumentation.config.piiFields,
+					redactAll,
+					value: result
+				}),
+				timestamp: (/* @__PURE__ */ new Date()).toISOString()
+			});
+			return result;
+		} catch (error) {
+			instrumentation.logFunction({
+				...baseEvent,
+				phase: "rejected",
+				rejectedError: serializeError(error),
+				timestamp: (/* @__PURE__ */ new Date()).toISOString()
+			});
+			throw error;
+		}
+	};
+	return wrapped;
 };
 
-//#endregion
-//#region src/modules/auth/consts.ts
-const DYNAMIC_AUTH_COOKIE_NAME = "DYNAMIC_JWT_TOKEN";
-
 //#endregion
 //#region src/constants.ts
 const SDK_API_CORE_VERSION = dependencies["@dynamic-labs/sdk-api-core"];
@@ -1634,7 +1624,7 @@ const DYNAMIC_ICONIC_SPRITE_URL = "https://iconic.dynamic-static-assets.com/icon
 *
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns True if the user needs additional MFA authentication, false otherwise.
-* @not-instrumented
+* @notInstrumented
 */
 const isUserMissingMfaAuth = (client = getDefaultClient()) => {
 	const user = client.user;
@@ -1654,7 +1644,7 @@ const DYNAMIC_WAAS_METADATA = {
 
 //#endregion
 //#region src/modules/waas/isWaasWalletProvider/isWaasWalletProvider.ts
-/** @not-instrumented */
+/** @notInstrumented */
 const isWaasWalletProvider = (walletProvider) => {
 	return walletProvider.key.includes(DYNAMIC_WAAS_METADATA.normalizedWalletName);
 };
@@ -1674,5 +1664,5 @@ var InvalidParamError = class extends BaseError {
 };
 
 //#endregion
-export { getOperatingSystem as $, fetchAndStoreNonces as A, LinkCredentialError as B, splitWalletProviderKey as C, onEvent as D, offEvent as E, getDeviceSigner as F, assertDefined as G, APIError as H, getNonce as I, instrumentFunction as J, ValueMustBeDefinedError as K, SandboxMaximumThresholdReachedError as L, UnauthorizedError as M, createDeviceSignatureHeadersMiddleware as N, onceEvent as O, getHeadersForNonceSignedByDeviceSigners as P, getPlatform as Q, MfaRateLimitedError as R, normalizeAddress as S, emitEvent as T, getSessionKeys as U, InvalidExternalAuthError as V, isCookieEnabled as W, DEFAULT_PII_FIELDS as X, scrubParameters as Y, getUserAgent as Z, formatWalletProviderKey as _, DYNAMIC_WAAS_METADATA as a, getDefaultClient as at, CHAINS_INFO_MAP as b, SDK_API_CORE_VERSION as c, BaseError as ct, WalletProviderPriority as d, version as dt, extractSessionId as et, getWalletProviderRegistry as f, getWalletAccountsFromState as g, getWalletAccounts as h, DEFAULT_WAAS_BASE_MPC_RELAY_API_URL as i, NONCE_POOL_SIZE as it, createApiClient as j, setCookie as k, DYNAMIC_AUTH_COOKIE_NAME as l, getCore as lt, NoWalletProviderFoundError as m, isWaasWalletProvider as n, CLIENT_SDK_NAME as nt, isUserMissingMfaAuth as o, setDefaultClient as ot, createRuntimeServiceAccessKey as p, __getElevatedAccessToken_wrapped as q, DEFAULT_WAAS_BASE_API_URL as r, DYNAMIC_SDK_API_VERSION as rt, DYNAMIC_ICONIC_SPRITE_URL as s, ClientNotFoundError as st, InvalidParamError as t, randomString as tt, getWalletProviderFromWalletAccount as u, name as ut, normalizeWalletNameWithChain as v, InvalidWalletProviderKeyError as w, formatWalletAccountId as x, getChainFromVerifiedCredentialChain as y, MfaInvalidOtpError as z };
-//# sourceMappingURL=InvalidParamError-B0nAZ6Ei.esm.js.map
+export { ValueMustBeDefinedError as $, splitWalletProviderKey as A, createDeviceSignatureHeadersMiddleware as B, getWalletAccountsFromState as C, CHAINS_INFO_MAP as D, getChainFromVerifiedCredentialChain as E, onceEvent as F, MfaRateLimitedError as G, getDeviceSigner as H, setCookie as I, InvalidExternalAuthError as J, MfaInvalidOtpError as K, fetchAndStoreNonces as L, emitEvent as M, offEvent as N, formatWalletAccountId as O, onEvent as P, assertDefined as Q, createApiClient as R, getWalletAccounts as S, normalizeWalletNameWithChain as T, getNonce as U, getHeadersForNonceSignedByDeviceSigners as V, SandboxMaximumThresholdReachedError as W, getSessionKeys as X, APIError as Y, isCookieEnabled as Z, getWalletProviderFromWalletAccount as _, DYNAMIC_WAAS_METADATA as a, getDefaultClient as at, createRuntimeServiceAccessKey as b, SDK_API_CORE_VERSION as c, BaseError as ct, DEFAULT_PII_FIELDS as d, version as dt, getElevatedAccessToken as et, getUserAgent as f, DYNAMIC_AUTH_COOKIE_NAME as g, extractSessionId as h, DEFAULT_WAAS_BASE_MPC_RELAY_API_URL as i, NONCE_POOL_SIZE as it, InvalidWalletProviderKeyError as j, normalizeAddress as k, instrumentFunction as l, getCore as lt, getOperatingSystem as m, isWaasWalletProvider as n, CLIENT_SDK_NAME as nt, isUserMissingMfaAuth as o, setDefaultClient as ot, getPlatform as p, LinkCredentialError as q, DEFAULT_WAAS_BASE_API_URL as r, DYNAMIC_SDK_API_VERSION as rt, DYNAMIC_ICONIC_SPRITE_URL as s, ClientNotFoundError as st, InvalidParamError as t, randomString as tt, scrubParameters as u, name as ut, WalletProviderPriority as v, formatWalletProviderKey as w, NoWalletProviderFoundError as x, getWalletProviderRegistry as y, UnauthorizedError as z };
+//# sourceMappingURL=InvalidParamError-DZjc7Tjc.esm.js.map