Transição para o Agave 2.0: um guia para desenvolvedores

Introdução

A estreia do Agave v2.0 na Mainnet-Beta da Solana está programada para as semanas seguintes ao Solana Breakpoint 2024 Singapore. Esta grande atualização contém várias mudanças incompatíveis, remoções de endpoints de API e renomeações de crates que todos os desenvolvedores da Solana devem conhecer. Além deste artigo, recomendamos que os desenvolvedores consultem o guia de transição publicado recentemente pela Anza no GitHub.

O Agave v2.0 já está ativo nos clusters Testnet e Devnet da Solana. O lançamento representa um marco importante na evolução do ecossistema da Solana e na transição para uma rede com múltiplos clientes. Espera-se que a equipe da Anza publique análises abrangentes e detalhadas do Agave 2.0 antes do lançamento. Este artigo se limitará aos aspectos práticos da preparação para a transição.

Endpoints RPC e chamadas de SDK removidos

Vários endpoints RPC obsoletos e descontinuados do Agave v1 serão removidos.

Especificamente: 

• getRecentBlockhash
• getConfirmedSignatureForAddresses2
• getConfirmedTransaction
• getConfirmedBlock
• getStakeActivation
• getFees
• confirmTransaction
• getSignatureStatus
• getSignatureConfirmation
• getTotalSupply
• getConfirmedSignaturesForAddress
• getConfirmedBlocks
• getConfirmedBlocksWithLimit
• getFeeCalculatorForBlockhash
• getFeeRateGovernor
• getSnapshotSlot

Com base em uma análise interna da Helius, acreditamos que a maioria dos nossos clientes não será afetada por essas mudanças. No entanto, um pequeno grupo ainda usa ativamente os seguintes endpoints:

• getRecentBlockhash
• getConfirmedSignatureForAddresses2
• getConfirmedTransaction
• getConfirmedBlock
• getStakeActivation
• getFees

A abordagem alternativa para getAccountInfo mostrada na imagem pode ser encontrada aqui.

As mudanças incompatíveis no SDK incluem:

• O suporte ao Borsh v0.9 foi removido. Use a v1 ou a v0.10 (#1440)
• O trait Copy não é mais derivado em Rent e EpochSchedule; passe a usar clone()
• solana-sdk: símbolos descontinuados) removidos 
• solana-program: símbolos descontinuados removidos

Uma lista completa das mudanças incompatíveis está disponível no changelog do Agave.

Crates renomeados

Vários crates estão sendo renomeados para viabilizar a introdução de vários clientes validadores da Solana, como o Firedancer, que serão gerenciados por equipes diferentes. Ao adicionar "Agave" aos nomes desses crates, eles passam a ser identificados como dependências mantidas especificamente pela Anza para o cliente validador Agave. Essa mudança oferece mais clareza ao diferenciar as dependências relacionadas ao Agave daquelas gerenciadas por outras equipes.

Os crates afetados são: 

• solana-validator
• solana-ledger-tool
• solana-watchtower
• solana-install
• solana-geyser-plugin-interface
• solana-cargo-registry

Os desenvolvedores devem verificar se há referências a esses crates em automações ou scripts e atualizá-las conforme necessário.

Argumentos de validador removidos

Para os operadores de validadores, os seguintes argumentos descontinuados de validador serão removidos com o lançamento do Agave v2.0:

• --enable-rpc-obsolete_v1_7 (#1886)
• --accounts-db-caching-enabled (#2063)
• --accounts-db-index-hashing (#2063)
• --no-accounts-db-index-hashing (#2063)
• --incremental-snapshots (#2148)
• --halt-on-known-validators-accounts-hash-mismatch (#2157)

Mais uma vez, recomendamos que os operadores de validadores verifiquem cuidadosamente se esses argumentos não estão mais em uso.

Por último, mas não menos importante, o GitHub original da Solana Labs será arquivado com o lançamento do Agave v2.0. Os desenvolvedores devem migrar todas as atividades para o repositório Anza Agave no GitHub.

Para concluir, deixamos as palavras de Nick Frostbutter , da equipe de DevRel da Solana, em um vídeo recente de changelog: “Se você estiver usando qualquer recurso que apresente um aviso de descontinuação, precisa garantir que está atualizando seu código.”

Isso é tudo para este breve comunicado de utilidade pública. Esperamos ver muitos de vocês no Breakpoint!