@openzeppelin/ui-react 3.2.0 → 3.3.0

package/dist/index.d.cts

@@ -492,13 +492,20 @@ interface UseResolveAddressOptions {
   readonly debounceMs?: number;
   /** When `false`, the hook stays `idle` and issues no resolution. Default `true`. */
   readonly enabled?: boolean;
+  /**
+   * When set, reverse-resolve via {@link RuntimeProvider} for this network
+   * instead of the wallet-global active runtime.
+   */
+  readonly network?: NetworkConfig;
 }
 /**
  * Reverse-resolve an address to a name. Soft-reads the active runtime from
  * `WalletStateContext` (never throws when no provider is mounted — degrades to
  * idle / UNSUPPORTED_NETWORK) and calls `runtime.nameResolution?.resolveAddress`.
- * Caches per (network, address) via the owned QueryClient. Not debounced by
- * default — addresses are pasted, not typed char-by-char.
+ * Pass `options.network` to scope resolution to a specific network without
+ * changing the wallet's active network. Caches per (network, address) via the
+ * owned QueryClient. Not debounced by default — addresses are pasted, not
+ * typed char-by-char.
  *
  * Applies no client-side address-shape check (INV-32): resolution is attempted on
  * any non-empty input and malformed addresses are rejected via the adapter's typed
@@ -506,7 +513,7 @@ interface UseResolveAddressOptions {
  *
  * @param address - The address to reverse-resolve. `null` / empty yields
  *   `status: 'idle'`.
- * @param options - `debounceMs` / `enabled` overrides.
+ * @param options - `debounceMs` / `enabled` / `network` overrides.
  * @returns The current {@link UseResolveAddressResult}.
  */
 declare function useResolveAddress(address: string | null | undefined, options?: UseResolveAddressOptions): UseResolveAddressResult;
@@ -594,7 +601,7 @@ declare function useNameResolutionContext(): NameResolutionContextValue;
 //#endregion
 //#region src/hooks/nameResolution/useRuntimeNameResolver.d.ts
 /**
- * Project the active runtime's `NameResolutionCapability` into the injected
+ * Project a runtime's `NameResolutionCapability` into the injected
  * {@link NameResolver} seam consumed by `@openzeppelin/ui-components` (SF-3, D3).
  * Mounted ambiently by the renderer:
  *
@@ -602,6 +609,10 @@ declare function useNameResolutionContext(): NameResolutionContextValue;
  * <NameResolverProvider {...useRuntimeNameResolver()}>{form}</NameResolverProvider>
  * ```
  *
+ * Pass `scopedNetwork` to resolve against a specific network via
+ * {@link RuntimeProvider}'s registry without changing {@link WalletStateProvider}'s
+ * active network (e.g. address-book Add Alias dropdown).
+ *
  * Each imperative call is backed by SF-2's **owned** resolution `QueryClient`
  * via `fetchQuery`, reusing SF-2's exact query-key convention
  * (`buildResolutionKey('name', networkId, normalizedName)`) — so a name
@@ -610,9 +621,10 @@ declare function useNameResolutionContext(): NameResolutionContextValue;
  * out-of-order safety, never a parallel cache (INV-119).
  *
  * Degradation, in order (all method-omission, never a throw):
- * - No `WalletStateProvider` mounted → empty resolver. The context is read
- *   directly (not via `useWalletState()`, which throws) so the ambient
- *   renderer mount stays safe for wallet-less usage.
+ * - No `WalletStateProvider` mounted (wallet path) or no `RuntimeProvider`
+ *   (network path) → empty resolver. The context is read directly (not via
+ *   `useWalletState()`, which throws) so the ambient renderer mount stays safe
+ *   for wallet-less usage.
  * - No active runtime, or runtime without the capability → empty resolver.
  * - Capability without `resolveName` → `isValidName` only; forward unsupported.
  *
@@ -622,7 +634,19 @@ declare function useNameResolutionContext(): NameResolutionContextValue;
  *
  * @returns A referentially stable {@link NameResolver} for the active runtime.
  */
-declare function useRuntimeNameResolver(): NameResolver;
+declare function useRuntimeNameResolver(scopedNetwork?: NetworkConfig): NameResolver;
+//#endregion
+//#region src/hooks/nameResolution/useNetworkNameResolver.d.ts
+/**
+ * @deprecated Pass the network to {@link useRuntimeNameResolver} instead.
+ */
+declare function useNetworkNameResolver(network: NetworkConfig | null): NameResolver;
+//#endregion
+//#region src/hooks/nameResolution/useNetworkResolveAddress.d.ts
+/**
+ * @deprecated Pass `network` in {@link UseResolveAddressOptions} to {@link useResolveAddress}.
+ */
+declare function useNetworkResolveAddress(address: string | null | undefined, network: NetworkConfig | null | undefined, options?: Omit<UseResolveAddressOptions, 'network'>): UseResolveAddressResult;
 //#endregion
 //#region src/hooks/runtime/runtimeCreationConfig.d.ts
 /** Safe default: miss-fallback OFF; no uiKit override. INV-204 */
@@ -734,5 +758,5 @@ interface NetworkSwitchManagerProps {
  */
 declare const NetworkSwitchManager: React.FC<NetworkSwitchManagerProps>;
 //#endregion
-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 };
+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, useNetworkNameResolver, useNetworkResolveAddress, 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/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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"}
+{"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/nameResolution/useNetworkNameResolver.ts","../src/hooks/nameResolution/useNetworkResolveAddress.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":";;;;;;;cACa;;;;;;UCiBI,eAAA;uBACM;;ADlBvB;;;;ACiBA;AASiB,UAAA,mBAAA,CACuB;EAe3B,oBAAgE,EAAA,CAAA,aAAlD,EAfa,aAeb,GAAA,IAAA,EAAA,GAAA;aAdd;;;ECPI;;;;EAGmC,cAAA,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,GAAA,IAAA;;AAapD;;;;AAAkF,cDKrE,cCLqE,EDKvD,MAAA,CAAA,OCLuD,CDKvD,mBCLuD,GAAA,IAAA,CAAA;;;AAhBjE,UAAA,oBAAA,CAAoB;EACzB,QAAA,EAAA,SAAA;EAEsB;EAA0B,cAAA,EAAA,CAAA,aAAA,EAA1B,aAA0B,EAAA,GAAR,OAAQ,CAAA,gBAAA,CAAA;;;AAa5D;;;;;;;;;AC7BiB,iBD6BD,eAAA,CC7BwB;EAAA,QAAA;EAAA;AAAA,CAAA,ED6BsB,oBC7BtB,CAAA,ED6B0C,kBAAA,CAAA,GAAA,CAAA,OC7B1C;;;UAAvB,uBAAA;;;uBAIM;iBAGN;EHfJ,gBAAqC,EAAA,OAAA;qBGoB7B;yCACoB,QAAQ;;AFJhC,cEgFJ,kBF/EU,EE+EQ,KAAA,CAAA,OF/EQ,CE+ER,uBF/EQ,GAAA,SAAA,CAAA;AAQvC;AAgBA;;;iBE6DgB,cAAA,CAAA,GAAkB;;;UCpFjB,wBAAA;YACL;;;;EJpBC,oBAAqC,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,GI0B3C,OJ1B2C,CI0BnC,aJ1BmC,GAAA,IAAA,GAAA,SAAA,CAAA,GI0BC,aJ1BD,GAAA,IAAA,GAAA,SAAA;;;;ACiBlD;AASA;AAgBA;qBGTqB;;;AFZrB;;;;;;AAgBA;;;;;;;;;AC7BA;AAIuB,iBC2FP,mBAAA,CD3FO;EAAA,QAAA;EAAA,gBAAA;EAAA,oBAAA;EAAA;AAAA,CAAA,ECgGpB,wBDhGoB,CAAA,ECgGI,kBAAA,CAAA,GAAA,CAAA,ODhGJ;;;;;;;UEPN,qBAAA;;;ELLJ;;;;ECiBI,SAAA,EAAA,GAAA,GAAA,OAAe;EASf;EAgBJ,UAAA,EAAA,CAAA,aAAc,CAAkD,EAAlD,MAAA,EAAA,GAAA,IAAA;;;;ACrB3B;;;;;;EAgBgB,UAAA,EAAA,CAAA,SAAe,EAAA,MAAA,EAAA,UAAA,EGbe,MHaf,CAAA,MAAA,EAAA,MAAA,GAAA,MAAA,CAAA,EAAA,GAAA,IAAA;EAAG;;;;;;;;EC7BjB,aAAA,EAAA,CAAA,QAAA,EAAuB,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EAIjB;;;;;;AAqFvB;AAMA;;;;ACpFA;;;AAOO,cCuBM,gBDvBN,ECuBsB,MAAA,CAAA,ODvBtB,CCuBsB,qBDvBtB,GAAA,IAAA,CAAA;;;;;;UElBU,sBAAA;;;ENRJ;;;YMcD;ALGZ;AASA;AAgBA;;;;ACrBA;;;;;;AAgBA;;;;AAAkF,cILrE,iBJKqE,EILlD,KAAA,CAAM,EJK4C,CILzC,sBJKyC,CAAA;;;;;;;;;;AFrClF;;;;ACiBA;AASA;AAgBA;;;;ACrBA;;;;;;AAgBA;;;;;;;;;AC7BA;;;;;;;AAyFA;AAMA;;;;ACpFA;;AAOe,cGqBF,YHrBE,EAAA,GAAA,GG2Bd,qBH3Bc;;;;;;;;;AJ1Bf;;;;ACiBA;AASA;AAgBa,iBOfG,iBAAA,CAAA,CPeW,EOfU,mBPeV;;;;;;;;;AD1C3B;;;;ACiBA;AASA;AAgBA;;;;ACrBA;;;;;;AAgBA;;;;;;;;;AC7BA;;;;;;;AAyFA;AAMA;;;iBM1DgB,mBAAA,CAAA,GAAuB;;;UCzCtB,oBAAA;;;;;;;EVJJ,OAAA,CAAA,EAAqC,MAAA;;;;ACiBlD;AASA;AAgBA;;iBSXgB,uBAAA,CAAA,GAA2B;;;UC3B1B,wBAAA;;;;;;;EXJJ;SWUJ;;;AVOT;AASA;AAgBA;;;iBUjBgB,2BAAA,CAAA,GAA+B;;;UCtB9B,gBAAA;;;;;;;AZHjB;;;;ACiBA;AASiB,iBWLD,mBAAA,CAAA,CXMwB,EWND,gBXO1B;;;UYtBI,oBAAA;;;gBAEiB;;;EbRrB,UAAqC,EaUpC,SbVoC,EAAA;;;;ECiBjC,KAAA,EYHR,KZGQ,GAAA,IAAe;EASf;EAgBJ,gBAAA,CAAgE,EY1BxD,SZ0BM;;;;ACrB3B;;;AAG4D,iBWQ5C,uBAAA,CAAA,CXR4C,EWQjB,oBXRiB;;;UYrB3C,uBAAA;;4BAEW;;;;SAInB;AdTT;;;;ACiBA;AASA;AAgBa,iBanBG,oBAAA,CAAA,CbmBW,EanBa,uBbmBb;;;;;;;;;AD1C3B;;;;ACiBA;AASA;AAgBa,iBcxBG,4BAAA,CdwBW,uBAAA,EAAA,MAAA,GAAA,IAAA,EAAA,kBAAA,EctBL,iBdsBK,GAAA,IAAA,EAAA,iBAAA,EAAA,MAAA,GAAA,IAAA,EAAA,eAAA,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,GAAA,IAAA,CAAA,EAAA,IAAA;;;;;;;;KepCf,oBAAA;AhBNZ;;;;ACiBA;AASA;AAgBA;Ke3BY,oBAAA;;;EdMK,SAAA,MAAA,EAAA,YAAoB;EACzB,SAAA,IAAA,EAAA,MAAA;CAEsB,GAAA;EAA0B,SAAA,MAAA,EAAA,SAAA;EAAR,SAAA,IAAA,EAAA,MAAA;CAAO,GAAA;EAa3C,SAAA,MAAA,EAAA,UAAe;EAAG,SAAA,IAAA,EAAA,MAAA;EAAU,SAAA,IAAA,EclB6B,edkB7B;CAAkB,GAAA;EAAoB,SAAA,MAAA,EAAA,OAAA;EAAA,SAAA,IAAA,EAAA,MAAA;kBcd5D;;;AbftB;;;;;AAayC,KaW7B,uBAAA,GbX6B;EAAO,SAAA,MAAA,EAAA,MAAA;AA4EhD,CAAA,GAAa;EAMG,SAAA,MAAA,EAAc,SAAA;;;;ECpFb,SAAA,OAAA,EAAA,MAAA;EACL,SAAA,IAAA,EYegE,YZfhE;CAMG,GAAA;EAAR,SAAA,MAAA,EAAA,OAAA;EAA4C,SAAA,OAAA,EAAA,MAAA;EAO9B,SAAA,KAAA,EYMC,mBZND;EAAkB,SAAA,KAAA,EAAA,GAAA,GAAA,IAAA;AAsEvC,CAAA;;;;UajGiB,qBAAA;;;;;AjBNjB;;;;ACiBA;AASA;AAgBA;;;;ACrBA;;;;;;AAgBA;AAAkC,iBeRlB,cAAA,CfQkB,IAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,OAAA,CAAA,EeNtB,qBfMsB,CAAA,EeL/B,oBfK+B;;;;UgB7BjB,wBAAA;;;;ElBRJ,SAAA,OAAqC,CAAA,EAAA,OAAA;;;;ACiBlD;EASiB,SAAA,OAAA,CAAA,EiBTI,ajBSe;AAgBpC;;;;ACrBA;;;;;;AAgBA;;;;;;;;;AC7BiB,iBe8BD,iBAAA,Cf9BwB,OAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,OAAA,CAAA,EegC5B,wBfhC4B,CAAA,EeiCrC,uBfjCqC;;;;;;AFSxC;AASiB,UkBZA,gBAAA,ClBYmB;EAgBvB;;;;ECrBI;EACL,SAAA,iBAAA,EAAA,MAAA;EAEsB;EAA0B,SAAA,iBAAA,EAAA,MAAA;EAAR;EAAO,SAAA,mBAAA,EAAA,MAAA;AAa3D;;;;;AAAkF,ciBNrE,cjBMqE,EiBNrD,gBjBMqD;;;;;;;AFrClF;;UoBeiB,2BAAA;qBACI;EnBCJ;EASA,SAAA,MAAA,CAAA,EmBRG,OnBQgB,CmBRR,gBnBSY,CAAA;EAe3B;;;;ECrBI,SAAA,WAAA,CAAA,EkBEQ,WlBFY;;;;;;AAgBrC;;;;;AAAkF,iBkBFlE,sBAAA,ClBEkE;EAAA,QAAA;EAAA,MAAA;EAAA;AAAA,CAAA,EkBE/E,2BlBF+E,CAAA,EkBEjD,SlBFiD;;;;;;;AFrClF;UqBaiB,0BAAA;;wBAEO;EpBEP;EASA,SAAA,MAAA,EoBTE,gBpBUqB;AAexC;;;;ACrBA;AACY,cmBqBC,qBnBrBD,EmBqBsB,OnBrBtB,CmBqBsB,0BnBrBtB,GAAA,IAAA,CAAA;;;;;AAeZ;;;AAA8D,iBmBgC9C,wBAAA,CAAA,CnBhC8C,EmBgClB,0BnBhCkB;;;;;;;;;AFrC9D;;;;ACiBA;AASA;AAgBA;;;;ACrBA;;;;;;AAgBA;;;;;;;;;AC7BA;;;AAYqB,iBmB8BL,sBAAA,CnB9BK,aAAA,CAAA,EmB8BkC,anB9BlC,CAAA,EmB8BkD,YnB9BlD;;;;;;iBoBdL,sBAAA,UAAgC,uBAAuB;;;;;;iBCCvD,wBAAA,8CAEL,4CACC,KAAK,uCACd;;;;cCTU,iCAAiC;;;;;AzBF9C;iByBSgB,8BAAA,WAAyC;;;UCAxC,oBAAA;oBACG;;qBAEC;;KAGT,gBAAA,mBAAmC,kBAAkB,QAAQ;A1BfzE;;;;ACiBA;AASA;AAgBa,iByBnBG,oBAAA,CzBmBW,mBAAA,EyBlBJ,ezBkBI,EAAA,MAAA,EyBjBjB,oBzBiBiB,CAAA,EyBhBxB,gBzBgBwB;;;;;;;;AD1C3B;;iB2BgBgB,iBAAA,sBACO,yBACb,uBACP;;;;;;;cCXU,wBAAwB,KAAA,CAAM;;;;;;UCE1B,uBAAA;;E7BVJ,SAAA,CAAqC,EAAA,MAAA;;uB6Bc3B;;E5BGN,mBAAe,CAAA,E4BDR,kB5BED;EAQN;EAgBJ,oBAAgE,CAAA,E4BxBpD,kB5BwBE;;;;ACrB3B;;;;;;AAgBA;;;;;;;;;AC7BA;;;;;AAayC,c0BsB5B,kB1BtB4B,E0BsBR,KAAA,CAAM,E1BtBE,C0BsBC,uB1BtBD,CAAA;;;;;;U2BXxB,yBAAA;;E9BVJ,MAAA,E8BYH,gB9BZwC;;kB8BchC;;E7BGD,eAAA,EAAA,MAAe;EASf;EAgBJ,uBAAgE,CAAA,EAAA,GAAlD,GAAA,IAAA;;;;ACrB3B;;;;;;AAgBA;;;;;;c4BFa,sBAAsB,KAAA,CAAM,GAAG"}

package/dist/index.d.mts

@@ -492,13 +492,20 @@ interface UseResolveAddressOptions {
   readonly debounceMs?: number;
   /** When `false`, the hook stays `idle` and issues no resolution. Default `true`. */
   readonly enabled?: boolean;
+  /**
+   * When set, reverse-resolve via {@link RuntimeProvider} for this network
+   * instead of the wallet-global active runtime.
+   */
+  readonly network?: NetworkConfig;
 }
 /**
  * Reverse-resolve an address to a name. Soft-reads the active runtime from
  * `WalletStateContext` (never throws when no provider is mounted — degrades to
  * idle / UNSUPPORTED_NETWORK) and calls `runtime.nameResolution?.resolveAddress`.
- * Caches per (network, address) via the owned QueryClient. Not debounced by
- * default — addresses are pasted, not typed char-by-char.
+ * Pass `options.network` to scope resolution to a specific network without
+ * changing the wallet's active network. Caches per (network, address) via the
+ * owned QueryClient. Not debounced by default — addresses are pasted, not
+ * typed char-by-char.
  *
  * Applies no client-side address-shape check (INV-32): resolution is attempted on
  * any non-empty input and malformed addresses are rejected via the adapter's typed
@@ -506,7 +513,7 @@ interface UseResolveAddressOptions {
  *
  * @param address - The address to reverse-resolve. `null` / empty yields
  *   `status: 'idle'`.
- * @param options - `debounceMs` / `enabled` overrides.
+ * @param options - `debounceMs` / `enabled` / `network` overrides.
  * @returns The current {@link UseResolveAddressResult}.
  */
 declare function useResolveAddress(address: string | null | undefined, options?: UseResolveAddressOptions): UseResolveAddressResult;
@@ -594,7 +601,7 @@ declare function useNameResolutionContext(): NameResolutionContextValue;
 //#endregion
 //#region src/hooks/nameResolution/useRuntimeNameResolver.d.ts
 /**
- * Project the active runtime's `NameResolutionCapability` into the injected
+ * Project a runtime's `NameResolutionCapability` into the injected
  * {@link NameResolver} seam consumed by `@openzeppelin/ui-components` (SF-3, D3).
  * Mounted ambiently by the renderer:
  *
@@ -602,6 +609,10 @@ declare function useNameResolutionContext(): NameResolutionContextValue;
  * <NameResolverProvider {...useRuntimeNameResolver()}>{form}</NameResolverProvider>
  * ```
  *
+ * Pass `scopedNetwork` to resolve against a specific network via
+ * {@link RuntimeProvider}'s registry without changing {@link WalletStateProvider}'s
+ * active network (e.g. address-book Add Alias dropdown).
+ *
  * Each imperative call is backed by SF-2's **owned** resolution `QueryClient`
  * via `fetchQuery`, reusing SF-2's exact query-key convention
  * (`buildResolutionKey('name', networkId, normalizedName)`) — so a name
@@ -610,9 +621,10 @@ declare function useNameResolutionContext(): NameResolutionContextValue;
  * out-of-order safety, never a parallel cache (INV-119).
  *
  * Degradation, in order (all method-omission, never a throw):
- * - No `WalletStateProvider` mounted → empty resolver. The context is read
- *   directly (not via `useWalletState()`, which throws) so the ambient
- *   renderer mount stays safe for wallet-less usage.
+ * - No `WalletStateProvider` mounted (wallet path) or no `RuntimeProvider`
+ *   (network path) → empty resolver. The context is read directly (not via
+ *   `useWalletState()`, which throws) so the ambient renderer mount stays safe
+ *   for wallet-less usage.
  * - No active runtime, or runtime without the capability → empty resolver.
  * - Capability without `resolveName` → `isValidName` only; forward unsupported.
  *
@@ -622,7 +634,19 @@ declare function useNameResolutionContext(): NameResolutionContextValue;
  *
  * @returns A referentially stable {@link NameResolver} for the active runtime.
  */
-declare function useRuntimeNameResolver(): NameResolver;
+declare function useRuntimeNameResolver(scopedNetwork?: NetworkConfig): NameResolver;
+//#endregion
+//#region src/hooks/nameResolution/useNetworkNameResolver.d.ts
+/**
+ * @deprecated Pass the network to {@link useRuntimeNameResolver} instead.
+ */
+declare function useNetworkNameResolver(network: NetworkConfig | null): NameResolver;
+//#endregion
+//#region src/hooks/nameResolution/useNetworkResolveAddress.d.ts
+/**
+ * @deprecated Pass `network` in {@link UseResolveAddressOptions} to {@link useResolveAddress}.
+ */
+declare function useNetworkResolveAddress(address: string | null | undefined, network: NetworkConfig | null | undefined, options?: Omit<UseResolveAddressOptions, 'network'>): UseResolveAddressResult;
 //#endregion
 //#region src/hooks/runtime/runtimeCreationConfig.d.ts
 /** Safe default: miss-fallback OFF; no uiKit override. INV-204 */
@@ -734,5 +758,5 @@ interface NetworkSwitchManagerProps {
  */
 declare const NetworkSwitchManager: React.FC<NetworkSwitchManagerProps>;
 //#endregion
-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 };
+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, useNetworkNameResolver, useNetworkResolveAddress, 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/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":";;;;;;;cACa;;;;;;UCiBI,eAAA;uBACM;;ADlBvB;;;;ACiBA;AASiB,UAAA,mBAAA,CACuB;EAe3B,oBAAgE,EAAA,CAAA,aAAlD,EAfa,aAeb,GAAA,IAAA,EAAA,GAAA;aAdd;;;ECPI;;;;EAGmC,cAAA,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,GAAA,IAAA;;AAapD;;;;AAAkF,cDKrE,cCLqE,EDKvD,MAAA,CAAA,OCLuD,CDKvD,mBCLuD,GAAA,IAAA,CAAA;;;AAhBjE,UAAA,oBAAA,CAAoB;EACzB,QAAA,EAAA,SAAA;EAEsB;EAA0B,cAAA,EAAA,CAAA,aAAA,EAA1B,aAA0B,EAAA,GAAR,OAAQ,CAAA,gBAAA,CAAA;;;AAa5D;;;;;;;;;AC7BiB,iBD6BD,eAAA,CC7BwB;EAAA,QAAA;EAAA;AAAA,CAAA,ED6BsB,oBC7BtB,CAAA,ED6B0C,kBAAA,CAAA,GAAA,CAAA,OC7B1C;;;UAAvB,uBAAA;;;uBAIM;iBAGN;EHfJ,gBAAqC,EAAA,OAAA;qBGoB7B;yCACoB,QAAQ;;AFJhC,cEgFJ,kBF/EU,EE+EQ,KAAA,CAAA,OF/EQ,CE+ER,uBF/EQ,GAAA,SAAA,CAAA;AAQvC;AAgBA;;;iBE6DgB,cAAA,CAAA,GAAkB;;;UCpFjB,wBAAA;YACL;;;;EJpBC,oBAAqC,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,GI0B3C,OJ1B2C,CI0BnC,aJ1BmC,GAAA,IAAA,GAAA,SAAA,CAAA,GI0BC,aJ1BD,GAAA,IAAA,GAAA,SAAA;;;;ACiBlD;AASA;AAgBA;qBGTqB;;;AFZrB;;;;;;AAgBA;;;;;;;;;AC7BA;AAIuB,iBC2FP,mBAAA,CD3FO;EAAA,QAAA;EAAA,gBAAA;EAAA,oBAAA;EAAA;AAAA,CAAA,ECgGpB,wBDhGoB,CAAA,ECgGI,kBAAA,CAAA,GAAA,CAAA,ODhGJ;;;;;;;UEPN,qBAAA;;;ELLJ;;;;ECiBI,SAAA,EAAA,GAAA,GAAA,OAAe;EASf;EAgBJ,UAAA,EAAA,CAAA,aAAc,CAAkD,EAAlD,MAAA,EAAA,GAAA,IAAA;;;;ACrB3B;;;;;;EAgBgB,UAAA,EAAA,CAAA,SAAe,EAAA,MAAA,EAAA,UAAA,EGbe,MHaf,CAAA,MAAA,EAAA,MAAA,GAAA,MAAA,CAAA,EAAA,GAAA,IAAA;EAAG;;;;;;;;EC7BjB,aAAA,EAAA,CAAA,QAAA,EAAuB,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EAIjB;;;;;;AAqFvB;AAMA;;;;ACpFA;;;AAOO,cCuBM,gBDvBN,ECuBsB,MAAA,CAAA,ODvBtB,CCuBsB,qBDvBtB,GAAA,IAAA,CAAA;;;;;;UElBU,sBAAA;;;ENRJ;;;YMcD;ALGZ;AASA;AAgBA;;;;ACrBA;;;;;;AAgBA;;;;AAAkF,cILrE,iBJKqE,EILlD,KAAA,CAAM,EJK4C,CILzC,sBJKyC,CAAA;;;;;;;;;;AFrClF;;;;ACiBA;AASA;AAgBA;;;;ACrBA;;;;;;AAgBA;;;;;;;;;AC7BA;;;;;;;AAyFA;AAMA;;;;ACpFA;;AAOe,cGqBF,YHrBE,EAAA,GAAA,GG2Bd,qBH3Bc;;;;;;;;;AJ1Bf;;;;ACiBA;AASA;AAgBa,iBOfG,iBAAA,CAAA,CPeW,EOfU,mBPeV;;;;;;;;;AD1C3B;;;;ACiBA;AASA;AAgBA;;;;ACrBA;;;;;;AAgBA;;;;;;;;;AC7BA;;;;;;;AAyFA;AAMA;;;iBM1DgB,mBAAA,CAAA,GAAuB;;;UCzCtB,oBAAA;;;;;;;EVJJ,OAAA,CAAA,EAAqC,MAAA;;;;ACiBlD;AASA;AAgBA;;iBSXgB,uBAAA,CAAA,GAA2B;;;UC3B1B,wBAAA;;;;;;;EXJJ;SWUJ;;;AVOT;AASA;AAgBA;;;iBUjBgB,2BAAA,CAAA,GAA+B;;;UCtB9B,gBAAA;;;;;;;AZHjB;;;;ACiBA;AASiB,iBWLD,mBAAA,CAAA,CXMwB,EWND,gBXO1B;;;UYtBI,oBAAA;;;gBAEiB;;;EbRrB,UAAqC,EaUpC,SbVoC,EAAA;;;;ECiBjC,KAAA,EYHR,KZGQ,GAAA,IAAe;EASf;EAgBJ,gBAAA,CAAgE,EY1BxD,SZ0BM;;;;ACrB3B;;;AAG4D,iBWQ5C,uBAAA,CAAA,CXR4C,EWQjB,oBXRiB;;;UYrB3C,uBAAA;;4BAEW;;;;SAInB;AdTT;;;;ACiBA;AASA;AAgBa,iBanBG,oBAAA,CAAA,CbmBW,EanBa,uBbmBb;;;;;;;;;AD1C3B;;;;ACiBA;AASA;AAgBa,iBcxBG,4BAAA,CdwBW,uBAAA,EAAA,MAAA,GAAA,IAAA,EAAA,kBAAA,EctBL,iBdsBK,GAAA,IAAA,EAAA,iBAAA,EAAA,MAAA,GAAA,IAAA,EAAA,eAAA,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,GAAA,IAAA,CAAA,EAAA,IAAA;;;;;;;;KepCf,oBAAA;AhBNZ;;;;ACiBA;AASA;AAgBA;Ke3BY,oBAAA;;;EdMK,SAAA,MAAA,EAAA,YAAoB;EACzB,SAAA,IAAA,EAAA,MAAA;CAEsB,GAAA;EAA0B,SAAA,MAAA,EAAA,SAAA;EAAR,SAAA,IAAA,EAAA,MAAA;CAAO,GAAA;EAa3C,SAAA,MAAA,EAAA,UAAe;EAAG,SAAA,IAAA,EAAA,MAAA;EAAU,SAAA,IAAA,EclB6B,edkB7B;CAAkB,GAAA;EAAoB,SAAA,MAAA,EAAA,OAAA;EAAA,SAAA,IAAA,EAAA,MAAA;kBcd5D;;;AbftB;;;;;AAayC,KaW7B,uBAAA,GbX6B;EAAO,SAAA,MAAA,EAAA,MAAA;AA4EhD,CAAA,GAAa;EAMG,SAAA,MAAA,EAAc,SAAA;;;;ECpFb,SAAA,OAAA,EAAA,MAAA;EACL,SAAA,IAAA,EYegE,YZfhE;CAMG,GAAA;EAAR,SAAA,MAAA,EAAA,OAAA;EAA4C,SAAA,OAAA,EAAA,MAAA;EAO9B,SAAA,KAAA,EYMC,mBZND;EAAkB,SAAA,KAAA,EAAA,GAAA,GAAA,IAAA;AAsEvC,CAAA;;;;UajGiB,qBAAA;;;;;AjBNjB;;;;ACiBA;AASA;AAgBA;;;;ACrBA;;;;;;AAgBA;AAAkC,iBeRlB,cAAA,CfQkB,IAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,OAAA,CAAA,EeNtB,qBfMsB,CAAA,EeL/B,oBfK+B;;;;UgB/BjB,wBAAA;;;;;AlBNjB;;;;ACiBA;AASA;AAgBA;;;;ACrBA;;;;;;AAgBA;AAAkC,iBgBRlB,iBAAA,ChBQkB,OAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,OAAA,CAAA,EgBNtB,wBhBMsB,CAAA,EgBL/B,uBhBK+B;;;;;;ADpBlC;AASiB,UkBZA,gBAAA,ClBYmB;EAgBvB;;;;ECrBI;EACL,SAAA,iBAAA,EAAA,MAAA;EAEsB;EAA0B,SAAA,iBAAA,EAAA,MAAA;EAAR;EAAO,SAAA,mBAAA,EAAA,MAAA;AAa3D;;;;;AAAkF,ciBNrE,cjBMqE,EiBNrD,gBjBMqD;;;;;;;AFrClF;;UoBeiB,2BAAA;qBACI;EnBCJ;EASA,SAAA,MAAA,CAAA,EmBRG,OnBQgB,CmBRR,gBnBSY,CAAA;EAe3B;;;;ECrBI,SAAA,WAAA,CAAA,EkBEQ,WlBFY;;;;;;AAgBrC;;;;;AAAkF,iBkBFlE,sBAAA,ClBEkE;EAAA,QAAA;EAAA,MAAA;EAAA;AAAA,CAAA,EkBE/E,2BlBF+E,CAAA,EkBEjD,SlBFiD;;;;;;;AFrClF;UqBaiB,0BAAA;;wBAEO;EpBEP;EASA,SAAA,MAAA,EoBTE,gBpBUqB;AAexC;;;;ACrBA;AACY,cmBqBC,qBnBrBD,EmBqBsB,OnBrBtB,CmBqBsB,0BnBrBtB,GAAA,IAAA,CAAA;;;;;AAeZ;;;AAA8D,iBmBgC9C,wBAAA,CAAA,CnBhC8C,EmBgClB,0BnBhCkB;;;;;;;;;AFrC9D;;;;ACiBA;AASA;AAgBA;;;;ACrBA;;;;;;AAgBA;;;;;;;iBoBOgB,sBAAA,CAAA,GAA0B;;;;cC1C7B,iCAAiC;;;;;AvBF9C;iBuBSgB,8BAAA,WAAyC;;;UCAxC,oBAAA;oBACG;;qBAEC;;KAGT,gBAAA,mBAAmC,kBAAkB,QAAQ;AxBfzE;;;;ACiBA;AASA;AAgBa,iBuBnBG,oBAAA,CvBmBW,mBAAA,EuBlBJ,evBkBI,EAAA,MAAA,EuBjBjB,oBvBiBiB,CAAA,EuBhBxB,gBvBgBwB;;;;;;;;AD1C3B;;iByBgBgB,iBAAA,sBACO,yBACb,uBACP;;;;;;;cCXU,wBAAwB,KAAA,CAAM;;;;;;UCE1B,uBAAA;;E3BVJ,SAAA,CAAqC,EAAA,MAAA;;uB2Bc3B;;E1BGN,mBAAe,CAAA,E0BDR,kB1BED;EAQN;EAgBJ,oBAAgE,CAAA,E0BxBpD,kB1BwBE;;;;ACrB3B;;;;;;AAgBA;;;;;;;;;AC7BA;;;;;AAayC,cwBsB5B,kBxBtB4B,EwBsBR,KAAA,CAAM,ExBtBE,CwBsBC,uBxBtBD,CAAA;;;;;;UyBXxB,yBAAA;;E5BVJ,MAAA,E4BYH,gB5BZwC;;kB4BchC;;E3BGD,eAAA,EAAA,MAAe;EASf;EAgBJ,uBAAgE,CAAA,EAAA,GAAlD,GAAA,IAAA;;;;ACrB3B;;;;;;AAgBA;;;;;;c0BFa,sBAAsB,KAAA,CAAM,GAAG"}
+{"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/nameResolution/useNetworkNameResolver.ts","../src/hooks/nameResolution/useNetworkResolveAddress.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.2.0";
+const VERSION = "3.3.0";
 
 //#endregion
 //#region src/hooks/AdapterContext.tsx
@@ -1145,11 +1145,11 @@ const NOOP_RETRY = () => {};
 * {@link EngineResult}. Not exported from the package.
 */
 function useResolutionEngine(params) {
-	const { input, namespace, debounceMs, enabled, shouldAttempt, getMethod } = params;
+	const { input, namespace, debounceMs, enabled, shouldAttempt, getMethod, runtimeSource } = params;
 	const walletState = useContext(WalletStateContext);
-	const activeRuntime = walletState?.activeRuntime ?? null;
-	const activeNetworkId = walletState?.activeNetworkId ?? null;
-	const isRuntimeLoading = walletState?.isRuntimeLoading ?? false;
+	const activeRuntime = runtimeSource ? runtimeSource.runtime : walletState?.activeRuntime ?? null;
+	const activeNetworkId = runtimeSource ? runtimeSource.networkId : walletState?.activeNetworkId ?? null;
+	const isRuntimeLoading = runtimeSource ? runtimeSource.isRuntimeLoading : walletState?.isRuntimeLoading ?? false;
 	const { queryClient, config } = useNameResolutionContext();
 	const trimmedLive = (input ?? "").trim();
 	const normalizedLive = trimmedLive.toLowerCase();
@@ -1304,40 +1304,13 @@ function toNameResult(engine) {
 }
 
 //#endregion
-//#region src/hooks/nameResolution/useResolveAddress.ts
-/**
-* Reverse-resolve an address to a name. Soft-reads the active runtime from
-* `WalletStateContext` (never throws when no provider is mounted — degrades to
-* idle / UNSUPPORTED_NETWORK) and calls `runtime.nameResolution?.resolveAddress`.
-* Caches per (network, address) via the owned QueryClient. Not debounced by
-* default — addresses are pasted, not typed char-by-char.
-*
-* Applies no client-side address-shape check (INV-32): resolution is attempted on
-* any non-empty input and malformed addresses are rejected via the adapter's typed
-* error union. Address-shape validation is SF-3's concern.
-*
-* @param address - The address to reverse-resolve. `null` / empty yields
-*   `status: 'idle'`.
-* @param options - `debounceMs` / `enabled` overrides.
-* @returns The current {@link UseResolveAddressResult}.
-*/
-function useResolveAddress(address, options) {
-	const { config } = useNameResolutionContext();
-	return toAddressResult(useResolutionEngine({
-		input: address,
-		namespace: "addr",
-		debounceMs: options?.debounceMs ?? config.reverseDebounceMs,
-		enabled: options?.enabled ?? true,
-		shouldAttempt: () => true,
-		getMethod: (cap) => cap.resolveAddress
-	}));
-}
+//#region src/hooks/nameResolution/mapAddressEngineResult.ts
 /**
 * Remap the engine's generic `input` to `address` (INV-24). A `debouncing` arm —
 * only reachable when a caller passes a non-zero reverse `debounceMs` — collapses
 * to `loading` so {@link UseResolveAddressResult} keeps no `debouncing` variant.
 */
-function toAddressResult(engine) {
+function mapAddressEngineResult(engine) {
 	switch (engine.status) {
 		case "idle": return { status: "idle" };
 		case "debouncing":
@@ -1359,6 +1332,71 @@ function toAddressResult(engine) {
 	}
 }
 
+//#endregion
+//#region src/hooks/nameResolution/useNetworkRuntimeSource.ts
+/**
+* Soft-reads {@link RuntimeContext} (never throws) and requests the registry
+* runtime for `network`. Call during render so loading state updates propagate.
+*
+* Does not mutate {@link WalletStateProvider}'s active network — wallet-global
+* runtime is never consulted when a scoped network is supplied (INV-154).
+*/
+function useNetworkRuntimeSource(network) {
+	const runtimeContext = useContext(RuntimeContext);
+	if (!network) return {
+		runtime: null,
+		networkId: "",
+		isRuntimeLoading: false
+	};
+	if (!runtimeContext) return {
+		runtime: null,
+		networkId: network.id,
+		isRuntimeLoading: false
+	};
+	const { runtime, isLoading } = runtimeContext.getRuntimeForNetwork(network);
+	return {
+		runtime,
+		networkId: network.id,
+		isRuntimeLoading: isLoading
+	};
+}
+
+//#endregion
+//#region src/hooks/nameResolution/useResolveAddress.ts
+/**
+* Reverse-resolve an address to a name. Soft-reads the active runtime from
+* `WalletStateContext` (never throws when no provider is mounted — degrades to
+* idle / UNSUPPORTED_NETWORK) and calls `runtime.nameResolution?.resolveAddress`.
+* Pass `options.network` to scope resolution to a specific network without
+* changing the wallet's active network. Caches per (network, address) via the
+* owned QueryClient. Not debounced by default — addresses are pasted, not
+* typed char-by-char.
+*
+* Applies no client-side address-shape check (INV-32): resolution is attempted on
+* any non-empty input and malformed addresses are rejected via the adapter's typed
+* error union. Address-shape validation is SF-3's concern.
+*
+* @param address - The address to reverse-resolve. `null` / empty yields
+*   `status: 'idle'`.
+* @param options - `debounceMs` / `enabled` / `network` overrides.
+* @returns The current {@link UseResolveAddressResult}.
+*/
+function useResolveAddress(address, options) {
+	const { config } = useNameResolutionContext();
+	const debounceMs = options?.debounceMs ?? config.reverseDebounceMs;
+	const enabled = options?.enabled ?? true;
+	const networkSource = useNetworkRuntimeSource(options?.network ?? null);
+	return mapAddressEngineResult(useResolutionEngine({
+		input: address,
+		namespace: "addr",
+		debounceMs,
+		enabled,
+		shouldAttempt: () => true,
+		getMethod: (cap) => cap.resolveAddress,
+		runtimeSource: options?.network != null ? networkSource : void 0
+	}));
+}
+
 //#endregion
 //#region src/hooks/nameResolution/NameResolutionProvider.tsx
 /**
@@ -1384,6 +1422,54 @@ function NameResolutionProvider({ children, config, queryClient }) {
 	});
 }
 
+//#endregion
+//#region src/hooks/nameResolution/createNameResolver.ts
+const EMPTY_RESOLVER$1 = {};
+/**
+* Projects a {@link NameResolutionCapability} into the SF-3 {@link NameResolver}
+* seam with SF-2 cache-key parity (INV-119).
+*/
+function createNameResolverFromCapability(capability, networkId, runtimeInstanceId, queryClient, config) {
+	if (!capability) return EMPTY_RESOLVER$1;
+	const resolveNameMethod = capability.resolveName;
+	return {
+		isValidName: (name) => capability.isValidName(name),
+		resolveName: resolveNameMethod ? async (name) => {
+			const normalized = name.trim().toLowerCase();
+			try {
+				return {
+					ok: true,
+					value: await queryClient.fetchQuery({
+						queryKey: buildResolutionKey("name", networkId, normalized, runtimeInstanceId),
+						queryFn: async () => {
+							let result;
+							try {
+								result = await resolveNameMethod(normalized);
+							} catch (cause) {
+								throw new ResolutionQueryError({
+									code: "ADAPTER_ERROR",
+									message: cause instanceof Error ? cause.message : String(cause),
+									cause
+								});
+							}
+							if (!result.ok) throw new ResolutionQueryError(result.error);
+							return result.value;
+						},
+						staleTime: config.staleTimeMs,
+						gcTime: config.gcTimeMs,
+						retry: (failureCount, error) => (error instanceof ResolutionQueryError ? isTransientError(error.resolutionError) : true) && failureCount < config.transientRetryCount
+					})
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: toNameResolutionError(error)
+				};
+			}
+		} : void 0
+	};
+}
+
 //#endregion
 //#region src/hooks/nameResolution/useRuntimeNameResolver.ts
 /**
@@ -1393,7 +1479,7 @@ function NameResolutionProvider({ children, config, queryClient }) {
 */
 const EMPTY_RESOLVER = {};
 /**
-* Project the active runtime's `NameResolutionCapability` into the injected
+* Project a runtime's `NameResolutionCapability` into the injected
 * {@link NameResolver} seam consumed by `@openzeppelin/ui-components` (SF-3, D3).
 * Mounted ambiently by the renderer:
 *
@@ -1401,6 +1487,10 @@ const EMPTY_RESOLVER = {};
 * <NameResolverProvider {...useRuntimeNameResolver()}>{form}</NameResolverProvider>
 * ```
 *
+* Pass `scopedNetwork` to resolve against a specific network via
+* {@link RuntimeProvider}'s registry without changing {@link WalletStateProvider}'s
+* active network (e.g. address-book Add Alias dropdown).
+*
 * Each imperative call is backed by SF-2's **owned** resolution `QueryClient`
 * via `fetchQuery`, reusing SF-2's exact query-key convention
 * (`buildResolutionKey('name', networkId, normalizedName)`) — so a name
@@ -1409,9 +1499,10 @@ const EMPTY_RESOLVER = {};
 * out-of-order safety, never a parallel cache (INV-119).
 *
 * Degradation, in order (all method-omission, never a throw):
-* - No `WalletStateProvider` mounted → empty resolver. The context is read
-*   directly (not via `useWalletState()`, which throws) so the ambient
-*   renderer mount stays safe for wallet-less usage.
+* - No `WalletStateProvider` mounted (wallet path) or no `RuntimeProvider`
+*   (network path) → empty resolver. The context is read directly (not via
+*   `useWalletState()`, which throws) so the ambient renderer mount stays safe
+*   for wallet-less usage.
 * - No active runtime, or runtime without the capability → empty resolver.
 * - Capability without `resolveName` → `isValidName` only; forward unsupported.
 *
@@ -1421,61 +1512,49 @@ const EMPTY_RESOLVER = {};
 *
 * @returns A referentially stable {@link NameResolver} for the active runtime.
 */
-function useRuntimeNameResolver() {
+function useRuntimeNameResolver(scopedNetwork) {
 	const walletState = useContext(WalletStateContext);
 	const { queryClient, config } = useNameResolutionContext();
-	const activeRuntime = walletState?.activeRuntime ?? null;
+	const networkSource = useNetworkRuntimeSource(scopedNetwork ?? null);
+	const useNetworkScoped = scopedNetwork != null;
+	const activeRuntime = useNetworkScoped ? networkSource.runtime : walletState?.activeRuntime ?? null;
 	const capability = activeRuntime?.nameResolution;
-	const networkId = walletState?.activeNetworkId ?? "";
+	const networkId = useNetworkScoped ? networkSource.networkId : walletState?.activeNetworkId ?? "";
 	const runtimeInstanceId = getRuntimeInstanceId(activeRuntime);
 	return useMemo(() => {
 		if (!capability) return EMPTY_RESOLVER;
-		const resolveNameMethod = capability.resolveName;
-		return {
-			isValidName: (name) => capability.isValidName(name),
-			resolveName: resolveNameMethod ? async (name) => {
-				const normalized = name.trim().toLowerCase();
-				try {
-					return {
-						ok: true,
-						value: await queryClient.fetchQuery({
-							queryKey: buildResolutionKey("name", networkId, normalized, runtimeInstanceId),
-							queryFn: async () => {
-								let result;
-								try {
-									result = await resolveNameMethod(normalized);
-								} catch (cause) {
-									throw new ResolutionQueryError({
-										code: "ADAPTER_ERROR",
-										message: cause instanceof Error ? cause.message : String(cause),
-										cause
-									});
-								}
-								if (!result.ok) throw new ResolutionQueryError(result.error);
-								return result.value;
-							},
-							staleTime: config.staleTimeMs,
-							gcTime: config.gcTimeMs,
-							retry: (failureCount, error) => (error instanceof ResolutionQueryError ? isTransientError(error.resolutionError) : true) && failureCount < config.transientRetryCount
-						})
-					};
-				} catch (error) {
-					return {
-						ok: false,
-						error: toNameResolutionError(error)
-					};
-				}
-			} : void 0
-		};
+		return createNameResolverFromCapability(capability, networkId, runtimeInstanceId, queryClient, config);
 	}, [
 		capability,
+		networkId,
+		runtimeInstanceId,
 		queryClient,
 		config,
-		networkId,
-		runtimeInstanceId
+		useNetworkScoped ? networkSource.isRuntimeLoading : walletState?.isRuntimeLoading ?? false
 	]);
 }
 
+//#endregion
+//#region src/hooks/nameResolution/useNetworkNameResolver.ts
+/**
+* @deprecated Pass the network to {@link useRuntimeNameResolver} instead.
+*/
+function useNetworkNameResolver(network) {
+	return useRuntimeNameResolver(network ?? void 0);
+}
+
+//#endregion
+//#region src/hooks/nameResolution/useNetworkResolveAddress.ts
+/**
+* @deprecated Pass `network` in {@link UseResolveAddressOptions} to {@link useResolveAddress}.
+*/
+function useNetworkResolveAddress(address, network, options) {
+	return useResolveAddress(address, network != null ? {
+		...options,
+		network
+	} : options);
+}
+
 //#endregion
 //#region src/hooks/runtime/runtimeCreationConfig.ts
 /** Safe default: miss-fallback OFF; no uiKit override. INV-204 */
@@ -1748,5 +1827,5 @@ const NetworkSwitchManager = ({ wallet, networkCatalog, targetNetworkId, onNetwo
 };
 
 //#endregion
-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 };
+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, useNetworkNameResolver, useNetworkResolveAddress, useResolveAddress, useResolveName, useResolveRuntime, useRuntimeContext, useRuntimeNameResolver, useWalletComponents, useWalletReconnectionHandler, useWalletState };
 //# sourceMappingURL=index.mjs.map