27 de julio de 2026

Introducción

Luego del cierre de la interfaz web de Tropykus, los contratos inteligentes continuarán funcionando normalmente en la red Rootstock. Esto significa que los usuarios seguirán teniendo el control de sus fondos y podrán interactuar directamente con los contratos utilizando el explorador de bloques Blockscout. Tené en cuenta que, a partir del 1 de septiembre de 2026, el equipo de Tropykus ya no brindará soporte para la interacción con los contratos inteligentes. 

Esta guía explica, paso a paso, cómo realizar las operaciones disponibles directamente desde los contratos inteligentes.

Herramienta de consulta rápida (opcional)

Antes de comenzar con los pasos de esta guía, podés utilizar esta herramienta para consultar tu posición en Tropykus de forma más simple.

Acceso: https://tropykus-consulta.netlify.app/

Esta herramienta fue desarrollada por un miembro de la comunidad y no forma parte del proyecto oficial de Tropykus.

No solicita permisos sobre tu billetera, no puede firmar transacciones ni mover fondos. Solo requiere que ingreses tu dirección para consultar la información directamente desde los contratos inteligentes y mostrarla de forma unificada.

Con ella podés ver:

• Los activos que tenés depositados y su monto real (sin necesidad de convertir kTokens).
• La liquidez disponible en los mercados de DOC y USDRIF para verificar si un retiro puede realizarse.
• Los préstamos activos y el monto pendiente de cada uno.

Además, junto a cada dato encontrarás botones para copiar el valor exacto que debe utilizarse en Blockscout:

• Retirar fondos: copia el valor que debe pegarse directamente en el campo de la función redeem, sin realizar conversiones adicionales.
• Aprobar un pago (approve): copia el monto con un pequeño margen adicional para evitar que la autorización resulte insuficiente por diferencias de intereses o redondeos.
• Pagar un préstamo (repayBorrow): copia un valor especial que indica al contrato que cancele la totalidad de la deuda existente al momento de ejecutar la transacción. Esto evita que quede un pequeño saldo pendiente debido a los intereses generados entre la consulta y la confirmación de la operación.

Importante: Esta herramienta es opcional. Todas las operaciones también pueden realizarse siguiendo únicamente los pasos explicados en esta guía.

Operaciones disponibles

Actualmente, las únicas operaciones disponibles en los contratos de Tropykus son:

• Retirar fondos depositados.
• Pagar préstamos existentes.

No es posible realizar nuevos depósitos ni solicitar nuevos préstamos.

¿Qué es Blockscout?

Blockscout es un explorador de bloques de código abierto que permite consultar la actividad de la red Rootstock e interactuar directamente con contratos inteligentes verificados desde el navegador.

A través de su interfaz es posible conectar una billetera compatible y ejecutar funciones de los contratos sin necesidad de utilizar la aplicación web de Tropykus.

Acceso a Blockscout:

https://rootstock.blockscout.com/

Requisitos

Antes de comenzar, asegúrate de cumplir con los siguientes requisitos.

1. Tener una billetera compatible

La billetera debe ser compatible con la red Rootstock y permitir firmar transacciones.

Por ejemplo:

• MetaMask
• Rabby
• Trezor (a través de MetaMask)
• Ledger (a través de MetaMask)

La dirección utilizada debe ser la misma con la que interactuaste previamente con Tropykus.

2. Tener configurada la red Rootstock

La billetera debe estar conectada a la red Rootstock.

Si utilizás otra red, las transacciones fallarán.

3. Contar con RBTC

Cada operación requiere pagar una comisión de red (gas).

Por eso es necesario tener una pequeña cantidad de RBTC disponible.

Si no tenés RBTC, no podrás firmar ninguna transacción.

4. Conocer el contrato correcto

Cada mercado de Tropykus está representado por un kToken, que funciona como un recibo de depósito. Por ejemplo, el contrato kDOC representa tus depósitos en DOC y es necesario para poder reclamar tus fondos al interactuar directamente con los contratos inteligentes.

Los contratos son los siguientes:

Durante esta guía utilizarás el contrato del kToken correspondiente al mercado sobre el que deseas operar.

Importante: Cuando vayas a realizar un pago de préstamo con DOC o USDRIF, también será necesario interactuar con el contrato del token correspondiente para otorgar la autorización (approve) antes de ejecutar el pago.

Cómo funciona la interacción con un contrato

Todos los contratos poseen dos tipos de funciones.

Read contract

Permite consultar información.

Estas funciones:

• no modifican tu posición;
• son gratuitas;
• no requieren firmar una transacción.

Ejemplos:

• consultar saldo
• consultar deuda
• consultar intereses

Write contract

Permite ejecutar operaciones.

Estas funciones:

• pueden modificar tu posición;
• requieren firmar una transacción;
• consumen gas.

Las operaciones de esta guía se realizan desde esta sección.

Paso 1 — Abrir Blockscout

Ingresá al explorador:

https://rootstock.blockscout.com/

Paso 2 — Buscar el contrato

En la barra de búsqueda pegá la dirección del contrato correspondiente al mercado que querés utilizar.

Por ejemplo:

• contrato kDOC
• contrato kRBTC

Presioná Enter.

Paso 3 — Abrir la página del contrato

Una vez dentro del contrato encontrarás varias pestañas.

Entre ellas:

• Token transfers
• Holders
• Contract
• Widgets

Seleccioná Contract.

Paso 4 — Abrir la sección Read/Write contract

Dentro de la pestaña Contract encontrarás la sección Read/Write Contract. Desde allí podrás acceder a las pestañas Read y Write.

Seleccioná la pestaña Read para consultar información del contrato sin ejecutar transacciones, y la pestaña Write para realizar operaciones que modifican el estado del contrato.

Paso 5 — Conectar la billetera

Presioná el botón Connect your wallet.

Seleccioná tu billetera.

Por ejemplo:

• MetaMask
• Rabby

La billetera solicitará autorización para conectarse al sitio.

Aceptá la conexión.

Paso 6 — Elegir la función

En la lista aparecerán todas las funciones disponibles.

Cada función tiene un propósito diferente.

Por ejemplo:

• consultar el saldo disponible 
• retirar fondos
• pagar un préstamo
• aprobar un token

En las siguientes secciones se explicará cuál utilizar para cada operación.

Retirar fondos

¿Qué hace esta operación?

Permite retirar los activos depositados en Tropykus hacia tu billetera.

No modifica ningún préstamo existente.

Paso 1

Buscá el contrato del kToken correspondiente al activo que querés retirar. Por ejemplo, si querés retirar DOC, deberás utilizar el contrato de kDOC indicado más arriba en esta guía.

Dentro de la página del contrato, ubicá la sección Contract y seleccioná Read/Write Contract. Luego, ingresá a la pestaña Read para consultar el balance de kTokens.

Buscá la función balanceOf, ingresá la dirección de tu billetera y ejecutá la consulta. El resultado indicará la cantidad de kTokens disponibles para retirar.

Paso previo

Antes de ejecutar cualquier operación desde la sección Write, conectá tu billetera al explorador de bloques. Esto permitirá firmar la transacción y autorizar la operación con la cuenta que tiene los kTokens.

Para conectar tu billetera, accedé directamente a este paso: Conectar billetera. 

Paso 2

Dentro de la sección Contract → Read/Write contract → Write, buscá la función redeem para realizar el retiro de fondos.

La función redeem permite retirar los fondos indicando la cantidad de kTokens que querés canjear. Para ello, utilizá el valor obtenido previamente mediante la función balanceOf e ingresalo en el campo correspondiente de redeem.

Importante: El valor obtenido en balanceOf ya está expresado en la unidad requerida por el contrato (con 18 decimales), por lo que no es necesario realizar ninguna conversión antes de ingresarlo en redeem. Copiá directamente el valor obtenido y pegalo en el campo correspondiente. Realizar una conversión adicional podría generar un monto incorrecto y afectar la operación.

Una vez completado el campo, presioná Write y confirmá la transacción desde tu billetera conectada.

Paso 3

Esperá a que la transacción sea confirmada.

Una vez confirmada, podrás verla en Blockscout.

Importante: En los mercados de DOC y USDRIF, la transacción de retiro puede fallar si el contrato no cuenta con suficiente liquidez disponible. Antes de realizar el retiro, podés consultar la liquidez del mercado mediante la función getCash() en la sección Read. El valor obtenido debe dividirse por 10^18 para expresarlo en la unidad del activo correspondiente.

Ejemplo: El valor obtenido en getCash() debe dividirse entre 10¹⁸ para convertirlo a la unidad del activo correspondiente.

En este caso:

98784483752028125524974 ÷ 10¹⁸ = 98784.483752028125524974

Por lo tanto, la liquidez disponible es aproximadamente $98,784.48.

Pagar un préstamo

¿Qué hace esta operación?

Permite cancelar total o parcialmente un préstamo existente.

Paso previo

Antes de realizar el pago del préstamo, ingresá al contrato del kToken correspondiente al mercado del préstamo. Por ejemplo, si tu préstamo es en DOC, deberás utilizar el contrato de kDOC indicado más arriba en esta guía.

Dentro de la página del contrato, ubicá la sección Contract y seleccioná Read/Write contract. Luego, ingresá a la pestaña Read para consultar la deuda pendiente.

Buscá la función borrowBalanceStored o borrowBalanceCurrent e ingresá la dirección de tu billetera.

• borrowBalanceCurrent: muestra la deuda actual incluyendo los intereses acumulados hasta el bloque más reciente. Requiere una transacción y tiene costo de gas.
• borrowBalanceStored: muestra la deuda registrada en la última actualización del protocolo. No requiere una transacción ni costo de gas, pero puede no incluir los intereses acumulados recientemente.

Para conocer el monto exacto de la deuda a pagar, utilizá borrowBalanceCurrent. El valor obtenido debe dividirse entre 10¹⁸ para convertirlo al formato decimal y conocer el monto real de la deuda. 

Paso 1

Antes de realizar el pago del préstamo, deberás ejecutar la función approve desde el contrato del token correspondiente. Esta autorización permite que el contrato de Tropykus pueda transferir los fondos necesarios desde tu billetera para cancelar el préstamo.

Los contratos son:

Importante: Para evitar que la transacción falle por diferencias en el cálculo de intereses o redondeos, recomendamos aprobar un monto ligeramente superior al que vas a utilizar para pagar la deuda. Por ejemplo, podés aprobar entre 1 y 2 DOC o USDRIF adicionales al monto estimado del pago.

Paso 2

Abrí el contrato del token correspondiente (DOC o USDRIF) utilizando la dirección indicada anteriormente.

Una vez dentro del contrato, seleccioná la pestaña Contract.

Según el token, la sección para ejecutar la función approve puede variar:

• Para USDRIF: seleccioná Read/Write proxy.
• Para DOC: seleccioná Read/Write contract.

Presioná Connect your wallet y conectá la billetera desde la que realizaste las operaciones en Tropykus.

Luego buscá la función approve y completá los parámetros: 

• spender (address): ingresá la dirección del contrato del kToken correspondiente al mercado del préstamo (por ejemplo, kUSDRIF o kDOC). Estas direcciones se encuentran en la sección "Conocer el contrato correcto" de esta guía.
• amount (uint256): ingresá el monto que querés pagar del préstamo. En este ejemplo, como se van a pagar $151, ingresá 151 y luego presioná el botón ×10¹⁸. El valor se convertirá al formato utilizado por el contrato y pasará a verse como 151000000000000000000, tal como se muestra en la imagen.

Finalmente, presioná Write y firmá la transacción desde tu billetera.

Una vez confirmada, la autorización estará activa y podrás continuar con la función repayBorrow.

Paso 3

Dentro del contrato del kToken correspondiente al mercado del préstamo, ingresá a la sección Read/Write contract y seleccioná la opción Write.

Buscá la función repayBorrow.

Esta función permite realizar el pago total o parcial de un préstamo existente. Al ejecutarla, el contrato utilizará la autorización otorgada previamente mediante la función approve para transferir los fondos necesarios y reducir la deuda pendiente.

Paso 4

Completá el monto que querés pagar del préstamo.

Ingresá la cantidad en formato decimal y luego presioná el botón ×10¹⁸ para convertir el valor al formato utilizado por el contrato.

4.1. Pagar toda la deuda

Si querés cancelar el préstamo por completo, hacé clic en Max. De esta forma se completará automáticamente el monto total de la deuda y evitarás que quede un saldo pendiente.

4.2. Realizar un pago parcial

Si querés pagar solo una parte del préstamo, ingresá el monto que deseás pagar. Por ejemplo, para pagar $150, escribí 150 y luego presioná el botón ×10¹⁸. El valor se convertirá al formato utilizado por el contrato y pasará a verse como 150000000000000000000.

Una vez que el monto sea el correcto, hacé clic en Write.

Paso 5

La billetera abrirá una ventana para confirmar la transacción.

Revisá la información de la operación y, si todo es correcto, presioná Confirmar o Aceptar para firmarla.

Paso 6

Esperá a que la transacción sea confirmada en la blockchain de Rootstock.

Una vez confirmada, la operación quedará registrada y podrás consultarla en Blockscout.

Si todo se ejecutó correctamente, consultá cualquiera de estas dos funciones del apartado Borrow. En ambos casos, el saldo del préstamo debería ser 0.

Verificar que la operación fue exitosa

Luego de firmar la transacción:

• Blockscout mostrará el hash.
• Podrás abrir la transacción.
• Verás el estado Success cuando haya sido confirmada.

Errores frecuentes

No aparece Connect your wallet

Actualizar la página o comprobar que la billetera esté instalada y desbloqueada.

La transacción falla

Verificar:

• que haya RBTC suficiente;
• que la red seleccionada sea Rootstock;
• que se esté utilizando el contrato correcto.

No puedo retirar mis fondos

Verificar:

• que el mercado tenga liquidez suficiente para procesar el retiro;
• que no tengas préstamos activos que estén utilizando esos fondos como colateral.

No puedo pagar el préstamo

Verificar:

• que previamente se haya ejecutado la autorización (approve) desde el contrato del token correspondiente;
• que en el approve se haya utilizado como spender el contrato kToken correcto.

Preguntas frecuentes

¿Los contratos siguen funcionando?
Sí. Aunque la interfaz de Tropykus deje de estar disponible, los contratos inteligentes continúan desplegados en Rootstock y pueden utilizarse directamente desde Blockscout.

¿Puedo realizar nuevos depósitos?
No. Los depósitos ya no están habilitados. 

¿Puedo solicitar un nuevo préstamo?
No. Los nuevos préstamos ya no están habilitados.