Skip to content

Provenance

Token composition is modeled as creation of new immutable values, with ancestry stored on the result and source tokens marked as appropriate. Merge and split metadata includes:

Field Meaning
_mergedFrom IDs of source tokens used to create a merged token.
_mergedAt Timestamp recorded for the merge.
_mergedInto ID of a token that superseded this token in a merge.
_splitFrom ID of the token from which a split token came.
_splitInto IDs of resulting split tokens.
_splitIndex and _splitAt Position and timestamp for a split result.

These fields describe lineage; they do not by themselves enforce ownership, scarcity, or legality. A game that needs those guarantees must validate the operation through actions and policies. Provenance remains useful for audit views, replay inspection, and deriving relationships between immutable values.