Bitcoin wallet C/C++ API for building cross-platform applications that require user authentication, encryption, backup, and meta-data management. This library alone implements the full functionality of the Airbitz Edge Security platform and bitcoin wallet minus the graphical interface.
Switch branches/tags
testnet_2015021810_ios testnet_2015021808_ios testnet_2015021807_ios testnet_2015021806_ios testnet_2015021805_android testnet_2015021804_android testnet_2015021803_android testnet_2015021802_android testnet_2015021801_android testnet_2015021624_android testnet_2015021620_android testnet_2015021618_android testnet_2015021616_android testnet_201502185_ios testnet_201502184_ios testnet_201502183_ios testnet_201502182_ios testnet_201502181_ios testnet_201502176_ios testnet_201502176_android testnet_201502175_ios testnet_201502175_android testnet_201502174_ios testnet_201502174_android testnet_201502173_ios testnet_201502173_android testnet_201502172_ios testnet_201502172_android testnet_201502171_android testnet_201502168_android testnet_201502166_android testnet_20150217.1_ios testnet_20150213.5_ios testnet_20150213.3_ios testnet_20150213.2_ios testnet_20150213.1_ios testnet_20150212.1_ios testnet_20150211.12_ios testnet_20150211.11_ios testnet_20150211.10_ios testnet_20150211.9_ios testnet_20150211.8_ios testnet_20150211.7_ios ios2.2.0-objc1.0.0 ios_v1.4.5 ios_v1.4.4 ios_v1.4.3 ios_v1.4.2 ios_v1.4.1 ios_v1.4.0 ios-2.3.0 ios-1.4.1 ios-1.4.0 ios-1.3.2 ios-1.3.1 ios-1.3.0 ios-1.2.0 develop_2015021904_ios develop_2015021903_ios develop_2015021902_ios develop_2015021902_android develop_2015021901_ios develop_2015021901_android develop_2015021811_ios develop_2015021810_ios develop_2015021809_ios develop_2015021808_ios develop_2015021807_ios develop_2015021806_ios develop_2015021806_android develop_2015021805_android develop_2015021804_android develop_2015021803_android develop_2015021802_android develop_2015021621_android develop_2015021619_android develop_2015021615_android develop_2015021614_android develop_201502185_ios develop_201502184_ios develop_201502183_ios develop_201502182_ios develop_201502181_ios develop_201502181_android develop_201502176_android develop_201502175_ios develop_201502175_android develop_201502174_ios develop_201502174_android develop_201502173_ios develop_201502173_android develop_201502172_ios develop_201502172_android develop_201502171_ios develop_201502171_android develop_201502167_ios develop_201502164_android develop_201502162_android develop_20150216.6_ios develop_20150216.5_ios
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

AirBitz Core Library

Airbitz Wallet Core

This library implements the core Bitcoin functionality for the AirBitz wallet. It manages accounts, syncing, and Bitcoin transactions.


The build process requires several pieces of software to be installed on the host system:

  • autoconf
  • automake
  • cmake
  • git
  • libtool
  • pkgconfig
  • protobuf
  • astyle

To install these on the Mac, please use Homebrew:

brew install autoconf automake cmake git libtool pkgconfig protobuf astyle

The 'wget' and 'cmake' that come from MacPorts are known to be broken. If you are building for iOS or Mac native, you also need a working installation of the XCode command-line tools.

For Linux native builds, you need the clang compiler. The following command will install the necessary dependencies on Ubuntu:

apt-get install autoconf automake cmake git libtool pkg-config protobuf-compiler clang astyle

Assuming your system has the necessary command-line tools installed, it should be possible to build ABC by doing something like:

cd deps

For faster build, compile with multiple cores

make  -j {{number_of_cores}}

This will build a core and cli that can run your current system. If you would like to cross-compile for another platform, following commands are available inside the deps directory:

make abc.ios-universal (only available on Mac)
make abc.osx-universal (only available on Mac)

The 'deps' system automatically downloads and builds the various open-source libraries that the AirBitz core depends on. If you want to bypass the deps system and run 'make' directly from the top-level directory, you will need to manually pre-install these libraries on your system. This approach makes the most sense for heavy day-to-day development, even if it requires more up-front setup work.

Directory structure

The entire library used to live in the "src" directory, but we are in the process of re-designing the library's API. The new (work-in-progress) library lives in the "abcd" directory, and the code in the "src" is just a shim that adapts the new library to the old API. Once the GUI's switch to the new API, the "src" directory will go away.

The "deps" directory contains a system for downloading and building all the libraries that ABC depends on, as well as ABC itself, for mobile platforms.

The "minilibs" directory contains small support libraries that don't have a standalone distribution.

The "cli" directory contains a command-line tool for exercising the core. We use this internally for debugging and testing.

The "test" directory contains unit tests.

The "util" directory contains ancillary utilities, such as a script for generating private keys from an exported wallet seed.


In order to check code style before checking in any commits, add the git hooks

cp util/git-hooks/pre-commit .git/hooks