Step 1. Get some Ether
Ether is used to pay for interactions on the block chain (known as gas).
The transactions you make a call to SingularityNET are:
- Transfer AGI into the multi-party escrow account,
- Create a payment channel for a service published in the SingularityNET registry, and
- Transfer AGI into the payment channel and set the timeout
After that, you interact with the service directly and won’t need to pay for further transactions unless you want add more AGI or extend the timeout for the payment channel.
So how do you get Ether? The mainnet requires you to buy or mine it, but we’re going to use a test net for now. Specifically Ropsten.
Luckily for test networks you can go to a faucet to request some Ether for free.
To use the faucet you need to create a wallet, and then provide them with your wallet’s public address.
Step 2. Get some AGI
We provide a faucet to get AGI for either Ropsten or Kovan networks: https://faucet.singularitynet.io/
You’ll need a github account to authenticate, and there after you can request AGI every 24 hours. (TODO confirm this timeout period is correct)
Step 3. Make a Call from the Marketplace
TODO someone needs to step through with the final beta UI taking screenshots
Step 4. Setup the
snet CLI tool
snet CLI tool is your swiss army knife for working with SingularityNET. It lets you publish services, manage your identities, and query what AI services are available to use. If you are familar with cloud providers like Amazon or Google, this is our decentralised equivalent of their
You can install the CLI with pip:
pip install snet-cli
You then need to create an identity that matches your metamask account, since this is where the faucets sent all your test tokens too.
snet identity create YOURNAME key
You will be prompted for the private key for your wallet. To get this, click “Show your account details” on metamask, and “export your private key”. This will ask for your metamask password. Once you enter it, you can then copy your private key and paste it into the snet cli. Next, you should probably copy some meaningless text to your clipboard to avoid accidentally pasting the key somewhere it shouldn’t go.
WARNING: Your private key is like the password to your online banking. Be very careful with it. Anyone who has it can control where your funds go.
SingularityNET takes your security seriously and any vulnerabilities can be reported on our Github (if minor), or emailed to email@example.com
Step 5. Make a Call from the Command Line
snet client call ...
Step 6. Congratulations!
You’ve managed to set up your environment to interact with SingularityNET and call services via the marketplace and the command line.
While these ways of working with SingularityNET are very powerful (we’ve barely touched on all the things the CLI is used for), this isn’t how you’d necessarily want to build an application that is integrated with SingularityNET. To do that, we recommend that you learn about our SDK which is the next article in our Getting Started series.