Funciones NFT y estimateGas: versión de 2021
Qué añadió la versión de noviembre de 2021 (getNFTOwner, getNFTURI, sendNFT, estimateGas) y cómo funcionan hoy los envíos de NFT y el gas en la API v2.
Revisado por Maurice Sobiera
Las funciones NFT de Chaingateway leen el propietario y la URI de metadatos de un token ERC-721, BEP-721 o TRC-721 y lo envían a otra dirección. La versión de noviembre de 2021 añadió getNFTOwner, getNFTURI y sendNFT para Ethereum, Tron y BSC. También añadió estimateGas para Ethereum y BSC, que devuelve una estimación de gas sin enviar la transacción.
¿Qué es un NFT?
Un token no fungible (NFT) es un token en el que cada unidad tiene su propio ID de token. Se estandarizó por primera vez en Ethereum como ERC-721. Los tokens ERC-20 son intercambiables: cualquier unidad es idéntica a otra. Un token ERC-721 es distinto, porque cada ID de token puede tener su propio propietario y sus propios metadatos.
El estándar está definido en EIP-721. Especifica ownerOf(tokenId) para devolver el propietario y safeTransferFrom para mover un token. La extensión opcional de metadatos añade tokenURI(tokenId), que devuelve un enlace a los metadatos del token. BEP-721 en BNB Smart Chain y TRC-721 en Tron siguen el mismo modelo.
EIP-721 estandariza una función de transferencia segura, safeTransferFrom, y una insegura, transferFrom. Con transferFrom, quien llama debe confirmar que la dirección receptora puede manejar NFT. El estándar advierte de que, de lo contrario, el token puede perderse de forma permanente. Compruebe el receptor antes de enviar un token a la dirección de un contrato. Para una introducción más larga, lea el estándar de tokens ERC721.
¿Qué funciones NFT añadió la versión de 2021?
La versión añadió tres funciones NFT. Las tres estaban disponibles para las API de Ethereum, Tron y Binance Smart Chain.
| Función | Qué hace | Parámetros |
|---|---|---|
| getNFTOwner | Devuelve la dirección del propietario de un NFT | ID del token, dirección del contrato del token |
| getNFTURI | Devuelve la URI de un NFT | Los mismos que getNFTOwner |
| sendNFT | Envía un NFT a otra dirección | Dirección del remitente, dirección de destino, dirección del contrato, ID del token |
Estos nombres describen las funciones tal como se anunciaron en 2021. La documentación de entonces era la referencia para su uso exacto.
¿Puede Chaingateway acuñar NFT?
Esta versión no incluía ninguna función de acuñación específica. Aun así, se podía acuñar codificando usted mismo la llamada al contrato y enviándola como una transacción normal con los datos codificados.
Esto es coherente con el estándar, porque EIP-721 no define la acuñación. La especificación dice que la creación y la destrucción de NFT no están incluidas y que un contrato puede implementarlas por otros medios. Por eso, la forma de acuñar difiere de un contrato a otro. En 2021 el equipo explicó que le faltaba un entorno de pruebas para una función de acuñación y pidió a los propietarios de contratos ERC-721, BEP-721 o TRC-721 que ayudaran a probar una.
¿Qué hace estimateGas?
estimateGas devuelve la cantidad de gas que se espera que necesite una transacción, antes de enviarla. Para Ethereum y BSC, toma los mismos parámetros que una transacción normal, salvo la contraseña. Se añadió porque muchos usuarios pedían una forma más sencilla de calcular las comisiones de gas.
El mecanismo subyacente es el método eth_estimateGas de la interfaz JSON-RPC de Ethereum. Según la documentación para desarrolladores de Ethereum, genera una estimación sin añadir la transacción a la blockchain. La misma página advierte de que la estimación puede ser bastante superior al gas que la transacción usa realmente. Trate el resultado como un límite superior para su gas limit, no como el coste final. Una transferencia simple de ether, por ejemplo, usa 21000 de gas, que la misma página muestra como 0x5208.
¿Qué puedo usar hoy?
Los nombres de función anteriores proceden de la generación de API de 2021. La especificación OpenAPI pública actual (versión 2.1.0) está organizada de otra manera, así que esta sección enumera lo que contiene a fecha de 5 de noviembre de 2026.
| Tarea | Endpoint en la especificación v2 |
|---|---|
| Enviar un token ERC-721 en Ethereum | POST /api/v2/ethereum/transactions/erc721 |
| Enviar un token BEP-721 en BSC | POST /api/v2/bsc/transactions/bep721 |
| Enviar un token TRC-721 en Tron | POST /api/v2/tron/transactions/trc721 |
| Enviar un token ERC-721 en Polygon o Arbitrum | POST /api/v2/polygon/transactions/erc721, POST /api/v2/arbitrum/transactions/erc721 |
| Leer el precio actual del gas | GET /api/v2/ethereum/gasprice, y la misma ruta bajo bsc, polygon y arbitrum |
La especificación no incluye endpoints separados para getNFTOwner, getNFTURI ni estimateGas. Para leer el propietario o la URI, llame a ownerOf o tokenURI en el contrato del token a través de cualquier endpoint JSON-RPC. Para una estimación de gas, use eth_estimateGas del mismo modo. El artículo sobre cómo estimar las comisiones de gas explica el cálculo.
Una solicitud de envío en Ethereum necesita from, contractaddress, to y tokenId. El campo password es obligatorio salvo que pase un privatekey. Los campos de gas, como gas, gasprice o maxFeePerGas, son opcionales.
curl -X POST https://app.chaingateway.io/api/v2/ethereum/transactions/erc721 \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "from": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "contractaddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "to": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "tokenId": 1, "password": "your-wallet-password" }'Una llamada correcta devuelve el estado 201 con el hash de la transacción en data.txid. Una contraseña de wallet incorrecta devuelve 401. Una wallet sin saldo suficiente para pagar el gas devuelve 422, por ejemplo con el mensaje «insufficient funds for gas * price + value». Las direcciones anteriores son los valores de ejemplo de la especificación. Para un recorrido completo, consulte cómo transferir NFT por API.
¿Quiere comentar las nuevas funciones?
Sus comentarios son bienvenidos en el grupo de Telegram de Chaingateway.
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 Blockchain para la referencia completa de los endpoints.