Querying Initia Usernames

Module Addresses

Network	Address
Testnet (initiation-2)	0x42cd8467b1c86e59bf319e5664a09b6b5840bb3fac64f5ce690b5041c530565a

Tutorials

Getting Address from Usernames

To retrieve an address from a username, we use the get_address_from_name function. The function interface is as follows:

#[view]
public fun get_address_from_name(name: String): Option<address>

InitiaJS

const { RESTClient, bcs } = require('@initia/initia.js')

const moduleAddress = '0x...'
const name = 'initia'
const restClient = new RESTClient('https://rest.testnet.initia.xyz', {
  gasPrices: '0.015uinit',
  gasAdjustment: '1.5',
})

restClient.move
  .view(
    moduleAddress,
    'usernames',
    'get_address_from_name',
    [],
    [bcs.string().serialize(name).toBase64()],
  )
  .then(console.log)

// Response:
// {
//   data: '"0x.."',
//   events: [],
//   gas_used: '5699'
// }

Getting Usernames from Address

To retrieve a username from an address, we use the get_name_from_address function.

#[view]
public fun get_name_from_address(addr: address): Option<String>

InitiaJS

const { RESTClient, bcs } = require('@initia/initia.js')

const moduleAddress = '0x...'
const address = 'init1...'
const restClient = new RESTClient('https://rest.testnet.initia.xyz', {
  gasPrices: '0.015uinit',
  gasAdjustment: '1.5',
})

restClient.move
  .view(
    moduleAddress,
    'usernames',
    'get_name_from_address',
    [],
    [bcs.address().serialize(address).toBase64()],
  )
  .then(console.log)

// Response:
// {
//   data: '"abc..."',
//   events: [],
//   gas_used: '5699'
// }