Todo lo que necesitas saber sobre el Optimism NFT API de Alchemy
Escrito por Mrig
Las colecciones de NFT están en auge en Optimism, con más desarrolladores construyendo nuevas apps de NFT en la red. Estos desarrolladores necesitan NFT APIs para consultar la red y obtener metadata de NFT para responder solicitudes de datos de usuarios. Sin las NFT APIs adecuadas, indexar y consultar metadata de NFT se convierte en un procedimiento que consume tiempo y recursos para desarrolladores individuales.
Aprende a empezar a construir herramientas, marketplaces, apps y más de NFT con el NFT API de Optimism de Alchemy.
El ecosistema de NFT de Optimism
Optimism es una solución de escalado L2 (layer 2) para Ethereum, que opera sobre infraestructura de optimistic rollup. Los optimistic rollups reducen la carga sobre Ethereum al realizar transacciones fuera de la cadena, ofreciendo así mayor throughput de transacciones y menores costos de gas. Los optimistic rollups agrupan múltiples transacciones en una sola transacción y las envían de vuelta a Ethereum para su validación, mejorando así la escalabilidad de la red.
La escalabilidad integrada de Optimism la convierte en una solución ideal para desarrollar proyectos de NFT. Los usuarios obtienen una experiencia mejorada al jugar juegos con NFT o intercambiar coleccionables gracias a las transacciones de alta velocidad y las comisiones bajas de Optimism.
Con más de 1 millón de activos NFT en Optimism distribuidos en 238K wallets de NFT, según el sitio web Optimism NFTScan, los desarrolladores necesitan el conjunto de herramientas correcto para construir protocolos de NFT e interactuar con un alto volumen de NFTs. El NFT API de Optimism de Alchemy es una herramienta principal que los desarrolladores necesitan para construir proyectos de NFT para el ecosistema de Optimism.
¿Qué es un NFT API de Optimism?
El NFT API de Optimism ayuda a los desarrolladores a obtener información de forma instantánea desde la red L2. Los desarrolladores pueden leer datos de bloques/transacciones, ejecutar smart contracts, consultar información on-chain y almacenar datos on-chain con el NFT API de Optimism.
Alchemy ofrece un NFT API multichain para desarrolladores que usa los APIs estándar JSON-RPC para interactuar con la infraestructura de nodos descentralizada de Optimism. El NFT API de Optimism de Alchemy permite a los desarrolladores acceder a mayor throughput de solicitudes, aumentar las solicitudes concurrentes y usar archivos de datos, logs y métricas de uso individuales de forma gratuita. Además, la solución admite todos los NFTs que siguen los estándares ERC-721 y ERC-1155, y ciertos NFTs anteriores a los contratos estandarizados de NFT de Ethereum.
Los desarrolladores también obtienen acceso a una amplia variedad de NFTs y su metadata a través de múltiples rutas de código. El NFT API de Optimism de Alchemy puede manejar NFTs on-chain u off-chain en formato JSON, SVG, UTF-8, gateways de IPFS como Pinata, e imágenes codificadas en Base64.
Los desarrolladores pueden usar el NFT API de Alchemy para los siguientes fines:
- Mostrar NFTs a los usuarios
- Desarrollar un marketplace de NFT
- Diseñar un protocolo de analítica de NFT
- Construir aplicaciones de gaming con NFT
- Verificar la propiedad de NFTs
¿Cómo funciona el NFT API de Optimism?
El NFT API de Optimism de Alchemy usa los siguientes mecanismos para lograr un funcionamiento de alto rendimiento: caching de imágenes, filtros de spam, redimensionamiento de imágenes y descripciones de error claras.
Caching de imágenes
Los desarrolladores suelen interactuar con proveedores de almacenamiento descentralizado como IPFS y servidores de terceros para acceder a archivos multimedia de NFT. Sin embargo, enfrentan tiempos de carga largos y errores de timeout.
Alchemy ofrece una solución de baja latencia con carga rápida y respuestas ágiles porque almacena en caché las imágenes de NFT con Cloudinary. Así, Alchemy puede servir las URLs de NFT desde su propia caché a los desarrolladores, reduciendo el tiempo de respuesta.
Filtros de spam
Los NFTs de spam no deseados pueden generar estafas y dificultar la experiencia del usuario en un marketplace, galería o plataforma de analítica de NFT. Los desarrolladores normalmente tienen que leer y analizar smart contracts individuales para acceder a la metadata de NFT y filtrar los NFTs de spam. Para simplificar esto, Alchemy ofrece los siguientes endpoints de API como filtros de spam de NFT:
- isSpamForContract - verifica si un smart contract de NFT es spam. Los desarrolladores también pueden filtrar direcciones de contrato para verificar propietarios de NFTs de spam.
- getSpamContracts - devuelve la lista de smart contracts ERC-721 y ERC-1155 de spam de una red particular.
Los desarrolladores pueden usar los filtros de spam de Alchemy para enviar NFTs de spam a quemar o marcar direcciones de wallet que envían NFTs de spam. Para agosto de 2022, el NFT API de Alchemy había marcado 5,000 smart contracts como NFTs de spam.
Alchemy usa los siguientes criterios para identificar NFTs de spam:
- Incumple los estándares de token ERC-721 y ERC-1155
- Incumple los estándares de token durante las transferencias de tokens
- Acuña tokens hacia direcciones honeypot como vitalik.eth
- Proporciona datos falsos sobre el suministro total de tokens
Redimensionamiento de imágenes
Los NFTs necesitan diferentes tamaños de imagen para thumbnails, smartphones, escritorios y viewports de tablet. Los desarrolladores pueden redimensionar NFTs alojados en Alchemy cambiando las URLs para incluir cualquier combinación de píxeles de alto y ancho y crear el aspect ratio. Así, Alchemy facilita el redimensionamiento de imágenes para los desarrolladores de NFT.
Errores de NFT
Aunque el NFT API de Alchemy devuelve la mayoría de la metadata de NFT, falla en cumplir la solicitud en los siguientes casos:
- Token does not exist - Alchemy usa un ID de token para llamar al método tokenURI/uri, pero el smart contract no lo reconoce. Esto significa que el token aún no ha sido acuñado o no existe.
- Malformed token URI - tokenURI/uri devuelve un sitio web "malformado" o inválido, por lo que no se puede acceder al sitio web para devolver la metadata.
- Failed to get token URI - mensaje de error genérico cuando el ID de token no devuelve ninguna metadata, incluso si el token existe.
- Token URI returns a non-200 response code - este error aparece cuando el URI devuelve un mensaje "502 Bad Gateway" porque el sitio web está caído o limita la tasa de solicitudes de los servidores de Alchemy.
- Throttled token URI - este error devuelve un mensaje "429 Too Many Requests", indicando que Alchemy ha solicitado la metadata con demasiada frecuencia, por lo que se le aplica un límite de tasa.
- Contract does not have any code - este error aparece cuando una dirección de token no tiene un código de smart contract correspondiente en la red blockchain.
- Contract returned a broken token URI, do not retry - este mensaje de error aparece cuando el tokenURI no responde porque la URL del sitio web puede no existir, o carece de configuración DNS.
Métodos compatibles del NFT API de Optimism
El NFT API de Optimism de Alchemy ayuda a los desarrolladores a construir apps de NFT en Optimism con las siguientes categorías de endpoints de NFT API:
Propiedad de NFT y token gating en Optimism
- getNFTs - obtiene los NFTs de Optimism que posee una wallet
- getOwnersForToken - obtiene los propietarios de Optimism para un token
- getOwnersForCollection - obtiene los propietarios de NFT de Optimism para una colección
- isHolderOfCollection - verifica si la wallet de Optimism posee un NFT
- getNFTsForCollection - obtiene los NFTs de una colección de NFT de Optimism
Metadata de NFT de Optimism
- getNFTMetadata - obtiene la metadata de NFT de Optimism
- getContractMetadata - obtiene la metadata del smart contract de NFT de Optimism
Ejemplos del NFT API de Optimism
El getNFTs de Alchemy es un endpoint de NFT API versátil es un endpoint de NFT API versátil, que permite a los desarrolladores usarlo en múltiples protocolos de NFT. Para entender cómo funciona el endpoint de API getNFTs, considera los siguientes ejemplos.
1. Token gating en Optimism
Cuando los desarrolladores construyen un marketplace de NFT, diseñan una página de perfil de usuario que muestra los NFTs que posee el usuario. Los desarrolladores pueden usar la herramienta de token gating de NFT de Optimism, isHolderOfCollection, para obtener los NFTs de una dirección de wallet particular si posee un token específico de una colección determinada.
2. Herramienta de analítica de NFT en Optimism
Las herramientas de analítica de NFT, como sitios web de ranking de rareza o agregadores, requieren metadata de NFT para crear listas y obtener datos de trading. Los desarrolladores pueden usar el API de metadata de NFT de Optimism, getNFTMetadata, para obtener la metadata on-chain usada en las herramientas de analítica de NFT.
3. Listas de airdrop de NFT en Optimism
Un proyecto de NFT contrata desarrolladores para hacer airdrop de nuevos NFTs a los propietarios de un NFT específico. Sin un API, los desarrolladores tienen que analizar toda la blockchain para rastrear la propiedad de los activos NFT. Sin embargo, el API de colecciones de NFT de Optimism de Alchemy, getOwnersForToken, permite a los desarrolladores identificar propietarios de forma instantánea y crear la lista de airdrop. Los desarrolladores también pueden usar este API para verificar la propiedad de un activo cuando los usuarios quieren poner un NFT particular como su foto de perfil.
Cómo empezar a construir con el NFT API de Optimism
En lugar de correr tu propio nodo de Optimism, es fácil crear un nodo privado de Optimism en Alchemy, y luego seguir tres pasos sencillos para empezar a construir con el NFT API de Optimism de Alchemy:
- Elige un gestor de paquetes - usa un gestor de paquetes como npm o yarn
- Configura el repo - abre una terminal para crear un nuevo repositorio desde la línea de comandos para los scripts de inicio rápido
- Elige una librería - usa Fetch, Axios u otra librería HTTP estándar para interactuar con el NFT API de Optimism
Los desarrolladores pueden llamar al NFT API de Optimism directamente con Fetch o Axios. Consulta la documentación de Alchemy para ver ejemplos actuales de endpoints y métodos compatibles.
Usa el mejor NFT API de Optimism con Alchemy
Durante el bull run de 2021, el mercado de NFT superó los $40 mil millones según Bloomberg. Aunque el sector de NFT atraviesa actualmente una etapa difícil de mercado bajista, la tecnología NFT tiene un enorme potencial de crecimiento futuro.
Por eso, los builders necesitarán las herramientas de desarrollo de NFT adecuadas para crear sus apps de NFT en la red escalable de Optimism. Crea una cuenta gratuita en Alchemy y empieza a construir apps de NFT con el NFT API gratuito de Alchemy.
Resúmenes relacionados
Web329 de mayo de 2024
Conoce Key3: la DAO líder de educación Web3 en Japón
Japan Airlines y Calbee, una empresa japonesa de snacks, están usando NFTs para promover el turismo y la lealtad de marca.
Web329 de mayo de 2024
Wavehack: el hackathon Web3 más importante de Japón
WaveHack es el hackathon Web3 más grande de Japón, y se llevará a cabo desde mediados de abril hasta finales de agosto de 2024.
Web329 de mayo de 2024
Web3 en Japón: una visión completa
Descubre cómo el gobierno de Japón está acelerando la innovación y cómo las empresas están usando la tecnología blockchain.

Construye magia blockchain
Alchemy combina los productos y herramientas de desarrollo Web3 más potentes con recursos, comunidad y un soporte legendario.