Saltar al contenido
Cómo verificar Proyectos

Cómo verificar el suministro de un token on-chain

El suministro total, el suministro circulante y el suministro máximo son tres números distintos que constantemente se confunden entre sí. Esta guía explica cómo leer cada uno directamente del contrato de un token y de los propios datos de la cadena, en lugar de confiar en una cifra citada en una publicación.

Cómo verificar el suministro de un token on-chain

“Suministro” suena como un único número. On-chain, normalmente son al menos tres números distintos, y confundirlos es una de las formas más comunes en que se tergiversa la escasez o la dilución de un token, a veces deliberadamente, a veces solo por descuido.

El suministro total, el circulante y el máximo son cosas distintas

  • Suministro total — el número de tokens que existen actualmente, según registra el propio contrato. Para la mayoría de los tokens estándar, esto se puede leer directamente del contrato.
  • Suministro máximo — el límite absoluto que el código de un contrato impone sobre cuántos tokens pueden existir jamás, si hay alguno codificado. Muchos tokens no tienen ningún límite codificado; el “suministro máximo” para esos es una declaración de política, no una garantía del contrato, a menos que el código realmente la haga cumplir.
  • Suministro circulante — el suministro total menos los tokens que están bloqueados, en tesorería, sin adquirir derechos (vesting) o de algún otro modo no libremente negociables. El suministro circulante no es, en la mayoría de los casos, un único valor on-chain; lo calcula alguien (el proyecto, un agregador de datos) restando direcciones específicas y conocidas como bloqueadas del suministro total, y ese cálculo es tan bueno como la lista de direcciones que tiene en cuenta.

La implicación práctica: el suministro total suele ser el único número sólido y directamente legible. El suministro máximo solo es significativo si confirmas que el contrato realmente impone un límite en lugar de simplemente declararlo en la documentación. El suministro circulante siempre depende de la definición de alguien sobre qué direcciones excluir, lo que significa que vale la pena comprobar la metodología, no solo la cifra destacada.

Paso a paso: leer el suministro desde el contrato

  1. Abre la página de la dirección del contrato del token y confirma que el código fuente está verificado (consulta cómo verificar el código fuente de un contrato inteligente) para que la pestaña Read Contract esté decodificada y sea legible.
  2. Llama a totalSupply. La mayoría de los estándares de token expone esto directamente; el número en bruto devuelto hay que dividirlo entre diez elevado al valor decimals del token (también legible en la misma pestaña) para obtener el suministro legible por humanos.
  3. Busca una función que indique que se está aplicando un límite absoluto en el código (a veces visible como una comprobación dentro de una función de acuñación, si el código fuente es legible) en lugar de confiar solo en un límite mencionado en un whitepaper o un sitio web.
  4. Comprueba si existe una función mint y quién puede llamarla. Un contrato con una función de acuñación activa y llamable, controlada por una sola dirección o un equipo pequeño, significa que el suministro total no es fijo, sin importar lo que sugiera cualquier cifra actual de suministro circulante.
  5. Para afirmaciones de suministro circulante, mira la pestaña “Holders” del explorador para ver las direcciones con las mayores tenencias, y comprueba si alguna está etiquetada como un contrato conocido de bloqueo, vesting o tesorería — lo que te permite comprobar razonablemente tú mismo un cálculo de suministro circulante en lugar de aceptar la cifra citada por fe.

Qué no demuestran los datos de suministro on-chain

Leer totalSupply y decimals directamente del contrato te da un número sólido y actual. No te dice los planes de acuñación futuros de un proyecto más allá de lo que el propio código impone, no te dice si las direcciones excluidas de un cálculo de suministro circulante realmente están bloqueadas de una forma que les impida moverse, y no te dice si las cifras de suministro citadas en un sitio de datos de terceros usan la misma metodología que usa el propio proyecto. Cuando una cifra de suministro circulante importa para una decisión, rastréala hasta las direcciones específicas que se están excluyendo y comprueba esas direcciones tú mismo en lugar de aceptar la cifra de un panel como evidentemente correcta.

Quemas, vesting, y por qué el panorama sigue moviéndose

El suministro total no es necesariamente estático aunque no haya acuñación activa. Muchos tokens implementan un mecanismo de “quema” que destruye tokens de forma permanente, normalmente enviándolos a una dirección sin clave privada conocida, lo que reduce el suministro total con el tiempo. Comprobar totalSupply en dos momentos distintos y ver una disminución es coherente con una quema; comprobar las afirmaciones de la documentación sobre un mecanismo de quema frente a si el código del contrato realmente llama a una función de quema en algún lugar es, igual que con la acuñación, la diferencia entre una declaración de política y una mecánica realmente impuesta.

Los cronogramas de vesting complican el seguimiento del suministro circulante en la dirección opuesta: los tokens que ya existen (contados en el suministro total) pero están bloqueados en un contrato de vesting que los libera gradualmente todavía no son circulantes, aunque lo serán más adelante según un calendario. Leer el propio calendario de liberación de un contrato de vesting, cuando el contrato está verificado y el calendario está codificado on-chain en lugar de solo descrito en un documento, te da una visión prospectiva de cómo probablemente cambiará el suministro circulante, lo cual suele ser más útil para un lector cuidadoso que una sola cifra actual de suministro circulante.

No es asesoramiento financiero

Esta guía explica cómo leer cifras de suministro directamente del contrato de un token. Es educación general, no asesoramiento financiero, legal ni de inversión. El suministro y la dilución son solo un factor entre muchos al evaluar cualquier activo, y esta guía no evalúa ningún token concreto.

Por qué el mismo token puede tener cifras de suministro distintas en distintas cadenas

Muchos tokens hoy existen como despliegues separados en varias cadenas, conectados por un mecanismo de puente en lugar de ser un único contrato. En esa situación, leer totalSupply en el despliegue de una cadena solo te dice el suministro en esa cadena concreta — el suministro combinado del token en todas las cadenas en las que está desplegado requiere comprobar cada despliegue por separado y sumarlos, y una afirmación sobre “suministro total” que solo cita la cifra de una cadena para un token genuinamente multicadena está incompleta. Confirmar en cuántas cadenas está realmente desplegado un token, algo que suele divulgarse en la propia documentación del proyecto, es un primer paso necesario antes de poder comprobar correctamente cualquier cifra de suministro entre cadenas.

Un error simple pero común: olvidar los decimales

El entero en bruto devuelto por totalSupply no es la cifra legible por humanos — hay que dividirlo entre diez elevado al valor decimals del token, que también es legible en la misma pestaña Read Contract. Saltarse este paso produce un número equivocado por muchos órdenes de magnitud, y leer mal un valor de contrato en bruto como el suministro real es un error sorprendentemente común incluso entre quienes comprueban la cadena directamente en lugar de confiar en una cifra de segunda mano.

Preguntas frecuentes

¿Por qué distintos sitios web a veces muestran cifras distintas de suministro circulante para el mismo token?

Porque el suministro circulante es una cifra calculada, no un único valor on-chain, y distintos proveedores de datos pueden usar listas distintas de direcciones que tratan como bloqueadas o no circulantes. El suministro total, en cambio, debería coincidir en todas partes, ya que se lee directamente del contrato.

¿”Suministro máximo” siempre significa que el contrato no puede crear más tokens?

Solo si el límite realmente se impone en el código del contrato. Un suministro máximo declarado en materiales de marketing sin una comprobación correspondiente impuesta en la función de acuñación es una afirmación, no una garantía.

¿Cómo compruebo si la función de acuñación de un token sigue activa?

Lee el código fuente del contrato verificado buscando una función que aumente el suministro total, y comprueba qué control de acceso (una comprobación de propietario, una comprobación de rol) restringe quién puede llamarla. Si ese acceso realmente se ha eliminado on-chain (consulta cómo comprobar si la propiedad de un contrato está renunciada), la acuñación por esa vía está cerrada; si no, sigue siendo posible.

¿Puedo comprobar el suministro de tokens en cadenas no EVM de la misma forma?

La idea subyacente es la misma — el suministro es una propiedad que registra el propio libro mayor de la cadena — pero la herramienta concreta difiere. El suministro de tokens de Solana, por ejemplo, se lee a través de los propios exploradores de Solana y las convenciones de su programa de tokens, en lugar de una pestaña Read Contract de estilo EVM.

Sobre la firma

Equipo editorial de The Crypto Online

Una firma colectiva para una redacción de verificación de afirmaciones. Cada pieza la edita una persona y se contrasta con un registro primario; la ayuda de IA se declara en nuestras pautas editoriales.

Todo el trabajo del equipo → Metodología Correcciones

No es asesoramiento financiero. Edición humana; la redacción asistida por IA se indica en nuestras pautas editoriales. ¿Has visto un error? Mira cómo funcionan las correcciones.