Getting Started
The purpose of this tutorial is to give a general overview of Avalanche and to serve as a starting point for new users to the Avalanche ecosystem. General knowledge of cryptocurrency is assumed, and in particular familiarity with the Ethereum ecosystem. If you don't understand something right away, that's OK. Search for an answer online, and if you don't find it, ask on our Discord.
We recommend reading this document entirely before using Avalanche so that you can avoid common pitfalls and problems that new users run into. There are many facets of Avalanche, so it's best to get a full picture of things before diving in to save yourself confusion. Also, this guide contains tips and warnings to help you avoid falling victim to scammers.
You can find a general overview of Avalanche here. It will be useful in understanding similarities and differences between Avalanche and other platforms.
AVAX Token and Fees
All fees on Avalanche are paid in the native token, AVAX, so you'll need some in order to interact with the Avalanche network. You can get it through exchanges. Another way to acquire AVAX is via credit card purchase on Pangolin. Other ways are explained below.
If you use the Avalanche Bridge to transfer assets to Avalanche, you will need some AVAX to move/swap your assets. The Avalanche Bridge provides an airdrop of AVAX to users who transfer more than a certain value of assets to Avalanche. Use this AVAX to swap some of your bridged assets for AVAX so that you can pay future transaction fees.
Wallet
An address can hold a balance of cryptocurrencies. A wallet controls a set of addresses. Think of an address like a lockbox, and a wallet as a key for many lockboxes. A wallet is accessible by providing a unique, secret 24 word passphrase. If you lose this passphrase, you don't have access to your wallet, and there is no way to recover your assets! Therefore, it's very important to safely store your wallet's secret passphrase securely. At the same time, anyone with your passphrase can access and take all of your assets, so it's vital to make sure nobody else knows your passphrase. It's best practice to not have your passphrase saved on any computer.
You can access your wallet on the Avalanche Wallet website. You can follow this guide to set up a new own wallet.
You can and should use a hardware Ledger to log into your wallet. Using a hardware wallet is the most secure way of accessing your tokens because your private keys and the passphrase never leave the device. If you have an amount of tokens you would not be comfortable losing, it is strongly advised to invest in a hardware wallet.
Once you have your wallet, you may want to send your AVAX from an exchange to your wallet. See here for a guide on doing so.
Avalanche's Primary Network consists of three different chains, as explained in the overview article linked above. To move your funds from one chain to another, you will need to make cross-chain transfers.
Metamask
Most of the activity on the Avalanche network happens on various dapps (decentralized apps). To interact with them, you can use a browser extension that will connect your wallet with the dapp. Metamask is one such popular wallet extension.
By default, Metamask connects to Ethereum. To connect to Avalanche, you need to add Avalanche as a custom network.
In Metamask you can create a new account and send funds to it from your main Avalanche wallet, or import the existing Avalanche Wallet account. You can import the account either by using the secret passphrase or by exporting the C-Chain private key from the wallet (Select Manage Keys
, then View C Chain Private Key
). If you use the Ledger hardware wallet, you can use it in Metamask too. It will connect to your wallet and have the same balances/addresses as if you accessed your wallet on the wallet website.
To see your funds in Metamask (if you imported Avalanche Wallet), or to be able to send funds from the Wallet account to Metamask account, you will need to have your funds on the C-Chain. Most exchanges are connected to the C-Chain, so you can withdraw AVAX directly from the exchange to your Metamask wallet. For details on networks and tokens available for deposit/withdrawal please consult the exchange support pages. List of exchanges can be found here.
Transactions
You can send tokens from the Avalanche Wallet or Metamask. It is important to have in mind that all transactions are final and irreversible. If you make a mistake and send funds to an incorrect address, there is no mechanism that can revert the transaction and return the funds to you. That's why it's critically important to be sure that the address you're sending the tokens to is correct and that you mean to send to an address on Avalanche and not a different network (see next section.) If you are not sure, test the validity of the transfer by sending a small amount first.
Sending to Other Networks
Other networks may have address formats that are identical to the ones on Avalanche. But that doesn't mean that you can send funds on Avalanche directly to other blockchain networks, including, for example, Ethereum or BSC (Binance Smart Chain). If you tell Avalanche to send funds to address (0x12345
), for example, it will do so on Avalanche, not another network, even if that address exists or is valid on another network. Your funds will not end up on the other network. Once the funds are sent, only the person who has the private keys that control the destination address can ever access them.
The above applies in the reverse direction, too. You cannot send funds to an Avalanche network address directly from Ethereum, BSC, etc. The addresses may look the same and be accepted, but that doesn't mean the funds will arrive in your wallet. If you want to send or receive funds from Ethereum, see the Avalanche Bridge section below.
If you're unsure of what you're attempting to do, or doing something for the first time, it's best to send a small amount ('dust') first, to check that it arrives at the intended destination.
Help! I did try to send tokens to/from another network, what now?
Well, you shouldn't have done that. But even if you did, there might be a way out. It is important to understand what happened: the tokens are still on the network where you posted the transaction, deposited to the destination address. To know what to do next, the question is: who controls the destination address?
If you attempted to send the tokens to your wallet then the solution is available: use the private keys for that address on the network where the transaction was posted. If using Metamask, it might be as simple as switching to the correct network with the account selected. You may also need to add the token to Metamask. Tokens on different networks usually have different contract addresses so make sure you're using the correct token address for the network.
If you attempted to send the tokens to somebody else's wallet, then you will need their cooperation. They will need to use the private keys to connect to the network where you made the transaction and retrieve the tokens.
If the destination address belongs to an exchange (it is their deposit address) then you need to contact their support and explain the situation. They might be able to help you, but be warned, exchange security procedures will usually not allow manual manipulation of the private keys. There might be a solution still. If the exchange does not accept deposits from that network, it might in the future, and then they might retrieve the tokens and credit your exchange balance.
Depositing and withdrawing from exchanges
Before attempting to deposit or withdraw from any exchange, make sure what you're trying to do is supported. Every exchange will have a different set of supported operations, just because you can make a transaction does not mean that the exchange will credit your balance. Check if the chain you're using is supported (some exchanges support both the X-Chain and the C-Chain, some just one or the other). Also, even though all exchanges support deposit and withdrawal of AVAX, not all of them support various other tokens that exist on the platform. Check with their support before sending the transaction. Failing to do so might result in a loss of tokens!
Adding Tokens
Besides the native token, AVAX, numerous other tokens exist on the network. Avalanche Wallet has built in support for the most popular tokens, but Metamask does not. If you acquire other tokens, they may not immediately be visible in your wallet or Metamask. You may need to add them manually, by selecting 'Add token' button. To add a token, you will need to know the token contract address. Do not use the search function in Metamask, it only works correctly on Ethereum. You can find addresses of the most popular tokens here for assets from Ethereum, or here for Avalanche assets.
When you add the address, the rest of the data will autofill, and your balance should be visible. You can automatically add tokens to Metamask here by pressing the Metamask icon in the Wrapped token
you want to add.
Dapps
Avalanche Bridge
Once you have your browser extension (Metamask for example) set up, you are ready to interact with dapps on Avalanche. Most of what you will want to do, such as yield farming, requires that you have tokens other than AVAX. If you have those tokens on Ethereum (or an exchange that can send them to Ethereum), one of the cheapest and fastest ways of bringing them over is the Avalanche Bridge.
You can find a collection of video tutorials on the basic usage of the Avalanche Bridge here. Also, make sure that you go over the FAQ which answers most common questions about the bridge and highlights things to watch out for.
When you bridge over $75 or more of assets, you will also be airdropped some AVAX to help pay for initial swaps. Use those funds only to acquire additional AVAX as you will need AVAX to pay for fees on every other dapp you use! If you get stranded without enough AVAX for fees you will be unable to do anything else, so make sure you always have some AVAX in your wallet. You can swap for AVAX on Pangolin.
Ecosystem
There is an ever-growing collection of dapps deployed on Avalanche. To find them, you can go to our official ecosystem website. You can filter the projects by selecting the tags for the areas of your interest. There is also a community-driven list of projects. (You should not consider the presence of a project on the lists above as an endorsement of the project.)
Dip in, browse, and try stuff. There are many gems in there.
Security
As elsewhere in the cryptocurrency space, you need to be keenly aware of the dangers. All transactions are final and irreversible, and if you fall victim to a scam, nobody will be able to retrieve your funds.
Wallet Passphrase
It's crucial to understand that your secret passphrase is your wallet. Whoever has access to the secret 24 word passphrase has complete and full access and control over everything in the wallet. If you give someone your passphrase, you have given them everything in it. Therefore, never give your passphrase to anyone. Do not send it anywhere. Do not type it into websites you found online or that someone sent you a link to. Best practice is to not have your passphrase saved on any computer.
The only place where you can enter the passphrase is into the official Avalanche Wallet website, and even then, make sure you're on a secure network and that the website is the right one by typing the address https://wallet.avax.network
address yourself. Check the padlock icon in your browser to make sure your connection is secure. If using a search engine, be aware that the first link might be ad for a malicious site impersonating the official one. Always carefully check the address! If you're in doubt as to whether to enter your passphrase, don't.
If you're working with non-trivial amounts of tokens (in other words, money you can't comfortably lose), we strongly advise that you use a Ledger hardware wallet to access your funds.
DYOR
That stands for 'Do your own research'. In other words, don't just blindly trust anything you read online. Check for other sources, ask for second opinions. Be very careful and judicious with accepting news from one source.
Be especially suspicious of people contacting you in private, offering help about issues you posted about publicly. Virtually every time it happens, it's a scammer trying to convince you to expose your passphrase, private keys or otherwise compromise your tokens.
Don't rush into unknown projects that promise outsized returns. Any dapp you deposit your funds into has access to them. Search for the project online and see who maintains it. Check that the contracts are verified and audited. Look out for potential red flags.
Fake tokens
Anyone can create a new token, and on Avalanche it is pretty cheap. Also, liquidity pool creation on DEXes is permissionless so anyone can create a new pair with a fake token that has the same name and token image as the real thing. To avoid that kind of scam, always select tokens from the official token lists on the DEXes, don't use links from other places.
Explorers
Explorers are websites that index and present network activity, where you can look up individual transactions, and find out more about what's flowing through the network.
Official explorer
explorer.avax.network is the official network explorer maintained by Ava Labs.
AvaScan
Avascan is an independent explorer website, known for its slick presentation and comprehensive overview, especially interesting for viewing validators and delegators, as it shows lots of interesting information about individual network validators.
VScout
VScout is another alternative explorer for Avalanche. Among other things there you can see distribution of validators across the planet.
Online support
We offer several ways of getting support. Here are some:
- Support site
- Twitter tech support.
- Telegram
- Discord server (most popular and highest traffic.)
Expanding on the DYOR section above: When using any public support channel, be suspicious of anyone contacting you in private via DMs, email or similar. They may pose as admins, moderators or team members. Legitimate accounts will never contact you in DMs first! Real admins and team members will always engage publicly first, and if needed request that you contact them in direct message.
Scammers monitor public channels for people looking for help and then contact them in private offering to help. A scammer might tell you that you need to 'sync your wallet' or something similar and give you a link where you are supposed to enter the wallet passphrase to complete the process. They might offer an app that will solve the problem. In both cases, it's just someone looking to steal your funds.
It bears repeating: do not give anyone your secret 24 word passphrase or your private keys!
Conclusion
Avalanche is a young platform, but it offers many interesting and exciting opportunities to get engaged and participate in the new frontier of blockchains. Getting started can feel daunting, but we hope this document will ease your introduction and onboarding.
If you have any questions, or doubts, need something to be cleared up, or just want to chat, please join us on our Discord server. We'd love to hear from you.