3 motivos importantes para usar o NFT API da Alchemy para getNFTs

Se você está construindo uma dApp de NFT, a NFT API da Alchemy pode ajudar você a criar experiências melhores para seus usuários usando get requests, como getNFTs e getOwnersForToken. Vamos ver o que esses métodos fazem e por que devemos usá-los em nossas builds de NFT.

O que é getNFTs?

getNFTs é um endpoint da NFT API que permite aos desenvolvedores obter a lista de todas as NFTs, incluindo tokens ERC-721 e ERC-1155, pertencentes a um determinado endereço de proprietário. Você pode informar um endereço de proprietário ou um nome ENS, e a API retornará a lista de todas as NFTs pertencentes a esse endereço, junto com o metadata das NFTs.

Exemplos de casos de uso para getNFTs

getNFTs é um dos endpoints mais versáteis da NFT API e pode ser usado em uma variedade de produtos web3, incluindo carteiras para exibir NFTs, marketplaces de NFT, ferramentas de análise de NFT, sites de ranking de raridade de NFT, bots do Discord, entre outros casos de uso.

Por exemplo, se você acessar a página de perfil da sua conta na OpenSea, você conseguirá ver quais NFTs você possui. Isso é feito por um endpoint que usa getNFTs para retornar as NFTs pertencentes ao seu endereço de carteira e o metadata relacionado às NFTs.

De forma mais ampla, getNFTs pode ser útil em qualquer situação em que seja necessário saber o que um usuário possui. Por exemplo, uma requisição getNFTs poderia alimentar ferramentas de análise de NFT, como sites de ranking de raridade, ou um bot do Discord, trazendo dados e informando qual NFT acabou de ser vendida, em qual marketplace foi vendida e qualquer outro metadata relevante.

O que é getOwnersForToken?

getOwnersForToken é uma API que permite especificar um smart contract de NFT e retornar a lista de todos os proprietários daquele token. Para tokens ERC-721, getOwnersForToken retornará apenas um único proprietário, mas para tokens ERC-1155, que podem ter múltiplos proprietários, getOwnersForToken pode retornar mais de um endereço de carteira.

Exemplos de casos de uso para getOwnersForToken

getOwnersForToken tem múltiplos casos de uso, incluindo airdrops, atualizações de cache para mudanças de propriedade de NFT e verificações de foto de perfil.

Se você está gerenciando um projeto de mint de NFT e quer fazer um airdrop para os proprietários de um token específico, getOwnersForToken permite identificar essa allowlist.

Da mesma forma, se você tem uma foto de perfil e quer verificar a propriedade, você pode usar essa API para checar se a propriedade mudou.

Sem o getOwnersforToken, não há uma solução conveniente para esses casos de uso, pois os desenvolvedores teriam que analisar toda a blockchain para descobrir como a propriedade de uma única NFT mudou ao longo do tempo. Agora, com a NFT API da Alchemy, a API getOwnersForToken consegue realizar essa tarefa com uma única requisição.

3 motivos para usar a NFT API da Alchemy para obter NFTs

Construir com a NFT API da Alchemy é a melhor escolha para obter NFTs por causa da sua cobertura, dos filtros de spam e do cache de imagens.

1. Cobertura de NFT

A NFT API da Alchemy tem a mais ampla cobertura de NFTs, o que é um desafio porque o metadata de NFT existe on chain, off chain e em formatos inconsistentes, o que gera muitos casos extremos para registrar o metadata com precisão.

Ter o metadata de NFT existindo em múltiplos formatos diferentes e em múltiplos ambientes diferentes torna a determinação do metadata correto de uma NFT um problema complicado.

A Alchemy consegue oferecer a cobertura de NFT mais completa por ter projetado múltiplos code paths para superar muitos dos casos mais recorrentes, incluindo, mas não se limitando a, lidar com metadata:

• On chain ou off-chain em formato JSON
• On chain ou off-chain em formato SVG
• On chain ou off-chain em formato UTF-8

A NFT API da Alchemy também consegue lidar com SVGs, NFTs que usam IPFS gateways como o Pinata, URIs que apontam para uma imagem em um local secundário off-chain, imagens codificadas em base 64, e muitas outras implementações.

Como obtemos o metadata de NFT?

Obter o metadata de uma NFT é um processo complicado, com muitas variações, mas a NFT API da Alchemy oferece uma solução simples para que você não precise perder tempo valioso pensando em cada caso de uso individualmente.

Para obter o metadata de uma NFT, começamos com um ID, que é um endereço de contrato e um token ID que juntos formam o identificador único da NFT.

Esse ID é verificado no cache de NFT da Alchemy para ver se a informação já existe. Se não estiver no cache, precisamos investigar que tipo de NFT é e a qual padrão o contrato segue.

Atualmente, a Alchemy suporta dois grandes padrões de NFT: smart contracts ERC-721 e ERC-1155.

Free video demo

Veja o dashboard da Alchemy em ação

Tour guiado de 30 minutos: todas as ferramentas do dashboard, demonstradas ao vivo.

Watch the demo

Um padrão ERC-721 propriamente dito deve fornecer um esquema que contenha o título e as propriedades da NFT, incluindo nome, descrições e imagem, e deve suportar alguns métodos adicionais.

Em teoria, você deve conseguir identificar se uma NFT suporta esse padrão por meio de uma support interface call, e o contrato responderá com a resposta.

Como esses contratos são programáveis, um desenvolvedor pode, intencionalmente ou por engano, programar o contrato para responder de forma incorreta, o que significa que precisamos observar outras propriedades do contrato para garantir que ele realmente suporta a interface.

Depois de determinar que o smart contract é de fato uma NFT, você pode perguntar ao contrato ou ao token pela localização do metadata. Para um contrato ERC721, o método que você chama é o método token URI, enquanto para um contrato 1155, ele é chamado simplesmente de método URI.

O URI aponta para um local na internet, ou um local on-chain, onde o metadata da NFT existe. Alguns contratos, quando questionados sobre essa localização, apontam para um arquivo, enquanto outros fornecem incorretamente o metadata diretamente no token URI.

Se o URI apontar para outro local, precisaremos seguir o link, geralmente para um site ou servidor de terceiros, o que traz seu próprio conjunto de problemas. Esses sites podem estar quebrados, ser maliciosos ou ter rate limit, mas a Alchemy resolve isso para retornar a informação de forma limpa.

Com tantas implementações diferentes entre os smart contracts ERC-721 e ERC-1155, ter uma cobertura de dados precisa e ampla de NFTs é um desafio persistente. Usar a NFT API da Alchemy é a melhor forma de garantir a máxima cobertura de NFTs conhecidas.

2. Filtros de spam de NFT

O filtro de spam da Alchemy para getNFTs facilita ainda mais o desenvolvimento ao filtrar NFTs de spam, que são airdrops não solicitados ou smart contracts de NFT que violam os padrões ERC-721 e ERC-1155.

Além das opções de filtragem nativas do getNFTs, o novo getSpamContracts da Alchemy retornará a lista de todos os contratos de spam ERC-721 e ERC-1155 na chain selecionada.

Da mesma forma, isSpamForContract verifica se um determinado smart contract de NFT foi classificado como spam. Você pode filtrar por endereços de contrato, o que significa que também pode procurar os proprietários de uma NFT específica e verificar se essa é a única que eles possuem.

A Alchemy é a única plataforma com um filtro de spam de NFT, e é extremamente difícil se engajar com NFTs quando você está sobrecarregado por spam.

3. Cache de imagens de NFT

O cache de imagens da Alchemy resulta em respostas mais rápidas e tempos de carregamento mais rápidos para imagens de NFT. Embora a mídia de NFT seja tradicionalmente servida a partir do IPFS, de provedores de armazenamento descentralizado ou de servidores de terceiros, os desenvolvedores frequentemente enfrentam tempos de carregamento lentos e erros de timeout ao usar esses endpoints. A Alchemy resolve esse problema fazendo cache das imagens de NFT usando o Cloudinary e servindo as URLs de NFT a partir do nosso próprio cache, tornando as recuperações mais rápidas.

Qual NFT API eu devo escolher?

Por causa dos endpoints robustos da Alchemy, incluindo filtros de spam, getFloorPrice e reingestContract, da melhor cobertura de NFT, incluindo suporte para Crypto Punks, e dos dados mais precisos, a NFT API da Alchemy é a melhor escolha para desenvolvedores web3.

Cadastre-se para uma conta na Alchemy e veja como a NFT API da Alchemy pode ajudar você a construir seu próximo projeto de NFT, ou saiba mais sobre como a Alchemy pode ajudar você em sua jornada web3.