The master
branch of this repository is being migrated to the bdk 1.0 API and is incomplete. For production-ready libraries, use the 0.31.X
releases.
The workspace in this repository creates the libbdkffi
multi-language library for the Rust-based
bdk library from the Bitcoin Dev Kit project.
Each supported language and the platform(s) it's packaged for has its own directory. The Rust code in this project is in the bdk-ffi directory and is a wrapper around the bdk library to expose its APIs in a uniform way using the mozilla/uniffi-rs bindings generator for each supported target language.
The below directories (a separate repository in the case of bdk-swift) include instructions for using, building, and publishing the native language binding for bdk supported by this project.
Language | Platform | Published Package | Building Documentation | API Docs |
---|---|---|---|---|
Kotlin | JVM | bdk-jvm (Maven Central) | Readme bdk-jvm | Kotlin JVM API Docs |
Kotlin | Android | bdk-android (Maven Central) | Readme bdk-android | Android API Docs |
Swift | iOS, macOS | bdk-swift (GitHub) | Readme bdk-swift | |
Python | linux, macOS, Windows | bdk-python (PyPI) | Readme bdk-python |
If you are familiar with the build tools for the specific languages you wish to build the libraries for, you can use their normal build/test workflows. We also include some just files to simplify the work across different languages. If you have the just tool installed on your system, you can simply call the commands defined in the justfile
s, for example:
cd bdk-android
just build
just offlinetests
just publishlocal
This library should compile with any combination of features with Rust 1.73.0.
To add new structs and functions, see the UniFFI User Guide and the uniffi-examples repository.
- Language bindings should feel idiomatic in target languages/platforms
- Adding new targets should be easy
- Getting up and running should be easy
- Contributing should be easy
- Get it right, then automate
// build.gradle.kts
repositories {
mavenCentral()
}
dependencies {
implementation("org.bitcoindevkit:bdk-android:<version>")
}
// build.gradle.kts
repositories {
mavenCentral()
}
dependencies {
implementation("org.bitcoindevkit:bdk-jvm:<version>")
}
Note: We also publish snapshot versions of bdk-jvm and bdk-android. See the specific readmes for instructions on how to use those.
pip3 install bdkpython
Add bdk-swift to your dependencies in XCode.
If you are interested in better understanding the base structure we use here in order to build your own Rust-to-Kotlin/Swift/Python language bindings, check out the uniffi-bindings-template repository. We maintain it as an example and starting point for other projects that wish to leverage the tech stack used in producing the BDK language bindings.
Both libraries and all their corresponding artifacts are signed with a PGP key you can find in the root of this repository. To verify the signatures follow the below steps:
- Import the PGP key in your keyring.
# Navigate to the root of the repository and import the ./PGP-BDK-BINDINGS.asc public key
gpg --import ./PGP-BDK-BINDINGS.asc
# Alternatively, you can import the key directly from a public key server
gpg --keyserver keyserver.ubuntu.com --receive-key 2768C43E8803C6A3
# Verify that the correct key was imported
gpg --list-keys
# You should see the below output
pub ed25519 2022-08-31 [SC]
88AD93AC4589FD090FF3B8D12768C43E8803C6A3
uid [ unknown] bitcoindevkit-bindings <bindings@bitcoindevkit.org>
sub cv25519 2022-08-31 [E]
- Download the binary artifacts and corresponding signature files.
- from bdk-jvm
bdk-jvm-<version>.jar
bdk-jvm-<version>.jar.asc
- from bdk-android
bdk-android-<version>.aar
bdk-android-<version>.aar.asc
- Verify the signatures.
gpg --verify bdk-jvm-<version>.jar.asc
gpg --verify bdk-android-<version>.aar.asc
# you should see a "Good signature" result
gpg: Good signature from "bitcoindevkit-bindings <bindings@bitcoindevkit.org>" [unknown]
Full key ID: 88AD 93AC 4589 FD09 0FF3 B8D1 2768 C43E 8803 C6A3
Fingerprint: 2768C43E8803C6A3
Name: bitcoindevkit-bindings
Email: bindings@bitcoindevkit.org
This project is made possible thanks to the wonderful work by the mozilla/uniffi-rs team.