Blockchain event indexer for the THJ ecosystem. Single source of truth for CubQuests, Score API, Set&Forgetti, ApiologyDAO governance, and Mibera substrate.
Built on HyperIndex V3. Indexes 6 chains: Ethereum, Optimism, Arbitrum, Base, Berachain (primary), and Zora.
Adding a contract source? Read SCALE.md first. Skipping the source-addition checklist has cost the project multi-hour reindex windows that blocked downstream consumers (apdao governance, score-mibera, mibera-codex, dimensions). The PR template will prompt you for the relevant fields.
| Endpoint | ID | Status |
|---|---|---|
https://indexer.hyperindex.xyz/b5da47c/v1/graphql |
b5da47c |
Authoritative production (until Decision Log D1) |
https://indexer.hyperindex.xyz/914708e/v1/graphql |
914708e |
Parallel mirror, identical state |
TUI_OFF=true pnpm devVisit http://localhost:8080 to see the GraphQL Playground.
LOCAL DEVELOPMENT ONLY: The default password is
testing. This is for local development only. Production endpoints require proper authentication.
pnpm codegen- Node.js v22+ — V3 requirement
- pnpm v8+
- Docker desktop
ENVIO_API_TOKENenv var — required by V3 HyperSync
| Document | Purpose |
|---|---|
| SCALE.md | Operator playbook — 5 guardrails + Decision Log. Read before any config.yaml change. |
| DEPLOYMENT_GUIDE.md | Deployment commands + reset semantics + verification queries |
| FAST_TESTING_GUIDE.md | Quick testing with block ranges |
CLAUDE.md |
AI assistant guide |
grimoires/loa/HANDLER_REGISTRY.md |
Contract → Handler mapping |
grimoires/loa/ENTITY_REFERENCE.md |
GraphQL entity reference |
grimoires/loa/SF_VAULT_SYSTEM.md |
Set & Forgetti vault docs |
grimoires/loa/freeside-sonar-perf-cycle.md |
Most recent optimization cycle design memo |