Rust client for dYdX v4

The crate implements interaction with the dYdX API.

The following features are implemented:

• NodeClient, IndexerClient + WebSockets, FaucetClient, NobleClient
• Fully asynchronous implementation
• Telemetry
• Convenient builder for constructing requests
• Automatic WS connection support

Install

To add the crate to your project, use the command:

cargo add dydx

Development

Workspace consists of a single crate:

• client - to provide connection management with dYdX, common types and utils

Prerequisites

• Rust
• cargo deny
• protoc for dev dependencies (metrics-exporter-tcp)

Examples

To run the example, you need to use the cargo command as follows:

cargo run --example bot_basic_adder

You can find the full set of examples in the examples folder.

Code quality assurance

Before publishing make sure to run (and fix all warnings and errors)

cargo fmt
cargo clippy
cargo deny check licenses advisories sources

Documentation

To generate the documentation, use the command

cargo doc -p dydx

Features

• strict-serde: Enables strict Serde deserialization by denying unknown fields in API response types. This is automatically enabled during tests via cfg_attr.

To run tests with the feature explicitly:

cargo test --features strict-serde

Acknowledgements

Built by Nethermind: @v0-e, @therustmonk, @maksimryndin

For more details about the grant see link.