https://github.com/drift-labs/drift-ffi-sys
FFI bindings for Drift program
https://github.com/drift-labs/drift-ffi-sys
drift solana
Last synced: 22 days ago
JSON representation
FFI bindings for Drift program
- Host: GitHub
- URL: https://github.com/drift-labs/drift-ffi-sys
- Owner: drift-labs
- License: apache-2.0
- Created: 2024-09-20T10:17:16.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-04-30T02:40:33.000Z (22 days ago)
- Last Synced: 2025-04-30T03:57:40.765Z (22 days ago)
- Topics: drift, solana
- Language: Rust
- Homepage:
- Size: 668 KB
- Stars: 0
- Watchers: 6
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/drift-labs/drift-ffi-sys/releases), unzip and link/copy to `/usr/lib` (linux) or `/usr/local/lib` (mac)
### from Source
```shell
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](https://blog.rust-lang.org/2024/03/30/i128-layout-update.html))
- 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`/`i128`s which are handled by a custom `compat::u128/i128` type that forces correct alignment where required.