react-wallet

This library was generated with Nx.

Running unit tests

Run nx test react-wallet to execute the Jest unit tests.

WalletConnect is provided by the bifront-sdk-wallet and provider-utils dependency chain instead of being duplicated in this bundle. Before publishing, review the Reown release gate documented in the provider-utils package's THIRD_PARTY_NOTICES.md.

The context exposes walletconnectPairingUri for custom pairing UI and providerTransportType when transport-specific behavior is needed. It also exposes initializationError when the committed initialization effect fails; the effect ignores completions after unmount. wcUri remains a deprecated alias, and providerType intentionally remains pockie when Pockie connects over WalletConnect. React is a peer dependency so the package does not ship a second React runtime; both React 18.2+ and React 19 are supported for the currently known SDK consumers.

WalletProvider constructs an inert Wallet during render, initializes it only after React commits, and destroys it on unmount. The StrictMode regression test asserts that every initialized lifecycle generation receives a matching cleanup and that the old 100 ms initialization poll is not reintroduced. Optional provider health checks await their asynchronous result before deciding whether to disconnect, so an unresolved promise cannot be mistaken for a healthy provider.