---
sidebar_position: 3
slug: /use/aliases
---

# Aliases

Each Lethean user can register with an alias, for example, @easytouse, a human-readable name associated with a payment address and text comment stored in the blockchain. This alias provides a short, easy-to-remember name rather than a long, confusing string of random characters. Blockchain storage ensures that aliases are protected from being altered.

Each alias is assigned to a particular wallet. Only one alias can be created per wallet. To register an alias, select `Register an alias` from the wallet main window.

To reduce the possibility of phishing, we set limitations on alias registrations. Users can use any combination of the lower-case Latin letters a-z and the Arabic numerals 0-9. Additionally, the length must be a minimum of 6 characters and a maximum of 25.

:::note

Aliases shorter than 6 characters can only be issued by the Lethean Core Team. Users can win one by participating in our monthly community events.

:::

The comment section will be temporarily stored in the blockchain until it passes a checkpoint. For more information on the pruning mechanism please refer to the [whitepaper](https://github.com/lethean-io/blob/master/lethean/Lethean_WP_latest.pdf).



<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0 }}>
  <iframe
    src="https://www.youtube.com/embed/ImbcSEc6cTU"
    title="YouTube video player"
    style={{ 
    position: 'absolute', 
    top: 0, 
    left: 0, 
    width: '100%', 
    height: '100%' 
    }}
    frameBorder="0"
    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
    allowFullScreen
  />
</div>

![alt alias-registration](/img/use/wallet-features/aliases/aliascreation.png)*<figcaption style={{textAlign: "center" }}>Alias registration</figcaption>*

Aliases can be used for more than just Lethean transactions. Think of them as a decentralised address book with universal IDs that can be used for various services based on the Lethean platform — VPN subscriptions, identity, agent federation, and marketplace listings.

### Registration via RPC

```bash
curl -X POST http://127.0.0.1:36944/json_rpc \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","method":"register_alias",
    "params":{
      "al":{
        "address":"YOUR_iTHN_ADDRESS",
        "alias":"myname",
        "comment":"My Lethean alias"
      },
      "authority_key":""
    }
  }'
```

### Lookup via RPC

```bash
# By alias name
curl -X POST http://127.0.0.1:36941/json_rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":"0","method":"get_alias_details","params":{"alias":"myname"}}'

# By address (reverse lookup)
curl -X POST http://127.0.0.1:36941/json_rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":"0","method":"get_alias_by_address","params":{"address":"iTHN..."}}'

# Get registration cost
curl -X POST http://127.0.0.1:36941/json_rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":"0","method":"get_alias_reward","params":{"alias":"myname"}}'
```

### Cost

New alias registration costs **1 LTHN**. Updates use the standard transaction fee (essentially free). This prevents spam registration while keeping aliases accessible.

### Requirements

- Minimum 6 characters, maximum 25
- Lowercase letters (a-z) and numbers (0-9) only
- Aliases shorter than 6 characters require an authority key (reserved for Lethean CIC)
- Requires HF4 (Zarcanum) to be active on the network

> **Verified:** `get_alias_reward` and `get_alias_details` RPCs tested on testnet. Registration requires HF4 (height 11,000) for transaction support.

