Error Handling

​

Overview

• SeamError — Thrown for SDK initialization, configuration, or API-level failures (for example, invalid token or no network).
• SeamCredentialError — Returned when a specific credential has an issue (for example, expired, unsupported device, or user action required).

​

SeamError Cases

​

SeamCredentialError Cases

​

Resolving Required User Interactions

if case .userInteractionRequired(let action) = error {
    switch action {
    case .enableBluetooth:
        showBluetoothEnableAlert()
    case .completeOtpAuthorization:
        navigateToOtpScreen()
    default:
        break
    }
}

​

Handling Errors in Code

​

Using Combine

let unlockPublisher = try Seam.shared.unlock(using: credential.id)

unlockPublisher
    .sink(
        receiveCompletion: { _ in
            print("Unlock finished")
        },
        receiveValue: { event in
            // Handle unlock events
        }
    )

​

Using async/await

do {
    let events = try Seam.shared.unlock(using: credential.id)
    for await event in events.values {
        // Handle unlock events
    }
} catch let error as SeamError {
    // Handle SDK-level errors
}

​

Generic Helper Function

func handleError(_ error: Error) {
    switch error {
    case let sdkError as SeamError:
        // Map to user-friendly messages
        break
    case let credError as SeamCredentialError:
        // Prompt user based on error type
        break
    default:
        // Generic fallback
        break
    }
}

​

Best Practices

• Map errors to UI states — Show loading, success, or error screens based on the error type.
• Provide actionable feedback — For credential expiration, guide the user to renew or reissue their credential.
• Check credentials before unlocking — If unlock(using:) would throw .credentialErrors([...]), present the top error to the user and wait until it is resolved before attempting the unlock.

​

See Also

• Quickstart — How to initialize SeamSDK and perform your first unlock.
• Architecture — How SeamSDK integrates with your app, cloud services, and hardware.
• UI Components — SeamComponents handles error presentation automatically.