Un proyecto se muda a un nuevo contrato, publica un ratio y abre una ventana de canje. Tu cartera sigue mostrando el saldo antiguo, y la cifra que acabarás teniendo no está escrita en ninguna parte. Convertir un ratio anunciado en un saldo acreditado exige tres comprobaciones distintas, y la que sale mal rara vez es la multiplicación que esperabas.
Qué establece realmente un ratio de conversión
Un ratio de conversión es un tipo de cambio fijo entre dos registros: cuántas unidades del token nuevo compra cada unidad del token antiguo. El proyecto lo fija, el contrato de canje lo impone y no se mueve con el mercado. Sea cual sea el precio al que cambien de manos los dos tokens el día en que canjees, el ratio que recibes es el que quedó escrito.
Lo primero que hay que resolver es la dirección, porque un ratio anunciado como uno a cuatro se lee de dos maneras. Puede significar una unidad nueva por cada cuatro antiguas, o cuatro unidades nuevas por cada una antigua, y esas dos lecturas se diferencian en un factor de dieciséis. Ancla la lectura a algo que puedas comprobar por tu cuenta: compara el suministro total nuevo con el antiguo. Si el suministro nuevo es el menor de los dos, cada unidad antigua tiene que convertirse en menos de una unidad nueva, y cualquier lectura que diga lo contrario está invertida.
Lo segundo es a qué saldo se aplica el ratio. Una migración define un conjunto elegible: saldos mantenidos en el momento de un snapshot, saldos que siguen en el contrato antiguo, o saldos presentados al contrato de canje antes de que deje de pagar. El ratio es idéntico para todos los que están dentro de ese conjunto, así que todo lo que sigue da por supuesto que tu saldo lo está. Si la ventana de canje sigue abierta es una pregunta distinta de qué pagaría el ratio si lo estuviera.
De dónde sale la cifra
El ratio es una decisión, y la decisión tiene un armazón aritmético. Un proyecto fija primero el tamaño del registro nuevo y luego lo divide entre las unidades antiguas que la migración tiene que absorber. El cociente es el ratio, y por eso el ratio y las dos cifras de suministro cuadran: multiplica el suministro antiguo elegible por el ratio y recuperas el suministro nuevo reservado para el canje.
Toma un proyecto que fija un suministro nuevo de 400.000.000 unidades y tiene 1.000.000.000 unidades antiguas elegibles para migrar. El ratio es la primera cifra dividida entre la segunda, así que cada unidad antigua se convierte en el 40 % de una unidad nueva. Leído al revés, hacen falta cinco unidades antiguas para producir dos nuevas.
Esa derivación te da una comprobación que puedes aplicar a cualquier anuncio. Si un proyecto publica las dos cifras de suministro y un ratio, las tres tienen que concordar. Cuando no lo hacen, o una de las tres está mal o el conjunto elegible es más estrecho de lo que suponías, y averiguar cuál de las dos importa más que recalcular tu propio saldo a partir de una cifra que no cuadra.
Cómo calcular tu propio derecho
Resueltas la dirección y el ratio, tu cifra es una sola multiplicación: saldo antiguo por el ratio. Un saldo de 12.500 unidades antiguas con un ratio del 40 % se convierte en 5.000 unidades nuevas. Nada de ese paso depende del precio, y nada depende del momento de la ventana en que canjees.
Haz esa multiplicación en las unidades que muestra tu cartera, porque esa es la forma que puedes contrastar con el anuncio. El contrato hace la misma multiplicación en otro sistema de unidades, y las dos coinciden solo cuando los decimales encajan. Esa es la comprobación siguiente, y es la que produce respuestas desviadas en potencias enteras de diez.
| Qué necesitas | Dónde leerlo | Qué falla sin ello |
|---|---|---|
| El ratio y en qué dirección va | El anuncio, contrastado con las dos cifras de suministro | El resultado sale invertido |
| Los decimales de ambos tokens | La función decimals de cada contrato de token | El resultado se desvía en una potencia de diez |
| La regla de redondeo | La aritmética entera dentro de la función de canje | Queda un resto en el contrato antiguo |
| Qué saldo es elegible | El anuncio, y lo que el contrato acepte | Cuentas unidades que el canje no admitirá |
Los decimales son una segunda conversión, y es la fácil de saltarse
Los contratos de token no guardan importes fraccionarios. Guardan enteros, y un valor aparte registra dónde va la coma decimal. En el estándar ERC-20, la función opcional decimals devuelve el número de decimales que usa el token; la especificación lo ilustra con un token cuyo valor de ocho significa que el importe almacenado se divide entre cien millones para llegar a su representación de usuario.
Precisamente porque esa función es opcional, el estándar señala que las interfaces y otros contratos no deben esperar que el valor esté presente. Cuando falta, el número de decimales es una convención que tienes que establecer por otra vía, y rellenar el hueco con un valor por defecto que das por supuesto es la manera de leer un saldo con órdenes de magnitud de diferencia.
Una migración entre dos tokens con decimales distintos añade ese escalado encima del ratio. Si el token antiguo usa dieciocho decimales y el nuevo seis, la misma cantidad mostrada se guarda como enteros que se diferencian en un factor de 1.000.000.000.000. El contrato de canje lleva ese escalado por dentro, así que una cartera que tenga los dos valores de decimals te muestra la cifra correcta. Los enteros en bruto copiados de un explorador de bloques son otra cosa: un valor leído directamente de una llamada al contrato está en unidades base, y poner una cifra en unidades base de un token junto a una cifra en unidades base del otro compara dos escalas distintas.
Lee el ratio del contrato en vez del anuncio
Un anuncio es prosa, y quien paga es el contrato de canje. Abre su código fuente verificado y localiza las dos constantes por las que la función de canje multiplica y divide. Esas constantes son el ratio en su forma impuesta. Si discrepan del anuncio, las constantes son por donde va a pasar tu saldo.
Lee de paso el valor de decimals en los dos contratos de token. Dos constantes y dos valores de decimals son todo el cálculo, y las cuatro son lecturas públicas que no cuestan nada.
Luego confirma el resultado antes de comprometer el saldo. Un contrato de canje necesita una aprobación de token para poder mover tus tokens antiguos, y una aprobación puede concederse por un importe pequeño en lugar de por el saldo entero. Canjear un importe pequeño, contrastar lo que llega con tu propia aritmética y solo entonces aprobar el resto convierte el cálculo en algo que has observado y no en algo que has deducido.
El redondeo y las unidades que se quedan atrás
El contrato trabaja con enteros, y la división entera trunca. Cuando tu importe antiguo no es múltiplo exacto del denominador del ratio, la división descarta el resto en vez de redondearlo hacia arriba. Con dieciocho decimales, el trozo descartado es una fracción demasiado pequeña para tener representación en pantalla, y aun así es real.
El resto se hace visible cuando el pago está cuantizado de forma más gruesa. Un saldo de 12.502 unidades antiguas con el mismo ratio del 40 % da 5.000 unidades nuevas y una fracción; un contrato que acredita unidades enteras acredita 5.000 y la fracción se queda donde estaba. Resuelve de antemano si lo que sobra es un resto de redondeo que puedes ignorar o un saldo antiguo que seguirás teniendo después de que se cierre la ventana.
Lo que el ratio no te dice sobre el valor
Un ratio de conversión fija cantidades y no afirma nada sobre el valor. Cambia el número de unidades que tienes, y eso es todo lo que el ratio garantiza. Leer un ratio por debajo de uno como una pérdida, o uno por encima de uno como una ganancia, toma una conversión aritmética por un movimiento de precio.
Lo que sí cambia una migración es qué registro pone precio el mercado. Una vez que existen los dos tokens, cotizan por separado, y sus precios salen de la demanda que encuentren y no del ratio que enlaza sus suministros. El token ERC-20 que recibes es un contrato nuevo con su propio mercado, y el ratio es lo único fijo que se lleva consigo.
| Qué fija el ratio | Qué deja al mercado |
|---|---|
| En cuántas unidades nuevas se convierte tu saldo | Cuánto vale una unidad nueva |
| La relación entre las dos cifras de suministro | Si el token nuevo cotiza por encima o por debajo del antiguo |
| La aritmética que ejecuta el contrato de canje | El valor de tu posición después del canje |
En resumen
Un ratio de conversión es una multiplicación envuelta en tres comprobaciones. Resuelve en qué dirección va el ratio contrastándolo con las dos cifras de suministro, lee los decimales de ambos tokens para que el escalado no desplace tu respuesta una potencia de diez, y busca la regla de redondeo para saber qué se queda atrás.
Luego verifica en vez de confiar: las constantes dentro del contrato de canje son el ratio que de verdad se aplicará, y un canje de prueba pequeño convierte tu aritmética en una observación. Para seguir aprendiendo los fundamentos, sigue más contenido de Bitbase Academy.
Lecturas relacionadas
Otros artículos de Bitbase sobre este tema:
- Cómo revocar una delegación de gobernanza
- Por qué una migración de token pide una aprobación en la billetera
- Migración de tokens completada pero los nuevos tokens no aparecen
- Señales de alerta de operaciones de lavado con NFT
- El ADX y cómo medir la fuerza de la tendencia
Aviso legal: Este artículo es contenido educativo de Bitbase Academy y se ofrece solo con fines informativos. No constituye asesoramiento de inversión, negociación, fiscal ni financiero. Los criptoactivos son volátiles; evalúa tu propio riesgo. Redactado en septiembre de 2026; consulta la información oficial más reciente.
Fuentes
[1] Ethereum Improvement Proposals, ERC-20: Token Standard (EIP-20, Final), método decimals eips.ethereum.org
[2] Documentación para desarrolladores de ethereum.org, ERC-20 Token Standard ethereum.org
