Pular para o conteúdo
0%

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

Escrito por Mrig

Publicado em 20 de outubro de 20227 min de leitura

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 de usuários. Sem NFT APIs adequadas, indexar e consultar metadados de NFT se torna um processo demorado e que consome muitos recursos para desenvolvedores individuais.

Aprenda como começar a construir ferramentas de NFT, marketplaces, apps e mais com a 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 múltiplas transações em uma única transação e as enviam de volta para a Ethereum para validação, aumentando assim a escalabilidade da rede.

A escalabilidade nativa do Optimism o torna uma solução ideal para o desenvolvimento de projetos de NFT. Os usuários têm uma experiência melhor ao jogar jogos de NFT 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 certo de ferramentas para construir protocolos de NFT e interagir com um alto volume de NFTs. A Optimism NFT API da Alchemy é uma ferramenta essencial para desenvolvedores que constroem projetos de NFT para o ecossistema Optimism.

O que é uma Optimism NFT API?

A Optimism NFT API ajuda desenvolvedores a buscar informações instantaneamente na 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 a Optimism NFT API.

A Alchemy oferece uma NFT API multichain para desenvolvedores que usam as APIs padrão JSON-RPC para interagir com a infraestrutura de nós descentralizada do Optimism. A Optimism NFT API da Alchemy permite que os desenvolvedores tenham acesso a maior throughput de requisições, aumento de requisições simultâneas e uso gratuito de arquivos de dados, logs e métricas de uso individuais. 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. A Optimism NFT API da Alchemy consegue lidar com NFTs on-chain ou off-chain nos formatos JSON, SVG, UTF-8, gateways IPFS como o Pinata, e imagens codificadas em Base64.

Os desenvolvedores podem usar a NFT API da Alchemy para os seguintes fins:

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

Como funciona a Optimism NFT API?

A 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 de erro claras.

Cache de imagens

Os desenvolvedores normalmente interagem com provedores de armazenamento descentralizado como o 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, porque armazena em cache as imagens de NFT com o Cloudinary. Assim, a Alchemy consegue servir URLs de NFT a partir do próprio cache para os 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 normalmente precisam ler e analisar smart contracts individualmente para acessar os 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 rede específica.

Os desenvolvedores podem usar os filtros de spam da Alchemy para enviar NFTs de spam para queima (burn) ou sinalizar endereços de carteira que enviam NFTs de spam. Até agosto de 2022, a Alchemy NFT API 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 thumbnails, smartphones, desktops e viewports de tablet. Os desenvolvedores podem redimensionar NFTs hospedados pela Alchemy alterando URLs para incluir qualquer combinação de pixels de altura e largura e criar a proporção desejada. Assim, a Alchemy facilita o redimensionamento de imagens para desenvolvedores de NFT.

Erros de NFT

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

  • Token não existe - a Alchemy usa um ID de token 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 metadados.
  • Falha ao obter token URI - mensagem de erro genérica quando o ID do token 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 o URI retorna uma mensagem "502 Bad Gateway", caso o site esteja fora do ar ou esteja limitando a taxa 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 assim 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 tentar 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 pela Optimism NFT API

A Optimism NFT API da Alchemy ajuda desenvolvedores a construir apps de NFT no Optimism com as seguintes categorias de endpoints de 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 no 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 da Optimism NFT API

O getNFTs é um endpoint de NFT API versátil é um endpoint de NFT API versátil, que permite aos desenvolvedores usá-lo em múltiplos protocolos de NFT. Para entender como o endpoint da API getNFTs funciona, considere 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 pertencentes ao usuário. Os desenvolvedores podem usar a ferramenta de token gating de NFT do Optimism, isHolderOfCollection, para buscar NFTs de um endereço de carteira específico, caso ele possua um determinado token 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 a API de metadados de NFT 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 os proprietários de um NFT específico. Sem uma API, os desenvolvedores teriam que analisar toda a blockchain para rastrear a propriedade dos ativos NFT. No entanto, a API de coleção de NFT do Optimism 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 os usuários querem definir um NFT específico como sua foto de perfil.

Como começar a construir com a Optimism NFT API

Em vez de rodar seu próprio nó Optimism, é fácil criar um nó privado Optimism na Alchemy e, em seguida, seguir três passos simples para começar a construir com a 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 a partir da linha de comando para os scripts de início rápido
  3. Escolha uma biblioteca - instale o Alchemy SDK para interagir com a Optimism NFT API

Embora os desenvolvedores possam usar Fetch e Axios, a forma mais rápida de começar a usar a Optimism NFT API é com o SDK da Alchemy, pois ele oferece melhores recursos, com suporte a WebSocket, retries e muitos outros benefícios.

Use a 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 enorme potencial de crescimento futuro.

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

Background gradient

Construa magia blockchain

A Alchemy combina os produtos e ferramentas de desenvolvimento Web3 mais poderosos com recursos, comunidade e suporte lendário.