@openzeppelin/ui-react 3.1.0 → 3.2.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react0 from "react";
 import React, { Context, ReactNode } from "react";
-import { BaseComponentProps, Connector, EcosystemRuntime, EcosystemSpecificReactHooks, EcosystemWalletComponents, NameResolutionError, NameResolver, NativeConfigLoader, NetworkCatalogCapability, NetworkConfig, ResolvedAddress, ResolvedName, RuntimeCapability, UiKitConfiguration, WalletCapability } from "@openzeppelin/ui-types";
+import { BaseComponentProps, Connector, CreateRuntimeOptions, EcosystemExport, EcosystemRuntime, EcosystemSpecificReactHooks, EcosystemWalletComponents, NameResolutionError, NameResolutionRuntimeOptions, NameResolver, NativeConfigLoader, NetworkCatalogCapability, NetworkConfig, ProfileName, ResolvedAddress, ResolvedName, RuntimeCapability, UiKitConfiguration, WalletCapability } from "@openzeppelin/ui-types";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 import { QueryClient } from "@tanstack/react-query";
 
@@ -624,6 +624,41 @@ declare function useNameResolutionContext(): NameResolutionContextValue;
  */
 declare function useRuntimeNameResolver(): NameResolver;
 //#endregion
+//#region src/hooks/runtime/runtimeCreationConfig.d.ts
+/** Safe default: miss-fallback OFF; no uiKit override. INV-204 */
+declare const DEFAULT_RUNTIME_CREATION_CONFIG: CreateRuntimeOptions;
+/**
+ * Normalizes the opt-in flag to the adapter's strict-enable contract.
+ * UIKit uses this at the threading boundary so `false` and `undefined` never
+ * emit `enableMainnetL1MissFallback: false` into adapter options (absent = OFF).
+ */
+declare function isMainnetL1MissFallbackEnabled(options?: NameResolutionRuntimeOptions): boolean;
+//#endregion
+//#region src/hooks/runtime/createResolveRuntime.d.ts
+interface ResolveRuntimeParams {
+  readonly profile: ProfileName;
+  /** Merged over {@link DEFAULT_RUNTIME_CREATION_CONFIG} per field. */
+  readonly options?: CreateRuntimeOptions;
+}
+type ResolveRuntimeFn = (networkConfig: NetworkConfig) => Promise<EcosystemRuntime>;
+/**
+ * Build a `resolveRuntime` callback for {@link RuntimeProvider} that forwards
+ * `CreateRuntimeOptions` to `ecosystemDefinition.createRuntime`.
+ *
+ * Does not cache — {@link RuntimeProvider} owns the per-network singleton registry.
+ */
+declare function createResolveRuntime(ecosystemDefinition: EcosystemExport, params: ResolveRuntimeParams): ResolveRuntimeFn;
+//#endregion
+//#region src/hooks/runtime/useResolveRuntime.d.ts
+/**
+ * Memoized {@link createResolveRuntime} for React apps. Recompute when
+ * `ecosystemDefinition`, `profile`, or opt-in posture change (INV-217, INV-222).
+ *
+ * Changing the returned function identity MUST trigger runtime registry flush
+ * in {@link RuntimeProvider} (INV-218).
+ */
+declare function useResolveRuntime(ecosystemDefinition: EcosystemExport, params: ResolveRuntimeParams): ResolveRuntimeFn;
+//#endregion
 //#region src/components/WalletConnectionHeader.d.ts
 /**
  * Component that renders the wallet connection UI.
@@ -699,5 +734,5 @@ interface NetworkSwitchManagerProps {
  */
 declare const NetworkSwitchManager: React.FC<NetworkSwitchManagerProps>;
 //#endregion
-export { AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, DEFAULT_CONFIG, type DerivedAccountStatus, type DerivedChainInfo, type DerivedConnectStatus, type DerivedDisconnectStatus, type DerivedSwitchChainStatus, NameResolutionContext, type NameResolutionContextValue, NameResolutionProvider, type NameResolutionProviderProps, type NameResolutionStatus, NetworkSwitchManager, type NetworkSwitchManagerProps, type ResolutionConfig, RuntimeContext, type RuntimeContextValue, RuntimeProvider, type RuntimeProviderProps, type RuntimeRegistry, type UseResolveAddressOptions, type UseResolveAddressResult, type UseResolveNameOptions, type UseResolveNameResult, VERSION, WalletConnectionHeader, WalletConnectionUI, type WalletConnectionUIProps, WalletStateContext, type WalletStateContextValue, WalletStateProvider, type WalletStateProviderProps, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useNameResolutionContext, useResolveAddress, useResolveName, useRuntimeContext, useRuntimeNameResolver, useWalletComponents, useWalletReconnectionHandler, useWalletState };
+export { AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, DEFAULT_CONFIG, DEFAULT_RUNTIME_CREATION_CONFIG, type DerivedAccountStatus, type DerivedChainInfo, type DerivedConnectStatus, type DerivedDisconnectStatus, type DerivedSwitchChainStatus, NameResolutionContext, type NameResolutionContextValue, NameResolutionProvider, type NameResolutionProviderProps, type NameResolutionStatus, NetworkSwitchManager, type NetworkSwitchManagerProps, type ResolutionConfig, type ResolveRuntimeFn, type ResolveRuntimeParams, RuntimeContext, type RuntimeContextValue, RuntimeProvider, type RuntimeProviderProps, type RuntimeRegistry, type UseResolveAddressOptions, type UseResolveAddressResult, type UseResolveNameOptions, type UseResolveNameResult, VERSION, WalletConnectionHeader, WalletConnectionUI, type WalletConnectionUIProps, WalletStateContext, type WalletStateContextValue, WalletStateProvider, type WalletStateProviderProps, createResolveRuntime, isMainnetL1MissFallbackEnabled, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useNameResolutionContext, useResolveAddress, useResolveName, useResolveRuntime, useRuntimeContext, useRuntimeNameResolver, useWalletComponents, useWalletReconnectionHandler, useWalletState };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/version.ts","../src/hooks/AdapterContext.tsx","../src/hooks/AdapterProvider.tsx","../src/hooks/WalletStateContext.ts","../src/hooks/WalletStateProvider.tsx","../src/hooks/AnalyticsContext.tsx","../src/hooks/AnalyticsProvider.tsx","../src/hooks/useAnalytics.ts","../src/hooks/useAdapterContext.ts","../src/hooks/useWalletComponents.ts","../src/hooks/useDerivedAccountStatus.ts","../src/hooks/useDerivedSwitchChainStatus.ts","../src/hooks/useDerivedChainInfo.ts","../src/hooks/useDerivedConnectStatus.ts","../src/hooks/useDerivedDisconnect.ts","../src/hooks/useWalletReconnectionHandler.ts","../src/hooks/nameResolution/resolutionState.ts","../src/hooks/nameResolution/useResolveName.ts","../src/hooks/nameResolution/useResolveAddress.ts","../src/hooks/nameResolution/resolutionConfig.ts","../src/hooks/nameResolution/NameResolutionProvider.tsx","../src/hooks/nameResolution/NameResolutionContext.ts","../src/hooks/nameResolution/useRuntimeNameResolver.ts","../src/components/WalletConnectionHeader.tsx","../src/components/WalletConnectionUI.tsx","../src/components/NetworkSwitchManager.tsx"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/version.ts","../src/hooks/AdapterContext.tsx","../src/hooks/AdapterProvider.tsx","../src/hooks/WalletStateContext.ts","../src/hooks/WalletStateProvider.tsx","../src/hooks/AnalyticsContext.tsx","../src/hooks/AnalyticsProvider.tsx","../src/hooks/useAnalytics.ts","../src/hooks/useAdapterContext.ts","../src/hooks/useWalletComponents.ts","../src/hooks/useDerivedAccountStatus.ts","../src/hooks/useDerivedSwitchChainStatus.ts","../src/hooks/useDerivedChainInfo.ts","../src/hooks/useDerivedConnectStatus.ts","../src/hooks/useDerivedDisconnect.ts","../src/hooks/useWalletReconnectionHandler.ts","../src/hooks/nameResolution/resolutionState.ts","../src/hooks/nameResolution/useResolveName.ts","../src/hooks/nameResolution/useResolveAddress.ts","../src/hooks/nameResolution/resolutionConfig.ts","../src/hooks/nameResolution/NameResolutionProvider.tsx","../src/hooks/nameResolution/NameResolutionContext.ts","../src/hooks/nameResolution/useRuntimeNameResolver.ts","../src/hooks/runtime/runtimeCreationConfig.ts","../src/hooks/runtime/createResolveRuntime.ts","../src/hooks/runtime/useResolveRuntime.ts","../src/components/WalletConnectionHeader.tsx","../src/components/WalletConnectionUI.tsx","../src/components/NetworkSwitchManager.tsx"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import * as react0 from "react";
 import React, { Context, ReactNode } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 import { QueryClient } from "@tanstack/react-query";
-import { BaseComponentProps, Connector, EcosystemRuntime, EcosystemSpecificReactHooks, EcosystemWalletComponents, NameResolutionError, NameResolver, NativeConfigLoader, NetworkCatalogCapability, NetworkConfig, ResolvedAddress, ResolvedName, RuntimeCapability, UiKitConfiguration, WalletCapability } from "@openzeppelin/ui-types";
+import { BaseComponentProps, Connector, CreateRuntimeOptions, EcosystemExport, EcosystemRuntime, EcosystemSpecificReactHooks, EcosystemWalletComponents, NameResolutionError, NameResolutionRuntimeOptions, NameResolver, NativeConfigLoader, NetworkCatalogCapability, NetworkConfig, ProfileName, ResolvedAddress, ResolvedName, RuntimeCapability, UiKitConfiguration, WalletCapability } from "@openzeppelin/ui-types";
 
 //#region src/version.d.ts
 declare const VERSION: string;
@@ -624,6 +624,41 @@ declare function useNameResolutionContext(): NameResolutionContextValue;
  */
 declare function useRuntimeNameResolver(): NameResolver;
 //#endregion
+//#region src/hooks/runtime/runtimeCreationConfig.d.ts
+/** Safe default: miss-fallback OFF; no uiKit override. INV-204 */
+declare const DEFAULT_RUNTIME_CREATION_CONFIG: CreateRuntimeOptions;
+/**
+ * Normalizes the opt-in flag to the adapter's strict-enable contract.
+ * UIKit uses this at the threading boundary so `false` and `undefined` never
+ * emit `enableMainnetL1MissFallback: false` into adapter options (absent = OFF).
+ */
+declare function isMainnetL1MissFallbackEnabled(options?: NameResolutionRuntimeOptions): boolean;
+//#endregion
+//#region src/hooks/runtime/createResolveRuntime.d.ts
+interface ResolveRuntimeParams {
+  readonly profile: ProfileName;
+  /** Merged over {@link DEFAULT_RUNTIME_CREATION_CONFIG} per field. */
+  readonly options?: CreateRuntimeOptions;
+}
+type ResolveRuntimeFn = (networkConfig: NetworkConfig) => Promise<EcosystemRuntime>;
+/**
+ * Build a `resolveRuntime` callback for {@link RuntimeProvider} that forwards
+ * `CreateRuntimeOptions` to `ecosystemDefinition.createRuntime`.
+ *
+ * Does not cache — {@link RuntimeProvider} owns the per-network singleton registry.
+ */
+declare function createResolveRuntime(ecosystemDefinition: EcosystemExport, params: ResolveRuntimeParams): ResolveRuntimeFn;
+//#endregion
+//#region src/hooks/runtime/useResolveRuntime.d.ts
+/**
+ * Memoized {@link createResolveRuntime} for React apps. Recompute when
+ * `ecosystemDefinition`, `profile`, or opt-in posture change (INV-217, INV-222).
+ *
+ * Changing the returned function identity MUST trigger runtime registry flush
+ * in {@link RuntimeProvider} (INV-218).
+ */
+declare function useResolveRuntime(ecosystemDefinition: EcosystemExport, params: ResolveRuntimeParams): ResolveRuntimeFn;
+//#endregion
 //#region src/components/WalletConnectionHeader.d.ts
 /**
  * Component that renders the wallet connection UI.
@@ -699,5 +734,5 @@ interface NetworkSwitchManagerProps {
  */
 declare const NetworkSwitchManager: React.FC<NetworkSwitchManagerProps>;
 //#endregion
-export { AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, DEFAULT_CONFIG, type DerivedAccountStatus, type DerivedChainInfo, type DerivedConnectStatus, type DerivedDisconnectStatus, type DerivedSwitchChainStatus, NameResolutionContext, type NameResolutionContextValue, NameResolutionProvider, type NameResolutionProviderProps, type NameResolutionStatus, NetworkSwitchManager, type NetworkSwitchManagerProps, type ResolutionConfig, RuntimeContext, type RuntimeContextValue, RuntimeProvider, type RuntimeProviderProps, type RuntimeRegistry, type UseResolveAddressOptions, type UseResolveAddressResult, type UseResolveNameOptions, type UseResolveNameResult, VERSION, WalletConnectionHeader, WalletConnectionUI, type WalletConnectionUIProps, WalletStateContext, type WalletStateContextValue, WalletStateProvider, type WalletStateProviderProps, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useNameResolutionContext, useResolveAddress, useResolveName, useRuntimeContext, useRuntimeNameResolver, useWalletComponents, useWalletReconnectionHandler, useWalletState };
+export { AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, DEFAULT_CONFIG, DEFAULT_RUNTIME_CREATION_CONFIG, type DerivedAccountStatus, type DerivedChainInfo, type DerivedConnectStatus, type DerivedDisconnectStatus, type DerivedSwitchChainStatus, NameResolutionContext, type NameResolutionContextValue, NameResolutionProvider, type NameResolutionProviderProps, type NameResolutionStatus, NetworkSwitchManager, type NetworkSwitchManagerProps, type ResolutionConfig, type ResolveRuntimeFn, type ResolveRuntimeParams, RuntimeContext, type RuntimeContextValue, RuntimeProvider, type RuntimeProviderProps, type RuntimeRegistry, type UseResolveAddressOptions, type UseResolveAddressResult, type UseResolveNameOptions, type UseResolveNameResult, VERSION, WalletConnectionHeader, WalletConnectionUI, type WalletConnectionUIProps, WalletStateContext, type WalletStateContextValue, WalletStateProvider, type WalletStateProviderProps, createResolveRuntime, isMainnetL1MissFallbackEnabled, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useNameResolutionContext, useResolveAddress, useResolveName, useResolveRuntime, useRuntimeContext, useRuntimeNameResolver, useWalletComponents, useWalletReconnectionHandler, useWalletState };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/version.ts","../src/hooks/AdapterContext.tsx","../src/hooks/AdapterProvider.tsx","../src/hooks/WalletStateContext.ts","../src/hooks/WalletStateProvider.tsx","../src/hooks/AnalyticsContext.tsx","../src/hooks/AnalyticsProvider.tsx","../src/hooks/useAnalytics.ts","../src/hooks/useAdapterContext.ts","../src/hooks/useWalletComponents.ts","../src/hooks/useDerivedAccountStatus.ts","../src/hooks/useDerivedSwitchChainStatus.ts","../src/hooks/useDerivedChainInfo.ts","../src/hooks/useDerivedConnectStatus.ts","../src/hooks/useDerivedDisconnect.ts","../src/hooks/useWalletReconnectionHandler.ts","../src/hooks/nameResolution/resolutionState.ts","../src/hooks/nameResolution/useResolveName.ts","../src/hooks/nameResolution/useResolveAddress.ts","../src/hooks/nameResolution/resolutionConfig.ts","../src/hooks/nameResolution/NameResolutionProvider.tsx","../src/hooks/nameResolution/NameResolutionContext.ts","../src/hooks/nameResolution/useRuntimeNameResolver.ts","../src/components/WalletConnectionHeader.tsx","../src/components/WalletConnectionUI.tsx","../src/components/NetworkSwitchManager.tsx"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/version.ts","../src/hooks/AdapterContext.tsx","../src/hooks/AdapterProvider.tsx","../src/hooks/WalletStateContext.ts","../src/hooks/WalletStateProvider.tsx","../src/hooks/AnalyticsContext.tsx","../src/hooks/AnalyticsProvider.tsx","../src/hooks/useAnalytics.ts","../src/hooks/useAdapterContext.ts","../src/hooks/useWalletComponents.ts","../src/hooks/useDerivedAccountStatus.ts","../src/hooks/useDerivedSwitchChainStatus.ts","../src/hooks/useDerivedChainInfo.ts","../src/hooks/useDerivedConnectStatus.ts","../src/hooks/useDerivedDisconnect.ts","../src/hooks/useWalletReconnectionHandler.ts","../src/hooks/nameResolution/resolutionState.ts","../src/hooks/nameResolution/useResolveName.ts","../src/hooks/nameResolution/useResolveAddress.ts","../src/hooks/nameResolution/resolutionConfig.ts","../src/hooks/nameResolution/NameResolutionProvider.tsx","../src/hooks/nameResolution/NameResolutionContext.ts","../src/hooks/nameResolution/useRuntimeNameResolver.ts","../src/hooks/runtime/runtimeCreationConfig.ts","../src/hooks/runtime/createResolveRuntime.ts","../src/hooks/runtime/useResolveRuntime.ts","../src/components/WalletConnectionHeader.tsx","../src/components/WalletConnectionUI.tsx","../src/components/NetworkSwitchManager.tsx"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -5,7 +5,7 @@ import { QueryClient, useQuery } from "@tanstack/react-query";
 import { Button } from "@openzeppelin/ui-components";
 
 //#region src/version.ts
-const VERSION = "3.1.0";
+const VERSION = "3.2.0";
 
 //#endregion
 //#region src/hooks/AdapterContext.tsx
@@ -58,11 +58,31 @@ function RuntimeProvider({ children, resolveRuntime }) {
 	const [loadingNetworks, setLoadingNetworks] = useState(/* @__PURE__ */ new Set());
 	const runtimeRegistryRef = useRef(runtimeRegistry);
 	const failedNetworksRef = useRef(/* @__PURE__ */ new Set());
+	const resolverGenerationRef = useRef(0);
+	const resolverInitializedRef = useRef(false);
 	useEffect(() => {
 		runtimeRegistryRef.current = runtimeRegistry;
 	}, [runtimeRegistry]);
 	useEffect(() => {
+		if (resolverInitializedRef.current) resolverGenerationRef.current += 1;
+		else resolverInitializedRef.current = true;
+		const registry = runtimeRegistryRef.current;
+		const runtimes = Object.values(registry);
+		const hadCachedRuntimes = runtimes.length > 0;
 		failedNetworksRef.current = /* @__PURE__ */ new Set();
+		setLoadingNetworks(/* @__PURE__ */ new Set());
+		if (hadCachedRuntimes) {
+			setRuntimeRegistry({});
+			setTimeout(() => {
+				runtimes.forEach((runtime) => {
+					try {
+						runtime.dispose();
+					} catch (error) {
+						logger.error("RuntimeProvider", "Error disposing runtime during registry flush:", error);
+					}
+				});
+			}, 0);
+		}
 	}, [resolveRuntime]);
 	useEffect(() => {
 		return () => {
@@ -150,7 +170,23 @@ function RuntimeProvider({ children, resolveRuntime }) {
 			return newSet;
 		});
 		logger.info("RuntimeProvider", `Starting runtime initialization for network ${networkId} (${networkConfig.name})`);
+		const generation = resolverGenerationRef.current;
 		resolveRuntime(networkConfig).then((runtime) => {
+			if (generation !== resolverGenerationRef.current) {
+				setTimeout(() => {
+					try {
+						runtime.dispose();
+					} catch (error) {
+						logger.error("RuntimeProvider", `Error disposing stale runtime for network ${networkId}:`, error);
+					}
+				}, 0);
+				setLoadingNetworks((prev) => {
+					const newSet = new Set(prev);
+					newSet.delete(networkId);
+					return newSet;
+				});
+				return;
+			}
 			logger.info("RuntimeProvider", `Runtime for network ${networkId} loaded successfully`, {
 				type: runtime.constructor.name,
 				objectId: Object.prototype.toString.call(runtime)
@@ -165,6 +201,14 @@ function RuntimeProvider({ children, resolveRuntime }) {
 				return newSet;
 			});
 		}).catch((error) => {
+			if (generation !== resolverGenerationRef.current) {
+				setLoadingNetworks((prev) => {
+					const newSet = new Set(prev);
+					newSet.delete(networkId);
+					return newSet;
+				});
+				return;
+			}
 			logger.error("RuntimeProvider", `Error loading runtime for network ${networkId}:`, error);
 			failedNetworksRef.current.add(networkId);
 			setLoadingNetworks((prev) => {
@@ -893,22 +937,42 @@ const DEFAULT_CONFIG = {
 };
 /** Stable prefix for every resolution cache key — namespaces this package's keys. */
 const RESOLUTION_KEY_PREFIX = "oz-name-resolution";
+const runtimeInstanceIds = /* @__PURE__ */ new WeakMap();
+let nextRuntimeInstanceId = 1;
+/**
+* Assign a stable, serializable id to each {@link EcosystemRuntime} object identity.
+* A disposed-and-recreated runtime (e.g. SF-4 opt-in toggle after INV-218 flush) gets
+* a new id so resolution cache keys miss and results refresh (INV-230).
+*/
+function getRuntimeInstanceId(runtime) {
+	if (!runtime) return 0;
+	let id = runtimeInstanceIds.get(runtime);
+	if (id === void 0) {
+		id = nextRuntimeInstanceId;
+		nextRuntimeInstanceId += 1;
+		runtimeInstanceIds.set(runtime, id);
+	}
+	return id;
+}
 /**
 * Build a network-scoped, namespace-separated cache key (INV-40). A name resolves
 * differently per network and provenance can be chain-scoped, so `networkId` is
-* part of the key; `namespace` keeps forward and reverse lookups disjoint.
+* part of the key; `namespace` keeps forward and reverse lookups disjoint;
+* `runtimeInstanceId` scopes entries to the active capability instance (INV-230).
 *
-* @param namespace       - `'name'` (forward) or `'addr'` (reverse).
-* @param networkId       - Active network id (`''` when no network is selected).
-* @param normalizedInput - Trimmed + lowercased input (INV-26).
+* @param namespace           - `'name'` (forward) or `'addr'` (reverse).
+* @param networkId           - Active network id (`''` when no network is selected).
+* @param normalizedInput     - Trimmed + lowercased input (INV-26).
+* @param runtimeInstanceId   - Active runtime instance discriminator (`0` when absent).
 * @returns A readonly tuple suitable for a TanStack Query `queryKey`.
 */
-function buildResolutionKey(namespace, networkId, normalizedInput) {
+function buildResolutionKey(namespace, networkId, normalizedInput, runtimeInstanceId = 0) {
 	return [
 		RESOLUTION_KEY_PREFIX,
 		namespace,
 		networkId,
-		normalizedInput
+		normalizedInput,
+		runtimeInstanceId
 	];
 }
 /**
@@ -1107,12 +1171,13 @@ function useResolutionEngine(params) {
 	const normalizedKey = effectiveTrimmed.toLowerCase();
 	const capability = activeRuntime?.nameResolution;
 	const networkId = activeNetworkId ?? "";
+	const runtimeInstanceId = getRuntimeInstanceId(activeRuntime);
 	const method = capability ? getMethod(capability) : void 0;
 	const liveAttemptable = capability ? shouldAttempt(capability, normalizedLive) : false;
 	const keyAttemptable = capability ? shouldAttempt(capability, normalizedKey) : false;
 	const queryEnabled = enabled && trimmedLive !== "" && capability != null && method != null && normalizedKey !== "" && keyAttemptable;
 	const query = useQuery({
-		queryKey: buildResolutionKey(namespace, networkId, normalizedKey),
+		queryKey: buildResolutionKey(namespace, networkId, normalizedKey, runtimeInstanceId),
 		queryFn: async () => {
 			if (!method) throw new ResolutionQueryError({
 				code: "ADAPTER_ERROR",
@@ -1359,8 +1424,10 @@ const EMPTY_RESOLVER = {};
 function useRuntimeNameResolver() {
 	const walletState = useContext(WalletStateContext);
 	const { queryClient, config } = useNameResolutionContext();
-	const capability = walletState?.activeRuntime?.nameResolution;
+	const activeRuntime = walletState?.activeRuntime ?? null;
+	const capability = activeRuntime?.nameResolution;
 	const networkId = walletState?.activeNetworkId ?? "";
+	const runtimeInstanceId = getRuntimeInstanceId(activeRuntime);
 	return useMemo(() => {
 		if (!capability) return EMPTY_RESOLVER;
 		const resolveNameMethod = capability.resolveName;
@@ -1372,7 +1439,7 @@ function useRuntimeNameResolver() {
 					return {
 						ok: true,
 						value: await queryClient.fetchQuery({
-							queryKey: buildResolutionKey("name", networkId, normalized),
+							queryKey: buildResolutionKey("name", networkId, normalized, runtimeInstanceId),
 							queryFn: async () => {
 								let result;
 								try {
@@ -1404,7 +1471,73 @@ function useRuntimeNameResolver() {
 		capability,
 		queryClient,
 		config,
-		networkId
+		networkId,
+		runtimeInstanceId
+	]);
+}
+
+//#endregion
+//#region src/hooks/runtime/runtimeCreationConfig.ts
+/** Safe default: miss-fallback OFF; no uiKit override. INV-204 */
+const DEFAULT_RUNTIME_CREATION_CONFIG = {};
+/**
+* Normalizes the opt-in flag to the adapter's strict-enable contract.
+* UIKit uses this at the threading boundary so `false` and `undefined` never
+* emit `enableMainnetL1MissFallback: false` into adapter options (absent = OFF).
+*/
+function isMainnetL1MissFallbackEnabled(options) {
+	return options?.enableMainnetL1MissFallback === true;
+}
+/**
+* Builds the `createRuntime` options bag for adapter threading.
+* When OFF, `nameResolution` is omitted (INV-207). When ON, spreads only
+* `{ enableMainnetL1MissFallback: true }` (INV-208).
+*/
+function buildCreateRuntimeOptions(options) {
+	return {
+		...options?.uiKit !== void 0 ? { uiKit: options.uiKit } : {},
+		...isMainnetL1MissFallbackEnabled(options?.nameResolution) ? { nameResolution: { enableMainnetL1MissFallback: true } } : {}
+	};
+}
+
+//#endregion
+//#region src/hooks/runtime/createResolveRuntime.ts
+/**
+* Build a `resolveRuntime` callback for {@link RuntimeProvider} that forwards
+* `CreateRuntimeOptions` to `ecosystemDefinition.createRuntime`.
+*
+* Does not cache — {@link RuntimeProvider} owns the per-network singleton registry.
+*/
+function createResolveRuntime(ecosystemDefinition, params) {
+	const { profile, options } = params;
+	const mergedOptions = buildCreateRuntimeOptions(options);
+	return (networkConfig) => Promise.resolve(ecosystemDefinition.createRuntime(profile, networkConfig, mergedOptions));
+}
+
+//#endregion
+//#region src/hooks/runtime/useResolveRuntime.ts
+/**
+* Memoized {@link createResolveRuntime} for React apps. Recompute when
+* `ecosystemDefinition`, `profile`, or opt-in posture change (INV-217, INV-222).
+*
+* Changing the returned function identity MUST trigger runtime registry flush
+* in {@link RuntimeProvider} (INV-218).
+*/
+function useResolveRuntime(ecosystemDefinition, params) {
+	const { profile, options } = params;
+	const uiKit = options?.uiKit;
+	const enableMainnetL1MissFallback = options?.nameResolution?.enableMainnetL1MissFallback;
+	return useMemo(() => createResolveRuntime(ecosystemDefinition, {
+		profile,
+		options: {
+			...uiKit !== void 0 ? { uiKit } : {},
+			...enableMainnetL1MissFallback === true ? { nameResolution: { enableMainnetL1MissFallback: true } } : {}
+		}
+	}), [
+		ecosystemDefinition,
+		profile,
+		uiKit,
+		enableMainnetL1MissFallback
 	]);
 }
 
@@ -1615,5 +1748,5 @@ const NetworkSwitchManager = ({ wallet, networkCatalog, targetNetworkId, onNetwo
 };
 
 //#endregion
-export { AnalyticsContext, AnalyticsProvider, DEFAULT_CONFIG, NameResolutionContext, NameResolutionProvider, NetworkSwitchManager, RuntimeContext, RuntimeProvider, VERSION, WalletConnectionHeader, WalletConnectionUI, WalletStateContext, WalletStateProvider, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useNameResolutionContext, useResolveAddress, useResolveName, useRuntimeContext, useRuntimeNameResolver, useWalletComponents, useWalletReconnectionHandler, useWalletState };
+export { AnalyticsContext, AnalyticsProvider, DEFAULT_CONFIG, DEFAULT_RUNTIME_CREATION_CONFIG, NameResolutionContext, NameResolutionProvider, NetworkSwitchManager, RuntimeContext, RuntimeProvider, VERSION, WalletConnectionHeader, WalletConnectionUI, WalletStateContext, WalletStateProvider, createResolveRuntime, isMainnetL1MissFallbackEnabled, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useNameResolutionContext, useResolveAddress, useResolveName, useResolveRuntime, useRuntimeContext, useRuntimeNameResolver, useWalletComponents, useWalletReconnectionHandler, useWalletState };
 //# sourceMappingURL=index.mjs.map