A atualização do Pi Network v24.1 precisa ser concluída até 2 de junho; se perder, será desconectado da mainnet

A Pi Network habilitou o upgrade de protocolo 24.1 em maio e exigiu que todos os operadores de nós concluíssem a migração do v23.0 para o v24.1 antes do prazo de 2 de junho; nós que perderem o prazo poderão ser desconectados da Pi Mainnet e precisarão de uma sincronização completa do zero para voltar a entrar na rede.

Guia operacional para o upgrade v24.1: três métodos confirmados

Método 1 (principal): usuários do Docker atualizem a versão da imagem no arquivo docker-compose.yml para: pinetwork/pi-node-docker:organization_mainnet-v1.0-p24.1.0 e, em seguida, executem docker-compose up -d

Método 2: reinicie o aplicativo do Pi Node no Pi Desktop (Windows / macOS); a versão mais recente acionará a atualização automaticamente.

Método 3: no Linux Node CLI execute pi-node update-protocol, use watch pi-node status para monitorar o status e finalize quando aparecer “已同步” (sincronizado).

Única forma confiável de confirmar que a migração foi concluída: compare o valor ingest_latest_ledger nos nós (o valor via curl). Quando os dois estiverem aproximadamente iguais, a migração foi concluída. Aviso importante: durante o processo de migração esse valor não é atualizado gradualmente; ele só será atualizado de uma vez no final da migração. O fato de o valor permanecer inalterado durante a migração não significa falha da migração.

Quatro regras-chave de operação confirmadas

（来源：Pi Network）

Upgrade em lotes: não atualize todos os nós ao mesmo tempo; faça em etapas. Durante o upgrade, redistribua o tráfego para nós que não estejam sendo atualizados ou para nós de contingência.

Não inicialize v25.1 ou v26.0 por conta própria: essas duas versões foram marcadas como “não iniciar”; é necessário aguardar o sinal oficial de inicialização do time central da Pi.

2 de junho é um prazo fatal (hard deadline): o tempo de migração não deve exceder 5 minutos. O time central da Pi recomenda concluir o mais cedo possível, em vez de esperar até o final.

É obrigatório confirmar no endpoint do livro-razão: não presuma que a migração foi concluída apenas reiniciando o nó; confirme obrigatoriamente comparando o ingest_latest_ledger.

Perguntas frequentes

Qual é a lógica de design da sequência de upgrade da v19→v26 da Pi Network, e por que cada etapa é obrigatória?

A sequência de upgrades da Pi Network é um design linear dependente: cada nova versão de funcionalidade é construída sobre a versão anterior, sem possibilidade de pular etapas. Esse tipo de design garante que toda a rede mantenha, em qualquer momento, a mesma versão de protocolo, impedindo que nós com versões diferentes se comuniquem de forma eficaz. Quanto mais nós antigos ainda estiverem operando na rede, mais lenta será a implantação em toda a rede das funções da nova versão; por isso, prazos fatais foram definidos para assegurar uma transição rápida e geral para a próxima versão. O v23.0 é a etapa mais complexa desta sequência, pois faz upgrade simultâneo do sistema operacional e do banco de dados; o v24.1 avança sobre essa base, integrando as novas versões do Stellar-Core e do Horizon.

Após a atualização do protocolo da Pi Mainnet para v24.1, os recursos de smart contracts e dApp serão ativados?

Não. O time central da Pi confirmou de forma explícita que a ativação de smart contracts e de aplicativos descentralizados (dApp) na Pi Mainnet ainda não foi anunciada oficialmente. O protocolo 23.0 alinha a Pi com o Stellar Core v23, que, no nível técnico, oferece uma base para essas funções; o v24.1 integra ainda o Stellar-Core v24.1.0, seguindo essa mesma linha técnica. Porém, ativar smart contracts e dApp é uma decisão oficial separada que o time central da Pi precisa tomar por conta própria; isso é um evento independente da atualização de versão do protocolo. A sequência atual de upgrades se concentra principalmente na estabilidade da infraestrutura e em otimizações de desempenho.

Se operadores de nós enfrentarem problemas durante o upgrade para v23.0, a dificuldade da migração para v24.1 será igualmente alta?

De acordo com a confirmação do time central da Pi, o v24.1 é uma migração interna padrão, com diferenças fundamentais em relação ao v23.0: no v23.0 é necessário fazer simultaneamente um upgrade do sistema operacional (Ubuntu 20→24), um upgrade do banco de dados (PostgreSQL 12→16) e a migração do protocolo. Além disso, como envolve reescrita dos arquivos do banco de dados, são necessárias medidas de backup antecipadas, e o tempo de inicialização é mais longo; já o v24.1 é apenas uma migração interna de dados, não envolve reescrita de arquivos do banco de dados, não requer etapas especiais de backup e, na maioria dos casos, a migração não excede 5 minutos, com reinício muito mais rápido do que no v23.0. A dificuldade do upgrade v23.0 vem principalmente da complexidade de uma sincronização em camadas; o v24.1 não possui a mesma complexidade.