Master Core (Beta) integration/staging tree

What is the Master Protocol

The Master Protocol is a communications protocol that uses the Bitcoin block chain to enable features such as smart contracts, user currencies and decentralized peer-to-peer exchanges. A common analogy that is used to describe the relation of the Master Protocol to Bitcoin is that of HTTP to TCP/IP: HTTP, like the Master Protocol, is the application layer to the more fundamental transport and internet layer of TCP/IP, like Bitcoin.

http://www.mastercoin.org

What is Master Core

Master Core is a fast, portable Master Protocol implementation that is based off the Bitcoin Core codebase (currently 0.9.3). This implementation requires no external dependencies extraneous to Bitcoin Core, and is native to the Bitcoin network just like other Bitcoin nodes. It currently supports a wallet mode and it will be seamlessly available on 3 platforms: Windows, Linux and Mac OS. Master Protocol extensions are exposed via a JSON-RPC interface. Development has been consolidated on the Master Core product, and once officially released it will become the reference client for the Master Protocol.

Disclaimer, warning

This software is EXPERIMENTAL software for TESTNET TRANSACTIONS only. USE ON MAINNET AT YOUR OWN RISK.

The protocol and transaction processing rules for Mastercoin are still under active development and are subject to change in future.

Master Core should be considered an alpha-level product, and you use it at your own risk. Neither the Mastercoin Foundation nor the Master Core developers assumes any responsibility for funds misplaced, mishandled, lost, or misallocated.

Further, please note that this particular installation of Master Core should be viewed as experimental. Your wallet data may be lost, deleted, or corrupted, with or without warning due to bugs or glitches. Please take caution.

This software is provided open-source at no cost. You are responsible for knowing the law in your country and determining if your use of this software contravenes any local laws.

You all know, BUT: DO NOT use wallet(s) with significant amount of any currency while working!

Testnet

1. To run Master Core in testnet mode, run Master Core with the following option in place: -testnet.
2. To receive MSC (and TMSC) on testnet please send TBTC to moneyqMan7uh8FqdCA2BV5yZ8qVrc9ikLP. For each 1 TBTC you will receive 100 MSC and 100 TMSC.

All functions in this mode will be TESTNET-ONLY (eg. send_MP).

Dependencies

Boost >= 1.53

Installation

NOTE: This will only build on Ubuntu Linux for now.

You will need appropriate libraries to run Master Core on Unix, please see doc/build-unix.md for the full listing.

You will need to install git & pkg-config:

sudo apt-get install git
sudo apt-get install pkg-config

Clone the Master Core repository:

 git clone https://github.com/mastercoin-MSC/mastercore.git
 cd mastercore/

Then, run Then, run:

./autogen.sh
./configure
make

Once complete:

cd src/

and start Master Core using ./mastercored. The inital parse step for a first time run will take approximately 10-15 minutes, during this time your client will scan the blockchain for Master Protocol transactions. You can view the output of the parsing at any time by viewing the log located in your datadir, by default: ~/.bitcoin/mastercore.log.

If a message is returned asking you to reindex, pass the -reindex flag to mastercored. The reindexing process can take serveral hours.

Note: to issue RPC commands to Master Core you may add the '-server=1' CLI flag or add an entry to the bitcoin.conf file (located in '~/.bitcoin/' by default).

In bitcoin.conf:

server=1

After this step completes, check that the installation went smoothly by issuing the following command ./mastercore-cli getinfo which should return the 'mastercoreversion' as well as some additional information related to the Bitcoin network.

The documentation for the RPC interface and command-line is located in [doc/apidocumentation.md] (doc/apidocumentation.md).

Current feature set:

• Broadcasting of simple send (tx0), and send to owners (tx3) [doc] (doc/apidocumentation.md#broadcasting-a-simple-send-transaction)

• Obtaining a Master Protocol balance [doc] (doc/apidocumentation.md#obtaining-a-master-protocol-balance)

• Obtaining all balances (including smart property) for an address [doc] (doc/apidocumentation.md#obtaining-all-master-protocol-balances-for-an-address)

• Obtaining all balances associated with a specific smart property [doc] (doc/apidocumentation.md#obtaining-all-master-protocol-balances-for-a-property-id)

• Retrieving information about any Master Protocol transaction [doc] (doc/apidocumentation.md#retrieving-a-master-protocol-transaction)

• Listing historical transactions of addresses in the wallet [doc] (doc/apidocumentation.md#listing-historical-transactions)

• Retreiving detailed information about a smart property [doc] (doc/apidocumentation.md#retrieving-information-about-a-master-protocol-property)

• Retreiving active and expired crowdsale information [doc] (doc/apidocumentation.md#retrieving-information-for-a-master-protocol-crowdsale)

• Sending a specific BTC amount to a receiver with referenceamount in send_MP

• Creating and broadcasting transactions based on raw Master Protocol data with sendrawtx_MP

Pending additions:

• Fully functional UI

• Meta-DEx support

• DEx support (making offer, making accept, making payment)

• Crowdsales (issuing smart properties, fundraisers, changing currency, closing fundraisers)

• gettransaction_MP output should include matched sell offer transaction reference

Support:

• Email mastercore@mastercoin.org or open a [GitHub issue] (https://github.com/mastercoin-MSC/mastercore/issues) to file a bug submission.