Skip to content

Files

Latest commit

mzfsharkgitbook-bot
mzfshark
and
gitbook-bot
GitBook: [dev] 156 pages modified
Jul 28, 2021
4aad177 · Jul 28, 2021

History

History
44 lines (24 loc) · 3.68 KB

getting-started.md

File metadata and controls

44 lines (24 loc) · 3.68 KB

Getting Started

Harmony is a powerful blockchain that is EVM compatible with sharding and staking features. Developing on Harmony should feel very familiar for Ethereum developers, as Harmony is fully Ethereum compatible and inherits almost all the tools and libraries from Ethereum, like truffle, remix, web3js, etc.

The simplest way to interact with Harmony blockchain is via JSON RPCs.

Querying Harmony blockchian using JSON RPCs

To really explore the full potential of Harmony blockchain, creating a wallet is the next step.

Creating a wallet (or ONE address)

  • Using onewallet or mathwallet browser extensions. Any other wallets can also be used.
  • Harmony CLI, also provides a quick way to create/manage wallet, interact with blockchain, etc.

Harmony uses bech32 address format with one1 prefix, however Ethereum style hex address can also be used. For example: one1pdv9lrdwl0rg5vglh4xtyrv3wjk3wsqket7zxy bech32 address is equivalent to 0x0B585F8DaEfBC68a311FbD4cB20d9174aD174016 hex address. Quick way to convert between formats is using explorer: https://explorer.harmony.one/#/address/one1pdv9lrdwl0rg5vglh4xtyrv3wjk3wsqket7zxy, at the top you will find "Address Format" ONE | ETH options.

Development environments

  • Several development environments exists: mainnet, testnnet, localnet​
    • We provide SDKs in several different languages. However most feature complete is our JavaScript SDK, which is the preferred language for DApp development.

Using SDKs to interact with Harmony blockchian

    • The most popular is our JavaScript SDK, which includes examples, documentation, and DApps developed in previous hackathons
  • Other SDKs include: Golang CLI, Java SDK, Python SDK
    • Note that, the Python SDK has only read-only features, meaning no transaction signing or smart contracts

How to deploy a smart contract on Harmony?

How to create a simple DApp on Harmony?

Resources

  • ​talk.harmony.one - for reporting issues, asking questions, or interact with other developers

Known Limitations

  • Only cross-shard native token (ONE token) transfers are allowed. No cross-shard for HRC20 or other contracts. Meaning, smart contracts are deployed on shard-0 and all contract interactions happen on shard-0. Contracts can still be deployed on other shards, however they won't be able to interact with contracts in other shards. We have cross-shard smart contract on our roadmap for Q3, 2021.