정의
마스터 계좌는 API 지갑을 승인해 자기를 위해, 또는 자기 서브계좌 가운데 어느 것을 위해 서명하게 할 수 있습니다. 그것들은 서명에만 쓰입니다. 계좌의 데이터를 조회할 때는 그 계좌의 실제 주소를 넘겨야 하고, 문서는 에이전트 주소로 조회하는 일을 흔한 함정으로 꼽습니다. 오류가 아니라 빈 결과가 돌아오기 때문입니다. 한 계좌는 이름 없는 승인 지갑 하나와 이름 있는 것 최대 세 개를 둘 수 있고, 서브계좌마다 이름 있는 에이전트 두 개가 더 허용되며, valid_until로 정하는 만기는 아무리 멀어도 180일 뒤까지입니다.
그런 키가 무엇을 할 수 있고 무엇을 할 수 없는지는 짐작이 아니라 실측했습니다. 2026년 9월 28일 메인넷에서, 테스트 계좌가 새 에이전트를 한 시간만 승인하고, 약 60의 잔고를 상대로 1,000 USDC짜리로 돈이 움직이는 모든 동작에 서명하게 했습니다. 그러면 아무것도 움직일 수 없고, 각 답의 이유만 남습니다. 이 서명자에서 거부된 것은 withdraw3, usdSend, spotSend, sendAsset, usdClassTransfer, 두 번째 approveAgent, 그리고 approveBuilderFee이고, 계좌 자신은 대신 잔고 오류를 만났습니다. 허용된 것은 주문을 내는 일과 취소하는 일입니다. 그리고 자금의 이동 하나가 허용되었습니다. vaultTransfer로, 에이전트 키가 서명한 5 USDC가 Hyperliquid 볼트에 닿았습니다.
운영상의 경고 하나가 이 정의와 함께 있어야 합니다. 논스는 서명자마다 따로 관리되고, API 지갑의 논스 상태는 새 지갑의 승인으로 등록이 풀릴 때, 만기가 될 때, 또는 그것을 등록한 계좌에 자금이 더 없을 때 지워질 수 있습니다. 문서는 그러면 앞서 서명된 동작이 재생될 수 있다고 말하며, 에이전트 주소를 절대 재사용하지 말라고 강하게 권합니다. 대신 새 것을 만드십시오.
우리 구성에서는 에이전트 키가 컴퓨터에 있고, 디스크에서 비밀번호로 봉해지며, 잠금이 풀려 있는 동안만 가디언이 메모리에 들고 있습니다. 가디언은 닫힌 거래 동작 목록에만 서명하고 그 밖에는 서명하지 않으며, 키는 스스로 만기가 되고 30일, 14일, 7일, 3일, 1일 전에 경고가 나옵니다. 그리고 lpa agent revoke가 당신의 지갑과 함께 그것을 퇴역시킵니다. 키와 그 비밀번호를 둘 다 쥔 도둑을 컴퓨터의 어떤 파일도 막지 못합니다. 그래서 버티는 한계선은 계좌입니다. 그 안에 든 것이 잃을 수 있는 최대입니다.
예시
반올림한 숫자로 보는 예시입니다. 1,000 USDC를 넣은 계좌가 에이전트 키 하나를, Hyperliquid가 허용하는 상한인 180일 뒤 만기로 승인합니다. 그 키는 이 1,000 USDC를 상대로 포지션을 열고 닫을 수 있고 종목의 레버리지와 마진 모드를 정할 수 있습니다. 거기서 1센트도 출금할 수 없고, 다른 주소로 보낼 수도 없으며, 현물과 무기한 선물 잔고 사이에서 옮길 수도 없습니다. 그것이 닿는 전부가 그 1,000 USDC이고, 그래서 전용 계좌가 중요한 한계선입니다.