OpenParable
Skip to content
← Back to skills

Address Utils

Development
address-utils

Address Utils is an Agent Skill for development published in the Nethereum/Nethereum repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Validate and format Ethereum addresses with Nethereum. Use when the user needs address validation, EIP-55 checksum, address comparison, zero address handling, UniqueAddressList, or address padding.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Nethereum/Nethereum/blob/HEAD/plugins/nethereum-skills/skills/address-utils/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/address-utils, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Address Utilities with Nethereum

NuGet: Nethereum.Util

Source: UtilDocExampleTests

Required Usings

using System.Collections.Generic;
using Nethereum.Util;
using Nethereum.Hex.HexConvertors.Extensions;

EIP-55 Checksum Addresses

Mixed-case encoding that provides error detection without changing the address value.

var addressUtil = AddressUtil.Current;

var checksum = addressUtil.ConvertToChecksumAddress("0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed");
// "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"

// Works from all-uppercase too
var fromUpper = addressUtil.ConvertToChecksumAddress("0x5AAEB6053F3E94C9B9A09F33669435E7EF1BEAED");
// Same result: "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"

// Verify checksum
addressUtil.IsChecksumAddress("0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"); // true
addressUtil.IsChecksumAddress("0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed"); // false

// Convert from raw bytes
var bytes = "5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed".HexToByteArray();
var checksumFromBytes = addressUtil.ConvertToChecksumAddress(bytes);

Validate Address Format

var addressUtil = AddressUtil.Current;

// Full validation (hex format, length, prefix)
addressUtil.IsValidEthereumAddressHexFormat("0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"); // true
addressUtil.IsValidEthereumAddressHexFormat("not-an-address"); // false

// Length-only check (40 hex chars + 0x prefix)
addressUtil.IsValidAddressLength("0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"); // true
addressUtil.IsValidAddressLength("0x1234"); // false

Compare Addresses (Case-Insensitive)

Ethereum addresses are case-insensitive for equality. Always use these methods instead of ==.

var addressUtil = AddressUtil.Current;

// Static method
addressUtil.AreAddressesTheSame(
    "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
    "0x5AAEB6053F3E94C9B9A09F33669435E7EF1BEAED"); // true

// Extension method
"0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"
    .IsTheSameAddress("0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed"); // true

Empty / Zero Address Handling

var addressUtil = AddressUtil.Current;

// Check for empty/null/zero
addressUtil.IsAnEmptyAddress(null);  // true
addressUtil.IsAnEmptyAddress("");    // true
addressUtil.IsAnEmptyAddress("0x0"); // true

// Extension methods
"0x0".IsAnEmptyAddress();           // true
"0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed".IsNotAnEmptyAddress(); // true

// Constants
AddressUtil.ZERO_ADDRESS;      // "0x0000000000000000000000000000000000000000"
AddressUtil.AddressEmptyAsHex; // Same zero address

// Safe accessor (returns zero address for null)
string nullAddr = null;
addressUtil.AddressValueOrEmpty(nullAddr);
// "0x0000000000000000000000000000000000000000"

UniqueAddressList and AddressEqualityComparer

Case-insensitive address collections that prevent duplicates regardless of casing.

// UniqueAddressList deduplicates automatically
var uniqueList = new UniqueAddressList();
uniqueList.Add("0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed");
uniqueList.Add("0x5AAEB6053F3E94C9B9A09F33669435E7EF1BEAED");
uniqueList.Add("0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed");
// uniqueList.Count == 1

// AddressEqualityComparer for Dictionary/HashSet
var comparer = new AddressEqualityComparer();
comparer.Equals(
    "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
    "0x5AAEB6053F3E94C9B9A09F33669435E7EF1BEAED"); // true

// Use in Dictionary for case-insensitive key lookup
var dict = new Dictionary<string, int>(comparer);
dict["0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"] = 100;
dict["0x5AAEB6053F3E94C9B9A09F33669435E7EF1BEAED"]; // 100

Pad Short Addresses (ConvertToValid20ByteAddress)

Left-pads a short hex value to a full 20-byte address. Useful when dealing with contract return values or CREATE2 results.

var addressUtil = AddressUtil.Current;

addressUtil.ConvertToValid20ByteAddress("0x1234");
// "0x0000000000000000000000000000000000001234"

addressUtil.ConvertToValid20ByteAddress(null);
// "0x0000000000000000000000000000000000000000"

Keccak-256 Hashing

Used internally for checksum calculation. Also available for general-purpose hashing.

var keccak = Sha3Keccack.Current;

// Hash a string
keccak.CalculateHash("hello");
// "1c8aff950685c2ed4bc3174f3472287b56d9517b9c948127319a09a7a36deac8"

// Hash raw bytes
var bytes = new byte[] { 0x68, 0x65, 0x6c, 0x6c, 0x6f };
keccak.CalculateHash(bytes).ToHex();

// Hash from hex input
keccak.CalculateHashFromHex("0x68656c6c6f");

// Get result as byte array (32 bytes)
byte[] hashBytes = keccak.CalculateHashAsBytes("hello");