Suministro y decimales

Máster de origen EN · P08-L02 · 45 minutos estimados · needs_review

Un error de decimales puede convertir nueve mil tokens en nueve tokens sin cambiar un solo saldo subyacente. Una definición mal etiquetada de suministro puede hacer que dos cálculos correctos parezcan contradictorios. Antes de valorar un activo o describir su distribución, establezca unidades, contexto y exclusiones.

Esta lección enseña la conversión exacta de bruto a mostrado y una conciliación de suministro. Parte de la identidad verificada en lugar de asumir que todos los tokens usan dieciocho decimales.

Mantenga separados enteros y presentación

Sea R una cantidad entera bruta y d el número verificado de decimales. Su cantidad ordinaria mostrada es R dividido por 10^d. La unidad bruta es la unidad contable indivisible en este modelo; los decimales definen la precisión de presentación, no el número de propietarios ni un precio de mercado. El estado del mint de Solana incluye suministro y decimales [S08-TOKENS]. El método decimals de ERC-20 es opcional en el estándar [S08-ERC20]; los metadatos no disponibles no deben sustituirse por un valor predeterminado adivinado.

Use cadenas de enteros o aritmética decimal exacta. Una hoja de cálculo o un número de coma flotante de JavaScript puede redondear un valor bruto grande antes de dividirlo. Guarde el entero original, el número de decimales, el contexto y el valor mostrado como campos distintos. Si una herramienta informa de un valor mostrado redondeado, calcule desde el dato bruto en lugar de tratar lo mostrado como exacto.

Un cero informado y un resultado ausente son diferentes. Cero es una medición válida bajo una fuente/contexto declarado; null o un tiempo de espera agotado describe evidencia ausente. Un número de decimales ausente impide una conversión fiable a unidades ordinarias aunque los saldos brutos sigan disponibles. Registre la cantidad bruta sin afirmar una cantidad de tokens.

Concilie medidas antes de compararlas

El suministro total describe la medida contable del protocolo en un contexto especificado. El suministro circulante requiere una política definida de inclusión. El inventario de tesorería, la adquisición gradual y la custodia de puentes pueden recibir tratamientos diferentes de distintos editores. Una etiqueta sin política no puede resolver una discrepancia.

Solana getTokenSupply devuelve cantidad bruta y decimales con contexto de respuesta [S08-SUPPLY]. No es una medida circulante definida independientemente. No reste de los totales brutos el suministro ya ajustado de un editor sin inspeccionar lo que excluyó.

Para un conjunto de datos cerrado de contabilidad estándar, los saldos deberían conciliar con el total suministrado. Las investigaciones reales deben inspeccionar si la exportación es exhaustiva, usa contextos concordantes y decodifica las extensiones correctamente. Algunos mecanismos de tokens complican una suma simple de saldos; declare esa limitación en lugar de forzar todos los activos a este modelo.

Las exclusiones no destruyen tokens. Retirar unidades de tesorería de un denominador analítico produce una estadística ajustada, no un evento del registro de cadena que cambia el suministro. Asimismo, una transferencia a una dirección descrita como dirección de quema no es automáticamente una reducción del totalSupply del protocolo. El mecanismo real de quema y el cambio contable necesitan evidencia.

Siga cambios sin cambiar la unidad

Una emisión aumenta el suministro contable total en el conjunto de datos. Una quema del protocolo lo reduce. Las transferencias ordinarias entre cuentas incluidas redistribuyen la propiedad sin cambiar el total. Si la secuencia suministrada está completa, el suministro nuevo equivale al anterior más unidades emitidas menos unidades quemadas.

Vincule contexto a cada evento y cantidad. Si una instantánea posterior difiere de su suma de eventos, compruebe cobertura incompleta, un mint inconsistente o precisión incorrecta antes de declarar manipulación. Una diferencia es un fallo de conciliación que necesita investigación; no es un veredicto sobre intención.

Los decimales deben verificarse para el objeto y contexto exactos. Dos activos con el mismo símbolo pueden tener distinta precisión. Una configuración incorrecta de una fuente puede producir una discrepancia de factor mil cuando d difiere en tres. Nunca «repare» el saldo bruto para que concuerde con un sitio web.

Use un puente de comparación

Cuando dos informes discrepen, disponga en columnas cantidad bruta, decimales, conversión de unidades, contexto de instantánea y política de exclusión. Esto hace visibles preguntas distintas. Un informe puede ser correcto para el suministro total mientras otro usa correctamente un denominador ajustado. Deben nombrarse por separado, no promediarse.

Si dos fuentes afirman la misma definición en el mismo contexto y aún discrepan, conserve ambos registros y una discrepancia sin resolver. No seleccione el número mayor porque parezca más seguro ni el menor porque mejore un porcentaje de concentración. Un hallazgo acotado declara la discordancia y la siguiente comprobación.

Los porcentajes cancelan un factor decimal común solo cuando numerador y denominador se refieren a la misma precisión y alcance del token. Comparar un numerador bruto con un denominador mostrado produce un resultado sin sentido. Puede ser numéricamente pulcro y aun así estar equivocado.

Comunique cantidades reproducibles

Escriba unidades en cada fila. «2,500» por sí solo podría significar unidades brutas, tokens o dólares. Esta lección usa unidades ficticias de tokens y no suministra precio de mercado ni valoración en dólares. Una conciliación correcta de suministro no dice nada sobre liquidez ejecutable, apreciación del precio ni legitimidad del emisor.

Conserve la precisión completa en la clave de respuestas y redondee solo para mostrar. Explique la política de redondeo cuando una fracción se repita. En este conjunto de datos las conversiones terminan exactamente, por lo que no es necesario ocultar ningún residuo redondeado.

• Cantidad bruta: unidades contables enteras.
• Decimales: precisión de presentación en base diez.
• Suministro total: medida contable del protocolo en un contexto.
• Suministro ajustado: medida con exclusiones declaradas por el analista.
• Conciliación: comparación de sumas y cambios compatibles.
• Contexto de instantánea: límite de estado para una observación.

ILLUSTRATIVE — FIX-P08-02. MINT-SUPPLY en SIM-SOL-A, modelo básico de contabilidad estándar, d=6 en S0 sintético. Se suministran saldos exhaustivos; todos los identificadores son etiquetas inválidas.

El total bruto T0 es 9,000,000,000. La fuente F1 establece d=9 por error y muestra 9. La política E excluye solo B3/B4. Una secuencia sintética completa de eventos hasta S1 quema 500,000,000 unidades brutas y emite 750,000,000; no hay otros cambios de suministro. No se suministra la asignación de cuentas S1.

OBSERVED en el conjunto de datos: Se suministran precisión, total y saldos S0. F1 usa la precisión equivocada.

INFERRED: El total S0 es 9,000 tokens; la cantidad ajustada según política E es 4,000. Los eventos completos implican un total S1 de 9,250 tokens.

UNKNOWN: Cualquier medida circulante real, asignación S1, precio o liquidez.

INSUFFICIENT EVIDENCE: Los 4,000 ajustados no son una quema del protocolo ni suministro circulante universal. La discordancia decimal no prueba intención maliciosa.

Asumir dieciocho decimales; mezclar unidades brutas/mostradas; contar exclusiones como quemas; importar enteros redondeados; comparar contextos no concordantes; y llamar «el» suministro circulante a una medida ajustada por política.

Convierta T0 y los cuatro saldos. Concilie S0. Calcule el denominador de la política E, la participación del propietario A en el total y en la cantidad ajustada, y el total S1. Explique el error de factor de F1 y si puede calcularse la concentración de tenedores S1.

• Verifique el activo exacto y el número de decimales.
• Conserve enteros brutos.
• Etiquete unidades y redondeo.
• Concilie contextos concordantes.
• Declare toda exclusión y su política.
• Mantenga desconocidos los saldos posteriores ausentes.

Precisión y definición preceden a la comparación del suministro. Una exclusión por política cambia el denominador analítico; un evento del registro de cadena cambia el suministro contable.

Las unidades brutas no son tokens mostrados. Distintas políticas de suministro responden preguntas distintas. Un total correcto no proporciona distribución actual ni liquidez.

Muestre la escala de conversión bruto→mostrado d=6, la conciliación de saldos S0 y barras separadas de total 9,000 y política E4,000. Marque F1 d=9 como discordancia de precisión; muestre el total S1 9,250 sin inventar un gráfico de tenedores.

Unidades y políticas de suministro ilustrativas; sin precio ni estimación circulante real.

Use SVG/HTML deterministas o gráficos con alternativas textuales, azul marino oscuro/negro y cian, azul eléctrico y violeta moderados. Etiquete cada cantidad e incertidumbre. A 390px apile los paneles; la verificación a 768px/escritorio y RTL en árabe sigue siendo trabajo futuro de los recursos. Mantenga los identificadores LTR y los ejes/direcciones de aristas factuales sin cambios. Use solo la marca oficial BlockAssay proporcionada si se añade identidad de marca. Ambos registros son especificaciones, no recursos entregados.

Use RADAR para el propósito educativo acotado de la lección solo si se verifican la compatibilidad de la red, la identidad exacta, los campos y la procedencia. Este contenido no afirma ningún endpoint de runtime ni capacidad de proveedor. Use el conjunto de datos sin conexión incorporado sin acceso de pago. Los datos ausentes siguen siendo desconocidos; no se requiere conexión de cartera, firma de transacción, lanzamiento de tokens ni operación en vivo. El progreso, los pagos y las referencias de Academy nunca cambian la evidencia de Radar. Un Pasaporte de Diagnóstico conserva observaciones y límites, no una predicción de precios ni un certificado de seguridad.

• Activos de Solana — Identidad de mint/cuenta/programa y decimales; distinguir los campos de propiedad de cuentas. Revisado 2026-09-30.
• Solana getTokenSupply — Suministro bruto, decimales y contexto de respuesta RPC; no una definición de suministro circulante. Revisado 2026-09-30.
• Estándar de tokens ERC-20 — Interfaz estándar; name, symbol y decimals opcionales; no certificación de privilegios ni identidad. Revisado 2026-09-30.

La documentación respalda mecanismos, no valores de conjuntos ficticios. Todos los ejemplos y registros de ejercicios son material original ILLUSTRATIVE, congelado en este archivo. S0/S1 son etiquetas de contexto sintéticas; observedAt es null porque no se recopiló ninguna medición de un registro de cadena en vivo ni histórico. Vuelva a revisar la documentación y el comportamiento efectivamente desplegado antes de cualquier publicación o integración.

P08-L03 después de revisar el ejercicio resuelto y el cuestionario.