Skip to content

Arkiv enforces these limits on every entity and query. The SDK checks them before it sends anything, and exports each one as a constant.

LimitValueConstant
Attributes per entity, and columns per schema32, or 31 for a named schemaMAX_ATTRIBUTES
Attribute name length32 bytesMAX_NAME_BYTES
str value length128 bytes of UTF-8MAX_STRING_BYTES
bytes value length128 KiBMAX_BYTES_LENGTH
All bytes values of one create or patch128 KiBMAX_ENTITY_BYTES
Lifetime, from the block the create or extension lands in7,884,000 blocks, about 182.5 daysMAX_LIFETIME
Key salt128 bitsMAX_SALT
TypeRangeConstants
i32−2,147,483,648 to 2,147,483,647I32_MIN, I32_MAX
u640 to 2^64 − 1U64_MAX
u2560 to 2^256 − 1U256_MAX
dec18 decimal places, within the signed 256-bit range when scaledDECIMAL_SCALE
LimitValueConstant
Rows per page100MAX_LIMIT, from @arkiv-network/sdk/query

The node also limits query length and nesting depth. A query over those limits fails with a QueryError whose kind is "limits".