Connections on React Native

This is an enterprise-only feature. Please contact us to enable.

On React Native the Connections contract is the same as the web and iOS, run in a web auth session. Works in Expo and bare React Native with Expo modules. The whole integration is one file, FireblocksConnect.ts.

Use expo-web-browser’s openAuthSessionAsync — it’s ASWebAuthenticationSession on iOS and Chrome Custom Tabs on Android, the same “open web, return via a callback scheme” primitive, run ephemerally (no consent prompt).

1. Install the modules

All three work in Expo and bare React Native.

terminal

npx expo install expo-web-browser expo-linking expo-crypto

2. Register your URL scheme

For Expo, set it in app.json. For bare React Native, add it to Info.plist (CFBundleURLTypes) and an Android intent-filter in AndroidManifest.xml.

app.json

{ "expo": { "scheme": "myapp" } }

3. Connect and use the result

One call. The nonce is verified for you, and some wallets (Phantom) return out-of-band and are handled inside connectWallet via an expo-linking listener — so, unlike the raw iOS integration, you don’t wire onOpenURL yourself.

ConnectButton.tsx

import { connectWallet } from "./FireblocksConnect";

try {
  const wallet = await connectWallet({
    flowURL: "https://your-connect-page.example/",
    scheme: "myapp",
  });
  // wallet.address, wallet.chain,
  // wallet.walletName, wallet.walletImage
} catch (e) {
  // FireblocksConnectCancelled | FireblocksConnectError
}

walletImage is usually an SVG-sprite URL — render it in a react-native-webview <img> rather than <Image>.

Common pitfalls

Test on a physical device. Wallets don’t run in the Simulator, so real wallet round-trips require a real device.
Serve over HTTPS. The flow mints WalletConnect URIs via WebCrypto, which needs a secure context.
Phantom has no WalletConnect option; the hosted page routes it to its in-app browser and this module catches the return. Validate on device.

Get Started

Integration guides

Connections on React Native

1. Install the modules

2. Register your URL scheme

3. Connect and use the result

Common pitfalls

​1. Install the modules

​2. Register your URL scheme

​3. Connect and use the result

​Common pitfalls

1. Install the modules

2. Register your URL scheme

3. Connect and use the result

Common pitfalls