feat: wallet configuration, availability detection, and @stacks/connect 8.2.5

[satoshai-dev]

Summary

• Pin @stacks/connect from ^8.2.2 to 8.2.5
• Leverage WalletConnect.initializeProvider() for faster WC connections and session restores
• Add wallets prop to StacksWalletProvider to configure which wallets are supported
• Add useWallets hook — returns configured wallets with { id, available } shape
• Add reset to useConnect — clears stuck connecting state when wallet modals are dismissed
• Runtime guard: throws if wallet-connect is in wallets without walletConnect.projectId
• Remove connectors from useConnect (replaced by useWallets)
• Fix runtime guard crash under React Strict Mode (moved from render body to useEffect)
• Fix reset() not cancelling in-flight connect() promises (generation counter prevents stale state)
• Fix WalletConnect double initializeProvider race between session restore and connect

Changes since @stacks/connect 8.2.2

8.2.5 (2026-02-20)

• feat: Expose WalletConnect.initializeProvider for independent initialization (stx-labs/connect#472)
• fix: Lazy-load @reown/appkit to reduce initial bundle size (stx-labs/connect#494)

8.2.4 (2025-12-17)

• fix: Default provider regression — array ordering bug (stx-labs/connect#486)

8.2.3 (2025-11-25)

• fix: WalletConnect connection failing when no params passed (stx-labs/connect#476)

New public API

wallets prop

<StacksWalletProvider wallets={['xverse', 'leather', 'wallet-connect']} walletConnect={{ projectId: '...' }}>

useWallets

const { wallets } = useWallets();
// [{ id: 'xverse', available: true }, { id: 'leather', available: false }, ...]

{wallets.map(({ id, available }) => (
    <button disabled={!available} onClick={() => connect(id)}>{id}</button>
))}

reset (via useConnect)

const { connect, reset, isPending } = useConnect();
// reset() clears stuck "Connecting..." state when wallet modals hang

Known issues

• @stacks/connect request() promise never rejects when WalletConnect modal is dismissed
• OKX wallet SDK has the same hanging promise behavior on popup close
• reset() is the consumer-side workaround for both cases
• See walletInfos memo invalidated on every render with inline wallets array #5, OKX connect failure disconnects wrong provider #6, Session restore ignores walletConnect chains/metadata changes #7, useXverse: early-exit async setup on effect cleanup #8 for lower-priority improvements deferred from this PR

Test plan

• Typecheck passes
• All 40 unit tests pass
• Build succeeds
• Manual: connect with Xverse/Leather — works as before
• Manual: WalletConnect connection with project ID
• Manual: close WC modal → reset clears pending state
• Manual: close OKX popup → reset clears pending state
• Manual: unavailable wallets show as disabled

Closes #1

🤖 Generated with Claude Code