@nexus-cross/connect-kit-wagmi 1.0.0-beta.1

package/README.md

@@ -0,0 +1,195 @@
+# @nexus-cross/connect-kit-wagmi
+
+wagmi connector adapters, connector registry, and the `createCrossxConfig`
+factory that produces a **dual wagmi config** — one side for CROSSx wallets
+(embedded, CROSSx Wallet, CROSSx Extension) and one side for third-party
+wallets routed through Reown (MetaMask, Binance). Use this package when you
+want the wallet plumbing without the built-in React UI.
+
+- With React UI: install [`@nexus-cross/connect-kit-react`](../react) instead — it already
+  depends on this package.
+- Headless: install this package directly and build your own button / modal.
+
+## Install
+
+```sh
+pnpm add @nexus-cross/connect-kit-wagmi wagmi viem @wagmi/core
+```
+
+**Optional peers** — install only the ones your DApp actually uses:
+
+| Peer | When to install |
+|------|-----------------|
+| `@to-nexus/sdk`, `@to-nexus/appkit-adapter-wagmi` | You want `cross_wallet` / `cross_extension` over the CROSS relay. |
+| `@reown/appkit`, `@reown/appkit-adapter-wagmi` | You want `metamask` / `binance` (or any third-party WalletConnect wallet). |
+| `@nexus-cross/crossx-sdk-core`, `@nexus-cross/crossx-sdk-wagmi` | You want the in-app `cross_embedded` (social-login) wallet. |
+
+## Quick start
+
+### Dual-side config (cross + reown)
+
+```ts
+import { createCrossxConfig } from '@nexus-cross/connect-kit-wagmi';
+import { toNexusAdapter } from '@nexus-cross/connect-kit-wagmi/to-nexus';
+import { reownAdapter } from '@nexus-cross/connect-kit-wagmi/reown';
+import { embeddedConnectorFactory } from '@nexus-cross/connect-kit-wagmi/embedded';
+
+export const config = createCrossxConfig({
+  crossProjectId: '...',
+  reownProjectId: '...',
+  appMetadata: { name: 'My DApp', url: 'https://example.com' },
+  networks: [crossTestnet, bscTestnet],
+  defaultNetwork: crossTestnet,
+  ssr: true,                       // Next.js App Router
+  crossProvider: toNexusAdapter(), // hosts cross_*
+  reownProvider: reownAdapter(),   // hosts metamask / binance
+  embeddedConnectorFactory,        // enables cross_embedded
+});
+
+// config.crossWagmiConfig  — wagmi Config for cross side (nullable)
+// config.reownWagmiConfig  — wagmi Config for reown side (nullable)
+// config.connectorRegistry — unified wallet list for your UI
+```
+
+### Single-side config
+
+Drop either adapter when your DApp only needs one ecosystem — the unused side
+becomes `null` and the registry only exposes wallets from the side you wired.
+
+```ts
+// CROSSx-only
+createCrossxConfig({
+  /* ... */
+  crossProvider: toNexusAdapter(),
+});
+
+// Reown-only
+createCrossxConfig({
+  /* ... */
+  reownProvider: reownAdapter(),
+});
+```
+
+### Mounting the wagmi config manually
+
+If you use `@nexus-cross/connect-kit-react`, the provider handles this for you. When using
+this package alone, remount `<WagmiProvider>` when the active side swaps so
+session state from the other side never leaks:
+
+```tsx
+<WagmiProvider key={activeProvider} config={activeWagmiConfig}>
+  {/* ... */}
+</WagmiProvider>
+```
+
+## Entrypoints
+
+| Import | Purpose |
+|--------|---------|
+| `@nexus-cross/connect-kit-wagmi` | Core API: `createCrossxConfig`, connector registry, SSR helpers, icons, utilities. |
+| `@nexus-cross/connect-kit-wagmi/to-nexus` | `toNexusAdapter()` — CROSS relay via `@to-nexus/appkit-adapter-wagmi`. |
+| `@nexus-cross/connect-kit-wagmi/reown` | `reownAdapter()` — standard WalletConnect relay via `@reown/appkit-adapter-wagmi`. |
+| `@nexus-cross/connect-kit-wagmi/embedded` | `embeddedConnectorFactory` — in-app CROSSx wallet (social login). Client-only; don't import from server code. |
+
+## Main API
+
+### `createCrossxConfig(options)`
+
+Produces a `CrossxConfig` bundle with:
+
+- `crossWagmiConfig` / `reownWagmiConfig` — per-side wagmi `Config`, or `null`
+  when that side isn't wired.
+- `connectorRegistry` — ordered list of `ConnectorEntry` with `walletId`,
+  `providerKind` (`'cross' | 'reown'`), `connectorId`, icons, and optional
+  `guideUrl` / `fallbackConnectorId`.
+- `crossProvider` / `reownProvider` — the adapter instances (exposes
+  `beforeConnect`, `closeModal`, `subscribeModalState`, `teardown`).
+- `defaultProvider` — which side to mount first (`'cross'` when both sides
+  are wired, unless overridden via `defaultProvider` option).
+- `activeProviderStorageKey` — localStorage key for persisting the active side
+  across reloads. Clear this during full sign-out flows.
+
+### Connector registry
+
+```ts
+import { resolveCurrentWallet } from '@nexus-cross/connect-kit-wagmi';
+
+// Map a live wagmi connectorId (+ last user intent) back to a WalletId.
+const walletId = resolveCurrentWallet(
+  config.connectorRegistry,
+  activeConnector.id,
+  lastIntent,
+);
+```
+
+`ConnectorEntry.aliasConnectorIds` handles EIP-6963 promotion (e.g.
+`io.metamask` elevating over wagmi's default `metaMask` id).
+
+### SSR helpers
+
+```tsx
+// app/layout.tsx (Next.js App Router)
+import { headers } from 'next/headers';
+import { cookieToCrossConnectKitState } from '@nexus-cross/connect-kit-wagmi';
+
+export default async function RootLayout({ children }) {
+  const cookie = (await headers()).get('cookie');
+  const initialState = cookieToCrossConnectKitState(config, cookie);
+  return (
+    <html><body>
+      <Providers initialState={initialState}>{children}</Providers>
+    </body></html>
+  );
+}
+```
+
+Requires `createCrossxConfig({ ssr: true })`.
+
+### Utilities
+
+```ts
+import {
+  clearWalletSessionStorage,   // nukes WC / appkit / wagmi localStorage keys
+  DEFAULT_SESSION_STORAGE_PREFIXES,
+  detectWallets, debugDetect,  // EIP-6963 + window globals + SDK probe
+  DEFAULT_WALLET_REGISTRY,     // canonical wallet descriptors
+  readWalletInfoTokens,        // read --wi-* CSS custom properties
+  deriveSDKThemeTokensFromWalletInfo, // map --wi-* → SDKThemeTokens
+} from '@nexus-cross/connect-kit-wagmi';
+```
+
+### Icons
+
+Bundler-agnostic `data:image/svg+xml` URIs. Safe to use as `<img src>`:
+
+```ts
+import {
+  CROSSX_ICON, EXTENSION_ICON,
+  METAMASK_ICON, BINANCE_ICON, WALLETCONNECT_ICON,
+  GOOGLE_ICON, APPLE_ICON,
+} from '@nexus-cross/connect-kit-wagmi';
+```
+
+## Headless example
+
+Using this package without `@nexus-cross/connect-kit-react` to build a custom UI is
+demonstrated in
+[`examples/next-wagmi-only`](../../examples/next-wagmi-only).
+
+## Allowed dependencies
+
+This package may depend on: `@nexus-cross/connect-kit-core` (ports / types), `wagmi`,
+`viem`, `@wagmi/core`, `@nexus-cross/*` (optional), `@to-nexus/*` (optional),
+`@reown/appkit*` (optional).
+
+It must **not** depend on React or `@nexus-cross/connect-kit-react` — the dependency
+direction is `react → core ← wagmi`.
+
+## Compatibility
+
+- `wagmi@^2`, `viem@^2`, `@wagmi/core@^2`
+- Node 18+ / modern browsers
+
+## License
+
+MIT

package/dist/adapters/helpers.d.ts

@@ -0,0 +1,46 @@
+import type { CrossConnectKitConfig } from '@nexus-cross/connect-kit-core';
+import type { Chain } from 'viem';
+import type { CreateConnectorFn } from 'wagmi';
+import type { ConnectorEntry } from '../registry/ConnectorRegistry.js';
+/**
+ * Connector id used for the standard Reown-relay WalletConnect
+ * connector in `toNexusAdapter` mode. Coexists with WagmiAdapter's
+ * internal 'walletConnect' (CROSS relay) so Binance and mobile
+ * MetaMask (which only speak the official WC relay) can still pair.
+ */
+export declare const REOWN_WC_CONNECTOR_ID = "walletConnectReown";
+/**
+ * Registry entries shared by both built-in adapters. Keeping them in one
+ * place ensures wallet order and metadata match regardless of which
+ * relay transport the DApp picks.
+ */
+export declare function crossWalletEntry(name?: string, connectorId?: string): ConnectorEntry;
+export declare function crossExtensionEntry(): ConnectorEntry;
+export declare function metamaskEntry(providerKind: 'cross' | 'reown', fallbackConnectorId?: string | undefined): ConnectorEntry;
+export declare function binanceEntry(providerKind: 'cross' | 'reown', connectorId?: string): ConnectorEntry;
+/**
+ * Factory for a standard-relay WalletConnect connector that coexists
+ * with WagmiAdapter's CROSS-relay walletConnect. Used only in
+ * `toNexusAdapter` mode where the 'walletConnect' id is already taken;
+ * `reownAdapter` mode just uses the built-in id directly.
+ *
+ * `showQrModal: true` delegates QR rendering to `@walletconnect/modal`
+ * (pulled in by the provider) so users without an extension can still
+ * complete the flow without crossx-kit having to ship its own QR UI.
+ */
+export declare function createReownWalletConnectConnector(params: {
+    projectId: string;
+    metadata?: {
+        name: string;
+        description?: string;
+        url: string;
+        icons?: string[];
+    };
+}): CreateConnectorFn;
+/**
+ * Convert our env-agnostic `NetworkConfig[]` into viem `Chain[]` for
+ * wagmi's `createConfig`. Only used by the reown path; `toNexusAdapter`
+ * uses CAIP-formatted preset networks from `@to-nexus/sdk` instead.
+ */
+export declare function toViemChain(network: CrossConnectKitConfig['networks'][number]): Chain;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/adapters/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/adapters/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAQvE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAE1D;;;;GAIG;AAEH,wBAAgB,gBAAgB,CAC9B,IAAI,SAAkB,EACtB,WAAW,SAAkB,GAC5B,cAAc,CAShB;AAED,wBAAgB,mBAAmB,IAAI,cAAc,CAWpD;AAED,wBAAgB,aAAa,CAC3B,YAAY,EAAE,OAAO,GAAG,OAAO,EAC/B,mBAAmB,GAAE,MAAM,GAAG,SAA2B,GACxD,cAAc,CAehB;AAED,wBAAgB,YAAY,CAC1B,YAAY,EAAE,OAAO,GAAG,OAAO,EAC/B,WAAW,SAAkB,GAC5B,cAAc,CAYhB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH,GAAG,iBAAiB,CA6BpB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,CAarF"}

package/dist/adapters/helpers.js

@@ -0,0 +1,124 @@
+import { walletConnect } from 'wagmi/connectors';
+import { BINANCE_ICON, CROSSX_ICON, EXTENSION_ICON, METAMASK_ICON, } from '../wallets/icons.js';
+/**
+ * Connector id used for the standard Reown-relay WalletConnect
+ * connector in `toNexusAdapter` mode. Coexists with WagmiAdapter's
+ * internal 'walletConnect' (CROSS relay) so Binance and mobile
+ * MetaMask (which only speak the official WC relay) can still pair.
+ */
+export const REOWN_WC_CONNECTOR_ID = 'walletConnectReown';
+/**
+ * Registry entries shared by both built-in adapters. Keeping them in one
+ * place ensures wallet order and metadata match regardless of which
+ * relay transport the DApp picks.
+ */
+export function crossWalletEntry(name = 'CROSSx Wallet', connectorId = 'walletConnect') {
+    return {
+        walletId: 'cross_wallet',
+        providerKind: 'cross',
+        type: 'app',
+        connectorId,
+        name,
+        iconUrl: CROSSX_ICON,
+    };
+}
+export function crossExtensionEntry() {
+    return {
+        walletId: 'cross_extension',
+        providerKind: 'cross',
+        type: 'extension',
+        connectorId: 'nexus.to.crosswallet.desktop',
+        name: 'CROSSx Extension',
+        iconUrl: EXTENSION_ICON,
+        installUrl: 'https://chromewebstore.google.com/detail/crossx/nninbdadmocnokibpaaohnoepbnpdgcg',
+    };
+}
+export function metamaskEntry(providerKind, fallbackConnectorId = 'walletConnect') {
+    return {
+        walletId: 'metamask',
+        providerKind,
+        type: 'external',
+        connectorId: 'injected',
+        // wagmi's MIPD elevates `injected` to the EIP-6963 rdns once the
+        // MetaMask extension announces itself; register both forms so
+        // `resolveCurrentWallet` maps correctly after connect.
+        aliasConnectorIds: ['io.metamask', 'metaMaskSDK'],
+        name: 'MetaMask',
+        iconUrl: METAMASK_ICON,
+        installUrl: 'https://metamask.io/download/',
+        fallbackConnectorId,
+    };
+}
+export function binanceEntry(providerKind, connectorId = 'walletConnect') {
+    return {
+        walletId: 'binance',
+        providerKind,
+        type: 'external',
+        connectorId,
+        // Same MIPD-aliasing case as MetaMask — Binance Wallet extension
+        // announces `com.binance.wallet` via EIP-6963 on desktop.
+        aliasConnectorIds: ['com.binance.wallet'],
+        name: 'Binance Wallet',
+        iconUrl: BINANCE_ICON,
+    };
+}
+/**
+ * Factory for a standard-relay WalletConnect connector that coexists
+ * with WagmiAdapter's CROSS-relay walletConnect. Used only in
+ * `toNexusAdapter` mode where the 'walletConnect' id is already taken;
+ * `reownAdapter` mode just uses the built-in id directly.
+ *
+ * `showQrModal: true` delegates QR rendering to `@walletconnect/modal`
+ * (pulled in by the provider) so users without an extension can still
+ * complete the flow without crossx-kit having to ship its own QR UI.
+ */
+export function createReownWalletConnectConnector(params) {
+    const factory = walletConnect({
+        projectId: params.projectId,
+        metadata: params.metadata
+            ? {
+                name: params.metadata.name,
+                description: params.metadata.description ?? '',
+                url: params.metadata.url,
+                icons: params.metadata.icons ?? [],
+            }
+            : undefined,
+        showQrModal: true,
+    });
+    return ((config) => {
+        const connector = factory(config);
+        // Override id so wagmi sees it as a distinct connector from
+        // WagmiAdapter's CROSS-relay 'walletConnect'.
+        Object.defineProperty(connector, 'id', {
+            value: REOWN_WC_CONNECTOR_ID,
+            configurable: true,
+            writable: false,
+        });
+        Object.defineProperty(connector, 'name', {
+            value: 'WalletConnect',
+            configurable: true,
+            writable: true,
+        });
+        return connector;
+    });
+}
+/**
+ * Convert our env-agnostic `NetworkConfig[]` into viem `Chain[]` for
+ * wagmi's `createConfig`. Only used by the reown path; `toNexusAdapter`
+ * uses CAIP-formatted preset networks from `@to-nexus/sdk` instead.
+ */
+export function toViemChain(network) {
+    return {
+        id: network.id,
+        name: network.name,
+        nativeCurrency: network.nativeCurrency,
+        rpcUrls: {
+            default: { http: [network.rpcUrl] },
+        },
+        blockExplorers: network.blockExplorerUrl
+            ? { default: { name: 'Explorer', url: network.blockExplorerUrl } }
+            : undefined,
+        testnet: network.testnet,
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/adapters/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/adapters/helpers.ts"],"names":[],"mappings":"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"}

package/dist/adapters/reownAdapter.d.ts

@@ -0,0 +1,20 @@
+import type { CreateConnectorFn } from 'wagmi';
+import { type WalletConnectAdapter } from './types.js';
+export interface ReownAdapterOptions {
+    /**
+     * Override the AppKit theme mode. Falls back to `CrossConnectKitConfig.theme.mode`
+     * when omitted.
+     */
+    readonly themeMode?: 'light' | 'dark';
+}
+/**
+ * Reown-side adapter backed by `@reown/appkit-adapter-wagmi` + the
+ * Reown Connect / ConnectingWalletConnect views. When the user picks
+ * MetaMask or Binance from crossx-kit's modal, `beforeConnect` opens
+ * Reown's native AppKit modal — the QR code rendered there shows the
+ * wallet's own logo (MetaMask fox, Binance diamond) instead of the
+ * generic WalletConnect glyph.
+ */
+export declare function reownAdapter(_options?: ReownAdapterOptions): WalletConnectAdapter;
+export type { CreateConnectorFn };
+//# sourceMappingURL=reownAdapter.d.ts.map

package/dist/adapters/reownAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reownAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/reownAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,iBAAiB,EAAE,MAAM,OAAO,CAAC;AA6BvD,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AA6IpB,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,GAAE,mBAAwB,GACjC,oBAAoB,CAkFtB;AAID,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/adapters/reownAdapter.js

@@ -0,0 +1,213 @@
+import { createAppKit } from '@reown/appkit';
+import { WagmiAdapter } from '@reown/appkit-adapter-wagmi';
+import { resolveThemeMode } from '@nexus-cross/connect-kit-core';
+/**
+ * `kitConfig.theme` accepts both the literal string form (`'dark'`) and
+ * the legacy `Partial<Theme>` object (`{ mode: 'dark' }`). Normalize
+ * both to a plain `ThemeMode` for Reown's AppKit options.
+ */
+function resolveKitThemeMode(theme) {
+    return resolveThemeMode(theme, undefined);
+}
+import { mainnet, sepolia, bsc, bscTestnet, } from '@reown/appkit/networks';
+import { binanceEntry, metamaskEntry, } from './helpers.js';
+/**
+ * Map of EIP-155 chain IDs → Reown preset `AppKitNetwork`. Reown's
+ * `createAppKit` / `WagmiAdapter` require these typed objects (not raw
+ * `NetworkConfig`). DApps that use chains outside this set should limit
+ * their reown side to the supported networks or open an upstream issue
+ * to get the preset added.
+ */
+const REOWN_PRESET_NETWORKS_BY_ID = new Map([
+    [mainnet.id, mainnet],
+    [sepolia.id, sepolia],
+    [bsc.id, bsc],
+    [bscTestnet.id, bscTestnet],
+]);
+/**
+ * Canonical WalletConnect Cloud wallet IDs for the wallets we surface
+ * via Reown's Connect view. Generic IDs — stable across projects —
+ * not DApp-scoped. Same values posa uses in its Reown AppKit config.
+ */
+const METAMASK_WC_ID = 'c57ca95b47569778a828d19178114f4db188b89b763c899ba0be274e97267d96';
+const BINANCE_WC_ID = '8a0ee50d1f22f6651afcae7eb4253e52a3310b90af5daef78a8c4929a9bb99d4';
+const WALLET_ID_ALLOWLIST = [METAMASK_WC_ID, BINANCE_WC_ID];
+/** Mirrors posa's `isMetaMaskInstalled` — non-Cross, non-Binance injected. */
+function isMetaMaskExtensionInstalled() {
+    if (typeof window === 'undefined')
+        return false;
+    const eth = window.ethereum;
+    if (!eth)
+        return false;
+    if (eth.providers?.length) {
+        return eth.providers.some((p) => p.isMetaMask && !p.isCross && !p.isBinance);
+    }
+    return !!eth.isMetaMask && !eth.isCross && !eth.isBinance;
+}
+const bootstrapCache = new Map();
+function resolveReownNetworks(kitNetworks) {
+    const result = [];
+    const unsupported = [];
+    for (const net of kitNetworks) {
+        const preset = REOWN_PRESET_NETWORKS_BY_ID.get(net.id);
+        if (preset)
+            result.push(preset);
+        else
+            unsupported.push(net.id);
+    }
+    if (result.length === 0) {
+        throw new Error(`[crossx-kit] reownAdapter: none of [${unsupported.join(', ')}] match a ` +
+            'Reown preset network. Currently supported: Ethereum mainnet/sepolia, ' +
+            'BSC mainnet/testnet. CROSS chains are handled by toNexusAdapter — ' +
+            'the reown side needs at least one chain that Reown knows about.');
+    }
+    return result;
+}
+function bootstrapReown(input) {
+    const { kitConfig, extraConnectors } = input;
+    if (!kitConfig.reownProjectId) {
+        throw new Error('[crossx-kit] reownAdapter requires CrossConnectKitConfig.reownProjectId — ' +
+            'register a WalletConnect Cloud project at https://cloud.reown.com.');
+    }
+    const key = kitConfig.reownProjectId;
+    const existing = bootstrapCache.get(key);
+    if (existing)
+        return existing;
+    const networks = resolveReownNetworks(kitConfig.networks);
+    const connectors = extraConnectors.map((e) => e.connector);
+    const wagmiAdapter = new WagmiAdapter({
+        projectId: kitConfig.reownProjectId,
+        networks,
+        connectors,
+        ssr: kitConfig.ssr,
+    });
+    // Match posa's `getReownAppKitConfig` (wallet-support.ts:91-121) so
+    // the modal stays focused on the two wallets we actually surface
+    // (MetaMask / Binance) and never auto-prompts a chain switch —
+    // posa's users are used to handling chain mismatches themselves via
+    // the connected wallet's own UI.
+    const options = {
+        adapters: [wagmiAdapter],
+        projectId: kitConfig.reownProjectId,
+        networks: networks,
+        metadata: {
+            name: kitConfig.appMetadata.name,
+            description: kitConfig.appMetadata.description ?? '',
+            url: kitConfig.appMetadata.url,
+            icons: kitConfig.appMetadata.icons ?? [],
+        },
+        features: {
+            email: false,
+            socials: false,
+            analytics: false,
+            onramp: false,
+            swaps: false,
+            send: false,
+            history: false,
+            receive: false,
+        },
+        allWallets: 'HIDE',
+        includeWalletIds: [...WALLET_ID_ALLOWLIST],
+        featuredWalletIds: [...WALLET_ID_ALLOWLIST],
+        enableNetworkSwitch: false,
+        enableCoinbase: false,
+        themeMode: resolveKitThemeMode(kitConfig.theme),
+    };
+    const appKit = createAppKit(options);
+    const wagmiConfig = wagmiAdapter
+        .wagmiConfig;
+    const entry = { appKit, wagmiConfig };
+    bootstrapCache.set(key, entry);
+    return entry;
+}
+/**
+ * Reown-side adapter backed by `@reown/appkit-adapter-wagmi` + the
+ * Reown Connect / ConnectingWalletConnect views. When the user picks
+ * MetaMask or Binance from crossx-kit's modal, `beforeConnect` opens
+ * Reown's native AppKit modal — the QR code rendered there shows the
+ * wallet's own logo (MetaMask fox, Binance diamond) instead of the
+ * generic WalletConnect glyph.
+ */
+export function reownAdapter(_options = {}) {
+    return {
+        providerKind: 'reown',
+        buildWagmiConfig(input) {
+            const { wagmiConfig } = bootstrapReown(input);
+            const registryEntries = [
+                ...input.extraConnectors
+                    .map((e) => e.registryEntry)
+                    .filter((e) => e !== null),
+                // Extension MetaMask path: wagmi's injected auto-added by
+                // WagmiAdapter. Mobile fallback: AppKit's Connect view (opened
+                // via beforeConnect).
+                metamaskEntry('reown', 'walletConnect'),
+                binanceEntry('reown', 'walletConnect'),
+            ];
+            return { wagmiConfig, registryEntries };
+        },
+        beforeConnect({ kitConfig }, walletId) {
+            if (!kitConfig.reownProjectId)
+                return 'defer';
+            const entry = bootstrapCache.get(kitConfig.reownProjectId);
+            if (!entry)
+                return 'defer';
+            // MetaMask + extension installed: let wagmi's `injected` connector
+            // fire directly so the user sees only the extension's native
+            // approval popup — no AppKit wallet picker in between. Matches
+            // posa's `connectMetaMask` fast path (WalletProvider.tsx:310-334).
+            if (walletId === 'metamask' && isMetaMaskExtensionInstalled()) {
+                return 'defer';
+            }
+            // Every other external wallet (Binance, MetaMask mobile) goes
+            // through the Reown Connect modal. `allWallets: 'HIDE'` +
+            // `includeWalletIds` trims the list so only the supported two
+            // wallets appear; clicking one routes to the QR view with its
+            // own logo.
+            if (walletId === 'metamask' || walletId === 'binance') {
+                entry.appKit.open({ view: 'Connect' }).catch((err) => {
+                    if (typeof console !== 'undefined') {
+                        console.warn('[crossx-kit] reownAdapter: appKit.open failed', err);
+                    }
+                });
+                return 'handled';
+            }
+            return 'defer';
+        },
+        subscribeModalState({ kitConfig }, callback) {
+            if (!kitConfig.reownProjectId)
+                return () => { };
+            const entry = bootstrapCache.get(kitConfig.reownProjectId);
+            if (!entry)
+                return () => { };
+            let lastOpen;
+            return entry.appKit.subscribeState((state) => {
+                const next = state.open === true;
+                if (next !== lastOpen) {
+                    lastOpen = next;
+                    callback(next);
+                }
+            });
+        },
+        closeModal({ kitConfig }) {
+            if (!kitConfig.reownProjectId)
+                return;
+            const entry = bootstrapCache.get(kitConfig.reownProjectId);
+            if (!entry)
+                return;
+            const close = entry.appKit
+                .close;
+            if (typeof close !== 'function')
+                return;
+            try {
+                const result = close.call(entry.appKit);
+                if (result && typeof result.then === 'function') {
+                    result.catch(() => { });
+                }
+            }
+            catch {
+                /* best-effort */
+            }
+        },
+    };
+}
+//# sourceMappingURL=reownAdapter.js.map

package/dist/adapters/reownAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reownAdapter.js","sourceRoot":"","sources":["../../src/adapters/reownAdapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/toNexusAdapter.d.ts

@@ -0,0 +1,12 @@
+import { type WalletConnectAdapter } from './types.js';
+export interface ToNexusAdapterOptions {
+    readonly displayName?: string;
+}
+/**
+ * Adapter backed by `@to-nexus/appkit-adapter-wagmi` — the CROSS-relay
+ * fork of Reown AppKit. Owns the wagmi `Config` so AppKit's native UI
+ * (QR modal, deep-link, Cross Extension approval flow) stays in sync
+ * with the kit's `useAccount` / `useConnect` state.
+ */
+export declare function toNexusAdapter(options?: ToNexusAdapterOptions): WalletConnectAdapter;
+//# sourceMappingURL=toNexusAdapter.d.ts.map

package/dist/adapters/toNexusAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toNexusAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/toNexusAdapter.ts"],"names":[],"mappings":"AAoBA,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAuGpB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CAyFtB"}