ERC20 Address: Formato, balanceOf y Cómo Crear Una vía API
Cómo funcionan por dentro una dirección ERC-20 y balanceOf, cómo se traslada a Polygon y Arbitrum, y cómo crear y vigilar direcciones ERC-20 vía REST en lugar de JSON-RPC en bruto.
Una ERC20 address es el mismo formato de dirección con prefijo 0x y 42 caracteres que Ethereum usa para cada cuenta — se convierte en una "ERC-20 address" según el contexto siempre que esa cuenta contiene tokens construidos con el estándar ERC-20. Como el formato se comparte en cada EVM chain, la misma erc20 address que usas en Ethereum funciona sin cambios en Polygon y Arbitrum, aunque los tokens y saldos de esa dirección son específicos de cada chain. Esta página cubre el formato, la llamada balanceOf que lee el saldo de un token, y cómo crear direcciones mediante una API.
El estándar ERC-20, en breve
ERC-20 es el estándar de tokens fungibles de Ethereum: un pequeño conjunto de funciones — transfer, approve, balanceOf y unas pocas más — que implementa cualquier contrato de token compatible, razón por la cual wallets y exchanges pueden admitir nuevos tokens ERC-20 sin trabajo de integración específico por token. La mecánica completa está en el artículo sobre el estándar ERC20 token del blog; esta página se centra en el lado de la dirección: qué es una erc20 address y cómo trabajar con ella de forma programática.
balanceOf: cómo se lee realmente un saldo ERC-20
Un saldo de token ERC-20 no se almacena en la dirección misma — se almacena dentro del smart contract del token, en un mapping indexado por dirección. balanceOf(address) es la función estándar de solo lectura que expone cada contrato ERC-20 para consultar ese valor. Llamarla directamente significa codificar una llamada JSON-RPC en bruto eth_call contra el contrato del token y decodificar el hex devuelto. La API de Chaingateway hace esa decodificación por ti: los endpoints de saldo e historial de transacciones devuelven números planos, así que "erc20 balanceof" deja de ser un problema de RPC en bruto y se convierte en una respuesta de API normal.
La misma dirección en Polygon y Arbitrum
Polygon y Arbitrum son ambas EVM-compatibles, así que una dirección de Polygon y una de Arbitrum usan el mismo formato 0x que una dirección de Ethereum, y de hecho pueden ser la misma dirección si se deriva de la misma key. Esa es también la razón por la que los tokens de Polygon son tokens ERC-20 en todo sentido funcional — es Polygon una red de token ERC-20, no un estándar de dirección distinto — POL y los tokens nativos de Polygon implementan la misma interfaz que los de Ethereum. Los contratos de token difieren por chain incluso cuando el formato de dirección no lo hace; un token desplegado en Ethereum necesita un despliegue independiente (o un bridge) para existir en Polygon.
ERC-721 y ERC-721A: un estándar distinto, el mismo formato de dirección
ERC-721 es el estándar de tokens no fungibles de Ethereum — cada ID de token es único en lugar de intercambiable, a diferencia de los saldos fungibles de ERC-20. ERC-721A es una implementación ampliamente usada y optimizada en gas de la misma interfaz ERC-721, popular en colecciones NFT acuñadas por lotes; cambia cómo el contrato almacena datos internamente, no el aspecto de la dirección de un titular. Ambos usan la misma dirección 0x de estilo erc20 para la propiedad. El artículo sobre el estándar ERC721 token cubre en profundidad el lado NFT.
Crea y lee direcciones ERC-20 vía REST
| Endpoint | Qué hace |
|---|---|
POST /api/v2/ethereum/addresses | Genera una nueva dirección de Ethereum |
POST /api/v2/ethereum/addresses/import | Importa una private key para que la API pueda firmar por esa dirección |
POST /api/v2/ethereum/webhooks | Registra un webhook para depósitos ERC-20 a la dirección |
POST /api/v2/ethereum/transactions/erc20 | Envía un token ERC-20 desde la dirección |
El mismo formato de solicitud se aplica con /polygon/ o /arbitrum/ en lugar de /ethereum/ en la ruta, ya que las tres chains comparten el formato de dirección y la interfaz ERC-20.
¿Necesitas saldos ERC-20 sin decodificar a mano llamadas balanceOf? Crea una cuenta gratuita y consulta una dirección de testnet vía REST — prueba de 7 días, sin tarjeta, sin KYC.
Preguntas frecuentes: direcciones ERC-20
¿Listo para construir en Ethereum, Polygon o Arbitrum?
Crea una cuenta y consulta un saldo ERC-20 de testnet hoy mismo — prueba de 7 días, sin tarjeta, sin KYC. Referencia completa en la documentación de la Ethereum API, o cubre las siete chains con la blockchain API multichain.