Estándar de token ERC721: cómo funcionan los NFT
Qué define el estándar ERC721, cómo funcionan propiedad, aprobaciones y transferencias, en qué se diferencia de ERC20 y cómo enviar tokens ERC721 por API.
Revisado por Maurice Sobiera
ERC721 es el estándar de Ethereum para tokens no fungibles (NFT). Define una interfaz común que implementa un contrato inteligente, de modo que cada token tiene un ID único, exactamente un propietario y el mismo conjunto de funciones para transferencias y aprobaciones. Así, los monederos, los marketplaces y las API pueden tratar cualquier contrato ERC721 de la misma manera.
¿Qué define el estándar ERC721?
El estándar se especifica en EIP-721. Un contrato conforme debe implementar la interfaz ERC721 y la interfaz ERC165, que permite a otros contratos preguntar si un contrato admite una interfaz. El ID de la interfaz ERC721 es 0x80ac58cd.
La interfaz tiene tres eventos y ocho funciones (safeTransferFrom existe en dos formas):
| Elemento | Tipo | Finalidad |
|---|---|---|
Transfer | evento | Se emite cada vez que cambia la propiedad de un token, incluidas la acuñación y la quema |
Approval | evento | Se emite cuando cambia la dirección aprobada para un token |
ApprovalForAll | evento | Se emite cuando un propietario activa o desactiva un operador para todos sus tokens |
balanceOf(owner) | función | Número de tokens que posee una dirección |
ownerOf(tokenId) | función | Dirección que posee un token |
safeTransferFrom(from, to, tokenId) | función | Transfiere un token y comprueba que un contrato receptor puede gestionarlo |
transferFrom(from, to, tokenId) | función | Transfiere un token sin esa comprobación |
approve(to, tokenId) | función | Permite a una dirección mover un token concreto |
setApprovalForAll(operator, approved) | función | Permite a un operador mover todos los tokens del llamante |
getApproved(tokenId) | función | Devuelve la dirección aprobada de un token |
isApprovedForAll(owner, operator) | función | Indica si un operador está aprobado para un propietario |
safeTransferFrom tiene una segunda forma con un argumento data adicional. Cuando el receptor es un contrato inteligente, ambas formas llaman a onERC721Received en él y revierten si el contrato no devuelve el valor esperado. Así se evita enviar tokens a contratos que no podrán volver a moverlos. transferFrom no tiene esa comprobación, y EIP-721 establece que quien llama es responsable de confirmar que el receptor puede gestionar NFT.
Existen dos extensiones opcionales. La extensión de metadatos añade name(), symbol() y tokenURI(tokenId), donde la URI suele apuntar a un archivo JSON con nombre, descripción e imagen. La extensión de enumeración añade totalSupply() y funciones para listar tokens por índice.
¿Cómo se crea un token ERC721?
Escriba un contrato inteligente que implemente la interfaz, compílelo y despliegue el bytecode en la blockchain de Ethereum. La mayoría de los equipos parten de una biblioteca mantenida en lugar de escribir las funciones a mano. La documentación de ERC721 de OpenZeppelin describe una implementación mantenida, y el IDE Remix, basado en web, puede compilarla y desplegarla sin herramientas locales.
El despliegue devuelve una dirección de contrato. Pruebe primero el contrato en una testnet y después despliéguelo en mainnet.
¿Qué es una dirección de contrato y por qué importa?
La dirección de contrato es el único identificador fiable de una colección de tokens ERC721. Los nombres y los símbolos no son únicos: cualquiera puede desplegar un contrato que se llame igual que una colección existente. Un token se identifica por completo mediante el par formado por la dirección del contrato y el ID del token.
Al integrar un token ERC721, guarde siempre ambos valores. Dos contratos distintos pueden tener cada uno un token con ID 1.
¿Cuál es la diferencia entre ERC721 y ERC20?
Los tokens ERC20 son fungibles: cada unidad es intercambiable, y el contrato solo guarda un saldo por dirección. Los tokens ERC721 no son fungibles: cada ID de token tiene su propio propietario y sus propios metadatos. EIP-721 se diseñó a partir del modelo ERC20 y señala la falta de seguimiento por activo como la razón por la que ERC20 no encaja con los NFT.
Las diferencias prácticas para una integración son pequeñas, pero fáciles de pasar por alto:
- Las transferencias ERC20 reciben un importe; las ERC721 reciben un ID de token.
balanceOfen un contrato ERC721 cuenta tokens, no valor.- ERC721 tiene aprobaciones por token además de aprobaciones de operador.
Para una comparación más larga con ERC1155, que puede contener tokens fungibles y no fungibles en un mismo contrato, lea ERC-721 vs ERC-1155 y Estándares de token explicados. Nuestra explicación de ERC20 está en El estándar de token ERC20.
¿Se pueden pagar las comisiones de gas con tokens ERC721?
No. El gas en Ethereum se paga siempre en ETH, incluso si la transacción solo mueve un token ERC721. La dirección emisora necesita suficiente ETH para cubrir el gas, y la comisión es el gas usado multiplicado por el precio del gas. Puede consultar el precio actual en el gas tracker de Etherscan, y ethereum.org explica cómo se calcula la comisión.
¿Cuánto cuesta crear un token ERC721?
Desplegar el contrato cuesta gas, y el importe depende del tamaño del contrato que despliegue. Acuñar cada token cuesta gas adicional, que paga el propietario del contrato o el usuario que acuña, según cómo esté escrito el contrato. Estime el despliegue en una testnet con eth_estimateGas antes de desplegar en mainnet, y después multiplique el resultado por el precio actual del gas.
¿Son legales los tokens ERC721?
El estándar del token es solo una interfaz técnica. Si un uso está regulado depende de lo que represente el token y de dónde estén situadas las partes. Vender tokens, aceptarlos como pago o ofrecerlos como participaciones de una empresa puede conllevar obligaciones de licencia, fiscales, de Conozca a su cliente (KYC) o de prevención del blanqueo de capitales (AML). Consulte con un abogado que conozca su jurisdicción antes de lanzar un modelo de negocio basado en ellos.
¿Cómo se envían tokens ERC721 automáticamente?
Puede enviar tokens ERC721 mediante un script a través de la API REST de Chaingateway, en lugar de usar un monedero para cada transferencia. El endpoint es POST /api/v2/ethereum/transactions/erc721, y recibe la dirección emisora, la dirección del contrato, el receptor y el ID del token. El gas se paga en ETH desde la dirección emisora, y existen endpoints equivalentes para Polygon y Arbitrum (erc721) y para BNB Smart Chain (bep721).
curl -X POST https://app.chaingateway.io/api/v2/ethereum/transactions/erc721 \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -H "X-Network: testnet" \ -d '{ "from": "0xSenderAddress", "contractaddress": "0xYourErc721ContractAddress", "to": "0xReceiverAddress", "tokenId": 1, "password": "wallet-password" }'Los campos obligatorios son from, contractaddress, to y tokenId. En lugar de password, puede enviar un privatekey. Los campos opcionales, como gas, gasprice, maxFeePerGas, maxPriorityFeePerGas y nonce, le permiten controlar la comisión y el orden de las transacciones. Una llamada correcta devuelve HTTP 201 con el ID de la transacción en data.txid. Configure la cabecera X-Network: testnet para probar primero la llamada en una red de pruebas. Los parámetros de la solicitud figuran en la referencia de la API.
Para ver paso a paso las comprobaciones de propiedad, la firma y la confirmación, consulte Transferir NFT mediante API.
¿Existen más estándares de token?
Sí. ERC20 cubre los tokens fungibles, y ERC-1155 es un estándar multi-token que puede gestionar tokens fungibles y no fungibles en un único contrato. En otras redes, los equivalentes tienen nombres distintos, por ejemplo TRC-20 en TRON y SPL en Solana.
Cómo escribimos estos artículos
¿Listo para construirlo tú mismo? Obtenga su clave de API — prueba de 7 días, sin tarjeta — o consulte API de Ethereum para la referencia completa de los endpoints.