> ## 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.

# Upgrades

> Atualizações de software, upgrades de consenso e manutenção

## Por Que os Upgrades Importam

A arquitetura da Plasma evolui rapidamente para dar suporte a casos de uso nativos de stablecoins de alto throughput. Upgrades pontuais:

* Protegem contra vulnerabilidades de segurança
* Melhoram o desempenho para cargas de trabalho de pagamento
* Mantêm a compatibilidade com a camada de consenso da Plasma e a interface RPC

Nós desatualizados podem apresentar falhas de sincronização, desempenho degradado ou problemas de segurança. Como os nós não validadores frequentemente atendem tráfego RPC crítico para aplicações de pagamento, manter-se atualizado é essencial.

<Note>
  A maioria dos upgrades de nós não validadores requer de 15 a 30 minutos de downtime. Releases maiores que introduzem novos recursos ou mudanças de consenso podem exigir janelas mais longas de sincronização.
</Note>

## Tipos de Upgrades

<Columns cols={3}>
  <Card title="Patches de segurança" href="#security-patches">
    Correções críticas para proteção da infraestrutura de pagamento
  </Card>

  <Card title="Atualizações de recursos" href="#feature-updates">
    Novas capacidades para aplicações de pagamento
  </Card>

  <Card title="Otimizações de desempenho" href="#performance-optimisations">
    Melhorias para o processamento de transações em alto volume
  </Card>
</Columns>

### Patches de Segurança

Os patches de segurança abordam vulnerabilidades em clientes não validadores, Reth ou dependências.

**Exemplos:**

* Vulnerabilidades de inconsistência de estado ou dessincronização de consenso
* Correções de controle de acesso e autenticação de RPC
* Atualizações de bibliotecas criptográficas

Esses devem ser aplicados imediatamente após o lançamento.

### Atualizações de Recursos

Lançamentos de recursos habilitam novas capacidades de protocolo ou dão suporte a novos padrões de aplicação.

**Exemplos:**

* Aprimoramentos de transferências de USD₮ sem taxa
* Suporte a tokens de gas personalizados
* Métodos RPC novos ou estendidos
* Otimizações de consulta de estado
* Melhorias na integração com wallets e exchanges

### Otimizações de Desempenho

Lançamentos focados em desempenho melhoram a velocidade de execução, eficiência de sincronização e uso de recursos.

**Exemplos:**

* Leituras e gravações mais rápidas no banco de dados
* Redução da latência de RPC sob carga
* Melhor eficiência de memória e CPU
* Melhorias na sincronização do consenso

## Procedimento de Upgrade

Os upgrades de nó não validador tipicamente envolvem fazer pull de uma nova imagem Docker, atualizar configurações e reiniciar o serviço.

<Steps>
  <Step title="Notifique as aplicações">
    Informe os serviços conectados sobre a manutenção planejada.
  </Step>

  <Step title="Verifique a compatibilidade">
    Garanta que as novas versões do cliente não validador funcionem com os endpoints de consenso atuais.
  </Step>

  <Step title="Atualize a configuração">
    Aplique quaisquer novas opções de configuração para recursos aprimorados. Preste atenção especial às mudanças que afetam o suporte a tokens de gas personalizados, processamento de transações sem taxa ou interfaces RPC de aplicações de pagamento.
  </Step>

  <Step title="Teste os endpoints RPC">
    Verifique a compatibilidade da aplicação de pagamento após o upgrade.
  </Step>

  <Step title="Monitore o processamento de transações">
    Garanta a operação normal para transferências de USD₮ e operações de gas personalizado.
  </Step>
</Steps>

<Tip>
  Implante upgrades em estágios ao operar vários nós não validadores. Comece com instâncias não críticas antes de atualizar a infraestrutura de pagamento principal, e monitore o primeiro nó atualizado com cuidado antes de prosseguir.
</Tip>

## Verificação Pós-Upgrade

Após o upgrade, verifique a sincronização completa com a camada de consenso e valide a funcionalidade principal.

<Check>**Sincronização de consenso**: A altura do bloco está alinhada com a rede</Check>
<Check>**Funcionalidade RPC**: Teste os endpoints-chave usados pelas aplicações de pagamento</Check>
<Check>**Baseline de desempenho**: Compare as métricas pós-upgrade com baselines anteriores</Check>
<Check>**Monitoramento**: Valide se os sistemas de monitoramento e alertas permanecem operacionais</Check>

<Tip>
  Documente as mudanças de configuração e o comportamento observado. Isso melhora a confiabilidade para futuros upgrades e solução de problemas. Para problemas comuns, consulte o [guia de solução de problemas](./troubleshooting).
</Tip>

## Procedimentos de Rollback

### Quando Fazer Rollback

Faça rollback se observar:

* Falha de sincronização de consenso
* Degradação severa de desempenho de RPC
* Incompatibilidade de aplicação
* Regressão de segurança
* Inconsistência de dados afetando saldos ou transferências

### Como Fazer Rollback

<Steps>
  <Step title="Pare os serviços">
    Pare os serviços do nó não validador.
  </Step>

  <Step title="Reverta imagem e configuração">
    Reverta para a imagem Docker e configuração anteriores.
  </Step>

  <Step title="Reinicie e ressincronize">
    Reinicie os serviços e ressincronize com a rede.
  </Step>

  <Step title="Verifique a funcionalidade">
    Reteste os endpoints RPC e a funcionalidade de transações.
  </Step>

  <Step title="Notifique as equipes">
    Notifique as equipes de aplicação sobre a restauração.
  </Step>
</Steps>

## Melhores Práticas

### Automação e Monitoramento

* Automatize pulls de imagem e atualizações de configuração quando possível
* Acompanhe alterações com configuração versionada
* Aprimore a observabilidade durante os upgrades
* Monitore atentamente taxas de erro de RPC, status de sincronização e throughput de transações após reinicializações

## Solução de Problemas Comuns

Se ocorrerem problemas após o upgrade:

* **Sincronização de consenso**: Verifique a conectividade de endpoints, credenciais e status de allowlist
* **Erros de RPC**: Valide a configuração, compatibilidade de versão e interfaces atualizadas
* **Regressão de desempenho**: Monitore o uso de recursos e revise as notas de lançamento

A atualização de nós não validadores da Plasma é essencial para manter uma infraestrutura RPC confiável e segura para aplicações baseadas em stablecoins. Seguir procedimentos estruturados de upgrade e validação minimiza o risco e garante desempenho contínuo.