Skip to main content

FAQ - Preguntas Frecuentes de Infraestructura

Esta sección responde a las preguntas más comunes sobre la infraestructura de la red ISBE, el despliegue de nodos y la operación de casos de uso.

Acceso y Conectividad​

¿Cómo accedo a la red ISBE?​

Mediante el endpoint RPC/WebSocket que ISBE proporcionará a tu caso de uso. Existen dos opciones:

  • Nodo compartido: ISBE te facilita el acceso a un nodo regular gestionado por el equipo de infraestructura.
  • Nodo propio: Puedes desplegar tu propio nodo regular siguiendo la guía de instalación y solicitando el permisionado.

¿Necesito desplegar mi propio nodo o puedo usar uno compartido?​

Depende de tus necesidades:

  • Usa nodo compartido si: tu caso de uso tiene tráfico moderado, no requieres control total del nodo, o estás en fase de pruebas.
  • Despliega nodo propio si: generas mucho tráfico, necesitas eventos en tiempo real intensivos, requieres mayor aislamiento, o quieres monitorización dedicada.

Consulta Tipos de Nodos - Cuándo conviene tener un nodo regular propio.

¿Qué puertos necesito abrir en mi firewall?​

Si despliegas un nodo regular propio:

  • 30303/tcp (obligatorio): Comunicación P2P con la red ISBE
  • 8545/tcp (opcional): RPC HTTP (solo si necesitas exponerlo)
  • 8546/tcp (opcional): WebSocket RPC (solo si necesitas exponerlo)

Ver detalles completos en Requisitos - Red.

Mi nodo muestra 0 peers, ¿qué hago?​

Verifica lo siguiente:

  1. Puerto 30303/tcp está abierto: comprueba firewall y reglas de seguridad de tu cloud provider
  2. IP pública correcta: la IP enviada en la solicitud de permisionado debe coincidir con la IP pública del servidor
  3. Permisionado aprobado: confirma con ISBE que tu enode fue autorizado correctamente
  4. Nodo arrancado correctamente: revisa logs con docker logs -f <Nombre_nodo>

Ver Indicadores Básicos - Acciones recomendadas.

Despliegue de Contratos y Transacciones​

¿Puedo desplegar smart contracts en la red?​

Sí, puedes desplegar contratos usando cualquier nodo regular (compartido o propio). La red ISBE es totalmente compatible con EVM, por lo que puedes usar herramientas estándar como:

  • Hardhat
  • Foundry
  • Truffle
  • Remix
  • Web3.js / Ethers.js

Ver Documentación de Smart Contracts para más detalles.

¿Hay costes económicos por transacción?​

No. ISBE es una red permissioned sin token económico. El gas se usa únicamente como mecanismo de control de ejecución para evitar operaciones excesivamente pesadas o bucles infinitos, pero no tiene coste económico.

Ver Parámetros de Red - Límite de gas.

¿Cuántas transacciones por segundo puedo enviar?​

Se recomienda no superar 10-20 transacciones por segundo desde una misma cuenta sin coordinación previa con ISBE. Si tu caso de uso requiere mayor throughput, contacta con el equipo de infraestructura para evaluar opciones.

Ver Parámetros de Red - Límites operacionales.

¿Cuánto tarda en confirmarse una transacción?​

El tiempo de bloque es aproximadamente 2 segundos. Esto significa que una transacción típicamente se confirma en un bloque en ese intervalo. Para operaciones críticas, se recomienda esperar 2-3 bloques para mayor seguridad.

Entornos y Configuración​

¿Cuál es la diferencia entre dev, pre y pro?​

  • ISBE-DEV: Desarrollo y pruebas tempranas. Puede ser reiniciado o tener cambios frecuentes.
  • ISBE-PRE: Preproducción. Réplica de producción para pruebas finales. Configuración estable.
  • ISBE-PRO: Producción. Solo para casos de uso maduros y validados. Cambios controlados con ventanas de mantenimiento.

Cada entorno es una red Besu independiente con su propio Chain ID.

Ver Arquitectura General - Entornos.

¿Cómo sé qué Chain ID usar?​

Cada entorno tiene su propio Chain ID. Estos valores serán proporcionados por ISBE cuando se active tu acceso al entorno correspondiente. El Chain ID correcto es necesario para:

  • Firmar transacciones correctamente
  • Configurar wallets (MetaMask, etc.)
  • Configurar frameworks de desarrollo (Hardhat, Foundry)

Ver Parámetros de Red - Chain ID.

¿Puedo migrar contratos entre entornos?​

Los contratos no se "migran", se redesplegan en cada entorno. Cada entorno (dev/pre/pro) es una blockchain independiente, por lo que debes:

  1. Desplegar el contrato en el nuevo entorno
  2. Actualizar las direcciones de contrato en tu aplicación
  3. Volver a verificar el contrato en Blockscout si es necesario

Monitorización y Troubleshooting​

¿Cómo verifico que mi nodo está sincronizado?​

Ejecuta el siguiente comando RPC:

curl -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
  http://localhost:8545

Compara el resultado con la altura de bloque en Blockscout. Si los números son similares (diferencia < 5 bloques), tu nodo está sincronizado.

Ver Indicadores Básicos.

¿Dónde puedo ver las transacciones y bloques de la red?​

Utiliza el explorador Blockscout oficial. ISBE te proporcionará la URL correspondiente a tu entorno:

  • Blockscout DEV
  • Blockscout PRE
  • Blockscout PRO

Ver Guía de Uso de Blockscout.

¿Puedo verificar el código fuente de mis contratos?​

Sí, Blockscout permite verificar el código fuente de los contratos desplegados. Esto facilita:

  • Transparencia y auditorías
  • Interacción directa desde el explorador
  • Validación por terceros

El proceso depende del entorno. Consulta con ISBE si la verificación está habilitada.

Ver Blockscout - Verificación de contratos.

Mi transacción aparece como "pending" mucho tiempo, ¿qué ocurre?​

Posibles causas:

  • Gas limit insuficiente: aumenta el gas limit de la transacción
  • Nonce incorrecto: verifica que estés usando el nonce correcto
  • Nodo desincronizado: verifica la altura de bloque de tu nodo
  • Problema de red: revisa el block time en Blockscout

Si el problema persiste más de 1 minuto, contacta con ISBE.

¿Cómo accedo a los paneles de monitorización?​

ISBE proporciona paneles de Grafana/Prometheus para visualizar métricas de red y nodos. El acceso se habilita por caso de uso. Solicita credenciales al equipo de infraestructura.

Ver Paneles de Monitorización.

Permisos y Seguridad​

¿Quién puede unirse a la red ISBE?​

ISBE es una red permissioned. Solo pueden participar:

  • Nodos validadores gestionados por ISBE
  • Nodos regulares de entidades autorizadas que hayan completado el proceso de permisionado

Las aplicaciones (dApps) pueden conectarse a los nodos regulares sin restricciones, pero los nodos en sí deben estar autorizados.

Ver Solicitud de Permisionado.

¿Cuánto tarda el proceso de permisionado?​

Normalmente entre 1-3 días laborables, dependiendo de:

  • Completitud de la información enviada
  • Validaciones técnicas necesarias
  • Carga de trabajo del equipo de infraestructura

Asegúrate de proporcionar toda la información requerida en la solicitud inicial para evitar demoras.

¿Qué pasa si cambio la IP de mi nodo?​

Debes notificar a ISBE inmediatamente para actualizar la lista de permisionado. Si cambias la IP sin notificar:

  • Tu nodo no podrá conectarse a la red P2P
  • Aparecerá con 0 peers
  • Las aplicaciones perderán conectividad

El proceso de actualización suele tardar unas horas.

¿Puedo tener múltiples nodos para el mismo caso de uso?​

Sí, puedes desplegar varios nodos regulares si tu caso de uso lo requiere (por ejemplo, para alta disponibilidad o balanceo de carga). Cada nodo debe:

  • Solicitar permisionado independiente
  • Tener su propio enode y claves
  • Cumplir los requisitos de hardware y red

Operación y Mantenimiento​

¿Quién es responsable del mantenimiento de mi nodo?​

Depende del tipo de nodo:

  • Nodo compartido gestionado por ISBE: responsabilidad completa de ISBE
  • Nodo propio: responsabilidad del caso de uso (backups, actualizaciones, seguridad, logs)

ISBE solo gestiona el permisionado y la topología P2P, no la operación de nodos desplegados por terceros.

¿Necesito hacer backups de mi nodo?​

Sí, si operas tu propio nodo regular. Se recomienda:

  • Backup del directorio de datos (data-path)
  • Backup de las claves del nodo (keys/)
  • Backups periódicos (diarios o semanales según criticidad)

Sin embargo, los nodos regulares pueden resincronizarse desde cero si pierdes los datos, aunque tomará tiempo.

¿Debo actualizar Besu cuando salga una nueva versión?​

ISBE notificará cuando sea necesario actualizar la versión de Besu. Las actualizaciones críticas de seguridad son obligatorias. Para actualizaciones menores, ISBE proporcionará una ventana de tiempo recomendada.

Los nodos que no actualicen a tiempo pueden perder compatibilidad con la red.

¿Puedo detener mi nodo temporalmente?​

Sí, puedes detener tu nodo regular sin problemas. Cuando lo reinicies, se resincronizará automáticamente con la red. Sin embargo:

  • Tu aplicación perderá conectividad mientras el nodo esté detenido
  • La resincronización tomará tiempo (depende de cuánto tiempo estuvo detenido)

Para mantenimientos programados, notifica a tus usuarios.

Soporte​

¿A quién contacto si tengo problemas?​

Para problemas de infraestructura:

  • Email de soporte ISBE (proporcionado en tu onboarding)
  • Sistema de tickets (si está disponible)

Para problemas de contratos:

¿Hay un horario de soporte?​

Consulta las condiciones de tu acuerdo con ISBE. Generalmente:

  • Entorno PRO: soporte en horario laboral, incidencias críticas 24/7
  • Entornos DEV/PRE: soporte en horario laboral

¿Dónde reporto incidencias?​

Sigue el procedimiento establecido por ISBE en tu proceso de onboarding. Generalmente incluye:

  • Email de incidencias
  • Sistema de tickets
  • Canal de Slack/Teams (si aplica)

Proporciona siempre:

  • Entorno afectado (dev/pre/pro)
  • Nombre del nodo (si aplica)
  • Descripción del problema
  • Logs relevantes
  • Timestamp de la incidencia

¿No encuentras respuesta a tu pregunta? Consulta la documentación completa de infraestructura o contacta con el equipo de soporte ISBE.