🧰Utilities

1. Fetch a list of available namespaces for resolution

• GET /api/v1/resolver/namespaces

• Returns a list of namespaces enabled for the tenant account. The shortname field value is the enumeration value for the resolver with namespace endpoint.

Response

200 OK

{
  "timestamp": "2024-12-04T11:27:05.813793213",
  "data": [
    {
      "name": "ENS Domains",
      "shortname": "ENS",
      "smartContractAddress": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85"
    },
    {
      "name": "Freename Domains",
      "shortname": "FNS",
      "smartContractAddress": "0x465ea4967479a96d4490d575b5a6cc2b4a4bee65"
    },
    {
      "name": "Unstoppable Domains",
      "shortname": "UD",
      "smartContractAddress": "0xa9a6a3626993d487d2dbda3173cf58ca1a9d9e9f"
    }
  ]
}

2. Set blockchain address for resolution

• POST /api/v1/resolver/{asciiName}

• This endpoint assigns a blockchain address to the item identified by the ASCII name provided in the path variable.

• Example:https://apis.freename.io/api/v1/resolver/monopattinohello.metaverse

Request Headers

Name	Description	Required
Authorization	Bearer token	true

Request Body

{
    "address": "0xBc3c4559Ebcd85e4DB8EcbEb0038c880bFbD0d3E"
}

Request Body Parameters

Parameter	Type	Description
address	String	The blockchain address to be associated with the item

Response

200 OK

{
    "timestamp": "2025-03-05T11:49:46.471884",
    "message": "Blockchain address saved successfully.",
    "data": {
        "address": "0xBc3c4559Ebcd85e4DB8EcbEb0038c880bFbD0d3E"
    }
}