Introduction to SingularityNET Marketplace

The The SingularityNET Marketplace is a decentralized application (DApp), which lists the available AI services and helps you to interact with those services through web interface abstracting all the complexity in invoking a service. It also processes payment for services (through MetaMask/General Wallet) and conduct service ratings. Whenever a transaction happens on Blockchain, an event is created. The marketplace monitors all those events. For example, if you publish a new organization, a new service, the marketplace receives an alert notification about published information in the Blockchain. The marketplace reads the organization metadata, the service metadata and the stores this into its database. This application efficiently displays all the details quickly without relying on the slow performance of the Blockchain The following image shows the contents from the marketplace.

The decentralized application (DApp) does the following:

• Reads data from the on-chain Registry and pairs it with off-chain metadata. This allows for searching, filtering, and discovering AI services.

• Integrates the SingularityNET curation service, and displays from the registry. Whenever an event comes from Blockchain, the details are stored in the local database, the review process is done on that data, and then when approved, the information is made available in the marketplace. Note: Displays those services that have been vetted, and owners who have experienced due diligence and signed legal agreements that protects user and data privacy.

• Displays custom UI components for interactions with AI services. It enables you to quickly build the UI components and host the component on the platform, and also you can determine what inputs need to be chosen for service execution, and is the expected output, without understanding the complexity of knowing the gRPC protocol, the proto that is associated with the service and how to call the service and so on.

• Integrates with Multi-Party Escrow, to allow consumers to pay for service usage; Allows consumers to rate about the utilized services Note: This rating services will be part of the SingularityNET’s Reputation System (currently under development). Currently, it is very difficult to rate services on Blockchain. Therefore all rating mechanism are performed off chain and managed in the market place. So you can share your opinion and reviews at marketplace.

• Captures usage metrics at a consumer level.

Note: Although, the SingularityNET platform is open and decentralized, the Marketplace is the SingularityNET Foundation’s curated view. This allows the foundation to adhere to legal requirements of different legislative regions. Currently, the Marketplace and SingularityNET is in beta stage. For more information about the current status, refer to current status page for changes, or follow the git-repo

Marketplace Requirements

If you are a service author, for the service to be visible to others and listed on the marketplace you must:

1. Build and publish your service
2. Use SSL with the snet-daemon. Note: if you don’t already have an SSL certificate for your domain, it is recommend you use certbot and letsencrypt .
3. Fork the snet-dapp repo, build a react component as the user interface for your service, and submit a pull request. Note: Identify the services on your networks, organization and service names being used. For more details, refer to dapp repo README.md.
4. Last is some paperwork that we are still finalising, and we’ll update this list when we have that. If you are itching to get your service listed, reach out to us via one of our community groups. Note that your service can be published to SingularityNET without being listed on the marketplace, but your service may be less discoverable to potential customers if it is not listed.

Calling a Service

All complexity of invoking a service is abstracted from the users. For example it becomes easy for the user to Input the values that need to be sent and view the computed expected result in the Output field, even without knowing the complexity of the gRPC calls/generating signatures for authorization to call a service.

Please note that the the Marketplace offers a free trial version, where registered users can access service(s) for a specified number of calls.

Once your freecalls are exhausted , you will need to pay for any new calls to the service. for this you need need a wallet, some ethers in your wallet , some AGIX in your wallet

You can either pay through Metamask or through a General wallet(paypal)

• Select a Wallet -

Lets look at each of the wallet options in detail below

Using Metamask

Important: Metamask is a plugin which is used by the SingularityNET platform. This extension, allows you to perform the following in the context of the marketplace:

• Transfer AGIX funds into escrow,
• Setup payment channels to enable calls to any of the listed services.

As a first step you will need to Authorize the Dapp to connect to your metamask account

• Authorize Metamask -

Depositing tokens from Metamask to the Escrow Wallet.

Steps

1. Let start by depositing some tokens from Metamask to the Singularity Escrow Wallet. So you can pay for service
2. On the Home page click on Account link
3. Confirm you have sufficient balance in your Metamask Wallet
4. In your Account details, check the Total Balance, This is the number AGIX token you have in Metamask wallet
5. In the Manage your Escrow account section, Enter the amount of money you want to deposit to the Escrow wallet
6. Click Deposit. A Metamask Window should pop-up. If it Metamask Window does not pop-up, click on the Metamask icon on the top of your browser.
7. Check the transaction and click confirm.
8. Wait for the transactions to be mined.
9. This is two step transactions; you will need to confirm both steps.(Gas fee and Total)
10. Wait for the transactions to be mined again
11. Confirmation message show that the token has been deposited to the Escrow wallet
12. You might need to refresh if your token still appears as authorized.

If you dont have money on Escrow account, you will be asked to Deposit into Escrow Now click on Deposit

You need to confirm every Blockchain transaction when using metamask as your mode of payment

Based on the number of calls you wish to invoke ,select the option and the channel will be funded accordingly

Once the funds are in the channel, you are all set to invoke the service !

Using General Wallet

Select the ‘General Wallet’ Option

To call a service

1. View a list of service from the home page.
2. Filter the list by using the search text box.
3. Look for image recognition service
4. Click on Demo. This will take you to the corresponding service details page.

If you are using General Wallet and you have sufficient funds , you will see the continue button

1. Now you have the access to the invoke section of the service The interface will change according to the input need for each service.
2. Choose a Method to identify the service - An Image
3. After setting-up all that you need, click the Invoke button.
4. If you are using Metamask , then the transaction will need to be signed again using metamask before invoking
5. Wait for the response
6. You are now eligible to write a review

You can now continue to use the Service till you have sufficient funds before the expiry date of the channel

claim back the reserved fund

1. Go the Account page If there is any expired channel it displays under the Expired Channel Details section
2. Select the channel you want to claim
3. Click Claim Channel
4. Confirm this transaction on Metamask
5. Wait for it to mined Displays the message confirming that funds have been successfully claimed. Once you do this, the payment channel you claimed is unlisted.

Withdraw tokens from Escrow wallet to Metamask

1. Go to the Account page
2. In theManage your Escrow account section, select Withdraw
3. Confirm that you have sufficient funds in the Escrow wallet.
4. Enter the money you want to withdraw and click Withdraw
5. Confirm this transaction on the Metamask
6. Wait for it to be mined A message displays that the withdraw has been successful
7. Refresh the page to see the balance is updated. You will be able to see the token back in to your Metamask wallet.

Last modified on : 23-Apr-24