ERC-8199 샌드박스 스마트 지갑 (Sandboxed Smart Wallet)

Draft · 계정·지갑 · 2026-03-19 작성

에이전트가 소유자 지갑과 완전히 분리된 전용 샌드박스 지갑에서 자금을 자율적으로 운용하되, 소유자가 언제든 자산을 회수하거나 접근을 끊을 수 있게 하는 지갑 표준입니다.

왜 필요한가

에이전트에게 지갑을 맡기는 기존 방법들은 각각 한계가 있습니다. 세션 키 방식은 소유자 지갑을 그대로 공유하므로, 화이트리스트로 엄격히 제한하지 않으면 권한을 벗어난 동작을 막기 어렵고 반대로 너무 좁게 제한하면 에이전트가 할 수 있는 일이 줄어듭니다. TEE 기반 정책 엔진은 편리하지만 결국 중앙화된 하드웨어와 운영자에 대한 신뢰에 전적으로 의존합니다. 계정 키를 그대로 공유하는 방식은 가장 직관적이지만 매 작업마다 소유자가 직접 승인하지 않으면 지갑 전체에 대한 무제한 접근을 주는 셈이어서 사람 개입 없는 완전한 자동화라는 목표와 충돌합니다. 이 때문에 에이전트가 오작동하거나 탈취되면 소유자의 자산 전체가 위험해질 수 있습니다.

구현해야 하는 것

심층 설명

Agent / Check / Execution 구조체

Agent는 agentKey(주소), validityTimestamp(uint128 validAfter와 uint128 validUntil을 한 슬롯에 packing), Check[] checkers로 구성됩니다. Check는 검사용 계약 주소 to와 검증 조건 데이터 termsData로 이루어집니다. Execution은 target, value, data로 구성되어 실제로 수행할 호출 하나를 나타냅니다. invokeAgentExec()와 executeFromOwner()는 모두 Execution[] 배열을 입력으로 받아 여러 실행을 한 번에 처리합니다.

에이전트 등록과 제거

registerAgents()는 소유자만 호출할 수 있고 성공하면 AgentRegistered 이벤트를 내보냅니다. 이미 활성 상태인 동일한 agentKey의 Agent를 다시 등록하려 하면 함수는 되돌려져야(revert) 합니다. removeAgents()도 소유자만 호출할 수 있고 AgentRemoved 이벤트를 내보내는데, agentKey의 유효 시간이 지났거나 아직 시작되지 않았더라도 agentKey가 존재하기만 하면 되돌려지지 않아야 합니다.

에이전트 실행과 서명

invokeAgentExec()는 누구나 중계(relay)할 수 있는 함수로, Execution 배열과 agentKey의 서명을 함께 받습니다. 서명에 실행 가능 시간 범위를 함께 인코딩할 수 있습니다. isAgentActive()는 agentKey가 등록되어 있고 현재 block.timestamp가 validityTimestamp 범위 안에 있을 때만 true를 반환해야 합니다.

Checker의 사전·사후 검사

Checker 계약은 preCheck()와 postCheck() 두 함수를 구현해야 합니다. 각각 실행 전/후에 Execution 배열과 termsData를 받아 조건을 검증하고 성공·실패를 bool로 반환합니다. 원문은 termsData를 구성할 때 블랙리스트 방식보다 화이트리스트 방식의 강제를 권장합니다.

소유자의 단방향 통제

owner()는 ERC-173의 owner() 패턴을 참조해 소유권 관련 도구·SDK와의 호환성을 높입니다. executeFromOwner()는 owner()가 반환하는 주소만 호출할 수 있고 자산의 완전한 인출을 포함한 임의 실행을 수행할 수 있습니다. 이로써 소유자 지갑만 샌드박스 지갑에 영향을 줄 수 있고 샌드박스 지갑은 소유자 지갑에 아무 권리도 갖지 않는 일방향 관계가 만들어집니다.

초기 자금 이전 방식

초기 부트스트랩은 소유자 지갑에서 SandboxedSmartWallet으로 자금을 직접 이전하는 방식으로 이루어집니다. 토큰 승인(approval) 모델은 권장되지 않는데, 이는 SandboxedSmartWallet이 소유자 지갑에 논리적·계정 수준으로 연결되거나 영향을 줄 수 있는 여지를 없애기 위해서입니다.

멀티 에이전트 공유와 부가 이점

여러 에이전트가 하나의 샌드박스 지갑을 공유하면 같은 자산, 온체인 주소 평판, 트랜잭션 기록을 함께 쓸 수 있습니다. 에이전트가 스마트 지갑을 쓰면 가스 추상화로 네이티브 가스 요구사항 부담을 줄이고 온체인 조건부 실행이나 다층적인 거래 전략을 지원받으며 고빈도 거래 환경에서 2차원 nonce 등으로 다수 트랜잭션을 병렬 실행하는 데도 도움이 됩니다.

제안 상태

이 ERC는 현재 Draft 상태로, 아직 확정되지 않았고 내용이 바뀌거나 중단될 수 있는 제안입니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs