Table of Contents

config

env

export

hasura

CLI reference

dipdup

: ____ _ ____
/ __ (_)____ / __ __ __ ____
/ / / // // __ / / / // / / // __
/ /_/ // // /_/ // /_/ // /_/ // /_/ /
/_____//_// .___//_____/ __,_// .___/: /_/ /_/

Usage

dipdup [OPTIONS] COMMAND [ARGS]...

Options

--version: Show the version and exit.

-c, --config <PATH>: A path to DipDup project config.

-e, --env-file <PATH>: A path to .env file containing KEY=value strings.

-C <NAME>: A shorthand for -c . -c configs/dipdup.<name>.yaml

Environment variables

DIPDUP_CONFIG: Provide a default for --config

DIPDUP_ENV_FILE: Provide a default for --env-file

Documentation: https://dipdup.io/docs GitHub: https://github.com/dipdup-io/dipdup Discord: https://discord.gg/aG8XKuwsQd

config

Commands to manage DipDup configuration.

Usage

dipdup config [OPTIONS] COMMAND [ARGS]...

env

Dump environment variables used in DipDup config.

If variable is not set, default value will be used.

Usage

dipdup config env [OPTIONS]

Options

-o, --output <output>: Output to file instead of stdout.

--unsafe: Use actual environment variables instead of default values.

-c, --compose: Output in docker-compose format.

-i, --internal: Include internal variables.

export

Print config after resolving all links and, optionally, templates.

WARNING: Avoid sharing output with 3rd-parties when –unsafe flag set - it may contain secrets!

Usage

dipdup config export [OPTIONS]

Options

--unsafe: Use actual environment variables instead of default values.

-f, --full: Resolve index templates.

-r, --raw: Do not initialize config; preserve file structure.

hasura

Commands related to Hasura integration.

Usage

dipdup hasura [OPTIONS] COMMAND [ARGS]...

configure

Configure Hasura GraphQL Engine to use with DipDup.

Usage

dipdup hasura configure [OPTIONS]

Options

-f, --force: Proceed even if Hasura is already configured.

init

Generate project tree, typeclasses and callback stubs.

This command is idempotent, meaning it won’t overwrite previously generated files unless asked explicitly.

Usage

dipdup init [OPTIONS] PATH

Options

-f, --force: Overwrite existing types and ABIs.

-b, --base: Include template base (default)

--no-base: Skip files from base template.

--no-linter: Skip applying linter and formatter.

--no-types: Skip generating ABIs and typeclasses.

Arguments

PATH: Optional argument(s)

mcp

Commands related to MCP integration.

Usage

dipdup mcp [OPTIONS] COMMAND [ARGS]...

run

Run MCP server.

Usage

dipdup mcp run [OPTIONS]

migrate

Migrate project to the new spec version.

If you’re getting MigrationRequiredError after updating DipDup, this command will fix imports and type annotations to match the current spec_version. Review and commit changes after running it.

Usage

dipdup migrate [OPTIONS]

Options

-n, --dry-run: Print changes without applying them.

new

Create a new project interactively.

Usage

dipdup new [OPTIONS]

Options

-q, --quiet: Use default values for all prompts.

-f, --force: Overwrite existing files.

-r, --replay <replay>: Use values from a replay file.

-t, --template <template>: Use a specific template.

-n, --name <name>: Project name.

package

Inspect and manage project package.

Usage

dipdup package [OPTIONS] COMMAND [ARGS]...

tree

Draw package tree.

Usage

dipdup package tree [OPTIONS]

verify

Verify project package.

Usage

dipdup package verify [OPTIONS]

report

Manage crash and performance reports.

Usage

dipdup report [OPTIONS] COMMAND [ARGS]...

ls

List reports.

Usage

dipdup report ls [OPTIONS]

rm

Remove report(s).

Usage

dipdup report rm [OPTIONS] [ID]

Options

-a, --all: Remove all reports.

Arguments

ID: Optional argument

show

Show report.

Usage

dipdup report show [OPTIONS] ID

Arguments

ID: Required argument

run

Run the indexer.

Execution can be gracefully interrupted with Ctrl+C or SIGINT signal.

Usage

dipdup run [OPTIONS]

schema

Commands to manage database schema.

Usage

dipdup schema [OPTIONS] COMMAND [ARGS]...

approve

Continue to use existing schema after reindexing was triggered.

Usage

dipdup schema approve [OPTIONS]

export

Print SQL schema including scripts from sql/on_reindex.

This command may help you debug inconsistency between project models and expected SQL schema.

Usage

dipdup schema export [OPTIONS]

init

Prepare database schema for running DipDup.

This command creates tables based on your models, then executes sql/on_reindex to finish preparation - the same things DipDup does when run on a clean database.

Usage