Migrating to Unity SDK v1.0

​

Initialization and readiness

​

What changed

• PrivyManager.Initialize(...) now returns an IPrivy instance immediately and begins initialization in the background.
• v1.0 removes the PrivyManager.AwaitReady() method.
• The SDK now ensures readiness when your app calls GetAuthState() or GetUser().

​

Migration

PrivyManager.Initialize(config);
await PrivyManager.AwaitReady();

var privy = PrivyManager.Initialize(config);
// Awaiting GetAuthState/GetUser ensures the SDK is fully initialized.
var authState = await privy.GetAuthState();

​

IPrivy API changes (user and auth access)

​

User access

• v1.0 removes the User property.
• Your app should call await privy.GetUser() instead.

PrivyUser user = PrivyManager.Instance.User;

IPrivyUser user = await PrivyManager.Instance.GetUser();

​

Auth state

• v1.0 removes the AuthState property.
• Your app should call await privy.GetAuthState() instead.

​

Auth state change callback

• v1.0 removes the SetAuthStateChangeCallback(...) method.
• Your app should subscribe to the AuthStateChanged event instead.

PrivyManager.Instance.SetAuthStateChangeCallback(state => {
    // handle state
});

PrivyManager.Instance.AuthStateChanged += state => {
    // handle state
};

​

Namespace and type relocations

​

Embedded wallet API changes

​

Wallet collection property

• v1.0 renames EmbeddedWallets to EmbeddedEthereumWallets (the old name is now marked [Obsolete]).

​

Wallet creation methods

​

RPC provider interface

• v1.0 removes IRpcProvider.
• Your app should use IEmbeddedEthereumWalletProvider (in Privy.Wallets) instead.

​

Example (signing a message)

IEmbeddedEthereumWallet wallet = await user.CreateWallet();
var response = await wallet.RpcProvider.Request(rpcRequest);

IEmbeddedEthereumWallet wallet = await user.CreateEthereumWallet();
var response = await wallet.RpcProvider.Request(rpcRequest);

​

Exception type changes

try {
    // ...
} catch (PrivyAuthenticationException ex) {
    // handle auth error
} catch (PrivyWalletException ex) {
    // handle wallet error
}

​

Configuration object changes

var config = new PrivyConfig {
    AppId = "...",
    ClientId = "...",
    LogLevel = PrivyLogLevel.NONE
};

using Privy.Config;

var config = new PrivyConfig {
    AppId = "...",
    ClientId = "...",
    LogLevel = PrivyLogLevel.None
};

​

Quick migration checklist

1. Update using statements to reference the new namespaces (e.g. Privy.Core, Privy.Auth, Privy.Wallets, Privy.Utils).
2. Replace await PrivyManager.AwaitReady() with await PrivyManager.Instance.GetAuthState() or await PrivyManager.Instance.GetUser().
3. Replace PrivyManager.Instance.User with await PrivyManager.Instance.GetUser().
4. Replace SetAuthStateChangeCallback(...) with AuthStateChanged += ....
5. Replace embedded wallet API calls using CreateWallet / EmbeddedWallets with CreateEthereumWallet / EmbeddedEthereumWallets (and optionally CreateSolanaWallet).
6. Update exception handling to catch PrivyAuthenticationException and PrivyWalletException.