Pular para o conteúdo principal

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

​
Tipos de Upgrades

Patches de segurança

Correções críticas para proteção da infraestrutura de pagamento

Atualizações de recursos

Novas capacidades para aplicações de pagamento

Otimizações de desempenho

Melhorias para o processamento de transações em alto volume

​
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.
1

Notifique as aplicações

Informe os serviços conectados sobre a manutenção planejada.
2

Verifique a compatibilidade

Garanta que as novas versões do cliente não validador funcionem com os endpoints de consenso atuais.
3

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

Teste os endpoints RPC

Verifique a compatibilidade da aplicação de pagamento após o upgrade.
5

Monitore o processamento de transações

Garanta a operação normal para transferências de USD₮ e operações de gas personalizado.
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.

​
Verificação Pós-Upgrade

Após o upgrade, verifique a sincronização completa com a camada de consenso e valide a funcionalidade principal.
Sincronização de consenso: A altura do bloco está alinhada com a rede
Funcionalidade RPC: Teste os endpoints-chave usados pelas aplicações de pagamento
Baseline de desempenho: Compare as métricas pós-upgrade com baselines anteriores
Monitoramento: Valide se os sistemas de monitoramento e alertas permanecem operacionais
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.

​
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

1

Pare os serviços

Pare os serviços do nó não validador.
2

Reverta imagem e configuração

Reverta para a imagem Docker e configuração anteriores.
3

Reinicie e ressincronize

Reinicie os serviços e ressincronize com a rede.
4

Verifique a funcionalidade

Reteste os endpoints RPC e a funcionalidade de transações.
5

Notifique as equipes

Notifique as equipes de aplicação sobre a restauração.

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