thirdwebDocs
Unity SDK

ReownWallet

ReownWallet replaces the legacy WalletConnect integration. It wraps the official Reown AppKit to surface 400+ wallets inside your Unity project.

Setup checklist

  • Add Reown prefab – drag the Reown AppKit prefab from Packages/Reown.AppKit.Unity/Prefabs into your scene.
  • Plan your connect call – you choose the chain and branding when you construct WalletOptions and ReownOptions before calling ConnectWallet.
  • Set the script define – add THIRDWEB_REOWN to every build target that will use Reown.
  • Provide metadata – Reown needs a WalletConnect projectId plus branding details (name, description, URL, icon) in the options you pass at runtime.

If the prefab is missing, the SDK logs an error at runtime telling you to either remove the define or add the prefab.

Connecting with Reown

var reownOptions = new ReownOptions(
	projectId: "YOUR_REOWN_PROJECT_ID",
	name: "My Game",
	description: "thirdweb powered experience",
	url: "https://mygame.example",
	iconUrl: "https://mygame.example/icon.png",
	includedWalletIds: new[] { "eip155:1:metamask" },
	excludedWalletIds: null
);
 
var walletOptions = new WalletOptions(
	provider: WalletProvider.ReownWallet,
	chainId: 1,
	reownOptions: reownOptions
);
 
var wallet = await ThirdwebManager.Instance.ConnectWallet(walletOptions);

The connection flow will:

  • Initialize Reown AppKit (once per session) with your metadata.
  • Attempt to resume a previous session before showing the modal.
  • Open the Reown modal for up to 120 seconds if no session is found.
  • Ensure the connected chain matches walletOptions.ChainId.

If the selected chain is not part of Reown's built-in list, the SDK automatically injects the chain metadata using Thirdweb's chain APIs and logs a warning so you know it was added on the fly.

API surface

ReownWallet.Create accepts the following arguments:

Limitations: Reown currently doesn't support raw eth_sign, account linking, or EIP-7702 authorizations. The SDK throws descriptive exceptions if you call those APIs.

Troubleshooting

  • "Reown AppKit not found" – add the prefab or remove THIRDWEB_REOWN if you don't need Reown.
  • NotSupportedException on connect – ensure the define symbol is added for the active build target.
  • Connection timed out – the modal stays open for 120 seconds; confirm the wallet scanned the QR code or resumed the session.

Explore the IThirdwebWallet API