ByteEncoder

Extension methods for encoding values to bytes.

Natural number type (non-negative BigInt).

Summons a ByteEncoder instance for type A.

Encodes signed integers using sign-magnitude encoding.

Encoding transformation:

• Positive n: encode (n * 2) as BigNat
• Negative n: encode (n * (-2) + 1) as BigNat

This ensures deterministic encoding while preserving sign information.

Encodes natural numbers with variable-length encoding.

Encoding rules:

• 0x00 ~ 0x80: single byte for values 0-128
• 0x81 ~ 0xf7: [0x80+len][data] for 1-119 byte data
• 0xf8: [0xf8][data] for exactly 120-byte data
• 0xf9 ~ 0xff: [0xf8+(ll-1)][len][data] for 121+ byte data, where ll is at least 2

Encodes Boolean as a canonical single-byte flag.

Encoding:

• false: 0x00
• true: 0x01

Encodes Byte as single byte.

Automatic derivation for product types (case classes, tuples).

Encodes each field in order and concatenates the results.

Encodes Instant as epoch milliseconds (Long encoding).

Encodes List as [size:BigNat][elem1][elem2]...[elemN].

Preserves order of elements.

Encodes Long as 8-byte big-endian representation.

Encodes Map as deterministically sorted Set of tuples.

Converted to Set[(K, V)] and encoded with Set's deterministic ordering.

Encodes Option as zero or one-element List.

Encoding:

• None: [0x00]
• Some(x): [0x01][x encoded]

Encodes Set with deterministic ordering.

Elements are encoded individually, then sorted lexicographically by their byte representation before concatenation. This ensures deterministic encoding regardless of Set iteration order.

Encodes Unit as empty byte sequence.