Skip to main content

ThirdwebSDK

The ThirdwebSDK is the entry point to all functionality of the Unity SDK.

You can initialize the SDK on your desired chain through the ThirdwebManager MonoBehaviour or manually instantiate it. Use the instance to access the different methods and properties of the SDK.

Usage​

The ThirdwebManager MonoBehaviour provides a convenient and customizable way to instantiate and manage the ThirdwebSDK. By attaching this script to a GameObject in your initial scene and using DontDestroyOnLoad(), the SDK remains instantiated throughout your game's lifecycle.

Please refer to the ThirdwebManager guide for detailed instructions on how to configure the manager.

Once ThirdwebManager is set up and the game starts, it will instantiate the ThirdwebSDK based on your settings. You can access the instantiated SDK from other scripts using:

ThirdwebSDK sdk = ThirdwebManager.Instance.SDK;

Provide the name of a default chain, or your own custom RPC URL of any EVM-compatible blockchain to instantiate the SDK.

View default chains
  • Ethereum: "ethereum"
  • Goerli: "goerli"
  • Polygon: "polygon"
  • Mumbai: "mumbai"
  • Arbitrum One: "arbitrum"
  • Arbitrum Goerli: "arbitrum-goerli"
  • Optimism: "optimism"
  • Optimism Goerli Testnet: "optimism-goerli"
  • Binance SmartChain: "binance"
  • Binance SmartChain Testnet: "binance-testnet"
  • Fantom Opera: "fantom"
  • Fantom Testnet: "fantom-testnet"
  • Avalanche C Chain: "avalanche-fuji"
  • Avalanche Fuji Testnet: "avalanche-fuji-testnet"
ThirdwebSDK sdk = new ThirdwebSDK("ethereum", {
      clientId = myClientId // you can get client id from dashboard settings
    });

Configuration​

chainOrRPC​

The blockchain you want to instantiate the SDK on.

Provide the name of a default chain (see above), or your own custom RPC URL of any EVM-compatible blockchain.

ThirdwebSDK sdk = new ThirdwebSDK("https://my-rpc-url");

chainId​

The chain ID of the blockchain you want to instantiate the SDK on.

ThirdwebSDK sdk = new ThirdwebSDK("goerli", 5);

options​

info

To use the Unity SDK, you need to pass a clientId option which you can obtain from an API key from the Dashboard.

You can use gasless transactions to forward all transactions to a relayer.

Currently supports OpenZeppelin Defender relayers.

ThirdwebSDK sdk = new ThirdwebSDK("goerli", 5, new ThirdwebSDK.Options()
{
    clientId = "my-client-id", // you can get client id from dashboard settings
    // Gasless configuration options
    gasless = new ThirdwebSDK.GaslessOptions()
    {
        // OpenZeppelin Defender options
        openzeppelin = new ThirdwebSDK.OZDefenderOptions()
        {
            relayerUrl = "open-zeppelin-relayer-url", // Your OZ Defender relayer URL
            relayerForwarderAddress = "0x...", // The OZ defender relayer address
            domainName = "domain-name", // The domain name for the forwarder
            domainVersion = "domain-version" // The version of the forwarder domain
        },
    },

    // Storage configuration options
    storage = new ThirdwebSDK.StorageOptions()
    {
        ipfsGatewayUrl = "https://my-ipfs-gateway.com/ipfs/" // Override the default IPFS gateway URL
    },

    // Wallet configuration options
    wallet = new ThirdwebSDK.WalletOptions()
    {
        appName = "My App", // The name of the app that will be displayed in different wallet providers
        appDescription = "App Description", // The description of the app
        appUrl = "https://my-app.com", // The URL of the app
        appIcons = new string[] { "https://my-app.com/icon1.png", "https://my-app.com/icon2.png" }, // An array of URLs for app icons
        magicLinkApiKey = "magic-link-api-key", // The API key for Magic Link authentication
        walletConnectProjectId = "wallet-connect-project-id", // The project ID for WalletConnect authentication
        extras = new Dictionary<string, object>()
        {
            { "foo", "bar" } // Additional data to pass to the wallet provider
        }
    },

    // Smart wallet configuration options
    smartWalletConfig = new ThirdwebSDK.SmartWalletConfig()
    {
        factoryAddress = "factory-address", // The address of the factory contract for smart wallets
        gasless = true, // Indicates whether gasless (paymaster) transactions are enabled
        bundlerUrl = "bundler-url", // The URL of the bundler service (optional)
        paymasterUrl = "paymaster-url", // The URL of the paymaster service (optional)
        entryPointAddress = "entry-point-address" // The address of the entry point contract (optional)
    }
});