Metadata Service Guide

Cronos ID has a Metadata Service, which allows third party NFT platforms and wallets to integrate and display the information of Cronos IDs.

Service Endpoints

Production Environment https://metadata.cronosid.xyz/

Contracts

• Testnet, CRORegistrar: 0x8101623b9F430C5A3fa808619456B8d98ba5A894

• Mainnet, CRORegistrar: 0xf884647Dfa84696d9373F36eE413CCc48093F924

NFT Metadata API

Request path:

/{networkName}/{contractAddress}/{tokenId}

Parameters:

• Network: Name of the chain to query for (mainnet | testnet)

• contractAddress: Accepts contractAddress of the NFT which is represented by the tokenId

• tokenId: Accepts labelhash of Cronos ID domain in both hex and int format

// how to get tokenId for the name 'abcde5.cro' (javascript)
const label = "abcde5".toLowerCase()
ethers.utils.keccak256(ethers.utils.toUtf8Bytes(label))
// or, same
ethers.utils.id(label)

Response Body:

{
  "is_normalized": true,
  "name": "to-the-moon.cro",
  "description": "to-the-moon.cro, an Cronos ID name.",
  "attributes": [
    {
      "trait_type": "Created Date",
      "display_type": "date",
      "value": 1661226007000
    },
    { "trait_type": "Length", "display_type": "number", "value": 11 },
    { "trait_type": "Segment Length", "display_type": "number", "value": 11 },
    {
      "trait_type": "Character Set",
      "display_type": "string",
      "value": "mixed"
    },
    {
      "trait_type": "Registration Date",
      "display_type": "date",
      "value": 1661226007000
    },
    {
      "trait_type": "Expiration Date",
      "display_type": "date",
      "value": 1976795527000
    }
  ],
  "name_length": 11,
  "segment_length": 11,
  "url": "https://cronosid.xyz/name/register/?label=to-the-moon.cro",
  "version": 0,
  "background_image": "https://metadata.cronosid.xyz/testnet/avatar/to-the-moon.cro",
  "image": "https://metadata.cronosid.xyz/testnet/0x8101623b9F430C5A3fa808619456B8d98ba5A894/0x486a8f914586140c471814a37061a30c5fc9585adca7fa5ed0636305c46d73fc/image",
  "image_url": "https://metadata.cronosid.xyz/testnet/0x8101623b9F430C5A3fa808619456B8d98ba5A894/0x486a8f914586140c471814a37061a30c5fc9585adca7fa5ed0636305c46d73fc/image"
}

Response Fields:

Field	Description
name	name of the domain
description	Short description about the name. It contains a warning message if the domain is not comprised of numbers and letters.
is_normalized	Whether the domain is normalized. It must follow UTS46 for normaliztion and validation.
attributes	A list of attributes, including: - Created Date - Length - Segment Length - Character Set - Registration Date - Expiration Date
name_length	Character length of the domain
segment_length	Segment length of the domain. Local-sensitive text segmentation obtained by Intl.Segmenter.
url	A URL to the domain's profile page on Cronos ID website
version	Cronos ID NFT version
background_image	Origin URL of the avatar image
image	URL of the domain image to display (recommended)
image_url	URL of the NFT image

NFT Metadata Image API

Request Path:

/{networkName}/{contractAddress}/{tokenId}/image

Parameters:

• network: Name of the chain to query for (mainnet | testnet)

• contactAddress: Accepts contractAddress of the NFT which is represented by the tokenId

• tokenId: Accepts labelhash of Cronos ID domain in both hex and int format

Response Body:

A SVG image file

• the content-type is ‘image/svg+xml’.