If you are a user that is brand new to EOSIO, or even new to Anchor, we have established this guide to help walk you through the first steps in setting up your first account using the desktop version for Windows, macOS, or Linux.
NOTE: Anchor currently does not support account creation, so make sure you have an account established before continuing through this guide.
Installing Anchor for Desktop
The first step is going to be to download Anchor itself to your computer. We have a wiki post established below that we’ll maintain with links to the current version of Anchor.
Setting up your first account
One you have the wallet downloaded and installed, you’re ready to launch the application. You’ll be greeted with this screen:
From here you’ll be able to setup a new wallet using the first button in the interface.
Alternatively, if you had a backup or are an advanced user using multiple computers to setup a cold/offline wallet setup, you can start the cold wallet setup using the final button.
NOTE: If at any point you need to start this process over again, you can go into the “Tools” section on the left navigation, and in the upper right there is a “Reset Application” button. Click this button will reset the entire application and bring you back to this step. It erases all keys, accounts, and settings from Anchor and will allow you to setup a brand new wallet by importing your keys again.
Anchor supports a number of EOSIO-based blockchains and the first thing we need to do is understand which chains you plan on using. Select the checkbox for each chain you’d like to use, or just select the one you want to get started with. The blockchains that are enabled can be changed at any point in the future - so don’t feel as if you have to configure them all from the start.
Once you’ve made your selection, click the blue “Enable Blockchains” button in the upper left.
Select a blockchain
Now that Anchor understands which blockchains you’d like to enable, now we need to select one to get started with. Click on the blockchain you’d like to start using to set it as the “Active Blockchain”.
You can also change which blockchain is active using the dropdown in the upper left, which in the screenshot below says “Select a blockchain”. This dropdown menu is available throughout the entire application and quickly allows you to change between different blockchains and accounts.
Setting up your first wallet
In the upper left dropdown, the EOS blockchain has been selected and it’s icon is now showing.
This next part of the setup process is where you’ll establish your wallets and connect to your account. We are immediately brought here after selecting the blockchain because no accounts have been configured. You can return to this interface at any time after you’ve setup your first account by clicking “Manage Accounts” from the account dropdown.
Within this interface you’ll click “Import Account”
Wallet Import Methods
Next we need to know how you’re planning on connecting this wallet to an account.
For the purposes of this guide, we will assume you have a private key for an account, in which case you’ll want to click the “Import Private Key” button.
NOTE: If you have an existing account already setup to use a Ledger, you’ll want to Enable Ledger Support, and then Load Keys from the Ledger to continue the setup process. This cannot be used to convert an existing account to use a Ledger device, only connect to accounts that are already associated with the Ledger.
Setting up a password
Once you’ve started to import a private key, we’re now interrupting the process because before importing any private keys, we need to establish a password for the wallet to use during encryption.
This popup will appear and prompt you to create a new password, and after submitting, confirm it.
Importing the private key
With a password configured, you can now import the private key to your account. Simply enter it in the text box and it will automatically attempt to retrieve any accounts associated with that key.
NOTE: This lookup is done by converting the private key entered into a public key, and performing a lookup against the public keys on the blockchain to find associated accounts. If you’ve changed the API server Anchor connects with, ensure one of the lookup APIs is available. This requires either an API running the v1 history plugin to perform a get_key_accounts lookup, or the new API available in nodeos 2.0.6 called get_accounts_by_authorizers.
Selecting the matching accounts to import
After the key is entered and account lookups are complete, you’ll now see a list of available accounts and permissions at the bottom. Check the checkbox next to each account you’d like to import, and click the green “Import Account” button towards the bottom once you’re ready.
You’ll be prompted to enter your password again (to encrypt the keys), and your accounts will be imported!
Enabling App Integration
The final prompt that appears after importing your first account is whether or not you want Anchor to listen for and be able to connect with external applications. Allowing app integration will allow “Sign-in with Anchor” type interfaces and allow a wide range of apps/dapps to send requests to your wallet.
This can be toggled on or off at any time from the home screen as well.
Welcome to Anchor!
Your account is now imported and you can now use Anchor as your wallet.
Where you go from here is up to you, but here’s a few quick tips on other things you could do from here:
- In the upper left, the blockchain icon dropdown lets you select which blockchain you’d like to use right now or configure/add/remove blockchains from your wallet.
- Also in the upper left is an account dropdown which will let you quickly switch between accounts. You can also use the “Manage Wallets” interface to add more accounts for the currently active blockchain.
- The navigation on the left can now be used to send tokens through the “Wallet”, manage staked tokens or rent through REX via “Resources”, or get involved in BP voting through “Governance”.
There’s a lot to Anchor and we’re continuing to work to make the experience easier to understand and more powerful. Check back for updates on the newest features, or join us here in the forums to discuss what we should change or get your questions answered!