A Pi Network ativou a actualização de protocolo 24.1 em maio, exigindo que todos os fornecedores de nós concluam a migração de v23.0 para v24.1 antes do prazo de 2 de junho. Os nós que falhem o prazo poderão ficar desligados da Pi mainnet e precisarão de se sincronizar totalmente de novo para poderem voltar a integrar a rede.
Guia operacional para a actualização v24.1: três métodos já confirmados
Método 1 (método principal): utilizadores Docker actualizem a versão da imagem no 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: reiniciar a aplicação Pi Node no Pi Desktop (Windows / macOS); a versão mais recente irá accionar automaticamente a actualização.
Método 3: Linux Node CLI executa pi-node update-protocol e usa watch pi-node status para monitorizar o estado; quando mostrar «sincronizado», concluir.
Único método fiável para confirmar que a migração terminou: comparar o valor ingest_latest_ledger no nó (o valor no curl); quando os dois valores forem aproximadamente iguais, significa que a migração está concluída. Nota importante: durante o processo de migração, este valor não é atualizado progressivamente — é atualizado de uma só vez apenas no final da migração — e o valor permanecerá inalterado durante a migração não significa que esta tenha falhado.
Quatro regras operacionais-chave já confirmadas
（Fonte：Pi Network）
Actualização por fases: não actualize todos os nós ao mesmo tempo; faça-o por etapas. Durante a actualização, transfira o tráfego para nós que não estejam a ser actualizados ou para nós de reserva
Não iniciar v25.1 nem v26.0 por conta própria: estas duas versões foram sinalizadas como «não iniciar»; é necessário aguardar o sinal oficial de arranque da equipa central da Pi
2 de junho é um prazo final rígido: o tempo de migração não deve exceder 5 minutos; a equipa central da Pi recomenda concluir o mais cedo possível, em vez de esperar até ao fim
É obrigatório confirmar a conclusão através do endpoint do livro-razão: não assuma apenas que a migração está concluída com o reinício do nó; é indispensável confirmar comparando ingest_latest_ledger
Perguntas frequentes
Qual é a lógica de conceção da sequência de actualização Pi Network de v19→v26 e por que razão cada passo é obrigatório?
A sequência de actualização da Pi Network é uma conceção linear com dependências: cada funcionalidade de uma nova versão é construída com base na versão anterior, não sendo possível saltar etapas. Esta conceção garante que toda a rede mantém, em qualquer momento, a mesma versão de protocolo, evitando que nós com versões diferentes não consigam comunicar de forma eficaz. Quanto maior o número de nós que ainda executam versões antigas na rede, mais lento será o deployment de funcionalidades da nova versão em toda a rede. Por isso, os prazos finais obrigatórios visam assegurar a transição rápida de toda a rede para a próxima versão. O v23.0 é o passo mais complexo desta sequência, com actualizações simultâneas do sistema operativo e da base de dados; o v24.1 avança a partir desta base, integrando as novas versões do Stellar-Core e do Horizon.
Depois de actualizar o protocolo da Pi mainnet para v24.1, as funcionalidades de contratos inteligentes e dApp serão activadas?
Não. A equipa central da Pi confirmou de forma explícita que a activação de contratos inteligentes e de aplicações descentralizadas (dApp) na Pi mainnet ainda não foi anunciada oficialmente. O protocolo 23.0 alinha a Pi com o Stellar Core v23, que a nível técnico fornece a base para estas funcionalidades. O v24.1 integra ainda o Stellar-Core v24.1.0, dando continuidade a esta via técnica; contudo, activar contratos inteligentes e dApps é uma decisão oficial separada que a equipa central da Pi precisa de tomar, independentemente da actualização de versão do protocolo. A sequência de actualização actual foca-se sobretudo na estabilidade da infraestrutura e na otimização de desempenho.
Se um fornecedor de nós tiver problemas durante a actualização v23.0, a dificuldade da migração para v24.1 será semelhante?
De acordo com a confirmação da equipa central da Pi, o v24.1 é uma migração padrão de dados internos, com diferenças fundamentais face ao v23.0: no v23.0 é necessária uma atualização simultânea do sistema operativo (Ubuntu 20→24), da base de dados (PostgreSQL 12→16) e da migração de protocolo. Além disso, como envolve reescrita dos ficheiros da base de dados, é necessário efetuar previamente medidas de cópia de segurança para prevenção, e o tempo de arranque é mais longo. O v24.1 é uma migração simples de dados internos, não envolve reescrita de ficheiros de base de dados, não requer passos especiais de cópia de segurança e, na maioria dos casos, a migração não ultrapassa 5 minutos; o reinício também é muito mais rápido do que no v23.0. A dificuldade da actualização v23.0 resulta principalmente da complexidade de sincronizações de múltiplas camadas; o v24.1 não tem a mesma complexidade.
