ERC-8410 실행 계획 아티팩트 참조 표준 (Portable Execution Plan Artifact)
Draft · 계정·지갑 · 2026-09-04 작성
에이전트 도구가 만든 트랜잭션 계획을 전체 데이터 대신 위치·길이·다이제스트로 된 작은 참조로 지갑에 전달하고, 지갑이 직접 조회해 검증하게 하는 표준입니다.
왜 필요한가
AI 에이전트가 지갑을 대신해 트랜잭션을 준비할 때, 준비 도구가 반환한 calldata를 모델이 그대로 읽고 다시 지갑 호출의 입력값으로 재생성해야 합니다. 스왑처럼 여러 단계를 묶은 복잡한 트랜잭션일수록 이 데이터가 커져 모델이 처리해야 하는 토큰 양과 응답 시간, 비용이 함께 늘어납니다. 더 큰 문제로, 모델이 바이트를 그대로 베끼는 과정에서 일부 내용이 빠지거나 잘리거나 바뀔 수도 있습니다. 또한 지갑은 이 calldata가 실제로 어느 도구에서 나왔는지 알 방법이 없어, 에이전트가 말해주는 설명만 믿고 승인 여부를 판단해야 합니다. 승인·정리·원자성 같은 실행 조건도 에이전트의 설명에 의존하게 되어, 지갑이 독립적으로 검증하기 어렵습니다.
심층 설명
실행 계획의 기본 구조
실행 계획(execution plan) 문서는 schema_version(현재 "1" 고정), chain_id(EIP-155 체인 ID), caip2_chain_id("eip155:"+chain_id와 일치해야 함), sender(모든 단계를 보낼 계정), ordered_steps(1~4096개의 단계 배열)를 필수로 담습니다. required_capabilities, simulation_failure_policy, extensions는 선택 필드입니다. 여기 나열되지 않은 멤버가 있으면 문서 전체를 거부해야 하고, 지원하지 않는 schema_version이나 모순된 체인 값도 거부해야 합니다. 계획은 하나의 발신자와 하나의 체인으로 제한되어 지갑 하나가 전체 호출열을 검증·실행할 수 있게 합니다.
단계(step)와 kind 라벨
ordered_steps의 각 항목은 1부터 순서대로 매겨지는 step 번호, kind, transaction 객체, 선택적 revert_decode를 가집니다. transaction은 계획의 chain_id·sender와 일치하는 chain_id·from, 그리고 to·data·value(wei 단위)를 필수로, gas는 선택(권고용)으로 가집니다. 지갑은 생성자가 제공한 gas 한도를 자체 추정 없이 그대로 브로드캐스트하면 안 됩니다. kind는 execution(사용자가 요청한 호출), approval(이후 단계가 쓸 허용량 부여), allowance_cleanup(이전 단계가 부여한 허용량 회수), signature_dependent_execution(이전에 승인된 서명을 소비), other 중 하나이며 순수 표시용 라벨일 뿐이라 지갑은 이 값으로 권한을 추론하거나 calldata가 실제로 그 라벨대로 동작한다고 가정하면 안 됩니다.
required_capabilities와 atomic_batch
required_capabilities는 실행에 필요한 동작을 나열하며, 지갑이 구현하지 않은 항목이 하나라도 있으면 전체 계획을 거부해야 합니다. 이번 버전은 atomic_batch 하나만 정의하는데, 모든 단계가 하나의 트랜잭션으로 실행되어 하나라도 실패하면 전체가 되돌려지는 조건입니다. 계정 추상화 배치 실행기나 EIP-7702 위임으로 이를 만족시킬 수 있습니다. atomic_batch를 요구하지 않는 다단계 계획은 개별 트랜잭션으로 실행할 수 있지만, 이때는 반드시 순서대로, 이전 단계가 성공적으로 채굴된 뒤에만 다음 단계를 시작해야 하고 실패하면 즉시 중단해야 합니다. 능력 이름은 32개 이하, 각 1~64자의 ASCII 문자로 제한됩니다.
simulation_failure_policy
생성자는 rpc_error, execution_reverted, simulation_setup_error 세 가지 실패 상황 각각에 action(retry_same_plan/reprepare_plan/user_review)과 1~2000자의 안내문을 담은 정책을 넣을 수 있습니다. execution_reverted와 simulation_setup_error에는 retry_same_plan을 쓸 수 없습니다. 이 정책은 전적으로 권고용이라 지갑은 이를 무시할 수 있고, 어떤 경우에도 이를 브로드캐스트 승인으로 취급해서는 안 됩니다.
plan digest 계산
계획 다이제스트는 schema_version, chain_id, sender와 각 단계의 step·kind·transaction(chain_id, from, to, data, value)만 정해진 순서(이름 알파벳순이 아님)로 공백 없이 직렬화한 JSON 문자열의 keccak256 해시입니다. caip2_chain_id, gas, revert_decode, simulation_failure_policy, required_capabilities, extensions는 다이제스트에서 제외됩니다. 즉 gas 힌트나 요구 능력이 달라도 다이제스트가 같을 수 있어, 다이제스트만으로 두 계획이 완전히 동등하다고 볼 수 없습니다. 지갑은 승인 화면과 승인 기록, 브로드캐스트된 트랜잭션 해시에 이 다이제스트를 함께 표시·기록하는 것이 권장됩니다.
아티팩트 참조와 전송 방식
참조(artifact reference)는 kind("artifact_reference"), artifact_type(execution_plan 또는 typed_data_signature_request), url(https/data:/file), 그리고 https·file일 때 필수인 integrity(keccak256 다이제스트)와 bytes(바이트 길이)를 담습니다. 지갑은 길이 확인 전 URL을 열지 않고, https는 기본 포트·공인 유니캐스트 주소·리다이렉트 금지·자격증명 미부착을 지키며 응답 본문을 문서 크기 한도 내에서 읽어야 합니다(DNS 리바인딩 방지를 위해 해석된 주소를 직접 확인). data: URI는 네트워크 접근 없이 디코딩 전 인코딩 길이를 제한하고, file은 선택 지원이며 localhost/빈 호스트의 절대경로만 허용하고 integrity·bytes가 없으면 읽기 전에 거부해야 합니다. 어느 경로든 받은 길이와 다이제스트가 참조와 다르면 거부해야 합니다.
타입드 데이터 서명 요청과 EIP-5792 변환
typed_data_signature_request는 실행 계획과 별개의 문서로, 하나의 구체적인 EIP-712 메시지와 서명할 계정을 담습니다. 지원은 선택 사항이며, 실행 계획만 지원하는 지갑은 서명 요청을 거부해야 하고 서명 요청을 계획의 단계나 extensions 안에 숨겨 넣을 수도 없습니다. 또한 이 ERC는 EIP-5792의 wallet_sendCalls로 변환하는 매핑도 정의합니다(chain_id↔chainId, sender↔from, 단계의 to/data/value 대응, atomic_batch↔atomicRequired). 다만 kind, revert_decode, simulation_failure_policy, extensions는 대응 항목이 없어 변환 시 소실되고, kind가 바뀌면 계획 다이제스트도 바뀌므로 왕복 변환이 다이제스트를 보존하지 않을 수 있습니다.
제안 상태
이 제안은 2026-09-04에 생성되어 현재 Draft 상태입니다. 아직 커뮤니티 논의와 구현 경험에 따라 필드 구성, 서명 요청 형식, 전송 규칙 등이 바뀌거나 제안 자체가 멈출 수 있습니다.
쓸 때 주의할 점
- 권한 판단에 메타데이터를 쓰지 않음: 계획과 참조는 신뢰할 수 없는 입력이므로 지갑은 호출 내용을 스스로 검증해야 하며, kind, instruction, extensions, revert_decode 결과를 승인 근거로 삼으면 안 됩니다. 두 다이제스트 모두 생성자를 인증하거나 승인을 증명하지 않으며, 릴레이가 문서와 참조를 함께 바꿔치기할 수도 있습니다.
- 에이전트가 생성한 코드도 릴레이로 취급: 모델이 직접 작성해 도구를 호출하는 코드도 하나의 릴레이이며, 신뢰할 수 없는 콘텐츠로부터 생성되어 문서나 참조를 구성·변조·대체할 수 있습니다. 지갑은 이런 코드에서 온 인라인 문서도 다른 릴레이의 입력과 똑같이 검증해야 하며, 변조되지 않았다고 단정하면 안 됩니다.
- 시뮬레이션 결과를 브로드캐스트 승인으로 쓰지 않음: 시뮬레이션과 실제 채굴 사이에 상태가 바뀌어 호출이 되돌리거나 다르게 실행될 수 있습니다. 지갑은 서명 직전에 재시뮬레이션해야 하며, 저장된 시뮬레이션 결과를 브로드캐스트 승인 근거로 삼으면 안 됩니다.
- SSRF 방지: 호출자가 준 URL을 가져오는 행위는 지갑 내부 네트워크의 서비스를 노출시킬 수 있습니다. 지갑은 호스트명이 아니라 실제로 해석된 주소를 확인하고 그 주소로 바로 연결해야 하며, 그렇지 않으면 DNS 리바인딩으로 검증 후 연결 사이에 사설 주소로 바뀔 수 있습니다. 리다이렉트·자격증명·비표준 포트는 금지되고, 응답 본문은 오류 메시지에 포함하면 안 됩니다.
- 로컬 파일 접근 제한: file 참조는 지갑 자신의 파일시스템 권한으로 읽히므로, 지갑은 사용자가 지정한 디렉터리로 읽기를 제한하는 것이 권장됩니다. 누락·과대·불일치·파싱 불가 입력은 모두 구분되지 않는 동일한 실패로 처리해야 파일 내용이 오류를 통해 노출되는 것을 막을 수 있습니다.