State Chain

A linear chain of multisig blocks forming a deterministic state machine for DAO governance.

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 ops only
    Timestamp  int64
}

System Keys

• sys.dao_keyset — DAO signer quorum (min threshold: 2)
• sys.timekeepers — trusted timekeeper keys and threshold

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)