Encodings

Here we describe the encodings of various types and values throughout the APIs.

Addresses

All Ethereum addresses that are provided in responses are always lowercased.

Block number

Block numbers are always encoded as string(s).

Token ID

Tokens IDs are always encoded as string(s).

Quantity and other numerics

Quantities and any large numeric values are always encoded as string(s).

Standard scalar types are used where possible, most commonly uint64, uint32, double, bytes.

Transaction values

Transaction values are always encoded as string(s).

Timestamp

In JSON format, the Timestamp type is encoded as a string in the RFC 3339 format. That is, the format is {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. The Z suffix indicates the timezone (UTC); the timezone is required.