Skip to main content

Wallet Integration

This guide covers connecting wallets and authenticating users with the Privacy Boost React Native SDK.

WalletDelegate Interface

The SDK interacts with wallets through the WalletDelegate interface:
The SDK calls waitForTransactionReceipt after sendTransaction to confirm on-chain inclusion and read emitted events (e.g. the Shield event). It should poll eth_getTransactionReceipt until the receipt is available.

Basic Authentication

See Getting Started → Connecting a Wallet for full handling of each AuthResult variant, including the mnemonic flow for first-time users.

WalletConnect Integration

Logout

State Accessors

Complete Example

Error Handling

Best Practices

1. Handle Signature Rejection Silently

When users cancel the wallet signature, don’t show an error.

2. Save Session After Authentication

Use session persistence to avoid re-signing on app restart. See Session Storage.

3. Show Connection State

Display the privacy address so users can verify which account is active.

Next Steps