Docs

Smart Wallet

Deploys a Smart Wallet for the user to interact with your app. The specified personal wallet will be the admin signer. For more information about Smart Wallets, see glossary.

Usage

using Thirdweb;

public async void ConnectWallet()
{
    // Reference to your Thirdweb SDK
    var sdk = ThirdwebManager.Instance.SDK;

    // Configure the connection
    var connection = new WalletConnection(
      provider: WalletProvider.SmartWallet,        // The wallet provider you want to connect to (Required)
      chainId: 1,                                  // The chain you want to connect to (Required)
      password: "myEpicPassword",                  // If using a local wallet as personal wallet (Optional)
      email: "email@email.com",                    // If using a personal wallet login option that requires email (Optional)
      personalWallet: WalletProvider.LocalWallet   // The personal wallet you want to use with your Smart Wallet (Optional)
    );

    // Connect the wallet
    string address = await sdk.wallet.Connect(connection);
}

Behavior

WebGL

Goes through the specified personalWallet login flow, then generates or connects a Smart Wallet based on that EOA address.

Standalone

Goes through the specified personalWallet login flow, then generates or connects a Smart Wallet based on that EOA address.

Mobile

Goes through the specified personalWallet login flow, then generates or connects a Smart Wallet based on that EOA address.

Miscellaneous

The ultimate goal of a Smart Wallet is to be able to sponsor gas fees for your users, while providing a signless and gasless experience.

They also work with any wallet provider as the EOA, but it is recommended to use a signless wallet, like Embedded Wallets, for the best experience.

You would then be able to login to the exact same persistent EOA and smart wallet address across your apps, and even across different platforms.

You can also create session keys (revokable), allowing new signers to interact with the smart wallet without being the admin. You may also add/remove admins.

using Thirdweb;

// Reference to your Thirdweb SDK
var sdk = ThirdwebManager.Instance.SDK;

// Create a session key
string signerAddress = "0xSignerAddress";
List<string> approvedTargets = new List<string> { "0xTargetAddress" };
string nativeTokenLimitPerTransactionInWei = "0";
string permissionStartTimestamp = "0";
string permissionEndTimestamp = Utils.GetUnixTimestampIn10Years().ToString();
string reqValidityStartTimestamp = "0";
string reqValidityEndTimestamp = Utils.GetUnixTimestampIn10Years().ToString();

var createSessionResult = await sdk.wallet.CreateSessionKey(
  "0xSignerAddress",
  approvedTargets,
  nativeTokenLimitPerTransactionInWei,
  permissionStartTimestamp,
  permissionEndTimestamp,
  reqValidityStartTimestamp,
  reqValidityEndTimestamp
);

// Get a list of current signers with permission details
List<SignerWithPermissions> signers = await sdk.wallet.GetAllActiveSigners();

// Revoke a session key
var revokeSessionResult = await sdk.wallet.RevokeSessionKey("0xSignerAddress");

// Add admin
var addAdminResult = await sdk.wallet.AddAdmin("0xSignerAddress");

// Remove admin
var removeAdminResult = await sdk.wallet.RemoveAdmin("0xSignerAddress");

// These features pair well with the `smartWalletAccountOverride` option to connect to a specific smart wallet
var connection = new WalletConnection(
  ...options,
  smartWalletAccountOverride: "0xSmartWalletAddress"
);
var address = await sdk.wallet.Connect(connection);

Additional Options

Smart wallets, through paymasters, can be seen as a "plugin" to your user wallets, whereby all gas fees can be sponsored onchain. To enable this, simply set the gasless smart wallet option to true in your ThirdwebManager prefab.

All Smart Wallets are deployed through an Account Factory, which is a contract that deploys Smart Wallets on behalf of your users. You would need to set this address in your ThirdwebManager prefab's Smart Wallet settings as well.