v3.1.2

What's Changed

• eth_estimateGas now adds a balance override by default as newer rust based nodes cannot be presumed to internally apply it as other node types do. If that call fails we fall back to a normal eth_estimateGas

v3.1.1

What's Changed

• Updated ThirdwebApi client - contains support for new Solana and improved x402 APIs.

v3.1.0

What's Changed

• Added AuthProvider.Epic - you can now login with your Epic Games account when using In-App or Ecosystem Wallets.

var iaw = await InAppWallet.Create(client: twClient, authProvider: AuthProvider.Epic);
var iawAddy = await iaw.LoginWithOauth(...);

• SmartWallet.CreateSessionKey now only requires a signerAddress, rest of the parameters are optional.
• Added custom llms.txt at the root of this project for your AIs to enjoy.
• Updated ThirdwebApi - contains latest https://api.thirdweb.com/reference additions such as x402, Solana and more APIs.

v3.0.0

Thirdweb .NET SDK v3 – Official Release

Why Upgrade to v3

1. Unified client and APIs
2. Faster, lighter, and more efficient
3. Modern dependencies and standards
4. Easier wallet and transaction testing
5. Architecture ready for future features

Thirdweb .NET SDK v3 evolves from separate utilities into a cohesive, high-performance platform.

Major Architectural Changes

Unified API Client

// v2 – Separate clients
var nebula = await ThirdwebNebula.Create(client);
var pay = new ThirdwebPay();  
var bridge = await ThirdwebBridge.Create(client);
var insight = await ThirdwebInsight.Create(client);

// v3 – Unified client
var response = await client.Api.JustDoItAsync(...);

Highlights

• Low level generated client for thirdweb API full access, will be kept updated and the time-save will be used to make higher level APIs with nicer DX similar to the remaining ThirdwebWallet, ThirdwebContract and ThirdwebTransaction APIs.
• Consistent API design
• Easier discovery via IntelliSense
• Wraps the thirdweb API with all its features vs waiting for manual higher level integration
• Wrapper customized and adapted to work across any runtime and extended for game engine use.

Note that the core thirdweb functionality of Wallets, Contracts and Transactions is effectively free of breaking changes (new features are available). In the future, they may call into ThirdwebClient.Api while maintaining the nicer DX. There will eventually be an opinionated easier to use wrapper for each service.

---

Wallet System Updates

Modernized Wallet Flow

// v2 – Private key wallet
var privateWallet = await PrivateKeyWallet.Generate(client);

// v3 – Guest/in-app wallets  
var wallet = await InAppWallet.Create(client, AuthProvider.Guest);
await wallet.LoginWithGuest();

Improvements

• Removed legacy signing and recovery methods from the IThirdwebWallet interface
• Removed obsolete LegacyEncryptionKey creaton param from In-App and Ecosystem Wallets.
• Major internal cleanup of legacy Shamir sharding client side logic and AWS logic.
• Better guest wallet flows
• Smarter gas handling and bundler integration

---

Performance & Dependencies

• Removed Portable.BouncyCastle and two other Nethereum dependencies.
• Updated remaining Nethereum dependencies to Nethereum 5.0.0
• Creating an In-App or Ecosystem wallet should feel a lot faster now.

Efficiency Gains

• 30% less code (6,997 → 4,886 lines)
• 41% fewer files (44 → 26)
• Faster builds and smaller runtime

---

Developer Experience

Transactions

var hash = await transaction.Send();
var receipt = await transaction.SendAndWaitForTransactionReceipt();

Build System

• Modernized for faster development and testing
• If you want to contribute, we have a nice Makefile to help run things more easily

---

Account Abstraction

• Unified bundler (ThirdwebBundler)
• Improved gas estimation and sponsorship
• Better EIP-7702 support
• Better zkSync integration

---

Learn more

• Portal Documentation
• Full Generated Reference

v2.25.2

What's Changed

• Fixed a bug where users from countries with a non-gregorian calendar could experience issues signing in with In-App or Ecosystem wallets, such as users with a Thai regional system calendar.
• EIP7702 account implementation is now fetched dynamically, the current contract implementation contains better onchain error messages and more useful contract events.

v2.25.1

What's Changed

• Added AuthProvider.TikTok as a login option for In-App or Ecosystem Wallets.

var iaw = await InAppWallet.Create(client: twClient, authProvider: AuthProvider.Steam);
var iawAddy = await iaw.LoginWithOauth(...);

v2.25.0

What's Changed

• Added ThirdwebContract.Deploy as this SDK's first integration of https://api.thirdweb.com/reference
• Includes various internal changes and improvements to account for the new generated api client.

Example

var serverWallet = await ServerWallet.Create(client: client, label: "TestFromDotnet");
var chainId = 11155111;

var abi = "[ { \"inputs\": [], \"name\": \"welcome\", \"outputs\": [ { \"internalType\": \"string\", \"name\": \"\", \"type\": \"string\" } ], \"stateMutability\": \"pure\", \"type\": \"function\" } ]";

var contractAddress = await ThirdwebContract.Deploy(
    client: client,
    chainId: chainId ,
    serverWalletAddress: await serverWallet.GetAddress(),
    bytecode: "6080604052348015600e575f5ffd5b5061014e8061001c5f395ff3fe608060405234801561000f575f5ffd5b5060043610610029575f3560e01c8063b627cf3b1461002d575b5f5ffd5b61003561004b565b60405161004291906100f8565b60405180910390f35b60606040518060400160405280601481526020017f57656c636f6d6520746f20746869726477656221000000000000000000000000815250905090565b5f81519050919050565b5f82825260208201905092915050565b8281835e5f83830152505050565b5f601f19601f8301169050919050565b5f6100ca82610088565b6100d48185610092565b93506100e48185602086016100a2565b6100ed816100b0565b840191505092915050565b5f6020820190508181035f83015261011081846100c0565b90509291505056fea264697066735822122001498e9d7d6125ce22613ef32fdb7e8e03bf11ad361d7b00e210b82d7b7e0d4464736f6c634300081e0033",
    abi: abi
);
Console.WriteLine($"Contract deployed at: {contractAddress}");

var contract = await ThirdwebContract.Create(client: client, address: contractAddress, chain: chainId, abi: abi);
var welcomeMessage = await contract.Read<string>("welcome");
Console.WriteLine($"Welcome message from deployed contract: {welcomeMessage}");

Expect more new features to keep coming as part of the thirdweb api integration!

v2.24.1

What's Changed

• Introduces a forwardLocalGasFees parameter to EngineWallet (deprecated Engine v2, superseeded by ServerWallet), allowing control over whether locally calculated gas fees are forwarded to the engine. Updates the EngineWallet.Create method and transaction overrides logic to support this feature. The default for this flag is false, giving gas calculation and submission authority to Engine when using this wallet provider.

v2.24.0

What's Changed

🚀 New Feature: ServerWallet - Next-Generation Secure Backend Wallets

We're excited to introduce ServerWallet, a powerful new wallet implementation that replaces the deprecated EngineWallet. ServerWallet provides vault-based secure wallet management with advanced execution options and seamless integration with the thirdweb dashboard's Transactions feature.

Key Features

• 🔒 Vault-Based Security: Enhanced security through server-side wallet management
• ⚡ Multiple Execution Modes: Support for Auto, ERC-4337, EIP-7702, EOA, and zkSync native AA execution
• 🎯 Smart Execution Strategy: Auto mode intelligently selects the optimal execution method based on your configuration
• 🔧 Flexible Configuration: Simple label-based wallet creation with optional execution customization
• 📊 Dashboard Integration: Full compatibility with thirdweb dashboard's Transactions tab (Engine v3)

Getting Started

// Basic usage with auto execution mode
var serverWallet = await ServerWallet.Create(
    client: client,
    label: "MyWallet"
);

// Advanced usage with custom execution options
var serverWallet = await ServerWallet.Create(
    client: client,
    label: "MyWallet",
    executionOptions: new ERC4337ExecutionOptions(chainId: 84532, signerAddress: "0x...")
);

Available Execution Options

• AutoExecutionOptions (Default): Automatically determines the best execution strategy
• ERC4337ExecutionOptions: Smart contract wallet execution with Account Abstraction
• EIP7702ExecutionOptions: Temporary EOA delegation to smart contracts
• EOAExecutionOptions: Direct externally owned account execution

Full IThirdwebWallet Compatibility

ServerWallet implements the complete IThirdwebWallet interface, supporting:

• Signing: Personal sign, typed data v4, transaction signing
• Transactions: Send, execute, and track transactions
• Transfers: Simple token and ETH transfers
• Message Signing: Support for various message formats

Usage Examples

// Get wallet address
var address = await serverWallet.GetAddress();

// Sign messages
var signature = await serverWallet.PersonalSign("Hello, Thirdweb!");

// Sign typed data
var typedDataSignature = await serverWallet.SignTypedDataV4(jsonTypedData);

// Execute transactions
var receipt = await serverWallet.Transfer(
    chainId: 84532, 
    toAddress: "0x...", 
    weiAmount: 1000000000000000000 // 1 ETH
);

// Force specific execution mode
var smartWallet = await ServerWallet.Create(
    client: client, 
    label: "MyWallet",
    executionOptions: new ERC4337ExecutionOptions(chainId: 84532, signerAddress: address)
);

🚨 Breaking Changes & Migration

EngineWallet Deprecation

EngineWallet is now deprecated and will be removed in a future version. Please migrate to ServerWallet for continued support and new features.

Migration Guide:

// Old EngineWallet approach
var engineWallet = EngineWallet.Create(
    client: client,
    engineUrl: "https://your-engine-url",
    authToken: "your-auth-token",
    walletAddress: "0x..."
);

// New ServerWallet approach
var serverWallet = await ServerWallet.Create(
    client: client,
    label: "YourWalletLabel"
);

Key Differences

• Label-based: ServerWallet uses labels instead of direct address specification
• Cloud Integration: Built for thirdweb dashboard integration (Engine v3)
• Enhanced Security: Improved vault-based architecture
• Advanced Execution: Multiple execution strategies with intelligent auto-selection

v2.23.1

What's Changed

Building on top of the new EIP-7702 In-App or Ecosystem Wallet CreateSessionKey functionality, new utilities were added:

• SignerHasFullPermissions
• GetSessionStateForSigner
• GetCallPoliciesForSigner
• GetTransferPoliciesForSigner
• GetSessionExpirationForSigner