Steve Myers 1bbd85378a Merge bitcoindevkit/bdk-ffi#107: Add license files
f3c6d97d818788abf562d116745effca3c734c9b Add license files (Steve Myers)
d17ea4b90c015c9a6cf5d2cf2f77e901d93fd089 Bump version to 0.3.0 (Steve Myers)
76fa9b95219945c8b92186c860e83270d0e95842 Add CHANGELOG.md (Steve Myers)

Pull request description:

  This issue is based on https://github.com/bitcoindevkit/bdk/issues/301, to be clear we should add license files to all our repositories.

  If you're on the below list and agree with this change please add a comment with "I hereby license my previous contributions to BDK under [Apache 2.0](https://choosealicense.com/licenses/apache-2.0/) and [MIT](https://choosealicense.com/licenses/mit/) licenses."

  - [x] @artfuldev
  - [x] @notmandatory
  - [x] @afilini
  - [x] @thunderbiscuit

Top commit has no ACKs.

Tree-SHA512: 7e0f2c7bf93d1cdb28cec979330790e00c1efd3ce80986e9084bc371fa73eda6413014e3ad8e598ca6ce1f797622dbfbe8339453de8d7ebefbb27fd5204bc4c6
2022-02-28 09:19:41 -08:00
2021-10-16 14:45:32 +05:30
2022-02-08 22:15:10 +01:00
2022-02-27 21:18:05 -08:00
2022-02-27 21:17:37 -08:00
2022-02-27 21:26:23 -08:00
2022-02-27 21:26:23 -08:00
2022-02-27 21:26:23 -08:00
2021-12-21 22:16:27 -08:00

Native language bindings for BDK

This repository contains source code for generating native language bindings for the rust based bdk library which is the central artifact of the Bitcoin Dev Kit project.

Each supported language has it's own repository that includes this project as a git submodule. The rust code in this project is a wrapper around the bdk library to expose it's APIs in a uniform way using the mozilla/uniffi-rs bindings generator for each supported target language.

Supported target languages and platforms

The below repositories include instructions for using, building, and publishing the native language binding for bdk supported by this project.

Language Platform Repository
Kotlin jvm bdk-kotlin
Kotlin android bdk-kotlin
Swift iOS, macOS bdk-swift
Python linux, macOS bdk-python

Contributing

Install uniffi-bindgen cli tool

Install the uniffi-bindgen binary on your system using:

cargo install uniffi_bindgen

The version must be the same as the uniffi dependency in Cargo.toml.

Adding new structs and functions

See the UniFFI User Guide

For pass by value objects

  1. create new rust struct with only fields that are supported UniFFI types
  2. update mapping bdk.udl file with new dictionary

For pass by reference values

  1. create wrapper rust struct/impl with only fields that are Sync + Send
  2. update mapping bdk.udl file with new interface

Goals

  1. Language bindings should feel idiomatic in target languages/platforms
  2. Adding new targets should be easy
  3. Getting up and running should be easy
  4. Contributing should be easy
  5. Get it right, then automate

Thanks

This project is made possible thanks to the wonderful work by the mozilla/uniffi-rs team.

Description
Frost experimentation on bdk-ffi
Readme 22 MiB
Languages
Rust 64.6%
Kotlin 18.1%
Swift 9.5%
Python 4.6%
Shell 2.2%
Other 1%