Packages & Modules

AftermathLSD 패키지

AftermathLSD package diagram

이 패키지의 기능은 여러 모듈 간에 분배됩니다. 주요 모듈은 아래에 설명되어 있습니다:

staked_sui_vault 모듈

이 모듈은 프로토콜과 상호 작용할 수 있는 인터페이스 역할을 합니다. 프로토콜 사용자를 위한 주요 진입점을 제공합니다. 사용자는 다음 기능을 사용할 수 있습니다:

1. 스테이크 요청: 사용자는 SUI 코인을 프로토콜에 제공하고, 현재 에폭의 SUI <-> AFSUI 환율에 따라 해당하는 양의 AFSUI를 즉시 받습니다.

2. 스테이크 해제 요청: 사용자는 AFSUI를 제공하고 해당하는 양의 SUI를 받습니다. 두 가지 가능성이 있습니다. 정규 스테이킹 해제는 사용자가 다음 에폭 시작 시 SUI를 받습니다. 즉시 스테이킹 해제는 사용자가 즉시 SUI를 받습니다. StakedSui 객체를 재스테이킹하는 것도 가능합니다.

3. 에폭 변경 처리: Sui 스테이킹 프레임워크 워크플로우는 에폭 변경 처리와 밀접하게 연결되어 있습니다. Sui 프레임워크가 매 두 에폭 사이에 수행하는 몇 가지 활동이 있습니다. 가장 중요한 것은 보상 수집과 스테이크 활성화입니다. 이를 프로토콜에 반영하기 위해 크랭크 기능이 트리거되어야 합니다. Sui 프레임워크의 제한으로 인해, 이 기능은 여러 번 트리거될 가능성이 큽니다. 에폭 변경이 처리되기 전에 프로토콜은 미정의 상태로 간주되며 작동하지 않습니다. 크랭크 기능을 트리거하면 인센티브 지급을 받습니다. 에폭 변경 처리를 원활하게 하기 위해, Aftermath는 Sui 체인 상태를 모니터링하고 적시에 에폭 처리를 시작하는 봇을 운영했습니다.

4. 검증자 수수료 업데이트: 프로토콜이 특정 검증자를 인지하고 있는 경우, 그 검증자는 검증자 수수료를 변경할 수 있는 운영 능력 객체(Operation Capability Object)를 받습니다. 검증자 수수료는 각각 발행된 AFSUI에서 취해지며, 직접 검증자 주소로 보내집니다.

Aftermath LSD Protocol stake_sui_vault module diagram

actions 모듈

이 모듈은 staked_sui_vault 모듈 설명에서 이전에 논의된 프로토콜의 비즈니스 로직을 구현합니다.

staked_sui_vault_state 모듈

이 모듈은 staked sui vault의 실제 구현을 제공합니다. AFSUI를 발행하고 소각할 권한이 있으며, 프로토콜 구성도 담당합니다. 주요 목적은 모든 StakedSui 객체와 SUI 잔액을 유지하는 것입니다. StakedSuis를 조직화하기 위해 Storage 엔티티가 사용됩니다.

storage 모듈

storage는 StakedSui 객체를 유지하고 스테이킹 해제 로직을 구현하는 추상화입니다. 스테이킹 해제는 LSD 프로토콜의 핵심 부분이며, 어떤 의미에서는 프로토콜 성능을 정의합니다. 이를 제공하기 위해 storage에는 성능 순으로 정렬된 스테이킹 해제 큐가 있어, 비활성 및 저성능 검증자로부터의 스테이크가 우선적으로 스테이킹 해제됩니다. 즉시 검증자를 고갈시키지 않기 위해, 각 스테이킹 해제는 여러 검증자 간에 분배됩니다.

validator 모듈

이 모듈은 Operation Capability Object 로직을 구현합니다. 이 객체는 특정 검증자에 대한 검증자 수수료 값을 변경할 수 있습니다.

Aftermath LSD 프로토콜은 여러 추가 패키지를 사용합니다.

안전 패키지

이 패키지는 Safe라는 모듈을 제공합니다. 이 엔티티는 어떤 타입의 객체도 저장할 수 있으며, 해당 객체에 대한 변경 가능한 참조를 인증된 모듈에게만 제공합니다. 오직 하나의 모듈만이 인증될 수 있습니다. LSD 프로토콜은 이 엔티티를 사용하여 AFSUI Treasury를 저장하고 스테이크된 sui 볼트 상태 모듈로부터 인증된 접근을 제공합니다.

추천 볼트 패키지

Aftermath LSD 프로토콜 사용자는 추천 시스템을 이용할 수 있습니다. 이 모듈은 추천인 - 피추천인 관계를 관리하고 로열티를 수집하는 로직을 제공합니다.

재무 패키지

프로토콜은 여러 유형의 수수료를 수집합니다. Treasury 엔티티는 수수료의 특정 부분을 수집하고 나중에 다양한 목적으로 사용할 수 있게 합니다.

유틸리티 패키지

Aftermath는 고성능 수학 프리미티브와 함수의 컬렉션입니다.

연결 세트 패키지

LinkedSet은 Sui 프레임워크의 LinkedTable 구현을 기반으로 합니다. 이 엔티티는 언스테이킹 큐를 구현하는 데 사용됩니다.

SuiSystemUtils 패키지

Sui 시스템과의 상호작용을 위한 메소드 컬렉션입니다.