Skip to content
Masteroin wallet in Ruby using QT
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Please note: This wallet is depcrecated, it won't work any longer.

Mastercoin wallet

Mastercoin wallet implementation in Ruby using QT bindings.


  • 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 version >= 1.9.2.

Dependencies will differ based on your operating system.


Install homebrew if you haven't got it yet.

  • brew install qt cmake


Manual packages you might need

These instructions might not be complete. Additional instructions welcome.

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


  • yum install gcc-c++ qt-devel cmake ruby-devel rubygems

Please note that the default GTK theme (Adwaita) on Fedora 20 is not compatible with the ruby-qt combination used by this wallet. While the wallet will still function, some graphical elements may not be visible. To fix this, you can change the GTK theme using the Gnome Tweak Tool:

yum install gnome-tweak-tool

Running gnome-tweak-tool does not work from the command line, so use ALT+F2 then type the command OR navigate to the icon from Activities->Show Applications->Utilities->Tweak Tool From there you can change the GTK+ theme. The "HighContrast" theme is known to work with the wallet as well as the "Greybird" theme. You may find the Greybird theme more pleasant. If you don't see the Greybird theme as an option, you can install it:

yum install greybird-gtk2-theme greybird-gtk3-theme


Please note that this wallet is not meant to be run on Windows. Please check out the MyMastercoin wallet.

If you want to go crazy then here are some pointers:

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


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.


This client uses 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 (c) 2013 Maran. See LICENSE.txt for further details.

You can’t perform that action at this time.