Kotlin SDK quickstart - Polygon Developer Docs

The Kotlin SDK supports Android 10 / API 29 or newer.

Install the SDK

Add the SDK to your app module. Replace VERSION with the latest published Maven Central release.

dependencies {
    implementation("io.github.0xsequence:oms-wallet-kotlin-sdk:VERSION")
}

Use Android compileSdk 34 or newer and Java 17 compile options. The SDK dependency includes its required runtime transitively.

Create the client

import technology.polygon.omswallet.OMSWallet

val omsWallet = OMSWallet(
    context = context,
    publishableKey = "YOUR_PUBLISHABLE_KEY",
)

You can pass an activity, service, or application Context. The constructor retains context.applicationContext for storage and Android Keystore access, so keep one client for your application scope rather than tying it to an activity instance. Construction is synchronous and restores a valid completed session when one exists. Methods that contact OMS, including authentication, wallet transactions, and indexer queries, are suspend functions. Call them from your coroutine scope. The client exposes two independent surfaces:

Property	Purpose
`omsWallet.wallet`	Authentication, active wallet sessions, signing, and transactions
`omsWallet.indexer`	Read-only balances and history for any address

Authenticate with email

Request a code, then complete authentication after the user enters it.

import technology.polygon.omswallet.wallet.CompleteAuthResult

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

val auth = omsWallet.wallet.completeEmailAuth("123456")
check(auth is CompleteAuthResult.WalletSelected)

println("Wallet address: ${auth.wallet.address}")

Automatic wallet selection is the default. It selects the first existing Ethereum wallet returned by OMS, or creates one when none exists. See Authentication for native OIDC ID-token authentication, redirect authentication, and app-driven wallet selection.

Send a transaction

After authentication, submit a zero-value transaction on Polygon Amoy.

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

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

println("OMS transaction: ${result.txnId}")
println("Status: ${result.status}")
println("Transaction hash: ${result.txnHash}")

The SDK prepares, executes, and waits for status by default. See Send transactions for other transaction inputs, fee selection, and status handling.

​Install the SDK

​Create the client

​Authenticate with email

​Send a transaction

Install the SDK

Create the client

Authenticate with email

Send a transaction