Unity SDK

Unity SDK v5 → v6 Migration Guide

Unity SDK v6 modernises wallet flows, trims unused integrations, and keeps the .NET interoperability you relied on in v5. This document compares the two ThirdwebManagerBase implementations and lists the code edits required to upgrade an existing project.

• Wallet providers – The WalletProvider enum now only exposes InAppWallet, EcosystemWallet, and ReownWallet. PrivateKeyWallet, WalletConnectWallet, and MetaMaskWallet handlers were removed from the manager.
• Reown integration – External wallets are unified under the optional ReownWallet provider. Support is wrapped in #if THIRDWEB_REOWN guards and requires Reown AppKit in your project.
• Option models – EcosystemWalletOptions and InAppWalletOptions no longer accept legacyEncryptionKey. WalletOptions gained a ReownOptions payload that is filled with sensible defaults when omitted.
• Manager internals – SupportedChains, IncludedWalletIds, and the _walletMapping accessors were deleted. ConnectWallet now sets ActiveWallet directly and only persists the most recent wallet for auto-connect.
• Version + diagnostics – THIRDWEB_UNITY_SDK_VERSION jumped to 6.0.0, and the boot sequence logs an explicit error if THIRDWEB_REOWN is defined but the AppKit prefab is missing from the scene.

• Delete the v5 Thirdweb folder.
• Import the v6 Unity package.
• Remove any outdated assembly definition references.

The serialized shape of ThirdwebManagerBase changed between branches. Drop the new prefab into your scenes (or update custom subclasses) and clear orphaned fields.

// v5
public enum WalletProvider {
    PrivateKeyWallet,
    InAppWallet,
    WalletConnectWallet,
    MetaMaskWallet,
    EcosystemWallet,
}
 
// v6
public enum WalletProvider {
    InAppWallet,
    EcosystemWallet,
    ReownWallet,
}

Key property changes in the component:

Reown replaces both MetaMask and WalletConnect. The v6 manager checks for the AppKit prefab whenever the THIRDWEB_REOWN scripting define symbol is set.

#if THIRDWEB_REOWN
var reownModalExists = FindObjectOfType<Reown.AppKit.Unity.AppKitCore>();
if (!reownModalExists) {
    ThirdwebDebug.LogError("Reown AppKit not found in scene …");
}
#endif

To enable Reown:

• Install the Reown AppKit Unity package.
• Add THIRDWEB_REOWN to Player Settings → Other Settings → Scripting Define Symbols for every build target that uses external wallets.
• Drop the Reown AppKit prefab into the scenes that should surface the modal.

If you’re shipping only in-app or ecosystem wallets, do not set the scripting define and remove any references to WalletProvider.ReownWallet.

Search the project for the removed enum values and update the call sites.

// v5 WalletConnect
await ThirdwebManager.Instance.ConnectWallet(new WalletOptions(
    provider: WalletProvider.WalletConnectWallet,
    chainId: new BigInteger(421614)
));
 
// v6 Reown
await ThirdwebManager.Instance.ConnectWallet(new WalletOptions(
    provider: WalletProvider.ReownWallet,
    chainId: new BigInteger(421614),
    reownOptions: new ReownOptions(projectId: "YOUR_REOWN_PROJECT_ID")
));

Other call-site adjustments:

• Remove any arguments named legacyEncryptionKey when instantiating InAppWalletOptions or EcosystemWalletOptions.
• Replace checks for WalletProvider.PrivateKeyWallet with direct usage of the .NET PrivateKeyWallet helpers, e.g. await PrivateKeyWallet.Generate(client).
• When you need to filter wallets in Reown, set IncludedWalletIds/ExcludedWalletIds inside the ReownOptions object instead of relying on the removed IncludedWalletIds array.

SmartWalletOptions retained the same fields, so your upgrade code should compile unchanged. What does change is the surrounding manager state:

• UpgradeToSmartWallet no longer adds the smart wallet to a shared dictionary; it simply returns the new wallet and sets ActiveWallet.
• LinkAccount still exists but now reads the redirect settings from ThirdwebManagerBase’s remaining fields. Confirm any login UI that referenced RedirectPageHtmlOverride still points to a valid asset.

var personalWallet = await PrivateKeyWallet.Generate(client);
var smartWallet = await ThirdwebManager.Instance.UpgradeToSmartWallet(
    personalWallet,
    chainId: new BigInteger(421614),
    smartWalletOptions: new SmartWalletOptions(sponsorGas: true)
);

• Delete deprecated prefabs (WalletConnectModal, old MetaMask UI, etc.).
• Remove scripts that referenced the dropped enum values so Unity stops warning about missing behaviours.
• Clear serialized ScriptableObjects that kept legacyEncryptionKey, SupportedChains, or IncludedWalletIds.
• Update internal docs to mention Reown and the new optional dependency model.

• Open Play mode and confirm each wallet flow works (In-App, Ecosystem, and optionally Reown).
• Test the auto-connect flow to verify that PlayerPrefs stores the new WalletOptions payload.
• Build for every platform you support; Reown builds will fail if the AppKit prefab or define is missing.
• Run any automated gameplay/contract tests to ensure async interactions behave identically.