Program description

P2P Exchange dApp provides the user with the opportunity to buy or sell cryptocurrency at a lucrative rate without the involvement of intermediaries. The service acts as a crypto-asset exchange with a mechanism that ensures all transactions are carried out directly between two parties involved in the exchange (the general view of the interface is shown in Figure 1).

Figure 1

Terminology

How P2P Exchange dApp works

If user A has a certain amount of tokens that he wants to exchange for other tokens on their own terms, they need to create an offer. This offer will be automatically added to the general offer board (section “All Listing”). User B responds to this offer and creates a deal with user A. After creating a deal, user’s B tokens that they indicated for exchange (when creating a deal from the wallet connected to the Platform) will be automatically withdrawn. These tokens will be deposited into the underlying smart contract of the transaction.

User A will see this trade in the “My Trades” section in the “Open” subsection. If they intend to make a deal, then they must confirm it. In this case, their tokens will be automatically withdrawn from the wallet connected to the Platform, and the tokens of user B will be credited to their wallet. The deal will be considered closed and will occur in the “Closed” subsection. At the same time, User A’s tokens will be credited to User B’s wallet, and the transaction will be considered closed.

If user A does not want to confirm the transaction, they can either ignore it, wait until the end of the specified period, or cancel. User B can cancel the deal at any time and withdraw their tokens from the smart contract if user A failed to confirm it or the deal has expired.

Important! Before executing the steps mentioned in this section (and any other sections of the Platform), the user needs to make sure that his/her wallet is connected to the Platform. In this guide, MetaMask will be used as an example.

Using P2P Exchange dApp

Getting started with P2P Exchange dApp

In order to buy or sell cryptocurrency at a favorable rate without intermediaries, the user needs to go to the “dApps” section of the Platform (Figure 2).

Figure 2

In this section, the user can see 3 different dApps:

This document will cover the use of only the third dApp — P2P Exchange.

To start working with the P2P Exchange dApp, click on the Open button (Figure 3).

Figure 3

A window of the wallet connected to the Platform will pop up, here the user need to confirm the action by clicking on the Sign button (Figure 4).

Figure 4

After confirming the action, the P2P Exchange dApp interface will be displayed and the user are ready to use the dApp (Figure 5)…

Figure 5

On the P2P Exchange dApp interface the user can see the following sections:

Each section will be discussed in more detail below.

How to see the list of all active offers

Figure 6

When the user click on the All Listing button, a list of active offers will appear (Figure 6), the information which is arranged in the following order:

When choosing an offer, the user can start a correspondence with the seller (the Chat button in the far right column) or start making a deal (the Acquire button in the far right column). Each step will be covered in more detail in other sections.

To view other available offers, the user needs to navigate between the pages (in the lower right corner of the interface — Figure 6).

For convenience, the user can sort offers (in the upper right corner of the interface — Figure 7) by the following parameters:

Figure 7

How to create/change username

In order to see the username instead of the wallet address in the offer (in the Trader column — Figure 8), the user must click on the purple ⚙️ button (upper right corner of the interface — Figures 6–7).

Figure 8

After a line for entering a username will appear (Figure 9).

The user can choose any name not occupied by another user (Figure 10) and containing any letters, numbers, or symbols “-” and “_”.

Figure 9
Figure 10

To save the entered username, the user needs to click on the Confirm button.

The username can be changed at any time. To do this, press the purple ⚙️ button again (upper right corner of the interface — Figures 6–7). Then the user needs to save changes, and the updated username will automatically appear in all offers.

How to create a new offer

When the user click on the Create Listing button, a window will appear in which the user can create a new offer (Figure 11).

Figure 11

To create an offer, the user must enter the data in the appropriate lines:

Figure 12
Figure 13

If the user selects My token, a new line will appear for entering the token address (ERC-20 or BEP-20 — depending on the network (Figure 14).

Figure 14

2) What do you want to receive? — in this line, the user must specify the token that they want to receive in return. The selection of the token is carried out by analogy with the previous line.

3) Min amount / Max amount — in these lines, the seller must specify the minimum and maximum amount of tokens that they want to sell. The selected range will be indicated in the Limits column (Figure 15). It is important to note that this range is not a condition of the transaction and is only for informational purposes (the number of tokens for exchange can be negotiated by the user additionally when interacting with the counterparty).

Figure 15

4) Define your offer — in this line, the user must specify the price for the token that he/she wants to sell. For example, if a user wants to give NBU tokens and receive GNBU in return, they can put “5” in this line, and then the price will be determined as 1 GNBU for 5 NBU. It is important to note that this range is not a condition of the transaction and is for informational purposes only.

5) Cross offer — the price of the token that the user wants to receive in return is calculated automatically (reverse rate).

There are two buttons at the bottom of the window (Figure 16):

Figure 16

How the user can see the list of their offers

When clicking on the My Listing button, a list of offers created by the current user will appear (Figure 17).

Figure 17

The information in this list is arranged in the same order as in the “All Listing” section (except for the buttons in the last column):

The Actions column contains three buttons:

If the user has a lot of created offers, then to view all of them it is necessary to navigate between the pages (in the lower right corner of the interface).

How to create a new deal

Figure 18

When clicking on the Create trade (Figure 17) or Acquire (Figure 6) button, a window will appear (Figure 18), in which the user can create a new trade.

To create a deal, the user must enter the data in the appropriate lines:

If all the lines are filled in correctly, the user needs to click on the Create trade button. After that, the created deal will be reflected in the “My Trades” section in the “Open” subsection (Figure 19) for both counterparties.

How the user can see a list of his/her open and closed deals

The “My Trades” section consists of two subsections (Figure 19):

Figure 19

Each subsection will be discussed in more detail below.

Figure 20

The information in the list of open trades is arranged in the following order:

The last column contains buttons that change according to the status of the deal (Figure 19):

If none of the counterparties has added tokens to the deal within the specified period or any of the counterparties have canceled the deal, then it is considered closed (it moves from the “Open” subsection to the “Closed” subsection).

If one of the counterparties has added/deposited tokens to the deal, and then the deal expires, then it goes to the “Closed” subsection for the counterparty who did not have time to deposit tokens within the specified time period, and remains in the “Open” subsection for the counterparty who contributed tokens. For this user, the Cancel and withdraw button appears so that they can withdraw his tokens from the transaction.

2. The “Closed” subsection contains all completed (closed) deals of the current user (Figure 21). The information in the list of closed deals is almost identical to that in the list of open deals: the Actions column is replaced by the Status column.

Figure 21

Possible status scenarios and meanings:

How the user interacts with counterparties

To interact with counterparties the user should go to the “My Chats” section (Figure 22).

Figure 22

This section has three filters (Figure 23):

Figure 23

The information in the chats list (Figure 24) is arranged in the appropriate order:

Figure 24

The Actions column contains two buttons:

When the user clicks the Answer button, they are moved/transferred to the chat window (Figure 25).

Figure 25

The chat with the user contains the following information:

DAO-governed platform that offers 16 earning strategies for users boosted by multiple layers of risk-management. https://link.nimbusplatform.io/medium