Umstieg auf Agave 2.0: Ein Leitfaden für Entwickler

Einführung

Agave v2.0 soll laut Zeitplan in den Wochen nach dem Solana Breakpoint 2024 in Singapur auf Solana Mainnet-Beta starten. Dieses große Update enthält mehrere Breaking Changes, entfernt API-Endpunkte und benennt Crates um. Alle Solana-Entwickler sollten diese Änderungen kennen. Zusätzlich zu diesem Artikel empfehlen wir Entwicklern, Anzas kürzlich veröffentlichten Leitfaden für den Umstieg auf GitHub zu lesen.

Agave v2.0 läuft derzeit auf den Testnet- und Devnet-Clustern von Solana. Das Release markiert einen wichtigen Meilenstein für die Entwicklung des Solana-Ökosystems und den Übergang zu einem Multi-Client-Netzwerk. Das Anza-Team wird voraussichtlich vor dem Start umfassende und detaillierte Analysen zu Agave 2.0 veröffentlichen. Dieser Artikel beschränkt sich auf die praktischen Aspekte der Vorbereitung auf den Umstieg.

Entfernte RPC-Endpunkte und SDK-Aufrufe

Mehrere veraltete und nicht mehr empfohlene RPC-Endpunkte aus Agave v1 werden entfernt.

Im Einzelnen: 

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

Auf Grundlage einer internen Analyse von Helius gehen wir davon aus, dass die meisten unserer Kunden von diesen Änderungen nicht betroffen sein werden. Eine kleine Gruppe verwendet die folgenden Endpunkte jedoch weiterhin aktiv:

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

Den im Bild gezeigten alternativen Ansatz für getAccountInfo findest du hier.

Zu den Breaking Changes im SDK gehören:

• Unterstützung für Borsh v0.9 entfernt; verwende bitte v1 oder v0.10 (#1440)
• Der Copy-Trait wird nicht mehr abgeleitet für Rent und EpochSchedule; verwende stattdessen clone()
• solana-sdk: veraltete Symbole) entfernt 
• solana-program: veraltete Symbole entfernt

Eine vollständige Liste der Breaking Changes findest du im Agave-Changelog.

Umbenannte Crates

Mehrere Crates werden umbenannt, um die Einführung mehrerer Solana-Validator-Clients wie Firedancer zu berücksichtigen, die von verschiedenen Teams verwaltet werden. Durch das Anhängen von „Agave“ an diese Crate-Namen werden die Crates als Abhängigkeiten gekennzeichnet, die Anza speziell für den Agave-Validator-Client pflegt. So lassen sich Agave-bezogene Abhängigkeiten klarer von denen anderer Teams unterscheiden.

Betroffen sind folgende Crates: 

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

Entwickler sollten alle Automatisierungen und Skripte auf Verweise zu diesen Crates prüfen und sie entsprechend aktualisieren.

Entfernte Validator-Argumente

Für Validator-Betreiber werden mit der Veröffentlichung von Agave v2.0 die folgenden veralteten Validator-Argumente entfernt:

• --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)

Auch hier empfehlen wir Validator-Betreibern, sorgfältig zu prüfen, dass diese Argumente nicht mehr verwendet werden.

Zu guter Letzt wird das ursprüngliche GitHub-Repository von Solana Labs mit der Veröffentlichung von Agave v2.0 archiviert. Entwickler sollten alle Aktivitäten in das Anza-Agave-Repository auf GitHub verlagern.

Zum Abschluss geben wir dir die Worte von Nick Frostbutter aus dem Solana-DevRel-Team in einem kürzlich veröffentlichten Changelog-Video mit auf den Weg: „Wenn du etwas verwendest, das eine Warnung wegen veralteter Funktionen ausgibt, musst du deinen Code unbedingt aktualisieren.“

Das war unsere kurze öffentliche Bekanntmachung. Wir hoffen, viele von euch beim Breakpoint zu sehen!