Parámetros técnicos de la red ISBE
Este documento recoge los parámetros operativos relevantes para los equipos que desarrollan y despliegan casos de uso sobre la red blockchain de ISBE. Incluye únicamente información necesaria para conectarse, desplegar contratos y operar de forma correcta en cada entorno (dev, pre, pro).
La red ISBE está basada en Hyperledger Besu y utiliza el mecanismo de consenso QBFT, totalmente compatible con EVM.
Los valores presentados en este documento corresponden a la configuración de referencia del MVP de ISBE y pueden variar según:
- Entorno (dev, pre, pro): cada entorno puede tener configuración específica
- Fase del proyecto (MVP, R1, R2): los parámetros pueden evolucionar entre entregas
- Actualizaciones de red: mejoras y optimizaciones posteriores al despliegue inicial
⚠️ Antes de configurar tus herramientas de desarrollo, verifica los valores específicos de tu entorno contactando con el equipo de infraestructura ISBE. Los parámetros críticos a confirmar son:
- Chain ID y Network ID
- Endpoints RPC (URLs y puertos)
- Tiempo de bloque actual
- Versión de Besu recomendada para tu entorno
1. Cliente y versión
La red ejecuta:
- Cliente: Hyperledger Besu
- Versión recomendada: 24.12.2 (actualizada según entrega del proyecto)
- Compatibilidad: EVM (Ethereum Virtual Machine)
- Consenso: QBFT (QBFT es la evolución de IBFT 2.0)
- Algoritmo hash: Keccak-256 (estándar Ethereum)
Besu es un cliente empresarial mantenido por la Linux Foundation, con soporte para redes permissioned y configuración flexible de QBFT.
La versión específica de Besu puede variar según el entorno y la fase del proyecto (MVP, R1, R2). Consulta con el equipo de infraestructura ISBE para la versión exacta de tu entorno.
2. Consenso: QBFT
La red ISBE utiliza QBFT (evolución mejorada de Istanbul BFT 2.0), un mecanismo tolerante a fallos bizantinos donde:
- Un conjunto de validadores propone y firma bloques.
- El bloque sólo es válido si alcanza un quorum de firmas.
- El sistema permite tolerar nodos caídos o no honestos dentro de los límites de BFT.
Parámetros de consenso configurados:
- Block period: 5 segundos (tiempo entre bloques)
- Epoch length: 1000 bloques (para rotación de validadores)
- Request timeout: 2 segundos (timeout de propuestas)
Características relevantes para los casos de uso:
- No existe minería: el consenso es determinístico.
- El tiempo de bloque es estable (5 segundos configurados).
- El comportamiento de las transacciones es predecible.
- No existe reorganización profunda de cadena (reorgs mínimos).
3. Tiempo de bloque
El tiempo de generación de bloque configurado en ISBE es:
- Tiempo de bloque: 5 segundos (parámetro
blockperiodseconds) - Variabilidad: muy baja (consenso determinístico)
- Adecuado para:
- Protocolos de notarización
- Smart contracts de uso general
- Integraciones backend con latencia predecible
Este block time puede ajustarse si la red requiere optimizaciones posteriores, pero los casos de uso deben diseñarse considerando que la escritura en blockchain nunca es instantánea y siempre implica latencia estructural (mínimo 5 segundos para confirmación).
4. Límite de gas y coste de transacción
ISBE, al ser una red permissioned basada en Besu, no utiliza un token económico. Por lo tanto:
- No existen costes económicos por transacción.
- El gas se usa únicamente como mecanismo de control de ejecución.
- Las transacciones deben incluir un límite de gas razonable para evitar operaciones excesivamente pesadas o bucles infinitos.
Límites configurados:
- Gas por bloque: 32.000.000 (0x1e84800 en hexadecimal)
- Gas por transacción: dinámico, según contrato, siempre dentro del límite de bloque.
- Gas mínimo por transacción: 1 wei (parámetro
min-gas-price)
Esto permite desplegar contratos complejos sin restricciones artificiales, pero se recomienda evitar:
- Contratos con almacenamiento masivo en un solo bloque.
- Lógica interna innecesariamente pesada.
5. Chain ID y Network ID
La red ISBE utiliza los siguientes identificadores:
- Chain ID: 2023
- Network ID: 2023
El Chain ID es el mismo para todos los entornos (dev, pre, pro) en la configuración actual de referencia. Esto significa:
- Las transacciones firmadas incluyen el identificador 2023
- Los wallets y librerías EVM deben configurarse con
chainId: 2023 - Frameworks como Hardhat o Foundry deben usar este valor en su configuración
Si tu entorno utiliza un Chain ID diferenciado por entorno (dev/pre/pro), el equipo de infraestructura ISBE te proporcionará los valores específicos. Verifica siempre con el equipo antes de configurar tus herramientas de desarrollo.
6. Tipos de endpoints RPC
Cada entorno expone endpoints compatibles con Ethereum JSON-RPC:
-
HTTP RPC: utilizado para la mayoría de interacciones backend (lecturas, escrituras)
- Puerto estándar: 8545
- APIs habilitadas:
ETH,NET,QBFT - CORS habilitado para desarrollo
-
WebSocket RPC: necesario para escuchar eventos en tiempo real (logs emitidos por contratos)
- Disponible según configuración del nodo
Parámetros de configuración RPC:
--rpc-http-enabled
--rpc-http-host=0.0.0.0
--rpc-http-port=8545
--rpc-http-api=ETH,NET,QBFT
--rpc-http-cors-origins="all"
--host-allowlist="*"
Los casos de uso recibirán las URLs finales de sus endpoints cuando se active su nodo regular o acceso a nodo compartido.
7. Reglas de permisionado
La red es permissioned: cada nodo debe incluirse en la lista de nodos autorizados para unirse al P2P.
El permisionado afecta únicamente a:
- Nodos regulares (propios de un caso de uso).
- Nodos validadores y permisionadores (gestionados por ISBE).
El permisionado no afecta a las dApps: cualquier aplicación puede conectarse al RPC asignado sin necesidad de formar parte del P2P.
8. Límites operacionales recomendados
Para garantizar un uso correcto de la red:
- Evitar enviar más de 10–20 transacciones por segundo desde una misma cuenta sin coordinación previa.
- Esperar confirmación de bloque antes de iniciar procesos dependientes.
- Diseñar smart contracts siguiendo patrones de eficiencia:
- Evitar almacenamiento redundante.
- Usar eventos en lugar de almacenar logs internos.
- No hacer loops dependientes de tamaño dinámico sin control.
9. Configuración adicional de nodos
Los nodos ISBE utilizan los siguientes parámetros adicionales de Besu:
Networking:
- Puerto P2P: 30303 (TCP/UDP)
- Host P2P: configurable según despliegue
Métricas:
- Métricas habilitadas por defecto
- Puerto métricas: 9545
- Host métricas:
0.0.0.0
Logging:
- Nivel por defecto:
INFO
Rutas personalizables:
--data-path: Ruta del directorio de datos del nodo--genesis-file: Ruta del archivo genesis.json--node-private-key-file: Ruta de la clave privada del nodo
10. Resumen de parámetros
| Parámetro | Valor |
|---|---|
| Cliente | Hyperledger Besu 24.12.2 |
| Consenso | QBFT (evolución de IBFT 2.0) |
| Tiempo de bloque | 5 segundos |
| Gas por bloque | 32.000.000 gas |
| Gas mínimo | 1 wei |
| Coste económico | Ninguno |
| Compatibilidad | Ethereum/EVM |
| Chain ID | 2023 |
| Network ID | 2023 |
| Puerto RPC HTTP | 8545 |
| Puerto P2P | 30303 |
| Puerto Métricas | 9545 |
| APIs RPC | ETH, NET, QBFT |
| Red | Permissioned |