> For the complete documentation index, see [llms.txt](https://docs.aftermath.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aftermath.finance/ko/liquid-staking-afsui/architecture/packages-and-modules.md).

# 패키지 및 모듈

## AftermathLSD 패키지

<figure><img src="https://1494121871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBWRI3CUEvo6lk7n5GNW%2Fuploads%2Fgit-blob-0b5b6b38f634c85bc9200541758c819796bac22d%2FScreenshot%202024-02-22%20at%2011.54.14%20AM.png?alt=media" alt=""><figcaption><p>AftermathLSD 패키지 다이어그램</p></figcaption></figure>

패키지 기능은 여러 모듈에 나뉘어 있습니다. 주요 모듈은 다음과 같습니다.

## staked\_sui\_vault 모듈

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

1. 스테이킹 요청: 사용자가 프로토콜에 SUI 코인을 제공하면 현재 에포크의 SUI <-> AFSUI 환율에 따라 그에 상응하는 수량의 AFSUI를 즉시 받습니다.
2. 언스테이킹 요청: 사용자가 AFSUI를 제공하면 그에 상응하는 수량의 SUI를 받습니다. 두 가지 방식이 있습니다. 일반 언스테이킹은 다음 에포크가 시작될 때 SUI를 받는 방식이고, 원자적(atomic) 언스테이킹은 SUI를 즉시 받는 방식입니다. StakedSui 객체를 다시 스테이킹하는 것도 가능합니다.
3. 에포크 전환 처리: Sui 스테이킹 프레임워크의 워크플로는 에포크 전환 처리와 긴밀하게 결합되어 있습니다. Sui 프레임워크는 매 에포크 사이에 몇 가지 작업을 수행하는데, 가장 중요한 것은 보상 수집과 스테이크 활성화입니다. 이를 프로토콜에 반영하려면 크랭크(crank) 함수를 호출해야 합니다. Sui 프레임워크의 제약 때문에 이 함수를 여러 번 호출해야 할 수 있습니다. 에포크 전환 처리가 완료될 때까지 프로토콜은 미정의 상태이며 작동하지 않습니다. 크랭크 함수를 호출한 주체는 인센티브를 받습니다. 에포크 전환 처리가 원활하게 이루어지도록 Aftermath는 Sui 체인 상태를 모니터링하고 제때 에포크 처리를 시작하는 봇을 운영했습니다.
4. 밸리데이터 수수료 갱신: 프로토콜이 특정 밸리데이터를 인지하고 있으면 해당 밸리데이터는 Operation Capability Object를 받으며, 이 객체로 해당 밸리데이터의 수수료를 변경할 수 있습니다. 밸리데이터 수수료는 발행되는 각 AFSUI에서 차감되어 밸리데이터 주소로 직접 전송됩니다.

<figure><img src="https://1494121871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBWRI3CUEvo6lk7n5GNW%2Fuploads%2Fgit-blob-0c6ad3bdb6ac626ea8ecb66b78025fcc7b4a6442%2FScreenshot%202024-02-22%20at%2011.55.57%20AM.png?alt=media" alt=""><figcaption><p>Aftermath LSD 프로토콜 stake_sui_vault 모듈 다이어그램</p></figcaption></figure>

## actions 모듈

staked\_sui\_vault 모듈 설명에서 다룬 프로토콜의 비즈니스 로직을 구현하는 모듈입니다.

## staked\_sui\_vault\_state 모듈

staked sui vault의 실제 구현을 제공하는 모듈입니다. AFSUI의 발행과 소각 권한을 가지며, 프로토콜 설정도 담당합니다. 주된 역할은 모든 StakedSui 객체와 SUI 잔고를 보관하는 것입니다. StakedSui를 체계적으로 관리하기 위해 Storage 엔티티를 사용합니다.

## storage 모듈

스토리지는 StakedSui 객체를 보관하고 언스테이킹 로직을 구현하는 추상화 계층입니다. 언스테이킹은 프로토콜의 성능을 좌우하기 때문에 LSD 프로토콜의 핵심 요소입니다. 이를 위해 스토리지는 밸리데이터 성과 기준 오름차순으로 정렬된 언스테이킹 큐를 두어, 비활성 상태이거나 성과가 낮은 밸리데이터의 스테이크부터 먼저 언스테이킹합니다. 특정 밸리데이터의 물량이 즉시 고갈되는 것을 막기 위해 각 언스테이킹은 여러 밸리데이터에 분산됩니다.

## validator 모듈

Operation Capability Object 로직을 구현하는 모듈입니다. 이 객체로 특정 밸리데이터의 수수료 값을 변경할 수 있습니다.

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

## Safe 패키지

Safe라는 모듈 하나를 제공하는 패키지입니다. 이 엔티티는 임의 타입의 객체를 저장하고, 권한이 부여된 모듈에 해당 객체의 가변 참조를 제공합니다. 권한은 하나의 모듈에만 부여될 수 있습니다. LSD 프로토콜은 이 엔티티를 사용해 AFSUI Treasury를 저장하고 staked sui vault state 모듈에서의 권한 기반 접근을 제공합니다.

## ReferralVault 패키지

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

## Treasury 패키지

프로토콜은 여러 종류의 수수료를 수취합니다. Treasury 엔티티를 통해 수수료의 특정 부분을 모아 두었다가 나중에 다양한 용도로 사용할 수 있습니다.

## Utilities 패키지

Aftermath의 고성능 수학 프리미티브와 함수 모음입니다.

## LinkedSet 패키지

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

## SuiSytemUtils 패키지

Sui System과 상호작용하기 위한 메서드 모음입니다.
