# 프로그래머블 월렛

대부분의 에이전트는 추천만 할 수 있습니다. Underscore는 프라이빗 키를 넘기지 않고도 실제 자금으로 실행하게 만듭니다.

Underscore 프로그래머블 월렛은 AI 에이전트와 운영자가 온체인 규칙 안에서 실행할 수 있도록 설계된 스마트 컨트랙트 월렛입니다. [매니저](https://docs.underscore.finance/ko/undefined-1/managers)는 권한을 정의하고, [수취인](https://docs.underscore.finance/ko/undefined-1/payees)은 반복 지출을 처리하며, [디지털 수표](https://docs.underscore.finance/ko/undefined-1/cheques)는 선택적 검토 지연이 있는 일회성 결제를 처리합니다. 모든 것은 오픈소스 스마트 컨트랙트에 의해 온체인에서 강제됩니다.

하나의 주소로 20개 이상의 DeFi 프로토콜에 접근할 수 있습니다. 엄격한 경계 안에서 에이전트에게 운영을 위임할 수 있습니다. 자금이 수익을 내는 동안 결제를 자동화할 수 있습니다. 서로 다른 월렛 사이로 자본을 즉시 이동할 수도 있습니다.

Base L2 위에 구축된 이 월렛은 기관급 보안성과 24시간 기회를 포착할 수 있는 유연성을 함께 제공합니다. 에이전트가 자율적으로 실행하든, 사용자가 직접 관리하든 마찬가지입니다.

핵심 구성은 네 가지입니다.

1. **통합 프로토콜 접근**: 표준화된 어댑터를 통해 주요 DeFi 프로토콜에 직접 연결
2. **에이전트 실행**: [매니저](https://docs.underscore.finance/ko/undefined-1/managers)가 정의된 경계 안에서 전략 실행. 수탁 없음, 키 공유 없음
3. **결제 레일**: 반복 지출과 일회성 승인용 프로그래머블 결제 시스템 ([수취인](https://docs.underscore.finance/ko/undefined-1/payees), [수표](https://docs.underscore.finance/ko/undefined-1/cheques))
4. **보안 계층**: 타임락, 화이트리스트, 세분화된 권한으로 모든 작업 보호

## 하나의 월렛, 모든 프로토콜

Underscore는 "DeFi 레고"라고 부르는 표준화된 어댑터를 통해 DeFi 프로토콜에 연결됩니다. 각 레고는 프로토콜별 작업을 일관된 인터페이스로 감싸며, 최적화된 가스 사용량으로 원자적 멀티프로토콜 트랜잭션을 가능하게 합니다.

**이 월렛은 시간이 지나도 계속 활용할 수 있습니다**. 새로운 DeFi 프로토콜이 출시되거나 기존 프로토콜에 기능이 추가되면, 새 DeFi 레고 통합을 통해 자동으로 월렛에 반영됩니다. 자금을 옮길 필요도, 새 월렛을 배포할 필요도, 따로 업데이트할 필요도 없습니다. 새 레고가 배포되는 순간 기존 프로그래머블 월렛도 곧바로 새 프로토콜에 접근할 수 있습니다.

### 수익 및 대출 프로토콜

**통합 프로토콜**: Morpho, Moonwell, Aave, Euler, Fluid, Compound, 그리고 Avantis, ExtraFi 같은 특화 프로토콜 외 다수

**가능한 작업**:

* 자산 예치로 수익 창출
* 자동 언와인딩을 포함한 자금 인출
* 수익 추적과 이익 계산
* 프로토콜 보상 청구
* 프로토콜 간 리밸런싱

### 트레이딩 및 DEX 통합

**통합 DEX**: Aerodrome, Uniswap, Curve

**가능한 작업**:

* 스마트 라우팅 기반 토큰 스왑 (최대 5홉 경로)
* 자동 비율 계산을 통한 유동성 추가/제거
* 표준 유동성(uni v2)과 집중 유동성(uni v3+) 모두 지원
* NFT 포지션 관리 및 범위 조정

### 부채 관리

**통합 프로토콜**: [Ripe Protocol](https://ripe.finance)

Ripe Protocol은 Underscore의 대출 파트너로, 자산을 팔지 않고도 유동성을 확보할 수 있게 해줍니다. 핵심 장점은 **Underscore 핵심 Vault 지분 토큰이 담보로 인정된다는 점**입니다. 즉, 자산이 AI 최적화 수익을 내는 동안 그 자산을 담보로 대출도 받을 수 있습니다. 수익과 유동성 중 하나를 고르는 것이 아니라 둘 다 가져갈 수 있습니다. Amplified Vaults도 Vault 전략 내부에서 같은 패턴을 활용합니다.

**작동 방식**:

1. **담보 예치**: 자산을 Ripe Protocol에 잠급니다. Underscore 핵심 Vault 지분 토큰도 포함됩니다
2. **대출 실행**: GREEN(스테이블코인) 또는 수익형 sGREEN으로 대출받습니다
3. **수익 유지**: 핵심 Vault 지분 토큰을 담보로 쓰는 경우, 기초 자산은 계속 최적화 수익을 창출합니다
4. **언제든 상환**: 원하는 시점에 원금과 이자를 갚습니다
5. **담보 회수**: 부채가 정리되면 자산을 인출합니다

**왜 중요한가요?**

기존 대출은 보통 선택을 강요합니다. 수익을 얻거나, 자산을 담보로 쓰거나 둘 중 하나입니다. Underscore + Ripe에서는:

* 핵심 Vault에 예치해 AI가 수익을 최적화하게 합니다
* 그 핵심 Vault 지분 토큰을 Ripe에서 담보로 사용합니다
* GREEN/sGREEN을 대출받아 유동성을 확보합니다
* 담보는 그동안 계속 수익을 냅니다

**가능한 작업**:

* 지원되는 어떤 자산이든 담보로 예치
* Underscore 핵심 Vault 지분 토큰을 수익 창출형 담보로 활용
* GREEN(스테이블코인) 또는 sGREEN(수익형 스테이블코인) 대출
* 허용된 어떤 토큰으로든 부채 상환
* 부채 포지션에서 RIPE 보상 획득 및 청구

**매니저 권한**:

* **부채 관리**: 담보 추가/제거, 대출, 상환
* 매니저는 대출한 자금을 외부 주소로 인출할 수 없습니다
* 모든 작업은 기본 매니저 한도를 따릅니다

**왜 대출하나요?**

* 오를 수 있는 자산을 팔지 않고도 유동성 확보
* 담보에서 계속 수익 창출
* 세금 효율성 향상. 대출은 일반적으로 과세 이벤트가 아님
* 단기 현금 흐름 수요 대응

### 자산 변환

**가능한 작업**:

* 슬리피지 없이 ETH ↔ WETH 변환
* 예치 증표 토큰(receipt token) 발행 및 상환 (예: stETH)
* 지연 상환 처리
* 프로토콜 요구사항에 맞춘 자동 포맷 변환

### 보상 및 인센티브

**가능한 작업**:

* 모든 프로토콜 보상을 하나의 트랜잭션으로 일괄 청구
* 생산적인 포지션으로 보상을 자동 복리
* 프로토콜 전반의 누적 수익 추적

## 배치 작업: 여러 단계, 하나의 트랜잭션

Underscore의 아키텍처는 복잡한 다단계 작업을 하나의 트랜잭션 안에서 원자적으로 실행할 수 있게 합니다. 이는 상당한 가스 절감 효과를 제공하고, 일부 단계만 실행되는 부분 실패 위험도 제거합니다.

### 배치 작업 예시

**수익 리밸런싱**:

```
1. Aave에서 인출 (낮은 수익)
2. Morpho에 예치 (높은 수익)
3. 두 프로토콜 모두에서 보상 청구
4. 보상을 생산적인 자산으로 변환
→ 전부 하나의 트랜잭션으로 처리
```

**복합 포지션 진입**:

```
1. Ripe Protocol에 담보 예치
2. 담보를 바탕으로 대출
3. 대출한 자금을 유동성으로 공급
4. 추가 수익을 위해 LP 토큰 스테이킹
→ 한 번의 클릭으로 전략 전체 실행
```

**포트폴리오 리밸런싱**:

```
1. 여러 풀에서 유동성 제거
2. 목표 비중에 맞게 자산 스왑
3. 새 포지션에 재배치
4. 모든 [보상](rewards.md) 청구 및 재투자
→ 전체 리밸런싱을 원자적으로 처리
```

## 스왑: 어떤 토큰이든 거래

프로그래머블 월렛에서 토큰을 스왑하면, 시스템이 통합된 DEX 전반에서 가장 나은 경로를 찾습니다.

### 스왑 작동 방식

멀티홉 라우팅 예시:

```
USDC → PEPE로 스왑하고 싶다고 가정해 봅시다.
직접 경로가 없거나 유동성이 부족할 수 있습니다.

스마트 라우팅은 다음과 같은 경로를 찾습니다:
USDC → ETH → PEPE (2홉)
또는
USDC → WETH → PEPE (더 나은 가격의 2홉)

최적 가격을 위해 최대 5홉까지 지원합니다.
```

### 슬리피지 보호

모든 스왑에는 슬리피지 보호가 포함됩니다. 사용자가 받을 최소 수량을 지정하면, 시장 상황이 바뀌어 그보다 적게 받게 되는 경우 트랜잭션은 되돌려집니다.

* 월렛 기본값: 스왑별로 설정 가능
* 매니저 한도: 각 매니저에는 최대 슬리피지 상한이 있습니다 (예: 최대 1%)
* 안전장치: 나쁜 가격으로 체결되는 대신 트랜잭션을 되돌립니다

### 스왑 수수료

Underscore는 스왑에 0.25% 수수료를 부과합니다. 이는 DEX 수수료와는 별개이며, DEX 수수료는 유동성 공급자에게 갑니다.

스왑 수수료는 Underscore의 비교적 작은 수익원 중 하나입니다. 다른 프로토콜 수익과 마찬가지로, 이 수익도 공개 시장에서 [$RIPE](https://app.ripe.finance/ripe)를 바이백하는 데 사용됩니다.

### 매니저 스왑 제어

매니저가 스왑을 실행할 때는 추가 제어가 적용됩니다.

* 최대 슬리피지 비율
* 기간별 최대 스왑 횟수
* 스왑당 최소 USD 금액
* 자산 제한 (어떤 토큰을 스왑할 수 있는지)

***

## 유동성 공급: 거래 수수료로 수익 창출

프로그래머블 월렛을 사용하면 탈중앙화 거래소에 유동성을 공급하고 거래 수수료의 일부를 벌 수 있습니다. 이는 가장 강력한 DeFi 전략 중 하나입니다. 사용자의 자산이 다른 사람의 거래를 가능하게 하면서 일하게 됩니다.

### 작동 방식

유동성을 공급할 때는 USDC와 ETH처럼 두 종류의 토큰을 거래 풀에 예치합니다. 트레이더는 이 토큰 사이를 스왑하며 수수료를 지불하고, 사용자는 풀 지분에 비례해 그 수수료를 받습니다.

**기본 예시**:

```
예치 자산: $5,000 USDC + $5,000 상당 ETH
풀 지분: 전체 유동성의 1%
일일 거래량: $1,000,000
수수료율: 0.3%
일일 수익: $30 (0.3% × $1M × 1%)
```

### 두 가지 유동성 유형

**단순 유동성 (Uniswap V2 스타일)**

* 가치가 같은 두 토큰을 예치
* 모든 가격 구간에서 수수료 획득
* 지분을 나타내는 LP 토큰 수령
* 지원 대상: Aerodrome Classic, Uniswap V2, Curve

**집중 유동성 (Uniswap V3 스타일)**

* 유동성을 제공할 구체적인 가격 범위 선택
* 가격이 해당 범위 안에 있을 때 더 높은 수수료 획득
* 자본 효율이 높지만 모니터링 필요
* 대체 가능 토큰이 아닌 NFT 포지션을 수령
* 지원 대상: Aerodrome Slipstream, Uniswap V3

### LP에 대한 매니저 권한

매니저는 **유동성 관리** 권한으로 유동성 작업을 처리할 수 있습니다.

* 승인된 풀에 유동성 추가
* 리밸런싱 시 유동성 제거
* 모든 기본 매니저 한도 적용

### 알아야 할 위험

**비영구적 손실**: 토큰 가격이 크게 벌어지면, 단순 보유했을 때보다 가치가 줄어들 수 있습니다. 이 손실은 출금할 때 비로소 "영구적"이 됩니다.

**스마트 컨트랙트 리스크**: LP 포지션은 DEX 스마트 컨트랙트 안에 존재합니다. Underscore는 검증되고 감사를 받은 프로토콜만 통합합니다.

***

## 그 밖의 월렛 기능

### Eject Mode: 긴급 락다운

월렛이 손상되었을 수 있다고 의심되거나 즉시 활동을 제한해야 한다면, Eject Mode를 활성화해 작업을 잠글 수 있습니다.

**활성화 시**:

* 전송과 ETH/WETH 변환만 허용
* 수익, 스왑, 부채, 유동성 작업은 모두 금지
* 오직 소유자만 어떤 작업이든 수행 가능
* 모든 매니저는 작동이 차단됨

**사용 예시**:

```
의심스러운 활동 감지
    ↓
Eject Mode 활성화 (트랜잭션 1회)
    ↓
월렛이 기본 작업만 가능한 상태로 잠김
    ↓
화이트리스트 주소로 자금을 안전하게 이동
    ↓
안전이 확보되면 Eject Mode 해제
```

Eject Mode는 비상시를 위한 패닉 버튼입니다. 먼저 제한하고, 나중에 조사하면 됩니다.

### [매니저](https://docs.underscore.finance/ko/undefined-1/managers): 에이전트에게 실행 권한을 부여하되, 수탁 권한은 주지 않습니다

매니저는 승인된 운영자(사람이든 AI이든)로, 사용자가 정의한 경계 안에서 작업을 실행합니다. 거래하고, 수익을 최적화하고, 결제를 관리할 수 있지만, 외부 주소로 출금하거나 한도를 초과할 수는 없습니다.

**사용 사례**:

* AI 에이전트가 24시간 수익 최적화 수행
* 트레이딩 에이전트가 데이터 피드, 컴퓨트, 추론 API 비용 지불
* 부채 포지션의 자동 관리
* CFO가 벤더 및 외주 인력 결제 처리
* 전문 트레이더가 포트폴리오 일부 관리
* 가족 구성원에게 긴급 접근 권한 부여

[→ 매니저 자세히 보기](https://docs.underscore.finance/ko/undefined-1/managers)

### [수취인](https://docs.underscore.finance/ko/undefined-1/payees): 에이전트가 필요한 서비스 비용을 결제하도록 합니다

수취인(Payee)은 반복 지출 계층입니다. 미리 승인된 수취인으로, 사용자가 허용한 범위 안에서만 자금을 받을 수 있습니다. 시장 데이터 피드, 모델 제공자, 컴퓨트 벤더, 외주 인력, 급여, 구독에 사용하세요. 자금은 결제 시점까지 수익을 내다가, 필요할 때 자동으로 전송됩니다.

**사용 사례**:

* 에이전트용 데이터 피드 및 추론 API 구독
* 주간 예산이 있는 컴퓨트 벤더 결제
* 수익을 내는 자금에서 직원 급여 지급
* 벤더 및 외주 인력에 대한 자동 결제
* 풀 결제(Pull Payment)를 활용한 구독형 서비스

[→ 수취인 자세히 보기](https://docs.underscore.finance/ko/undefined-1/payees)

### [수표](https://docs.underscore.finance/ko/undefined-1/cheques): 무조건적인 신뢰 없이 처리하는 일회성 지출

디지털 수표는 자금 이체를 통제 가능한 결제 약속으로 바꿉니다. 소액은 즉시 처리됩니다. 큰 금액은 검토 지연 뒤에 놓이고, 언제든 취소할 수 있습니다. 자금은 실제 결제 전까지 계속 수익을 냅니다.

**사용 사례**:

* 에이전트가 일회성 데이터셋이나 컴퓨트 작업 구매
* 결과물이 오지 않으면 취소할 수 있는 외주 결제
* 검토 시간이 내장된 대규모 전송
* 결제 시점을 유연하게 조절할 수 있는 일회성 벤더 송장
* "되돌리기" 옵션이 필요한 어떤 결제든

[→ 수표 자세히 보기](https://docs.underscore.finance/ko/undefined-1/cheques)

### [화이트리스트](https://docs.underscore.finance/ko/undefined-1/whitelist): 무제한 신뢰

화이트리스트는 비상시를 위해 준비해 두는 최고 신뢰 단계입니다. 지연이나 한도 없이 무제한 전송을 받을 수 있는 주소 목록입니다. 타임락 추가는 월렛 손상을 방어하고, 즉시 제거는 통제권을 유지하게 합니다.

**사용 사례**:

* 긴급 자금 접근용 하드웨어 월렛
* 즉시 자금 통합이 필요한 기업 재무 월렛
* 리스크 분산을 위한 멀티월렛 전략
* 접근을 잃어버렸을 때 복구용 Gnosis Safe

[→ 화이트리스트 자세히 보기](https://docs.underscore.finance/ko/undefined-1/whitelist)

## 아키텍처 비교

| 기존 다중 월렛 구성      | Underscore 프로그래머블 월렛 |
| ---------------- | -------------------- |
| 여러 인터페이스와 로그인 필요 | 하나의 통합 인터페이스         |
| 프로토콜마다 수동 토큰 승인  | 사전 구성된 프로토콜 접근       |
| 월렛 간 외부 전송 필요    | 내부 라우팅, 별도 전송 불필요    |
| 수동 수익 추적         | 자동 이익 계산             |
| 자동화 옵션이 제한적      | 완전한 위임 기능            |
| 월렛별로 분리된 보안      | 통합 보안 모델             |

## 자주 묻는 질문

### 🔐 **보안 및 통제**

**이건 셀프 커스터디 월렛인가요?**\
네. 소유자 지갑과 자산에 대한 최종 통제권은 사용자에게 있습니다. 매니저는 온체인에서 승인된 제한된 작업만 실행할 수 있으며, 수탁 권한이나 무제한 서명 권한을 절대 받지 않습니다.

**Underscore가 사라지면 어떻게 되나요?**\
자금은 계속 안전하고 접근 가능합니다. 스마트 컨트랙트는 불변이며 Underscore 서버에 의존하지 않습니다. BaseScan이나 다른 인터페이스를 통해 직접 월렛과 상호작용할 수 있습니다. [Params Explorer](https://params.underscore.finance/deployments)에서는 현재 배포 상태와 프로토콜 설정도 확인할 수 있습니다.

**새 월렛으로 마이그레이션할 수 있나요?**\
네. 프로토콜에는 자금 이동과 설정 복사(매니저, 수취인, 화이트리스트)를 지원하는 마이그레이션 시스템이 포함되어 있습니다. 새 기능을 쓰고 싶거나 구성을 재정비해야 할 때 유용합니다.

### 💰 **비용 및 수수료**

**수수료는 어떻게 되나요?**

* **Earn Vault 성과 수수료**: 발생한 수익금에 대해서만 20%
* **스왑 수수료**: 토큰 스왑 시 0.25%
* **외부 보상 청구**: 프로토콜 보상(MORPHO, WELL 등) 청구 시 20%
* **수익 사용처**: 프로토콜 수익의 100%는 공개 시장에서 [$RIPE](https://app.ripe.finance/ripe)를 바이백하는 데 사용됩니다
* **수수료 없음**: 전송, 유휴 자금, 예치, 부채 작업, 유동성 공급, ETH/WETH 래핑

수수료 구조와 사용처는 [프로토콜 이코노믹스](https://docs.underscore.finance/ko/undefined-2/protocol-economics)를 참고하세요.

### 기술 설정

**기존 월렛과 함께 사용할 수 있나요?**\
네. 기존 월렛(예: MetaMask)으로 Underscore 프로그래머블 월렛을 배포하면, 그 기존 월렛이 소유자 지갑 역할을 하게 됩니다.

**어떤 프로토콜에 접근할 수 있나요?**\
Aave, Morpho, Compound(대출), Ripe Protocol(차입), Uniswap, Curve, Aerodrome(거래) 등 20개 이상의 프로토콜에 접근할 수 있습니다. 새 프로토콜도 레고 시스템을 통해 자동으로 통합됩니다.

**Base L2에 문제가 생기면 어떻게 되나요?**\
Base는 Ethereum의 보안 모델을 상속합니다. 매우 드문 경우 L2 이슈가 발생하더라도 자산을 Ethereum 메인넷으로 인출하기 위한 확립된 절차가 존재합니다. 자금에 대한 통제권은 계속 사용자에게 있습니다.

***

## 당신의 선택

AI 에이전트에게 필요한 것은 API만이 아닙니다. 제한된 온체인 실행 권한, 프로그래머블 결제 레일, 그리고 강력한 보안 한도가 필요합니다.

에이전트나 운영자가 리밸런싱하고, 결제하고, 대출하고, 상환하고, 사용자가 정한 규칙 안에서 자금을 이동해야 한다면 프로그래머블 월렛을 배포하세요.

***

*프로그래머블 월렛 + Earn Vaults. 당신의 돈은 잠들지 않습니다.*