Swift changelog

​

Added

• Support for binary payloads in generateAuthorizationSignature.

​

Fixed

• Remove stray logger error call.
• Allow Privy sessions to be refreshed when the app is backgrounded.

​

Added

• Added addSigners, addSigner, removeSigner, and removeAllSigners methods on EmbeddedWallet for managing wallet signers directly from the client

​

Fixed

• Added more descriptive error logging in wallet flows.

​

Fixed

• Circular dependency during SDK initialization.

​

Added

• Added support for transaction MFA with SMS, TOTP, and passkeys, including enrollment, verification, and unenrollment
• Added automatic MFA prompting via a delegate, so the SDK can prompt for MFA when wallet operations require it
• Added support for embedded wallet migration onto TEE execution, automatically or manually
• Added OAuth account linking
• Added generateAuthorizationSignature to the user object, enabling client-side signing of requests to the Privy API with authorization keys

​

Added

• Add account unlinking for email, phone number, SIWE, SIWS, and OAuth

​

Changed

• Link methods now return PrivyUser instead of Void:
  • func privy.email.linkWithCode(_ code: String, sentTo email: String) async throws -> PrivyUser
  • func privy.sms.linkWithCode(_ code: String, sentTo phoneNumber: String) async throws -> PrivyUser
  • func privy.siwe.link(message: String, signature: String, params: SiweMessageParams, metadata: WalletLoginMetadata?) async throws -> PrivyUser
  • func privy.siws.link(message: String, signature: String, metadata: WalletLoginMetadata?) async throws -> PrivyUser
  • func privy.passkey.link(relyingParty: String, displayName: String?) async throws -> PrivyUser
• Unlink methods now return PrivyUser instead of Void:
  • func privy.email.unlink(email: String) async throws -> PrivyUser
  • func privy.sms.unlink(phoneNumber: String) async throws -> PrivyUser
  • func privy.siwe.unlink(address: String) async throws -> PrivyUser
  • func privy.siws.unlink(address: String) async throws -> PrivyUser
  • func privy.passkey.unlink(credentialId: String) async throws -> PrivyUser
  • func privy.oAuth.unlink(with: OAuthProvider, subject: String) async throws -> PrivyUser

​

Added

• Expose MFA methods on the PrivyUser object

​

Added

• Adds support for Passkey login, signup, account linking and unlinking

​

Added

• Adds support for signTransaction to the Solana provider
• Adds support for signAndSendTransaction to the Solana provider
• Adds support for login and linking through Sign in with Solana
• Adds support for unlinking an external Solana wallet

​

Deprecated

• .siwe.generateSiweMessage → .siwe.generateMessage
• .siwe.loginWithSiwe → .siwe.login
• .siwe.linkWithSiwe → .siwe.link

​

Changed

• Minimum iOS version is now 17.0
• Minimum macOS version is now 14.0
• Bumps internal dependencies to latest versions

​

Fixed

• Add some additional guard rails to webview timeout issues

​

Fixed

• Adds some safeguards to flows to prevent timeouts

​

Fixed

• Fixes a bug related to wallet creation

​

Added

• Adds the ability to specify a timeout when creating a wallet

​

Changed

• Throw PrivyError when authenticate network call fails
• Make APIError a public enum

​

Added

• Adds support for updating a user’s email address via privy.email.updateWithCode(_:sentTo:)
• Adds support for updating a user’s phone number via privy.sms.updateWithCode(_:sentTo:)
• Adds support for linking a phone number via privy.sms.linkWithCode(_:sentTo:)

​

Added

• func getUser() async -> PrivyUser? - awaits ready under the hood, then returns user if authenticated

​

Deprecated

• Privy.user - Use func getUser() async -> PrivyUser? instead.

​

Added

• func getAuthState() async -> AuthState - awaits ready under the hood, then returns most up to date AuthState

​

Deprecated

• func awaitReady() async in favor of the newly added func getAuthState() async -> AuthState

​

Added

• Adds a typed form to EmbeddedEthereumWalletProvider.request for the following methods: personal_sign, secp256k1_sign, eth_sign, eth_signTypedData_v4, eth_signTransaction, eth_sendTransaction.

​

Important

​

Added

• Adds Swift 6 support.
• Adds a new case to AuthState, authenticatedUnverified.
• Adds a new method to Privy, onNetworkRestored.
• Adds a new method to Privy, awaitReady.
• Adds support for the secp256k1_sign ethereum RPC.
• Adds support for HD wallets on Solana.
• Adds support for social login via Discord.

​

Changed

• Distributes as a binary framework with library evolution.
• AuthState.authenticated now contains a PrivyUser object instead of the session struct.

​

Removed

• Removed Factory as a dependency.

​

Improvements

• Add support for the secp256k1_sign ethereum RPC
• Add support for HD wallets on Solana

​

Improvements

• Adds Discord support for social login
• Swift 6 support

​

Improvements

• Support Swift binary evolution

​

Fixed

• Misc bug fixes

​

Added

• Swift 6.1 Compiler Support

​

Fixed

• Misc bug fixes

​

Fixed

• Misc bug fixes

​

Fixed

• Misc bug fixes

​

Fixed

• Misc bug fixes

​

Fixed

• Fixes a bug related to refreshing the user’s session when using custom auth.

• App client ID required at initialization
• PrivySdk.initialize now throws if called more than once
• new Privy.awaitReady async method
• AuthState now contains the PrivyUser object instead of the raw session struct

​

Improvements

• Add support for the secp256k1_sign ethereum RPC

​

Improvements

• Add support for identity tokens and expose the AuthSession.identityToken property

​

Improvements

• Adds some additional logic to reinitialize secure context after app is backgrounded
• Automatically connects wallets when making rpc requests

​

Improvements

• Adds PrivyLoggingConfig that allows you to specify PrivyLogLevel, and optionally, a logMessage callback if you want to manage logging

​

Improvements

• Enhances logging around WebView and Session

​

Improvements

• Set log level at init
• Add enhanced logging throughout SDK

​

Improvements

• Add some additional debug logs

​

Improvements

• Bump timeouts to 60 seconds or higher

​

Improvements

• Bump timeouts on create wallet flow
• Reset wallet state after errors in create wallet flow

​

Improvements

• Improved error handling for LoginWithEmail.linkWithCode(code:, sentTo:)

​

Bug Fixes

• Fix for macOS and macOS Catalyst xcframework

​

Improvements

• Support for macOS and macOS Catalyst

​

Improvements

• Twitter/X Login
• EthereumEmbeddedWalletProvider for Ethereum wallet requests
• SolanaEmbeddedWalletProvider for Solana wallet requests
• Solana sign message support

• Deprecated EmbeddedWalletProvider. This method’s name sounds chain agnostic, but the provider is Ethereum specific.

​

Bug Fixes

• Fixes a bug in the connect wallet flow

​

Improvements

• Create wallet by specifying chain type (Ethereum or Solana)
• New connect wallet API that doesn’t require passing “retryOnFailure”

• Deprecated Create wallet API (Ethereum only)
• Deprecated Connect wallet API that requires developer to specify retryOnFailure
• Deprecated Recover wallet API (now handled automatically under the hood)

​

Improvements

• Lower minimum support to iOS 16

​

Improvements

• Add support for Privy RPC URLs
• Support native Sign in with Apple

​

Improvements

• Link email
• Link wallet

​

Improvements

• Makes some core foundational changes that better handles race conditions

​

Improvements

• Introduces “appClientId” in Privy config initializer

​

Bug Fixes

• Bug fix related to awaiting embedded wallet ready state

​

Improvements

• Introduces login with Google

​

Bug Fixes

• Fixed a bug where user object wasn’t properly updated after auth refresh

​

Bug Fixes

• Fix a bug in embedded wallets that prevented sending rpc requests with additional wallets

​

Improvements

• Drops the requirement that embeddedWalletState must be disconnected before calling privy.embeddedWallet.connectWallet()

​

Improvements

• Bug fix and edge case handling when calling logout
• Updates privy.embeddedWallet.connectWallet() such that it no ops if wallet is already connected

​

Improvements

• The official launch of our flagship Swift SDK

​

Improvements

• Base Sepolia chain (84532) added to supported chains

​

Improvements

• Login with SIWE (Sign in with Ethereum)

​

Improvements

• Login with email
• Login with SMS
• Privy session restoration on SDK init

​

Improvements

• Improved error handling and guarding during wallet creation

​

Improvements

• Interface updates for simpler embedded wallet interactions
• Embedded wallets now auto-connect after successful login
• Separate callbacks for authState and embeddedWalletState
• Improved error messages

​

Improvements

• Now possible to create and send requests on behalf of multiple embedded wallets