How ponder-sh/ponder works
Ponder is a TypeScript framework for indexing EVM data. A developer creates or configures an application, starts the runtime, and selects contracts, chains, and event filters. Historical and realtime synchronizers fetch blockchain data through RPC, dispatch matching events to user indexing callbacks, and persist results through the database layer. HTTP consumers query generated GraphQL or SQL APIs, with client and React packages providing application-facing access. The graph preserves documented multichain, Postgres, development-server, and project-generation capabilities; several internal connections use directory-level evidence because their implementations were not sampled.
Main entry points: database/index.ts Database layer · runtime/index.ts Indexing runtime · server/index.ts HTTP server · client.ts Indexing RPC client
Components 25
Project setup
- Project generator
packages/create-ponder/src/index.ts - Project template
packages/create-ponder/templates/empty - Ponder CLI
packages/core/src/bin/ponder.ts - Chain configuration
packages/core/src/config/index.ts
Indexing pipeline
- Indexing runtime
packages/core/src/runtime/index.ts - Multichain runtime
packages/core/src/runtime/multichain.ts - Historical sync
packages/core/src/sync-historical/index.ts - Realtime sync
packages/core/src/sync-realtime/index.ts - Event filters
packages/core/src/runtime/fragments.ts - Indexing RPC client
packages/core/src/indexing/client.ts - Index callbacks
packages/core/src/runtime/events.ts
Storage and schema
- Onchain schema
packages/core/src/drizzle/index.ts - Indexing store
packages/core/src/indexing-store/index.ts - Database layer
packages/core/src/database/index.ts - SQL query builder
packages/core/src/database/queryBuilder.ts
Query interfaces
- GraphQL API
packages/core/src/graphql/index.ts - HTTP server
packages/core/src/server/index.ts - Typed client
packages/client/src/index.ts - React bindings
packages/react/src/context.ts
Runtime operations
- Development UI
packages/core/src/ui/index.ts - Runtime metrics
packages/core/src/internal/metrics.ts
Other components
- Developer
- API consumer
- EVM RPC
- Postgres
Connections 26
- Developer → Project generator: creates project
- Project generator → Project template: uses template
- Developer → Ponder CLI: starts runtime
- Chain configuration → Event filters: defines filters
- Ponder CLI → Indexing runtime: starts indexing
- Indexing runtime → Multichain runtime: coordinates chains
- Multichain runtime → Historical sync: runs backfill
- Multichain runtime → Realtime sync: runs realtime
- Historical sync → Indexing RPC client: fetches history
- Realtime sync → Indexing RPC client: fetches blocks
- Event filters → Indexing RPC client: narrows requests
- Indexing RPC client → EVM RPC: requests chain data
- Indexing runtime → Index callbacks: dispatches events
- Index callbacks → Database layer: writes indexed data
- Onchain schema → Database layer: defines tables
- Indexing store → Database layer: stages index state
- Database layer → Postgres: persists data
- HTTP server → GraphQL API: routes GraphQL
- HTTP server → SQL query builder: routes SQL
- GraphQL API → Database layer: reads indexed data
- SQL query builder → Database layer: executes queries
- API consumer → HTTP server: sends queries
- Typed client → HTTP server: requests data
- React bindings → Typed client: provides client
- Indexing runtime → Runtime metrics: reports progress
- Development UI → Runtime metrics: reads progress