Swift SDK quickstart - Polygon Developer Docs

The Swift SDK supports iOS 15+, macOS 12+, and Swift 6.2+.

Install the SDK

In Xcode, choose File > Add Package Dependencies, enter the repository URL, and use Up to Next Minor Version starting at 0.3.1.

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

In a Package.swift manifest, declare the dependency and add the OMSWallet product to your target.

dependencies: [
    .package(url: "https://github.com/0xsequence/swift-sdk.git", .upToNextMinor(from: "0.3.1")),
],
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "OMSWallet", package: "swift-sdk"),
        ]
    ),
]

For CocoaPods, add the published pod to your Podfile.

pod 'oms-wallet-swift-sdk', '~> 0.3.1'

Import the package in files that use it.

import OMSWallet

Create the client

Create one OMSWallet when your app starts and keep it alive. The publishable key selects the OMS project and environment.

let omsWallet = try OMSWallet(publishableKey: "YOUR_PUBLISHABLE_KEY")

Use omsWallet.wallet for authenticated wallet operations and omsWallet.indexer for read-only balance and history queries.

Authenticate with email

Send an OTP, collect the code in your UI, and complete authentication. Automatic wallet selection is the default: the SDK activates the first matching wallet or creates one when needed.

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

let auth = try await omsWallet.wallet.completeEmailAuth(code: "123456")

guard case .walletSelected(let walletAddress, _, _, _) = auth else {
    fatalError("Automatic wallet selection did not complete")
}

print("Active wallet:", walletAddress)

The completed session is persisted and restored when you create OMSWallet on a later app launch.

Send a transaction

An active wallet session is required. This example submits a zero-value transaction on Polygon Amoy and waits for the default status resolution.

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

print("Wallet transaction ID:", transaction.txnId)
print("Onchain hash:", transaction.txnHash ?? "not available yet")

The SDK prepares, executes, and waits for status. 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