Skip to content
Permalink
Fetching contributors…
Cannot retrieve contributors at this time
executable file 249 lines (145 sloc) 16.9 KB

Lunie.io Guide

Lunie.io is a user friendly Web-Wallet, open-sourced under Apache License and endorsed by official Cosmos Hub webpage.

For the consistency of this tutorial we recommend using up to date Google Chrome Browser. It's also important that when following this or any other tutorial you make absolutely sure that all websites you access including https://lunie.io is using a secure connection.

Table of Contents

Accessing Wallet

Currently only way to access your account is by using Ledger Nano S hardware wallet, if you do not have one visit Official Manufacturer Website and acquire one, otherwise you will not be able to continue with this tutorial.

Ledger Nano S

Cosmos App Installation

Before you begin to install Cosmos App on your Ledger Nano S device make sure you downloaded and installed Ledger Live Application on your Mac, Windows or Linux operating system.

  • Start by plugging in your Ledger Nano S device into USB port of your PC, typing in pin, opening your Ledger Live Application and Entering your password. Once this step is done you should be presented with following window:

  • Enter Settings By clicking a gearbox in the top right corner of the Ledger Live window.

  • After entering settings window click on the Experimental Features Tab

  • Within Experimental Feature tab:
    • 1. enable Developer Mode by switching a checkbox to blue,
    • 2. make sure a blue "Experimental feature" tag is lighting up right after in the top of your window informing you about enabled mode, then
    • 3. Click a Manager label in the Menu located on the left side of the window.

  • Follow instructions to connect your ledger, navigate to dashboard (using ledger) and allowing Ledger Live application on your device.
    • 1. Make sure your ledger device is updated to latest version (1.5.5 or higher), if its not you should see a Firmware version x.x.x is available [Update] notification, in such case follow official support upgrade instructions (mirror).
    • 2. In the App catalog search textbox type Cosmos, then
    • 3. press Install button and follow instructions on the screen

WARNING: Always install latest version of the Cosmos App (currently 1.5.0), but at the time of reading it might already differ, if you do not see the version of the app that you were suggested is latest make sure that you Updated your ledger first to latest firmware. In case where you see many different 'Cosmos' apps for example COSMOS and Cosmos pick the one with latest version below it's name. If you already have COSMOS App installed (for example version 1.3.x) you have to remove it before installing version 1.5.x or later.

  • As the result your Ledger Nano S should have now installed Cosmos app, which you can find in the main menu.

Depending whether or not you initialized your ledger with fundraiser seed phrase as per our CLI Guide you will have access to your funds or freshly created empty wallet, ready to use with Lunie.

Sign In

Signing in to lunie.io allows you to access your wallet and begin interacting with Cosmos Hub, that is preview balances, stake your ATOM's, participate in governance processes and send transactions.

  • Before you begin you have to open previously installed Cosmos App on your Ledger Nano S. Your device screen should then look as on the image below displaying Tendermint Cosmos string, otherwise you will encounter Cosmos app is not open on the Ledger notification later on (in your browser).

  • Enter https://lunie.io website in your browser, then
  • Click in top right corner on the Sign In button

  • After clicking a Sign In button you will be presented with two options, Sign in with Ledger Nano S and Sign in with Address. You should select and click on Sign in with Ledger Nano S option.

  • You should be then presented with a Sign In window and another Sign In button in the bottom right corner of the popup. You can now click the Sign In button within a Sign In popup window to access your account.

  • In case of connection issues where you encounter Ledger not found message please follow an official Ledger Support article: https://support.ledger.com/hc/en-us/articles/115005165269 (mirror). Also make sure that your device didn't went into automatic sleep mode and exited the application, and that you entered COSMOS App as suggested by a first step of the Sign In process.

Delegating

Delegating ATOM's, that is staking tokens of Cosmos Hub allows you to claim block and fee rewards. In order to claim rewards you have to first delegate them to your validator of choice and then claim them by sending a withdraw transactions.

Ledger Nano S

This section explains how to delegate your ATOM's to your validator of choice using Ledger Nano S hardware wallet. Before you begin make sure you Signed in.

Validator View

In order to delegate your coins you can start by selecting an active validator (green bubble next to Moniker) from the Validator Tab in the Staking view of the Luni webpage. Once you click on the Moniker of your validator of choice, for example Bity.com you will be presented with following view:

Validator View helps you discover and verify informations about your validator. Note that it is not guaranteed that validator with familiar Moniker is the validator you really want to delegate your coins to, so to be absolutely sure you have to verify his Full Operator Address, in case of Bity.com that address is cosmosvaloper1uv26ytrnmydyctq0s58ve2k6wn2p653mqs80fm. Always take note of the Full Operator Address when delegating as you will have to verify it on the screen of your Ledger Nano S device later on.

Now you should be ready to proceed and delegate your ATOM's

  • In the top Right corner of the Validator View you should find two buttons: Delegate allowing you to stake your coins to a validator identified by the Full Operator Address and Undelegate that you can use when unbonding stake from your validator.
  • 1. Click Delegate Button which cause Delegate popup box to appear, then
  • 2. Set Amount value to amount of ATOM's you wish to delegate to your validator. The smallest value you can enter is 0.000001 ATOM, that is 1 micro ATOM. Note that Amount you should enter is specified in unit of ATOM's not uatom's like in case of CLI tools. If you enter incorrect value you should see an error notification stating Amount must be between 0.000001 and XXX. You can't delegate more then amount of Available ATOM's you can see in the first section of the website.
  • 3. After specifying Amount click a Next button within a Delegate popup box.

  • Next section of the Staking popup that will appear will be a verification view informing you about how much of atoms you will delegate to a validator - a Subtotal and a Network Fee - that is amount of atoms you will have to pay to the network to process your transaction. Note that you can't send more then your entire balance Available ATOM balance! that means maximum amount you can send is Available ATOM minus Network Fee, we recommend that you delegate such amount so that you will have at least one ATOM remaining. If you decide not to follow this advice you might end up locking your account (not being able to transfer your coins due to not enough Available balance to execute any transactions) or having your transaction fail.
  • After verifying correctness of your transaction input click Next button on the bottom right of the Delegate popup.

  • Last view of the Delegate popup presented to you is submission section
  • Click a Submit button on the bottom right of the Delegate popup once you are ready to proceed.

  • Delegate popup will display a Please verify and sign the transaction on your ledger after which you will have around a minute to verify and sign transaction using your hardware wallet, otherwise you will get navigated back to Submit section and will have to click Submit button again then verify transaction before timeout occurs.
  • On your ledger screen you should verify following information
    • Section 01/09 - if chain_id is the same as chain id in the Network Explorer view, currently cosmoshub-2
    • Section 04/09 - maximum fee amount that is gas * amount, note that denomination uatom means values are displayed in micro ATOM's on the ledger screen that is 10^-6 (1 ATOM equals 1'000'000 uatom's).
    • Section 06/09 - message type should be cosmos-sdk/MsgDelegate
    • Section 07/09 - is the amount of atoms you will be delegating to your validator
    • Section 09/09 - is the validator address, you have to click both button on the Ledger Nano S to preview it, you have to make sure this address is the same as previously noted Full Operator Address, for example cosmosvaloper1uv26ytrnmydyctq0s58ve2k6wn2p653mqs80fm in case where you wished to delegate your atoms to Bity.com.
  • After verifying correctness of transaction on the screen of your ledger device you will be presented with option to View transaction again or Sign transaction. Navigate to Sign transaction and press both left and right buttons to sign.
  • After signing a transaction ledger screen will go back to main menu of the COSMOS App and Delegate popup will continue to display pending status. You have to patiently await around 30 seconds after which your transaction will be submitted and Successful delegation popup message displayed.

Navigation

Lunie.io allow you to navigate into following sections

  • Network - landing page with simple explorer, network statistics and latest blocks
  • Transactions - preview of transactions such as transfers, delegation, undelegations, redelegation and other on-chain activities.
  • Staking - preview of your delegations, validator list and network parameters

Wallet

Wallet View to which you can navigate after signing in allows you to send transactions and await their competition status later on.

Transactions

Transactions View to which you can navigate after signing in helps you preview all on-chain activities relevant to your cosmos account. Each transaction is a separate row and informs you about amounts, type of action, time and block number where transaction was included and network fees paid.

Staking

Staking View to which you can navigate after you signing in enables you to access three sections Validators, Parameters and MyDelegations

My Delegations Tab

Presents you a list of validators you are actively delegating your coins to as well as list of pending undelegations.

Validator Tab

Allows you to discover list of active and not active validators. You can order this list in 6 different ways:

  • Moniker that is a friendly name.
  • My delegations that is number of atoms you delegate to specific validator.
  • Rewards you have earned from that validator, Validator's `Voting Power.
  • Commission how much validator charges his delegators off their rewards for delegating to him.
  • Uptime how well is given validator performing in the task of signing and proposing blocks thus earning rewards for his delegators.

Parameters Tab

Is a view informing you about "cosmological constant" in regards to staking and consensus, that is

  • Current Staking Token - name of a staking token,
  • Duration of Undelegation Period - that is time required to access / transfer your atoms after they were undelegated from a validator you have chose to delegate your coins to.
  • Maximum number of validators - how many validators from the total list presented in validator tab can participate in consensus and earn rewards for themselves and their delegators.

Governance

Governance View to which you can navigate after you signing in enables you to preview all on-chain proposals via the Proposals Tab and Parameters Tab in regard to proposals. Final utility of the Governance view is option to create proposals.

Proposals Tab

Helps you to view and sort network proposals vy following properties;

  • Title - Name and short description of the proposal
  • Proposal Id - Proposal identifier
  • Yes - Percentage of yes votes wishing to accept proposal
  • No - Percentage of no votes, wishing to reject proposal
  • No with Veto - Percentage of votes strongly opposing to the potentially harmful proposal
  • Abstain - Percentage of votes that acknowledged proposal but do not want to take a side

Parameters Tab

Is a view informing you about "cosmological constant" in regard to governance processes, that is

  • Minimum Deposit - minimum deposit that has to be paid for the proposal to be voted upon
  • Maximum Deposit Period - amount of time within which deposit must reach Minimum Deposit amount
  • Threshold - Percentage of yes votes requiring for proposal to pass
  • Quorum - Percentage of all tokens that has to be used to vote upon proposal for it to become accepted or rejected
  • Veto - Percentage of No with veto votes required to reject a proposal
  • Voting Period - length of voting period.

Network

As of time of writing this guide a Network Explore is a lading page of the lunie.io. After you signed in you should be presented with a following view.

  • First section allows you to preview your Total ATOM that is entire balance secured by your wallet, Available ATOM refers to amount of coins you can transfer and Rewards to amount of accumulated stake you can claim.
  • Second section presents you a Chain Identifier (currently cosmoshub-2) and basic informations about the chain such as number of transactions, number of validators, block height, time since last block as well as total number of liquid / transferable and locked / delegated ATOM's.
  • Third section is a descending list of recent blocks on which you can click and explore transactions that were addedd to the blockchain (for example #197,602).
You can’t perform that action at this time.