Adding `drift_rs` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add drift-rs

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

drift-rs = "1.0.0-alpha.11"

The drift_rs library will be automatically available globally.

Back to the crate overview.

Readme

drift-rs

Experimental, high performance Rust SDK for building offchain clients for Drift V2 protocol.

Install

# crates.io
drift-rs = "1.0.0-alpha.10"

# build from source
drift-rs = { git = "https://github.com/drift-labs/drift-rs", tag = "v1.0.0-alpha.10" }

Use

use drift_rs::{DriftClient, Wallet};
use solana_sdk::signature::KeyPair;

async fn main() {
    let client = DriftClient::new(
        Context::MainNet,
        RpcClient::new("https://rpc-provider.com"),
        KeyPair::new().into(),
    )
    .await
    .expect("connects");

    /// Subscribe to Ws-based live prices, blockhashes, and oracle updates
    let markets = [MarketId::spot(1), MarketId::perp(0)];
    client.subscribe_markets(&markets).await.unwrap();
}

Setup

Mac (m-series)

Install rosetta and configure Rust toolchain for x86_64

softwareupdate --install-rosetta
# replace `1.84.0` with preferred stable version
rustup install 1.84.0-x86_64-apple-darwin
rustup override set 1.84.0-x86_64-apple-darwin

⚠️ the default toolchain is incompatible due to memory layout differences between solana program (BPF) and aarch64 and will fail at runtime with deserialization errors like: InvalidSize.

Local Development

drift-rs links to the drift program crate via FFI, build from source (default) or dynamically link with a version from drift-ffi-sys

# Build from source (default)
CARGO_DRIFT_FFI_STATIC=1
# Provide a prebuilt drift_ffi_sys lib 
CARGO_DRIFT_FFI_PATH="/path/to/libdrift_ffi_sys"

Development

Release

git tag v<MAJOR.MINOR.PATCH> && git push

Updating IDL types

copy the updated IDL to res/drift.json from protocol-v2 branch
cargo check
commit changes

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.

Adding drift_rs library as a dependency

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Adding `drift_rs` library as a dependency