Transición a Agave 2.0: guía para desarrolladores

Introducción

Está previsto que Agave v2.0 debute en Solana Mainnet-Beta durante las semanas posteriores a Solana Breakpoint 2024 Singapore. Esta importante actualización incluye varios cambios incompatibles, eliminaciones de endpoints de API y cambios de nombre de crates que todos los desarrolladores de Solana deben conocer. Además de este artículo, recomendamos que los desarrolladores revisen la guía de transición que Anza publicó recientemente en GitHub.

Agave v2.0 ya está activo en los clústeres Testnet y Devnet de Solana. El lanzamiento marca un hito importante en la evolución del ecosistema de Solana y la transición hacia una red con múltiples clientes. Se espera que el equipo de Anza publique análisis completos y detallados de Agave 2.0 antes del lanzamiento. Este artículo se limitará a los aspectos prácticos de la preparación para la transición.

Endpoints RPC y llamadas del SDK eliminados

Se eliminarán varios endpoints RPC obsoletos y en desuso de Agave v1.

En concreto: 

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

Según un análisis interno de Helius, creemos que la mayoría de nuestros clientes no se verán afectados por estos cambios. Sin embargo, un pequeño grupo todavía usa activamente los siguientes endpoints:

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

El enfoque alternativo para getAccountInfo que aparece en la imagen se puede consultar aquí.

Los cambios incompatibles del SDK incluyen:

• Se eliminó la compatibilidad con Borsh v0.9; usa v1 o v0.10 (#1440)
• El trait Copy ya no se deriva en Rent y EpochSchedule; cambia a clone()
• solana-sdk: se eliminaron los símbolos obsoletos) 
• solana-program: se eliminaron los símbolos obsoletos

Puedes consultar una lista completa de los cambios incompatibles en el registro de cambios de Agave.

Crates renombrados

Se cambiará el nombre de varios crates para facilitar la incorporación de múltiples clientes de validator de Solana, como Firedancer, que estarán administrados por distintos equipos. Al añadir "Agave" a los nombres de estos crates, se los identifica como dependencias mantenidas específicamente por Anza para el cliente de validator Agave. Este cambio permite distinguir con mayor claridad las dependencias relacionadas con Agave de aquellas administradas por otros equipos.

Los crates afectados son: 

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

Los desarrolladores deben buscar referencias a estos crates en sus automatizaciones o scripts y actualizarlas según corresponda.

Argumentos del validator eliminados

Para los operadores de validators, los siguientes argumentos obsoletos del validator se eliminarán con el lanzamiento de 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)

Una vez más, recomendamos que los operadores de validators comprueben detenidamente que estos argumentos ya no estén en uso.

Por último, pero no menos importante, el GitHub original de Solana Labs se archivará cuando se lance Agave v2.0. Los desarrolladores deben migrar todas sus actividades al repositorio de Anza Agave en GitHub.

Para concluir, compartimos las palabras de Nick Frostbutter , del equipo de DevRel de Solana, en un video reciente sobre el registro de cambios: “Si usas algo que muestra una advertencia de obsolescencia, debes asegurarte de actualizar tu código”.

Eso es todo por este breve anuncio de servicio público. ¡Esperamos ver a muchos de ustedes en Breakpoint!