에이전트 지갑이란
Hyperliquid에서는 계좌가 두 번째 키를 승인해 자기를 대신해 거래하게 할 수 있습니다. 에이전트 지갑, 또는 API 지갑이라고 부릅니다. 승인에는 계좌가 한 번만 서명하고, 그 뒤로는 에이전트 키가 계좌를 위해 주문에 서명하며 자금은 보유하지 않습니다.
승인에는 끝나는 날짜가 붙습니다. 길어도 180일이며, 이것이 Hyperliquid가 허용하는 최대입니다. 계좌는 언제든 취소할 수 있습니다.
어떻게 측정했는가
2026년 9월 28일 Hyperliquid 메인넷에서, 약 60 USDC가 있는 테스트 계좌를 썼습니다. 계좌는 Locker Vault가 하는 것처럼 새 에이전트를 한 시간만 승인했고, 그 에이전트가 자금을 움직이는 동작마다 1,000 USDC로 서명했습니다.
60 USDC가 있는 계좌에 1,000 USDC를 요구하면 아무것도 움직일 수 없습니다. 중요한 것은 거부의 이유뿐이었습니다. 그다음 계좌가 같은 요청에 서명했습니다. 에이전트가 계좌와 다른 답을 받은 곳에서는, 금액이 아니라 에이전트라는 이유로 막힌 것입니다.
Hyperliquid의 답
| 동작 | 에이전트 키로 서명 |
|---|---|
| 주문을 내고, 그다음 취소 | 허용 |
출금(withdraw3) | 거부 |
USDC나 토큰 전송(usdSend, spotSend, sendAsset) | 거부 |
현물과 무기한 선물 사이 이동(usdClassTransfer) | 거부 |
| 다른 에이전트 승인, 또는 빌더 수수료 승인 | 거부 |
계좌 자금을 Hyperliquid 볼트에 예치(vaultTransfer) | 허용 |
거부의 이유는 모두 같았습니다. Hyperliquid가 그 동작을 에이전트 자신의 주소에 적용했고, 그곳에는 아무것도 없기 때문입니다. 그래서 볼트 예치만 5 USDC로 다시 시험했습니다. 목적지는 Hyperliquid 자신의 볼트인 HLP로, 계좌의 것으로 남는 곳입니다. 이것은 통과했습니다.
서명할 수 있는 단 하나의 자금 이동
볼트 예치는 계좌의 여유 증거금에서 남이 운영하는 볼트로 자금을 옮깁니다. 에이전트 키를 손에 넣은 도둑은 당신의 계좌를 자기가 운영하는 볼트에 예치하고, 자기와 맞붙는 거래로 잃게 만들 수 있습니다.
lpa는 이 동작에 결코 서명하지 않습니다. 가디언이 서명하는 것은 닫힌 거래 동작 목록뿐입니다. 하지만 키 파일과 당신의 비밀번호를 가진 도둑에게는 lpa가 필요하지 않습니다.
lpa가 더하는 것
- 에이전트 키는 당신의 비밀번호로 디스크에 봉인되고, 당신이 잠금을 푼 동안에만 가디언이 메모리에 들고 있습니다.
- 가디언은 주문과 취소, 레버리지와 증거금 설정에만 서명하고, 그 밖에는 아무것도 서명하지 않습니다.
- 모든 진입은 당신의 로컬 정책과, 휴대폰에서 서명한 위임장에 비추어 확인됩니다.
- 키는 스스로 만료되며, 그 30일과 14일, 7일, 3일, 1일 전에 알려 줍니다.
그래도 남는 한계선
키와 비밀번호를 모두 가진 도둑은 컴퓨터의 어떤 파일로도 막지 못합니다. 그때 남는 것은 이렇습니다. 키는 출금할 수 없고, 키는 만료되며, 에이전트만을 위해 쓰는 계좌에는 감당할 수 있는 만큼만 들어 있습니다.
끝내려면 lpa agent revoke가 휴대폰으로 키를 즉시 물러나게 합니다. lpa mandate revoke는 휴대폰이 필요 없고, 새 위임장에 서명할 때까지 lpa의 모든 진입을 멈춥니다.