ConnectModal

<ConnectModal> is the Radix Dialog that drives wallet selection. It's an ecosystem-first two-step picker: the user first chooses an ecosystem (EVM / Solana — Stellar and Starknet slots later), then picks a wallet within that ecosystem. The wallet list is scoped to the chosen branch so MetaMask under EVM and MetaMask Snap under Solana can never get crossed.

<WhiskSend> opens it when the user clicks the connect CTA. Import it directly only if you're building your own shell.

import { ConnectModal } from "@usewhisk/react";

Props

Controlled

const [open, setOpen] = useState(false);

<button onClick={() => setOpen(true)}>Connect</button>
<ConnectModal open={open} onOpenChange={setOpen} />

Behaviour

• Ecosystem step — shown when the provider config registers more than one ecosystem (e.g. both evm() and solana()). If only one is configured, the modal skips straight to that ecosystem's wallet list (no pointless extra click).
• Back button — visible on the wallet-list step when both ecosystems are configured. Returns to the ecosystem picker.
• Auto-close — fires when the connection on the ecosystem the user picked completes. Connections on the other ecosystem (e.g. wagmi auto-reconnect mid-Solana flow) don't close the modal, so the picked flow can finish.
• Errors surface inline. EVM connector errors and Solana adapter errors render under the wallet list rather than being swallowed.

Once the user connects, the modal closes itself. From there, your own UI (or any Whisk component) can read connection state from useWhiskAccount.