Address.fromHex

Try it Live

Run Address examples in the interactive playground

This page is a placeholder. All examples on this page are currently AI-generated and are not correct. This documentation will be completed in the future with accurate, tested examples.

View the complete executable example at playground/src/examples/primitives/address/from-hex.ts.

`primitives_address_from_hex(const char* hex, PrimitivesAddress* out_address): int`

Create address from hex string in C. Accepts hex strings with or without 0x prefix.Parameters:

hex: const char* - Hex string (with or without 0x prefix)
out_address: PrimitivesAddress* - Pointer to output address struct (20 bytes)

Returns: int - PRIMITIVES_SUCCESS (0) on success, error code otherwiseExample:

#include "primitives.h"

// From hex string
PrimitivesAddress addr1;
int result = primitives_address_from_hex("0x742d35Cc6634C0532925a3b844Bc9e7595f51e3e", &addr1);
if (result != PRIMITIVES_SUCCESS) {
    // Handle error
}

// From hex without prefix
PrimitivesAddress addr2;
result = primitives_address_from_hex("742d35Cc6634C0532925a3b844Bc9e7595f51e3e", &addr2);

// Case insensitive
PrimitivesAddress addr3;
result = primitives_address_from_hex("0x742D35CC6634C0532925A3B844BC9E7595F51E3E", &addr3);

Error Handling:

Returns non-zero error code on failure
Check result before using out_address
Common errors: invalid hex format, incorrect length

Memory: No allocation - address is copied to provided struct.Defined in: primitives.h:103

Format Requirements

Length (implementation-dependent): TypeScript implementations (Class API):

Requires 0x prefix: exactly 42 characters total

Zig and C implementations:

Accepts both formats:
- With 0x prefix: exactly 42 characters
- Without 0x prefix: exactly 40 characters

Characters:

Valid: 0-9, a-f, A-F
Invalid: g-z, G-Z, whitespace, special characters

Case sensitivity:

Parsing is case-insensitive
Both lowercase and uppercase hex are accepted
Mixed-case (EIP-55 checksummed) addresses are valid

Error Handling

import { Address } from '@tevm/voltaire'

// Missing 0x prefix
try {
  Address("742d35Cc6634C0532925a3b844Bc9e7595f51e3e")
} catch (e) {
  console.error(e) // InvalidHexFormatError
}

// Wrong length
try {
  Address("0x742d35")
} catch (e) {
  console.error(e) // InvalidHexFormatError
}

// Invalid characters
try {
  Address("0xGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG")
} catch (e) {
  console.error(e) // InvalidHexStringError
}

Validation Before Parsing

Use Address.isValid() to check before parsing:

const input = "0x742d35Cc6634C0532925a3b844Bc9e7595f51e3e"

if (Address.isValid(input)) {
  const addr = Address(input)
  console.log(addr.toHex())
} else {
  console.error("Invalid address format")
}

EIP-55 Checksums

fromHex() accepts checksummed addresses but does not validate checksums. Use isValidChecksum() to validate before parsing:

const checksummed = "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"

if (Address.isValidChecksum(checksummed)) {
  const addr = Address(checksummed)
  console.log("Checksum valid")
} else {
  console.warn("Invalid checksum, but parsing anyway")
  const addr = Address(checksummed)
}

Overview

Getting Started

Core Concepts

Skills

JSONRPCProvider

Contract

Primitives

Cryptography

EVM

Utils

Guides

Examples

Swift

Zig

Developer Documentation

Generated API (TypeDoc)

Try it Live

`primitives_address_from_hex(const char* hex, PrimitivesAddress* out_address): int`

Format Requirements

Error Handling

Validation Before Parsing

EIP-55 Checksums

See Also

Try it Live

​primitives_address_from_hex(const char* hex, PrimitivesAddress* out_address): int

​Format Requirements

​Error Handling

​Validation Before Parsing

​EIP-55 Checksums

​See Also

`primitives_address_from_hex(const char* hex, PrimitivesAddress* out_address): int`

Format Requirements

Error Handling

Validation Before Parsing

EIP-55 Checksums

See Also