SDK Quickstart - Polygon Developer Docs

This quickstart walks through the minimum OMS Wallet SDK flow: install an SDK, create or configure the client, authenticate with email OTP, and send a first transaction from the non-custodial wallet.

Swift and Kotlin are native app SDKs. TypeScript is best for web, Node, and JavaScript apps.

1. Get project credentials

2. Install an SDK

TypeScript
Swift
Kotlin

pnpm add @0xsequence/typescript-sdk viem

Add the package in Xcode with File -> Add Package Dependencies and enter the following git URL.

https://github.com/0xsequence/swift-sdk.git

dependencies {
    implementation("io.github.0xsequence:oms-client-kotlin-sdk:0.1.0-alpha.1")
}

3. Create the client

Create the client once when your app starts, then reuse it for wallet operations.

TypeScript
Swift
Kotlin

import { OMSClient } from '@0xsequence/typescript-sdk'

const oms = new OMSClient({
  publicApiKey: 'YOUR_PROJECT_ACCESS_KEY',
  projectId: 'YOUR_PROJECT_ID',
})

import OMS_SDK

let oms = OMSClient(
    projectAccessKey: "YOUR_PROJECT_ACCESS_KEY",
    projectId: "YOUR_PROJECT_ID"
)

import com.omsclient.kotlin_sdk.OMSClient

val client = OMSClient(
    context = context,
    publicApiKey = "YOUR_PROJECT_ACCESS_KEY",
    projectId = "YOUR_PROJECT_ID",
)

4. Authenticate with email

Email authentication is a two-step OTP flow. Start auth, show your OTP input, then complete auth with the user-entered code.

TypeScript
Swift
Kotlin

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

const { walletAddress } = await oms.wallet.completeEmailAuth({ code: '123456' })

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

try await oms.wallet.startEmailAuth(email: "user@example.com")

let result = try await oms.wallet.completeEmailAuth(code: "123456")

if case let .walletSelected(walletAddress, _, _, _) = result {
    print("Wallet address:", walletAddress)
}

import com.omsclient.kotlin_sdk.wallet.CompleteAuthResult

client.wallet.startEmailAuth("user@example.com")

val result = client.wallet.completeEmailAuth("123456")
check(result is CompleteAuthResult.WalletSelected)

println("Wallet address: ${result.walletAddress}")

5. Send a first transaction

Send a native token transaction on Polygon Amoy. Values are raw base-unit values. On supported testnets, fee options are automatically sponsored.

TypeScript
Swift
Kotlin

import { Networks } from '@0xsequence/typescript-sdk'
import { parseEther, type Address } from 'viem'

const recipient = '0xRecipient' as Address

const tx = await oms.wallet.sendTransaction({
  network: Networks.amoy,
  to: recipient,
  value: parseEther('0'),
})

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

let tx = try await oms.wallet.sendTransaction(
    network: .polygonAmoy,
    to: "0xRecipient",
    value: "0"
)

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

import com.omsclient.kotlin_sdk.Network
import java.math.BigInteger

val tx = client.wallet.sendTransaction(
    network = Network.AMOY,
    to = "0xRecipient",
    value = BigInteger.ZERO,
)

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

Next steps

SDK Overview

Compare supported SDKs and find the detailed reference for each one.

Send USDC

Send an ERC-20 transfer from a non-custodial wallet.

Authentication

Review auth options, wallet selection, and wallet creation where each SDK supports them.

Balances & History

Read token balances and raw base-unit values through the SDK indexer clients.

​1. Get project credentials

​2. Install an SDK

​3. Create the client

​4. Authenticate with email

​5. Send a first transaction

​Next steps

SDK Overview

Send USDC

Authentication

Balances & History

1. Get project credentials

2. Install an SDK

3. Create the client

4. Authenticate with email

5. Send a first transaction

Next steps