Skip to content
Snippets Groups Projects

Changes

Page history
  • New page
  • Templates
    • Rename cutecoin to sakia authored by inso's avatar inso
    Show whitespace changes
    Inline Side-by-side
    Sakia-getting-started-tutorial.md 0 → 100644
    View page @ 2de5be30
    > This tutorial was originally written here: http://forum.ucoin.io/t/tutorial-subscribe-to-the-testing-currency/143
    Install Sakia following the instructions [there.](https://github.com/ucoin-io/sakia/wiki/Sakia-install)
    # Introduction
    This subject will be our first tutorial of uCoin dealing with Community integration, using the first graphical client **sakia**:
    <img src="http://forum.ucoin.io/uploads/default/80/6462e33b9e2eeec3.png" width="690" height="388">
    This tutorial will cover the following steps:
    * Installing sakia
    * Creating your personal identity
    * Connecting to the network
    * Joining a community
    And in a second time, **one of the most important** action in uCoin:
    * Certificating other people (both members and *non-members*)
    Feel free to leave comments if you encouter difficulties, have suggestions, or anything else.
    Have fun! :)
    # Installing sakia
    ## Download
    Have a look at https://github.com/ucoin-io/sakia/releases. Choose the one that fits your own environment.
    > Here, we will consider the case of Windows (.exe) version that does not rely on any external library. Windows version can be used "as is".
    ## Launch
    Once download is finished, extract the resulting file. Inside the folder, you will find a *sakia.exe*. To launch sakia, simply click on this file. You should land on the above screenshot of sakia home screen.
    <img src="http://forum.ucoin.io/uploads/default/81/1c8632118e6cbbdf.png" width="690" height="388">
    # Creation of your personal identity
    In the menu, click on `Account > Add`.
    <img src="http://forum.ucoin.io/uploads/default/83/e02ff08074ddf8ca.png" width="690" height="305">
    In the screen that showed up, you will have to enter your personal identity name. In this example, I will put mine "cgeek". But you have to choose your own.
    > If you choose an already used UID, you won't be able to join the community. So ensure not to collide with someone else's UID.
    You should now have the following screen:
    <img src="http://forum.ucoin.io/uploads/default/85/9050a3ccadc388a4.png" width="417" height="276">
    Click on "Next". You will now be asked for data to constitute **your personal keyring**. You will be asked for 2 parameters:
    * Salt: we advice you to choose your personal e-mail as value for this field. But you can put any other value: it only has to carry enough entropy to avoid key collision. Typically, your personal e-mail is a good choice, added to the fact it is easy to remember.
    * Password: here, choose a **very strong** password, so no one can find it. This password **can't be changed thereafter**, so choose it carefully.
    > N.B.: you will have to **remember** these 2 values, salt and password. The keypair generated from these values won't be saved anywhere. It will only e in your head!
    You can click on "Show public key" to see the resulting key generated from your salt and password. Mine will be:
    <img src="http://forum.ucoin.io/uploads/default/87/1d4715e9bdcafa56.png" width="516" height="136">
    > This isn't my *real* public key, it is just for our example. ;)
    Click on next to generate both your key and your personal identity.
    # Connect to the network
    Right now, you should be on the following screen:
    <img src="http://forum.ucoin.io/uploads/default/88/16228420f72bcb56.png" width="419" height="279">
    To connect to the network, click on `Add a community` button.
    In the next screen, you will have to enter a network address + port. For our example, meta_brouzouf, I advice you to connect to a node I own:
    <img src="http://forum.ucoin.io/uploads/default/89/276db33eb20a7e2e.png" width="417" height="341">
    Click on `Next` to validate.
    You will be presented a new screen where you can add more known nodes from the network:
    <img src="http://forum.ucoin.io/uploads/default/92/9841d5e5986a7372.png" width="421" height="342">
    We won't add more in this tutorial. Click `Ok` to finalize. You should be noticed a:
    <img src="http://forum.ucoin.io/uploads/default/91/696f336d4882a685.png" width="479" height="151">
    Which means your newly created identity + key are not yet published on the server. Click `Yes` to make the publication. You will be asked for your password, which will be used for *signing* your identity:
    <img src="http://forum.ucoin.io/uploads/default/93/b0ccb0802f67bfaf.png" width="291" height="138">
    You should now have:
    <img src="http://forum.ucoin.io/uploads/default/90/7e2a92bdb2a7dadc.png" width="419" height="279">
    Click on `Ok` to finalize. You will again be asked for your password (dunno why). Enter it again:
    <img src="http://forum.ucoin.io/uploads/default/93/b0ccb0802f67bfaf.png" width="291" height="138">
    You should now be back on Home screen with some changes displayed:
    <img src="http://forum.ucoin.io/uploads/default/94/7645767548831888.png" width="592" height="500">
    If you reached this step, then your identity was successfuly created. Well done! ;)
    # Joining a community
    What you did was to create your identity. But to really join a community (and its currency), **you have to express your will** to join it.
    Doing so is easy as a pie: first, click on `Community` tab:
    <img src="http://forum.ucoin.io/uploads/default/95/251a0932ea82abd2.png" width="590" height="500">
    And click on `Send membership demand`. You should be asked for your password if did not checked "Remember my password for this session" earlier:
    <img src="http://forum.ucoin.io/uploads/default/93/b0ccb0802f67bfaf.png" width="291" height="138">
    and then, if you don't have any error message, then your membership was successfully sent.
    There we are: you are now eligible to join a community. However, you **won't** actually join. Why? Because you also need *certifications* for your identity made by other members.
    So now, you need to gather enough certifications, for example by asking them on this forum. And you may also yourself certify *others* so they receive certifications too. Follow next explanation to learn how.
    # Certify someone else
    ## A member
    If you want to sign someone that you know *is* a member, it will be super simple: first, go to `Community > Members` tab. Here, you will find the list of current members. All you have to do is to right click on the user ID you want to certify, and click on `Certify identity` to have the following screen:
    <img src="http://forum.ucoin.io/uploads/default/97/7d0f7525526d2105.png" width="417" height="258">
    Click on `OK` to finish the certification process.
    You will be asked your password:
    <img src="http://forum.ucoin.io/uploads/default/93/b0ccb0802f67bfaf.png" width="291" height="138">
    And then see the message:
    <img src="http://forum.ucoin.io/uploads/default/98/6a3dbe9a51c86baa.png" width="520" height="138">
    Of course, the public key won't be the same: you will have the one of the user you wanted to certify. :relieved:
    ## An ex-member
    This case is a bit trickier: you need to have the user ID you want to sign in mind.
    Have it? Good. Go to `Community > WoT` tab. In the search field, type this ID. For example, `cgeek`:
    <img src="http://forum.ucoin.io/uploads/default/102/382e0c26af2d5f52.png" width="590" height="500">
    If you type on the "Enter" key of your keyboard, the graph area should be updated to center on the user ID you typed. To sign it, right click on the ellipse of the user you want to sign and choose menu `Certify identity`:
    <img src="http://forum.ucoin.io/uploads/default/103/795e6e55b3c23cde.png" width="590" height="500">
    You should now have the following screen:
    <img src="http://forum.ucoin.io/uploads/default/97/7d0f7525526d2105.png" width="417" height="258">
    Click on `OK` to finish the certification process.
    You will be asked your password:
    <img src="http://forum.ucoin.io/uploads/default/93/b0ccb0802f67bfaf.png" width="291" height="138">
    And then see the message:
    <img src="http://forum.ucoin.io/uploads/default/98/6a3dbe9a51c86baa.png" width="520" height="138">
    ## Anyone, even a newcomer
    Go to menu `Actions > Certification`.
    <img src="http://forum.ucoin.io/uploads/default/96/ca88a8915bc24bbd.png" width="589" height="500">
    You will have following screen:
    <img src="http://forum.ucoin.io/uploads/default/97/7d0f7525526d2105.png" width="417" height="258">
    Choose `User public key` option and copy/paste (or manually enter) the public key of the individual's identity you want to certify. Click on `OK` to do the certification.
    You will be asked your password:
    <img src="http://forum.ucoin.io/uploads/default/93/b0ccb0802f67bfaf.png" width="291" height="138">
    And then see the message:
    <img src="http://forum.ucoin.io/uploads/default/98/6a3dbe9a51c86baa.png" width="520" height="138">
    Congratulations! You have just certified this key! :)
    If others do the same for your identity, then you might become a member of the community.
    # Conclusion
    There we are! We have been through the basic steps for creating an identity with sakia, express our will to join the community and learned how to certify one's identity.
    This topic will be edited several times to reflect the incoming new versions of sakia, which will be with no doubt, richer and richer each time to make our life easier.
    Let's make currencies!
    \ No newline at end of file