Ponder

[![CI status][ci-badge]][ci-url]
[![Version][version-badge]][version-url]
[![Telegram chat][tg-badge]][tg-url]
[![License][license-badge]][license-url]

Ponder is an open-source framework for blockchain application backends.

Documentation

Visit ponder.sh for documentation, guides, and the API reference.

Support

Join Ponder's telegram chat for support, feedback, and general chatter.

Features

✅  Local development server with hot reloading

✅  create-ponder CLI tool to get started from an Etherscan link or Graph Protocol subgraph

✅  End-to-end type safety using viem and ABIType

✅  Autogenerated GraphQL API

✅  Easy to deploy anywhere using Node.js/Docker

✅  Supports all Ethereum-based blockchains, including test nodes like Anvil

✅  Index events from multiple chains in the same app

✅  Reconciles chain reorganization

✅  Factory contracts

✅  Process transactions calls (in addition to logs)

🏗️  Run effects (e.g. send an API request) in indexing code

Quickstart

$3

You will be asked for a project name, and if you are using a template (recommended). Then, the CLI will create a project directory, install dependencies, and initialize a git repository.

``bash
npm init ponder@latest


or

pnpm create ponder

or

yarn create ponder
`

$3

Just like Next.js and Vite, Ponder has a development server that automatically reloads when you save changes in any project file. It also prints console.log statements and errors encountered while running your code. First, cd into your project directory, then start the server.

`bash
npm run dev


or

pnpm dev

or

yarn dev
`

$3

Ponder fetches event logs for the contracts added to ponder.config.ts, and passes those events to the indexing functions you write.

`ts
// ponder.config.ts

import { createConfig } from "ponder";
import { BaseRegistrarAbi } from "./abis/BaseRegistrar";

export default createConfig({
chains: {
mainnet: {
id: 1,
rpc: "https://eth-mainnet.g.alchemy.com/v2/...",
},
},
contracts: {
BaseRegistrar: {
abi: BaseRegistrarAbi,
chain: "mainnet",
address: "0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85",
startBlock: 9380410,
},
},
});
`

$3

The ponder.schema.ts file contains the database schema, and defines the shape data that the GraphQL API serves.

`ts
// ponder.schema.ts

import { onchainTable } from "ponder";

export const ensName = onchainTable("ens_name", (t) => ({
name: p.text().primaryKey(),
owner: p.text().notNull(),
registeredAt: p.integer().notNull(),
}));
`

$3

Files in the src/ directory contain indexing functions, which are TypeScript functions that process a contract event. The purpose of these functions is to insert data into the entity store.

`ts
// src/BaseRegistrar.ts

import { ponder } from "ponder:registry";
import schema from "ponder:schema";

ponder.on("BaseRegistrar:NameRegistered", async ({ event, context }) => {
const { name, owner } = event.params;

await context.db.insert(schema.ensName).values({
name: name,
owner: owner,
registeredAt: event.block.timestamp,
});
});
`

See the create & update records docs for a detailed guide on writing indexing functions.

$3

Ponder automatically generates a frontend-ready GraphQL API based on your ponder.schema.ts file. The API serves data that you inserted in your indexing functions.

`ts
{
ensNames(limit: 2) {
items {
name
owner
registeredAt
}
}
}
`

`json
{
"ensNames": {
"items": [
{
"name": "vitalik.eth",
"owner": "0x0904Dac3347eA47d208F3Fd67402D039a3b99859",
"registeredAt": 1580345271
},
{
"name": "joe.eth",
"owner": "0x6109DD117AA5486605FC85e040ab00163a75c662",
"registeredAt": 1580754710
}
]
}
}
`

That's it! Visit ponder.sh for documentation, guides for deploying to production, and the API reference.

Contributing

If you're interested in contributing to Ponder, please read the contribution guide.

Packages

- ponder
- @ponder/client
- @ponder/react
- @ponder/utils
- create-ponder
- eslint-config-ponder`

About

Ponder is MIT-licensed open-source software.

[ci-badge]: https://github.com/ponder-sh/ponder/actions/workflows/main.yml/badge.svg
[ci-url]: https://github.com/ponder-sh/ponder/actions/workflows/main.yml
[tg-badge]: https://img.shields.io/endpoint?color=neon&logo=telegram&label=chat&url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Fpondersh
[tg-url]: https://t.me/pondersh
[license-badge]: https://img.shields.io/npm/l/ponder?label=License
[license-url]: https://github.com/ponder-sh/ponder/blob/main/LICENSE
[version-badge]: https://img.shields.io/npm/v/ponder
[version-url]: https://github.com/ponder-sh/ponder/releases