Username Registration

In the Andromeda universe, your username is more than just a name—it’s your personal home base in the Virtual File System. Just like creating a user account on your computer, registering a username sets up your very own /home/you directory, where your apps and components will live in style.

This guide will walk you through how to register your username on Andromeda testnet in just a few easy steps.

Prerequisites

We’ll be going through this process using the Andromeda CLI, so if you don’t have it installed yet, make sure to set that up first. You’ll also need to import the wallet or address you’d like to register the username to.

Need help with that part? Don’t worry, we’ve got you covered. You can follow our intro to CLI docs here.

Once you’re ready, let’s dive into the steps to claim your username on testnet!

Registration Steps

  1. Connect to the wallet you are looking to register

  2. Run the following command:

os vfs execute

  1. Select [Option 4] "Register User".

  2. Select no for "Would you like to add address". This means the connected wallet address will be used.

  3. Select the username to register your address to.

  4. Select no for "Would you like to add funds".

  5. Confirm the transaction.

Your username is now registered.

Checking the Result

To make sure your username has been registered, we can query the VFS:

  1. Run the command 

os vfs query

  1. Select [Option 4] "Get Username".

  2. Paste your crypto address that you registered (you can get your address by running "wallet list")

  3. Run the command

The username you registered should be returned. Now any apps you create will be under your username directoy. For example if you create an application called "hello world" then it would registered under your username:

And any component of the app (auction-1 in the example below) would also be registered under the app:

Last updated