Chromia Vault
Overview
Chromia Vault is a wallet that supports asset transfers within the Chromia ecosystem. You can use it to transfer any FT3 assets (Chromia equivalent of Ethereum ERC-20 and ERC-721 protocols).
However, besides just transfers, Vault has additional features like dapp account linking and browsing Chromia dapps. The dapp account linking feature allows you to Single Sign-On (SSO) into your dapp account using the Vault (the same way Google or Facebook login gets used to login into different websites) and to control your dapp account assets directly from the Vault.
This section describes how you can perform such actions on the Chromia Vault web app.
Access the Vault
Create a new account
Account creation is a 3-steps process.
- First, you have to choose the account name and password. The name and password aren't public and can only be used to access the account later.
After the account name and password fields are filled, clicking Continue takes you to a new screen showing 15 words (the mnemonic).
Printing out or writing down these words and storing them in a safe place is highly advised.
Knowing these 15 words in the correct order is the only way to retrieve the account if the password is lost or the browser history is cleared for any reason.
- After you have safely stored the words, clicking Continue takes you to a screen where you have to click (or drag&drop) the words in the correct order and thus confirm that you have stored the words somewhere.
When all words are specified in the correct order, the "Confirm" button is enabled.
By clicking Confirm, the account is stored in local browser storage, and you are taken to the Dashboard screen.
Access the account (login)
All created accounts are stored in local browser storage (on the device). Accounts are unlocked by a password that was selected while creating an account.
If you want to access an existing account on a device, you can use the Import Existing Account feature.
Import existing account
The import existing account feature is used when you want to access your account on other devices or forget your password, so you can't log in normally.
Importing an account is a two-step process.
- First, you are asked to provide the 15 words mnemonic from when you created that account in the correct order.
- On the next screen, you are asked to provide a name for the account and choose the password for it, which is used to access the account on that device from now on.
Dashboard
The Dashboard page is divided into three different sections: Chromia Accounts, Linked Apps, and Explore Apps.
Chromia accounts
Chromia Accounts are something that we usually call "main chain" accounts. There could be multiple Chromia accounts within one Vault account. Access to a Vault account allows access to all Chromia accounts beneath it.
Explore apps
Explore Apps section is an app explorer (Google Play / App Store equivalent) where one can browse and explore all the apps built in the Chromia ecosystem.
Linked apps
The Linked Apps section contains all the apps one has created an account for, which this Vault account controls.
Each dapp in the Chromia ecosystem has its own blockchain. Every account (that little Tile) on the dashboard represents a combination of blockchain and a specific account on that particular blockchain.
Tile is composed of two parts:
- Automatically generated squared image created from Blockchain ID.
- Automatically generated robo-icon created from the Account ID.
That means if you have multiple accounts on the same blockchain, they
have the same squared image, while robo-icon is the same for
the one accountId on different dapps.
Clicking on any of the accounts in the dashboard takes you to the wallet feature of the Vault, which is used to send/receive assets from/to that specific account.
Asset transfer (wallet features)
To access the wallet section, one needs to select the account from the dashboard first:
Assets
The assets section shows the list of all the available assets in that specific account.
Sending assets
Assets are sent from the Send Tokens tab of the transfer section.
The address comprises two parts - blockchain id and account id, separated by the semicolon. So, the address format is <blockhainId;accountId\>. You can either enter the address manually (copy/paste) or use a QR scanner to scan the QR code containing the recipient's address info.
Once the address field is populated, Application and Account are filled with appropriate hash icons automatically generated from the input address.
After the address is populated, select an appropriate Asset and Amount to send, and click Send.
Receiving assets
The address for this specific account is shown on the Receive Tokens tab of the transfer section.
There is also a QR code shown next to the address. Instead of providing the address itself, it's possible to provide a QR code that someone can scan and send assets.
Furthermore, besides holding address info, QR codes can also have Amount and Asset information. Whenever Amount or Asset fields are changed, the QR code gets updated.
When such a QR code (containing asset or amount info) is scanned from the Send Tokens tab, those fields are also auto-populated on the UI.
Transaction history
Transaction history is a table that shows the account's transactional activities.
It contains info about transaction type (sending or receiving), the account to which you've sent or from which you've received the assets (sender/recipient), along with some other information like which assets were transferred, the amount, timestamp, and so on.
SSO and app linking
Chromia Vault offers Single Sign-On (SSO) service for the dapps in the Chromia ecosystem. This allows users to log in to different systems (apps) using a single account. The app needs to integrate with the Chromia Vault SSO service to take advantage of this feature. Similarly, for Login with Facebook or Login with Google features, once Chromia Vault is used for SSO, you have to authorize the app in the system. For example:
