Saltar al contenido principal

Blockscout — Guía de uso

Blockscout es el explorador oficial de la red ISBE. Permite consultar bloques, transacciones, cuentas y contratos desplegados en los distintos entornos (dev, pre y pro). Esta herramienta es útil tanto para desarrolladores como para equipos funcionales que necesitan verificar la actividad on-chain de su caso de uso.

1. Acceso al explorador​

La red ISBE dispone de un explorador Blockscout por entorno. Cada caso de uso recibirá los enlaces correspondientes cuando se active su entorno.

Estructura de URLs:

  • ISBE-DEV: https://blockscout.dev.isbe.network (no real)
  • ISBE-PRE:
    • Red Case: https://blockscout-main.pre.portal.redisbe.com
    • Red Bare: https://blockscout-bare.pre.portal.redisbe.com
  • ISBE-PRO:
    • Red Case: https://blockscout-main.portal.redisbe.com
    • Red Bare: https://blockscout-bare.portal.redisbe.com

2. Funciones principales​

Blockscout permite:

2.1. Consultar bloques​

  • Altura del bloque
  • Validadores que han firmado el bloque
  • Número de transacciones incluidas
  • Timestamp
  • Hash del bloque

2.2. Consultar transacciones​

Incluye:

  • Estado de la transacción (success / failed)
  • Gas usado
  • Input data (útil para decodificar funciones)
  • Eventos emitidos por el contrato
  • Firma y dirección del emisor

2.3. Consultar contratos desplegados​

Permite:

  • Ver dirección del contrato
  • Código fuente verificado (si se sube)
  • ABI público (si se quiere compartir)
  • Eventos y funciones visibles
  • Interacción directa desde la interfaz (si está habilitada)

2.4. Consultar cuentas y balances​

Incluye:

  • Balance ETH simulado (sin valor económico)
  • Historial de transacciones
  • Interacciones con contratos

3. Verificación de contratos​

Los casos de uso pueden verificar su contrato en el explorador, lo que permite:

  • Mostrar el código fuente
  • Exponer la ABI
  • Facilitar auditorías y validación externa
  • Habilitar la interacción directa desde Blockscout

El proceso depende de la configuración del entorno, pero normalmente consiste en:

  1. Compilar el contrato con parámetros deterministas.
  2. Subir código fuente y metadatos al explorador.
  3. Confirmar dirección y constructor arguments.

Consultar al equipo ISBE si la verificación está habilitada en su entorno.

4. Limitaciones conocidas​

  • Blockscout puede tardar varios segundos en indexar un bloque recién generado.
  • Algunas funciones avanzadas de interacción pueden estar deshabilitadas según entorno.
  • La verificación automática de contratos no siempre está disponible en dev.
  • En redes permissioned, ciertas estadísticas públicas pueden estar simplificadas.

5. Buenas prácticas de uso​

  • Siempre verificar la transacción en Blockscout tras un despliegue crítico.
  • Para debugging avanzado, combinar Blockscout con logs RPC del nodo de ejecución.
  • Revisar los eventos del contrato para validar el comportamiento esperado.
  • Si una transacción aparece como pending durante demasiado tiempo, contactar con ISBE.

6. Resumen​

Blockscout es una herramienta esencial para:

  • Validar que las transacciones se ejecutan correctamente.
  • Inspeccionar contratos, eventos y llamadas.
  • Realizar auditoría básica de la actividad blockchain.

Debe usarse junto con los nodos RPC asignados y la monitorización del caso de uso para obtener una visión completa del comportamiento on-chain.