gurnec / BitcoinArmory

Python-Based Bitcoin Software

##Armory

Created by Alan Reiner on 13 July, 2011

Armory is a full-featured Bitcoin client, offering a dozen innovative features not found in any other client software! Manage multiple wallets (deterministic and watching-only), print paper backups that work forever, import or sweep private keys, and keep your savings in a computer that never touches the internet, while still being able to manage incoming payments, and create outgoing payments with the help of a USB key.

Multi-signature transactions are accommodated under-the-hood about 80%, and will be completed and integrated into the UI soon.

Armory has no independent networking components built in. Instead, it relies on on the Satoshi client to securely connect to peers, validate blockchain data, and broadcast transactions for us. Although it was initially planned to cut the umbilical cord to the Satoshi client and implement independent networking, it has turned out to be an inconvenience worth having. Reimplementing all the networking code would be fraught with bugs, security holes, and possible blockchain forking. The reliance on Bitcoin-Qt right now is actually making Armory more secure!

##Donations

Please take a moment to donate! 1ArmoryXcfq7TnCSuZa9fQjRYwJ4bkRKfv

##Building Armory From Source

See instructions here

##Dependencies

• GNU Compiler Collection
  Linux: Install package g++

• Crypto++
  Linux: Install package libcrypto++-dev
  Windows: Download

• SWIG
  Linux: Install package swig
  Windows: Download
  MSVS: Copy swigwin-2.x directory next to cryptopp as swigwin

• Python 2.6/2.7
  Linux: Install package python-dev
  Windows: Download

• Python Twisted -- asynchronous networking
  Linux: Install package python-twisted
  Windows: Download

• PyQt 4 (for Python 2.X)
  Linux: Install packages libqtcore4, libqt4-dev, python-qt4, and pyqt4-dev-tools
  Windows: Download

• qt4reactor.py -- combined eventloop for PyQt and Twisted
  All OS: Download

• pywin32
  Windows Only: qt4reactor relies on pywin32 (for win32event module). Download

• py2exe
  (OPTIONAL - if you want to make a standalone executable in Windows)
  Windows: Download

##Sample Code

Armory contains over 25,000 lines of code, between the C++ and python libraries. This can be very confusing for someone unfamiliar with the code (you). Below I have attempted to illustrate the CONOPS (concept of operations) that the library was designed for, so you know how to use it in your own development activities. There is a TON of sample code in the following:

• C++ - BlockUtilsTest.cpp
• Python - Unit Tests, sample_armory_code.py

##License

Distributed under the GNU Affero General Public License (AGPL v3)
See LICENSE file or here

##Copyright

Copyright (C) 2011-2015, Armory Technologies, Inc.