> 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/perpetuals/architecture/account/agent-wallets.md).

# 에이전트 지갑

계정 소유권 이전 없이 거래 권한을 위임

에이전트 지갑을 사용하면 계정 소유권은 그대로 유지하면서 Perpetuals 계정의 거래 권한을 다른 지갑에 위임할 수 있습니다. 봇 운영, 자동화, 조직 차원의 권한 관리에 사용하십시오. 기본 지갑은 계정의 관리자 역할을 계속 맡습니다.

### 작동 원리

각 Perpetuals 계정은 관리자 캐퍼빌리티(admin capability)로 제어됩니다. 에이전트 지갑 기능을 통해 관리자 지갑은 두 번째 지갑(에이전트)에 어시스턴트 수준의 권한을 부여할 수 있습니다. 권한을 부여할 때마다 수신 지갑이 소유하는 캐퍼빌리티 객체가 발행되며, 한 계정이 동시에 보유할 수 있는 활성 에이전트 지갑은 최대 10개입니다(프로토콜 파라미터). 이후 에이전트 지갑은 해당 계정을 대신해 지원되는 거래 작업을 실행할 수 있습니다. **에이전트는 담보 출금을 제외한 모든 작업을 수행할 수 있으며**, 다른 에이전트 지갑을 부여·회수하거나 [빌더 코드](https://docs.aftermath.finance/ko/perpetuals/architecture/builder-codes-front-end-fee.md) 승인을 취소하는 것도 할 수 없습니다(승인 추가는 에이전트도 할 수 있지만, 삭제는 관리자만 가능합니다).

### 에이전트 지갑을 사용하는 이유

* 전용 지갑에서 자동화 전략 실행
* 리스크 관리를 위한 서명 키 분리
* 장기 보관용 트레저리/관리자 지갑을 실행 환경과 격리
* 필요 시 즉시 권한 회수

{% hint style="warning" %}
어떤 형태의 자동화든 반드시 에이전트 지갑을 사용하십시오. 트레저리/관리자 지갑을 봇 실행에 재사용하지 마십시오.
{% endhint %}

### 앱에서 관리하기

**더보기** 메뉴에서 **에이전트 지갑**을 열거나 [aftermath.finance/perpetuals/agent-wallets](https://aftermath.finance/perpetuals/agent-wallets)로 이동하십시오. 로그인하면 내 지갑이 관리하는 모든 Perpetuals 계정과 볼트의 에이전트 지갑을 확인하고, 권한을 부여하거나 회수할 수 있습니다. 부여와 회수는 각각 관리자 지갑이 서명하는 온체인 트랜잭션입니다.

[원클릭 거래](https://docs.aftermath.finance/ko/perpetuals/architecture/account/one-click-trading.md)는 키가 브라우저에 저장된 에이전트 지갑을 사용합니다. 이 지갑의 주소도 이 목록에 표시됩니다.

### 에이전트 지갑 부여

계정 관리자 지갑에서 다음 항목을 지정한 트랜잭션을 제출합니다:

* `accountId`
* `recipientAddress`: 에이전트 권한을 받을 지갑

온체인 확정 후, 수신 지갑은 어시스턴트 수준 권한으로 해당 계정을 대신해 거래할 수 있습니다.

**엔드포인트:** `POST /api/perpetuals/account/transactions/grant-agent-wallet`

### 에이전트 지갑 회수

계정 관리자 지갑에서 다음 항목을 지정한 트랜잭션을 제출합니다:

* `accountId`
* 회수할 어시스턴트 캐퍼빌리티의 `accountCapId`

확정 후, 회수된 지갑은 위임받은 권한을 즉시 잃습니다.

에이전트는 관리자 지갑의 개입 없이 언제든지 자신의 캐퍼빌리티를 소멸시켜 스스로 권한을 포기할 수도 있습니다.

**엔드포인트:** `POST /api/perpetuals/account/transactions/revoke-agent-wallet`

{% hint style="info" %}
봇을 운영하시나요? 에이전트 지갑에 SUI를 보유할 필요가 없습니다. 중앙 풀에서 가스를 후원하는 방법은 [가스리스 트레이딩(GasPool)](https://docs.aftermath.finance/ko/perpetuals/architecture/account/gasless-trading.md)을 참고하십시오.
{% endhint %}
