Skip to content

ValueInput = ArkivValue | boolean | number | bigint | string | Uint8Array

Defined in: src/schema/values.ts:500

A JavaScript value accepted wherever a typed value is expected: either a tagged value, or one of the five bare forms that map unambiguously onto a single type.

bare formtype
booleanbool
numberi32
bigintu256
stringstr
Uint8Arraybytes

Anything else — a large number, a decimal, an address, an entity key — must name its type, which is what keeps "0x1234..." a string rather than silently becoming a key.

These defaults apply identically when writing and when querying, so a value written bare and queried bare always agrees with itself. The mismatch to watch for is a bare value where its column has another type: a bare bigint is a u256, not a u64. Through a schema that is caught — a write throws SchemaMismatchError and a query throws InvalidPredicateError — but a query without a schema sends the predicate as written, and the engine, for which a type mismatch is not an error, simply matches nothing.