State Chain

A linear chain of multisig blocks forming a deterministic state machine. It carries DAO governance and drives emission: the oracle, tokenomics parameters, and network phase all live here.

Properties

• Linear — one chain, one tip
• Multisig — threshold signatures from DAOKeyset
• Self-referential — keyset stored in own KV store at sys.dao_keyset
• Deterministic — replay all blocks → same KV state

Block Structure

type Block struct {
    Index      uint64
    PrevHash   string
    Ops        []Op            // [{action: "set"/"delete", key, value}]
    Signatures []BlockSignature
    Hash       string          // SHA-256 of the canonical encoding (below)
    Timestamp  int64
}

The hash covers the canonical encoding index(8 BE) ‖ prev_hash(32) ‖ num_ops(4 BE) ‖ ops ‖ timestamp(8 BE) — signatures excluded, so signing does not change the hash.

System Keys

Six validated sys.* keys:

• sys.dao_keyset — DAO signer quorum (min threshold: 2)
• sys.timekeepers — trusted timekeeper keys and threshold
• sys.minter — authorized XUSD issuers
• sys.oracle — oracle configuration
• sys.phase — network phase (transitions are one-directional)
• sys.tokenomics — emission R-curve parameters and Hermite cap

sys.network_id is read-only — set at genesis, never writable over the chain.

Operations

• set — create/update key with JSON value
• delete — remove key (cannot delete sys.* keys)
• Key format: ^[a-z0-9_.-]+$, max 128 chars
• Value max: 64 KB, must be valid JSON

Sync

• Protocol: /xe/statechain-sync/1.0.0
• Gossip topic: xe/statechain
• Page size: 64 blocks
• 30-second per-peer cooldown
• Genesis never sent over sync (configured locally)