Corporate State Schema v0

The balance-sheet schema behind CapState.

CapState models issuer records as state nodes with source documents, hashes, as-of dates, authority references, and derived metrics. The schema is designed for humans to inspect and for contracts/agents to reference safely.

Identity + authority

issuer_identity, legal_entity, security_listing, authority_document, authorized_wallet, authorized_officer, revocation_notice

Treasury + cash

treasury_asset, cash_balance, restricted_cash, custody_account, encumbrance, proof_of_reserve_reference

Claims + equity

debt_instrument, preferred_series, convertible_note, warrant, option_plan, common_equity, share_count, seniority_layer

Rules + triggers

treasury_policy, issuance_policy, dividend_policy, covenant, coverage_trigger

Derived state

derived_metric, methodology, factor_score, oracle_feed

Provenance

source_document, issuer_attestation, verification_receipt, onchain_receipt, dispute

Canonical node shape

{
  "id": "cash:AA001:USD:2026-05-28",
  "type": "cash_balance",
  "issuerId": "AA001",
  "asOf": "2026-05-28",
  "value": { "amount": 84200000, "currency": "USD", "restriction": "unrestricted" },
  "sourceDocument": "10-Q / issuer attestation",
  "hash": "0x…",
  "authorityId": "capstate-demo-authority",
  "status": "indexed"
}

Cross-chain attestation fields

{
  "attestation": {
    "canonicalChain": "ethereum",
    "schemaUid": "0x…",
    "attestationUid": "0x…",
    "stateHash": "0x…"
  },
  "settlement": {
    "chain": "base",
    "oracleAddress": "0x…",
    "acceptedStateRoot": "0x…",
    "updatedAt": "2026-05-28T00:00:00Z"
  }
}

Ethereum can host the canonical issuer/authority attestation while Base hosts the low-cost app/oracle read surface for contracts, covenants, alerts, dashboards, and Mini Apps.

Minimum DAT completeness groups

identity, authority, authorized signer, treasury assets, cash, restricted cash status, custody status, encumbrance status, share count, claims, methodology, derived state, provenance.