* https://github.com/OmniLayer/omniwallet

* https://github.com/OmniLayer/spec

* Please open a [GitHub issue] (https://github.com/OmniLayer/omnicore/issues) to file a bug submission.

Omni Core related documentation is available in: [src/omnicore/doc](../src/omnicore/doc)

Copyright (c) 2013-2015 Omni Core Developers

Copyright (c) 2009-2015 Bitcoin Core Developers

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is

furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in

all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN

THE SOFTWARE.

Omni Core (beta) integration/staging tree

[](https://travis-ci.org/OmniLayer/omnicore)

What is the Omni Layer

The Omni Layer 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 Omni Layer to Bitcoin is that of HTTP to TCP/IP: HTTP, like the Omni Layer, is the application layer to the more fundamental transport and internet layer of TCP/IP, like Bitcoin.

What is Omni Core

Omni Core is a fast, portable Omni Layer implementation that is based off the Bitcoin Core codebase (currently 0.10.2). 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 is seamlessly available on three platforms: Windows, Linux and Mac OS. Omni Layer extensions are exposed via the UI and the JSON-RPC interface. Development has been consolidated on the Omni Core product, and it is the reference client for the Omni Layer.

Disclaimer, warning

This software is EXPERIMENTAL software. USE ON MAINNET AT YOUR OWN RISK.

By default this software will use your existing Bitcoin wallet, including spending bitcoins contained therein (for example for transaction fees or trading).

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

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

Further, please note that this installation of Omni Core should be viewed as EXPERIMENTAL. Your wallet data, bitcoins and Omni Layer tokens 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.

PLEASE DO NOT use wallet(s) with significant amounts of bitcoins or Omni Layer tokens while testing!

Related projects

* https://github.com/OmniLayer/OmniJ

* https://github.com/OmniLayer/omniwallet

* https://github.com/OmniLayer/spec

Support

* Please open a [GitHub issue](https://github.com/OmniLayer/omnicore/issues) to file a bug submission.

Omni Core configuration

Omni Core can be configured via command-line options, or by editing `bitcoin.conf`.

- `-startclean` (boolean, clear persistence files, disabled by default)

- `-omnilogfile=file` (string, log file, `omnicore.log` by default)

- `-omnidebug=category` (multi string, enable log categories, can be `all`, `none`)

- `-autocommit` (boolean, create or broadcast transactions, enabled by default)

- `-omnitxcache=n` (number, max. size of input transaction cache, `500000` transactions by default)

- `-datacarrier` and `-datacarriersize` determine whether to use class B (multisig) or class C encoding

- `-omnialertallowsender=source` (multi string, authorize alert senders, can be `any`)

- `-omnialertignoresender=source` (multi string, ignore alert senders)

- `-overrideforcedshutdown` (boolean, overwrite shutdown, triggered by an alert, disabled by default)

- `-disclaimer` (boolean, explicitly show QT disclaimer on startup, disabled by default)

- `-omniuiwalletscope=n` (number, max. transactions to show in history, `500` by default)

Note: this is a temporary file, and shall be updated before a release.

Master Core version 0.0.9-rel is available from:

- https://github.com/mastercoin-MSC/mastercore/releases/tag/v0.0.9

General

- This release is consensus critical. You MUST update before block 342650. After block 342650 prior versions WILL provide incorrect data

- This release modifies the schema. You MUST reparse when upgrading (run once with the --startclean option)

- Integrators should regularly poll getinfo_MP for any alerts to ensure they are kept aprised of any urgent issues

Changelog

- Mainnet Send To Owners transaction processing is live from block 342650

- STO support added to listtransactions_MP

- STO RPC calls getsto_MP and sendtoowners_MP added

- Added --startclean option to automate reparsing (removal of MP_ state folders etc)

- Alerting system added including evaluation and shutdown in event of new protocol messages being made live that are unsupported by client

- getinfo_MP RPC call added

- Numerous bugfixes

Omni Core version 0.0.9.1-rel is available from:

https://github.com/mastercoin-MSC/mastercore/releases/tag/v0.0.9.1

0.0.9.1 is a minor release and not consensus critical. An upgrade is only mandatory if you are using a version prior 0.0.9.

Please report bugs using the issue tracker at GitHub:

https://github.com/mastercoin-MSC/mastercore/issues

IMPORTANT

- This is the first experimental release of Omni Layer support in the QT UI, please be vigilant with testing and do not risk large amounts of Bitcoin and Omni Layer tokens.

- The transaction index is no longer defaulted to enabled. You will need to ensure you have "txindex=1" (without the quotes) in your configuration file.

- If you are upgrading from a version earlier than 0.0.9-rel you must start with the --startclean parameter at least once to refresh your persistence files.

- The first time Omni Core is run the startup process may take an hour or more as existing Omni Layer transactions are parsed. This is normal and should only be required the first time Omni Core is run.

Upgrading and downgrading

How to Upgrade

If you are running an older version, shut it down. Wait until it has completely shut down (which might take a few minutes for older versions), then copy the new version of mastercored/mastercore-qt.

If you are upgrading from any version earlier than 0.0.9, the first time you run you must start with the --startclean parameter at least once to refresh your persistence files.

Downgrading

Downgrading is not currently supported as older versions will not provide accurate information.

Changelog

General

- Extra console debugging removed

- Bitcoin 0.10 blockchain detection (will refuse to start if out of order block storage is detected)

- txindex default value now matches Bitcoin Core (false)

- Update authorized alert senders

- Added support for TX70 to RPC output

- Fix missing LOCK of cs_main in selectCoins()

- Versioning code updated

UI

- New signal added for changes to Omni state (emitted from block handler for blocks containing Omni transactions)

- Fix double clicking a transaction in overview does not activate the Bitcoin history tab

- Splash screen updated to reflect new branding

- Fix frame alignment in overview page

- Update send page behaviour and layout per feedback

- Fix column resizing on balances tab

- Right align amounts in balances tab

- Various rebranding to Omni Core

- Rewritten Omni transaction history tab

- Add protection against long labels growing the UI size to ridiculous proportions

- Update signalling to all Omni pages to ensure up to date info

- Override display of Mastercoin metadata for rebrand (RPC unchanged)

- Acknowledgement of disclaimer will now be remembered

- Ecosystem display fixed in property lookup

- Fix intermittent startup freezes due to locks