To interact with the Vana Network, please refer to the instructions on setting up the network, managing hot and cold keys, and setting up a wallet.
In this section, you will find information on:
Instructions how to set up the network
Using the to Block explorer
Obtaining test token from the faucet
In this section, you will find details about:
Key pairings
Cold keys
Hot keys
In this section, you will find instructions on how to:
set up a wallet in the browser
set up a local wallet with CLI
The Vana network is EVM-compatible and supports Ethereum-compatible addresses. A Vana wallet holds the core ownership of assets on the Vana network, acting as the identity for all operations. Your wallet is also used to derive different encryption keys to secure your data.
Network participants like DLP validators can use the CLI tool that comes with the Vana cli to manage their wallets.
This guide explains how to work with Vana wallet keys. For instructions on creating a Vana wallet, see Creating a Wallet.
A Vana wallet consists of a coldkey and a hotkey, used for different operations in the Vana ecosystem.
Each key is a pair of separate cryptographic keys. A coldkey has a private key and a public key, as does a hotkey.
The coldkey is synonymous with the wallet name. For example, the --wallet.name
option in a vanacli
command accepts the coldkey as its value, while --wallet.hotkey
accepts the hotkey. One coldkey can have multiple hotkeys.
Storage: Holds VANA.
Delegation: For delegating and undelegating VANA.
DLP Creation: Used for creating a DLP.
Security: Provides the highest level of security; always encrypted.
You can create multiple hotkeys paired with a single coldkey. In a DLP, you are identified by your hotkey, keeping your coldkey secure. The same hotkey cannot be used for two nodes in the same DLP but can be used in different DLPs.
Transactions: Signing transactions.
Operations: Registering and running DLP nodes.
Delegation: VANA holders can delegate their VANA to a validator’s hotkey.
Coldkey: Highly secure and always encrypted, used for storing and managing VANA securely.
Hotkey: Less secure, generally unencrypted, used for regular operational tasks.
This is an overview of how to create a Vana wallet, and associated keys. A Vana wallet holds the core ownership of assets on the Vana network, acting as the identity for all operations.
The Vana network is EVM-compatible and supports Ethereum-compatible addresses. Any wallet that supports EVM chains can be used to create a wallet that can send and receive VANA, including hardware wallets. Some recommended wallet applications are MetaMask, Rabby, and Trust Wallet.
Network operators like DLP validators can use the CLI tool that comes with the Vana framework to manage their wallets.
The Vana framework supports wallets that each contain:
A coldkey: an address representing the owner of a service running in the network.
A hotkey: an address representing the service running in the network.
Coldkeys are secure keys stored encrypted offline, used for critical or infrequent transactions. A hotkey allows a validator to call a DLP smart contract and must be loaded into the live service environment.
Each of these is a pair of separate cryptographic keys. A coldkey has a private key and a public key, as does a hotkey.
The coldkey is synonymous with the wallet name. For example, the --wallet.name
option in a vanacli
command accepts the coldkey as its value, while --wallet.hotkey
accepts the hotkey. One coldkey can have multiple hotkeys.
Storage: Holds VANA.
Delegation: For delegating and undelegating VANA.
DLP Creation: Used for creating a DLP.
Security: Provides the highest level of security; encrypted at rest.
You can create multiple hotkeys paired with a single coldkey. In a DLP, you are identified by your hotkey, keeping your coldkey secure. The same hotkey cannot be used for two nodes in the same DLP but can be used in different DLPs.
Transactions: Signing transactions.
Operations: Registering and running DLP nodes.
Delegation: VANA holders can delegate their VANA to a validator’s hotkey.
Security: Less secure, generally unencrypted, used for regular operational tasks.
Create a local wallet using the vanacli
command line tool on your computer, so it can be used to create or participate in a DLP.
Keep your mnemonic safe
When a wallet is created, a mnemonic is created that can be used to recover your wallet. Anyone who knows the mnemonic for your wallet account can access your VANA tokens. Hence you must always keep this mnemonic in a safe and secure place, known only to you. More important, if you lose your wallet address, you can use its mnemonic (that you stored away in safekeeping) to restore the wallet.
To create a wallet using the CLI:
Clone the vana-framework repository and follow the steps in Getting Started to install the CLI tool. Use the wallet create
command to start the process of creating a wallet.
You will be prompted to enter the wallet name (aka coldkey name), hotkey name, and a password to encrypt your wallet with.
Local wallets are stored on your machine under ~/.vana/wallets
.
The Vana network is a fully EVM-compatible L1 designed for private data. Currently in testnet, it is a testing ground for data liquidity pool creators and data contributors.
Our testnet is under active development. You may encounter bugs, performance issues, and other disruptions. Data on the testnet may be wiped without warning. We appreciate your feedback and contributions to help to resolve any issues. Please join our Discord for the most up-to-date information.
Please make sure to read carefully the Terms before you participate in any activities on Satori Testnet.
Add a new network with these details within your preferred wallet (e.g. MetaMask). The video below demonstrates how to do this.
Moksha is our current testnet, running on Proof-of-Stake consensus. This is the recommended testnet for active development.
Satori is our first testnet, running on Proof-of-Authority consensus. While we don't recommend this testnet for active development, it is available for historical purposes.
A quick video on setting up the Satori Testnet and perform a simple data transaction.
You will also find a button on the bottom left in the block explorer to add the network with one click to your MetaMask. If using mobile, you will need to use the MetaMask browser to see this button.
Moksha Testnet: https://moksha.vanascan.io
Satori Testnet: https://satori.vanascan.io
A block explorer is a web-based tool that allows users to view details about blocks, transactions, addresses, and other activities on a blockchain network. Block explorers provide a user-friendly interface for accessing blockchain data, making it easier to track transactions, monitor network activity, and verify information without needing to run a full node.
Available at: https://faucet.vana.org/
To begin testing on Satori, use the faucet to send free tokens to your wallet so you can register a DLP or a validator node. The faucet is rate-limited, but if you need more tokens to test, send your wallet address in discord and the community will help you out.
RPC URL
https://rpc.moksha.vana.org
Chain ID
14800
Network name
Vana Moksha Testnet
Currency
VANA
Block Explorer
https://moksha.vanascan.io
RPC URL
https://rpc.satori.vana.org
Chain ID
14801
Network name
Vana Satori Testnet
Currency
VANA
Block Explorer
https://satori.vanascan.io