ERC-8273 증명 기반 에이전트 행동 게이트 (Attestation-Gated Agentic Actions)
Draft · 서명·인증 · 2025-05-26 작성
AI 에이전트가 온체인 작업을 실행하기 전에 승인된 증명자가 그 거래 안에서만 유효한 일회성 인증을 발급해, 컨트랙트가 '이 에이전트가 이 작업을 할 자격이 있는지'를 즉시 확인하게 하는 표준입니다.
왜 필요한가
에이전트에게 신원만 부여하는 방식에는 근본적인 한계가 있습니다. 같은 신원이 항상 같은 에이전트 뒤에 있다는 보장이 없고 신원 하나로는 '이 에이전트가 지금 이 작업을 할 자격이 있는가'를 말해주지 못합니다. 거래가 실제로 에이전트가 수행한 것인지, 이 에이전트가 이런 종류의 작업을 할 권한이 있는지, 실행 환경을 신뢰할 수 있는지, 자율 실행과 사람 지시를 구분할 수 있는지는 서로 다른 질문이지만 모두 '특정 작업에 묶이고 온체인에서 조회 가능한 증명 기록'을 필요로 합니다. 지금까지는 이런 표준 장치가 없어서 신원 NFT는 '이 주소가 에이전트라고 주장한다'는 것만 말해줄 뿐 특정 작업에 대해서는 아무것도 보장하지 못했습니다.
구현해야 하는 것
function supportsInterface(bytes4 interfaceId) external view returns (bool);: 컨트랙트가 특정 인터페이스를 지원하는지 ERC-165 방식으로 확인합니다.event Attested( uint256 indexed attestationId, address indexed wallet, bytes32 indexed capability, bytes32 actionDigest, bytes32 subjectHash, address attestor, uint256 subjectId, bytes32 subjectType, bytes32 evidenceHash );: 새 증명이 발급될 때마다 발생하는 이벤트로, 지갑·capability·증명자 등 핵심 정보를 기록합니다.function isAttested( SubjectRef calldata subject, bytes32 capability, bytes32 actionDigest ) external view returns (bool);: 특정 subject가 해당 capability·actionDigest로 현재 거래에서 활성 증명을 갖고 있는지 bool로 반환하는 조회용 뷰 함수입니다.function latestAttestationId( SubjectRef calldata subject, bytes32 capability, bytes32 actionDigest ) external view returns (uint256);: 같은 (subject, capability, actionDigest) 조합에서 가장 최근 발급된 증명의 ID를 반환합니다. 없으면 0을 반환합니다.function getAttestation(uint256 attestationId) external view returns (AttestationRecord memory record);: attestationId로 영구 저장된 증명 기록 전체를 조회합니다.function getActiveAttestation( SubjectRef calldata subject, bytes32 capability, bytes32 actionDigest ) external view returns (AttestationRecord memory record);: subject 기준으로 현재 거래의 활성 증명을 트랜지언트 스토리지에서 읽어 반환하며 없으면 되돌립니다.function isAttestedAddress( address wallet, bytes32 capability, bytes32 actionDigest ) external view returns (bool);: 지갑 주소가 해당 capability·actionDigest로 현재 거래에서 활성 증명을 갖고 있는지 bool로 반환합니다.function getActiveAttestationByWallet( address wallet, bytes32 capability, bytes32 actionDigest ) external view returns (AttestationRecord memory record);: 지갑 주소를 기준으로 현재 거래의 활성 증명을 읽어 반환하며 없으면 되돌립니다. msg.sender로 게이팅하는 컨트랙트가 주로 사용합니다.function attestAndCall( SubjectRef calldata subject, bytes32 capability, bytes32 evidenceHash, address wallet, ExecutionRequest calldata exec ) external payable returns (uint256 attestationId, bytes memory result);: 유일한 외부 발급 진입점으로, 증명 기록, 트랜지언트 인증 개방, 지정된 실행 프로필로 작업 실행을 한 거래 안에서 모두 처리합니다.function executeFromRelayer( AgentCall[] calldata calls, bytes calldata authData ) external payable returns (bytes[] memory results);: 에이전트 지갑이 직접 실행 프로필을 지원하려면 구현해야 하는 함수로, 레지스트리가 이 함수를 호출하면 지갑이 대상 컨트랙트를 호출해 msg.sender가 지갑 자신이 되게 합니다.
심층 설명
네 가지 인터페이스 구조
이 ERC는 기능을 네 인터페이스로 나눕니다. IERC8273(core)은 타입 정의와 Attested 이벤트, 읅기 전용 조회 함수를 담고 모든 구현이 MUST로 지원해야 합니다. IERC8273AtomicAttestation은 유일한 외부 발급 진입점 attestAndCall을 담고 구조상 '확장'이라 불리지만 사실상 MUST입니다. IERC8273ActiveAttestation(subject 기준 getActiveAttestation)과 IERC8273WalletAttestation(wallet 기준 getActiveAttestationByWallet / isAttestedAddress)은 SHOULD이며 둘 중 최소 하나는 지원해야 게이팅 조회 창구가 생깁니다. ERC-8004 통합을 표방하는 구현은 IERC8273WalletAttestation을 반드시 지원해야 합니다.
capability와 actionDigest 두 축
capability는 '어떤 범주의 권한인가'를 나타내는 굵은 식별자(예: keccak256("DEFI_ACCESS_V1"))입니다. actionDigest는 '어떤 구체적 행동에 묶였는가'를 나타내며 0이면 capability만 지정된 상태(capability-only mode)를 뜻합니다. 0이 아닌 actionDigest는 대상 컨트랙트, 함수 셀렉터, 인자, 그리고 재사용 방지를 위한 nonce나 attestationId를 반드시 포함해 도출해야 합니다. chainId는 레지스트리가 체인별로 배포되어 자연히 분리되므로 포함하지 않고 실행 프로필(profileId)도 레지스트리 내부 개념이라 포함하지 않습니다.
트랜지언트 스토리지 기반 수명
활성 인증은 EIP-1153의 TSTORE/TLOAD로 구현됩니다. keccak256(abi.encode("wallet", wallet, capability, actionDigest))와 keccak256(abi.encode("subject", subjectHash, capability, actionDigest)) 두 슬롯에 attestationId를 기록하며 거래가 끝나면 EVM이 자동으로 지웁니다. 영구 저장되는 AttestationRecord는 상태가 항상 Recorded이며 감사 기록으로만 쓰이고 활성 권한을 의미하지 않습니다.
attestAndCall 처리 절차
구현은 wallet != 0, capability != 0, exec.profileId != 0을 확인해야 하고 msg.value가 0이 아니면 actionDigest도 0이 아니어야 합니다. 이후 영구 기록을 status=Recorded로 쓰고 Attested를 발생시키며 TSTORE로 wallet/subject 슬롯에 attestationId를 씁니다. 그다음 exec.profileId에 맞는 실행 프로필을 선택해 작업을 실행하는데, 대상 DApp이 보는 msg.sender는 반드시 attested wallet이어야 합니다. 실행이 실패하거나 성공을 확인할 수 없으면 영구 기록과 트랜지언트 기록을 포함해 거래 전체를 되돌립니다.
두 가지 실행 프로필
Direct Wallet Execution Profile(AGENT_EXECUTE_V1)은 IAgentExecute를 구현한 AA/ERC-7702 지갑에 적용되며 레지스트리가 wallet.executeFromRelayer(calls, authData)를 호출해 지갑이 대상 컨트랙트를 호출하게 합니다. authData는 chainId, wallet, registry, profile, actionDigest, nonce, 유효 기간을 묶어야 합니다. ERC-4337 UserOperation Profile(ERC4337_USEROP_V1)은 기존 4337 지갑에 적용되며 UserOperation의 sender가 wallet과 같아야 하고 EntryPoint.handleOps가 되돌리지 않았다는 사실만으로 성공을 추정해서는 안 되며 영수증이나 이벤트 증명으로 성공을 확인해야 합니다. 이 프로필은 msg.value를 거부해야 합니다(handleOps는 payable이 아님).
게이팅 전용 함수와 조회용 뷰의 구분
getActiveAttestation / getActiveAttestationByWallet은 트랜지언트 저장소를 읽어 인증이 없으면 되돌리는 '게이팅 전용' 함수로, 온체인 권한 확인에 권장되는 경로입니다. 반대로 isAttested / isAttestedAddress / latestAttestationId / getAttestation은 bool이나 과거 기록을 돌려주는 조회용 뷰 함수로, 오프체인 인덱싱이나 UI 표시용이며 민감한 작업의 유일한 게이트로 써서는 안 됩니다.
capability-only 모드의 제약
actionDigest가 0인 capability-only 모드에서는 권한의 범위가 증명자의 오프체인 평가에만 의존하고 프로토콜이 calldata를 강제로 검증하지 않습니다. 그래서 이 모드는 단순 자산 이전, 권한 있는 상태 변경, 거래 내 재진입으로 증폭될 수 있는 금융 작업에 써서는 안 되며 그런 경우는 action-bound 모드를 쓰고 DApp이 재진입 방지 장치를 추가해야 합니다. 트랜지언트 슬롯은 거래가 끝날 때까지 계속 활성 상태이므로 게이트 자체가 재진입을 막아주지는 않습니다.
제안 상태
이 ERC는 현재 Draft 상태로, 아직 커뮤니티 논의가 진행 중이며 세부 사항이 바뀔 수 있는 초안입니다.