BitShares Core Release 3.0.0

What’s New

• Release Numbering: We changed the versioning of the Core software to reflect a Protocol.Feature.Hotfix release format beginning from 3.0.0
• Hashed Timelock Contracts (HTLC): The building blocks for Atomic Cross Chain Swaps
• Sharing of Market Fees

Fixes

• MCR Bugfix: Resolves a bug where the call price is inconsistent when the maintenance collateral ratio (MCR) was modified
• Max Supply: Resolves a bug that could cause supply to grow beyond the intended maximum supply level.
• Oversized Transactions: Resolves a bug that could allow transactions beyond the size limit.
• Account Permission Bugfix: Resolves a bug that under certain circumstances a transaction signed by owner key of an account would be rejected

Where to Learn More

• Users documentation: How BitShares Works
• Developer documentation: Developer Portal
• NEW Instructions for the Hashed Time-Locked Contracts (HTLC) functionality
• NEW Instructions for Testing the Sharing of Market Fees
• NEW Instructions for Testing the MCR Fix

Who Should Update

• All validation node operators are encouraged to upgrade prior to Protocol Activation: 23 APR 2019 14:02 UTC as this is a consensus protocol impacting release
• All BTS token holders are encouraged to review this release, then vote to support block producers signaling their intention to upgrade prior to protocol activation

How to Update

Precautions

• All validation nodes must complete their upgrade prior to Protocol Activation: 23 APR 2019 14:02 UTC
• A blockchain replay will automatically be performed after the validation node software is restarted. This typically takes 90 minutes on a modern CPU

Obtain the Source Code

• git client: git clone --recursive --branch 3.0.0 https://github.com/bitshares/bitshares-core.git
• zip archive: https://github.com/bitshares/bitshares-core/archive/3.0.0.zip
• tar.gz archive: https://github.com/bitshares/bitshares-core/archive/3.0.0.tar.gz

Build the Binaries

The binaries may be built by using your pre-existing process, or by following the standard instructions that can be found in the wiki:

• Ubuntu
• OS X
• Windows
• Windows Development Environment

Deploy the Binaries

Your standard process for deploying the node software may be used. No additional requirements or precautions will be required to deploy the new release.

Obtain the Docker Image

The latest Docker image may be found at BitShares Core Docker page and updated with:

docker pull bitshares/bitshares-core

Binaries

Binaries of the command line interface (CLI) wallet, node software, and delayed node are pre-built and available for download.

Platform	SHA256 Checksum
Microsoft Windows	97559647e099c3768565f50cb5f43b0956afa6fd371b442aabdfb6e9acb62cb3
Mac	7c50d0a8f2eb5fdfd4c0c5d86d5bba076ec0acf1ccf256e70d2e4ef8010871eb
Linux	6f893f5bf5a08928c10d9adeaca92204ab150886dbe0da2102118e9aa5ab5a25

Changes

A summary of the tasks contained within Protocol Upgrade Release (3.0.0) follows:

Core Functionality

Description	Issue	Pull Request
Borrowing MPAs ignores max_supply setting	1465	1498
Call price is inconsistent when MCR changed	1270,1423	1324,1469,1493
Distribute Asset Market Fees to Referral Program (BSIP-43)	1268	1419
Hashed Time-Locked Contract (BSIP-44)	BSIPS 103	1370,1475,1535,1538
Prevent oversized transactions	1573	1624
Account permission bugfix	584	1259

Build Process

Description	Issue	Pull Request
Build fails on macOS due to size_t	1590	1589

Release Contributors

@abitmore
@jmjatlanta
@oxarbitrage
@pmconrad
@OpenLedgerApp
@ryanRfox