Mastercoin wallet

Mastercoin wallet implementation in Ruby using QT bindings.

Dependencies

  • Ruby 1.9.2 or higher

  • Rubygems

  • QT 4

Check your ruby version using ruby -v. If the version is lower then 1.9.2 or not installed yet, install rvm and ruby 1.9.3.

Dependencies will differ based on your operating system.

OS X

Install homebrew if you haven’t got it yet.

  • brew install qt cmake

Debian/Ubuntu

These instructions might not be complete. Additional instructions welcome.

  • apt-get install libqt4-gui libqt4-dev cmake ruby-dev libssl-dev

Windows

These instructions might also not be complete.

This last step should hopefully not be needed anymore but for now we need a custom patched bitcoin-ruby for Windows

Installation

Once the depencies are installed you can just do gem install mastercoin-wallet to install the wallet. Start it by issuing mastercoin-wallet from a terminal.

First run configuration

The first time you run the wallet it will ask you for a password and your Mastercoin private key. If you use Bitcoin-qt as your main wallet you can find the private key by going to help->debug window->console. In this window you type dumpprivkey followed by your Mastercoin address to retrieve the private key.

Please note that your private key should remain private. If somebody somehow aquires this key then can spend your Bitcoin and Mastercoin please be diligent when transferring your private key.

Privacy

This client uses Mastercoin-explorer.com to lookup your balance and transaction information and to broadcast new transactions. It does not relay any private information like your private key that information is kept encrypted inside your mastercoin-wallet config file and is never transmitted to a third-party.

Alpha warning

This is the initial version of this client, please only use if it you know and accept the risks that come with using w.i.p. applications.

Contributing to mastercoin-wallet

  • Check out the latest master to make sure the feature hasn’t been implemented or the bug hasn’t been fixed yet.

  • Check out the issue tracker to make sure someone already hasn’t requested it and/or contributed it.

  • Fork the project.

  • Start a feature/bugfix branch.

  • Commit and push until you are happy with your contribution.

  • Make sure to add tests for it. This is important so I don’t break it in a future version unintentionally.

  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright © 2013 Maran. See LICENSE.txt for further details.