Thirdweb 0.0.10
.NET 6.0
This package targets .NET 6.0. The package is compatible with this framework or higher.
.NET Standard 2.1
This package targets .NET Standard 2.1. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package Thirdweb --version 0.0.10
NuGet\Install-Package Thirdweb -Version 0.0.10
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Thirdweb" Version="0.0.10" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Thirdweb --version 0.0.10
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Thirdweb, 0.0.10"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Thirdweb as a Cake Addin #addin nuget:?package=Thirdweb&version=0.0.10 // Install Thirdweb as a Cake Tool #tool nuget:?package=Thirdweb&version=0.0.10
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Thirdweb .NET SDK
Overview
The Thirdweb .NET SDK is a powerful library that allows developers to interact with the blockchain using the .NET framework. It provides a set of convenient methods and classes to simplify the integration of Web3 functionality into your .NET applications.
Features
- Connect to any EVM network
- Query blockchain data using Thirdweb RPC
- Interact with smart contracts
Installation
To use the Thirdweb .NET SDK in your project, you can either download the source code and build it manually, or install it via NuGet package manager.
dotnet add package Thirdweb
Usage
Simple Example
// A single client fits most use cases
var client = ThirdwebClient.Create(clientId: "myClientId", bundleId: "com.my.bundleid");
// Optionally pass abi, if not passed we fetch it for you
var contract = await ThirdwebContract.Create(client: client, address: "0x81ebd23aA79bCcF5AaFb9c9c5B0Db4223c39102e", chain: 421614);
var readResult = await ThirdwebContract.Read<string>(contract, "name");
Console.WriteLine($"Contract read result: {readResult}");
// Create embedded account as signer to unlock web2 auth
var embeddedAccount = await EmbeddedAccount.Create(client: client, email: "email@email.com"); // or email: null, phoneNumber: "+1234567890"
// Relog if embedded account not logged in
if (!await embeddedAccount.IsConnected())
{
await embeddedAccount.SendOTP();
Console.WriteLine("Please submit the OTP.");
var otp = Console.ReadLine();
(var embeddedAccountAddress, var canRetry) = await embeddedAccount.SubmitOTP(otp);
if (embeddedAccountAddress == null && canRetry)
{
Console.WriteLine("Please submit the OTP again.");
otp = Console.ReadLine();
(embeddedAccountAddress, _) = await embeddedAccount.SubmitOTP(otp);
}
if (embeddedAccountAddress == null)
{
Console.WriteLine("OTP login failed. Please try again.");
return;
}
}
// Create a smart account to unlock gasless features, with embedded account as a signer
var smartAccount = await SmartAccount.Create(client: client, personalAccount: embeddedAccount, factoryAddress: "0xbf1C9aA4B1A085f7DA890a44E82B0A1289A40052", gasless: true, chainId: 421614);
// Log addresses
Console.WriteLine($"Embedded Account: {await embeddedAccount.GetAddress()}");
Console.WriteLine($"Smart Account: {await smartAccount.GetAddress()}");
// Sign, triggering deploy as needed and 1271 verification if it's a smart wallet
var message = "Hello, Thirdweb!";
var signature = await smartAccount.PersonalSign(message);
Console.WriteLine($"Signed message: {signature}");
var writeResult = await ThirdwebContract.Write(smartAccount, contract, "mintTo", 0, await smartAccount.GetAddress(), 100);
Console.WriteLine($"Contract write result: {writeResult}");
Advanced Example
using Thirdweb;
// Do not use secret keys client side, use client id/bundle id instead
var secretKey = Environment.GetEnvironmentVariable("THIRDWEB_SECRET_KEY");
// Do not use private keys client side, use embedded/smart accounts instead
var privateKey = Environment.GetEnvironmentVariable("PRIVATE_KEY");
// Fetch timeout options are optional, default is 60000ms
var client = ThirdwebClient.Create(secretKey: secretKey, fetchTimeoutOptions: new TimeoutOptions(storage: 30000, rpc: 60000));
var contract = await ThirdwebContract.Create(client: client, address: "0x81ebd23aA79bCcF5AaFb9c9c5B0Db4223c39102e", chain: 421614);
var readResult = await ThirdwebContract.Read<string>(contract, "name");
Console.WriteLine($"Contract read result: {readResult}");
// Create accounts (this is an advanced use case, typically one account is plenty)
var privateKeyAccount = await PrivateKeyAccount.Create(client: client, privateKeyHex: privateKey);
var embeddedAccount = await EmbeddedAccount.Create(client: client, email: "email@email.com"); // or email: null, phoneNumber: "+1234567890"
var smartAccount = await SmartAccount.Create(client: client, personalAccount: embeddedAccount, factoryAddress: "0xbf1C9aA4B1A085f7DA890a44E82B0A1289A40052", gasless: true, chainId: 421614);
// // Reset embedded account (optional step for testing login flow)
// if (await embeddedAccount.IsConnected())
// {
// await embeddedAccount.Disconnect();
// }
// Relog if embedded account not logged in
if (!await embeddedAccount.IsConnected())
{
await embeddedAccount.SendOTP();
Console.WriteLine("Please submit the OTP.");
var otp = Console.ReadLine();
(var embeddedAccountAddress, var canRetry) = await embeddedAccount.SubmitOTP(otp);
if (embeddedAccountAddress == null && canRetry)
{
Console.WriteLine("Please submit the OTP again.");
otp = Console.ReadLine();
(embeddedAccountAddress, _) = await embeddedAccount.SubmitOTP(otp);
}
if (embeddedAccountAddress == null)
{
Console.WriteLine("OTP login failed. Please try again.");
return;
}
}
// Connect the smart account with embedded signer and grant a session key to pk account (advanced use case)
_ = await smartAccount.CreateSessionKey(
signerAddress: await privateKeyAccount.GetAddress(),
approvedTargets: new List<string>() { Constants.ADDRESS_ZERO },
nativeTokenLimitPerTransactionInWei: "0",
permissionStartTimestamp: "0",
permissionEndTimestamp: (Utils.GetUnixTimeStampNow() + 86400).ToString(),
reqValidityStartTimestamp: "0",
reqValidityEndTimestamp: Utils.GetUnixTimeStampIn10Years().ToString()
);
// Reconnect to same smart account with pk account as signer (specifying account address override)
smartAccount = await SmartAccount.Create(
client: client,
personalAccount: privateKeyAccount,
factoryAddress: "0xbf1C9aA4B1A085f7DA890a44E82B0A1289A40052",
gasless: true,
chainId: 421614,
accountAddressOverride: await smartAccount.GetAddress()
);
// Log addresses
Console.WriteLine($"PrivateKey Account: {await privateKeyAccount.GetAddress()}");
Console.WriteLine($"Embedded Account: {await embeddedAccount.GetAddress()}");
Console.WriteLine($"Smart Account: {await smartAccount.GetAddress()}");
// Sign, triggering deploy as needed and 1271 verification if it's a smart wallet
var message = "Hello, Thirdweb!";
var signature = await smartAccount.PersonalSign(message);
Console.WriteLine($"Signed message: {signature}");
var balanceBefore = await ThirdwebContract.Read<BigInteger>(contract, "balanceOf", await smartAccount.GetAddress());
Console.WriteLine($"Balance before mint: {balanceBefore}");
var writeResult = await ThirdwebContract.Write(smartAccount, contract, "mintTo", 0, await smartAccount.GetAddress(), 100);
Console.WriteLine($"Contract write result: {writeResult}");
var balanceAfter = await ThirdwebContract.Read<BigInteger>(contract, "balanceOf", await smartAccount.GetAddress());
Console.WriteLine($"Balance after mint: {balanceAfter}");
// Storage actions
// // Will download from IPFS or normal urls
// var downloadResult = await ThirdwebStorage.Download<string>(client: client, uri: "AnyUrlIncludingIpfs");
// Console.WriteLine($"Download result: {downloadResult}");
// // Will upload to IPFS
// var uploadResult = await ThirdwebStorage.Upload(client: client, path: "AnyPath");
// Console.WriteLine($"Upload result preview: {uploadResult.PreviewUrl}");
// Access RPC directly if needed, generally not recommended
// var rpc = ThirdwebRPC.GetRpcInstance(client, 421614);
// var blockNumber = await rpc.SendRequestAsync<string>("eth_blockNumber");
// Console.WriteLine($"Block number: {blockNumber}");
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.1 is compatible. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.1
- Amazon.Extensions.CognitoAuthentication (>= 2.5.0)
- AWSSDK.Lambda (>= 3.7.113.2)
- Nethereum.ABI (>= 4.19.0)
- Nethereum.Contracts (>= 4.19.0)
- Nethereum.HdWallet (>= 4.14.0)
- Nethereum.Hex (>= 4.19.0)
- Nethereum.Signer (>= 4.19.0)
- Nethereum.Signer.EIP712 (>= 4.19.0)
- Newtonsoft.Json (>= 13.0.3)
- Portable.BouncyCastle (>= 1.9.0)
-
net6.0
- Amazon.Extensions.CognitoAuthentication (>= 2.5.0)
- AWSSDK.Lambda (>= 3.7.113.2)
- Nethereum.ABI (>= 4.19.0)
- Nethereum.Contracts (>= 4.19.0)
- Nethereum.HdWallet (>= 4.14.0)
- Nethereum.Hex (>= 4.19.0)
- Nethereum.Signer (>= 4.19.0)
- Nethereum.Signer.EIP712 (>= 4.19.0)
- Newtonsoft.Json (>= 13.0.3)
- Portable.BouncyCastle (>= 1.9.0)
-
net7.0
- Amazon.Extensions.CognitoAuthentication (>= 2.5.0)
- AWSSDK.Lambda (>= 3.7.113.2)
- Nethereum.ABI (>= 4.19.0)
- Nethereum.Contracts (>= 4.19.0)
- Nethereum.HdWallet (>= 4.14.0)
- Nethereum.Hex (>= 4.19.0)
- Nethereum.Signer (>= 4.19.0)
- Nethereum.Signer.EIP712 (>= 4.19.0)
- Newtonsoft.Json (>= 13.0.3)
- Portable.BouncyCastle (>= 1.9.0)
-
net8.0
- Amazon.Extensions.CognitoAuthentication (>= 2.5.0)
- AWSSDK.Lambda (>= 3.7.113.2)
- Nethereum.ABI (>= 4.19.0)
- Nethereum.Contracts (>= 4.19.0)
- Nethereum.HdWallet (>= 4.14.0)
- Nethereum.Hex (>= 4.19.0)
- Nethereum.Signer (>= 4.19.0)
- Nethereum.Signer.EIP712 (>= 4.19.0)
- Newtonsoft.Json (>= 13.0.3)
- Portable.BouncyCastle (>= 1.9.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
2.0.0 | 23 | 9/5/2024 |
1.5.0 | 84 | 8/20/2024 |
1.4.0 | 284 | 8/12/2024 |
1.3.0 | 69 | 8/7/2024 |
1.2.0 | 64 | 8/7/2024 |
1.1.0 | 53 | 8/2/2024 |
1.0.2 | 58 | 7/31/2024 |
1.0.1 | 78 | 7/16/2024 |
1.0.0 | 112 | 7/1/2024 |
0.4.0 | 119 | 6/1/2024 |
0.3.1 | 99 | 5/29/2024 |
0.3.0 | 99 | 5/23/2024 |
0.2.0 | 120 | 5/15/2024 |
0.1.1 | 129 | 4/15/2024 |
0.1.0 | 78 | 4/12/2024 |
0.0.13 | 84 | 4/10/2024 |
0.0.12 | 89 | 4/10/2024 |
0.0.11 | 76 | 4/10/2024 |
0.0.10 | 91 | 4/10/2024 |
0.0.9 | 102 | 4/10/2024 |
0.0.8 | 93 | 4/9/2024 |
0.0.7 | 81 | 4/9/2024 |
0.0.6 | 97 | 4/8/2024 |
0.0.5 | 94 | 4/5/2024 |
0.0.4 | 106 | 4/3/2024 |
0.0.3 | 80 | 4/3/2024 |
0.0.1 | 114 | 3/26/2024 |
0.0.0 | 100 | 3/26/2024 |