Ir al contenido
Una perspectiva global de los activos digitalesPERSPECTIVA GLOBAL · CONTEXTO LOCAL
ChainView BTC866CHAIN VIEW
Aprender

Decimales de tokens: del entero a la cantidad visible

Los saldos suelen almacenarse como enteros y la interfaz aplica una escala decimal. El símbolo del token no es un identificador único: dos contratos pueden compartir nombre y mostrar unidades diferentes.

Leer enEspañol (México)简体中文繁體中文English한국어РусскийالعربيةTiếng Việtไทย
Decimales de tokens: del entero a la cantidad visible

Ilustración original del tema: Diagrama original de ChainView BTC866 · ChainView BTC866 Editorial · CC BY 4.0

La escala que aplica la pantalla

Los saldos suelen almacenarse como enteros y la interfaz aplica una escala decimal. El símbolo del token no es un identificador único: dos contratos pueden compartir nombre y mostrar unidades diferentes.

El símbolo no identifica el contrato

En ERC-20 el metadato decimals es opcional y las implementaciones pueden variar. Verifique contrato y red, además de la documentación, antes de interpretar un valor crudo o comparar dos exportaciones.

Mantener enteros sin redondeo binario

Conserve entero original, escala declarada y cantidad presentada. Para registros financieros use aritmética decimal o entera adecuada y evite redondeos de coma flotante que alteren unidades pequeñas.

Un cálculo con seis decimales

Un valor crudo de 1234500 con seis decimales representa 1.2345 tokens. Con otra escala el mismo entero significaría otra cantidad; cambiar la pantalla no cambia automáticamente el dato del contrato.

Revisar antes de repetir un envío

Compare eventos de transferencia bajo la misma convención. Un saldo visual extraño puede deberse a metadatos o caché, no a una emisión nueva ni a una pérdida; investigue antes de volver a transferir.

Pruebas que conservan el valor crudo

Para probar una integración use cantidades pequeñas y conserve el valor crudo de la llamada y del evento. El redondeo de pantalla puede ocultar fracciones que siguen existiendo y afecta conciliaciones cuando se copian importes manualmente. No atribuya a todos los contratos de un símbolo el metadato de uno solo. Si la consulta de decimals falla, marque la escala como pendiente y consulte la implementación; inventar dieciocho por costumbre puede producir un error de muchos órdenes de magnitud en registros y autorizaciones.

Fuentes

  1. ERC-20 (se abre en una pestaña nueva)
  2. Ethereum token standards (se abre en una pestaña nueva)