SIZE_CONSTANTS

const SIZE_CONSTANTS: object

Defined in: packages/synapse-core/src/utils/constants.ts:45

Data size constants

Type Declaration

BYTES_PER_LEAF

readonly BYTES_PER_LEAF: 32n = 32n

Bytes per leaf in the PDP merkle tree.

Use leafCountToRawSize() on the aggregate data-set leaf count when calculating the approximate byte size used by FWSS pricing.

DEFAULT_UPLOAD_BATCH_SIZE

readonly DEFAULT_UPLOAD_BATCH_SIZE: 32 = 32

Default number of uploads to batch together in a single addPieces transaction This balances gas efficiency with reasonable transaction sizes

GiB

readonly GiB: bigint

Bytes in 1 GiB

KiB

readonly KiB: 1024n = 1024n

Bytes in 1 KiB

MAX_ADD_PIECES_MESSAGE_SIZE

readonly MAX_ADD_PIECES_MESSAGE_SIZE: number

Payload budget (bytes) for one addPieces / createAndAdd Filecoin message.

Filecoin messages are capped at 64 KiB. 288 bytes are reserved for message overhead (from, to, nonce, gas, method, …), leaving this much for encoded params. Used by the default piece-batcher limiter.

MAX_LEGACY_ADD_PIECES_BATCH_SIZE

readonly MAX_LEGACY_ADD_PIECES_BATCH_SIZE: 80 = 80

Maximum pieces per legacy data-set addition, enforced alongside the message-size limit.

MAX_UPLOAD_SIZE

readonly MAX_UPLOAD_SIZE: 68182605824 = 68_182_605_824

Maximum upload size currently supported by PDP servers.

64 GiB padded piece adjusted for fr32 expansion: 64 GiB * (127/128) = 68,182,605,824 bytes (63.5 GiB)

Fr32 encoding adds 2 bits of padding per 254 bits of data, resulting in 128 bytes of padded data for every 127 bytes of raw data. A 64 GiB raw payload therefore exceeds this limit once padded.

Note: While it’s technically possible to upload large pieces as Uint8Array, streaming via ReadableStream is strongly recommended for non-trivial sizes.

MiB

readonly MiB: bigint

Bytes in 1 MiB

MIN_UPLOAD_SIZE

readonly MIN_UPLOAD_SIZE: 127 = 127

Minimum upload size (128 bytes padded); matches what storage providers currently accept.

PiB

readonly PiB: bigint

Bytes in 1 PiB

TiB

readonly TiB: bigint

Bytes in 1 TiB