Chuyển đổi sang Agave 2.0: Hướng dẫn dành cho nhà phát triển

Giới thiệu

Agave v2.0 dự kiến sẽ ra mắt trên Solana Mainnet-Beta trong những tuần sau Solana Breakpoint 2024 Singapore. Bản cập nhật lớn này có nhiều thay đổi gây mất tương thích, loại bỏ điểm cuối API và đổi tên crate mà mọi nhà phát triển Solana cần lưu ý. Ngoài bài viết này, chúng tôi khuyến nghị các nhà phát triển xem hướng dẫn chuyển đổi do Anza phát hành gần đây trên GitHub.

Agave v2.0 hiện đã hoạt động trên các cụm Testnet và Devnet của Solana. Bản phát hành này đánh dấu một cột mốc quan trọng trong quá trình phát triển hệ sinh thái Solana và chuyển đổi sang mạng đa client. Đội ngũ Anza dự kiến sẽ công bố các bài phân tích toàn diện, chuyên sâu về Agave 2.0 trước khi ra mắt. Bài viết này chỉ tập trung vào các khía cạnh thực tế của quá trình chuẩn bị chuyển đổi.

Các điểm cuối RPC và lệnh gọi SDK bị loại bỏ

Nhiều điểm cuối RPC Agave v1 đã lỗi thời và không còn được khuyến nghị sử dụng sẽ bị loại bỏ.

Cụ thể: 

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

Dựa trên phân tích nội bộ của Helius, chúng tôi cho rằng phần lớn khách hàng sẽ không bị ảnh hưởng bởi những thay đổi này. Tuy nhiên, một nhóm nhỏ vẫn đang tích cực sử dụng các điểm cuối sau:

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

Phương pháp thay thế cho getAccountInfo trong hình có thể được tìm thấy tại đây.

Các thay đổi gây mất tương thích trong SDK bao gồm:

• Đã loại bỏ hỗ trợ Borsh v0.9, vui lòng sử dụng v1 hoặc v0.10 (#1440)
• Trait Copy không còn được tự động dẫn xuất trên Rent và EpochSchedule; hãy chuyển sang sử dụng clone()
• solana-sdk: đã loại bỏ các ký hiệu không còn được khuyến nghị sử dụng) 
• solana-program: đã loại bỏ các ký hiệu không còn được khuyến nghị sử dụng

Bạn có thể xem danh sách đầy đủ các thay đổi gây mất tương thích trong nhật ký thay đổi của Agave.

Các crate được đổi tên

Một số crate đang được đổi tên để hỗ trợ việc ra mắt nhiều client trình xác thực Solana, chẳng hạn như Firedancer, do các đội ngũ khác nhau quản lý. Việc thêm "Agave" vào tên các crate này giúp xác định đây là những dependency được Anza duy trì riêng cho client trình xác thực Agave. Thay đổi này giúp phân biệt rõ hơn các dependency liên quan đến Agave với những dependency do các đội ngũ khác quản lý.

Các crate bị ảnh hưởng gồm: 

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

Các nhà phát triển nên kiểm tra mọi quy trình tự động hoặc script để tìm tham chiếu đến các crate này và cập nhật chúng cho phù hợp.

Các tham số trình xác thực bị loại bỏ

Đối với đơn vị vận hành trình xác thực, các tham số trình xác thực không còn được khuyến nghị sử dụng sau đây sẽ bị loại bỏ khi Agave v2.0 được phát hành:

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

Một lần nữa, chúng tôi khuyến nghị các đơn vị vận hành trình xác thực kiểm tra kỹ để đảm bảo những tham số này không còn được sử dụng.

Cuối cùng nhưng không kém phần quan trọng, GitHub Solana Labs ban đầu sẽ được lưu trữ khi Agave v2.0 được phát hành. Các nhà phát triển nên chuyển mọi hoạt động sang kho lưu trữ GitHub Anza Agave.

Để kết lại, xin trích lời Nick Frostbutter thuộc đội ngũ DevRel của Solana trong một video nhật ký thay đổi gần đây: “Nếu đang sử dụng bất kỳ thứ gì có cảnh báo ngừng hỗ trợ, bạn cần đảm bảo nâng cấp mã của mình.”

Thông báo ngắn dành cho cộng đồng đến đây là hết. Hy vọng sẽ gặp nhiều bạn tại Breakpoint!