Documentation

DipDup is a Python framework for building smart contract indexers. It helps developers focus on business logic instead of writing a boilerplate to store and serve data.

Quickstart

Get your first indexer running in minutes. A Linux/macOS distribution with Python 3.11 installed is required to run DipDup. In this short guide we will create an indexer for a fungible token contract. Our goal is to save all token transfers to the database and then calculate some statistics of its holders' activity.

Featured

Indexes Multiple indexes are available for different workloads. Every index is linked to a specific datasource and provides a set of handlers for different kinds of data.

GraphQL API DipDup provides seamless integration with Hasura GraphQL Engine to expose your data to the client side. It's a powerful tool that allows you to build a GraphQL API on top of your database with minimal effort.

DipDup ORM To store indexed data in the database, you need to define models that represent database tables. Our storage layer is based on Tortoise ORM. We have extended it with some useful features like a copy-on-write rollback mechanism, caching, and more.

Running in Docker You can run DipDup in Docker containers. It's a convenient way to deploy your indexer to the cloud. This guide will show you how to do it with Compose and Swarm environments.

Built with DipDup Multiple major players including Rarible, Youves and Kord.fi are already using DipDup in production. Check out the full list and discover all the use cases.

Resources

Changelog The list of all notable changes in recent DipDup versions.