Wallet Operations - Polygon Developer Docs

Your app can read balances for any address without signing in. Signing messages and submitting transactions require an active non-custodial wallet session. The examples below use the OMS Wallet SDKs.

Get wallet address

TypeScript
React Native
Swift
Kotlin

const activeWallet = omsWallet.wallet.activeWallet

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

console.log('Wallet address:', activeWallet.address)

const activeWallet = omsWallet.wallet.activeWallet

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

console.log('Wallet address:', activeWallet.address)

import Foundation

guard let activeWallet = omsWallet.wallet.activeWallet else {
    throw NSError(domain: "App", code: 1, userInfo: [NSLocalizedDescriptionKey: "No active wallet session"])
}

print("Wallet address:", activeWallet.address)

val activeWallet = requireNotNull(omsWallet.wallet.activeWallet) {
    "No wallet selected"
}

println("Wallet address: ${activeWallet.address}")

Read balances

TypeScript
React Native
Swift
Kotlin

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

const result = await omsWallet.indexer.getBalances({
  walletAddress: '0x1111111111111111111111111111111111111111',
  networks: [Networks.polygon],
})

for (const balance of result.nativeBalances) {
  console.log(balance.symbol, balance.balance)
}

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

const result = await omsWallet.indexer.getBalances({
  walletAddress: '0x1111111111111111111111111111111111111111',
  networks: [Networks.polygon],
})

for (const balance of result.nativeBalances) {
  console.log(balance.symbol, balance.balance)
}

let result = try await omsWallet.indexer.getBalances(
    GetBalancesParams(
        walletAddress: "0x1111111111111111111111111111111111111111",
        networks: [.polygon]
    )
)

for balance in result.nativeBalances {
    print(balance.symbol, balance.balance)
}

Kotlin wallet APIs are suspend functions. Call them from a coroutine, such as lifecycleScope.launch in an Android UI.

import technology.polygon.omswallet.Network

val result = omsWallet.indexer.getBalances(
    walletAddress = "0x1111111111111111111111111111111111111111",
    networks = listOf(Network.POLYGON),
)

for (balance in result.nativeBalances) {
    println("${balance.symbol}: ${balance.balance}")
}

These examples query EVM balances. For Solana and Tron balances, use getSolanaBalances and getTronBalances. See the SDK-specific Balances and history page for Solana and Tron networks, filters, and result types.

Send a stablecoin payment (USDC)

TypeScript
React Native
Swift
Kotlin

import { Networks } from '@polygonlabs/oms-wallet'
import { parseUnits, type Abi, type Address } from 'viem'

const usdcContract = '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359' as Address
const recipient = '0x1111111111111111111111111111111111111111' as Address
const amount = parseUnits('10', 6)

const erc20Abi = [
  {
    name: 'transfer',
    type: 'function',
    stateMutability: 'nonpayable',
    inputs: [
      { name: 'to', type: 'address' },
      { name: 'amount', type: 'uint256' },
    ],
    outputs: [{ type: 'bool' }],
  },
] as const satisfies Abi

const tx = await omsWallet.wallet.sendTransaction({
  network: Networks.polygon,
  to: usdcContract,
  abi: erc20Abi,
  functionName: 'transfer',
  args: [recipient, amount],
})

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

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

const amount = parseUnits('10', 6)

const tx = await omsWallet.wallet.callContract({
  network: Networks.polygon,
  contractAddress: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
  method: 'transfer',
  args: [
    { type: 'address', value: '0x1111111111111111111111111111111111111111' },
    { type: 'uint256', value: amount },
  ],
})

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

let amount = try parseUnits(value: "10", decimals: 6)

let tx = try await omsWallet.wallet.callContract(
    network: .polygon,
    contractAddress: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    method: "transfer",
    args: [
        AbiArg(type: "address", value: .string("0x1111111111111111111111111111111111111111")),
        AbiArg(type: "uint256", value: .string(amount))
    ]
)

print("Transaction:", tx.txnHash ?? tx.txnId)

import technology.polygon.omswallet.Network
import technology.polygon.omswallet.models.AbiArg
import technology.polygon.omswallet.utils.parseUnits
import kotlinx.serialization.json.JsonPrimitive

val amount = parseUnits("10", 6)

val tx = omsWallet.wallet.callContract(
    network = Network.POLYGON,
    contractAddress = "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    method = "transfer",
    args = listOf(
        AbiArg(type = "address", value = JsonPrimitive("0x1111111111111111111111111111111111111111")),
        AbiArg(type = "uint256", value = JsonPrimitive(amount.toString())),
    ),
)

println("Transaction id: ${tx.txnId}")
println("Transaction hash: ${tx.txnHash}")

Send encoded calldata

TypeScript
React Native
Swift
Kotlin

import { Networks } from '@polygonlabs/oms-wallet'
import type { Address, Hex } from 'viem'

const tx = await omsWallet.wallet.sendTransaction({
  network: Networks.polygon,
  to: '0x3333333333333333333333333333333333333333' as Address,
  value: 0n,
  data: '0x...' as Hex,
})

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

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

const tx = await omsWallet.wallet.sendTransaction({
  network: Networks.polygon,
  to: '0x3333333333333333333333333333333333333333',
  value: '0',
  data: '0x...',
})

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

let tx = try await omsWallet.wallet.sendTransaction(
    network: .polygon,
    request: SendTransactionRequest(
        to: "0x3333333333333333333333333333333333333333",
        value: "0",
        data: "0x..."
    )
)

print("Transaction:", tx.txnHash ?? tx.txnId)

import technology.polygon.omswallet.Network
import technology.polygon.omswallet.models.SendTransactionRequest
import java.math.BigInteger

val tx = omsWallet.wallet.sendTransaction(
    network = Network.POLYGON,
    request = SendTransactionRequest(
        to = "0x3333333333333333333333333333333333333333",
        value = BigInteger.ZERO,
        data = "0x...",
    ),
)

println("Transaction id: ${tx.txnId}")
println("Transaction hash: ${tx.txnHash}")

Call a contract

TypeScript
React Native
Swift
Kotlin

import { Networks } from '@polygonlabs/oms-wallet'
import { parseUnits, type Abi, type Address } from 'viem'

const abi = [
  {
    name: 'transfer',
    type: 'function',
    stateMutability: 'nonpayable',
    inputs: [
      { name: 'to', type: 'address' },
      { name: 'amount', type: 'uint256' },
    ],
    outputs: [{ type: 'bool' }],
  },
] as const satisfies Abi

const tx = await omsWallet.wallet.sendTransaction({
  network: Networks.polygon,
  to: '0x3333333333333333333333333333333333333333' as Address,
  abi,
  functionName: 'transfer',
  args: ['0x1111111111111111111111111111111111111111' as Address, parseUnits('10', 6)],
})

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

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

const tx = await omsWallet.wallet.callContract({
  network: Networks.polygon,
  contractAddress: '0x3333333333333333333333333333333333333333',
  method: 'transfer',
  args: [
    { type: 'address', value: '0x1111111111111111111111111111111111111111' },
    { type: 'uint256', value: parseUnits('10', 6) },
  ],
})

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

let tx = try await omsWallet.wallet.callContract(
    network: .polygon,
    contractAddress: "0x3333333333333333333333333333333333333333",
    method: "transfer",
    args: [
        AbiArg(type: "address", value: .string("0x1111111111111111111111111111111111111111")),
        AbiArg(type: "uint256", value: .string("10000000"))
    ]
)

print("Transaction:", tx.txnHash ?? tx.txnId)

import technology.polygon.omswallet.Network
import technology.polygon.omswallet.models.AbiArg
import kotlinx.serialization.json.JsonPrimitive

val tx = omsWallet.wallet.callContract(
    network = Network.POLYGON,
    contractAddress = "0x3333333333333333333333333333333333333333",
    method = "transfer",
    args = listOf(
        AbiArg(type = "address", value = JsonPrimitive("0x1111111111111111111111111111111111111111")),
        AbiArg(type = "uint256", value = JsonPrimitive("10000000")),
    ),
)

println("Transaction id: ${tx.txnId}")
println("Transaction hash: ${tx.txnHash}")

Sign a message

Used for authentication, consent flows, or off-chain verifications:

TypeScript
React Native
Swift
Kotlin

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

const signature = await omsWallet.wallet.signMessage({
  network: Networks.polygon,
  message: 'I authorize this payment of 10 USDC',
})

console.log('Signature:', signature)

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

const signature = await omsWallet.wallet.signMessage({
  network: Networks.polygon,
  message: 'I authorize this payment of 10 USDC',
})

console.log('Signature:', signature)

let signature = try await omsWallet.wallet.signMessage(
    network: .polygon,
    message: "I authorize this payment of 10 USDC"
)

print("Signature:", signature)

import technology.polygon.omswallet.Network

val signature = omsWallet.wallet.signMessage(
    network = Network.POLYGON,
    message = "I authorize this payment of 10 USDC",
)

println("Signature: $signature")

Send ERC-20, ERC-721, ERC-1155

Use standard ABI calls for token types that do not have dedicated helpers:

TypeScript
React Native
Swift
Kotlin

import { Networks, WalletType } from '@polygonlabs/oms-wallet'
import type { Abi, Address } from 'viem'

const erc721Abi = [
  {
    name: 'safeTransferFrom',
    type: 'function',
    stateMutability: 'nonpayable',
    inputs: [
      { name: 'from', type: 'address' },
      { name: 'to', type: 'address' },
      { name: 'tokenId', type: 'uint256' },
    ],
    outputs: [],
  },
] as const satisfies Abi

const activeWallet = omsWallet.wallet.activeWallet

if (activeWallet?.type !== WalletType.Ethereum) {
  throw new Error('No active Ethereum wallet session')
}

const tx = await omsWallet.wallet.sendTransaction({
  network: Networks.polygon,
  to: '0x4444444444444444444444444444444444444444' as Address,
  abi: erc721Abi,
  functionName: 'safeTransferFrom',
  args: [
    activeWallet.address,
    '0x1111111111111111111111111111111111111111' as Address,
    42n,
  ],
})

console.log('NFT transfer:', tx.txnHash ?? tx.txnId)

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

const activeWallet = omsWallet.wallet.activeWallet

if (!activeWallet) {
  throw new Error('No active wallet session')
}
const walletAddress = activeWallet.address

const tx = await omsWallet.wallet.callContract({
  network: Networks.polygon,
  contractAddress: '0x4444444444444444444444444444444444444444',
  method: 'safeTransferFrom',
  args: [
    { type: 'address', value: walletAddress },
    { type: 'address', value: '0x1111111111111111111111111111111111111111' },
    { type: 'uint256', value: '42' },
  ],
})

console.log('NFT transfer:', tx.txnHash ?? tx.txnId)

import Foundation

guard let activeWallet = omsWallet.wallet.activeWallet else {
    throw NSError(domain: "App", code: 1, userInfo: [NSLocalizedDescriptionKey: "No active wallet session"])
}

let tx = try await omsWallet.wallet.callContract(
    network: .polygon,
    contractAddress: "0x4444444444444444444444444444444444444444",
    method: "safeTransferFrom",
    args: [
        AbiArg(type: "address", value: .string(activeWallet.address)),
        AbiArg(type: "address", value: .string("0x1111111111111111111111111111111111111111")),
        AbiArg(type: "uint256", value: .string("42"))
    ]
)

print("NFT transfer:", tx.txnHash ?? tx.txnId)

import technology.polygon.omswallet.Network
import technology.polygon.omswallet.models.AbiArg
import kotlinx.serialization.json.JsonPrimitive

val activeWallet = requireNotNull(omsWallet.wallet.activeWallet) {
    "No wallet selected"
}

val tx = omsWallet.wallet.callContract(
    network = Network.POLYGON,
    contractAddress = "0x4444444444444444444444444444444444444444",
    method = "safeTransferFrom",
    args = listOf(
        AbiArg(type = "address", value = JsonPrimitive(activeWallet.address)),
        AbiArg(type = "address", value = JsonPrimitive("0x1111111111111111111111111111111111111111")),
        AbiArg(type = "uint256", value = JsonPrimitive("42")),
    ),
)

println("NFT transfer: ${tx.txnHash ?: tx.txnId}")

Transaction result

TypeScript
React Native
Swift
Kotlin

import { Networks } from '@polygonlabs/oms-wallet'
import type { Address } from 'viem'

const tx = await omsWallet.wallet.sendTransaction({
  network: Networks.polygon,
  to: '0x1111111111111111111111111111111111111111' as Address,
  value: 0n,
})

console.log('Wallet transaction ID:', tx.txnId)
console.log('Onchain hash:', tx.txnHash ?? 'pending')

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

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

console.log('Wallet transaction ID:', tx.txnId)
console.log('Onchain hash:', tx.txnHash ?? 'pending')

let tx = try await omsWallet.wallet.sendTransaction(
    network: .polygon,
    to: "0x1111111111111111111111111111111111111111",
    value: "0"
)

print("Wallet transaction ID:", tx.txnId)
print("Onchain hash:", tx.txnHash ?? "pending")

import technology.polygon.omswallet.Network
import java.math.BigInteger

val tx = omsWallet.wallet.sendTransaction(
    network = Network.POLYGON,
    to = "0x1111111111111111111111111111111111111111",
    value = BigInteger.ZERO,
)

println("Wallet transaction ID: ${tx.txnId}")
println("Onchain hash: ${tx.txnHash ?: "pending"}")