Agave 2.0 전환: 개발자 가이드

소개

Agave v2.0은 Solana Breakpoint 2024 Singapore 이후 몇 주 내에 Solana Mainnet-Beta에 처음 도입될 예정입니다. 이번 주요 업데이트에는 모든 Solana 개발자가 알아야 할 여러 호환성 파괴 변경 사항, API 엔드포인트 제거, 크레이트 이름 변경이 포함됩니다. 이 글과 함께 Anza가 최근 GitHub에 공개한 전환 가이드도 검토하시길 권장합니다.

Agave v2.0은 현재 Solana의 Testnet 및 Devnet 클러스터에서 운영되고 있습니다. 이번 릴리스는 Solana 생태계의 발전과 멀티 클라이언트 네트워크로의 전환에서 중요한 이정표입니다. Anza 팀은 출시 전에 Agave 2.0에 대한 포괄적이고 심층적인 분석을 공개할 예정입니다. 이 글에서는 실질적인 전환 준비 사항만 다룹니다.

제거되는 RPC 엔드포인트 및 SDK 호출

더 이상 사용되지 않거나 지원 중단된 여러 v1 Agave RPC 엔드포인트가 제거될 예정입니다.

해당 항목은 다음과 같습니다: 

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

Helius의 내부 분석에 따르면 대부분의 고객은 이러한 변경 사항의 영향을 받지 않을 것으로 판단됩니다. 다만 일부 고객은 여전히 다음 엔드포인트를 사용하고 있습니다:

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

이미지에 표시된 getAccountInfo의 대체 방법은 여기에서 확인할 수 있습니다.

SDK의 호환성 파괴 변경 사항은 다음과 같습니다:

• Borsh v0.9 지원이 제거되었습니다. v1 또는 v0.10을 사용하세요(#1440)
• Rent 및 EpochSchedule에서 Copy 트레이트가 더 이상 파생되지 않습니다. **clone()**을 사용하도록 전환하세요
• solana-sdk: 지원 중단된 심볼)이 제거되었습니다 
• solana-program: 지원 중단된 심볼이 제거되었습니다

호환성 파괴 변경 사항의 전체 목록은 Agave 변경 로그에서 확인할 수 있습니다.

이름이 변경되는 크레이트

서로 다른 팀이 관리하는 Firedancer 같은 여러 Solana 검증인 클라이언트의 도입을 지원하기 위해 일부 크레이트의 이름이 변경됩니다. 크레이트 이름에 "Agave"를 추가하면 해당 크레이트가 Anza에서 Agave 검증인 클라이언트용으로 관리하는 종속성임을 명확히 식별할 수 있습니다. 이를 통해 Agave 관련 종속성과 다른 팀에서 관리하는 종속성을 더 명확하게 구분할 수 있습니다.

영향을 받는 크레이트는 다음과 같습니다: 

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

개발자는 모든 자동화 또는 스크립트에서 이러한 크레이트를 참조하는 부분이 있는지 확인하고 적절히 업데이트해야 합니다.

제거되는 검증인 인수

검증인 운영자의 경우 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)

다시 한번, 검증인 운영자는 이러한 인수가 더 이상 사용되지 않는지 신중하게 확인하시길 권장합니다.

마지막으로 Agave v2.0이 출시되면 기존 Solana Labs GitHub는 보관 처리됩니다. 개발자는 모든 활동을 Anza Agave GitHub 리포지토리로 이전해야 합니다.

마무리하며 Solana DevRel 팀의 Nick Frostbutter 가 최근 변경 로그 영상에서 전한 말을 소개합니다. “지원 중단 경고가 표시된 기능을 사용하고 있다면 반드시 코드를 업그레이드해야 합니다.”

이상으로 짧은 안내를 마칩니다. Breakpoint에서 많은 분을 만나 뵙기를 바랍니다!