.NET SDK

Utils

Utils bundles the SDK's most handy helpers for formatting values, working with addresses, and preparing typed data. If you need an API not covered here, check the full reference.

Constants.ADDRESS_ZERO             // 0x0000…0000 (zero address)
Constants.NATIVE_TOKEN_ADDRESS     // 0xEeee…EEeE (native token sentinel)
Constants.DECIMALS_18              // 1e18 as a double (decimal scaling helper)
 
Constants.IERC20_INTERFACE_ID      // ERC-165 ID for ERC-20
Constants.IERC721_INTERFACE_ID     // ERC-165 ID for ERC-721
Constants.IERC1155_INTERFACE_ID    // ERC-165 ID for ERC-1155
 
Constants.ENTRYPOINT_ADDRESS_V06   // Default ERC-4337 entry point v0.6
Constants.ENTRYPOINT_ADDRESS_V07   // Default ERC-4337 entry point v0.7
 
Constants.DEFAULT_FACTORY_ADDRESS_V06 // Default Thirdweb factory v0.6
Constants.DEFAULT_FACTORY_ADDRESS_V07 // Default Thirdweb factory v0.7
 
Constants.EIP_1271_MAGIC_VALUE     // Expected return value for EIP-1271 signature validation
Constants.ERC_6492_MAGIC_VALUE     // Magic value appended to ERC-6492 signatures

Fetch metadata (native token, RPCs, explorers, stack type, etc.) for a given chain ID. Results are cached in-memory.

ThirdwebChainData data = await Utils.GetChainMetadata(client, chainId);

Quickly check if a chain uses zkSync infrastructure. Falls back to chain metadata when the ID is not one of the known zkSync networks.

bool isZkSync = await Utils.IsZkSync(client, chainId);

Normalize any hex address to its EIP-55 checksum representation.

string checksum = address.ToChecksumAddress();

Lightweight validation for EVM addresses.

if (!input.IsValidAddress()) {
	throw new ArgumentException("Expected an EVM address");
}

Resolve between ENS names and addresses. Lookups are cached per process.

string ens = await Utils.GetENSFromAddress(client, address);
string addr = await Utils.GetAddressFromENS(client, ensName);

Pull public social metadata (Lens, Farcaster, etc.) for an address or ENS.

SocialProfiles profiles = await Utils.GetSocialProfiles(client, "vitalik.eth");

Join multiple hex strings (with 0x prefixes) into a single blob.

string callData = Utils.HexConcat("0x1234", "0x5566");

Extension helpers for toggling between byte arrays and hex.

byte[] bytes = hex.HexToBytes();
string hexAgain = bytes.BytesToHex();

Convert between hex strings and BigInteger values.

BigInteger gas = "0x5208".HexToNumber();
string hexValue = gas.NumberToHex();

Encode or decode UTF-8 strings as hex.

string payload = "Hello".StringToHex();
string message = payload.HexToString();

Generate Ethereum-style prefixed hashes or raw Keccak hashes.

byte[] prefixed = messageBytes.HashPrefixedMessage();
string keccak = message.HashMessage();

Left-pad a hex string so it fits into exactly 32 bytes.

byte[] padded = someHex.HexToBytes32();

Strip leading zero bytes—handy before ABI encoding.

byte[] trimmed = signature.TrimZeroes();

Stringify large integers inside a typed-data payload before sending it to browsers or wallets.

string normalizedJson = Utils.PreprocessTypedDataJson(rawJson);

Convert strongly typed EIP-712 data structures into wallet-ready JSON.

string json = Utils.ToJsonExternalWalletFriendly(typedData, message);

Wrap signatures for ERC-6492 (counterfactual ERC-4337 accounts) with the required magic value.

string wrapped = Utils.SerializeErc6492Signature(factoryAddress, deploymentCalldata, signatureBytes);

Convert between human-readable token amounts and Wei.

string wei = "0.05".ToWei();
string eth = wei.ToEth(decimalsToDisplay: 6, addCommas: true);
string usdc = Utils.FormatERC20(usdcRawValue, decimalsToDisplay: 2, decimals: 6);

Scale a BigInteger between two decimal systems—useful when toggling between token decimals.

BigInteger stableValue = amount.AdjustDecimals(18, 6);

Assemble a Sign-In With Ethereum message from a LoginPayloadData object. Throws if required fields are missing to help surface misconfigurations early.

string messageToSign = Utils.GenerateSIWE(payload);

Timestamp helpers for authentication windows or scheduled expirations.

long now = Utils.GetUnixTimeStampNow();
long farFuture = Utils.GetUnixTimeStampIn10Years();

Swap ipfs:// URIs for a gateway of your choice (defaults to the Thirdweb fallback gateway).

string httpUrl = ipfsUri.ReplaceIPFS("https://w3s.link/ipfs/");

Retrieve legacy gas prices or EIP-1559 fee suggestions with optional safety bumps. Polygon, Celo, and Arbitrum chains get tailor-made logic.

BigInteger gasPrice = await Utils.FetchGasPrice(client, chainId);
(BigInteger maxFee, BigInteger maxPriority) = await Utils.FetchGasFees(client, chainId);

Runtime checks that tell you whether a chain requires EIP-155 signatures and whether it supports EIP-1559 style fees.

bool needsProtectedTx = await Utils.IsEip155Enforced(client, chainId);
bool supports1559 = Utils.IsEip1559Supported(chainId.ToString());

Poll for a transaction receipt with built-in timeouts from the client's fetch options.

var receipt = await Utils.WaitForTransactionReceipt(client, chainId, txHash);

Check whether bytecode exists at an address.

bool deployed = await Utils.IsDeployed(client, chainId, contractAddress);

Detect delegated accounts (EIP-7702 style) by comparing on-chain code against the delegation contract.

bool delegated = await Utils.IsDelegatedAccount(client, chainId, address, delegationContract);

Encode ENS-style DNS packets. Exposed for advanced ENS tooling; most integrations can rely on the higher-level ENS helpers above.

byte[] packet = Utils.PacketToBytes("subdomain.example.eth");