/drift-ffi-sys

FFI bindings for Drift program

Primary LanguageRustApache License 2.0Apache-2.0

drift-ffi

Exposes C-ABI bindings for drift program.

Goals:

  1. Enable building SDKs that reuse program logic.
  2. Separate rust SDK from program/solana runtime dependencies. Allows rust SDK to freely update to latest solana-* crates with bug fixes, improvements, etc.

Installation

Prebuilt

Download latest release libs, unzip and link/copy to /usr/lib (linux) or /usr/local/lib (mac)

from Source

rustup install 1.76.0-x86_64-apple-darwin # M1 mac
rustup install 1.76.0-x86_64-unknown-linux-gnu # linux

cargo build --release
ln -sf ./target/release/libdrift_ffi_sys.dylib /usr/local/lib # mac
ln -sf ./target/release/libdrift_ffi_sys.so /usr/lib #linux

Developer Notes

  • this crate must be built with rust <= 1.76.0 to provide compatibility with onchain data layouts (later rust versions have breaking changes 128-bit integer C-abi compatibility)

  • for rust users this crate is intended to be linked via compiler flags (not Cargo dependency) as it compiles to a (platform dependent) dynamic lib (.so/.dylib/.dll)

  • can ignore most of the warnings for FFI safety. The main issue are types containing u128/i128s which are handled by a custom compat::u128/i128 type that forces correct alignment where required.