fromHex

Decodes a hex string to bytes, number, boolean, or string using a fluent API.

Import

import "github.com/ChefBingbong/viem-go/utils/encoding"

Usage

import "github.com/ChefBingbong/viem-go/utils/encoding"
import "math/big"

// Convert hex to bytes
bytes, _ := encoding.FromHex("0x48656c6c6f").ToBytes()
// []byte{72, 101, 108, 108, 111}

// Convert hex to big.Int
num, _ := encoding.FromHex("0x1a4").ToBigInt()
// big.Int representing 420

// Convert hex to int64
num, _ := encoding.FromHex("0x1a4").ToNumber()
// int64(420)

// Convert hex to uint64
num, _ := encoding.FromHex("0x1a4").ToUint()
// uint64(420)

// Convert hex to boolean
b, _ := encoding.FromHex("0x1").ToBool()
// true

// Convert hex to string
str, _ := encoding.FromHex("0x48656c6c6f20776f726c642e").ToString()
// "Hello world."

// With size validation
bytes, _ := encoding.FromHex("0x01").WithSize(4).ToBytes()
// []byte{0x00, 0x00, 0x00, 0x01} (padded)

Returns

• Type: Depends on the conversion method called ([]byte, *big.Int, int64, uint64, bool, string, error)

The decoded value in the requested format.

Parameters

hex (required)

• Type: string

The hex string to decode (should have 0x prefix).

bytes, _ := encoding.FromHex("0x48656c6c6f").ToBytes()

WithSize(size) (optional)

• Type: int

Validates and optionally pads the hex to the specified byte size.

// Validate size and pad if needed
bytes, _ := encoding.FromHex("0x01").WithSize(4).ToBytes()
// []byte{0x00, 0x00, 0x00, 0x01}

WithSigned() (optional)

• Type: method

Treats the hex as a signed integer (two's complement) for ToBigInt and ToNumber conversions.

// Convert signed hex
num, _ := encoding.FromHex("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff").
  WithSize(32).
  WithSigned().
  ToBigInt()
// big.Int representing -1

Conversion Methods

ToBytes()

Converts hex to a byte slice:

bytes, _ := encoding.FromHex("0x0102").ToBytes()
// []byte{0x01, 0x02}

ToBigInt()

Converts hex to a *big.Int:

num, _ := encoding.FromHex("0x1a4").ToBigInt()
// big.Int representing 420

ToNumber()

Converts hex to an int64:

num, _ := encoding.FromHex("0x1a4").ToNumber()
// int64(420)

ToUint()

Converts hex to a uint64:

num, _ := encoding.FromHex("0x1a4").ToUint()
// uint64(420)

ToBool()

Converts hex to a boolean:

b, _ := encoding.FromHex("0x1").ToBool()
// true

b, _ = encoding.FromHex("0x0").ToBool()
// false

ToString()

Converts hex to a UTF-8 string:

str, _ := encoding.FromHex("0x48656c6c6f").ToString()
// "Hello"

Standalone Functions

HexToBytes

Converts hex to bytes:

bytes, _ := encoding.HexToBytes("0x0102")
// []byte{0x01, 0x02}

HexToBigInt

Converts hex to *big.Int:

num, _ := encoding.HexToBigInt("0x1a4", false)
// big.Int representing 420

HexToNumber

Converts hex to int64:

num, _ := encoding.HexToNumber("0x1a4", false)
// int64(420)

HexToUint

Converts hex to uint64:

num, _ := encoding.HexToUint("0x1a4")
// uint64(420)

HexToBool

Converts hex to boolean:

b, _ := encoding.HexToBool("0x1")
// true

HexToString

Converts hex to string:

str, _ := encoding.HexToString("0x48656c6c6f")
// "Hello"