Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Awesome Bitcoin toolkit for ObjC and Swift
C Objective-C C++ Swift Other
Failed to load latest commit information.
CoreBitcoin.xcodeproj Added BTCDataTests.swift
CoreBitcoin added test for checksig ops
CoreBitcoinIOS copyrights update
CoreBitcoinIOSlib iOS framework and static library, changed build directory
CoreBitcoinOSX copyrights update
CoreBitcoinOSXlib static library for OSX
CoreBitcoinTestsOSX Added BTCDataTests.swift
UnitTests BTCCurrencyConverter average calculation fix and unit testing
openssl/include/openssl removed old binaries and generated files
.gitignore Ignore openssl.bak
CoreBitcoin.podspec 0.6.7
GLOSSARY.md link to new location of the glossary
INSTALLATION.txt frameworks with the same name
LICENSE.txt updated license info in a minor way
MEME_GLOSSARY.md more memes
README.md link to arcbit homepage rather then app store
ReleaseNotes.md various links and references to new features
ScriptStringRepresentation.md wip on script parsing
build_libraries.sh header processing in frameworks
openssl-1.0.1e.tar.gz fixes to openssl bundling
postprocess_openssl_includes_in_framework.rb header processing in frameworks
update_headers.rb added BTC256 for holding hashes in fixed-length buffers
update_openssl.sh Use xcode command line tools to get developer path and SKD versions

README.md

CoreBitcoin

CoreBitcoin implements Bitcoin protocol in Objective-C and provides many additional APIs to make great apps.

CoreBitcoin deliberately implements as much as possible directly in Objective-C with limited dependency on OpenSSL. This gives everyone an opportunity to learn Bitcoin on a clean codebase and enables all Mac and iOS developers to extend and improve Bitcoin protocol.

Note that "Bitcoin Core" (previously known as BitcoinQT or "Satoshi client") is a completely different project.

Projects using CoreBitcoin

Features

See also Release Notes.

Currency Tools

  • Bitcoin currency formatter with support for BTC, mBTC, bits (BTCNumberFormatter).
  • Currency converter (not linked to any exchange) with support for various methods to calculate exchange rate (BTCCurrencyConverter).
  • Various price sources and abstract interface for adding new ones (BTCPriceSource with support for Winkdex, Coindesk, Coinbase, Paymium).

Advanced Features

  • Deterministic RFC6979-compliant ECDSA signatures.
  • Script evaluation machine to actually validate individual transactions (BTCScriptMachine).
  • Blind signatures implementation (BTCBlindSignature).
  • Math on elliptic curves: big numbers, curve points, conversion between keys, numbers and points (BTCBigNumber, BTCCurvePoint).
  • Various cryptographic primitives like hash functions and AES encryption (see BTCData.h).

On the roadmap

See all todo items.

  • Complete support for blocks and block headers.
  • SPV mode and P2P communication with other nodes.
  • Full blockchain verification procedure and storage.
  • Importing BitcoinQT, Electrum and Blockchain.info wallets.
  • Support for libsecp256k1 in addition to OpenSSL.
  • Eventual support for libconsensus as it gets more mature and feature-complete.

The goal is to implement everything useful related to Bitcoin and organize it nicely in a single powerful library. Pull requests are welcome.

Starting points

To encode/decode addresses see BTCAddress.

To perform cryptographic operations, use BTCKey, BTCBigNumber and BTCCurvePoint. BTCKeychain implements BIP32 (hierarchical deterministic wallet).

To fetch unspent coins and broadcast transactions use one of the 3rd party APIs: BTCBlockchainInfo (blockchain.info) or Chain-iOS (recommended).

For full wallet workflow see BTCTransaction+Tests.m (fetch unspent outputs, compose a transaction, sign inputs, verify and broadcast).

For multisignature scripts usage see BTCScript+Tests.m: compose and unlock multisig output.

All other files with +Tests in their name are worth checking out as they contain useful sample code.

Using CoreBitcoin CocoaPod (recommended)

Add this to your Podfile:

pod 'CoreBitcoin', :podspec => 'https://raw.github.com/oleganza/CoreBitcoin/master/CoreBitcoin.podspec'

Run in Terminal:

$ pod install

Include headers:

#import <CoreBitcoin/CoreBitcoin.h>

If you'd like to use categories, include different header:

#import <CoreBitcoin/CoreBitcoin+Categories.h>

Using CoreBitcoin.framework

Clone this repository and build all libraries:

$ ./update_openssl.sh
$ ./build_libraries.sh

Copy iOS or OS X framework located in binaries/iOS or binaries/OSX to your project.

Include headers:

#import <CoreBitcoin/CoreBitcoin.h>

There are also raw universal libraries (.a) with headers located in binaries/include, if you happen to need them for some reason. Frameworks and binary libraries have OpenSSL built-in. If you have different version of OpenSSL in your project, consider using CocoaPods or raw sources of CoreBitcoin.

Swift

We love Swift and design the code to be compatible with Swift. That means using modern enums, favoring initializers over factory methods, avoiding obscure C features etc. You are welcome to try using CoreBitcoin from Swift, please file bugs if you have problems.

Swift is awesome to write crypto in it (due to explicit optionals, generics and first-class structs) and we would love to rewrite the entire CoreBitcoin and even relevant portions of OpenSSL in it. Unfortunately, for a year or two it's just out of the question due to instability. And then, using Swift-only features on the API level would mean that Objective-C code wouldn't be able to use CoreBitcoin. Given that, in the medium term we will focus solely on Objective-C implementation compatible with Swift. When everyone jumps exclusively on Swift, we'll make a complete rewrite.

Contribute

Feel free to open issues, drop us pull requests or contact us to discuss how to do things.

Follow existing code style and use 4 spaces instead of tabs. Methods have opening braces on a new line. There's no line width limit.

Email: oleganza@gmail.com

Twitter: @oleganza

To publish on CocoaPods:

$ pod trunk push --verbose --use-libraries

Donate

Please send your donations here: 1CBtcGivXmHQ8ZqdPgeMfcpQNJrqTrSAcG.

All funds will be used only for bounties.

You can also donate to a specific bounty. The amount will be reserved for that bounty and listed above. Contact Oleg to arrange that.

License

Released under WTFPL (except for OpenSSL). Have a nice day.

Something went wrong with that request. Please try again.