Transition vers Agave 2.0 : guide pour les développeurs

Introduction

Le lancement d’Agave v2.0 sur Solana Mainnet-Beta est prévu dans les semaines suivant Solana Breakpoint 2024 Singapore. Cette mise à jour majeure comprend plusieurs changements incompatibles, des suppressions de points de terminaison API et des renommages de crates dont tous les développeurs Solana doivent prendre connaissance. En complément de cet article, nous recommandons aux développeurs de consulter le guide de transition récemment publié par Anza sur GitHub.

Agave v2.0 est actuellement disponible sur les clusters Testnet et Devnet de Solana. Cette version marque une étape importante dans l’évolution de l’écosystème Solana et sa transition vers un réseau multiclient. L’équipe d’Anza devrait publier des analyses complètes et approfondies d’Agave 2.0 avant son lancement. Cet article se limitera aux aspects pratiques de la préparation à la transition.

Points de terminaison RPC et appels SDK supprimés

Plusieurs points de terminaison RPC obsolètes et dépréciés d’Agave v1 vont être supprimés.

À savoir : 

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

D’après une analyse interne de Helius, nous pensons que la plupart de nos clients ne seront pas affectés par ces changements. Cependant, un petit groupe utilise encore activement les points de terminaison suivants :

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

L’approche alternative pour getAccountInfo présentée dans l’image est disponible ici.

Les changements incompatibles du SDK comprennent :

• Suppression de la prise en charge de Borsh v0.9 ; utilisez la v1 ou la v0.10 (#1440)
• Le trait Copy n’est plus dérivé pour Rent et EpochSchedule ; utilisez désormais clone()
• solana-sdk : suppression des symboles dépréciés) 
• solana-program : suppression des symboles dépréciés

La liste complète des changements incompatibles est disponible dans le journal des modifications d’Agave.

Crates renommées

Plusieurs crates sont renommées pour accompagner l’arrivée de plusieurs clients de validation Solana, tels que Firedancer, qui seront gérés par différentes équipes. L’ajout d’« Agave » au nom de ces crates permet de les identifier comme des dépendances spécifiquement maintenues par Anza pour le client de validation Agave. Ce changement permet de distinguer plus clairement les dépendances liées à Agave de celles gérées par d’autres équipes.

Les crates concernées sont : 

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

Les développeurs doivent rechercher les références à ces crates dans leurs automatisations et scripts, puis les mettre à jour en conséquence.

Arguments de validateur supprimés

Pour les opérateurs de validateurs, les arguments de validateur dépréciés suivants seront supprimés lors de la sortie d’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)

Là encore, nous recommandons aux opérateurs de validateurs de vérifier soigneusement que ces arguments ne sont plus utilisés.

Enfin, le dépôt GitHub original de Solana Labs sera archivé lors de la sortie d’Agave v2.0. Les développeurs doivent transférer toutes leurs activités vers le dépôt GitHub d’Anza Agave.

Pour conclure, voici les mots de Nick Frostbutter , membre de l’équipe DevRel de Solana, dans une récente vidéo du journal des modifications : « Si vous utilisez un élément accompagné d’un avertissement de dépréciation, vous devez impérativement mettre votre code à jour. »

Voilà qui conclut cette courte annonce d’intérêt général. Nous espérons vous retrouver nombreux à Breakpoint !