Atualizando o Runtime da Sua Appchain com Sudo¶
Introdução¶
Sudo é um módulo que permite que chamadas de tempo de execução privilegiadas sejam despachadas quando chamadas da conta Sudo. Sudo é por vezes coloquialmente referido como um superusuário ou uma conta semelhante a um deus. Isso permite que você realize ações privilegiadas no curso do gerenciamento da sua appchain, como a atualização do tempo de execução da sua appchain com tecnologia Tanssi.
Neste guia, você aprenderá como usar o Sudo para atualizar o runtime da sua appchain. Com acesso Sudo, atualizar sua cadeia é um processo rápido e fácil. Observe que as equipas de appchain em produção terão a opção de eliminar gradualmente o acesso Sudo e confiar na governança para processar as atualizações de tempo de execução.
Verificando os Pré-Requisitos¶
Para o exemplo neste guia, você precisará ter o seguinte:
- Uma appchain com tecnologia Tanssi (Quick Trial, Dedicated ou MainNet).
- A conta Sudo da sua appchain conectada ao portal do desenvolvedor da sua appchain. Você pode consultar o guia de Gerenciamento do Sudo para obter instruções sobre como injetar a sua conta Sudo no portal do desenvolvedor.
- O novo ficheiro binário de runtime Wasm, compilado com uma versão superior à atual.
Se você não souber qual é a conta Sudo da sua rede Tanssi, é possível encontrá‑la no Tanssi Dashboard na seção Properties.
Warning
É fundamental proteger a chave da sua conta Sudo com o máximo de cuidado, pois ela concede acesso privilegiado à sua rede Tanssi.
Obtendo o Runtime Wasm¶
Se a sua cadeia for baseada em um dos modelos oficiais, você pode baixar o arquivo binário oficial de runtime Wasm na tabela abaixo. Os lançamentos oficiais são publicados na seção de lançamentos no repositório Tanssi.
Você deve sempre atualizar o tempo de execução seguindo as versões de forma ordenada, aplicando uma versão após a outra sem pular nenhuma delas. Para isso, você precisa saber a versão atual do tempo de execução da sua appchain, que você encontrará no seu Tanssi Dashboard na seção Propriedades. Por exemplo, se a versão do seu tempo de execução for 1000, você deverá atualizar primeiro para 1100, depois para 1201, depois para 1300 e assim por diante até a versão mais recente disponível.
Atenção
Aplicar as atualizações em ordem garante que as alterações (migrações) nas estruturas de dados internas sejam aplicadas, preservando a consistência dos dados. Caso contrário, pode paralisar sua appchain.
Nota
Se estiver compilando o tempo de execução manualmente, certifique-se de usar a versão Wasm compact e compressed, que é otimizada e mais leve.
Atualizando Seu Runtime¶
Para começar, acesse o portal do desenvolvedor da sua appchain Tanssi, que pode ser encontrado no seu Tanssi Dashboard na seção Ferramentas.
Atenção
Se a sua appchain foi implantada usando um modelo oficial e a atualização pretendida é um runtime personalizado, certifique-se de ter alterado o nome padrão da especificação (frontier-template ou container-chain-template) para um diferente antes de construir o arquivo Wasm. Você também precisará executar a extrínseca setCodeWithoutChecks em vez de setCode.
Com o seu tempo de execução Wasm pronto para ser carregado e a sua conta Sudo acessível no portal do desenvolvedor, siga as seguintes etapas:
- Navegue até a aba Desenvolvedor do portal do desenvolvedor da sua appchain Tanssi.
- Clique em Sudo. Se você não vir Sudo neste menu, é porque você não associou a conta Sudo ao portal do desenvolvedor. Certifique-se de que a sua conta Sudo está injetada pela sua carteira e conectada ao portal do desenvolvedor.
- Selecione o pallet system.
- Selecione setCode.
- Alterne a chave fileUpload para habilitar o upload do seu arquivo de runtime Wasm.
- Faça o upload do seu runtime Wasm.
- Pressione Enviar Sudo e confirme a transação na sua carteira.
Você pode verificar se a atualização do seu runtime foi bem-sucedida verificando a versão do runtime no canto superior esquerdo. Nesse caso, você pode ver que o runtime da appchain com tecnologia Tanssi foi atualizado com sucesso para a versão 400.
E é isso! A seção portal do desenvolvedor tem muitos outros guias sobre como gerenciar sua appchain Tanssi.
| Criada: 9 de dezembro de 2025