Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/dydxprotocol/v4-chain

dydx v4 protocol
https://github.com/dydxprotocol/v4-chain

Last synced: 4 months ago
JSON representation

dydx v4 protocol

Awesome Lists containing this project

README 

          



dYdX Chain





  

    License

  




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](https://dydx.exchange/blog/v4-technical-architecture-overview)



[Indexer Deep Dive](https://dydx.exchange/blog/v4-deep-dive-indexer)



[Front End Deep Dive](https://dydx.exchange/blog/v4-deep-dive-front-end)



# Resources and Documentation



[Official Documentation](https://docs.dydx.exchange/)



[dYdX Academy](https://dydx.exchange/crypto-learning#)



[dYdX Blog](https://dydx.exchange/blog#)



# Clients



[v4-clients](https://github.com/dydxprotocol/v4-clients)



# Third-party Clients



[C++ Client](https://github.com/asnefedovv/dydx-v4-client-cpp)



[Python Client](https://github.com/kaloureyes3/v4-clients/tree/main/v4-client-py)



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](https://github.com/dydxprotocol/v4-chain/blob/main/indexer/README.md) 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](https://github.com/dydxprotocol/v4-chain/blob/main/protocol/README.md) for developer documentation.



`v4-proto-js` — Scripts for publishing proto package to [npm](https://www.npmjs.com/package/@dydxprotocol/v4-proto).



`v4-proto-py` — Scripts for publishing proto package to [PyPI](https://pypi.org/project/v4-proto/).



# Contributing



If you encounter a bug, please file an [issue](https://github.com/dydxprotocol/v4-chain/issues) 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](https://dydx.exchange/v4-terms). The full license can be found [here](https://github.com/dydxprotocol/v4-chain/blob/main/LICENSE). 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](https://dydx.exchange/terms)).