While there are many high-level APIs for interacting with Ethereum, such as Contracts and Providers, a lot of the low level access requires byte manipulation operations.
Many of these operations are used internally, but can also be used to help normalize binary data representations from the output of various functions and methods.
A Bytes is any object which is an Array or TypedArray with each value in the valid byte range (i.e. between 0 and 255 inclusive), or is an Object with a length property where each indexed property is in the valid byte range.
A BytesLike can be either a Bytes or a DataHexString.
A DataHexstring is identical to a HexString except that it has an even number of nibbles, and therefore is a valid representation of binary data as a string.
A Hexstring is a string which has a 0x prefix followed by any number of nibbles (i.e. case-insensitive hexadecimal characters, 0-9 and a-f).
- r and s --- The x co-ordinate of r and the s value of the signature
- v --- The parity of the y co-ordinate of r
- yParityAndS --- The compact representation of the s and v
- _vs --- Deprecated property; renamed to yParityAndS
- recoveryParam --- The normalized (i.e. 0 or 1) value of v
- compact - The full siggnature using compact representation
Raw Signature inherits string<DataHexString<65>>
A Raw Signature is a common Signature format where the r, s and v are concatenated into a 65 byte (130 nibble) DataHexString.
A SignatureLike is similar to a Signature, except redundant properties may be omitted or it may be a Raw Signature.
For example, if _vs is specified, s and v may be omitted. Likewise, if recoveryParam is provided, v may be omitted (as in these cases the missing values can be computed).
Returns true if and only if object is a Bytes or DataHexString.
Returns true if and only if object is a valid hex string. If length is specified and object is not a valid DataHexString of length bytes, an InvalidArgument error is thrown.
Converts DataHexStringOrArrayish to a Uint8Array.
Converts hexstringOrArrayish to a DataHexString.
Converts aBigNumberish to a HexString, with no unnecessary leading zeros.
Concatenates all the BytesLike in arrayOfBytesLike into a single Uint8Array.
Returns a Uint8Array with all leading 0 bytes of aBtyesLike removed.
Returns a Uint8Array of the data in aBytesLike with 0 bytes prepended to length bytes long.
If aBytesLike is already longer than length bytes long, an InvalidArgument error will be thrown.
Concatenates all the BytesLike in arrayOfBytesLike into a single DataHexString
Returns the length (in bytes) of aBytesLike.
Returns a DataHexString representation of a slice of aBytesLike, from offset (in bytes) to endOffset (in bytes). If endOffset is omitted, the length of aBytesLike is used.
Returns a HexString representation of aBytesLike with all leading zeros removed.
Returns a DataHexString representation of aBytesLike padded to length bytes.
If aBytesLike is already longer than length bytes long, an InvalidArgument error will be thrown.
Return the raw-format of aSignaturelike, which is 65 bytes (130 nibbles) long, concatenating the r, s and (normalized) v of a Signature.
Return the full expanded-format of aSignaturelike or a raw-format DataHexString. Any missing properties will be computed.
Return a new Uint8Array of length random bytes.
Return a copy of array shuffled using Fisher-Yates Shuffle.