Discord / Telegram bots

If you have a project using Discord or Telegram for verification features (ie: possession of specific NFTs / or permission tokens) then NFDs are an excellent way to let users get access without having to do anything other than provide their NFD name !

Users can verify their Discord and Telegram accounts via NFDs. If users perform this verification, their ID will be stored as a 'verified' property in their NFD and provide a trivial way of sign on w/ proven on-chain metadata.

Verifying a Discord handle

Once a user has verified their Discord ID, their Discord 'snowflake' ID will be set in properties.verified.discord in the 'full' view of an NFD fetch.

To use NFDs for verification, a bot simply needs to use the users' snowflake ID and find all NFDs that have that ID as a verified discord handle. You will be able to know the Algorand accounts are all theirs, no webpage has to be popped, nor transactions to sign.

The bot should query the API (See NFDomains REST API Reference), the /nfd/v2/search?vproperty=discord&vvalue={snowflakeid} endpoint specifically (with the 'full' view), for the id of the user.

Search NFDs via various filters

Search NFDs via various filters

GEThttps://api.nf.domains/nfd/v2/search

Query parameters

Header parameters

Response

200304400404429

OK response.

Headers

Body

application/json

match-checkstring

Not returned, used in tagging for response to indicate if-none-match etag matched

nfds*NfdRecordCollection (array of NfdRecord (object))

total*integer (int64)

total number of results, with data containing paged amount based on offset/limit

Request

JavaScriptCurl

const response = await fetch('https://api.nf.domains/nfd/v2/search', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "match-check": "Nesciunt numquam ullam accusantium et debitis autem.",
  "nfds": [
    {
      "appID": 1000000,
      "asaID": 5020498933399342000,
      "avatarOutdated": false,
      "caAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ],
      "cache-control": "Voluptas ea molestiae eligendi et asperiores.",
      "category": "Ut eos aspernatur.",
      "currentAsOfBlock": 2761096942291864600,
      "depositAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "etag": "Sequi dolor fugiat.",
      "match-check": "Vel et enim numquam et qui incidunt.",
      "metaTags": [
        "Saepe libero eum eaque quo assumenda.",
        "Animi voluptatem est minus.",
        "Tenetur reprehenderit sunt adipisci necessitatibus."
      ],
      "name": "Autem ab.",
      "nfdAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "owner": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "parentAppID": 1000000,
      "properties": {
        "internal": {
          "Animi veniam eum esse eos et porro.": "Ullam veritatis qui placeat quo.",
          "Quidem a nesciunt.": "Et alias dolor debitis veniam.",
          "Ut repellendus doloribus omnis quidem sed omnis.": "In aut neque vel."
        },
        "userDefined": {
          "ca:p": "Eveniet architecto consequatur."
        },
        "verified": {
          "caAlgo": "Nostrum ea."
        }
      },
      "reservedFor": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "saleType": "Ad veritatis nobis esse error pariatur veniam.",
      "sellAmount": 4924974612238891000,
      "seller": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "sigNameAddress": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "state": "Nobis nesciunt.",
      "tags": [
        "Necessitatibus necessitatibus molestias cumque veritatis earum non.",
        "Voluptatem quia rerum.",
        "Dolor nesciunt minus sequi.",
        "Laborum voluptas consequatur aliquam doloremque."
      ],
      "timeChanged": "1991-02-07T01:20:39Z",
      "timeCreated": "2015-03-30T18:41:32Z",
      "timePurchased": "2015-12-09T05:54:10Z",
      "unverifiedCa": {
        "btc": [
          "12KKDt4Mj7N5UAkQMN7LtPZMayenXHa8KL"
        ]
      },
      "unverifiedCaAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ]
    },
    {
      "appID": 1000000,
      "asaID": 5020498933399342000,
      "avatarOutdated": false,
      "caAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ],
      "cache-control": "Voluptas ea molestiae eligendi et asperiores.",
      "category": "Ut eos aspernatur.",
      "currentAsOfBlock": 2761096942291864600,
      "depositAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "etag": "Sequi dolor fugiat.",
      "match-check": "Vel et enim numquam et qui incidunt.",
      "metaTags": [
        "Saepe libero eum eaque quo assumenda.",
        "Animi voluptatem est minus.",
        "Tenetur reprehenderit sunt adipisci necessitatibus."
      ],
      "name": "Autem ab.",
      "nfdAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "owner": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "parentAppID": 1000000,
      "properties": {
        "internal": {
          "Animi veniam eum esse eos et porro.": "Ullam veritatis qui placeat quo.",
          "Quidem a nesciunt.": "Et alias dolor debitis veniam.",
          "Ut repellendus doloribus omnis quidem sed omnis.": "In aut neque vel."
        },
        "userDefined": {
          "ca:p": "Eveniet architecto consequatur."
        },
        "verified": {
          "caAlgo": "Nostrum ea."
        }
      },
      "reservedFor": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "saleType": "Ad veritatis nobis esse error pariatur veniam.",
      "sellAmount": 4924974612238891000,
      "seller": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "sigNameAddress": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "state": "Nobis nesciunt.",
      "tags": [
        "Necessitatibus necessitatibus molestias cumque veritatis earum non.",
        "Voluptatem quia rerum.",
        "Dolor nesciunt minus sequi.",
        "Laborum voluptas consequatur aliquam doloremque."
      ],
      "timeChanged": "1991-02-07T01:20:39Z",
      "timeCreated": "2015-03-30T18:41:32Z",
      "timePurchased": "2015-12-09T05:54:10Z",
      "unverifiedCa": {
        "btc": [
          "12KKDt4Mj7N5UAkQMN7LtPZMayenXHa8KL"
        ]
      },
      "unverifiedCaAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ]
    },
    {
      "appID": 1000000,
      "asaID": 5020498933399342000,
      "avatarOutdated": false,
      "caAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ],
      "cache-control": "Voluptas ea molestiae eligendi et asperiores.",
      "category": "Ut eos aspernatur.",
      "currentAsOfBlock": 2761096942291864600,
      "depositAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "etag": "Sequi dolor fugiat.",
      "match-check": "Vel et enim numquam et qui incidunt.",
      "metaTags": [
        "Saepe libero eum eaque quo assumenda.",
        "Animi voluptatem est minus.",
        "Tenetur reprehenderit sunt adipisci necessitatibus."
      ],
      "name": "Autem ab.",
      "nfdAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "owner": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "parentAppID": 1000000,
      "properties": {
        "internal": {
          "Animi veniam eum esse eos et porro.": "Ullam veritatis qui placeat quo.",
          "Quidem a nesciunt.": "Et alias dolor debitis veniam.",
          "Ut repellendus doloribus omnis quidem sed omnis.": "In aut neque vel."
        },
        "userDefined": {
          "ca:p": "Eveniet architecto consequatur."
        },
        "verified": {
          "caAlgo": "Nostrum ea."
        }
      },
      "reservedFor": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "saleType": "Ad veritatis nobis esse error pariatur veniam.",
      "sellAmount": 4924974612238891000,
      "seller": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "sigNameAddress": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "state": "Nobis nesciunt.",
      "tags": [
        "Necessitatibus necessitatibus molestias cumque veritatis earum non.",
        "Voluptatem quia rerum.",
        "Dolor nesciunt minus sequi.",
        "Laborum voluptas consequatur aliquam doloremque."
      ],
      "timeChanged": "1991-02-07T01:20:39Z",
      "timeCreated": "2015-03-30T18:41:32Z",
      "timePurchased": "2015-12-09T05:54:10Z",
      "unverifiedCa": {
        "btc": [
          "12KKDt4Mj7N5UAkQMN7LtPZMayenXHa8KL"
        ]
      },
      "unverifiedCaAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ]
    },
    {
      "appID": 1000000,
      "asaID": 5020498933399342000,
      "avatarOutdated": false,
      "caAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ],
      "cache-control": "Voluptas ea molestiae eligendi et asperiores.",
      "category": "Ut eos aspernatur.",
      "currentAsOfBlock": 2761096942291864600,
      "depositAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "etag": "Sequi dolor fugiat.",
      "match-check": "Vel et enim numquam et qui incidunt.",
      "metaTags": [
        "Saepe libero eum eaque quo assumenda.",
        "Animi voluptatem est minus.",
        "Tenetur reprehenderit sunt adipisci necessitatibus."
      ],
      "name": "Autem ab.",
      "nfdAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "owner": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "parentAppID": 1000000,
      "properties": {
        "internal": {
          "Animi veniam eum esse eos et porro.": "Ullam veritatis qui placeat quo.",
          "Quidem a nesciunt.": "Et alias dolor debitis veniam.",
          "Ut repellendus doloribus omnis quidem sed omnis.": "In aut neque vel."
        },
        "userDefined": {
          "ca:p": "Eveniet architecto consequatur."
        },
        "verified": {
          "caAlgo": "Nostrum ea."
        }
      },
      "reservedFor": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "saleType": "Ad veritatis nobis esse error pariatur veniam.",
      "sellAmount": 4924974612238891000,
      "seller": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "sigNameAddress": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "state": "Nobis nesciunt.",
      "tags": [
        "Necessitatibus necessitatibus molestias cumque veritatis earum non.",
        "Voluptatem quia rerum.",
        "Dolor nesciunt minus sequi.",
        "Laborum voluptas consequatur aliquam doloremque."
      ],
      "timeChanged": "1991-02-07T01:20:39Z",
      "timeCreated": "2015-03-30T18:41:32Z",
      "timePurchased": "2015-12-09T05:54:10Z",
      "unverifiedCa": {
        "btc": [
          "12KKDt4Mj7N5UAkQMN7LtPZMayenXHa8KL"
        ]
      },
      "unverifiedCaAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ]
    }
  ],
  "total": 8748286736289853000
}

If NFD(s) are returned for that discord ID, then all the 'related' accounts of those NFDs can be examined.

These are:

• Owner - the owner of the account is guaranteed and can't be impersonated.

• nfdAccount - this is the account address of the NFD itself. NFDs can contain assets and this will come into play more in the future.

• caAlgo[*] - the list of accounts in the caAlgo array are the accounts the user has explicitly linked to their NFD and all are accounts the user can sign for.

All of these accounts can be searched by the bot to check for ownership of membership assets (like owning a particular NFT or other membership token). If found in any of these accounts, then the discord user (which owns that NFD) can be assigned specific roles which require proof of ownership.

Because users can either sell their NFDs, or the assets which gave them access, it is suggested that bots store the discord id and periodically reassert the above search/account checks. If the user either sells their asset or perhaps links additional accounts that grant additional rights, the bot should remove or add roles as appropriate.