Skip to main content

​
POST /get_alias

Resolves an alias to a Fuego address. Request:
The @ prefix is optional — both "alice" and "@alice" resolve the same way. Response (found):
Response (not found):
Check found before using address. A found: false response with status: "OK" means the alias does not exist on-chain — it is not an error.

​
POST /get_alias_by_address

Reverse lookup: find the alias registered for a given address. Request:
Response (found):

​
GET /get_all_aliases

Returns all registered aliases. Use sparingly — on a large network this can be a large response. Request: {} Response:

​
Privacy note

Aliases are stored on-chain with the full address in the registration transaction extra. The AliasIndex also stores the address hash (cn_fast_hash(spendKey||viewKey)) for ownership verification.
  • /get_all_aliases returns alias names, types, and registration blocks — no addresses.
  • /get_alias returns the full address (targeted, single-alias lookup).
  • /get_alias_by_address returns the alias name for a given address.
This design blocks mass surveillance while enabling targeted alias resolution for swaps and transfers. An observer must know the alias name to retrieve its address — one at a time, not in bulk.