Fake .eth ENS name check with fields

POST

fake-eth-name-check

curl --request POST \
  --url https://api.nameguard.io/fake-eth-name-check \
  --header 'Content-Type: application/json' \
  --data '{
  "network_name": "mainnet"
  "contract_address": "0x495f947276749ce646f68ac8c248420045cb7b5e"
  "token_id": "61995921128521442959106650131462633744885269624153038309795231243542768648193"
  "fields": {"title": "nick.eth"}
}'

{
  "status": "authentic_eth_name",
  "nameguard_result": {
    "rating": 3,
    "risk_count": 2,
    "highest_risk": {
      "check": "confusables",
      "status": 3,
      "message": "<string>",
      "check_name": "<string>"
    },
    "name": "vitalìk.eth",
    "namehash": "0xd48fd5598e605861cbd8e45419b41b83739bff52eaef0e283181bbe0a43a5b32",
    "normalization": "normalized",
    "checks": [
      {
        "check": "confusables",
        "status": 3,
        "message": "<string>",
        "check_name": "<string>"
      }
    ],
    "labels": [
      {
        "rating": 3,
        "risk_count": 2,
        "highest_risk": {
          "check": "confusables",
          "status": 3,
          "message": "<string>",
          "check_name": "<string>"
        },
        "label": "vitalìk",
        "labelhash": "0x41459971a5b847d0eef67bc11e2845f1074a2aed1ac6a357378b18fba50816e4",
        "normalization": "normalized",
        "checks": [
          {
            "check": "confusables",
            "status": 3,
            "message": "<string>",
            "check_name": "<string>"
          }
        ],
        "graphemes": [
          {
            "rating": 3,
            "risk_count": 2,
            "highest_risk": {
              "check": "confusables",
              "status": 3,
              "message": "<string>",
              "check_name": "<string>"
            },
            "normalization": "normalized",
            "grapheme": "v",
            "grapheme_name": "Latin Small Letter V",
            "grapheme_type": "simple_letter",
            "grapheme_script": "Latin",
            "grapheme_description": "A-Z letter",
            "title": "<string>",
            "subtitle": "<string>"
          }
        ],
        "canonical_label": "vitalik",
        "title": "<string>",
        "subtitle": "<string>",
        "beautiful_label": "<string>"
      }
    ],
    "canonical_name": "vitalik.eth",
    "title": "<string>",
    "subtitle": "<string>",
    "beautiful_name": "<string>"
  },
  "investigated_fields": {}
}

curl --request POST \
  --url https://api.nameguard.io/fake-eth-name-check \
  --header 'Content-Type: application/json' \
  --data '{
  "network_name": "mainnet"
  "contract_address": "0x495f947276749ce646f68ac8c248420045cb7b5e"
  "token_id": "61995921128521442959106650131462633744885269624153038309795231243542768648193"
  "fields": {"title": "nick.eth"}
}'

Body

application/json

network_name

enum<string>

required

Available options:

mainnet,

sepolia

contract_address

string

required

Contract address for the NFT contract (ERC721 and ERC1155 supported).

Example:

"0x495f947276749ce646f68ac8c248420045cb7b5e"

token_id

string

required

The ID of the token (in hex or decimal format).

Example:

"61995921128521442959106650131462633744885269624153038309795231243542768648193"

fields

object

required

Fields with values which will be investigated (e.g. title, collection name, metadata) whether they look like fake .eth ENS name. title key is mandatory, for ENS contracts it should be the ENS name.

Response

200

application/json

Successful Response

Fake .eth ENS name check result.

status

enum<string>

required

authentic_eth_name The NFT is associated with authentic ".eth" contracts.
impersonated_eth_name The NFT appears to impersonate a ".eth" name. It doesn't belong to authentic ENS contracts but contains graphemes that visually resemble ".eth" at the end of relevant NFT metadata fields. Consider automated rejection of this NFT from marketplaces.
potentially_impersonated_eth_name The NFT potentially impersonates a ".eth" name. It doesn't belong to authentic ENS contracts but contains graphemes that visually resemble ".eth" within relevant NFT metadata fields (but not at the end of those fields). Consider manual review of this NFT before publishing to marketplaces.
non_impersonated_eth_name The NFT doesn't represent itself as a ".eth" name and doesn't belong to authentic ENS contracts. No string that visually resembles ".eth" was found within relevant NFT metadata fields.
unknown_nft: No information could be found on the requested NFT. This generally indicates that the NFT doesn't exist or hasn't been indexed yet.
invalid_eth_name: The NFT is associated with authentic ".eth" contracts, but it is unnormalized.
potentially_authentic_eth_name: The NFT is associated with authentic ".eth" contracts, but its label is unknown.
unknown_eth_name: The NFT is associated with authentic ".eth" contracts, but its label is unknown or has never been registered.

Available options:

authentic_eth_name,

impersonated_eth_name,

potentially_impersonated_eth_name,

non_impersonated_eth_name,

unknown_nft,

invalid_eth_name,

unknown_eth_name

nameguard_result

object | null

required

NameGuard report for the .eth ENS NFT.

null if status is any value except authentic_eth_name, invalid_eth_name and unknown_eth_name (the NFT is not associated with authentic ".eth" contracts)

nameguard_result.rating

enum<integer>

required

The rating of a name/label/grapheme based on multiple conducted checks.

pass: All checks passed.
warn: At least one check failed with a WARN status but no check failed with an ALERT status.
alert: At least one check failed with an ALERT status.

Available options:

2,

3,

4

Example:

3

nameguard_result.risk_count

integer

required

The number of checks that have a status of alert or warn.

Example:

2

nameguard_result.highest_risk

object | null

required

The check considered to be the highest risk. If no check has a status of alert or warn, this field is null.

nameguard_result.name

string

required

The analyzed name. Can contain labelhashes when some labels are unknown.

Example:

"vitalìk.eth"

nameguard_result.namehash

string

required

The namehash of the name in hex format prefixed with 0x.

Example:

"0xd48fd5598e605861cbd8e45419b41b83739bff52eaef0e283181bbe0a43a5b32"

nameguard_result.normalization

enum<string>

required

The ENSIP-15 normalization status of a name or label.

normalized: The name or label is normalized.
unnormalized: The name or label is not normalized.
unknown: The name or label is unknown because it cannot be looked up from its hash.

Available options:

normalized,

unnormalized,

unknown

nameguard_result.checks

object[]

required

A list of checks that were performed on the name.

The result of a conducted check.

nameguard_result.labels

object[]

required

The analyzed labels of the name.

Label analysis result.

nameguard_result.labels.rating

enum<integer>

required

The rating of a name/label/grapheme based on multiple conducted checks.

pass: All checks passed.
warn: At least one check failed with a WARN status but no check failed with an ALERT status.
alert: At least one check failed with an ALERT status.

Available options:

2,

3,

4

Example:

3

nameguard_result.labels.risk_count

integer

required

The number of checks that have a status of alert or warn.

Example:

2

nameguard_result.labels.highest_risk

object | null

required

The check considered to be the highest risk. If no check has a status of alert or warn, this field is null.

nameguard_result.labels.label

string

required

The analyzed label. If the label is unknown, this field is [labelhash].

Example:

"vitalìk"

nameguard_result.labels.labelhash

string

required

The labelhash of the label in hex format prefixed with 0x.

Example:

"0x41459971a5b847d0eef67bc11e2845f1074a2aed1ac6a357378b18fba50816e4"

nameguard_result.labels.normalization

enum<string>

required

The ENSIP-15 normalization status of a name or label.

normalized: The name or label is normalized.
unnormalized: The name or label is not normalized.
unknown: The name or label is unknown because it cannot be looked up from its hash.

Available options:

normalized,

unnormalized,

unknown

nameguard_result.labels.checks

object[]

required

A list of checks that were performed on the label.

The result of a conducted check.

nameguard_result.labels.graphemes

object[] | null

required

A list of graphemes that were analyzed in the label. If the label is unknown, this field is null.

Grapheme analysis result.

nameguard_result.labels.graphemes.rating

enum<integer>

required

The rating of a name/label/grapheme based on multiple conducted checks.

pass: All checks passed.
warn: At least one check failed with a WARN status but no check failed with an ALERT status.
alert: At least one check failed with an ALERT status.

Available options:

2,

3,

4

Example:

3

nameguard_result.labels.graphemes.risk_count

integer

required

The number of checks that have a status of alert or warn.

Example:

2

nameguard_result.labels.graphemes.highest_risk

object | null

required

The check considered to be the highest risk. If no check has a status of alert or warn, this field is null.

nameguard_result.labels.graphemes.normalization

enum<string>

required

The ENSIP-15 normalization status of a grapheme. This check does not consider the context of the grapheme and is not equivalent to ens_normalize(grapheme). A normalized grapheme can be combined with other normalized graphemes to form an unnormalized label. The position of a grapheme in a label can also affect the normalization status of the label.

normalized: The grapheme is normalized.
unnormalized: The grapheme is not normalized.

Available options:

normalized,

unnormalized

nameguard_result.labels.graphemes.grapheme

string

required

The analyzed grapheme.

Example:

"v"

nameguard_result.labels.graphemes.grapheme_name

string

required

The name of the grapheme.

Example:

"Latin Small Letter V"

nameguard_result.labels.graphemes.grapheme_type

string

required

The type of the grapheme. If all characters in the grapheme have the same type, that type is returned. Otherwise, special is returned.

simple_letter - [a-z]
simple_number - [0-9]
other_letter - a letter (single-char grapheme) in any script that is not simple; LC class http://www.unicode.org/reports/tr44/#GC_Values_Table
other_number - a digit (single-char grapheme) in any script that is not simple; N class http://www.unicode.org/reports/tr44/#GC_Values_Table
hyphen - a hyphen
dollarsign - a dollar sign
underscore - an underscore
emoji - an emoji or emoji ZWJ sequence
invisible - zero width joiner or non-joiner
special - for any grapheme that doesn't match one of the other classifications or if characters have different types

Example:

"simple_letter"

nameguard_result.labels.graphemes.grapheme_script

string

required

Script name of the grapheme computed from the script names of its characters.

Example:

"Latin"

nameguard_result.labels.graphemes.grapheme_description

string

required

Description of the grapheme type.

Example:

"A-Z letter"

nameguard_result.labels.graphemes.title

string

required

A human-readable title based on the rating.

nameguard_result.labels.graphemes.subtitle

string

required

A human-readable subtitle based on the rating.

nameguard_result.labels.canonical_label

string | null

required

The canonical form of the analyzed label.

null if the canonical form of any grapheme is not known
null if the result would be unnormalized, even if the canonical form of all graphemes is known
[labelhash] if the label is unknown

Example:

"vitalik"

nameguard_result.labels.title

string

required

A human-readable title based on the rating.

nameguard_result.labels.subtitle

string

required

A human-readable subtitle based on the rating.

nameguard_result.labels.beautiful_label

string | null

required

Beautified version of label.

nameguard_result.canonical_name

string | null

required

The canonical form of the analyzed name.

null if the canonical form of any label is not known
can contain labelhashes when some labels are unknown

Example:

"vitalik.eth"

nameguard_result.title

string

required

A human-readable title based on the rating.

nameguard_result.subtitle

string

required

A human-readable subtitle based on the rating.

nameguard_result.beautiful_name

string | null

required

Beautified version of name.

investigated_fields

object | null

required

Fields with values from Alchemy response which are investigated (e.g. title, collection name, metadata) whether they look like fake .eth ENS name.

null if status is unknown_nft

Reverse lookup of an Ethereum address to a primary name Inspect Grapheme GET

curl --request POST \
  --url https://api.nameguard.io/fake-eth-name-check \
  --header 'Content-Type: application/json' \
  --data '{
  "network_name": "mainnet"
  "contract_address": "0x495f947276749ce646f68ac8c248420045cb7b5e"
  "token_id": "61995921128521442959106650131462633744885269624153038309795231243542768648193"
  "fields": {"title": "nick.eth"}
}'

{
  "status": "authentic_eth_name",
  "nameguard_result": {
    "rating": 3,
    "risk_count": 2,
    "highest_risk": {
      "check": "confusables",
      "status": 3,
      "message": "<string>",
      "check_name": "<string>"
    },
    "name": "vitalìk.eth",
    "namehash": "0xd48fd5598e605861cbd8e45419b41b83739bff52eaef0e283181bbe0a43a5b32",
    "normalization": "normalized",
    "checks": [
      {
        "check": "confusables",
        "status": 3,
        "message": "<string>",
        "check_name": "<string>"
      }
    ],
    "labels": [
      {
        "rating": 3,
        "risk_count": 2,
        "highest_risk": {
          "check": "confusables",
          "status": 3,
          "message": "<string>",
          "check_name": "<string>"
        },
        "label": "vitalìk",
        "labelhash": "0x41459971a5b847d0eef67bc11e2845f1074a2aed1ac6a357378b18fba50816e4",
        "normalization": "normalized",
        "checks": [
          {
            "check": "confusables",
            "status": 3,
            "message": "<string>",
            "check_name": "<string>"
          }
        ],
        "graphemes": [
          {
            "rating": 3,
            "risk_count": 2,
            "highest_risk": {
              "check": "confusables",
              "status": 3,
              "message": "<string>",
              "check_name": "<string>"
            },
            "normalization": "normalized",
            "grapheme": "v",
            "grapheme_name": "Latin Small Letter V",
            "grapheme_type": "simple_letter",
            "grapheme_script": "Latin",
            "grapheme_description": "A-Z letter",
            "title": "<string>",
            "subtitle": "<string>"
          }
        ],
        "canonical_label": "vitalik",
        "title": "<string>",
        "subtitle": "<string>",
        "beautiful_label": "<string>"
      }
    ],
    "canonical_name": "vitalik.eth",
    "title": "<string>",
    "subtitle": "<string>",
    "beautiful_name": "<string>"
  },
  "investigated_fields": {}
}

NameGuard

SDK

API

Fake .eth ENS name check with fields

Performs a fake .eth ENS name check based on given NFT metadata.

Body

Response