BH Network — MVP Tutorial and FAQs

Thanks to the tools provided by the Elrond developers and the intuitive design and capabilities of the Maiar platform, the BH Network would like to present its Minimum Viable Product (MVP). This post will cover how to use the MVP to get the best understanding of the platform.

We will also explain the abilities and limitations of the MVP as it stands, including what is likely to change in future releases.

As with all cryptocurrencies, exchanges, and platforms, you should research before investing or spending money.

What is the BH Network MVP?

The BH Network Marketplace MVP is the first working version of the marketplace in production. We have included enough features for you to test and understand the core components of the marketplace functions.

As you work through the MVP, you will inevitably encounter certain aspects that do not work as you would expect and others that do not work at all. They are not flaws or faults. The BH Network has intentionally omitted them from the MVP to allow people to focus on our core link between Maiar and the Marketplace.

How to Login to the MVP Via Desktop or Laptop — A Complete Step-by-Step Guide

1. Visit The MVP Website

• The first thing you need to do is visit the MVP website: https://mvp.bh.network

This URL is only for the MVP and will not be the final URL.

2. Click on the Sign-In

• The sign-in button is in the top right corner:

3. Choose Log in Method

Here, the website will present you with three options:

1. Ledger
2. Web Wallet
3. Maiar Login

The easiest, safest, and fastest way to log in is through the Maiar option. We will use that for this article.

4. Click “Maiar” Login

5. Open the Maiar App on your Mobile Device

• If you do not already have Maiar, you can visit https://maiar.com from your device and click Download Maiar.
• Alternatively, you can search for “Maiar” on your provider’s app store.
• Follow the instructions provided by Maiar to complete the registration.

6. Open The Maiar App

• After you have got the Maiar App, open it as usual.

7. Log in to Maiar

• Enter the passcode or use your fingerprint to log in, if you have one

8. Open the Maiar Quick Menu

• After logging in, you need to click the menu button at the bottom center:

9. Select Wallet Connect:

• Simply press the Wallet Connect button.

10. Scan the MVP QR Code

• Using the Maiar App on your mobile device, scan the MVP QR code and click approve.

• You are now logged in to the BH.Network Marketplace MVP.

Please note that you will lose the connection and log out if you close the Maiar app.

How to Login Via Mobile

1. Visit the Website on A Mobile Device

• Go to https://mvp.bh.network on your mobile browser.

2. Click on the Menu Icon

• The menu icon is the three horizontal lines in the top right corner.

3. Click on Sign In

4. Click on “Maiar” Login

5. Click Maiar Login

• As you are on a mobile device, there is no requirement to scan the QR code.
• If you have the app, the website will redirect you to the login page of the Maiar app. From there, log in as usual, and approve the connection.
• Do not close the Maiar app.
• Return to your browser, and you will be logged in.

Frequenlty Asked Questions

Why Do You Need to Install Maiar?

Maiar is a highly secure and user-friendly, full non-custodial digital wallet and global payments app that allows you to exchange and store money on your mobile phone securely. Its innovative concept of Maiar Wallet Connect can be coupled with any dApp (decentralized application) built over the Elrond blockchain, offering personal key decryption and personal identification to allow passwordless entry to any connected site.

How to login with Ledger

1. Setting up Ledger

• Set up your Ledger device
• Download the Ledger Live application on PC
• Upgrade your device with the latest firmware‌

2. Install the Elrond EGLD App on Your Ledger‌

Teach your Ledger device to work with Elrond Network by installing the Elrond app on it.‌

• Open the Ledger Live application.
• Click on the “Manager” section in the app.
• Connect and unlock your Ledger device.
• If prompted, allow the Manager on your device by pressing the two buttons.
• In the App Catalog, search for “Elrond”.
• Click the “Install” button next to the Elrond app.
• Your Ledger device will display “Processing” as the app installs.

3. Turn Contract Data On

• Turn on the Ledger device.
• Access it using the PIN.
• Start Elrond app.
• Go to Settings > Contract Data > Yes.

Elrond EGLD instructions taken from the official Elrond post: eGold Is Now Officially Available on Ledger!

4. Log into BH Network Marketplace MVP Using the Ledger Device

• Make sure your Ledger device is connected to your computer.
• Log into your Ledger device.
• Navigate to the Elrond Network app & open it by pushing both buttons on your device.
• Navigate in your browser to https://mvp.bh.network/
• Click Sign In and Ledger option from the pop-up window.
• Click Connect Ledger.
• Choose the first address from the list and confirm*.
• Approve confirmation from Ledger device, too**.
• You are logged in.

Note: Currently, there is a Ledger firmware limitation, and only the first address can be used for SC signing messages.

Note: You will have to confirm any operation from the device.

Why Do We Need to Choose the First Root Address from the Ledger, not Secondary Addresses?

Due to a current Ledger firmware limitation, only the first address can sign Smart Contract messages.

What Data Do We Store?

For the MVP, the only data that we store are the test jobs that you create. Those jobs are stored on the blockchain and our off-chain database.

However, as we expect the creation of many test jobs, the off-chain database will purge approximately every hour — thus deleting all jobs except our examples.

How Do We Buy XeGLD?

There is no requirement or ability to buy XeGLD as it is a development token only used for checking services running on the Elrond blockchain. Therefore, there is no charge to obtain XeGLD, and there is no monetary value in it, either.

To obtain XeGLD, you need to use the Devnet faucet.

How to Top Up XeGLD?

At present, the only way to top up your XeGLD is through the Devnet faucet.

1. Click on the link above.
2. Enter your eGLD wallet address
3. Enter the desired number of DeGLD (Development eGLD)
4. Click CLAIM

This process may change if the Developers find a different way to distribute the development tokens.

Is XeGLD Real eGLD?

No, they are not real tokens, and they do not cost money. They are non-transferable into any other currency and do not show in your wallet either. These tokens are for development testing only.

Do I Need to Pay to Use Them?

No, the XeGLD development tokens are free.

Do I Need to Pay to Use the MVP Platform?

No, the MVP platform is free to use.

How do I Convert XeGLD to xBHAT?

• Sign In using Maiar/Ledger/Json+Password
• Click/tap the Buy xBHAT button
• Type the amount of XeGLD you want to change for xBHAT
• Confirm the exchange tx through the Maiar app, Ledger, or Elrond Wallet.

How Do I Post a Test Job?

• Make sure you have xBHAT tokens.
• Click/tap the Post Job button.
• Fill in the job details and the amount you want to “pay” for the task.
• Confirm the task posting tx through the Maiar app, Ledger, or Elrond Wallet.

Explain to Me Like I Am A Nerd

How Does The MVP Connect to the Blockchain?

To resolve the problems depicted in the second chapter of our whitepaper, we designed the entire marketplace to have a complete history and footprint in the Elrond blockchain.

To achieve that, the central core of our MVP is a dApp (decentralized Application) connected to the Elrond blockchain API. A dApp is a computer application that runs on a decentralized computing system. DApps are typically open-source, decentralized and in compliance with a specific protocol agreed upon within the community involved.

The Elrond REST API can be used by any application — dApp, desktop, or server — to interact with the Blockchain. The Elrond Proxy and the Node (Observer) are designed to expose the same HTTP endpoints, though this doesn’t always hold due to architectural constraints [2].

What Makes it Secure?

Web applications rely on the classical “username & password” credential and similar authentication methods, which are relatively easy to implement and familiar to most developers.

But you cannot compare these traditional methods with asymmetric EdDSA encryption. Blockchain public key cryptography offers superior security and privacy when compared to legacy authentication mechanisms. At the same time, it is a paradigm shift for developers, who often have to rebuild several components in their application to allow blockchain integration.

The Elrond dApp core components are built using React and Typescript. The npm package installs the library that helps any website and dApp owner to authenticate their users and execute Elrond blockchain transactions. Web Wallet, Maiar Login, and Ledger methods for authentication and transaction signing are included. You can enable all of them to allow users to sign in to your app using their Elrond ID and integrate blockchain transactions into your processes. [2]

How is the MVP Built?

According to the above chapters (2 and 3), the main app is the dApp using React and Typescript components, communicating with the Elrond blockchain via Elrond REST API.

Beside that, we strive for having our own decentralized infrastructure connected to Maiar servers and Elrond Blockchain. We have deployed our own wallet connect bridge [3] that connects Maiar client application with Maiar server. Both login and transaction signing works through our own decentralized bridge.

Also, we developed our own SC (Smart Contract) which our dApp interacts to. This SC is in charge with job requests management, bids, value/ratio of BHAT, BHAT amount per user. All this information is kept to SC storage level.

Why Do We Use a Database For Storage?

Blockchain was designed having next properties immutability, decentralization, enhanced security, distributed ledgers, consensus, transparency, and faster settlement in mind.
All these aspects impact the storage footprint size from both size/state and economical (it is not cheap to make writing transactions for big chunks of data to blockchain).

That’s why the user profiles (not the credentials — login is still via blockchain private keys) and the collaterals (images, big data around the jobs requests, etc.) are kept off-chain in a Database and correlated with the blockchain with the user’s public keys and jobs requests (every job request is with a footprint in the Elrond blockchain).

This unique mix at the design level is the best way to keep both the blockchain and the off-chain database properties (security + storage).

How Will the Smart Contracts Work Between Two Parties and How and When Will The BHAT Team Get Involved?

Today, we can replace the role of an escrow manager with an SC (smart contract), an unchangeable piece of code that lives on the blockchain. No one can alter any rules surrounding the exchange once on the blockchain. That gives both buyer and seller confidence that they won’t be cheated during the exchange. The buyer will send the funds to the SC storage, and the seller will send a request ID to the SC storage signaling the project is ready. (The ID will be synced with the delivered project and sent to the off-chain database).

However, an escrow SC needs to have a 3rd party — the auditor. They will verify if the seller delivered a real project and is not a scammer. If everything is ok, the auditor approves the swap — the seller will receive the funds, and the buyer will receive the project. Considering the manual job that needs to be audited by a 3rd party player, this is a paid service. The escrow SC will only be used if the buyer and seller request (e.g., essential projects where security is mandatory).

References

[1] https://docs.elrond.com/sdk-and-tools/rest-api/rest-api
[2]https://elrond.com/blog/elrond-authentication-signing-dapp-core/
[3] https://github.com/walletconnect/walletconnect-monorepo

Find us on: https://linktr.ee/blackhatnetwork