Getting Started - RIF Marketplace User Guide

Please read the Setup guide if you haven't.

Buy a domain

To buy a domain in the RIF Marketplace, a single transaction is involved. Let's start!

1- Go to the RIF Marketplace. Click on Name Services to get to the RNS Domains Marketplace.

UserGuide - Marketplace Landing

2- On the Name Services section, you will find a Search and Filter panel on the left, which allows you to look for a specific domain based on name and/or price. On the right side, you will see the list of available domains to buy, including details such as Domain Name, Owner, Renewal Date, and Price.

UserGuide - Marketplace Domains

3- Select the Domain you want to buy by clicking on the Select button. You will be redirected to the BUY confirmation screen, where you can review the order details and click on Buy Domain to proceed.

UserGuide - Marketplace Buy

4- Confirm the transaction on your wallet.

UserGuide - Confirm Transaction

5- Wait until the required amount of confirmations are received. A confirmation message will be displayed once the domain has been successfully purchased.

UserGuide - Domains Bought Confirmations Wait

UserGuide - Domains Bought Confirmations Wait Completed

Now you can click on Buy Another Domain to get back to the main Domain listing page. You can also login to the RNS Manager to manage and setup the domain.

Sell a domain

To sell a domain, two transactions are involved. Let's start!

1- Go to the RIF Marketplace. Click on Name Services to get to the RNS Domains Marketplace.

UserGuide - Marketplace Landing

2- Click on the SELL tab right above the filter panel on the left. This will redirect you to the list of domains you own, that are available for sale.

UserGuide - Marketplace Own Domains

3- Select the domain you want to list for sale and click on Select. You will be redirected to the SELL confirmation page where you can specify the Price for the domain listing. You can then click on List Domain to proceed.

UserGuide - Marketplace Sell

4- Confirm the 2 (two) transactions on your wallet. The first transaction is for the Approval of the Domain transfer, the second is the actual Placement transaction.

Confirm Transaction

5- Wait until the required amount of confirmations are received. A confirmation message will be displayed once the domain was successfully listed for sale.

UserGuide - Domains Listed Confirmations Wait

UserGuide - Domains Listed Confirmations Wait

Click on "View Domain Listings" to see the domain you have just listed, now available on the RIF Marketplace.

Cancel a domain

If you want to remove a domain which is listed for Sale, you can do that with two transactions. Let's start!

1- Go to the RIF Marketplace. Click on Name Services to get to the RNS Domains Marketplace.

2- Click on the SELL tab right above the filter panel on the left. This will redirect you to the list of domains you own which are available for sale. On the left, there are three options, select Your Offers

UserGuide - Marketplace Listed Domains

3- Select the domain you want to remove by clicking on X. You will be redirected to the CANCEL confirmation page. You can then click on Cancel Domain to proceed.

UserGuide - Marketplace Cancel

4- Confirm the 2 (two) transactions on your wallet. The first transaction is for the Disapproval of the Domain transfer, the second is the actual Unplacement transaction.

Confirm Transaction

5- Wait until the required amount of confirmations are received. A confirmation message will be displayed once the domain was successfully removed.

UserGuide - Domains Cancelled Confirmations Wait

UserGuide - Domains Cancelled Confirmations Wait Completed

Click on View Domain Listings to verify that the domain has been removed from the RIF Marketplace.

Offer Storage

To offer decentralized storage in the RIF Marketplace, you need to follow these steps:

1- Go to the RIF Marketplace. Click on Storage Services to get to the Storage Marketplace.

UserGuide - Marketplace Landing

2- On the Storage Services section, click on the SELL tab on the top section to submit your storage offer. Here, you will access the form to submit your Storage offer.

UserGuide - Marketplace Storage Sell

3- Complete the size in GB (total amount of storage you will offer) and your Pinning Service Peer ID which is obtained when initializing the RIF Storage Pinning Service. Once that is complete you can define multiple Billing Plans, each of them containing a price, a payment token, and a billing period (daily, weekly, or monthly). You can define different combinations and offer different Billing Plans for your storage offer, as shown below.

UserGuide - Marketplace Storage Sell Form

UserGuide - Marketplace Storage Sell Form 2

4- Submit the transaction, confirm it on your wallet and wait for the required confirmations to process the Storage Offer.

UserGuide - Confirm Transaction

UserGuide - Confirm Transaction

UserGuide - Confirm Transaction

5- Offers can be managed through the MY OFFERS section where you can access a list of existing agreements and withdraw the earned funds.

UserGuide - Marketplace Storage Withdraw

Once you click on WITHDRAW this will submit a transaction that needs to be confirmed in the Wallet and processed in order to get the earned funds.

Note: It is important to remark that during this Beta phase, Storage Providers need to be whitelisted in the smart contract so please contact us if you are interested!

Setup Pinning Service

1 - Go to the Marketplace Storage Sell page and start the creation process: RIF Marketplace Sell Page. You will see that your Rootstock address is not registered as a Storage provider yet.

RIF Marketplace Register Page

2 - That means you need to get whitelisted. Please submit the whitelisting request here: Whitlisting Form. While your request is being processed, you need to install the Storage Pinner application and generate a Peer ID. On the same page, click the ‘Get Peer ID’ link and follow the instructions.

RIF Marketplace Register Small

RIF Marketplace Installation Instructions

3 - During the package installation, run the init command. The pinner DB is instantiated for the given Offer ID and a new Peer ID is generated. You should have a result similar to this one:

rif-pinning init --offerId 0x8dc5758fff238ce129121031969dffd4a58a4e5f

Init DB... done
Set Offer ID... done
Generating Peer Identity... done
Your PeerId: QmYekG8Nkm1co9VxSLqCBnm9mxPYtabL1Q7emzU322KKdm

(Note: make sure your address/Offer ID is lower case)

4 - The URL may be displayed depending on the config which points to Marketplace and has the Peer ID as a parameter. Otherwise, navigate to the URL where you started: RIF Marketplace Sell Page and copy-paste the Peer ID generated in the previous step.

5 - After Creating an Offer you are ready to start the rif-pinning daemon and an IPFS node. To run an IPFS node, please refer to the IPFS documentation. To run the RIF Pinner with default configurations, execute the following in the terminal:

rif-pinning daemon --network mainnet
or
rif-pinning daemon --network testnet

This command starts listening for new Agreements, and connects to IPFS. By default, it expects the IPFS node to run on port 5001. If you want to customize rif-pinner daemon behaviour, execute:

rif-pinning daemon help

To perform any other tasks with the rif-pinner:

rif-pinning help

Application for providing your storage space to other to use in exchange of RIF Tokens

VERSION
  @rsksmart/rif-storage-pinning/0.2.2 linux-x64 node-v14.16.1

USAGE
  $ rif-pinning [COMMAND]

COMMANDS
  agreements    Agreements info
  cleanup       Cleanup pinner files
  daemon        Run pinning service
  db-migration  DB migration
  help          display help for rif-pinning
  init          Initialize Pinner service dependencies

Rent Storage

To rent decentralized storage in the RIF Marketplace, follow these steps:

1- Go to the RIF Marketplace. Click on Storage Services to get to the Storage Marketplace.

UserGuide - Marketplace Landing

2- On the Storage Services section, you will find a Search and Filter panel on the left, which allows you to look for a specific storage provider based on name, size, and/or price. On the right side, you will see the list of available providers to rent storage including details such as Provider, Storage system, available size, Billing Periods, and Price per GB per month.

UserGuide - Marketplace Storage Buy

3- Select the Provider by clicking on the Select button. You will be redirected to the BUY confirmation screen, where you can Upload files or Pin an existing hash.

UserGuide - Marketplace Storage Buy Upd

UserGuide - Marketplace Storage Buy Upd

Once the IPFS hash to pin is completed (either through Upload or Pin by hash) click on PIN to proceed to the next step where the Billing Plan will be defined and paid.

4- Select the Subscription period and the number of periods to prepay. This will create the required transaction to confirm the decentralized storage.

UserGuide - Marketplace Storage Buy Upd

5- Click on BUY and confirm the transaction on your wallet. Then wait for the required confirmations to get your files pinned successfully!

UserGuide - Confirm Transaction

UserGuide - Confirm Transaction

UserGuide - Confirm Transaction

Renew Storage

You can renew an existing Storage agreement by following these steps:

1- Go to the RIF Marketplace. Click on Storage Services to get to the Storage Marketplace.

UserGuide - Marketplace Landing

2- On the Storage Services section, click on the MY PURCHASES tab to see a list of your existing agreements. Find the one you want to renew and click on RENEW.

UserGuide - Marketplace Renew

3- Select the number of periods to prepay. This will create the required transaction to confirm the renewal of the decentralized storage.

UserGuide - Marketplace Storage Buy Upd

4- Click on RENEW and confirm the transaction on your wallet. Then wait for the required confirmations to get your files pinned successfully!

UserGuide - Renew Transaction

UserGuide - Renew Transaction

UserGuide - Renew Transaction


Github | Access the RIF Marketplace

Receive updates

Get the latest updates from the Rootstock ecosystem

Loading...