Participaciones ERC-4626 y activos: qué significa el saldo

El saldo de una bóveda ERC-4626 es una cantidad de participaciones, no automáticamente la misma cantidad de tokens subyacentes. Identifica el activo de la bóveda y distingue la conversión general, la previsión de reembolso y el límite de reembolso del propietario. Estas cifras responden a preguntas distintas sobre una posición.

Si una cartera muestra 100 participaciones y la interfaz del protocolo muestra 120 tokens subyacentes, no supongas de entrada que un saldo es incorrecto. Comprueba primero qué mide cada cifra. Esta guía permite conciliar una tenencia existente mediante lecturas, sin recomendar depositar en una bóveda ni reembolsar las participaciones.

Identifica el token de participación y su activo subyacente

El estándar ERC-4626 define las participaciones como tokens ERC-20. balanceOf(account) de la bóveda cuenta esas participaciones; asset() identifica el contrato del token subyacente. Anota ambas direcciones de contrato junto a la red y la cuenta que compruebas.

Un símbolo conocido no basta. Confirma el despliegue exacto de la bóveda mediante la documentación oficial del protocolo o una transacción conocida, accediendo por una ruta fiable. Después compara la dirección del activo subyacente, y no solo su nombre, con el token previsto. Un contrato copiado puede ofrecer nombres de métodos conocidos sin ser la bóveda que buscabas.

Comprueba las unidades de ambos lados. Una cantidad bruta de participaciones utiliza los decimales del token de participación; una salida bruta de activos utiliza los del token subyacente. No tienen por qué coincidir: la guía de bóvedas de OpenZeppelin describe implementaciones con precisión adicional para las participaciones. Nuestra guía de decimales de tokens explica cómo reconocer un entero que aún requiere formato. No vuelvas a escalar una cantidad ya formateada.

Elige la cifra que responde a tu pregunta

Utiliza las lecturas documentadas del contrato verificado en lugar de multiplicar por una tasa copiada de otra bóveda. La referencia API de OpenZeppelin distingue métodos de conversión, previsión y límites.

Lectura	Unidad devuelta	Pregunta que responde
balanceOf(account)	Participaciones	¿Cuántas participaciones tiene esta cuenta?
convertToAssets(shares)	Activos subyacentes	¿Cuál es el equivalente general en activos?
previewRedeem(shares)	Activos subyacentes	¿Cuál es la estimación de reembolso de estas participaciones?
maxRedeem(owner)	Participaciones	¿Cuántas participaciones puede reembolsar ahora este propietario?

convertToAssets describe una conversión ideal que excluye comisiones y el deslizamiento del intercambio real. No es una cotización personalizada de retirada. previewRedeem incluye comisiones de retirada y refleja las condiciones actuales, pero ignora deliberadamente los límites de reembolso. Para conocerlos, consulta maxRedeem del propietario. Las definiciones de métodos del estándar explicitan estas diferencias.

Una previsión positiva es, por tanto, compatible con un límite menor o incluso nulo. Una lectura tampoco reserva fondos: el estado puede cambiar antes de una transacción posterior. Sigue las condiciones de retirada documentadas de esa bóveda, incluido cualquier trámite de solicitud obligatorio. Una bóveda con una extensión asíncrona u otra interfaz requiere instrucciones propias.

Cuenta una sola tenencia en la comparación

Considera una instantánea hipotética con todas las cifras ya expresadas en unidades legibles. Una cuenta tiene 100 participaciones. Para esa cantidad, la bóveda devuelve 120 tokens subyacentes mediante convertToAssets y 119 tokens subyacentes mediante previewRedeem. Por separado, maxRedeem de la cuenta es de 40 participaciones.

Los 120 tokens son un equivalente general. Los 119 tokens son la previsión de las 100 participaciones, no una prueba de que las 100 puedan reembolsarse ahora. El límite de 40 participaciones se mide en participaciones y no debe compararse como si fueran 40 tokens subyacentes. Para examinar la cantidad de participaciones permitida, obtén su propia previsión en lugar de suponer que la del saldo completo se aplica sin cambios.

Son cifras inventadas para ilustrar etiquetas y alcance, no una cotización real de una bóveda, una tabla de comisiones ni un cálculo de la tasa de un protocolo concreto. No se consultó ninguna cartera ni se ejecutó ninguna transacción para este ejemplo.

No sumes 100 participaciones y su equivalente de 120 tokens como tenencias separadas. Describen la misma posición. Si la cartera también contiene tokens subyacentes fuera de la bóveda, registra ese saldo real por separado. Al comparar totales en moneda fiduciaria, comprueba qué representación ha contado ya el rastreador antes de añadir un valor del protocolo. La guía general para conciliar carteras ayuda a distinguir cantidades ausentes de precios ausentes o posiciones no compatibles.

Registra una instantánea coherente sin mover fondos

Utiliza un explorador o lector de contratos en el que ya confíes. El procedimiento describe una inspección basada en documentación; no se probó con una bóveda activa para este artículo. Las referencias primarias se revisaron el 25 de octubre de 2026.

1. Confirma la identidad de la posición. Registra la red, la cuenta y la dirección completa del contrato de la bóveda. Verifica que ese despliegue utiliza la interfaz ERC-4626 que pretendes inspeccionar.
2. Identifica el activo y las unidades. Registra asset() y las escalas decimales de participaciones y activo. Lee el saldo de participaciones de la cuenta, distinguiendo enteros brutos de cantidades formateadas.
3. Elige la lectura pertinente. Para una comparación contable, registra convertToAssets de esa cantidad exacta de participaciones. Para estimar el reembolso, registra previewRedeem y etiquétalo como previsión.
4. Comprueba por separado el límite del propietario. Lee maxRedeem(owner) y las condiciones de retirada del protocolo. No sustituyas un límite no disponible por el saldo de participaciones ni interpretes una previsión positiva como autorización para reembolsar.
5. Alinea y etiqueta las observaciones. Prefiere el mismo bloque para saldo, conversión, previsión y límite. Si el lector solo ofrece llamadas separadas al estado más reciente, guarda sus horas y señala que las instantáneas pueden diferir.
6. Concilia una posición. Mantén juntos cantidad de participaciones, equivalente en activos e información de reembolso. Marca una lectura fallida como desconocida, conserva el error e investiga cuenta, contrato, red o interfaz antes de concluir que la cantidad es cero.

Estas lecturas públicas no necesitan firma, autorización de gasto, frase de recuperación ni transferencia. Si un sitio pide algo de eso solo para mostrar un saldo, detén ese proceso. La respuesta de un contrato puede explicar una pantalla; no certifica la seguridad del contrato.

Una conversión no es rentabilidad ni precio de venta

El equivalente en activos indica cómo expresa la bóveda una cantidad de participaciones en su token subyacente. No demuestra beneficios respecto al depósito original, un precio de venta en el mercado ni un reembolso futuro garantizado. Comisiones, redondeo, cambios de la bóveda y precio propio del activo subyacente deben registrarse por separado.

No generalices este procedimiento a todo token que represente un depósito. Por ejemplo, stETH y wstETH tienen su propio método documentado de contabilidad y conversión. Un saldo de aspecto similar no demuestra un comportamiento ERC-4626.

La comprobación termina cuando puedes nombrar la bóveda y el activo exactos, identificar la cantidad de participaciones y la instantánea, y explicar qué pantalla muestra una conversión, una previsión o un límite. Si una lectura esencial no está disponible, deja esa parte sin verificar. Mover la posición es una decisión aparte; no hace falta para explicar el saldo mostrado.