React Native SDK quickstart - Polygon Developer Docs

This quickstart creates one wallet client, signs in with email OTP, and submits a zero-value transaction on Polygon Amoy.

Install the SDK

The SDK supports React Native 0.85 or newer with React 19.2 or newer. Android requires minSdk 24, compileSdk 36, Java 17, and Android 10 or newer at runtime. iOS requires deployment target 15.1 or newer and Xcode 26 for bare React Native; Expo apps use their Expo SDK’s iOS and Xcode minimums.

Bare React Native
Expo

npm install @polygonlabs/oms-wallet-react-native@0.4.0
npx pod-install

React Native autolinking connects the Android and iOS modules. On iOS, the module pulls the Swift SDK with Swift Package Manager through React Native’s spm_dependency, so keep the react_native_post_install call in your Podfile’s post_install hook, as in the React Native template.

npx expo install @polygonlabs/oms-wallet-react-native@0.4.0
npx expo prebuild
npx expo run:ios
# or: npx expo run:android

Use Expo SDK 56 or newer with a development build or EAS Build. The package contains native code, so it does not run in Expo Go. It does not require an SDK config plugin.

React Native Web is not supported.

Create the client

Create exactly one OMSWallet instance and reuse it for the lifetime of the app. Constructing another instance replaces the native client behind the first instance, and calls on the earlier instance throw an error.

wallet.ts

import { OMSWallet } from '@polygonlabs/oms-wallet-react-native'

export const omsWallet = new OMSWallet({
  publishableKey: 'YOUR_PUBLISHABLE_KEY',
})

Use omsWallet.wallet for authenticated wallet operations. Use the independent omsWallet.indexer client for read-only balance and history queries.

Authenticate with email

Request a one-time code, then complete authentication with the code entered by the user:

await omsWallet.wallet.startEmailAuth({
  email: 'user@example.com',
})

const { wallet } = await omsWallet.wallet.completeEmailAuth({
  code: '123456',
})

console.log('Active wallet:', wallet?.address)

Automatic wallet selection is the default. The result is a completed wallet session for the selected wallet; wallet is undefined only when you request manual selection.

Send a test transaction

Wallet writes require the active session created above. Use a value in raw base units and an exported network:

import { Networks } from '@polygonlabs/oms-wallet-react-native'

const transaction = await omsWallet.wallet.sendTransaction({
  network: Networks.amoy,
  to: '0x1111111111111111111111111111111111111111',
  value: '0',
})

console.log(transaction.status, transaction.txnHash ?? transaction.txnId)

The method prepares, executes, and waits for transaction status by default. See send transactions for fee selection and polling controls. Continue with authentication for native provider ID tokens, redirects, and manual wallet selection. See send transactions for contract calls, fee behavior, and status handling.

​Install the SDK

​Create the client

​Authenticate with email

​Send a test transaction

Install the SDK

Create the client

Authenticate with email

Send a test transaction