Integrating

Integrating with is simple.

Web2 API and UI:

To see a single name (without logging in):

/ids/[token-name]

To see all the names registered to a wallet (without logging in):

/addresses/[address]

To see the primary alias (without logging in):

/addresses/[address]/primary

For Developers:

Mapping Address → Name

A wallet address has a 1-to-many relationship to names.

Most times, however, we only want one name.

This is where the primary alias comes in.

To get the primary alias for a wallet address, call it like so:

PrimaryAlias { address: String }

If a user/wallet address has set a primary alias, this will be returned.

Otherwise, the first (latest) result will be returned from chain.

Mapping Name → Address

This mapping is simpler, since names are extended CW721 NFTs.


  OwnerOf {
    token_id: String,
    include_expired: Option<bool>,
  },

OwnerOf is nice as it is part of the CW721 standard, but it is not that ergonomic.

If you find this is so, let us know - as we may add a slimmed alias for it in the next version of .

The address of this contract is: