Authentication - Polygon Developer Docs

Non-custodial wallets support multiple authentication flows. Each method resolves the wallet for the authenticated identity. If your app supports account linking, linked identities can access the same wallet. Social login is the recommended flow for consumer-facing fintechs and payment apps. Users authenticate via their existing Google account. No password or seed phrase is involved. Use the SDK’s default Google redirect flow when your app can authenticate through a browser redirect. Mobile apps start the redirect, open the returned authorization URL, and complete authentication from the deep-link callback URL.

TypeScript
React Native
Swift
Kotlin

const result = await oms.wallet.signInWithOidcRedirect({
  provider: 'google',
})

if (result && 'walletAddress' in result) {
  console.log('Wallet address:', result.walletAddress)
}

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

const started = await oms.wallet.startOidcRedirectAuth({
  provider: OidcProviders.google(),
  redirectUri: 'yourapp://auth/callback',
})

openSystemAuth(started.authorizationUrl)

const result = await oms.wallet.handleOidcRedirectCallback({
  callbackUrl,
})

if (result.type === 'completed') {
  console.log('Wallet address:', result.wallet.address)
}

let started = try await oms.wallet.startOidcRedirectAuth(
    provider: OidcProviders.google(),
    redirectUri: "yourapp://auth/callback"
)

openSystemAuth(started.authorizationUrl)

let result = try await oms.wallet.handleOidcRedirectCallback(callbackUrl)

if case let .completed(wallet) = result {
    print("Wallet address:", wallet.address)
}

import com.omsclient.kotlin_sdk.wallet.OidcProviders
import com.omsclient.kotlin_sdk.wallet.OidcRedirectAuthResult

val started = client.wallet.startOidcRedirectAuth(
    provider = OidcProviders.google(),
    redirectUri = "yourapp://auth/callback",
)

openCustomTab(started.authorizationUrl)

when (val result = client.wallet.handleOidcRedirectCallback(callbackUrl)) {
    is OidcRedirectAuthResult.Completed -> {
        println("Wallet address: ${result.wallet.address}")
    }
    else -> Unit
}

On first login, OMS Wallet creates or resolves the wallet for the provider identity and returns the active wallet.

Email OTP

Email OTP is ideal for financial products where users may not have a social account or prefer not to link one. The user enters their email, receives a one-time code, and the wallet is created on verification.

TypeScript
React Native
Swift
Kotlin

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

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

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

await oms.wallet.startEmailAuth('user@example.com')

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

if (result.type !== 'walletSelected') {
  throw new Error('Select or create a wallet before continuing')
}

console.log('Wallet address:', result.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}")

The SDK handles the full OTP flow. No additional backend is required for email OTP.

TypeScript
React Native
Swift
Kotlin

if (oms.wallet.session.walletAddress) {
  console.log('Signed in:', oms.wallet.session.walletAddress)
} else {
  console.log('Not signed in')
}

const session = await oms.wallet.getSession()

if (session.walletAddress) {
  console.log('Signed in:', session.walletAddress)
} else {
  console.log('Not signed in')
}

if let walletAddress = oms.wallet.session.walletAddress {
    print("Signed in:", walletAddress)
} else {
    print("Not signed in")
}

val session = client.session

if (session.walletAddress != null) {
    println("Signed in: ${session.walletAddress}")
} else {
    println("Not signed in")
}

​Social login

​Email OTP

​Checking sign-in state

Social login

Email OTP

Checking sign-in state