zenith-docs/docs/documentation/watchers.md

Watchers

Watchers are specialized indexing services that monitor blockchain events and maintain queryable databases. The Zenith ecosystem uses three watchers to track different data sources, each exposing data through GraphQL APIs for application use.

---

Azimuth Watcher

Monitors Urbit's Azimuth identity registry on Ethereum, tracking point ownership, sponsorship relationships, and identity state changes.

Data Sources: Ethereum mainnet Azimuth contracts

Example Query:

query {
  point(id: "~sampel-palnet") {
    owner
    sponsor
    keyRevisionNumber
  }
}

---

Lockdrop Watcher

Monitors the Zenith lockdrop contract on Ethereum, tracking participant deposits and lock commitments during Stage 0.

Data Sources: Ethereum lockdrop contract

Example Query:

query {
  deposit(address: "0x...") {
    points
    lockDuration
    timestamp
  }
}

---

Zenith Watcher

Indexes the Zenith blockchain itself, tracking transactions, account states, and module events.

Data Sources: Zenith blockchain (all stages)

Example Query:

query {
  account(address: "zenith1...") {
    balances {
      denom
      amount
    }
    transactions {
      hash
      timestamp
    }
  }
}