Integración de wallets de NFT

¿Qué es la integración de wallets de NFT?

La integración de wallets de NFT es el proceso de conectar una wallet de criptomonedas a una aplicación para que los usuarios puedan ver, acuñar, transferir, comprar, vender, reclamar, verificar o utilizar tokens no fungibles.

En el sector cripto, esta integración actúa como puente entre la dirección de wallet del usuario, el contrato inteligente del NFT, los datos de la blockchain, los metadatos del token y la interfaz de la aplicación.

Una buena integración permite conectar una wallet, cambiar a la red correcta, ver los NFT propios, entender las solicitudes de transacción, aprobar solo los permisos necesarios y realizar acciones con NFT de forma segura.

Una mala integración puede provocar mints fallidos, aprobaciones ocultas, transferencias en la red equivocada, NFT que no se muestran correctamente, filtraciones de privacidad, riesgo de phishing y una experiencia de usuario confusa.

La base técnica suele incluir API de proveedores de wallet, llamadas RPC a la blockchain, estándares de tokens NFT, obtención de metadatos, indexadores, consultas a contratos inteligentes, firma de transacciones y seguimiento de eventos.

La API de proveedor EIP-1193 formaliza una API de proveedor de Ethereum en JavaScript para que las aplicaciones y las wallets puedan comunicarse de forma más coherente.

El estándar EIP-6963 mejora la detección de varias wallets cuando el usuario tiene más de un proveedor de wallet inyectado disponible en el mismo navegador.

Los protocolos de conexión entre wallets y aplicaciones, como el WalletConnect Wallet SDK, también permiten un acceso seguro a wallets en entornos móviles, web y multichain.

En las aplicaciones de NFT, la integración de wallets no es solo una función de inicio de sesión.

Es el panel de control del usuario para la propiedad digital.

Conclusiones clave sobre la integración de wallets de NFT

• • La integración de wallets de NFT conecta la wallet del usuario a una aplicación de NFT para que esta pueda consultar la propiedad y solicitar acciones aprobadas por el usuario.
  • Suele incluir conexión de wallet, detección de cuenta y red, consulta de saldos de NFT, visualización de metadatos, mints, transferencias, aprobaciones y solicitudes de firma.
  • ERC-721 y ERC-1155 son los estándares de tokens NFT más habituales en la integración de wallets.
  • EIP-1193 permite a las aplicaciones comunicarse con proveedores de wallets de Ethereum mediante una API común basada en solicitudes.
  • EIP-6963 ayuda a las aplicaciones a detectar varios proveedores de wallet inyectados de forma más segura y predecible.
  • Las integraciones basadas en WalletConnect permiten conectar wallets móviles y externas a las aplicaciones sin depender exclusivamente de extensiones del navegador.
  • La integración de los metadatos de NFT es esencial, ya que las wallets necesitan nombres, imágenes, descripciones, atributos y enlaces multimedia para mostrar los NFT con claridad.
  • Las aprobaciones de wallet deben gestionarse con cuidado, porque una aprobación maliciosa puede permitir que un contrato transfiera NFT desde la wallet del usuario.
  • Una buena integración debería admitir cambios de red seguros, solicitudes legibles, simulación de transacciones, gestión clara de errores y solicitudes de datos respetuosas con la privacidad.
  • La integración de wallets de NFT debe diseñarse como infraestructura de seguridad, no solo como una función de interfaz de usuario.

Cómo funciona la integración de wallets de NFT

La integración suele comenzar cuando el usuario hace clic en el botón para conectar una wallet.

La aplicación detecta los proveedores de wallet o los métodos de conexión disponibles.

El usuario selecciona una wallet y aprueba la solicitud de conexión.

Una vez concedido el permiso, la aplicación recibe la dirección pública de wallet del usuario.

A continuación, puede comprobar el ID de la blockchain conectada para confirmar que el usuario está en la red correcta.

Si está en una red equivocada, la aplicación puede solicitar que cambie de red o mostrarle instrucciones.

Una vez conectada la wallet, la aplicación puede consultar datos públicos on-chain relacionados con ella.

Entre otros, puede consultar la propiedad de ERC-721, los saldos de ERC-1155, las aprobaciones de tokens, la elegibilidad para el mint, el estado de reclamaciones y el historial de transacciones.

Cuando el usuario quiere realizar una acción, la aplicación crea una transacción o un mensaje para que la wallet lo revise y lo firme.

La wallet solo firma cuando el usuario aprueba la solicitud.

Integración de wallets de NFT y proveedores de wallet

Un proveedor de wallet es la interfaz que permite a una aplicación solicitar datos de la blockchain o pedir a la wallet que firme mensajes y transacciones.

En las aplicaciones de Ethereum para navegador, este proveedor se ha expuesto a menudo mediante un objeto JavaScript.

EIP-1193 describe el proveedor como un objeto JavaScript que proporciona acceso a Ethereum a través de un cliente y una wallet.

El proveedor es fundamental en las aplicaciones de NFT porque permite solicitar cuentas, consultar el estado de la red, enviar transacciones y responder a cambios de cuenta.

Un proveedor de wallet no debería conceder a una aplicación acceso ilimitado.

La aplicación debería solicitar únicamente los permisos necesarios para la acción que el usuario quiere realizar.

La wallet debería pedir permiso al usuario antes de exponer el acceso a la cuenta o firmar transacciones.

La aplicación debería gestionar los errores del proveedor con claridad.

También debería responder de forma segura cuando el usuario desconecte la wallet, cambie de cuenta o de red, o rechace una solicitud.

La integración es más sólida cuando el comportamiento del proveedor es predecible y el consentimiento del usuario está claro.

Integración de wallets de NFT y EIP-1193

EIP-1193 es importante porque ofrece a las aplicaciones una forma estándar de comunicarse con los proveedores de wallets de Ethereum.

El estándar define un método de solicitud mediante el cual la aplicación envía al proveedor un nombre de método y sus parámetros.

En una integración de NFT, las solicitudes habituales al proveedor pueden incluir la obtención de cuentas, la consulta del ID de la blockchain, el envío de una transacción, la firma de un mensaje o el cambio de red.

Esto permite que los desarrolladores de wallets y aplicaciones trabajen con una interfaz común.

Sin un modelo compartido de proveedor, cada wallet podría comportarse de manera diferente y sería más difícil ofrecer compatibilidad con las aplicaciones de NFT.

EIP-1193 también define eventos del proveedor, como los cambios de cuenta y de red.

Estos eventos importan porque la propiedad de los NFT y el contexto de red dependen de la wallet y la blockchain seleccionadas.

Si el usuario cambia de cuenta, la aplicación debería actualizar los NFT que muestra.

Si cambia de red, la aplicación debería actualizar las direcciones de contrato, las fuentes de metadatos y las rutas de transacción.

Una aplicación de NFT segura nunca debería dar por hecho que el estado de la wallet permanecerá fijo después de conectarla.

Integración de wallets de NFT y EIP-6963

EIP-6963 mejora la detección de wallets cuando hay varias wallets inyectadas disponibles en el mismo navegador.

Antes de este estándar, varias wallets de navegador podían competir por controlar el mismo objeto de proveedor.

Esto podía generar condiciones de carrera y experiencias de usuario confusas.

EIP-6963 incorpora un mecanismo de detección que permite a las wallets anunciarse mediante eventos de window.

Así, una aplicación de NFT puede mostrar al usuario una pantalla más clara para seleccionar una wallet.

Esto importa a los usuarios de NFT porque muchos coleccionistas utilizan distintas wallets para distintos fines.

Una wallet puede servir para guardar NFT a largo plazo.

Otra puede utilizarse para acuñar.

Una tercera puede destinarse a los videojuegos.

Una buena integración de wallets de NFT debería permitir que los usuarios elijan la wallet que realmente quieren utilizar.

Integración de wallets de NFT y WalletConnect

La integración mediante WalletConnect permite que las aplicaciones se conecten a wallets que no están inyectadas directamente en la página del navegador.

Esto es especialmente importante para las wallets móviles, las de escritorio y las que se ejecutan en otro dispositivo.

El usuario puede escanear un código QR, aprobar una sesión en una wallet móvil y firmar después las transacciones desde esa wallet.

La documentación de WalletConnect describe su Wallet SDK como una forma de integrar un acceso seguro y multichain a las wallets.

En las aplicaciones de NFT, puede ampliar el alcance porque los usuarios no quedan limitados al modelo de wallets de extensión del navegador.

También puede mejorar la experiencia móvil, ya que muchos usuarios de NFT interactúan desde el teléfono.

Sin embargo, el diseño de las sesiones importa.

Las aplicaciones deberían solicitar únicamente las redes y los métodos necesarios.

Las wallets deberían mostrar claramente los permisos de la sesión.

Los usuarios deberían desconectar las sesiones en las que ya no confían.

Integración de wallets de NFT y ERC-721

ERC-721 es el principal estándar para NFT únicos en redes similares a Ethereum.

El estándar ERC-721 define funciones básicas para registrar y transferir tokens no fungibles.

Una integración de wallets de NFT compatible con ERC-721 suele tener que consultar ownerOf, balanceOf, tokenURI, las aprobaciones y los eventos Transfer.

Cuando los usuarios transfieren NFT, la aplicación también puede tener que llamar a safeTransferFrom u otras funciones del contrato.

Para mostrar el NFT, la wallet o la aplicación suele necesitar la dirección del contrato, el ID del token, la dirección del titular y el URI de los metadatos.

Por seguridad, la aplicación debe explicar si el usuario está transfiriendo un NFT, aprobando un NFT o autorizando a un operador para toda una colección.

Las aprobaciones de ERC-721 son importantes porque pueden permitir que otra dirección o contrato mueva NFT.

Una integración segura debería mostrar claramente el alcance de la aprobación.

No debería ocultar solicitudes de aprobación tras etiquetas poco claras de mint o reclamación.

El usuario debería saber exactamente qué NFT o colección se ve afectado.

Integración de wallets de NFT y ERC-1155

ERC-1155 es un estándar multítoken que puede representar tipos de token fungibles, semifungibles y no fungibles dentro de un mismo contrato.

El estándar ERC-1155 define una interfaz capaz de representar muchos tipos de token en un solo contrato inteligente.

La integración de wallets de NFT con ERC-1155 debe gestionar los ID y los saldos de los tokens de forma diferente a ERC-721.

Un usuario puede poseer varias unidades del mismo ID de token ERC-1155.

Un objeto de juego, una entrada, un distintivo o un coleccionable por ediciones pueden utilizar ERC-1155 en lugar de ERC-721.

Las aplicaciones deberían mostrar la cantidad que posee el usuario, no solo el ID del token.

Las transferencias pueden realizarse con un único token o en forma de lote.

Las aprobaciones también pueden conceder derechos de operador sobre los tokens del titular en el contrato.

Una buena integración debería facilitar la comprensión de las cantidades ERC-1155 y del alcance de las aprobaciones.

Los usuarios no deberían tener que adivinar si están transfiriendo un objeto, varias copias o un lote entero.

Metadatos de NFT en la integración de wallets

Los metadatos de NFT son la información que permite a las wallets y aplicaciones mostrar qué representa un NFT.

Pueden incluir el nombre, la descripción, la imagen, la animación, los atributos, los enlaces externos y los detalles de la colección.

Sin metadatos, una wallet quizá solo muestre una dirección de contrato y un ID de token.

Eso es técnicamente correcto, pero poco útil para la mayoría de los usuarios.

La guía de IPFS sobre datos de NFT explica las prácticas recomendadas para almacenar datos y proporcionar una experiencia duradera a creadores y titulares.

La integración de wallets de NFT debería obtener los metadatos de forma cuidadosa y segura.

Cuando corresponda, la aplicación debería admitir URI de IPFS, URL HTTPS y otras referencias habituales a metadatos.

Debería almacenar en caché los metadatos sin ocultar actualizaciones importantes.

También debería gestionar enlaces rotos, gateways lentas, imágenes que faltan, JSON mal formado y contenido multimedia no seguro.

Una buena integración de metadatos ayuda a entender los NFT sin sacrificar la seguridad.

Visualización de imágenes y contenido multimedia de NFT

La integración de wallets de NFT suele incluir la representación de imágenes y contenido multimedia.

Según el NFT, puede incluir archivos JPEG, PNG, GIF, SVG, MP4, GLB, HTML, audio u otros formatos.

La visualización de contenido multimedia debe tratarse como una cuestión de seguridad.

Los metadatos de un NFT pueden apuntar a archivos externos controlados por terceros desconocidos.

Las aplicaciones deberían evitar ejecutar scripts no seguros procedentes del contenido multimedia de los NFT.

Si admiten contenido interactivo, deberían aislar el contenido arriesgado en un entorno controlado.

Cuando sea posible, deberían utilizar políticas de seguridad de contenido y reglas de visualización segura.

También deberían mostrar alternativas cuando no se pueda cargar el contenido.

Una imagen rota no debería impedir que el usuario transfiera o gestione un NFT válido.

Una integración de wallets de NFT debería mostrar el contenido de forma atractiva, pero nunca confiar ciegamente en él.

Actualizaciones de metadatos de NFT y ERC-4906

Los metadatos de algunos NFT pueden cambiar después del mint.

Los NFT dinámicos pueden actualizar su ilustración, nivel, estado de membresía, estadísticas de juego o atributos de recompensa.

La extensión ERC-4906 para actualizaciones de metadatos añade eventos que ayudan a las aplicaciones de terceros a saber cuándo han cambiado los metadatos ERC-721.

Esto es importante para la integración de wallets porque unos metadatos obsoletos pueden inducir a error.

Si cambia el estado de un NFT, la wallet debería saber cuándo actualizar la información.

Por ejemplo, un personaje de videojuego puede subir de nivel, una entrada puede quedar marcada como utilizada o un distintivo de membresía puede caducar.

Sin eventos de actualización ni una lógica de refresco, la wallet puede mostrar información desactualizada.

Los desarrolladores deberían admitir señales de actualización de metadatos cuando estén disponibles.

También deberían explicar si los metadatos son inmutables, los actualiza el titular, los actualiza el emisor o son dinámicos.

Los usuarios deberían saber si el NFT que ven hoy puede cambiar mañana.

Verificación de la propiedad de NFT

La verificación de la propiedad de NFT comprueba si una wallet conectada posee un NFT concreto o un saldo de tokens determinado.

Se utiliza para sitios web con acceso limitado por tokens, videojuegos, membresías, descuentos, eventos, airdrops, DAO y acceso a comunidades.

En ERC-721, la aplicación puede comprobar si ownerOf devuelve la dirección conectada para un ID de token concreto.

También puede examinar los eventos Transfer o utilizar un indexador para enumerar todos los NFT que posee la wallet.

En ERC-1155, la aplicación puede consultar balanceOf para un ID de token determinado.

Las comprobaciones de propiedad deben corresponder a la blockchain y a la dirección de contrato correctas.

Un usuario puede poseer un NFT en una blockchain y no en otra.

Una colección falsa puede tener metadatos similares, pero una dirección de contrato distinta.

Una buena integración verifica la propiedad mediante los datos del contrato, no solo a partir de imágenes o nombres.

La verificación fiable de la propiedad es la base de las experiencias de NFT con acceso limitado por tokens.

Integración del mint de NFT

La integración del mint de NFT permite acuñar o reclamar un nuevo NFT mediante una transacción de wallet.

Antes de que el usuario firme, la aplicación debería mostrar la blockchain, el contrato, el precio del mint, el estándar del token, el estado de la oferta, el límite por wallet y el gas previsto.

Si el mint utiliza una whitelist, la integración quizá tenga que proporcionar una prueba de Merkle o una autorización firmada.

Si utiliza precios dinámicos, la aplicación debería mostrar el precio actual y los posibles cambios.

Si el mint es gratuito, la aplicación debería mostrar igualmente el coste de gas y el propósito de la transacción.

Los mints gratuitos pueden ser peligrosos si la transacción concede aprobaciones o ejecuta código malicioso.

La solicitud de la wallet debería aclarar si el usuario está acuñando, aprobando, transfiriendo o firmando un mensaje.

La aplicación debería gestionar los mints fallidos de forma adecuada.

Debería explicar si el fallo se debe a que se agotó la oferta, a una red incorrecta, a gas insuficiente, a una firma rechazada, a una elegibilidad caducada o a un error del contrato.

Una buena integración de mint reduce el pánico durante los lanzamientos de alta demanda.

Integración de transferencias de NFT

La integración de transferencias de NFT permite enviar NFT de una wallet a otra.

La aplicación debería pedir la dirección del destinatario y mostrar exactamente qué NFT se va a transferir.

En ERC-721, la transferencia suele mover un único ID de token.

En ERC-1155, puede transferirse una cantidad de un ID de token o un lote de varios ID de token.

La aplicación debería advertir a los usuarios de que las transferencias en blockchain suelen ser difíciles o imposibles de revertir una vez confirmadas.

También debería avisar si el destinatario podría ser un contrato que no pueda gestionar el NFT correctamente.

safeTransferFrom ayuda a reducir algunos riesgos de compatibilidad con el destinatario, pero no evita todos los errores.

La aplicación debería mostrar claramente la blockchain, ya que enviar un NFT en la red equivocada puede causar confusión.

Las funciones de libreta de direcciones pueden ayudar a reducir errores si se implementan de forma segura.

La integración de transferencias debería priorizar la claridad frente a la velocidad.

Integración de aprobaciones de NFT

La integración de aprobaciones de NFT es una de las partes más delicadas de la integración de wallets de NFT.

Una aprobación permite que otra dirección o contrato inteligente mueva NFT desde la wallet del usuario.

ERC-721 admite aprobaciones para un único token y aprobaciones de operador para toda una colección.

ERC-1155 admite aprobaciones de operador para los tipos de token de un contrato.

Los usuarios suelen aprobar contratos de marketplaces, préstamos, staking, videojuegos o escrow.

Los atacantes suelen engañar a los usuarios para que aprueben contratos maliciosos.

Una aplicación segura debería mostrar exactamente qué aprobación solicita.

Debería distinguir entre la aprobación de un único token y la aprobación de toda la colección.

No debería solicitar una aprobación amplia cuando basta con una más limitada.

Cuando sea práctico, debería permitir revisar y revocar aprobaciones antiguas.

Integración de wallets de NFT y acceso limitado por tokens

El acceso limitado por tokens utiliza la propiedad de NFT para desbloquear contenido, acciones, descuentos, roles o acceso.

La integración de wallet para este tipo de acceso suele pedir al usuario que conecte una wallet y puede solicitarle que firme un mensaje para demostrar que controla la dirección.

A continuación, la aplicación comprueba si la wallet posee el NFT requerido.

El acceso limitado por tokens no debería exigir que los usuarios concedan aprobaciones de tokens.

Por lo general, basta con consultar la propiedad para comprobar el acceso.

Si un sitio web solicita una aprobación para una simple comprobación de acceso, el usuario debería desconfiar.

Las aplicaciones deberían utilizar retos de inicio de sesión nuevos para impedir que se repitan firmas antiguas.

Los mensajes de inicio de sesión deberían incluir el dominio, un nonce, una hora de caducidad y el propósito de la solicitud.

Las aplicaciones deberían evitar almacenar más datos de la wallet de los necesarios.

El acceso limitado por tokens resulta útil cuando permite demostrar la membresía sin obligar al usuario a asumir riesgos de custodia innecesarios.

Integración de wallets de NFT e inicio de sesión con wallet

El inicio de sesión con wallet permite demostrar el control de una dirección mediante la firma de un mensaje.

Puede ser útil para perfiles de NFT, colecciones, paneles, cuentas de videojuegos y portales comunitarios.

La firma de inicio de sesión debería ser legible para las personas.

No debería parecer una transacción ni una aprobación.

Debería incluir el dominio de la aplicación para impedir que la firma se reutilice en otro sitio web.

También debería incluir un nonce único para impedir que la misma firma se vuelva a utilizar más adelante.

Debería incluir la hora de emisión y la hora de caducidad.

Cuando se pueda utilizar un mensaje estructurado, no debería pedirse al usuario que firme datos hexadecimales poco claros.

El inicio de sesión con wallet resulta práctico, pero los usuarios deben entender que las firmas son acciones de seguridad reales.

El flujo de inicio de sesión debería autenticar al usuario, no engañarlo para que conceda permisos sobre sus activos.

Integración de wallets de NFT y experiencia móvil

La integración móvil de wallets de NFT plantea dificultades porque los usuarios pueden pasar de un navegador a una aplicación de wallet, una aplicación, un código QR, una notificación y una pantalla de confirmación de transacción.

El cambio de contexto puede generar confusión y transacciones fallidas.

Los enlaces profundos pueden ayudar a abrir la aplicación de wallet correcta.

Las sesiones basadas en WalletConnect pueden ayudar a las wallets móviles a comunicarse con las aplicaciones.

La aplicación debería conservar el estado cuando el usuario vuelva desde la wallet.

Debería mostrar claramente si una transacción está pendiente, confirmada, fallida o rechazada.

También debería evitar obligar al usuario a conectarse repetidamente.

El cambio de red en el móvil debe gestionarse con cuidado.

Antes y después de la aprobación de la wallet, deberían mostrarse el mismo NFT, precio, contrato y acción.

La integración móvil debería reducir las dificultades sin restar claridad a las transacciones.

Integración de wallets de NFT y privacidad

La integración de wallets de NFT puede plantear riesgos de privacidad porque las direcciones de wallet pueden revelar actividad pública.

Cuando un usuario conecta una wallet, la aplicación puede conocer su dirección y vincularla al comportamiento de navegación, los datos de la cuenta, la información del dispositivo o los perfiles sociales.

Las investigaciones sobre privacidad en Web3 han detectado que los diseños de wallets y aplicaciones pueden filtrar información relacionada con las wallets a terceros.

Esto importa porque las wallets de NFT suelen contener señales de identidad muy visibles.

Una wallet puede mostrar colecciones de arte, membresías, distintivos de eventos, activos de videojuegos, tokens de gobernanza o credenciales de identidad.

Las aplicaciones solo deberían solicitar conectar una wallet cuando sea necesario.

Deberían explicar por qué necesitan la wallet.

También deberían evitar compartir las direcciones con scripts de terceros que no sean necesarios.

Los usuarios deberían valorar el uso de wallets separadas para la identidad pública, los mints, los videojuegos y el almacenamiento a largo plazo.

La integración de wallets debería respetar tanto la privacidad como la propiedad.

Integración de wallets de NFT y seguridad

La seguridad es el aspecto más importante de la integración de wallets de NFT.

La aplicación no debería solicitar frases semilla ni claves privadas.

No debería solicitar aprobaciones amplias sin una razón clara.

Tampoco debería ocultar llamadas arriesgadas a contratos tras etiquetas de botones amigables.

Antes de crear transacciones, debería verificar las direcciones de contrato y los ID de la blockchain.

Debería utilizar HTTPS y proteger a los usuarios frente a dominios falsificados.

Cuando sea posible, debería simular las transacciones para mostrar los cambios de activos previstos.

También debería advertir a los usuarios sobre aprobaciones y transferencias sospechosas.

Cuando corresponda, debería admitir wallets de hardware y procesos multifirma.

Debería tratar cada firma como una autorización significativa.

La integración de wallets de NFT debería diseñarse teniendo en cuenta que los atacantes pueden copiar la interfaz e intentar confundir a los usuarios.

Integración de wallets de NFT y consultas a contratos inteligentes

Las consultas a contratos inteligentes permiten mostrar datos de NFT sin pedir al usuario que firme una transacción.

Algunos ejemplos son las consultas a ownerOf, balanceOf, tokenURI, isApprovedForAll, totalSupply, el precio de mint, el estado de reclamación y los metadatos del contrato.

Las consultas son útiles porque no cuestan gas ni modifican el estado de la blockchain.

Sin embargo, necesitan una configuración correcta de la red y del contrato.

Una dirección de contrato incorrecta puede mostrar datos falsos.

Un endpoint RPC incorrecto puede devolver resultados inesperados.

Una caché desactualizada puede mostrar información de propiedad obsoleta.

Una buena integración debería distinguir en la interfaz entre las acciones de solo lectura y las que requieren firma.

El usuario no debería tener que firmar un mensaje solo para que una aplicación consulte la propiedad pública de un NFT.

El diseño de las consultas influye tanto en la usabilidad como en la confianza.

Integración de wallets de NFT e indexadores

Los indexadores recopilan eventos de la blockchain y los organizan para acelerar las consultas de las aplicaciones.

Las aplicaciones de NFT suelen utilizar indexadores porque examinar directamente desde un nodo cada contrato y cada ID de token puede ser lento.

Un indexador puede registrar eventos Transfer, cambios de propiedad, referencias a metadatos, aprobaciones y actividad de colecciones.

Los indexadores mejoran el rendimiento y la experiencia del usuario.

También pueden generar problemas de calidad de datos.

Si un indexador se retrasa, la aplicación quizá no muestre inmediatamente un NFT recién acuñado.

Si se le escapa un evento, la propiedad podría aparecer de forma incorrecta.

Si confía en metadatos falsos, la aplicación puede mostrar activos engañosos.

Una integración sólida debería gestionar los retrasos del indexador y ofrecer una opción de actualización o una consulta directa al contrato cuando corresponda.

Los usuarios deberían entender que la visualización de la wallet puede ir por detrás del estado real de la blockchain.

Integración de wallets de NFT y NFT cross-chain

La integración de NFT cross-chain es compleja porque un NFT puede existir en una blockchain, una red Layer 2 o mediante una representación envuelta.

La aplicación de wallet debe saber a qué red pertenece el NFT.

La aplicación debe utilizar el ID de blockchain, el endpoint RPC, la dirección de contrato, el estándar de token, la lógica de metadatos y las reglas del bridge correctos.

Un token con el mismo nombre en dos redes puede no ser el mismo activo.

Un NFT envuelto puede depender de un contrato de bridge o de un proceso de custodia.

Un juego puede admitir NFT en una red, pero no en otra.

La integración cross-chain debería mostrar la red en todo momento.

No debería combinar activos de forma que oculte los riesgos específicos de cada red.

Las operaciones de bridge deberían explicar los plazos, las comisiones, la finalidad y los límites de recuperación.

La experiencia cross-chain con NFT debería ser sencilla, pero no engañosa.

Integración de wallets de NFT y abstracción de cuentas

La abstracción de cuentas puede mejorar la integración de wallets de NFT al hacer que estas sean más programables.

Las cuentas inteligentes pueden admitir transacciones por lotes, límites de gasto, claves de sesión, recuperación social, gas patrocinado y reglas de permisos personalizadas.

En las aplicaciones de NFT, esto puede facilitar los mints, los videojuegos, las transferencias y las acciones en marketplaces.

Un usuario quizá pueda acuñar y poner a la venta un NFT en un mismo flujo por lotes.

Un juego puede utilizar una clave de sesión limitada para realizar acciones de bajo valor con NFT.

Una wallet puede patrocinar el gas para que un usuario nuevo reclame un NFT sin comprar antes un token nativo para pagar las comisiones.

Estas funciones pueden favorecer la adopción, pero también plantean cuestiones sobre la confianza y el diseño de contratos.

Los usuarios deberían saber quién puede recuperar la cuenta, qué permisos tiene una clave de sesión y si las transacciones están patrocinadas por un tercero.

Los desarrolladores deberían evitar ocultar permisos potentes tras la comodidad.

Una mejor experiencia de usuario no debería reducir el control del usuario.

Integración de wallets de NFT y simulación de transacciones

La simulación de transacciones muestra a los usuarios qué podría ocurrir antes de firmar.

En la integración de wallets de NFT, puede indicar si se acuñará, transferirá, aprobará, quemará, pondrá en staking o listará un NFT.

También puede mostrar pagos en tokens, estimaciones de gas y posibles errores del contrato.

La simulación no es perfecta, ya que el estado de la blockchain puede cambiar antes de que se confirme la transacción.

Aun así, resulta útil porque muchas estafas de NFT se basan en que los usuarios no entienden los efectos de una transacción.

Una transacción simulada puede advertir de que una acción llamada «reclamar» en realidad transfiere NFT fuera de la wallet.

También puede indicar que una solicitud para «verificar la wallet» concede una aprobación de operador.

Puede alertar de que un mint llama a un contrato inesperado.

Cuando sea posible, las aplicaciones y wallets deberían simular las transacciones, especialmente las acciones con NFT de gran valor.

Las vistas previas claras pueden evitar errores costosos.

Integración de wallets de NFT y gestión de errores

La gestión de errores es una parte importante de la integración de wallets de NFT.

Los usuarios necesitan saber por qué ha fallado una acción de la wallet.

Una transacción puede fallar porque el usuario haya rechazado la firma.

También puede fallar porque el usuario esté en la red equivocada.

Puede que no haya gas suficiente.

Es posible que la oferta del mint se haya agotado.

La prueba de whitelist puede ser inválida.

La wallet puede estar desconectada o bloqueada.

El contrato puede haber revertido la transacción con un error personalizado.

Los mensajes de error claros reducen las consultas de soporte e impiden que los usuarios vuelvan a intentar acciones peligrosas a ciegas.

Integración de wallets de NFT y diseño de la interfaz

La interfaz debería permitir entender las acciones de la wallet antes de firmar.

El botón para conectar la wallet no debería parecer un botón de mint.

Una solicitud de firma no debería parecer una inofensiva actualización de página.

Una aprobación de tokens no debería parecer un simple inicio de sesión.

La transferencia debería mostrar claramente el NFT, el destinatario, la red y el coste.

El mint debería mostrar claramente la oferta, el precio, el gas, el contrato y el estado de elegibilidad.

Una página con acceso limitado por tokens debería explicar si necesita una conexión de wallet o una firma.

La interfaz debería utilizar un lenguaje sencillo y no limitarse a mostrar nombres de métodos del contrato.

Los usuarios que quieran más información deberían tener acceso a los detalles avanzados.

Una buena integración de wallets de NFT tiene en cuenta tanto a los principiantes como a los expertos.

Integración de wallets de NFT y API para desarrolladores

Para crear una integración de wallets de NFT, los desarrolladores suelen utilizar API, SDK, indexadores, proveedores RPC, bibliotecas de contratos y conectores de wallets.

Estas herramientas pueden acelerar el desarrollo.

También pueden generar dependencias.

Si una API deja de funcionar, quizá falle la visualización de los NFT.

Si cambia el comportamiento de un SDK, puede fallar la conexión de la wallet.

Si un indexador se retrasa, la información de propiedad puede quedar desactualizada.

Si no está disponible un gateway de metadatos, las imágenes pueden desaparecer.

Los desarrolladores deberían saber qué partes de la integración están descentralizadas y cuáles dependen de servicios externos.

Deberían supervisar los fallos y ofrecer alternativas adecuadas.

Una aplicación de NFT fiable no debería fallar sin avisar cuando haya problemas con una dependencia.

Integración de wallets de NFT y cumplimiento

La integración de wallets de NFT puede plantear cuestiones de cumplimiento según el activo, la jurisdicción y el modelo de negocio.

Una aplicación sencilla para mostrar arte puede tener obligaciones distintas a las de una plataforma que gestione entradas, activos tokenizados del mundo real, membresías reguladas o pagos de gran valor.

Algunas aplicaciones quizá deban verificar direcciones de wallet o aplicar restricciones por ubicación.

Otras quizá necesiten registros fiscales, facturas, recibos o comunicaciones a los usuarios.

Algunos casos de uso de NFT pueden requerir comprobaciones de edad o identidad.

Las funciones de cumplimiento deberían diseñarse sin recopilar datos personales innecesarios.

Si se requieren comprobaciones de identidad, los usuarios deberían saber quién recopila los datos y con qué fin.

Conectar una wallet no equivale a confirmar plenamente una identidad legal.

La propiedad pública de una wallet y la identidad legal son conceptos distintos.

Los desarrolladores deberían diseñar la integración de wallets de NFT teniendo en cuenta tanto la privacidad como los requisitos legales.

Ventajas de la integración de wallets de NFT

La primera ventaja es la propiedad directa por parte del usuario.

Los usuarios pueden guardar NFT en sus propias wallets, en lugar de depender exclusivamente de la base de datos de una aplicación.

La segunda ventaja es la interoperabilidad.

Si se admiten los estándares correspondientes, wallets, videojuegos, comunidades, marketplaces y herramientas con acceso limitado por tokens pueden reconocer el mismo NFT.

La tercera ventaja es una verificación transparente.

Las aplicaciones pueden comprobar la propiedad on-chain en vez de confiar en registros privados de cuentas.

La cuarta ventaja es la interacción programable.

Mediante contratos inteligentes, los NFT se pueden acuñar, transferir, poner en staking, quemar, mostrar o utilizar como credenciales de acceso.

La quinta ventaja es un mayor control para el usuario.

Los usuarios pueden elegir qué wallet conectar y qué acciones aprobar.

La sexta ventaja es la componibilidad.

La integración de wallets de NFT permite a muchas aplicaciones utilizar la misma capa de propiedad de tokens.

Riesgos y limitaciones de la integración de wallets de NFT

El primer riesgo es el phishing.

Las aplicaciones falsas de NFT pueden imitar los procesos de integración de wallets para robar firmas o aprobaciones.

El segundo riesgo son las aprobaciones demasiado amplias.

Los usuarios pueden aprobar accidentalmente que un contrato mueva muchos NFT.

El tercer riesgo son los fallos de metadatos.

Los NFT pueden mostrarse de forma incorrecta si se rompen los enlaces a los metadatos o el contenido multimedia no es seguro.

El cuarto riesgo es la filtración de privacidad.

Conectar una wallet puede revelar datos públicos de propiedad e historial de transacciones.

El quinto riesgo es la confusión con redes incorrectas.

Los usuarios pueden interactuar en una red distinta de la que pretendían utilizar.

El sexto riesgo es el fallo de dependencias.

Los proveedores RPC, los gateways de metadatos, los SDK y los indexadores pueden no estar disponibles o tener datos desactualizados.

El séptimo riesgo son los contratos inteligentes.

La wallet puede funcionar correctamente aunque el contrato del NFT o la lógica de la aplicación no sean seguros.

Errores habituales en la integración de wallets de NFT

Un error habitual es pedir a los usuarios que conecten una wallet antes de explicarles por qué.

Otro es no detectar los cambios de cuenta.

Un tercer error es no detectar los cambios de red.

Un cuarto es mostrar imágenes de NFT sin verificar la dirección del contrato.

Un quinto es tratar de la misma forma los saldos de ERC-721 y ERC-1155.

Un sexto es ocultar a los usuarios el alcance de las aprobaciones.

Un séptimo es depender exclusivamente de un servidor centralizado de metadatos sin ofrecer alternativas ni informar de ello.

Un octavo es exigir firmas para consultar datos públicos sencillos de propiedad.

Un noveno es no probar los procesos de wallets móviles.

Un décimo es ignorar las filtraciones de privacidad causadas por la conexión de wallets y los scripts de terceros.

Buenas prácticas para desarrolladores

Cuando corresponda, utiliza procesos estandarizados de proveedor de wallet, como EIP-1193.

Si son relevantes las wallets inyectadas, admite la detección de varias wallets mediante EIP-6963.

Si tus usuarios lo necesitan, admite sesiones con wallets móviles y externas.

Muestra claramente la dirección conectada, la red y el estado de la wallet.

Separa las comprobaciones de propiedad de solo lectura de las transacciones firmadas.

Explica las aprobaciones de NFT en un lenguaje sencillo.

Verifica las direcciones de contrato y los ID de la blockchain antes de crear transacciones.

Admite correctamente ERC-721 y ERC-1155 en lugar de suponer que todos los NFT se comportan igual.

Gestiona de forma segura las referencias a IPFS y a otros metadatos.

Utiliza simulación de transacciones, mensajes de error claros y solicitudes de permisos prudentes.

Buenas prácticas para usuarios

Conecta las wallets únicamente a aplicaciones en las que confíes.

Comprueba el dominio antes de conectarte.

Utiliza una wallet independiente para acuñar si vas a interactuar con proyectos de NFT arriesgados o desconocidos.

Cuando sea posible, guarda los NFT valiosos en una wallet de almacenamiento más segura.

Lee cada solicitud de la wallet antes de firmar.

Ten especial cuidado con las aprobaciones y las solicitudes setApprovalForAll.

Confirma la red antes de acuñar, transferir o aprobar NFT.

No introduzcas una frase semilla en ningún sitio web de NFT.

Desconecta las sesiones antiguas de wallet que ya no necesites.

Recuerda que la integración de la wallet solo da a una aplicación acceso de visualización y de firma cuando lo apruebas, por lo que las aprobaciones deben tomarse en serio.

Cuándo resulta útil la integración de wallets de NFT

Es útil cuando una aplicación necesita verificar la propiedad de un token.

También sirve para acuñar y reclamar NFT.

Es útil en comunidades y membresías con acceso limitado por tokens.

Sirve para videojuegos blockchain que utilizan objetos NFT.

También se utiliza en galerías de NFT y paneles de cartera.

Es útil para entradas de eventos e insignias digitales.

También lo es para protocolos DeFi que aceptan NFT como colateral o posiciones.

Las DAO pueden utilizarla para asignar roles según la propiedad de NFT.

Resulta menos útil cuando la aplicación solo necesita un nombre de usuario normal y no requiere verificar la propiedad en blockchain.

La integración de wallets debería resolver un problema real de propiedad o firma, no añadirse solo porque suene propia de Web3.

Integración de wallets de NFT en una frase

La integración de wallets de NFT conecta una wallet de criptomonedas con una aplicación de NFT para que los usuarios puedan verificar la propiedad, ver metadatos y aprobar acciones con NFT, como mints, transferencias, reclamaciones, acceso limitado por tokens e interacciones con contratos inteligentes.

Preguntas frecuentes

¿Qué significa la integración de wallets de NFT?

Significa conectar una wallet de criptomonedas a una aplicación para que el usuario pueda ver, verificar, acuñar, transferir, aprobar o utilizar NFT.

¿Por qué necesitan integración de wallets las aplicaciones de NFT?

La necesitan porque la propiedad de los NFT y la aprobación de transacciones se controlan mediante direcciones de wallet y firmas criptográficas.

¿Qué estándares son importantes para integrar wallets de NFT?

Según el diseño de la aplicación, los estándares importantes incluyen ERC-721, ERC-1155, EIP-1193, EIP-6963, EIP-712 y ERC-4906.

¿Qué diferencia hay entre conectar una wallet y firmar una transacción?

Conectar una wallet normalmente comparte la dirección pública con la aplicación, mientras que firmar una transacción autoriza una acción en la blockchain.

¿Puede una aplicación de NFT mover mis NFT después de que conecte la wallet?

Conectar la wallet por sí solo no debería permitir que una aplicación mueva NFT, pero firmar aprobaciones o transferencias puede dar permiso a un contrato para mover activos.

¿Qué es una aprobación de NFT?

Es un permiso que permite a otra dirección o contrato transferir uno o varios NFT desde la wallet del usuario.

¿Por qué a veces no aparecen los NFT en una wallet?

Es posible que no aparezcan por retrasos del indexador, una selección incorrecta de red, estándares de token no compatibles, metadatos rotos, filtros de spam ocultos o limitaciones de visualización de la wallet.

¿Qué es el acceso limitado por tokens en la integración de wallets de NFT?

Es una comprobación para determinar si una wallet conectada posee el NFT requerido antes de conceder acceso a contenido, ventajas, roles o acciones.

¿Es segura la integración de wallets de NFT?

Puede serlo si la aplicación utiliza permisos claros, contratos verificados, una gestión segura de metadatos, solicitudes legibles y un diseño cuidadoso de las transacciones.

¿Cuál es el mayor riesgo de la integración de wallets de NFT?

El mayor riesgo es engañar a los usuarios para que firmen aprobaciones, transferencias o mensajes maliciosos que permitan a los atacantes controlar NFT de valor.

¿Deberían los usuarios conectar wallets de almacenamiento con NFT de gran valor a las aplicaciones?

Por lo general, deberían evitar conectar wallets de almacenamiento de gran valor a aplicaciones desconocidas y valorar el uso de wallets separadas para acuñar y navegar.

¿Puede funcionar en el móvil la integración de wallets de NFT?

Sí. Puede funcionar mediante wallets móviles, enlaces profundos, sesiones con códigos QR y protocolos de conexión de wallets, pero la experiencia debe diseñarse con cuidado.

Conclusión

La integración de wallets de NFT es la capa de conexión esencial entre la propiedad de NFT y las aplicaciones destinadas a los usuarios.

Permite a una wallet demostrar la propiedad, mostrar NFT, solicitar firmas, enviar transacciones e interactuar con contratos inteligentes.

Sin esta integración, una aplicación de NFT no puede saber fácilmente qué activos posee un usuario ni pedirle que apruebe acciones como acuñar, transferir, poner en staking, listar o reclamar.

Una buena integración hace que los NFT sean utilizables.

Una mala integración los hace confusos y peligrosos.

Las mejores integraciones combinan estándares técnicos con diseños fáciles de entender.

EIP-1193 ayuda a las aplicaciones a comunicarse con los proveedores de wallets.

EIP-6963 permite a los usuarios elegir entre varias wallets inyectadas.

Las sesiones basadas en WalletConnect permiten conectar wallets móviles y externas entre distintos dispositivos.

ERC-721 y ERC-1155 definen cómo se poseen, transfieren y aprueban los NFT.

IPFS y los estándares de metadatos ayudan a las wallets a mostrar nombres, imágenes, atributos y contenido multimedia de NFT.

ERC-4906 ayuda a las aplicaciones a reaccionar cuando cambian los metadatos.

Estos elementos se combinan para convertir la propiedad en blockchain en una experiencia de producto útil.

Sin embargo, la integración de wallets también implica riesgos importantes.

Los usuarios pueden ser engañados para firmar aprobaciones maliciosas.

Las aplicaciones pueden exponer la privacidad de la wallet.

Los metadatos pueden dejar de funcionar o cargar contenido no seguro.

Las transacciones en la red equivocada pueden confundir a los usuarios.

Los indexadores pueden mostrar datos desactualizados.

Los procesos móviles pueden ocultar detalles importantes.

Los contratos inteligentes pueden contener errores aunque la wallet funcione correctamente.

Por ello, la integración de wallets de NFT debe tratarse como infraestructura de seguridad.

Los desarrolladores deberían solicitar los permisos mínimos, mostrar solicitudes claras, admitir correctamente los estándares de tokens, verificar las direcciones de contrato, gestionar los metadatos de forma segura, simular las transacciones cuando sea posible y diseñar la experiencia para usuarios móviles.

Los usuarios deberían conectar sus wallets con cuidado, leer todas las solicitudes de firma, evitar las aprobaciones sospechosas, separar las wallets según el nivel de riesgo y no compartir nunca las frases semilla.

El objetivo de la integración de wallets de NFT no es solo conseguir que funcione un botón para conectarse.

Es ayudar a los usuarios a entender y controlar sus activos digitales de forma segura en distintas aplicaciones.

Cuando se hace bien, la integración permite que la propiedad de NFT sea transferible, verificable y útil.

Cuando se hace mal, convierte la propiedad en una serie confusa de ventanas emergentes arriesgadas.

Los productos de NFT más sólidos serán los que simplifiquen la conexión de la wallet y, al mismo tiempo, mantengan suficientemente visibles los permisos, las redes, los contratos, los metadatos y los riesgos para que los usuarios puedan tomar decisiones informadas.