package hexutil
import "github.com/ethereum/go-ethereum/common/hexutil"
Package hexutil implements hex encoding with 0x prefix. This encoding is used by the Ethereum RPC API to transport binary data in JSON payloads.
Encoding Rules
All hex data must have prefix "0x".
For byte slices, the hex data must be of even length. An empty byte slice encodes as "0x".
Integers are encoded using the least amount of digits (no leading zero digits). Their encoding may be of uneven length. The number zero encodes as "0x0".
Index ¶
- Variables
- func Decode(input string) ([]byte, error)
- func DecodeBig(input string) (*big.Int, error)
- func DecodeUint64(input string) (uint64, error)
- func Encode(b []byte) string
- func EncodeBig(bigint *big.Int) string
- func EncodeUint64(i uint64) string
- func MustDecode(input string) []byte
- func MustDecodeBig(input string) *big.Int
- func MustDecodeUint64(input string) uint64
- func UnmarshalFixedJSON(typ reflect.Type, input, out []byte) error
- func UnmarshalFixedText(typname string, input, out []byte) error
- func UnmarshalFixedUnprefixedText(typname string, input, out []byte) error
- type Big
- func (b Big) ImplementsGraphQLType(name string) bool
- func (b Big) MarshalText() ([]byte, error)
- func (b *Big) String() string
- func (b *Big) ToInt() *big.Int
- func (b *Big) UnmarshalGraphQL(input interface{}) error
- func (b *Big) UnmarshalJSON(input []byte) error
- func (b *Big) UnmarshalText(input []byte) error
- type Bytes
- func (b Bytes) ImplementsGraphQLType(name string) bool
- func (b Bytes) MarshalText() ([]byte, error)
- func (b Bytes) String() string
- func (b *Bytes) UnmarshalGraphQL(input interface{}) error
- func (b *Bytes) UnmarshalJSON(input []byte) error
- func (b *Bytes) UnmarshalText(input []byte) error
- type U256
- func (b U256) MarshalText() ([]byte, error)
- func (b *U256) String() string
- func (b *U256) UnmarshalJSON(input []byte) error
- func (b *U256) UnmarshalText(input []byte) error
- type Uint
- func (b Uint) MarshalText() ([]byte, error)
- func (b Uint) String() string
- func (b *Uint) UnmarshalJSON(input []byte) error
- func (b *Uint) UnmarshalText(input []byte) error
- type Uint64
Examples ¶
Variables ¶
var ( ErrEmptyString = &decError{"empty hex string"} ErrSyntax = &decError{"invalid hex string"} ErrMissingPrefix = &decError{"hex string without 0x prefix"} ErrOddLength = &decError{"hex string of odd length"} ErrEmptyNumber = &decError{"hex string \"0x\""} ErrLeadingZero = &decError{"hex number with leading zero digits"} ErrUint64Range = &decError{"hex number > 64 bits"} ErrUintRange = &decError{fmt.Sprintf("hex number > %d bits", uintBits)} ErrBig256Range = &decError{"hex number > 256 bits"} )
Errors
Functions ¶
func Decode ¶
Decode decodes a hex string with 0x prefix.
func DecodeBig ¶
DecodeBig decodes a hex string with 0x prefix as a quantity. Numbers larger than 256 bits are not accepted.
func DecodeUint64 ¶
DecodeUint64 decodes a hex string with 0x prefix as a quantity.
func Encode ¶
Encode encodes b as a hex string with 0x prefix.
func EncodeBig ¶
EncodeBig encodes bigint as a hex string with 0x prefix.
func EncodeUint64 ¶
EncodeUint64 encodes i as a hex string with 0x prefix.
func MustDecode ¶
MustDecode decodes a hex string with 0x prefix. It panics for invalid input.
func MustDecodeBig ¶
MustDecodeBig decodes a hex string with 0x prefix as a quantity. It panics for invalid input.
func MustDecodeUint64 ¶
MustDecodeUint64 decodes a hex string with 0x prefix as a quantity. It panics for invalid input.
func UnmarshalFixedJSON ¶
UnmarshalFixedJSON decodes the input as a string with 0x prefix. The length of out determines the required input length. This function is commonly used to implement the UnmarshalJSON method for fixed-size types.
func UnmarshalFixedText ¶
UnmarshalFixedText decodes the input as a string with 0x prefix. The length of out
determines the required input length. This function is commonly used to implement the
UnmarshalText method for fixed-size types.
Code:play
Output:Example¶
package main
import (
"encoding/json"
"fmt"
"github.com/ethereum/go-ethereum/common/hexutil"
)
type MyType [5]byte
func (v *MyType) UnmarshalText(input []byte) error {
return hexutil.UnmarshalFixedText("MyType", input, v[:])
}
func (v MyType) String() string {
return hexutil.Bytes(v[:]).String()
}
func main() {
var v1, v2 MyType
fmt.Println("v1 error:", json.Unmarshal([]byte(`"0x01"`), &v1))
fmt.Println("v2 error:", json.Unmarshal([]byte(`"0x0101010101"`), &v2))
fmt.Println("v2:", v2)
}
v1 error: hex string has length 2, want 10 for MyType
v2 error: <nil>
v2: 0x0101010101
func UnmarshalFixedUnprefixedText ¶
UnmarshalFixedUnprefixedText decodes the input as a string with optional 0x prefix. The length of out determines the required input length. This function is commonly used to implement the UnmarshalText method for fixed-size types.
Types ¶
type Big ¶
Big marshals/unmarshals as a JSON string with 0x prefix. The zero value marshals as "0x0".
Negative integers are not supported at this time. Attempting to marshal them will return an error. Values larger than 256bits are rejected by Unmarshal but will be marshaled without error.
func (Big) ImplementsGraphQLType ¶
ImplementsGraphQLType returns true if Big implements the provided GraphQL type.
func (Big) MarshalText ¶
MarshalText implements encoding.TextMarshaler
func (*Big) String ¶
String returns the hex encoding of b.
func (*Big) ToInt ¶
ToInt converts b to a big.Int.
func (*Big) UnmarshalGraphQL ¶
UnmarshalGraphQL unmarshals the provided GraphQL query data.
func (*Big) UnmarshalJSON ¶
UnmarshalJSON implements json.Unmarshaler.
func (*Big) UnmarshalText ¶
UnmarshalText implements encoding.TextUnmarshaler
type Bytes ¶
type Bytes []byte
Bytes marshals/unmarshals as a JSON string with 0x prefix. The empty slice marshals as "0x".
func (Bytes) ImplementsGraphQLType ¶
ImplementsGraphQLType returns true if Bytes implements the specified GraphQL type.
func (Bytes) MarshalText ¶
MarshalText implements encoding.TextMarshaler
func (Bytes) String ¶
String returns the hex encoding of b.
func (*Bytes) UnmarshalGraphQL ¶
UnmarshalGraphQL unmarshals the provided GraphQL query data.
func (*Bytes) UnmarshalJSON ¶
UnmarshalJSON implements json.Unmarshaler.
func (*Bytes) UnmarshalText ¶
UnmarshalText implements encoding.TextUnmarshaler.
type U256 ¶
U256 marshals/unmarshals as a JSON string with 0x prefix. The zero value marshals as "0x0".
func (U256) MarshalText ¶
MarshalText implements encoding.TextMarshaler
func (*U256) String ¶
String returns the hex encoding of b.
func (*U256) UnmarshalJSON ¶
UnmarshalJSON implements json.Unmarshaler.
func (*U256) UnmarshalText ¶
UnmarshalText implements encoding.TextUnmarshaler
type Uint ¶
type Uint uint
Uint marshals/unmarshals as a JSON string with 0x prefix. The zero value marshals as "0x0".
func (Uint) MarshalText ¶
MarshalText implements encoding.TextMarshaler.
func (Uint) String ¶
String returns the hex encoding of b.
func (*Uint) UnmarshalJSON ¶
UnmarshalJSON implements json.Unmarshaler.
func (*Uint) UnmarshalText ¶
UnmarshalText implements encoding.TextUnmarshaler.
type Uint64 ¶
type Uint64 uint64
Uint64 marshals/unmarshals as a JSON string with 0x prefix. The zero value marshals as "0x0".
func (Uint64) ImplementsGraphQLType ¶
ImplementsGraphQLType returns true if Uint64 implements the provided GraphQL type.
func (Uint64) MarshalText ¶
MarshalText implements encoding.TextMarshaler.
func (Uint64) String ¶
String returns the hex encoding of b.
func (*Uint64) UnmarshalGraphQL ¶
UnmarshalGraphQL unmarshals the provided GraphQL query data.
func (*Uint64) UnmarshalJSON ¶
UnmarshalJSON implements json.Unmarshaler.
func (*Uint64) UnmarshalText ¶
UnmarshalText implements encoding.TextUnmarshaler
Source Files ¶
- Version
- v1.15.11 (latest)
- Published
- May 5, 2025
- Platform
- linux/amd64
- Imports
- 7 packages
- Last checked
- 2 days ago –
Tools for package owners.