> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superearn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Super Vault

> EarnUSDT를 뒷받침하며 전략·체인 간 자금을 라우팅하는 Kaia의 메인 집계 볼트

<Note>
  이 문서는 Super Vault의 개념적 역할에 집중합니다. 함수 단위 상세·컨트랙트 인터페이스는
  <a href="/ko/developers/core-components"><strong>Core Components</strong></a>,
  <a href="/ko/developers/integrate-earn-usdt"><strong>Integrate EarnUSDT</strong></a>에서 확인하세요.
</Note>

## Summary

Super Vault는 **EarnUSDT** 뒤에 있는 단일 풀 포트폴리오로, 복잡한 작업을 대신 처리합니다.
Cooldown Vault에서 사용자 자금을 모아 Kaia 네이티브·멀티체인 전략에 배분하고, EarnUSDT 지분 가격을 결정하는 단일 포트폴리오 가치를 제공합니다.

1. **유동성 관리 & RWA 준비**:
   **쿨다운 윈도우**로 출금을 미리 계획해, 유동성이 낮은 DeFi·RWA 전략을 안전히 활용하면서도 사용자 출금을 대응합니다.

2. **Runespear 기반 멀티체인 집계**:
   자본을 다른 체인(예: Ethereum)으로 브릿지하고 다시 회수하며, Runespear로 보수적이고 동기화된 회계를 유지합니다.

3. **단일 팜이 아닌 전략 엔진**:
   예치는 여러 온체인 전략(Kaia DeFi + 멀티체인)으로 분산되며, 하나의 수익원만 쫓기보다 시간이 지나며 배분을 조정합니다.

4. **거버넌스·수수료·리스크 제어**:
   역할 기반 권한, 헬스체크, 손실 한도, 일시정지 스위치, 자동 수수료 로직(운용/성과 수수료, 현재 0%)이 온체인에서 적용되어 운영을 통제하고 사용자 수익을 투명하게 합니다.

***

## 1. 볼트 스택 내 역할

Kaia 쪽 스택은 다음과 같습니다:

```text theme={null}
User ↔ Cooldown Vault ↔ Super Vault ↔ { Kaia strategies, OriginVault ↔ RemoteVault ↔ remote strategies }
```

**Cooldown Vault (Kaia)**

* 사용자 입·출금 풀.
* **SuperEarnRouter**를 통해서만 접근 가능하며, 직접 입·출금 엔트리는 없습니다.
* 쿨다운, 손실 한도 등 사용자 안전 정책을 적용합니다.
* 최종적으로 Super Vault와 연결 볼트의 지분 가격을 바탕으로 **EarnUSDT**를 민트/소각합니다.

**Super Vault (Kaia)**

* 집계 레이어:

  * Cooldown Vault에서 자본을 수집하고,
  * Kaia에 얼마나 두고 멀티체인 전략에 얼마나 보낼지 결정하며,
  * Kaia 측 포트폴리오가 목표 배분·리스크 한도에 맞도록 유지합니다.
* 개념적으로 EarnUSDT 가치를 뒷받침하는 “단일 포트폴리오” 입니다.

**OriginVault (Kaia, ERC‑7540 유사)**

* Kaia를 떠나는 자본의 크로스체인 허브.
* 다른 체인 전략용 USDT를 보유합니다.
* 브릿지·메시징 레이어를 거쳐 처리해야 하는 ERC‑7540 유사 비동기 리뎀션 모델로 **예치·출금 대기**를 관리합니다.
* 브릿지/회계 컴포넌트와 함께 이동 중 자산을 추적합니다.

**RemoteVaults (예: Ethereum)**

* 브리징된 자산을 받는 원격 체인 볼트.
* 화이트리스트된 DeFi·RWA 전략(Morpho, 기타 볼트 등)에 자금을 배치합니다.
* 그 가치가 OriginVault와 Super Vault를 거쳐 흘러, 궁극적으로 **Kaia의 EarnUSDT 지분 가격 상승**으로 반영됩니다.

이 모든 요소가 EarnUSDT를 뒷받침하는 **총자산**을 정의하며, Super Vault가 포트폴리오를 논리적으로 집계하는 지점입니다.

***

## 2. “Super Vault 자산”의 범위

“EarnUSDT를 뒷받침하는 총자산”은 Super Vault가 통합해 보는 다음을 의미합니다:

* **Kaia의 유휴 USDT**(유동성 버퍼)
* **Kaia 네이티브 전략 포지션**
* **크로스체인 자산**:

  * Kaia OriginVault의 지분,
  * 다른 체인의 RemoteVault 자산·전략 포지션,
  * 브릿지 **이동 중 자산**.

크로스체인 전송·메시지가 비동기라 시스템은 보수적 회계 모델을 사용합니다:

* 진행 중 전송을 **브릿지 큐**와 회계 레이어에서 추적합니다.
* 대상 체인에서 확인되기 전까지 자산을 “도착”으로 보지 않습니다.
* 크로스체인 메시지의 상태 스냅샷으로 Origin/Remote 상태를 지속적으로 일치시킵니다.

따라서:

* 크로스체인 활동이 많은 짧은 구간에는 수치가 다소 보수적으로 보일 수 있습니다.
* 메시지·전송이 정산되면 중복 없이 정확한 값으로 **수렴**합니다.

크로스체인 회계 모델에 대한 자세한 내용은 **[Runespear & Messaging](/ko/protocol/runespear)** 페이지를 참고하세요.

***

## 3. 자본 라우팅 & 포트폴리오 엔진

Super Vault는 단일 수익원을 하드코딩하지 않습니다. 대신 **포트폴리오 엔진**으로서:

* [포트폴리오 배분 정책](/ko/protocol/portfolio-allocation-policy)에서 목표 비중·제약을 받고,
* [포트폴리오 기회 목록](/ko/protocol/opportunity-set)의 적용 가능한 전략에 배분하며,
* 수익·유동성·리스크 조건이 변할 때 리밸런싱합니다.

구체적으로는:

* **Kaia 유동성 버퍼**를 유지해 출금·운영 수요를 대응하고,
* 일부 자본을 전용 전략 컨트랙트(예: `StrategyMorphoGauntletUSDTVault`)를 통해 **Kaia DeFi/RWA 전략**에 배치하며,
* 다른 일부를 **멀티체인 전략**으로 보내는데:

  * Kaia의 OriginVault에 예치하고,
  * OriginVault가 다른 체인의 RemoteVault로 브리징을 조정하며,
  * RemoteVault가 선정된 DeFi/RWA 전략(Morpho 볼트 등)에 투자합니다.

Super Vault 입장에서는 모든 포지션이 **“포트폴리오 가치”** 하나로 집계되어 EarnUSDT를 뒷받침합니다.

### 3.1 볼트 + 전략 구조

슈퍼 볼트는 **볼트 + 전략** 모델을 따릅니다:

* Super Vault 자체는 지분(EarnUSDT on Kaia)을 발행하는 **토큰화된 볼트**입니다.
* 특정 수익원(Morpho, RWA 볼트, 크로스체인 OriginVault 등)과 상호작용하는 **전략 컨트랙트 집합**에 자본을 위임합니다.
* 각 전략은 다음과 같은 파라미터를 가집니다:

  * **Debt ratio** – 전략이 관리할 수 있는 Super Vault 자산의 최대 비중
  * **수확당 최소/최대 부채** – 포지션을 얼마나 빨리 늘리거나 줄일지
  * **전략 성과 수수료** – 전략 구현자에게 배분될 수 있는 선택적 이익 지분

이 아키텍처는 **볼트당 여러 전략**을 지원해 포트폴리오 엔진이:

* 프로토콜·섹터별로 리스크를 분산하고,
* 단일 전략 노출을 제한하며,
* 시장 변화에 따라 배분을 조정할 수 있게 합니다.

실제 EarnUSDT는 모든 수익원을 쫓기보다 기회 목록·리스크 프레임워크를 거친 **선정된 전략 집합**만 사용합니다.

### 3.2 자동화 및 안전장치

여러 보조 컴포넌트가 Super Vault + 전략 레이어를 둘러싸고 동작합니다:

* **LightKeeper (Kaia / 원격)**\
  오프체인 헬퍼가 `LightKeeper` 컨트랙트를 호출해 전략을 **harvest**·**tend**합니다.

  * `harvests(strategies[])`는 손익을 실현해 볼트에 보고합니다.
  * `tends(strategies[])`는 손익 실현 없이 포지션을 리밸런싱합니다.
  * 각 전략의 `harvestTrigger()` / `tendTrigger()`로 가스 비용·예상 수익을 고려해 호출 시점을 결정합니다.

* **CrosschainKeeper (Kaia / 원격)**\
  **브리징 및 원격 볼트 운영**을 조정합니다:

  * OriginVault ↔ RemoteVault 간 유휴 USDT 브리징,
  * 원격 볼트 예치/인출,
  * 리뎀션 큐 처리 및 배치 출금.

  Super Vault 관점에서 CrosschainKeeper는 크로스체인 포트폴리오를 목표 배분에 맞추는 역할입니다.

* **HealthCheck**\
  각 전략은 `HealthCheck` 컨트랙트와 연결되어 **수확당 손익 한도**를 적용할 수 있습니다. 예기치 않은 큰 손실·이익(오라클 문제 등)이 발생하면 트랜잭션을 되돌리고 운영자에게 알립니다.

* **BaseFeeOracle / FeeOracle**\
  예상 수익 대비 가스가 너무 비쌀 때 수확을 피하기 위해, 전략은 베이스피 오라클을 조회해 현재 가스비가 수확에 적합한지 판단합니다.

* **Super Vault 주변 역할**\
  볼트 스택은 계층적 역할 모델을 따릅니다:

  * **Governance** – 시스템 수준 파라미터(수수료, 예치 한도, 비상 종료, 역할 지정) 변경 권한
  * **Management** – 일상 포트폴리오 관리(전략 온보딩/제거, 헬스체크 튜닝, 유동성 임계값)
  * **Guardian** – 긴급 상황에서 볼트를 일시 중지할 수 있는 응급 대응자
  * **Keeper** – LightKeeper / CrosschainKeeper를 통해 자동화를 수행하는 핫월렛·봇 역할(제한된 권한)

이 역할 분리는 Super Vault를 크게 자동화하면서도 명확한 안전장치와 에스컬레이션 경로를 제공합니다.

### 3.3 수수료 모델(운용·성과 수수료)

Super Vault를 구현하는 볼트 컨트랙트는 **두 가지 수수료**를 지원합니다:

* **운용 수수료**

  * 총 운용 자산(AUM)에 대한 연 단위 고정 비율.
  * 시간이 지남에 따라 누적되며, 수확 시 보상/수수료 수령자에게 **볼트 지분을 민트**해 반영됩니다.
  * 경제적으로는 전략의 총 성과 대비 지분 가격 상승 속도를 약간 늦춥니다.

* **성과 수수료**

  * 수확 시 발생한 **실현 이익**의 일부 비율.
  * 수확 시 지분으로 부과되며, 지분 가격에 반영되기 전에 차감됩니다.
  * **볼트 레벨**(프로토콜/트레저리 수수료)과 **전략 레벨**(전략가 수수료, `StrategyParams.performanceFee`) 모두 설정될 수 있습니다.

**Kaia의 EarnUSDT Super Vault**에서는 현재 두 수수료 모두 0%로 설정되어 있어, 외부 프로토콜 수수료를 제외한 모든 실현 수익이 사용자에게 전달됩니다.

향후 수수료가 활성화되면:

* **UI와 문서에 수수료 차감 후 APY**가 표시됩니다.
* 출금 스프레드나 숨겨진 마크업 없이, 수익에서만 수수료를 차감합니다.

***

## 4. 출금 및 유동성 관리

사용자가 EarnUSDT 리뎀션을 시작하면:

1. **SuperEarnRouter**를 통해 Kaia에서 요청이 생성되고 **Cooldown Vault**를 거쳐 짧은 쿨다운이 시작됩니다(CooldownVault는 사용자 직접 호출 불가).

2. 이 기간 동안 시스템은:

   * Kaia 측 유동성 버퍼를 사용하고,
   * 같은 경로를 역방향으로 따라 원격 체인 자본을 회수합니다
     (RemoteVault → OriginVault → Super Vault → Cooldown Vault).
   * 필요 시 전략 포지션을 정리하거나 리밸런싱하는데, 다음을 준수합니다:

     * 최대 손실 한도,
     * 슬리피지 한도,
     * 브릿지 안전 점검·타임아웃.

3. 쿨다운과 내부 정산이 끝나면, 사용자는 **요청 시점에 고정된 지분 가격**으로 Kaia USDT를 받습니다(EarnUSDT 토큰 세부는 \$EarnUSDT 참고).

Super Vault 관점에서는 기초 자산을 강제 매도하기보다, 출금 대응 중 투자 포지션을 통제된 방식으로 유휴 USDT로 전환하는 과정입니다.

***