omhmichaels/homebrew-harmony

*Harmony Homebrew TAP Repository*

Harmony Homebrew Tap

Harmony Blockchain Homebrew Tap

Overview

Purpose:

• Allow and support binary installation of official harmony versioned binaries using homebrew. Explained in detail under History
• Supplement and simplify the development proccess of harmony blockchain development on Homebrew supported devices.
• More about Official Homebrew Third Party Taps Here
  • [Homebrew Taps][https://docs.brew.sh/Taps]
  • [Maintaining a Homebrew Tap][https://docs.brew.sh/How-to-Create-and-Maintain-a-Tap]

History

This repository was originally created for the Harmony Bounty here:

• [https://github.com/harmony-blockchain/bounties/issues/69]

The bounty specifications ask for a Cask. The reasoning for this is believed to be the following:

• Harmony would like to have the package installed directly from thier stable binary releases of there code.
• Harmony prefers this method over building from source
• Harmony believes binary installation is the best way to onboard people to Harmony Blockchain
• Simplifies installation dependencies compared to building from source.

The bounty also mention bottles but does not mention formulea.

Homebrew notes on why to maintain a tap Homebrew’s versions should not be used to “pin” formulae to your personal requirements. You should instead create your own tap for formulae you or your organisation wish to control the versioning of, or those that do not meet the above standards. Software that has regular API or ABI breaking releases still needs to meet all the above requirements; that a brew upgrade has broken something for you is not an argument for us to add and maintain a formula for you.

The completed cask was submitted to( Homebrew/homebrew-cask [Homebrew/homebrew-cask#113134] but is unable to be pulled in favor of an open [pull request in homebrew/homebrew-core][Homebrew/homebrew-core#87031] for a formula of the same name.

Cask Pull Request:[Homebrew/homebrew-cask][Homebrew/homebrew-cask#113134]

Formulea Pull Request:[Homebrew/homebrew-core formulea pull request packaging both harmony node and cli] [Homebrew/homebrew-core#87031]

Install Tap

# Tap the harmony-blockchain Homebrew
brew tap  harmony/homebrew https://github.com/omhmichaels/homebrew-harmony 

Current Casks

harmony-blockchain:

• Description: Harmony Blockchain Node

• Install:

        # Be sure to tap the repository 
        brew tap harmony/homebrew https://github.com/omhmichaels/homebrew-harmony

        # Install Harmony blockchain
        brew install harmony-blockchain

• Post Install:
  • Verify the unsigned binary as well as each of the dylib libraries.
  • After validation the following error will occcur:
  • ERROR when loading bls key: stat ./.hmy/blskeys: no such file or directory
  • Create a wallet and have its corresponding keys to fix issue
• Test:

# Grab the GOSDK Wrapper
curl -O https://raw.githubusercontent.com/harmony-one/go-sdk/master/scripts/hmy.sh

chmod u+x hmy.sh

./hmy.sh -d 

# Then create a wallet. Store your passphrase and mnemonic given in the output if you want to use your wallet again. 
/hmy.sh -- keys add account-name1 --passphrase 

# Then run your harmony-blockchain node
harmony 

Contributing

• From Homebrew Documentation:
  • [Maintaining a Homebrew Tap][https://docs.brew.sh/How-to-Create-and-Maintain-a-Tap]
  • [Cask-Cookbook][https://docs.brew.sh/Cask-Cookbook]

Usage