Alias

Alias is a short, easy to remember, name of the address. The alias is unique on the blockchain.

One address can have several aliases.

The alias can be used instead of the address:

• In Transfer, Mass Transfer and Lease transactions to identify a recipient, as well as in Invoke Script transactions to identify an invoked dApp.
• To find an account in Waves Explorer (opens new window).

The alias cannot be deleted.

Alias Requirements

The length of an alias can be from 4 to 30 bytes (1 character can take up to 4 bytes).

The following characters are allowed:

• lowercase Latin letters
• numbers
• dot
• underscore
• hyphen
• @

Create Alias

To create an alias, you have to send a Create Alias transaction. There are the following options for sending the transaction:

• In Waves.Exchange (opens new window) app developed by the third-party team from the community. See the Create Personal Alias (opens new window) article of Waves.Exchange documentation.
• Using client libraries. See also the How to Create Transaction and Broadcast It to Blockchain article.

View Aliases

The list of account aliases, as well as other blockchain data, is public and can be read by anyone. For example, you can see aliases in Waves Explorer (opens new window). To do this, find an account by its address and switch to the Aliases tab.

In Node REST API, you can obtain a list of aliases by address using the GET/alias/by-address/{address} method and an address by alias using the GET /alias/by-alias/{alias} method.

Binary Format

See the Alias Binary Format article.