Swift (iOS)

The Para SDK for Swift helps you integrate secure wallet features (creation, passkey-based authentication, transaction signing) into your iOS app. Below is an expanded guide that:

• Describes environment setup for associated domains and passkeys
• Shows how to create and log in users via email, phone, or OAuth
• Demonstrates the final steps of wallet creation and basic message signing

​

Prerequisites

To use Para, you need an API key. This key authenticates your requests to Para services and is essential for integration.

​

Installation and Configuration

​

Initializing the Para Manager

Below is a typical SwiftUI @main App demonstrating how to load environment and API keys from Info.plist, then set up Para:

import SwiftUI
import ParaSwift

@main
struct exampleApp: App {
    @StateObject private var paraManager: ParaManager
    @StateObject private var appRootManager = AppRootManager()

    init() {
        let environmentString = Bundle.main.object(forInfoDictionaryKey: "PARA_ENVIRONMENT") as? String ?? "beta"
        let environment: ParaEnvironment = environmentString == "sandbox" ? .sandbox : .beta
        let apiKey = Bundle.main.object(forInfoDictionaryKey: "PARA_API_KEY") as! String

        _paraManager = StateObject(wrappedValue: ParaManager(environment: environment, apiKey: apiKey))
    }

    var body: some Scene {
        WindowGroup {
            switch appRootManager.currentRoot {
            case .authentication:
                // If user not authenticated, show sign-in flows
                UserAuthView()
                    .environmentObject(paraManager)
                    .environmentObject(appRootManager)
            case .home:
                // If user is authenticated, show their wallet
                WalletView()
                    .environmentObject(paraManager)
                    .environmentObject(appRootManager)
            }
        }
    }
}

​

Authentication Flows

Passkeys let you authenticate users with either email, phone (OTP-based), or OAuth. Each flow shares a common pattern:

1. Check if user exists (by email or phone)
2. Create user if new, which triggers OTP
3. Verify OTP and generate passkey
4. Create wallet to store user’s assets

Use the same ParaManager instance for each step. The code below outlines email-based creation. Phone and OAuth are structurally similar but call their respective methods (createUserByPhone, verifyByPhone, generatePasskey(identifier:...), etc.).

• Email
• Phone
• OAuth

let userExists = try await paraManager.checkIfUserExists(email: userEmail)
if userExists {
    // Prompt user to log in with passkey
}

// If user does not exist, create user -> triggers OTP
try await paraManager.createUser(email: userEmail)

// Then call verify with the code user receives let biometricsId = try await paraManager.verify(verificationCode:
otpCode)

// Associate passkey with the verified user
try await paraManager.generatePasskey(identifier: userEmail, biometricsId: biometricsId)

// Optionally create a wallet
try await paraManager.createWallet(skipDistributable: false)

​

Logging In Existing Users

Once the user has a passkey (they’ve previously created or logged in), logging in is straightforward:

try await paraManager.login(authorizationController: authorizationController)

This triggers a biometric prompt, verifying the passkey before unlocking the wallet. On success, you can fetch wallets or sign transactions.

​

Signing Messages or Transactions

You can sign arbitrary messages (e.g., EVM or Solana transactions) by passing Base64-encoded bytes. For instance:

let messageData = "Hello Solana".data(using: .utf8)!
let base64Message = messageData.base64EncodedString()
let signature = try await paraManager.signMessage(walletId: wallet.id, message: base64Message)

For complex transactions (EVM, Solana, Cosmos, etc.), ensure you serialize them properly and only then call signMessage.

​

Example Project

For more complete usage patterns, including a SwiftUI app demonstrating email, phone, and OAuth flows, as well as passkey creation and transaction signing:

​

Integration Support

If you’re experiencing issues that aren’t resolved by our troubleshooting resources, please contact our team for assistance. To help us resolve your issue quickly, please include the following information in your request:

1. 1

   A detailed description of the problem you’re encountering.

2. 2

   Any relevant error messages or logs.

3. 3

   Steps to reproduce the issue.

4. 4

   Details about your system or environment (e.g., device, operating system, software version).

Providing this information will enable our team to address your concerns more efficiently.