User Guide

From Status Wiki
This is the approved revision of this page, as well as being the most recent.
Jump to: navigation, search

Getting Started

Welcome to Status! This is Ethereum, anywhere. Ethereum everywhere. A world computer in your pocket. It is so many cool and amazing things that is difficult to know where to start, but I suppose we’ll just begin at the beginning.

Once you have downloaded the app, installed it and opened it, it should take you into a chat with Console: a DApp that lives inside status and lets you set up your account and control all the important stuff (as well as a bunch of other rad features, which we will get to in good time). If you'd like to restore an old account, you should see that option near the top left, and it will take you to the sign in screen, where you'll need both your 12-word seed phrase and password you used to create the account you're wishing to recover.

Image 01.png

As you can see, I have already been chatting a fair bit with Console (friends, yay!!). When setting up a new account, Console will send you an "Action" message, requesting that you set up and confirm a password. Once submitted, it goes off and does the crazy math required to generate your account. The UI concept here is that when someone sends an action message requesting (in this case) a password, or money, or a confirmation code etc., you can tap the message and it will insert the appropriate syntax to respond to that request, followed by your input. It's all about making interacting with these new technologies as intuitive and easy as possible.

One other thing to note is the ‘Available’ beneath ‘Console’ in the top left. This means that my phone has synced with the ropsten testnet (Status defaults to Ropsten, but you can also switch it to the Rinkeby testnet under 'Settings'). I am running android 7.0 and am doing so over wifi. It took just under 40mins for me to sync from scratch, though there are varying reports coming in depending on phone, OS and network differences. Still, ~40min sync time on a mobile is just insane. Thanks to Zsolt for the amazing work on LES.

You can optionally give your phone number to help status sync with your existing contacts. This is not mandatory (we're all about privacy if you are) and the app will work fine without it. Note that if you run into any issues, you can just shake your phone and this should bring up a screen that allows you to submit an error report directly to the status team. You can select from the options what you want to do, but generally it seems best to `Report a Problem`:

Instabug1.png

You should be able to select a colour to indicate the severity of the issue on the second screen above. I really want to make sure that Jarrad, Carl and the crew are on their toes, so I have gone for red here. Hitting the forward button (top right) should take you to where the magic really happens.

Instabug2.png

Please note the `Take a screen recording` button in the bottom left. This is how the team prefers you to submit bug reports as it is enormously helpful with seeing exactly what went wrong and so providing insight into where to go to fix the issue. You can enter your email, take a video and go ahead and submit. At which point we issue you a massive thank you for being such a stellar alpha tester. Go you!

Instabug3.png

Actually Using the App

OK, now that we have the setup out the way, we can get into the really fun stuff. Once you have generated your account with Console, you can open either testnet faucet (depending on which network you're on) to get some shweet test ether into your account so that you can go out and convince actual people to be your friends too. Please do not open an issue if this doesn’t happen - we can’t convince people to like you (even if you do use the best tech around).

To open the faucet, tap the hamburger menu to the left of the chat box, or just select the '/faucet' option above the keyboard input. Select the 'Status Testnet Faucet' and hit the blue arrow to send the message. You should get a message back saying 'Faucet message has been received', and some test ether should arrive shortly in your wallet.

Image 02.png

Seeing as we’re now finished chatting to Console for the moment, we can hit the back button and this will take us into the Chats page:

Image 03.png

Here you can see all the lovely people that you have been chatting to. It’s really straightforward and intuitive, so behave as you normally would in WhatsApp or WeChat etc. Tapping a conversation will take you into it, and you can use the bottom three tabs to navigate through the Wallet, Chats, Discover and Contacts screen. You can also just swipe right. Just do you.

Wallet used to be a DApp that lived in your contact, but we have abstracted it away into its own native screen as we get closer to Beta and start testing ERC20 token support, sending, receiving and exchange functions and a bunch of other, visually-stunning ways of showing you the value you control through Status. Swipe left from the contacts screen to have a look around and see if your test Ether from the faucet has arrived.

Image 04.png

Obviously, you want to be able to transact from the Wallet, so get a friend's address and see if you can send them some Ether. Hit the Send button and follow the prompts through our beautiful new transaction screens. You'll see that Status asks for permission to access your camera, but you only need to grant this in the case that you want to scan someone's QR code. If you have an ETH address already copied, or would like to send directly to one of your contacts in Status, you can safely deny this permission and carry on along to select a different option.

I had an address copied to my clipboard, so selected that option and then input an amount of 0.01 ETH to send to that address:

Image 11.png

You'll be asked to use your password to sign the transaction and, once you have done that, you should see this Success screen. We have been extra cautious and advise people to wait for at least 12 confirmations before being absolutely sure that the money has been sent. Future versions of the wallet screen will make it much more obvious how many confirmations each transaction in your history has. Make sure to explore the rest of the wallet and go and take a look at your transaction history to see what I mean here. There's still a host of features to come, but this should be more than enough to whet your appetite and show you what is possible from nothing more than a mobile phone.:

Image 12.png

Ok great, we can send transactions, awesome! If you now hit 'Got It', navigate back out of the wallet view and swipe right twice, or select the Discover tab at the bottom, you will get to the Discover page:

Image 05.png

Discover is going to be one of the most crucial aspects of our product going forward. This is the gateway through which you can find other contacts and contracts on a decentralized network that are relevant and interesting to you. Think of it like PageRank for the distributed computing age. In Discover, you can see hashtags people are using and discover all the different conversations going on. Swipe right through the cards to see the most popular categories, or scroll down to see the most recent updates.

If you want to make a message of your own appear here, you need to hit the hamburger menu in the top left there and edit your status with the hashtag you want to see appear here. Start a meme or hop onto an existing one - it’s all up to you. You can also edit your name there, unless you're amused by the anonymous handles we assign by default. Here, I have updated my status to reflect the work being done on the wiki, and changed my name to my preferred online handle:

Image 06.png

If you would like to make further changes to your profile, tap the 3 dots to the right of your name and avatar. Your profile page should look like the below. Here, you can see account and device info, switch between different test networks and show off a QR code if you ever need someone to be able to scan your address info quickly.

Image 07.png

Tap your editable status field in order to edit your status again, change your name, or upload a cool profile pic. Remember to include that hashtag if you want it to appear on the Discover page.

Once that is all done and you’ve broadcast a status for all the world to see, hit the back button and navigate to the Contacts page. Here, you will find a full list of the people and DApps you have connected with through Status. Don't stress though, a bunch of DApps also appear there by default so you don't feel lonely at first. You can see that we have split them into two groups for ease-of-use - the State of the DApps and just normal DApps. State of the DApps are optimized to work well with Status and provide a really slick, intuitive UX:

Image 08.png

These DApps all work in essentially the same way as Console - you can open a chat with them, which will direct you to an in-app browser that displays whatever is appropriate for that app. If no in-app browser opens, that means the DApp has been built into a chatbot and should provide you with a bunch of options for interacting with it in the form of '/suggestions' above the keyboard input.

If you close your app or otherwise have an issue, when you reopen it, you should be directed to a screen which looks like the below. Select the account that belongs to you (in the case where you set up more than one) and then put in the appropriate password and you should get back to the chat screen:

Image 09.png

If that doesn’t work for you or your account doesn’t appear like mine, hit the `Recover access` button at the bottom of the first screen and follow the prompts to input the 12 word passphrase console gave you when you first set stuff up and your password.

Happy sailing!

For the Adventurous

We’ve covered all the basic functionality as it stands, but there is so much more that you can do with status. Most of this stuff will only become available in the beta release or after, but developers around the world should be getting really excited to start building dApps to live alongside Flight Delays and Maker etc.

Though it is by no means complete yet, you can do a lot more than just set you account up using Console - it is, after all, a full dApp of its own. Go back to that chat and type `web3.` (the fullstop is important) and `web3.eth.`:

Image 10.png

You should be able to see a whole bunch of suggestions for the sorts of things you can do directly from Console, the most basic of which is `web3.eth.blockNumber` which will return the current block number on the testnet you are on. If this doesn’t blow your mind, I’m not sure what will...

If you want to dive in even further and help develop the app, contribute some code or otherwise get involved in the technical side of things, here are the links you need:

1) How to build Status yourself.

2) The latest nightlies for those with Android phones or Genymotion running (much easier than building): http://artifacts.status.im:8081/artifactory/nightlies-local/

3) Our API documentation so you can figure out what '/debug' does and how to build your own DApps and chatbots.