ERC-1155: ¿Qué es ERC-1155?ERC-1155 es un estándar de tokens de Ethereum que permite gestionar muchos tipos de tokens distintos mediante un solo contrato inteligente.Un único contrato ERC-1155 puede contener toERC-1155: ¿Qué es ERC-1155?ERC-1155 es un estándar de tokens de Ethereum que permite gestionar muchos tipos de tokens distintos mediante un solo contrato inteligente.Un único contrato ERC-1155 puede contener to
¿Qué es ERC-1155?
ERC-1155 es un estándar de tokens de Ethereum que permite gestionar muchos tipos de tokens distintos mediante un solo contrato inteligente.Un único contrato ERC-1155 puede contener tokens fungibles, tokens no fungibles, tokens semifungibles o una combinación de estos activos.La especificación ERC-1155 oficial define reglas comunes para saldos, transferencias, operaciones por lotes, autorizaciones, callbacks de recepción, eventos, metadatos y detección de interfaces.
ERC-1155 se conoce comúnmente como estándar multi-token.Cada tipo de token se identifica mediante un ID de token y puede tener su propia oferta, metadatos, finalidad, escasez y características económicas.Este diseño reduce la necesidad de desplegar un contrato inteligente independiente para cada activo de una aplicación cripto de gran tamaño.ERC-1155 resulta especialmente útil para videojuegos blockchain, coleccionables digitales, membresías, entradas para eventos, sistemas de recompensas, inventarios tokenizados y aplicaciones que gestionan varios activos relacionados.Seguir el estándar mejora la interoperabilidad, pero no garantiza que un token sea auténtico, valioso, escaso o seguro.¿Por qué se creó ERC-1155?
Los estándares de tokens de Ethereum anteriores solían centrarse en un activo fungible o en una colección de activos únicos.Por ello, un proyecto con cientos de monedas, artículos de videojuegos, entradas y coleccionables podía necesitar muchos contratos independientes.Cada contrato adicional genera costes de despliegue, código repetido, trabajo administrativo y complejidad de integración.ERC-1155 permite que estos tipos de tokens compartan un contrato y un sistema común de transferencias.También admite operaciones por lotes para consultar o transferir varios ID de token en una sola llamada.Agrupar operaciones puede reducir los costes repetidos de transacción y simplificar las interacciones que implican muchos activos.El estándar se diseñó pensando en sistemas de tokens de gran tamaño, pero no se limita a los videojuegos blockchain.Cómo funciona ERC-1155
Un contrato ERC-1155 registra un saldo independiente para cada combinación de dirección de cuenta e ID de token.Por ejemplo, una wallet podría poseer 500 unidades del ID de token 1, tres unidades del ID de token 2 y una unidad del ID de token 3.El ID de token 1 podría representar una moneda fungible, el ID de token 2 un artículo de edición limitada y el ID de token 3 un NFT único.Los tres saldos pueden existir en el mismo contrato inteligente.Cuando se transfieren tokens, el contrato reduce el saldo del remitente y aumenta el del destinatario para los ID seleccionados.El contrato emite eventos estandarizados para que las wallets y los indexadores de blockchain puedan observar los cambios.Si el destinatario es un contrato inteligente, ERC-1155 ejecuta un callback de recepción para confirmar que el contrato acepta los tokens.¿Qué es un ID de token ERC-1155?
Un ID de token es un entero sin signo que identifica un tipo de token dentro de un contrato ERC-1155.El mismo ID de token puede aparecer en otro contrato sin representar el mismo activo cripto.Por tanto, un activo ERC-1155 se identifica conjuntamente por su red blockchain, la dirección del contrato y el ID de token.El ID de token 100 en un contrato podría representar un recurso de videojuego, mientras que el ID de token 100 de otro contrato podría representar una entrada para un evento.El estándar no exige que los ID de token comiencen en cero ni que aumenten en un orden sencillo.Los desarrolladores pueden asignar los ID según el diseño de su aplicación.Los usuarios deben verificar la dirección completa del contrato y el ID de token, en lugar de confiar únicamente en el nombre o la imagen mostrados.Tokens fungibles ERC-1155
Un ID de token puede funcionar como activo fungible cuando existen muchas unidades intercambiables de ese ID.Por ejemplo, un videojuego podría emitir un millón de unidades del ID de token 10 como moneda del juego.Cada titular tendría un saldo cuantitativo asociado al ID de token 10.Normalmente, las unidades del mismo ID tienen las mismas propiedades definidas por el contrato.La interfaz principal ERC-1155 no define un símbolo, valor decimal ni nombre independiente para cada ID de token.Cuando sea necesario, los proyectos deben proporcionar esta información de visualización mediante metadatos o funciones personalizadas.Tokens no fungibles ERC-1155
Un ID de token puede funcionar como NFT cuando su oferta se limita a una unidad.La dirección que posee esa unidad es, en la práctica, titular del activo único representado por el ID.Otro ID del mismo contrato puede representar un artículo único distinto.A diferencia de ERC-721, ERC-1155 no exige automáticamente que la oferta de cada ID de token sea de una unidad.La lógica de acuñación del contrato debe imponer la unicidad cuando se describe un ID como no fungible.Los usuarios deben comprobar los controles de oferta reales antes de confiar en que un artículo ERC-1155 sea único.Tokens semifungibles ERC-1155
Un token semifungible tiene varias unidades intercambiables durante una etapa de su ciclo de vida, pero después puede adquirir un significado o una utilidad diferentes.Las entradas para eventos son un ejemplo habitual, ya que varias entradas de una misma sección pueden ser intercambiables antes del evento.Después del evento, cada entrada utilizada puede convertirse en un coleccionable vinculado a una experiencia concreta.Los artículos de videojuegos de edición limitada también pueden utilizar un modelo semifungible.ERC-1155 no etiqueta formalmente un ID de token como fungible, no fungible o semifungible.La clasificación depende de la oferta, los metadatos, las reglas de transferencia y el comportamiento de la aplicación.Funciones principales de ERC-1155
La interfaz principal ERC-1155 incluye funciones para consultar saldos, transferir tokens y gestionar permisos de operador.Sus funciones principales son
balanceOf
, balanceOfBatch
, safeTransferFrom
, safeBatchTransferFrom
, setApprovalForAll
e isApprovedForAll
.ERC-1155 también exige compatibilidad con la detección de interfaces ERC-165.La interfaz principal no define la acuñación pública, la quema pública, los royalties, la oferta total, los decimales de los tokens ni las autorizaciones de tokens individuales.Los contratos pueden añadir estas funciones mediante extensiones opcionales o lógica personalizada.La función balanceOf
La función
balanceOf
devuelve la cantidad de un ID de token que posee una cuenta.Requiere tanto la dirección de una cuenta como un ID de token.Esto difiere de ERC-20, porque un contrato ERC-20 suele representar un único tipo de token.También difiere de ERC-721, ya que el saldo ERC-721 cuenta cuántos NFT únicos de la colección posee una dirección.El saldo ERC-1155 para un ID puede ser cero, uno o un entero superior.El estándar exige que falle una consulta de saldo para la dirección cero.La función balanceOfBatch
La función
balanceOfBatch
obtiene varios saldos en una sola llamada.El emisor de la llamada proporciona una matriz de direcciones de cuenta y otra de ID de token.Cada cuenta se empareja con el ID de token situado en la misma posición de la matriz.Las dos matrices deben tener la misma longitud.La función permite consultar varios ID de token para una cuenta o un ID de token para varias cuentas.Esto reduce el número de llamadas blockchain independientes que necesitan las wallets, los videojuegos y las aplicaciones de cartera.La función safeTransferFrom
La función
safeTransferFrom
transfiere una cantidad de un ID de token de una dirección a otra.El emisor de la llamada debe ser el titular del token o un operador autorizado por ese titular.El remitente debe poseer suficientes unidades del ID seleccionado.El destinatario no puede ser la dirección cero.La función también acepta un campo de bytes que puede contener datos específicos de la aplicación.Una transferencia individual correcta emite un evento
TransferSingle
.Si el destinatario es un contrato inteligente, debe superar la comprobación de aceptación ERC-1155 obligatoria.La función safeBatchTransferFrom
La función
safeBatchTransferFrom
transfiere varios ID de token y cantidades en una sola transacción.El emisor de la llamada proporciona una matriz de ID de token y otra coincidente con las cantidades que se van a transferir.La cantidad de cada posición se aplica al ID situado en la misma posición de la matriz.Las matrices deben tener la misma longitud.El remitente debe tener unidades suficientes de cada token incluido en el lote.Si falla alguna transferencia necesaria, normalmente se revierte toda la transacción.Una operación correcta emite un único evento
TransferBatch
.Ventajas de las transferencias por lotes
Las transferencias por lotes pueden reducir los costes de transacción cuando deben moverse juntos varios activos relacionados.Un jugador podría transferir moneda, materiales, equipamiento y coleccionables en una sola transacción.Un contrato de recompensas podría distribuir varios tipos de tokens a un destinatario en una sola operación.Agrupar operaciones también puede simplificar los intercambios atómicos, ya que el conjunto completo de activos se mueve o la transacción falla.El ahorro de gas depende del número de ID, los cambios de almacenamiento, la lógica del receptor y las condiciones de la red.Los lotes muy grandes aún pueden superar los límites de gas de la transacción o generar riesgos de denegación de servicio.Las aplicaciones deben establecer límites prácticos para el tamaño de los lotes controlados por los usuarios.Autorizaciones de operadores ERC-1155
ERC-1155 utiliza autorizaciones de operadores que abarcan toda la colección.La función
setApprovalForAll
permite al titular del token autorizar o revocar a un operador.Un operador autorizado puede transferir todos los ID de token ERC-1155 que posea el titular dentro de ese contrato.El permiso también puede abarcar los tokens que el titular reciba posteriormente del mismo contrato.El estándar principal no permite autorizar únicamente un ID o una cantidad limitada.Este permiso amplio puede facilitar el uso, pero conlleva un riesgo de seguridad significativo.Un operador malicioso puede retirar todos los tokens afectados mientras la autorización siga activa.La función isApprovedForAll
La función
isApprovedForAll
indica si un operador tiene autoridad sobre los saldos ERC-1155 de un titular.Devuelve
true
o false
.La autorización solo se aplica al contrato en el que se concedió.No abarca automáticamente activos de otro contrato ERC-1155 ni tokens que utilicen otro estándar.Los usuarios deben revisar periódicamente las autorizaciones de operadores y revocar los permisos que ya no necesiten.Desconectar una wallet de un sitio web no elimina una autorización almacenada en la blockchain.Extensiones para autorizaciones granulares
El modelo amplio de operadores puede no ser adecuado si un titular quiere autorizar solo un ID de token o una cantidad limitada.La extensión de allowance ERC-5216 propuesta define autorizaciones más granulares por ID y cantidad.
Esta extensión no forma parte del estándar principal ERC-1155 y no debe darse por supuesta en todos los contratos.Las wallets deben explicar claramente si una transacción concede autoridad para toda la colección o un permiso limitado.Callbacks de recepción ERC-1155
Un contrato inteligente que recibe tokens ERC-1155 mediante una transferencia segura estándar debe implementar el callback de recepción correcto.El callback para una transferencia individual es
onERC1155Received
.El callback para una transferencia por lotes es
onERC1155BatchReceived
.El receptor puede inspeccionar el operador, el titular anterior, los ID de token, las cantidades y los datos adjuntos.Acepta los tokens devolviendo el valor requerido.Si devuelve un valor incorrecto o revierte la operación, se revierte toda la transferencia de tokens.Este diseño reduce las transferencias accidentales a contratos inteligentes que no pueden procesar activos ERC-1155.ID de interfaz del receptor y valores devueltos
El ID de interfaz del receptor ERC-1155 es
0x4e2312e0
.El valor de retorno esperado para
onERC1155Received
es 0xf23a6e61
.El valor de retorno esperado para
onERC1155BatchReceived
es 0xbc197c81
.Un contrato receptor debe verificar qué contrato ERC-1155 activó el callback.Aceptar datos de callback sin comprobar quién los envía puede permitir que un contrato malicioso cree registros de depósito falsos.Superar una comprobación de recepción no garantiza que el contrato receptor tenga un proceso seguro de retirada futura.Callbacks de recepción y reentrancia
Los callbacks de recepción ERC-1155 ejecutan código de contratos externos antes de que finalice la transacción original.Un receptor malicioso puede llamar a otra función mientras la transferencia original sigue en curso.Este comportamiento crea una posible vía de reentrancia.La especificación ERC-1155 exige que los cambios de saldo y los eventos de transferencia se produzcan antes del callback de recepción.Las aplicaciones que interactúan con el token deben proteger igualmente su propia contabilidad y lógica de autorización.Los desarrolladores deben probar ambos callbacks con contratos receptores maliciosos que intenten reentrar en la misma función o en otra.La documentación de implementación ERC-1155 actual también advierte de que las transferencias a contratos pueden generar riesgo de reentrancia.
Eventos ERC-1155
El estándar principal define los eventos
TransferSingle
, TransferBatch
, ApprovalForAll
y URI
.Estos registros de eventos permiten a las wallets, los exploradores de blockchain y los indexadores hacer un seguimiento de la actividad de los tokens.ERC-1155 está diseñado para que el historial de oferta y saldos pueda reconstruirse a partir de los eventos de transferencia emitidos correctamente.Todos los eventos deben interpretarse junto con la dirección del contrato que los emitió.Un contrato malicioso puede emitir eventos con nombres conocidos sin representar un proyecto auténtico.El evento TransferSingle
El evento
TransferSingle
registra el operador, el remitente, el destinatario, el ID de token y la cantidad.Una transferencia normal contiene direcciones de remitente y destinatario distintas de cero.En una acuñación, la dirección cero se utiliza como remitente.En una quema, la dirección cero se utiliza como destinatario.El estándar también exige que las transferencias de valor cero emitan el evento correspondiente.El evento TransferBatch
El evento
TransferBatch
registra varios ID de token y cantidades transferidos en una sola operación.Los ID y valores se almacenan en posiciones correspondientes de las matrices.El evento también identifica al operador, al remitente y al destinatario.En una acuñación por lotes, la dirección cero se utiliza como remitente.En una quema por lotes, la dirección cero se utiliza como destinatario.Los indexadores deben procesar todos los elementos de las matrices del evento para calcular correctamente los saldos y las ofertas.El evento ApprovalForAll
El evento
ApprovalForAll
registra si un titular ha habilitado o deshabilitado a un operador.Contiene el titular, el operador y el estado de la autorización.El evento no transfiere tokens por sí mismo.Cambia si el operador puede iniciar futuras transferencias desde la cuenta del titular.Revocar una autorización no revierte las transferencias completadas mientras estaba activa.Detección de interfaces ERC-165
ERC-1155 exige la detección de interfaces ERC-165.El ID de la interfaz principal ERC-1155 es
0xd9b67a26
.Un contrato compatible debería devolver
true
cuando se llame a supportsInterface
con ese identificador.El estándar ERC-165 ofrece a los contratos un método común para publicar las interfaces compatibles.
La detección de interfaces ayuda a las aplicaciones a evitar llamadas a funciones no compatibles.Un resultado positivo no demuestra por sí solo que todas las funciones estén implementadas de forma correcta o segura.Metadatos ERC-1155
ERC-1155 incluye una extensión opcional de URI de metadatos.La extensión añade una función
uri
que devuelve una ubicación de metadatos para un ID de token.Su ID de interfaz es
0x0e89341c
.La URI suele apuntar a un documento JSON que contiene un nombre, una descripción, una imagen, atributos y otra información del token.El estándar principal no exige funciones on-chain independientes de
name
, symbol
o decimals
para cada ID de token.Los proyectos pueden añadir estos campos mediante metadatos o interfaces personalizadas.El marcador {id} en los metadatos
Una URI de metadatos ERC-1155 puede contener el marcador
{id}
.Las aplicaciones sustituyen este marcador por el ID de token solicitado en formato hexadecimal en minúsculas.El valor formateado debe contener 64 caracteres hexadecimales, incluidos los ceros iniciales.No debe incluir el prefijo
0x
.Este método permite que una URI base describa las ubicaciones de metadatos de muchos ID de token.Si una aplicación realiza mal la sustitución, puede obtener los metadatos de un activo equivocado.Riesgos del almacenamiento de metadatos
Los metadatos ERC-1155 pueden almacenarse en un servidor web, una red direccionada por contenido o directamente on-chain.Los metadatos alojados en servidores pueden cambiar o desaparecer.El almacenamiento direccionado por contenido puede mejorar la integridad, pero el contenido debe seguir disponible.Los metadatos on-chain reducen la dependencia del alojamiento externo, pero pueden resultar más caros de almacenar y actualizar.Una URI modificable puede permitir que un administrador cambie nombres, imágenes, descripciones y atributos después de que los usuarios hayan adquirido tokens.Los usuarios deben averiguar quién controla los metadatos y si puede verificarse alguna garantía de permanencia.Acuñación de tokens ERC-1155
La acuñación crea nuevas unidades de un ID de token ERC-1155.El estándar principal no define una función pública de acuñación ni determina quién puede crear tokens.Una implementación puede restringir la acuñación a un administrador, un contrato inteligente, un proceso de gobernanza u otro rol autorizado.Una acuñación individual emite
TransferSingle
desde la dirección cero.Una acuñación por lotes emite
TransferBatch
desde la dirección cero.La acuñación a un contrato inteligente normalmente activa el callback de recepción correspondiente.Los usuarios deben revisar la autoridad de acuñación antes de confiar en afirmaciones sobre la oferta o la escasez.Quema de tokens ERC-1155
La quema elimina unidades de tokens de la circulación según las reglas del contrato.El estándar principal no exige una función pública de quema.Un contrato puede permitir que los titulares, los operadores autorizados, los administradores o la lógica del protocolo quemen tokens.Una quema emite un evento de transferencia con la dirección cero como destinatario.Quemar todas las unidades actuales de un ID no impide necesariamente que se vuelva a acuñar ese ID.El resultado depende de los controles de acuñación y oferta de la implementación.Oferta total y enumeración
La interfaz principal ERC-1155 no incluye una función
totalSupply
.La oferta puede reconstruirse a partir de los eventos de acuñación y quema cuando el contrato cumple correctamente los requisitos de emisión de eventos.Una implementación puede añadir una extensión opcional de seguimiento de oferta que indique la oferta total de cada ID.La biblioteca de contratos ERC-1155 actual incluye extensiones para el seguimiento de la oferta, la quema, la pausa y el almacenamiento de URI.
ERC-1155 tampoco define una función principal para enumerar todos los ID de token o titulares existentes.Las aplicaciones suelen utilizar la indexación de eventos off-chain para crear estas listas.Royalties ERC-1155
Los royalties para creadores no forman parte del estándar principal ERC-1155.El estándar de royalties ERC-2981, opcional, permite que un contrato indique un destinatario de royalties y un importe sugerido.
El importe de los royalties se calcula a partir de un precio de venta proporcionado.ERC-2981 comunica información sobre royalties, pero no impone automáticamente su pago en todas las transferencias.Una transferencia puede realizarse sin que haya una venta, lo que explica en parte por qué el contrato del token no puede tratar cada movimiento como un evento sujeto a royalties.Los usuarios deben averiguar si un administrador puede modificar la configuración de royalties.Errores estandarizados ERC-1155
La especificación original ERC-1155 no define errores personalizados modernos de Solidity.El estándar Final ERC-6093 define nombres de errores comunes para los contratos ERC-1155.
Estos errores abarcan saldos insuficientes, remitentes no válidos, destinatarios no válidos, falta de autorización del operador, operadores no válidos y longitudes de matriz no coincidentes.Los errores estandarizados pueden ayudar a las wallets y a los desarrolladores a explicar los fallos de las transacciones de forma más coherente.Los contratos ERC-1155 existentes no están obligados a adoptar estos errores.ERC-1155 frente a ERC-20
ERC-20 suele representar un tipo de token fungible por contrato.ERC-1155 puede representar muchos tipos de tokens en un solo contrato.ERC-20 utiliza allowances numéricas para los operadores, mientras que ERC-1155 utiliza en su interfaz principal autorizaciones de operadores para toda la colección.ERC-1155 incluye transferencias por lotes y callbacks de recepción obligatorios para los destinatarios que sean contratos inteligentes.El estándar principal ERC-20 no incluye estas funciones.ERC-20 puede seguir siendo más sencillo cuando un proyecto solo necesita un activo cripto fungible.ERC-1155 frente a ERC-721
ERC-721 está diseñado para ID de tokens no fungibles de titularidad individual.Un ID de token ERC-721 válido tiene un titular.ERC-1155 almacena un saldo cuantitativo para cada combinación de cuenta e ID de token.Esto permite que un ID tenga muchas unidades intercambiables mientras que otro ID del mismo contrato tenga una oferta de una unidad.ERC-1155 también admite transferencias por lotes estandarizadas, mientras que ERC-721 normalmente transfiere un NFT cada vez.ERC-721 puede ofrecer un modelo más sencillo cuando todos los activos son únicos.Casos de uso habituales de ERC-1155
Los videojuegos blockchain pueden gestionar monedas, materiales, armas, personajes y terrenos mediante un único contrato ERC-1155.Los sistemas de eventos pueden emitir distintas categorías y cantidades de entradas bajo ID de token separados.Los proyectos de membresía pueden crear varios niveles de acceso o paquetes de ventajas.Los artistas digitales pueden emitir ediciones limitadas con varias copias intercambiables de cada obra.Las aplicaciones financieras pueden utilizar ID de token para identificar fechas de vencimiento, derechos, categorías de posiciones o grupos de riesgo.Los sistemas de recompensas pueden distribuir varios tipos de puntos o artículos de logros en una sola transacción por lotes.El estándar no verifica de forma independiente que un token represente un derecho legalmente exigible o un activo del mundo real.Riesgos de autorización ERC-1155
El phishing de autorizaciones de operadores es un riesgo importante para los titulares de ERC-1155.Un sitio web malicioso puede solicitar
setApprovalForAll
presentando la transacción como una verificación, conexión de cuenta o acceso a recompensas.Después de la autorización, el operador puede transferir todos los tokens ERC-1155 que tenga el usuario en ese contrato.La autorización puede seguir activa hasta que el titular la revoque.Antes de firmar, los usuarios deben verificar la red, el contrato del token, la dirección del operador y el tipo de permiso.Nunca se necesita una frase de recuperación de wallet ni una clave privada para cancelar una autorización de operador.Riesgos de las operaciones por lotes
Las operaciones por lotes utilizan matrices cuyas posiciones deben permanecer correctamente alineadas.Una discrepancia entre los ID de token y las cantidades debe hacer que falle la transacción.Un indexado incorrecto puede transferir una cantidad equivocada de un activo.Las matrices muy grandes controladas por el usuario pueden consumir demasiado gas o hacer que una función resulte inutilizable.Un contrato receptor debe validar todos los ID y cantidades antes de aceptar un lote.Los desarrolladores deben probar matrices vacías, ID repetidos, longitudes no coincidentes, lotes grandes e ID de activos no compatibles.Riesgos de oferta y autenticidad
Un ID de token puede parecer único porque actualmente solo existe una unidad.Sin embargo, una cuenta autorizada todavía podría acuñar más unidades posteriormente.Otro contrato puede copiar el mismo nombre, ID, imagen o metadatos del token.La dirección del contrato y la red son elementos esenciales para identificar un token ERC-1155.Los usuarios deben examinar los roles de acuñación, los límites de oferta, los permisos de actualización y los controles de metadatos.La compatibilidad con ERC-1155 no demuestra autenticidad, escasez, respaldo de garantías ni valor de inversión.Riesgos de los contratos actualizables
Un contrato ERC-1155 puede funcionar mediante un proxy actualizable.Un administrador autorizado puede tener la capacidad de cambiar la acuñación, las transferencias, las autorizaciones, los metadatos, las comisiones u otros comportamientos.Las actualizaciones pueden corregir vulnerabilidades, pero también introducir lógica dañina.Si se compromete una clave de actualización, todos los ID de token gestionados por el contrato pueden quedar en riesgo.Los usuarios deben revisar la autoridad de actualización, los periodos de espera, los controles de multifirma y los permisos de emergencia.La compatibilidad con la interfaz correcta no demuestra que un contrato esté descentralizado o sea inmutable.Cómo deben implementar ERC-1155 los desarrolladores
Los desarrolladores deben partir de una implementación mantenida y revisada activamente, salvo que necesiten lógica de saldos personalizada.La guía de desarrollo ERC-1155 actual explica los saldos multi-token, las operaciones por lotes, las comprobaciones del receptor y las extensiones habituales.
Las funciones de acuñación y administración deben utilizar controles de acceso claros.Las restricciones de oferta deben imponerse en el código del contrato, no limitarse a describir en la documentación del proyecto.Las implementaciones deben emitir todos los eventos obligatorios de transferencia y autorización.Las pruebas deben cubrir transferencias individuales y por lotes, acuñaciones, quemas, permisos de operador, receptores no válidos, discrepancias entre matrices y callbacks maliciosos.Los desarrolladores también deben verificar los identificadores ERC-165 correctos de cada extensión compatible.Cómo pueden evaluar los usuarios un token ERC-1155
El primer paso es verificar la red blockchain, la dirección del contrato y el ID de token.El segundo paso es determinar si el token está pensado para ser fungible, no fungible o semifungible.El tercer paso es examinar la oferta actual, la autoridad de acuñación y cualquier límite de oferta.El cuarto paso es revisar las autorizaciones de operadores activas asociadas a la wallet.El quinto paso es averiguar cómo se almacenan los metadatos y si pueden cambiar.El sexto paso es identificar las facultades de administración, pausa, congelación, royalties y actualización.El séptimo paso es examinar el código fuente, las auditorías y el historial de incidentes sin considerarlos garantías.El octavo paso es comprender qué utilidad, derecho de reembolso o reclamación legal ofrece realmente el token.El noveno paso es comprobar si los contratos receptores ofrecen un proceso de retirada fiable.El décimo paso es probar un contrato desconocido con una cantidad pequeña antes de transferir activos valiosos.Ejemplo de transferencia por lotes ERC-1155
Supongamos que Alice posee 100 unidades del ID de token 1, cinco unidades del ID de token 2 y una unidad del ID de token 3.Quiere enviar a Bob diez unidades del ID 1, dos unidades del ID 2 y una unidad del ID 3.Su wallet llama a
safeBatchTransferFrom
con matrices que contienen los tres ID y las cantidades correspondientes.El contrato verifica los saldos de Alice y confirma que el emisor de la llamada está autorizado.Reduce los saldos de Alice y aumenta los de Bob para cada ID.El contrato emite un único evento
TransferBatch
que describe el movimiento.Si Bob es un contrato inteligente, el contrato del token llama a
onERC1155BatchReceived
.Si el destinatario devuelve el valor correcto, la transacción se completa.Si falla alguna comprobación de saldo, autorización, matriz o receptor, se revierte toda la transacción.Errores habituales con ERC-1155
Un error habitual es suponer que todos los ID de token ERC-1155 representan NFT.Otro error es suponer que un ID con una unidad actual tiene una oferta máxima permanente de una unidad.Un tercer error es conceder una autorización de operador sin entender que abarca todos los ID de token del contrato.Un cuarto error es creer que desconectar una wallet elimina una autorización on-chain.Un quinto error es usar la disponibilidad de metadatos como prueba de que se ha acuñado un token.Un sexto error es suponer que todos los contratos ofrecen una función de oferta total.Un séptimo error es procesar matrices por lotes sin comprobar sus longitudes y posiciones.Un octavo error es ignorar los callbacks del receptor y el riesgo de reentrancia.Un noveno error es suponer que los royalties comunicados se aplican automáticamente.Un décimo error es considerar que la conformidad de la interfaz demuestra autenticidad, escasez o seguridad.Preguntas frecuentes
¿Qué significa ERC-1155?
ERC-1155 es el estándar multi-token de Ethereum para gestionar muchos tipos de tokens fungibles, no fungibles y semifungibles en un solo contrato.¿ERC-1155 es una criptomoneda?
ERC-1155 es un estándar técnico, y los contratos que lo implementan pueden crear distintos tipos de activos cripto.¿Cuál es el ID de interfaz ERC-1155?
El ID de la interfaz principal ERC-1155 es
0xd9b67a26
.¿Cuál es el ID de interfaz del receptor ERC-1155?
El ID de la interfaz del receptor es
0x4e2312e0
.¿Puede ERC-1155 crear tokens fungibles?
Sí. Un ID de token puede representar muchas unidades intercambiables distribuidas entre varias cuentas.¿Puede ERC-1155 crear NFT?
Sí. Un ID de token puede funcionar como NFT cuando el contrato limita su oferta a una unidad.¿Qué es un token semifungible?
Es un token cuyas unidades son intercambiables en un contexto, pero que posteriormente adquieren un significado, estado o utilidad distintos.¿Puede un contrato ERC-1155 contener muchos activos?
Sí. Un contrato puede gestionar muchos ID de token con distintas ofertas, metadatos y finalidades.¿Qué devuelve balanceOf?
Devuelve la cantidad que posee una cuenta de un ID de token concreto.¿Qué hace balanceOfBatch?
Devuelve en una sola llamada los saldos de varios pares de cuenta e ID de token.¿Qué es safeBatchTransferFrom?
Transfiere varios ID de token y cantidades en una sola transacción y comprueba la recepción cuando el destinatario es un contrato inteligente.¿Qué hace setApprovalForAll?
Autoriza a un operador a gestionar todos los ID de token que posee quien realiza la llamada dentro de un contrato ERC-1155.¿Pueden los usuarios autorizar un único ID de token?
No mediante la función de autorización principal ERC-1155, aunque las extensiones opcionales pueden ofrecer permisos más limitados.¿Caduca automáticamente una autorización ERC-1155?
No. Una autorización estándar de operador sigue activa hasta que el titular la revoca o la lógica personalizada modifica sus efectos.¿ERC-1155 exige comprobaciones del receptor?
Sí. Las transferencias seguras estándar a contratos inteligentes deben seguir las reglas correspondientes del callback de recepción individual o por lotes.¿Puede un contrato receptor rechazar tokens ERC-1155?
Sí. Puede revertir la operación o devolver un valor de aceptación incorrecto, lo que hace que falle la transferencia.¿ERC-1155 admite metadatos?
Sí. Incluye una extensión opcional de URI de metadatos con el ID de interfaz
0x0e89341c
.¿Todos los tokens ERC-1155 tienen nombre y símbolo?
No. El estándar principal no exige funciones on-chain independientes de nombre o símbolo para cada ID de token.¿ERC-1155 define decimales?
No. Cuando se necesita información sobre la denominación, debe obtenerse de los metadatos o de la lógica específica del proyecto.¿ERC-1155 incluye totalSupply?
No. La oferta total requiere indexar eventos o utilizar una extensión opcional de seguimiento de oferta.¿Pueden cambiar los metadatos ERC-1155?
Sí. Los metadatos pueden cambiar si el contrato o el sistema de almacenamiento externo permite actualizaciones.¿ERC-1155 impone el pago de royalties?
No. La información de royalties requiere un estándar independiente y las funciones principales de transferencia no los imponen automáticamente.¿Las transferencias por lotes ERC-1155 pueden ahorrar gas?
Sí. Combinar varios movimientos de tokens en una sola transacción puede reducir los costes repetidos de transacción.¿Los callbacks ERC-1155 pueden provocar reentrancia?
Sí. Los callbacks de recepción ejecutan código externo y pueden llamar a otras funciones del contrato antes de que finalice la transacción original.¿La conformidad con ERC-1155 hace que un token sea seguro?
No. Un contrato compatible todavía puede contener código inseguro, permisos excesivos, metadatos modificables, controles de oferta débiles o afirmaciones fraudulentas.Conclusión
ERC-1155 es el estándar de Ethereum para gestionar muchos tipos de tokens mediante un solo contrato inteligente.Cada ID de token puede representar un activo fungible, un NFT único, un artículo semifungible u otro activo cripto basado en cantidades.El estándar define consultas de saldo, transferencias individuales y por lotes, autorizaciones de operadores para toda la colección, callbacks de recepción, eventos, reglas de metadatos y detección de interfaces.Las operaciones por lotes pueden reducir los costes de transacción cuando es necesario consultar o transferir varios activos conjuntamente.Los callbacks obligatorios del receptor reducen las transferencias accidentales a contratos incompatibles, pero introducen riesgos de llamadas externas y reentrancia.El estándar principal no define acuñación pública, quema, oferta total, decimales, royalties, metadatos permanentes ni allowances para tokens individuales.Estas propiedades dependen de las extensiones opcionales y de la implementación concreta del contrato.Los usuarios deben verificar la red, la dirección del contrato, el ID de token, los controles de oferta, las autorizaciones de operadores, el sistema de metadatos y los permisos de administrador.Los desarrolladores deben utilizar implementaciones mantenidas, emitir todos los eventos obligatorios, proteger los callbacks del receptor, limitar la complejidad de los lotes y probar todas las vías de autorización.ERC-1155 proporciona una infraestructura multi-token flexible, pero la compatibilidad técnica no garantiza autenticidad, escasez, valor financiero ni seguridad del contrato inteligente.También te puede interesar
WhatsMiner M30S++
¿Qué es WhatsMiner M30S++? WhatsMiner M30S++ es un minero ASIC de Bitcoin de MicroBT diseñado para la minería Proof of Work con SHA-256. Forma parte de la serie WhatsMiner M30 y se utiliza principalme
2026/10/15 11:08
Dominios Web3
¿Qué son los dominios Web3? Los dominios Web3 son nombres basados en blockchain que pueden sustituir direcciones largas de carteras, dirigir a contenido descentralizado, representar una identidad on-c
2026/10/15 11:08
Proyectos Web3
¿Qué son los proyectos Web3? Los proyectos Web3 son aplicaciones, protocolos, herramientas, redes y comunidades basados en blockchain que utilizan tecnología descentralizada para dar a los usuarios ma
2026/10/15 11:06
POPULAR
Criptomonedas de moda que están acaparando la atención del mercado
Volumen TOP
Las criptomonedas con mayor volumen de trading
Recién Añadidos
Criptomonedas recientemente listadas y disponibles para operar