> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plasma.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizaciones

> Actualizaciones de software, actualizaciones de consenso y mantenimiento

## Por qué importan las actualizaciones

La arquitectura de Plasma evoluciona rápidamente para soportar casos de uso de alto throughput y nativos de stablecoins. Las actualizaciones oportunas:

* Protegen contra vulnerabilidades de seguridad
* Mejoran el rendimiento para cargas de trabajo de pagos
* Mantienen la compatibilidad con la capa de consenso y la interfaz RPC de Plasma

Los nodos desactualizados pueden experimentar fallos de sincronización, rendimiento degradado o problemas de seguridad. Como los nodos no validadores a menudo sirven tráfico RPC crítico para aplicaciones de pago, mantenerse actualizado es esencial.

<Note>
  La mayoría de las actualizaciones de nodos no validadores requieren entre 15 y 30 minutos de tiempo de inactividad. Los lanzamientos mayores que introducen nuevas funcionalidades o cambios de consenso pueden requerir ventanas de sincronización más largas.
</Note>

## Tipos de actualizaciones

<Columns cols={3}>
  <Card title="Parches de seguridad" href="#security-patches">
    Correcciones críticas para la protección de la infraestructura de pagos
  </Card>

  <Card title="Actualizaciones de funcionalidades" href="#feature-updates">
    Nuevas capacidades para aplicaciones de pago
  </Card>

  <Card title="Optimizaciones de rendimiento" href="#performance-optimisations">
    Mejoras para el procesamiento de transacciones de alto volumen
  </Card>
</Columns>

### Parches de seguridad

Los parches de seguridad abordan vulnerabilidades en clientes no validadores, Reth o dependencias.

**Ejemplos:**

* Vulnerabilidades de inconsistencia de estado o desincronización del consenso
* Correcciones de control de acceso y autenticación RPC
* Actualizaciones de librerías criptográficas

Estas deben aplicarse inmediatamente cuando se lanzan.

### Actualizaciones de funcionalidades

Los lanzamientos de funcionalidades habilitan nuevas capacidades de protocolo o soporte para nuevos patrones de aplicación.

**Ejemplos:**

* Mejoras en las transferencias de USD₮ con comisión cero
* Soporte para tokens de gas personalizados
* Métodos RPC nuevos o extendidos
* Optimizaciones de consulta de estado
* Mejoras en la integración con wallets y exchanges

### Optimizaciones de rendimiento

Los lanzamientos enfocados en rendimiento mejoran la velocidad de ejecución, la eficiencia de sincronización y el uso de recursos.

**Ejemplos:**

* Lecturas y escrituras más rápidas a la base de datos
* Reducción de latencia RPC bajo carga
* Mejor eficiencia de memoria y CPU
* Mejoras en la sincronización del consenso

## Procedimiento de actualización

Las actualizaciones de nodos no validadores típicamente involucran descargar una nueva imagen Docker, actualizar las configuraciones y reiniciar el servicio.

<Steps>
  <Step title="Notifica a las aplicaciones">
    Informa a los servicios conectados sobre el mantenimiento planificado.
  </Step>

  <Step title="Verifica la compatibilidad">
    Asegúrate de que las nuevas versiones del cliente no validador funcionen con los endpoints de consenso actuales.
  </Step>

  <Step title="Actualiza la configuración">
    Aplica cualquier nueva opción de configuración para funcionalidades mejoradas. Presta especial atención a los cambios que afectan el soporte de tokens de gas personalizados, el procesamiento de transacciones sin comisión o las interfaces RPC de aplicaciones de pago.
  </Step>

  <Step title="Prueba los endpoints RPC">
    Verifica la compatibilidad de la aplicación de pago después de la actualización.
  </Step>

  <Step title="Monitorea el procesamiento de transacciones">
    Asegura la operación normal de las transferencias de USD₮ y operaciones de gas personalizado.
  </Step>
</Steps>

<Tip>
  Despliega las actualizaciones por etapas cuando operes múltiples nodos no validadores. Comienza con instancias no críticas antes de actualizar la infraestructura primaria de pagos, y monitorea cuidadosamente el primer nodo actualizado antes de proceder.
</Tip>

## Verificación posterior a la actualización

Después de actualizar, verifica la sincronización completa con la capa de consenso y valida la funcionalidad central.

<Check>**Sincronización del consenso**: La altura del bloque se alinea con la red</Check>
<Check>**Funcionalidad RPC**: Prueba los endpoints clave usados por las aplicaciones de pago</Check>
<Check>**Línea base de rendimiento**: Compara las métricas posteriores a la actualización con las líneas base anteriores</Check>
<Check>**Monitoreo**: Valida que los sistemas de monitoreo y alertas permanezcan operativos</Check>

<Tip>
  Documenta los cambios de configuración y el comportamiento observado. Esto mejora la confiabilidad para futuras actualizaciones y solución de problemas. Para problemas comunes, consulta la [guía de solución de problemas](./troubleshooting).
</Tip>

## Procedimientos de rollback

### Cuándo hacer rollback

Haz rollback si observas:

* Fallo de sincronización del consenso
* Degradación severa del rendimiento RPC
* Incompatibilidad con las aplicaciones
* Regresión de seguridad
* Inconsistencia de datos que afecta saldos o transferencias

### Cómo hacer rollback

<Steps>
  <Step title="Detén los servicios">
    Detén los servicios del nodo no validador.
  </Step>

  <Step title="Revierte la imagen y la configuración">
    Revierte a la imagen Docker y configuración anterior.
  </Step>

  <Step title="Reinicia y resincroniza">
    Reinicia los servicios y resincroniza con la red.
  </Step>

  <Step title="Verifica la funcionalidad">
    Vuelve a probar los endpoints RPC y la funcionalidad de transacciones.
  </Step>

  <Step title="Notifica a los equipos">
    Notifica a los equipos de aplicaciones sobre la restauración.
  </Step>
</Steps>

## Buenas prácticas

### Automatización y monitoreo

* Automatiza las descargas de imágenes y actualizaciones de configuración donde sea posible
* Rastrea los cambios con configuración bajo control de versiones
* Mejora la observabilidad durante las actualizaciones
* Monitorea de cerca las tasas de error RPC, el estado de sincronización y el throughput de transacciones después de los reinicios

## Solución de problemas común

Si ocurren problemas después de la actualización:

* **Sincronización del consenso**: Revisa la conectividad del endpoint, las credenciales y el estado de allowlist
* **Errores RPC**: Valida la configuración, la compatibilidad de versión y las interfaces actualizadas
* **Regresión de rendimiento**: Monitorea el uso de recursos y revisa las notas de lanzamiento

Actualizar los nodos no validadores de Plasma es esencial para mantener una infraestructura RPC confiable y segura para las aplicaciones basadas en stablecoins. Seguir procedimientos estructurados de actualización y validación minimiza el riesgo y asegura un rendimiento sin interrupciones.