dYdX Chain

The dYdX v4 software (the ”dYdX Chain”) is a sovereign blockchain software built using Cosmos SDK and CometBFT. It powers a robust decentralized perpetual futures exchange with a high-performance orderbook and matching engine for a feature-rich, self-custodial perpetual trading experience on any market.

This repository contains the source code for the Cosmos SDK application responsible for running the chain and the associated indexer services. The indexer services are a read-only layer that indexes on-chain and off-chain data from a node and serves it to users in a more performant and user-friendly way.

Getting Started

Architecture Overview

Indexer Deep Dive

Front End Deep Dive

Resources and Documentation

Official Documentation

dYdX Academy

dYdX Blog

Clients

v4-clients

Third-party Clients

C++ Client

Python Client

By clicking the above links to third-party clients, you will leave the dYdX Trading Inc. (“dYdX”) GitHub repository and join repositories made available by third parties, which are independent from and unaffiliated with dYdX. dYdX is not responsible for any action taken or content on third-party repositories.

Directory Structure

audits — Audit reports live here.

docs — Home for documentation pertaining to the entire repo.

indexer — Contains source code for indexer services. See its README for developer documentation.

proto — Contains all protocol buffers used by protocol and indexer.

protocol — Contains source code for the Cosmos SDK app that runs the protocol. See its README for developer documentation.

v4-proto-js — Scripts for publishing proto package to npm.

v4-proto-py — Scripts for publishing proto package to PyPI.

Contributing

If you encounter a bug, please file an issue to let us know. Alternatively, please feel free to contribute a bug fix directly. If you are planning to contribute changes that involve significant design choices, please open an issue for discussion instead.

License and Terms

The dYdX Chain is licensed under AGPLv3 and subject to the v4 Terms of Use. The full license can be found here. dYdX does not deploy or run v4 software for public use, or operate or control any dYdX Chain infrastructure. dYdX products and services are not available to persons or entities who reside in, are located in, are incorporated in, or have registered offices in the United States or Canada, or Restricted Persons (as defined in the dYdX Terms of Use).