React Native Blockchain Interaction - Polygon Developer Docs

All wallet operations require configure and an active wallet session. React Native wallet, transaction, signature, and balance APIs take chainId as a string, such as 137 for Polygon mainnet or 80002 for Polygon Amoy.

import { getWalletAddress } from '@0xsequence/oms-react-native-sdk'

const walletAddress = await getWalletAddress()

if (!walletAddress) {
  throw new Error('No active wallet session')
}

Get Supported Networks

List networks supported by this SDK build.

import { getSupportedNetworks } from '@0xsequence/oms-react-native-sdk'

const networks = await getSupportedNetworks()
const amoy = networks.find((network) => network.chainId === '80002')

console.log(amoy?.displayName)

Parameters Takes no parameters. Returns Returns Promise<OmsNetwork[]>.

Field	Type	Description
`chainId`	`string`	EVM chain ID as a string.
`name`	`string`	Network registry name.
`nativeTokenSymbol`	`string`	Native token symbol.
`explorerUrl`	`string`	Block explorer URL.
`displayName`	`string`	Display name for UI.

Send A Transaction

sendTransaction sends native tokens when you pass to and value. Values are raw base-unit integer strings.

import { parseUnits, sendTransaction } from '@0xsequence/oms-react-native-sdk'

const tx = await sendTransaction({
  chainId: '80002',
  to: '0xRecipient',
  value: parseUnits('0.01', 18),
})

console.log(tx.txnHash ?? tx.txnId)

Parameters

Parameter	Type	Description
`chainId`	`string`	EVM chain ID as a string.
`to`	`string`	Recipient address or contract address.
`value`	`string`	Raw base-unit native token value.
`data`	`string`, `null`, or undefined	Encoded calldata for raw calldata transactions.
`mode`	`'native'`, `'relayer'`, or undefined	Transaction mode.
`selectFeeOption`	`OmsFeeOptionSelector`, `null`, or undefined	Optional callback for selecting a fee option.
`waitForStatus`	`boolean` or undefined	Defaults to `true`. Pass `false` to return immediately after transaction execution starts.
`statusPolling`	`OmsTransactionStatusPollingOptions` or undefined	Optional post-execute polling controls.

Returns Returns Promise<OmsSendTransactionResponse>.

Field	Type	Description
`txnId`	`string`	Wallet transaction ID.
`status`	`string`	Latest transaction status returned by OMS Wallet.
`txnHash`	`string` or `null`	On-chain transaction hash when available.

Send Raw Calldata

Use data when you already have encoded calldata.

import { sendTransaction } from '@0xsequence/oms-react-native-sdk'

const tx = await sendTransaction({
  chainId: '80002',
  to: '0xTokenContract',
  value: '0',
  data: '0xa9059cbb000000000000000000000000...',
})

console.log('Contract transaction:', tx.txnHash ?? tx.txnId)

Parameters Use the same sendTransaction parameters. Returns Returns Promise<OmsSendTransactionResponse>.

Call A Contract

Use callContract when you want the SDK to submit a method-string contract call.

import { callContract, parseUnits } from '@0xsequence/oms-react-native-sdk'

const amount = parseUnits('1', 6)

const tx = await callContract({
  chainId: '80002',
  contractAddress: '0xTokenContract',
  method: 'transfer(address,uint256)',
  args: [
    { type: 'address', value: '0xRecipient' },
    { type: 'uint256', value: amount },
  ],
})

console.log('Contract transaction:', tx.txnHash ?? tx.txnId)

Parameters

Parameter	Type	Description
`chainId`	`string`	EVM chain ID as a string.
`contractAddress`	`string`	Contract address to call.
`method`	`string`	ABI method signature, such as `transfer(address,uint256)`.
`args`	`CallContractArg[]`, `null`, or undefined	Method arguments as Wallet API ABI args.
`mode`	`'native'`, `'relayer'`, or undefined	Transaction mode.
`selectFeeOption`	`OmsFeeOptionSelector`, `null`, or undefined	Optional callback for selecting a fee option.
`waitForStatus`	`boolean` or undefined	Defaults to `true`. Pass `false` to return immediately after transaction execution starts.
`statusPolling`	`OmsTransactionStatusPollingOptions` or undefined	Optional post-execute polling controls.

Returns Returns Promise<OmsSendTransactionResponse>. By default, transaction methods poll for status after execute until the status resolves or the default timeout is reached. Pass waitForStatus: false to return immediately after execute, or pass statusPolling to tune timeoutMs, intervalMs, fastIntervalMs, and fastPollCount.

Select A Fee Option

When OMS Wallet returns fee options, pass selectFeeOption. The selector receives fee options enriched with the wallet balance for each token when available. Use a first-available selector when you want to choose the first fee option whose availableRaw balance covers the quoted fee value. The current React Native wrapper exposes fee selection through the selectFeeOption callback shape. On testnets, fee options are automatically sponsored, so you usually do not need to choose a fee token.

import {
  sendTransaction,
  type OmsFeeOptionSelector,
} from '@0xsequence/oms-react-native-sdk'

const firstAvailable: OmsFeeOptionSelector = (feeOptions) =>
  feeOptions.find((option) => {
    if (option.availableRaw == null) {
      return false
    }

    return BigInt(option.availableRaw) >= BigInt(option.feeOption.value)
  })?.selection ?? null

const tx = await sendTransaction({
  chainId: '80002',
  to: '0xRecipient',
  value: '0',
  selectFeeOption: firstAvailable,
})

Return option.selection when choosing a quoted fee option. It uses tokenId when present and falls back to the token symbol for native fee options. Returning null is only valid for sponsored transactions. Parameters selectFeeOption receives OmsFeeOptionWithBalance[]. Each item includes feeOption, selection, and optional balance fields such as availableRaw. Returns Return OmsFeeOptionSelection, null, or a promise for either value.

Get Transaction Status

Fetch the current status for a wallet transaction ID.

import { getTransactionStatus } from '@0xsequence/oms-react-native-sdk'

const status = await getTransactionStatus(tx.txnId)

console.log(status.status, status.txnHash)

Parameters

Parameter	Type	Description
`txnId`	`string`	Wallet transaction ID returned by `sendTransaction` or `callContract`.

Returns Returns Promise<OmsTransactionStatus>.

Field	Type	Description
`status`	`string`	Latest Wallet transaction status.
`txnHash`	`string` or `null`	On-chain transaction hash when available.

Sign A Message

signMessage returns a hex-encoded signature for the active wallet.

import { signMessage } from '@0xsequence/oms-react-native-sdk'

const message = 'Hello from OMS'
const signature = await signMessage('80002', message)

console.log('Signature:', signature)

Parameters

Parameter	Type	Description
`chainId`	`string`	EVM chain ID as a string.
`message`	`string`	Plaintext message to sign.

Returns Returns Promise<string>, the hex-encoded signature.

Verify A Message Signature

verifyMessageSignature verifies a message signature against the active wallet session.

import { verifyMessageSignature } from '@0xsequence/oms-react-native-sdk'

const isValid = await verifyMessageSignature({
  chainId: '80002',
  message,
  signature,
})

console.log('Signature valid:', isValid)

Parameters

Parameter	Type	Description
`chainId`	`string`	EVM chain ID as a string.
`message`	`string`	Original plaintext message.
`signature`	`string`	Hex-encoded signature to verify.

Returns Returns Promise<boolean>.

Sign Typed Data

Use signTypedData for EIP-712 typed data.

import { signTypedData } from '@0xsequence/oms-react-native-sdk'

const typedData = {
  domain: {
    name: 'Example App',
    version: '1',
    chainId: 80002,
  },
  types: {
    Message: [{ name: 'contents', type: 'string' }],
  },
  primaryType: 'Message',
  message: {
    contents: 'Hello from OMS',
  },
}

const typedSignature = await signTypedData({
  chainId: '80002',
  typedData,
})

Parameters

Parameter	Type	Description
`chainId`	`string`	EVM chain ID as a string.
`typedData`	`unknown`	EIP-712 typed-data payload. Must be JSON serializable.

Returns Returns Promise<string>, the hex-encoded signature.

Verify Typed Data

Verify an EIP-712 signature against the active wallet session.

import { verifyTypedDataSignature } from '@0xsequence/oms-react-native-sdk'

const isTypedDataValid = await verifyTypedDataSignature({
  chainId: '80002',
  typedData,
  signature: typedSignature,
})

Parameters

Parameter	Type	Description
`chainId`	`string`	EVM chain ID as a string.
`typedData`	`unknown`	Original EIP-712 typed-data payload. Must be JSON serializable.
`signature`	`string`	Hex-encoded signature to verify.

Returns Returns Promise<boolean>.

Parse Units

Convert a decimal display value to a raw base-unit integer string.

import { parseUnits } from '@0xsequence/oms-react-native-sdk'

const rawAmount = parseUnits('1.00', 6)

console.log(rawAmount)

Parameters

Parameter	Type	Description
`value`	`string`	Decimal display value.
`decimals`	`number` or undefined	Token decimals. Defaults to `18`.
`options.roundingMode`	`'reject'` or `'nearest'`	Defaults to `'nearest'`. Use `'reject'` to fail on non-zero fractional precision beyond `decimals`.

Returns Returns string.

Format Units

Convert a raw base-unit value to a decimal display string.

import { formatUnits } from '@0xsequence/oms-react-native-sdk'

const displayAmount = formatUnits('1000000', 6)

console.log(displayAmount)

Parameters

Parameter	Type	Description
`value`	`string` or `bigint`	Raw base-unit integer value.
`decimals`	`number` or undefined	Token decimals. Defaults to `18`.

Returns Returns string.

​Get Supported Networks

​Send A Transaction

​Send Raw Calldata

​Call A Contract

​Select A Fee Option

​Get Transaction Status

​Sign A Message

​Verify A Message Signature

​Sign Typed Data

​Verify Typed Data

​Parse Units

​Format Units

Get Supported Networks

Send A Transaction

Send Raw Calldata

Call A Contract

Select A Fee Option

Get Transaction Status

Sign A Message

Verify A Message Signature

Sign Typed Data

Verify Typed Data

Parse Units

Format Units