Create an alias

Creating an alias

sithbit alias create <alias> [--keypair <keypair>] [--skip-preflight]

For example:

sithbit alias create john_doe

This registers john_doe as an alias pointing at the address of the signing keypair (defaulting to your configured default keypair — see Getting Started).

Note: sithbit mailbox create already registers your wallet’s own address as a self-alias automatically. Use alias create for additional friendly names beyond that automatic one.

To register many names at once (e.g. a postmaster reserving names for resale), see Reserve aliases in bulk.

Allowed characters

Alias names are validated at registration — both client-side and by the on-chain program, so the rules hold even for hand-rolled transactions:

• Lowercase ASCII letters, digits, and the separators ., _, - (uppercase input is accepted and lowercased before storage and PDA derivation).
• Must start and end with a letter or digit.
• No consecutive dots.
• At most 64 bytes.

Non-ASCII names are refused outright: this shuts out homoglyph (e.g. Cyrillic а), zero-width, and Unicode-normalization look-alike spoofing.