CBitcoin

C bindings for libbitcoin. Intended primarily as support for the Bitcoin framework, which depends on this one and provides Swift bindings for libbitcoin.

Blog Post

On January 25, 2019 I published an announcement for this framework on my blog here.

Requirements

• Swift 5.1

• Xcode 11.3

• This distribution includes pre-built fat frameworks for libbitcoin and its dependencies: libboost, and libsecp256k1. In order to check out this large pre-built file, you need to install the latest version of Git and the Git Large File Storage handler:

$ brew install git
$ brew install git-lfs
$ which git
/usr/local/bin/git
$ git --version
git version 2.21.0

Installation

CBitcoin no longer supports building via Cocoapods, but since it also relies on embedding several third-party pre-built binary frameworks (libbitcoin etc.) it is also not suitable for distribution via the Swift Package Manager at this time. So for now, it is built directly as an Xcode project.

In the shell:

$ git clone https://github.com/BlockchainCommons/iOS-CBitcoin.git CBitcoin
$ cd CBitcoin/Sources
$ unzip -q Frameworks.zip
$ cd ..
$ open CBitcoin.xcodeproj/

Within Xcode:

• Build the CBitcoin target for an available platform.

Unit Tests

CBitcoin does not have built-in unit tests, but the Bitcoin Swift framework builds on CBitcoin and contains unit tests for all CBitcoin functionality.

Building the frameworks yourself

If you wish, you can run the included build_frameworks.sh script to build the frameworks for libbitcoin, libboost, and libsecp256k1 from scratch. This will take significant time.

Author

Wolf McNally, wolf@wolfmcnally.com

License

CBitcoin is available under the Apache 2 license. See the LICENSE file for more info.