Tudo o que você precisa saber sobre a Optimism NFT API da Alchemy

As coleções de NFT estão em alta no Optimism, com mais desenvolvedores construindo novos apps de NFT na rede. Esses desenvolvedores precisam de NFT APIs para consultar a rede e obter metadados de NFT para atender solicitações de dados dos usuários. Sem NFT APIs adequadas, indexar e consultar metadados de NFT se torna um processo que consome tempo e recursos para desenvolvedores individuais.

Saiba como começar a construir ferramentas, marketplaces, apps e mais para NFT com o Optimism NFT API da Alchemy.

O ecossistema de NFT do Optimism

Optimism é uma solução de escalabilidade L2 (layer 2) para Ethereum, rodando sobre infraestrutura de optimistic rollup. Optimistic rollups reduzem a carga sobre a Ethereum ao realizar transações off-chain, oferecendo assim maior throughput de transações e taxas de gas reduzidas. Optimistic rollups agrupam várias transações em uma única transação e as enviam de volta para a Ethereum para validação, aumentando a escalabilidade da rede.

A escalabilidade nativa do Optimism o torna uma solução ideal para desenvolver projetos de NFT. Os usuários têm uma experiência aprimorada ao jogar NFT games ou negociar colecionáveis com as transações rápidas e taxas baixas do Optimism.

Com mais de 1 milhão de ativos NFT no Optimism distribuídos em 238 mil carteiras de NFT, segundo o site Optimism NFTScan, os desenvolvedores precisam do conjunto de ferramentas certo para construir protocolos de NFT e interagir com um alto volume de NFTs. O Optimism NFT API da Alchemy é uma ferramenta essencial para desenvolvedores que constroem projetos de NFT no ecossistema Optimism.

O que é um Optimism NFT API?

O Optimism NFT API ajuda desenvolvedores a obter instantaneamente informações da rede L2. Os desenvolvedores podem ler dados de blocos/transações, executar smart contracts, consultar informações on-chain e armazenar dados on-chain com o Optimism NFT API.

A Alchemy oferece um NFT API multichain para desenvolvedores que usam as APIs padrão JSON-RPC para interagir com a infraestrutura de nós descentralizada do Optimism. O Optimism NFT API da Alchemy permite que os desenvolvedores acessem maior throughput de requisições, aumentem requisições simultâneas e usem arquivos de dados, logs e métricas de uso individuais gratuitos. Além disso, a solução suporta todos os NFTs que seguem os padrões ERC-721 e ERC-1155, e alguns NFTs anteriores aos contratos de NFT padronizados da Ethereum.

Os desenvolvedores também têm acesso a uma ampla gama de NFTs e seus metadados por meio de múltiplos caminhos de código. O Optimism NFT API da Alchemy consegue lidar com NFTs on-chain ou off-chain nos formatos JSON, SVG, UTF-8, gateways IPFS como Pinata, e imagens codificadas em Base64.

Os desenvolvedores podem usar o NFT API da Alchemy para os seguintes propósitos:

• Exibir NFTs para os usuários
• Desenvolver um marketplace de NFT
• Projetar um protocolo de análise de NFT
• Construir aplicações de jogos com NFT
• Verificar a propriedade de NFTs

Como funciona o Optimism NFT API?

O Optimism NFT API da Alchemy usa os seguintes mecanismos para alcançar alto desempenho: cache de imagens, filtros de spam, redimensionamento de imagens e descrições claras de erros.

Cache de imagens

Os desenvolvedores geralmente interagem com provedores de armazenamento descentralizado como IPFS e servidores de terceiros para acessar arquivos de mídia de NFT. No entanto, eles enfrentam tempos de carregamento mais longos e erros de timeout.

A Alchemy oferece uma solução de baixa latência, com carregamento rápido e respostas ágeis, pois armazena em cache as imagens de NFT com o Cloudinary. Assim, a Alchemy consegue servir URLs de NFT a partir do próprio cache aos desenvolvedores, reduzindo o tempo de resposta.

Filtros de spam

NFTs de spam indesejados podem levar a golpes e prejudicar a experiência do usuário em um marketplace, galeria ou plataforma de análise de NFT. Os desenvolvedores geralmente precisam ler e analisar smart contracts individuais para acessar metadados de NFT e filtrar NFTs de spam. Para simplificar esse processo, a Alchemy oferece os seguintes endpoints de API como filtros de spam de NFT:

• isSpamForContract - verifica smart contracts de NFT de spam. Os desenvolvedores também podem filtrar endereços de contrato para verificar os proprietários de NFTs de spam.
• getSpamContracts - retorna a lista de smart contracts ERC-721 e ERC-1155 de spam de uma determinada rede.

Os desenvolvedores podem usar os filtros de spam da Alchemy para enviar NFTs de spam para queima ou sinalizar endereços de carteira que enviam NFTs de spam. Até agosto de 2022, o NFT API da Alchemy havia marcado 5.000 smart contracts como NFTs de spam.

A Alchemy usa os seguintes critérios para identificar NFTs de spam:

1. Viola os padrões de token ERC-721 e ERC-1155
2. Viola os padrões de token durante transferências de token
3. Cunha tokens para endereços honeypot como vitalik.eth
4. Fornece dados falsos sobre o fornecimento total de tokens

Redimensionamento de imagens

NFTs precisam de diferentes tamanhos de imagem para miniaturas, smartphones, desktops e viewports de tablets. Os desenvolvedores podem redimensionar NFTs hospedados na Alchemy alterando as URLs para incluir qualquer combinação de pixels de altura e largura, criando a proporção desejada. Assim, a Alchemy facilita o redimensionamento de imagens para desenvolvedores de NFT.

Erros de NFT

Embora o NFT API da Alchemy retorne a maioria dos metadados de NFT, ele falha em atender a solicitação nas seguintes situações:

• Token não existe - a Alchemy usa um token ID para chamar o método tokenURI/uri, mas o smart contract não o reconhece. Isso significa que o token ainda não foi cunhado ou não existe.
• Token URI malformado - tokenURI/uri retorna um site "malformado" ou inválido e, portanto, não é possível acessar o site para retornar os metadados.
• Falha ao obter token URI - mensagem de erro genérica quando o token ID não retorna nenhum metadado, mesmo que o token exista.
• Token URI retorna um código de resposta diferente de 200 - esse erro aparece quando a URI retorna uma mensagem "502 Bad Gateway", caso o site esteja fora do ar ou esteja limitando a taxa de requisições dos servidores da Alchemy.
• Token URI limitado (throttled) - esse erro retorna uma mensagem "429 Too Many Requests", indicando que a Alchemy solicitou metadados com muita frequência, sofrendo limitação de taxa.
• Contrato não possui código - esse erro aparece quando um endereço de token não possui um código de smart contract correspondente na rede blockchain.
• Contrato retornou um token URI quebrado, não tente novamente - essa mensagem de erro aparece quando o tokenURI não responde porque a URL do site pode não existir ou não possui configuração de DNS.

Métodos suportados pelo Optimism NFT API

O Optimism NFT API da Alchemy ajuda desenvolvedores a construir apps de NFT no Optimism com as seguintes categorias de endpoints do NFT API:

Propriedade de NFT e token gating no Optimism

• getNFTs - obtém NFTs do Optimism pertencentes a uma carteira
• getOwnersForToken - obtém os proprietários de um token no Optimism
• getOwnersForCollection - obtém os proprietários de NFT de uma coleção no Optimism
• isHolderOfCollection - verifica se a carteira do Optimism possui um NFT
• getNFTsForCollection - obtém NFTs de uma coleção de NFT no Optimism

Metadados de NFT no Optimism

• getNFTMetadata - obtém metadados de NFT no Optimism
• getContractMetadata - obtém metadados do smart contract de NFT no Optimism

Exemplos do Optimism NFT API

O getNFTs é um endpoint de NFT API versátil é um endpoint de NFT API versátil, permitindo que os desenvolvedores o utilizem em múltiplos protocolos de NFT. Para entender como o endpoint getNFTs funciona, veja os exemplos a seguir.

1. Token gating no Optimism

Quando os desenvolvedores constroem um marketplace de NFT, eles projetam uma página de perfil de usuário que exibe os NFTs de propriedade do usuário. Os desenvolvedores podem usar a ferramenta de token gating de NFT do Optimism, isHolderOfCollection, para buscar NFTs de um determinado endereço de carteira caso ele possua um token específico de uma coleção especificada.

2. Ferramenta de análise de NFT no Optimism

Ferramentas de análise de NFT, como sites de ranking de raridade ou agregadores, precisam de metadados de NFT para criar listas e obter dados de negociação. Os desenvolvedores podem usar o NFT metadata API do Optimism, getNFTMetadata, para recuperar os metadados on-chain usados em ferramentas de análise de NFT.

3. Listas de airdrop de NFT no Optimism

Um projeto de NFT contrata desenvolvedores para fazer airdrop de novos NFTs para proprietários de um NFT específico. Sem uma API, os desenvolvedores teriam que analisar toda a blockchain para rastrear a propriedade dos ativos de NFT. No entanto, o Optimism NFT collection API da Alchemy, getOwnersForToken, permite que os desenvolvedores identifiquem instantaneamente os proprietários e criem a lista de airdrop. Os desenvolvedores também podem usar essa API para verificar a propriedade de um ativo quando usuários querem usar um NFT específico como foto de perfil.

Como começar a construir com o Optimism NFT API

Em vez de rodar seu próprio nó Optimism, é fácil criar um nó Optimism privado na Alchemy, e então seguir três passos simples para começar a construir com o Optimism NFT API da Alchemy:

1. Escolha um gerenciador de pacotes - use um gerenciador de pacotes como npm ou yarn
2. Configure o repositório - abra um terminal para criar um novo repositório pela linha de comando para os scripts de quickstart
3. Escolha uma biblioteca - use Fetch, Axios ou outra biblioteca HTTP padrão para interagir com o Optimism NFT API

Os desenvolvedores podem chamar o Optimism NFT API diretamente com Fetch ou Axios. Consulte a documentação da Alchemy para exemplos atuais de endpoints e métodos suportados.

Use o melhor Optimism NFT API com a Alchemy

Durante o bull run de 2021, o mercado de NFT ultrapassou US$ 40 bilhões, segundo a Bloomberg. Embora o setor de NFT esteja atualmente passando por uma fase difícil de bear market, a tecnologia NFT tem um potencial imenso de crescimento futuro.

Portanto, os desenvolvedores precisarão das ferramentas certas para criar seus apps de NFT na rede escalável do Optimism. Crie uma conta gratuita na Alchemy e comece a construir apps de NFT com o NFT API gratuito da Alchemy.