Gnosis Safe on Harmony

The Gnosis Safe is a smart contract wallet with multi-signature functionality at its core. Gnosis Safe Application on Harmony: https://multisig.harmony.one

Connect Wallet

You can connect to Gnosis Safe using Metamask.

1) Go to the Safe application on Harmony at https://multisig.harmony.one and click on Connect Wallet.

2) Chose your wallet.

Connecting with MetaMask

Select the MetaMask option in the connect wallet menu. Check that the correct MetaMask account is active and connected to the Harmony Network.

Create Safe

1) Press Create new Safe.

2) Name the safe. This will be stored locally. Press Start to continue.

3) Add additional owners if you want. For each additional owner:

1. Click Add another owner

2. Give Owner a Name

3. Enter Owner an Address

4. Select how many owners will be required to confirm a transaction

5. Press Review

4) Submit your safe by clicking on Submit. You will need a very small amount of ONE tokens to confirm the transaction.

5) Confirm the transaction on Metamask.

6) If all steps were sucessfull your Safe should have been deployed. Just click on Continue.

Load Existing Safe

You can load the Safe on other devices, so everyone can sign transactions using the same safe, but using different accounts.

1) On main page there is an option called Load Existing Safe. Click on this button as shown by the image below.

2) Pick a name for your Safe and paste the Safe Address. The Safe Address can be found on the main page. If you are in doubt please check section Receive Tokens.

3) Review owners by clicking on Review.

4) Load Safe by clicking on Load.

If sucessfull, you should see your Safe loaded on main page.

Send Tokens

1) On the main page click on New Transaction.

2) On next window click on Send funds. You can also send collectibles, but for this example we will be sending normal tokens.

3) On next window fill the recipient address you want to send your tokens to and the amount. After that click on Review.

4) O next window click on Submit.

5) A Metamask window will pop up for you to confirm the transaction. You should see your transaction confirmed on the next window. On our example we are using 2 of 3 signatures for the tokens to be sent out of the Safe.

6) We need at least one more account to confirm the transaction on the safe. Just click on Confirm logged in with the required account.

7) Approve the transaction by clicking on Approve Transaction.

8) If all the parts have confirmed the transaction you should see Success on top.

Receive Tokens

Once you have a Safe deployed, you can use the Safe address to receive tokens. Just click on Copy to clipboard.

Trezor wallet can be used along with Metamask to perform ONE transfers on Harmony network. Follow the steps below.

Note that, load the Ethereum firmware (or app) for signing the transactions on the trezor device. Currently, Harmony does not have a separate trezor firware. There is a bounty for adding Harmony to trezor firmware. After this bounty is finished, the users will be able to both transfer ONE and perform staking using trezor using Harmony firmware (or app).

Metamask can be used along with ledger to perform transfers.

Steps:

Installing using Ledger Live (RECOMMENDED)

1. Turn on Developer

Download and install the latest Ledger Live version onto your computer. Ledger Live is the app you use to manage your Ledger device. Please follow the official installation instruction here.

Open Ledger Live, select Manager. Turn on Developer Mode in Manager: Settings -> Experimental Features -> Developer Mode, as shown below:

2. Search for the App in the Catalog

Ledger live provides app catalog for different types of apps, as shown below:

To find the Harmony app, type harmony in the search bar, as shown below:

3. Install/Remove the App

There are two buttons associated with Harmony One app. The install button can be clicked to install Harmony One app to Ledger Nano. The app can be uninstalled by clicking the trash bin button.

4. Using the App

To use Harmony One app, please check your Ledger Nano device and click both buttons to open the app.

Installing Manually (Windows)

1. Install Python

To install Python 3.8.1 for windows, go to this website.

At the end make sure you add the python binary to the path:

2. Install Packages

Execute the commands below on the windows terminal:

python -m pip install --upgrade pip
pip install virtualenv
virtualenv venv
cd venv
cd Scripts
Activate.bat
pip install ledgerblue

2. Download Latest Version

Click here to download the latest avaialable version. Make sure you download it using the raw format from Github like shown below:

3. Install the App

Move the ver1.6.0.hex file downloaded before tovenv\Scripts folder and execute the command below to install the app:

python -m ledgerblue.loadApp --appFlags 0x40 --path "44'/1023'" --curve secp256k1 --tlv --targetId 0x31100004 --targetVersion="1.6.0" --delete --fileName ver1.6.0.hex --appName One --appVersion 1.6.0 --dataSize 0 --icon 01ffffff00ffffff00ffffffffffffc7e1bbcdbbddbbcdbbc50bd8a3ddbbddbbddb3edc7e3ffffffff

Confirm the installation of the app on your Ledger.

Installing Manually (Ubuntu Linux)

1. Install Packages

sudo apt update
sudo apt install libudev1 libudev-dev libusb-1.0-0-dev python3-dev python3-pip python3-testresources git
sudo pip3 install -U setuptools
sudo pip3 install virtualenv
virtualenv -p python3 venv
source venv/bin/activate
pip install ledgerblue

2. Downloading the App

git clone https://github.com/harmony-one/ledger-app-one
cd ledger-app-one

3. Installing the App

sudo ~/venv/bin/python -m ledgerblue.loadApp --appFlags 0x40 --path "44'/1023'" --curve secp256k1 --tlv --targetId 0x31100004 --targetVersion="1.6.0" --delete --fileName release/ver1.6.0.hex --appName One --appVersion 1.6.0 --dataSize $((0x`cat debug/app.map |grep _envram_data | tr -s ' ' | cut -f2 -d' '|cut -f2 -d'x'` - 0x`cat debug/app.map |grep _nvram_data | tr -s ' ' | cut -f2 -d' '|cut -f2 -d'x'`))  --icon 01ffffff00ffffff00ffffffffffffc7e1bbcdbbddbbcdbbc50bd8a3ddbbddbbddb3edc7e3ffffffff

Confirm the installation of the app on your Ledger.

Using Harmony hardware wallet on the Ledger requires a few things. You will need:

• Your Ledger

• The Harmony app installed on your Ledger

Download & Setup HMY

To interact with your Ledger device using the HMYC CLI, please click here to download and configure it first.

Interacting with Ledger

With that in mind, you can run any other command via HMY CLI using your Ledger.

Below, are a few practical examples on how to interact with your Ledger device.

1. Displaying your Address

For example, if you want to show your Ledger address you would simply run:

Using the Binary:

./hmy keys list --ledger

Using the Shell Wrapper:

./hmy.sh -- keys list --ledger

2. Displaying your Balance

Using the Binary:

./hmy balances --node="<endpoint-address>" <ONE-address> --ledger

Using the Shell Wrapper:

./hmy.sh -- balances --node="<endpoint-address>" <ONE-address> --ledger

3. Sending Transactions

Using the Binary:

./hmy transfer --node="<endpoint_address>" \
 --from <ONE_address> --to <ONE_address> \
 --from-shard <shard> --to-shard <shard> \
 --amount <amount> --chain-id <chain-id> --passphrase --ledger

Using the Shell Script:

./hmy.sh -- transfer --node="<endpoint_address>" \
 --from <ONE_address> --to <ONE_address> \
 --from-shard <shard> --to-shard <shard> \
 --amount <amount> --chain-id <chain-id> --passphrase --ledger

For a complete reference of all commands available, please check the HMY CLI cookbook.

• Demo on Harmony Mainnet

• Harmony's Wallet Strategy

• Tweets on Updates and News

• Research on Keyless Wallet

Project Summary

⚡ WHY: Billions of users can earn 10% or more annual returns with crypto assets. But they must stop worrying about seed phrases, device loss, email phishing, phone hijacking... We can secure everyone’s financial future against password breaches, software bugs, platform malware and exchange hacks.

👩‍👩‍👧‍👦 WHOM: Global consumers with just a few thousand dollars and no technical background.

💎 WHAT: A digital wallet for crypto assets, investment and identity. Consumers can buy crypto assets via credit cards, then trade between multiple platforms. They can earn fixed-rate interests or actively invest for higher returns. Their profiles can hold digital arts or custom domain names.

🤯 MAGIC

• Earn 20% annual interests for the first million users.

• No emails, SMS, passwords or government documents necessary.

• Seamless between assets from Bitcoin, Ethereum or any networks.

🔨 HOW

• Many staking protocols offer 10% yields, lending protocols offer 10%, and liquidity pools offer 20%.

• Assets and keys are secured on blockchain; only need Google Authenticator and social recovery.

• Harmony supports non-custodial and trustless transactions in 2 seconds and at less than $0.01 fees.

💪 WHO: Ph.D.s, ex-Google developers, formal verification as security audit, top branding agency, builders of billion user products.

🔥 WHERE: The Future of Money is already here but unevenly distributed. Decades of cryptography, best research in production.

🚀 WHEN: Product launch in 2021 Q3 with 1000 users, then 10k users in Q4 with each wallet holding $1000. A prototype with minimal features on mainnet in July.

💡 Terms

• Social recovery: friends or other devices unlock funds for you if you lose access to your wallet.

• Non-custodial: no network, software, developers, government or even Harmony control your fund.

Join us at @1wallet_, demo and wiki.

Security Goals

ONE Wallet is designed with these goals in mind for security:

Social (people)

• Resilient. Funds are recoverable through time locks and multiple safety nets. No single point of failure such as thefts, cracks, loss, censorship or coercions is catastrophic.

• Sufficient. All steps are well defined without delegating to hardware devices or seed phrases in safety boxes. Users do not need any passwords or rely on biometrics.

• Anonymous. An account is a fresh cryptographic hash, not tied to existing systems or real-world identity. Derived paths support multiple public keys to protect privacy.

Smart (code)

• Composable. One-time or low-entropy passwords are useful for small funds. Multiple authentications can independently boost protection thresholds against brute-force.

• On-chain. A decentralized network with high stakes and fast finality validates all transactions. Its platform has sustainable incentives and open governance to evolve.

• Programmable. Operations can call third-party contracts, store history of states, or upgrade its code. Complex applications may use oracles of time, locations and events.

Hard (math)

• Self-Sovereign. No third parties, government documents, designated guardians, backup servers or hardware enclaves are necessary. Users have full custody and self control.

• Air-Gapped. Key-loggers and man-in-the-middle attacks are minimized. The full parameters of transactions are easy to verify and approve without cables or cameras.

• Verified. Trusted are only open source and hardened cryptography. Formal verification, through logical frameworks, assures end-to-end security beyond tests and audits.

Tradeoffs

There may be conflicts, tradeoffs or impracticality of the goals above. Here's our rule of thumb:

1. Toward validating our innovation with 10k users (each with $100 assets), focus on these three goals: sufficient, resilient and composable.

2. Toward adopting our product with 1m users (each with $1k assets), differentiate with these three goals: on-chain, self-sovereign and air-gapped

MetaMask is an extension for accessing Harmony enabled distributed applications, or "dapps", from your browser. The extension injects the Harmony web3 API into every website's javascript context, so that Web3 applications can read from the blockchain.

In this section, we walk through the process of installing MetaMask, configuring it on the Harmony network, and importing an existing account using a previously generated private key.

To send ONE tokens to an address, click the "Transfer funds" button and the send window will pop-up.

Input the amount of tokens to send and the destination address, then click the "next" buttons.

Click the "Confirm and Sign" button to sign the transaction.

Check your ledger Nano S, the LED display on Nano S is shown as below. Click on the right button to review transaction on Ledger.

Check and confirm the destination address is correct.

Check and confirm the amount is correct.

Currently, staking dashboard only supports transaction on shard0.

Click the right button to start signing the transaction:

Once transaction is signed, Send window will pop-up on the staking dashboard and display the transaction status.

It will display "Successful Send" once the transactions completes.

Check the validators page to see list of validators. Click on desired validator logo to check validator details.

Click on the "Delegate" button to delegate to this validator.

Enter the desired delegation amount or scroll the percentage slider in the pop-up Delegate window. Delegation must be at least 100 ONE. Click on "Next" and confirm the signature request.

Check your Ledger, it will display "Delegate Stake" in the LED screen. Press the right button to start signing the transaction.

Check the delegator address. Press the right button to show full address. If correct, press both left/right buttons to continue.

Check the validator address. If correct, press both left/right buttons to continue.

Check the delegation amount. If correct, press the right button to continue:

Press right button for Sign Stake confirmation.

The entire process is shown below:

Once transaction is signed, Delegate window will pop-up on the staking dashboard and display the transaction status.

Create New Wallet

Import Wallet (Recover)

Download SafePal Mobile Apps

SafePal mobile apps can be downloaded from PlayStore and AppStore following the instructions here.

Quick Start

Please make sure your SafePal is the latest by following the instructions here. The SafePal general user's manual is here and the initial set up guide is here.

Ledger Nano X and Nano S

The Nano X and Nano S are hardware wallets created by Ledger. A hardware wallet stores the private keys to Harmony tokens on a separate device, making it much harder for malicious parties to steal them. In fact, the private keys never leave the Nano wallet itself, so they will remain secure even if the device is connected to a compromised computer. As long as you follow best practices when using your Nano, it is virtually impossible for an attacker to steal your funds.

Plug in your Ledger and open the Harmony Ledger App. Your device will be detected by your computer.

Start from the staking dashboard: https://staking.harmony.one/ledger and click the "sign-in" button.

You will be directed to the Validators page on the Staking Dashboard and a small trident logo will appear on the chrome tab. Your Ledger Nano will display "waiting for commands" before you click on any buttons.

Click the "Show on Ledger" button to display your address on your Ledger device.

Press the right button on Ledger to continue and confirm the address is correct.

Adding Harmony to MetaMask

Open MetaMask and click the list of networks at the top, then select "Add Network".

Fill the Endpoint Information

You will be prompted for additional information. Use the table below to complete the step. Below you will see multiple options for RPC URL and Chain ID corresponding to mainnet vs testnet, and the various shards within each.

The example below shows the configuration that needs to be done to connect to Harmony Mainnet on Shard 0:

Click the Save button and your configuration should be done!

Adding a Custom Token

Open MetaMask, select the Harmony network, then click the Assets tab. Near the bottom, click "Import Tokens" and complete the empty fields.

Add the Token Contract Address, Token Symbol, and the Decimals value. Note the Token Symbol and Decimals may auto-populate. These details are usually provided by the token creator.

See "Importing 1BTC Token" as an example.

Complete the step by clicking on "Add Custom Token". Your custom HRC20 Token will show up in MetaMask along with its balance.

Sending a HRC20/HRC721 Transaction

Click on the asset you want to send your tokens from on the Asset tab. Click on Send button and on next window copy paste the destination address starting with 0x, fill the amount you want to send, click on Next and then on Confirm.

Receiving a HRC20/HRC721

In order to receive a transaction, just share the 0x address format of your wallet. One Wallet supports sending HRC20/HRC721 transactions to either addresses starting with 0x or one1.

1. Obtaining a Private Key

Importing an account is done by taking an existing private key and importing it into MetaMask. How you obtain the private key is dependent on the wallet in use.

For the Harmony Chrome extension wallet, click the Menu button at the top right, click Export Private Key, enter your password, and copy the private key displayed.

2. Using a Private Key

Click on the icon on top as shown by the image below and then on Import Account:

On next window, select the option to import from a Private Key, paste your key and click on Import to complete the step.

Your account should now be imported.

Retrieving the 0x Equivalent Address

• For mainnet, go to (Mainnet). For testnet, go to .

• Search for your one1 address at the top.

• At top of the screen, toggle the address format from ONE to ETH.

• Copy the 0x address format by clicking on the small icon right to the address

You now have the 0x address which corresponds to your one1 address.

Sending a Regular Transaction

To send a transaction on MetaMask, click on Send button and on next window paste the destination address starting with 0x, fill the amount you want to send, click on Next, and then click on continue.

Receiving a Regular Transaction

In order to receive a transaction, simply share the 0x address format with the sender.

You can choose to create a wallet through the extension or import your existing wallet using a mnemonic phrase or a private key.

When you create a wallet, please write down your mnemonic correctly and keep in a safe place.

You may also import your Harmony Account using your mnemonic or private key.

You can also choose to export your keys in Settings. Your keys will be exported into a txt file with both private key and mnemonic.

In order to create a new account, click on the icon on top as shown by the image below and then on Create Account:

On next window, provide an account name and then click the Create button to complete the step.

Make sure you've set up your Math Wallet extension according to the directions in .

Opening Web Wallet

You will need to open Web Wallet in order to view account details and perform transactions.

1. Please select the wallet you want to open and click Web Wallet on the Math Wallet extension popover interface.

2. After clicking Web Wallet, a new tab will open asking you to login into Math Wallet, click on login and you will enter the Web Wallet.

Sending transactions

1. Specify the shard you want to pull funds from using the Shard dropdown in the sidebar.

2. Specify which account you want to send funds to using the To Address field.

3. Specify which shard you want to send funds to using the Shard dropdown to the right.

4. Specify the amount you wish to send in the Transfer Amount field.

5. Specify the gas price you wish to pay using the Fee slider. Gas is a fee charged by the network for the computational work of mining a transaction into the blockchain.

6. Click Transfer to complete the transaction! You will be shown a transaction receipt before finalizing the transaction.

is a browser extension and a mobile wallet for holding and transacting cryptocurrency.

Installation

1. Access the Google Chrome web store and install the .

1. Open the extension in your browser and create new password.

1. Select Harmony from the list of networks.

Click to install the MetaMask extension on your browser. It can be installed on most desktop browsers. Just click on the installation button to begin the process. Once installed, continue to the next section to add the Harmony network to your new wallet.

SafePal Hardware Wallet

SafePal is a secure and user-friendly hardware wallet designed for the masses. SafePal S1, its first flagship hardware wallet, adopts multiple layers of security schemes and intuitive user interfaces, enabling users to store, transfer and trade coins in the wallet in the easiest way.

How to send ONE in SafePal？

1. Click on the 'Send' segment in SafePal App menu bar and select ONE.

1. Input the destination address by pasting the address or scanning the QR code. Enter all transaction details - amount, fee and don't forget to select the shard number.

1. Then clink “Send”to check the transaction details.

Tips: If you don't know the exact shard number, don't worry, you can simply use Shard 0 as the default shard.

1. Sign the order with your SafePal S1 hardware wallet.

1. Confirm the payment.The transfer is broadcasted on chain. Don't forget to check transfer status later.

How to receive ONE in SafePal?

To receive ONE tokens you need to provide the sender your ONE address which can be found using the SafePal app or wallet.

Using the SafePal App:

1. Select ONE which gives you the option of receive and send, click on receive

2. You can either copy your ONE address for the wallet, save the QR code, or have the other party scan the QR code from your phone

Using the SafePal Wallet:

1. Turn on the wallet

2. Scroll to "Asset Management" in the main menu

3. Select "Harmony" out of all the options

4. Click on receive, and then enter your PIN code

5. Your QR code, as well as the ONE address for the wallet will show for the other party to use

Stake and exchange Harmony ONE tokens using Guarda Wallet. You can download the desktop wallet here.

Manage your Harmony, Ethereum, HRC20, HRC721, ERC20 & ERC721 Tokens in a trustless manner.

You can download Blits Wallet here.

Average setup time is 3-5 minutes:

1. Download Metamask Mobile App from Apple App Store

2. Click on Get Started

3. Select Create a new wallet

4. Scroll and select No thanks for Metamask data

5. Create Password and select Face ID (MetaMask cannot recover your password, write this down in a safe place, DO NOT TAKE A SCREENSHOT)

6. Allow Face ID

7. Secure Wallet (*even more important than password, should never be shared with anyone, even MetaMask)

8. Review Metamask Tips (store phrase in a secure location)

9. Make sure no one is watching before revealing phrase, click View

10. Write your Secret Recovery Phrase in a safe place

11. Choose to enable automatic security checks (we recommend that you enable this)

12. You’re all set! Now connect to Harmony

13. Now that you have Metamask set up, let’s get you ready for ONE 🎉

14. Click Wallet at the top of the screen

15. Click Add Network

16. Select Add for Harmony Mainnet Shard 0

17. Approve (make sure the information is the same)

18. Switch to Network

19. To Get ONE you’ll need your ONE address

20. With Metamask open make sure the Wallet is on Harmony Mainnet Shard 0

21. Click your address on the top of the page to copy it

22. Once the address is copied, select ONE

23. Select the three dots on the top right and View on block explorer

24. Paste in Search

25. Your ONE address will automatically load

26. Select the copy icon to copy the address

(For additional iPhone security measures, follow this link)

With your ONE staked to one or more validators, your delegation begins earning rewards with each block. You may collect these rewards at any time and may be re-delegated to compound your interest assuming you have 100 or more ONE.

Visit the staking dashboard at staking.harmony.one and click the Portfolio link on the left.

Log into the dashboard if you're not already signed in.

With your address confirmed, proceed by clicking the Claim Rewards button to collect the ONE earned through staking.

Note the staking dashboard currently only displays whole integers, which means <1 ONE rewards will display as zero and cannot be collected.

Proceed by clicking the Next button at the window below.

Then click the Confirm and Sign button to send the transaction for signing in Math Wallet.

This will cause Math Wallet to pop up and request you to accept the signature request.

Click the Accept button to sign the transaction and collect your rewards.

Your rewards are collected once you see a Successful Withdrawal message.

Your ONE rewards, generated by staking your coins, are now added to your wallet.

Visit and sign into the staking dashboard at https://staking.harmony.one/, if you are signed out.

Click on the Portfolio link to the left.

This page will display information about your staked ONE including a list of validators to which you've delegated your ONE, amount of staked ONE, and unclaimed rewards.

You can undelegate from one or more validators where your ONE is staked.

From the Portfolio view, select the validator(s) from which you wish to undelegate by clicking on their validator name. This brings up the validator profile page.

Click the Undelegate button.

You will be prompted to specify how much you wish to undelegate from the validator. From here, specify an amount you wish to undelegate or click Set Max to undelegate all ONE from the validator.

Click Next and then click Confirm and Sign. This will open a window for Math Wallet.

Click the Accept button to sign your undelegation / unstaking transaction.

You should see a notification for your successful undelegation.

Your ONE is now undelegated from the validator. You may have more ONE staked with other validators. To undelegate fully, repeat these steps again through the list of validators on your Portfolio page.

Visit the staking dashboard at https://staking.harmony.one/ and click Sign In.

The screen will prompt you to make a selection.

Choose "Use an Existing Address".

Click "Use Math Wallet" from the next selection of options and then click "Sign In".

Sign in to your Math Wallet browser extension. You will see a Login Request pop up. Select your wallet and then click Accept.

You will be brought back to the Validator page of Staking Dashboard. You will be able to see your address on the top left corner under the Harmony logo which means you are now signed in to your account.

Locate and click on your preferred validator from the list.

The validator profile page will open. Click on the Delegate button.

Option #1: Enter the desired amount of tokens you would like to delegate and click next or...

Option #2: Use the slider to determine the percentage of your ONE you wish to stake.

Click Next and then click Confirm and Sign.

Click Accept to confirm the signature request on the Math Wallet pop-up window and wait a few seconds. If the transaction completes, you will find a success confirmation pop-up on your screen.

You are now staking your ONE with a validator and will begin earning rewards at the start of the following epoch.

Click the Portfolio link on the left to view your stake amount, rewards accumulated, and a list of any validator to whom you have delegated your coins.

Frontier is a chain-agnostic DeFi aggregation layer. Users can stake in Harmony using Frontier.

Please visit with your mobile device to download the harmony mobile app.

Cobo is the first leading wallet company in the world to offer Staking and masternode rewards on user holdings, making it easy for users to grow their digital assets effortlessly. As a company, they emphasize long-term security, reliability, and convenience.

You can download Cobo Wallet .

Staking4All wallet is a desktop wallet for Harmony. You can download it .

Description: "The ultimate gateway to decentralized finance in a user-friendly, multi-currency and convenient cryptocurrency wallet for all your needs."

For more information: https://infinitywallet.io/mobile

Stake and exchange Harmony ONE tokens using Guarda Wallet. You can download the mobile wallet .

Trust Wallet is a mobile cryptocurrency wallet. Please visit with your mobile device to download the app. Users can stake in Harmony using Trust Wallet.

Incoming transactions

The funds that are sent within shard 0 will be viewed correctly in Trust Wallet.

If you receive funds in a shard other than shard 0 (i.e. in shard 2), you will not see the transaction receipt in the Trust Wallet app. Since your account balance will only show the funds in shard 0, your total balance will not change.

Outgoing transactions

Since there is no shard selection in the Trust Wallet UI, all transactions will originate from shard 0 and will be sent to shard 0.

For more details, please see these example cross-shard transactions using Trust Wallet:

What to do if you receive funds in a shard other than shard 0 when using Trust Wallet?

You will need to export the account in which you received the funds and import it to another wallet such as the CLI or Math Wallet.

Example Using Math Wallet:

1. Open Trust Wallet app

2. Click on "Settings" on the bottom right

3. Click on "Wallets"

4. Click on the info circle next to "Multi-Coin Wallet"

5. The screen will show backup options, select "show recovery phrase"

6. Your mnemonic recovery phrase will show up, make sure to note them down accurately and securely

7. Open Math Wallet Chrome Extension

8. Click the + sign next to Harmony

9. Select "Import Wallet"

10. Select "Import by mnemonic"

11. Type in your mnemonic that you noted from Trust Wallet, and click next

12. Name your new imported wallet

13. Open "web wallet" from the extension and you can access all your funds in all shards

Import/Export Wallet

Below are the official instructions on how to restore/import Recovery Phrase (mnemonic) on Trust wallet.

Description: "ONTO is the first truly decentralized, cross-chain wallet, allowing users to securely manage their identities, data, and digital assets. Wallet users can manage their crypto assets (including NFTs), perform cross-chain swaps, keep up-to-date with the blockchain and crypto industry’s latest developments and events via the ONTO news feed, and enjoy a variety of dApps."

For more information:

Description: "Trustee Wallet is the altcoins & Bitcoin wallet app for secure storage, profitable purchase of cryptocurrencies and tokens using bank cards."

For more information: https://trusteeglobal.com/

Download Harmony CLI tool

1. For Linux

Enter the following command into your shell of choice:

curl -LO https://harmony.one/hmycli && mv hmycli hmy && chmod +x hmy

2. For MacOS

hmy depends on some dynamic libraries, hence we recommend using the shell wrapper. Enter there commands into your terminal:

curl -O https://raw.githubusercontent.com/harmony-one/go-sdk/master/scripts/hmy.sh
chmod u+x hmy.sh
./hmy.sh -d

Now you can use hmy.sh as a wrapper over hmy and you should assume that all references to hmy in these documents refer to hmy.sh. For example, the command ./hmy becomes ./hmy.sh -- .

3. Compiling from source

If you are interested in compiling from source, then the process is more involved.

Steps:

1. Clone the repository at the same level as the main Harmony repo:

cd $(go env GOPATH)/src/github.com/harmony-one
ls
bls harmony mcl
git clone https://github.com/harmony-one/go-sdk.git

1. Then setup the build flags:

source harmony/scripts/setup_bls_build_flags.sh

1. Call make in the go-sdk repo. This builds a binary named hmy:

cd go-sdk
make

Congratulations! You can now use the binary to run the CLI.

Description: Stake and exchange Harmony ONE tokens using Guarda Wallet. Stake, exchange, earn and buy Harmony, Bitcoin, Ethereum and thousands of other assets.

For more information: https://guarda.com/

Get JSON output of balances on all shards of a given ONE address with the balances subcommand:

Using the Binary:

Using the Shell Wrapper:

Example:

Introduction

hmy is the official Command Line Interface (CLI) provided by Harmony. You can use it as a local wallet and as a way to interact with your Ledger Nano device. The hmy CLI is completely open-source. You can track its development and post any issues encountered and your feature suggestions .

Features

With the hmy CLI you can create a wallet, check your balance, send signed transactions to the Harmony blockchain, look up previous transactions, recover keys from previous mnemonics, create new keystores, and create new BLS keys.

Supported Platforms

• OSX: main development platform

• Linux: tested

• Windows: tested/working under Windows Subsystem for Linux (WSL)

Release information

We will always upload the latest production release on and announce future uploads in pre-production releases.

Harmony Smart Defi Wallet

Send. Swap. Connect. | Available at https://sefwallet.one

Sef Wallet is a smart DeFi wallet built for Harmony blockchain. Always low fees, and fast transaction time.

ADVANCED SECURITY

• Guardians for added protection

• Spending limits

• Open-source contracts

• Independently audited

AUTHENTICATOR RECOVERY

No more worrying about losing mnemonic keys, private keys, email or passwords to restore your wallet. Recovery is done with your authenticator codes on the blockchain with merkle proof.

ASSETS MANAGEMENT

• Supports HRC20 send/transfer

• Local prices conversions to dozens of languages

SWAP ON SUSHISWAP

• Native support for sushiswap

• Supports over dozens of of tokens

CONNECT TO DAPPS

• Connect any dapps with WalletConnect

• Access to Defi features on Sushiswap.

Delegating to a Validator

You can delegate tokens to a validator using the following command:

./hmy --node="https://api.s0.t.hmny.io" staking delegate \
    --delegator-addr [ONE ADDRESS] --validator-addr [ONE ADDRESS] \
    --amount [AMOUNT] --passphrase

The CLI will ask for the passphrase for the delegator-addr keystore file.

--delegator-addr is the ONE address of the delegator (string)

--validator-addr is the ONE address of the validator (string)

--amount is the number of ONE tokens to delegate to the validator (float)

Undelegating from a Validator

You can un-delegate tokens from a validator using the following command:

./hmy --node="https://api.s0.t.hmny.io" staking undelegate \
    --delegator-addr [ONE ADDRESS] --validator-addr [ONE ADDRESS] \ 
    --amount [AMOUNT] --passphrase

The CLI will ask for the passphrase for the delegator-addr keystore file.

--delegator-addr is the ONE address of the delegator (string)

--validator-addr is the ONE address of the validator (string)

--amount is the number of ONE tokens to un-delegate (float)

Collecting Rewards

You can collect your block rewards with the following command:

./hmy --node="https://api.s0.t.hmny.io" staking collect-rewards \
--delegator-addr [ONE ADDRESS] --passphrase

The CLI will prompt your for the passphrase of the delegation account.

--delegator-addr is the account to collect rewards for

New Wallet

Using the Binary:

./hmy keys add <account-name> [--passphrase]

Using the Shell Wrapper:

./hmy.sh -- keys add <account-name1> [--passphrase]

Example:

./hmy keys add test-account --passphrase

This creates a keystore at the following directory:(hmy keys location)/account-name1/UTC--2019-09-16T21-25-35.297331000Z--678e7ea3dcb5f4e9724c0e761843572f10c49b73

When creating keys this way, hmy will ask you to provide a passphrase.‌ Make sure you keep track of this passphrase for future use because the passphrase is used to decrypt the keystore when signing transactions. Also make sure you save the seed phrase, also called a mnemonic.

To know where your wallet file has been created, run the following command:

Using the Binary:

./hmy keys location

Using the Shell Wrapper:

./hmy.sh -- keys location

You can check the list of wallets (local accounts) with the following command:

Using the Binary:

./hmy keys list

Using the Shell Wrapper:

./hmy.sh -- keys list

Import Wallet

Importing a Keystore

‌You might have an existing keystore made by Harmony's old wallet.sh program that ends with ".key" in the file name (example):

one16qsd5ant9v94jrs89mruzx62h7ekcfxmduh2rx.key

Or that starts with "UTC" in the file name (example):

UTC--2020-01-15T01-02-06.606670000Z--9689a0711642bf08ea92ed98d552f0c1b8c8cefb

Both these files can be imported into hmy using the command import-ks as shown below.

Using the Binary:

./hmy keys import-ks <absolute_path_to_keystore> --passphrase

Using the Shell Script:

./hmy.sh -- keys import-ks <absolute_path_to_keystore> --passphrase

Examples:

./hmy keys import-ks /home/harmony/one16qsd5ant9v94jrs89mruzx62h7ekcfxmduh2rx.key --passphrase
./hmy keys import-ks /home/harmony/UTC--2020-01-15T01-02-06.606670000Z--9689a0711642bf08ea92ed98d552f0c1b8c8cefb --passphrase

‌Keep in mind that you should know the passphrase associated with the imported keystore and pass it as a parameter as shown in the commands above. For keystores created by Harmony's wallet.sh, the default passphrase is an empty string; this matters for signing transactions.‌

Importing a Private Key

Sometimes you might have a secp256k1 private key, such as the one generated from the following command:

openssl ecparam -genkey -name secp256k1 -text -noout -outform DER | xxd -p -c 1000 | sed 's/41534e31204f49443a20736563703235366b310a30740201010420/PrivKey: /' | sed 's/a00706052b8104000aa144034200/\'$'\nPubKey: /'

You can import the key with an optional name and passphrase

Using the Binary:

./hmy keys import-private-key <secp256k1_private_key> [wallet_name] [--passphrase]

Using the Shell Script:

./hmy.sh -- keys import-private-key <secp256k1_private_key> [wallet_name] [--passphrase]

Example:

./hmy keys import-private-key b8798ca0a56ce16517ea37c6b1229cbb67cf0e022c423b044fe8f537830d8be5 my_wallet_name_here --passphrase

If no account name is provided, a random word concatenated with -imported will be used. If no passphrase is provided, the default passphrase will be used (which is blank). Note that the CLI currently only supports importing secp256k1 private keys.

Importing a Mnemonic Phrase

You can recover lost wallet keys by entering the mnemonic words you received (and hopefully saved) when creating it:

Using the Binary:

./hmy keys recover-from-mnemonic [wallet_name]

Using the Shell Script:

./hmy.sh -- keys recover-from-mnemonic [wallet_name]

Example:

./hmy keys recover-from-mnemonic nameofyourkey

Perhaps the most important feature of the hmy CLI is the ability to create and send signed transactions to the Harmony blockchain.

Overview

Sending a transaction

Using the Binary:

./hmy transfer --node="<endpoint-address>" \
 --from <ONE_address> --to <ONE_address> \
 --from-shard <shard> --to-shard <shard> \
 --amount <amount> --chain-id <chain-id> --passphrase

Using the Shell Wrapper:

./hmy.sh -- transfer --node="<endpoint-address>" \
 --from <ONE_address> --to <ONE_address> \
 --from-shard <shard> --to-shard <shard> \
 --amount <amount> --chain-id <chain-id> --passphrase

Example:

./hmy --node="https://api.s0.t.hmny.io" \
 transfer --from one1yc06ghr2p8xnl2380kpfayweguuhxdtupkhqzw \
 --to one1q6gkzcap0uruuu8r6sldxuu47pd4ww9w9t7tg6 \    
 --from-shard 0 --to-shard 1 --amount 12.5 --chain-id mainnet --passphrase mypassword

Checking the transaction hash

Check for finality of the transaction by using the transaction hash like so:

Using the Binary:

./hmy blockchain transaction-receipt <transaction_id> --node="<endpoint-address>"

Using the Shell Wrapper:

./hmy.sh -- blockchain transaction-receipt <transaction_id> --node="<endpoint-address>"

Example:

./hmy --node="https://api.s0.t.hmny.io" \
 blockchain transaction-receipt \
 0x599793f313ee17566f8d09728b9d043b8e26135ddce86beeee13f98767d452f7

Detail

ChainIDs

Let's first check what chain-ids are available for us to use, we can do that easily with:

Using the Binary:

./hmy blockchain known-chains

Using the Shell Wrapper:

./hmy.sh -- blockchain known-chains

Example:

./hmy blockchain known-chains

[
  "mainnet",
  "testnet",
  "devnet"
]

Notice that the output is pretty printed JSON, most outputs of hmy are JSON encoded and hmy defaults to showing it nicely indented. Sometimes though you might want to turn that off, you can do that for any command with the flag --no-pretty.

By default, hmy assumes the testnet chain-id; override that with the --chain-id flag

Our first transaction

We'll use the transfer subcommand of hmy to send a transaction.

./hmy transfer
Error: required flag(s) "amount", "from", "from-shard", "to", "to-shard" not set

Notice that simply invoking the transfer subcommand gave us an error message about certain flags not being set. We'll need to provide legitimate values for these flags for our transaction to proceed successfully. Reading off the flags in the error message from left to right, the semantic meanings are as follows:

• amount: The quantity of Harmony One token to transfer from the senders to the receiver

• from: The sender's one address

• from-shard: Shard from which sender's balance will be drawn from

• to: Receiver's ONE address

• to-shard: Shard in which receiver will receive the amount sent by the sender

• passphrase: your wallet passphrase, which is prompted when you hit enter (or you can use a txt file with password and add it: --passphrase file.txt)

A sharded blockchain is a new kind of blockchain architecture where the network is partitioned into sub-networks called shards. Sharding is one of the distinguishing features of Harmony and it is key to solving the traditional scalability problems encountered in other blockchain protocols.

Note: The same ONE address will have a different balance in each shard. Currently Harmony mainnet has four shards while testnet has three shards. Sending a transaction from one shard to another is called a "cross-shard transaction."

Thus, a correct usage of transfer looks like:

Using the Binary:

./hmy transfer --node="<endpoint-address>" \
 --from <ONE_address> --to <ONE_address> \
 --from-shard <shard> --to-shard <shard> \
 --amount <amount> --chain-id <chain-id> --passphrase

Using the Shell Wrapper:

./hmy.sh -- transfer --node="<endpoint-address>" \
 --from <ONE_address> --to <ONE_address> \
 --from-shard <shard> --to-shard <shard> \
 --amount <amount> --chain-id <chain-id> --passphrase

Example:

./hmy transfer --node="https://api.s0.t.hmny.io" \
 --from one1yc06ghr2p8xnl2380kpfayweguuhxdtupkhqzw \
 --to one1q6gkzcap0uruuu8r6sldxuu47pd4ww9w9t7tg6 \
 --from-shard 0 --to-shard 1 --amount 10 --chain-id mainnet
{"transaction-receipt":"0x455f98a3aa11ef50ee5cc5ac8bbd79e04f2fe353180bb7e25fc6c921fc8fdc83"}

Try out your transaction with the flag --dry-run, this flag tells hmy to create, cryptographically sign the transaction but not actually send it off. Sender's balances are checked and the output is a JSON dump of the signed transaction.

Signing and sending a transaction is very quick, about 2 seconds maximum. The actual sending of the transaction is done via an RPC (Remote Procedure Call), you'll notice that we did not explicitly say where to send the transaction to. This is because the default destination of the RPC call goes to http://localhost:9500, the default HTTP RPC server running when you start a local harmony blockchain. For real world usage though, you'll want a different location. You can control that with the --node flag (see the top of this page for an example).

Result of the transaction

Once an RPC machine receives a transaction, it sends you back a transaction hash. This transaction hash is the key identifier used when querying the blockchain for transactions.

We can pull down details of the finalized transaction with ./hmy blockchain transaction-receipt as well:

Using the Binary:

./hmy blockchain transaction-receipt --node="<endpoint-address>" <transaction-hash>

Using the Shell Wrapper:

./hmy.sh -- blockchain transaction-receipt --node="<endpoint-address>" <transaction-hash>

Example:

./hmy blockchain transaction-receipt \
    --node="https://api.s0.t.hmny.io" \
    0x25dd32397b5a69146b2dc3bbdc8ef8aae271e9b12a36c6dff1eb8995cac9dcba
{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "blockHash": "0x67eb5d671af76814d9ab326f9ec36c5b889b872e0c34e8cbe484aea20f0611ea",
    "blockNumber": "0x21017f",
    "contractAddress": null,
    "cumulativeGasUsed": "0x5208",
    "from": "one1sp4q22r7cc78742mzrufu6xwcekqxjgq78jk3m",
    "gasUsed": "0x5208",
    "logs": [],
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "shardID": 0,
    "status": "0x1",
    "to": "one129r9pj3sk0re76f7zs3qz92rggmdgjhtwge62k",
    "transactionHash": "0x25dd32397b5a69146b2dc3bbdc8ef8aae271e9b12a36c6dff1eb8995cac9dcba",
    "transactionIndex": "0x0"
  }
}

You can tell hmy to wait until transaction confirmation by providing a positive integer value to flag --wait-for-confirm. For example, --wait-for-confirm=10 will try checking the receipt of the transaction for 10 seconds.

The easiest way to get detailed help is to use the cli itself. For example below is the cookbook which gives an overview of various commands.

./hmy cookbook --node="https://api.s0.t.hmny.io"

#Cookbook of Usage

#Note:

#1) Every subcommand recognizes a '--help' flag
#2) If a passphrase is used by a subcommand, one can enter their own passphrase interactively
#   with the --passphrase option. Alternatively, one can pass their own passphrase via a file
#   using the --passphrase-file option. If no passphrase option is selected, the default
#   passphrase of '' is used.
#3) These examples use Shard 0 of Open Staking Network as argument for --node

#Examples:

#1.  Check account balance on given chain
./hmy --node="https://api.s0.t.hmny.io" balances <SOME_ONE_ADDRESS>

#2.  Check sent transaction
./hmy --node="https://api.s0.t.hmny.io" blockchain transaction-by-hash <SOME_TX_HASH>

#3.  List local account keys
./hmy keys list

#4.  Sending a transaction (waits 40 seconds for transaction confirmation)
./hmy --node="https://api.s0.t.hmny.io" transfer \
    --from <SOME_ONE_ADDRESS> --to <SOME_ONE_ADDRESS> \
    --from-shard 0 --to-shard 1 --amount 200 --passphrase

#5.  Sending a batch of transactions as dictated from a file (the `--dry-run` options still apply)
./hmy --node="https://api.s0.t.hmny.io" transfer --file <PATH_TO_JSON_FILE>
#Check README for details on json file format.

#6.  Check a completed transaction receipt
./hmy --node="https://api.s0.t.hmny.io" blockchain transaction-receipt <SOME_TX_HASH>

#7.  Import an account using the mnemonic. Prompts the user to give the mnemonic.
./hmy keys recover-from-mnemonic <ACCOUNT_NAME>

#8.  Import an existing keystore file
./hmy keys import-ks <PATH_TO_KEYSTORE_JSON>

#9.  Import a keystore file using a secp256k1 private key
./hmy keys import-private-key <secp256k1_PRIVATE_KEY>

#10. Export a keystore file's secp256k1 private key
./hmy keys export-private-key <ACCOUNT_ADDRESS> --passphrase

#11. Generate a BLS key then encrypt and save the private key to the specified location.
./hmy keys generate-bls-key --bls-file-path <PATH_FOR_BLS_KEY_FILE>

#12. Create a new validator with a list of BLS keys
./hmy --node=https://api.s0.os.hmny.io staking create-validator --amount 10 --validator-addr <SOME_ONE_ADDRESS> \
    --bls-pubkeys <BLS_KEY_1>,<BLS_KEY_2>,<BLS_KEY_3> \
    --identity foo --details bar --name baz --max-change-rate 0.1 --max-rate 0.1 --max-total-delegation 10 \
    --min-self-delegation 10 --rate 0.1 --security-contact Leo  --website harmony.one --passphrase

#13. Edit an existing validator
./hmy --node="https://api.s0.t.hmny.io" staking edit-validator \
    --validator-addr <SOME_ONE_ADDRESS> --identity foo --details bar \
    --name baz --security-contact EK --website harmony.one \
    --min-self-delegation 0 --max-total-delegation 10 --rate 0.1\
    --add-bls-key <SOME_BLS_KEY> --remove-bls-key <OTHER_BLS_KEY> --passphrase

#14. Delegate an amount to a validator
./hmy --node="https://api.s0.t.hmny.io" staking delegate \
    --delegator-addr <SOME_ONE_ADDRESS> --validator-addr <VALIDATOR_ONE_ADDRESS> \
    --amount 10 --passphrase

#15. Undelegate to a validator
./hmy --node="https://api.s0.t.hmny.io" staking undelegate \
    --delegator-addr <SOME_ONE_ADDRESS> --validator-addr <VALIDATOR_ONE_ADDRESS> \
    --amount 10 --passphrase

#16. Collect block rewards as a delegator
./hmy --node="https://api.s0.t.hmny.io" staking collect-rewards \
    --delegator-addr <SOME_ONE_ADDRESS> --passphrase

#17. Check elected validators
./hmy --node="https://api.s0.t.hmny.io" blockchain validator elected

#18. Get current staking utility metrics
./hmy --node="https://api.s0.t.hmny.io" blockchain utility-metrics

#19. Check in-memory record of failed staking transactions
./hmy --node="https://api.s0.t.hmny.io" failures staking

#20. Check which shard your BLS public key would be assigned to as a validator
./hmy --node="https://api.s0.t.hmny.io" utility shard-for-bls 2d61379e44a772e5757e27ee2b3874254f56073e6bd226eb8b160371cc3c18b8c4977bd3dcb71fd57dc62bf0e143fd08

Here is the list of failed transaction messages which can be checked by querying your transaction hash, checking the transaction hash on explorer or checking the blockchain pool transactions.

Here is how with the hmy cli :

Generate Markdown Documentation

if you want a full list of commands the hmy tool knows in markdown format, please run the following command:

Then in the same directory, hmy creates a directory named hmy-docs in which you can find all markdown files for the commands and subcommands.

Delete Account

Deletion of a one account is possible by issuing the below command

hmy provides several subcommands under the blockchain subcommand which let you query the blockchain.

List of available commands

By using ./hmy blockchain help command we can see that the following options are available:

Here are some examples of the above commands that you will use frequently:

transaction-by-hash

Checking the hash of your transaction to see the transaction data and if the transaction has been completed

Using the Binary:

Using the Shell Wrapper:

Example:

transaction-receipt

Get information about a finalized transaction:

Using the Binary:

Using the Shell Wrapper:

Example:

latest-header command

Checking the network status, last block, epoch, leaders, based on the shard number:

Using the Binary:

Using the Shell Wrapper:

Example:

block-by-number

Using the Binary:

Using the Shell Wrapper:

Example: