ERC-8183 에이전트 커머스 작업 에스크로 (Agentic Commerce)
Draft · 금고·DeFi · 2026-02-25 작성
AI 에이전트나 사람이 작업을 주고받을 때 클라이언트가 예치한 대금을, 평가자가 완료를 확인하면 제공자에게, 거절되거나 기한이 지나면 클라이언트에게 돌려주는 최소한의 에스크로 표준입니다.
왜 필요한가
AI 에이전트들이 서로 작업을 맡기고 받을 때는 신뢰할 수 있는 제3자가 없는 경우가 많습니다. 클라이언트가 대금을 먼저 주면 제공자가 작업을 하지 않고 사라질 위험이 있고 반대로 작업을 먼저 시키고 나중에 주겠다고 하면 제공자가 대금을 받지 못할 위험이 있습니다. 완료 여부를 누가 판정하는지, 거절이나 기한 만료 시 환불이 어떻게 이뤄지는지에 대한 공통 규칙이 없으면 프로젝트마다 서로 호환되지 않는 에스크로 컨트랙트를 매번 새로 만들어야 하고 다른 에이전트나 지갑, 평판 시스템이 그 작업의 상태를 신뢰하고 읽어들이기도 어려워집니다.
구현해야 하는 것
createJob(provider, evaluator, expiredAt, description, hook?): 클라이언트가 제공자·평가자·만료 시각·설명·후크를 지정해 Open 상태의 작업을 생성합니다.setProvider(jobId, provider, optParams?): 제공자 없이 생성된 작업에 클라이언트가 나중에 제공자를 지정합니다.setBudget(jobId, amount, optParams?): 클라이언트 또는 제공자가 작업 대금을 설정하거나 협의합니다.fund(jobId, expectedBudget, optParams?): 클라이언트가 합의된 대금을 에스크로에 예치해 작업을 Funded 상태로 바꿉니다.submit(jobId, deliverable, optParams?): 제공자가 작업 결과물 참조를 제출해 평가를 요청하고 작업을 Submitted 상태로 바꿉니다.complete(jobId, reason, optParams?): 평가자가 작업 완료를 확정해 에스크로된 대금을 제공자에게 지급합니다.reject(jobId, reason, optParams?): 상태에 맞는 권한자(클라이언트 또는 평가자)가 작업을 거절해 대금을 클라이언트에게 환불합니다.claimRefund(jobId): 기한이 지났을 때 누구나 호출해 작업을 만료시키고 클라이언트에게 전액 환불합니다.function beforeAction(uint256 jobId, bytes4 selector, bytes calldata data) external;: 후크 컨트랙트가 핵심 함수 실행 전에 호출되어 되돌리면 해당 행동을 막을 수 있습니다.function afterAction(uint256 jobId, bytes4 selector, bytes calldata data) external;: 후크 컨트랙트가 핵심 함수 실행 후(상태 변경·토큰 전송 포함) 호출되어 되돌리면 트랜잭션 전체를 롤백시킵니다.
심층 설명
상태 기계
작업은 Open, Funded, Submitted, Completed, Rejected, Expired 여섯 상태 중 하나입니다. Open에서는 클라이언트가 예산을 정하고 아직 예치하지 않은 상태이며 클라이언트가 거절하면 종료됩니다. 클라이언트 또는 제공자가 setBudget으로 가격에 합의한 뒤 클라이언트가 fund를 호출하면 대금이 에스크로에 들어가 Funded가 됩니다. Funded에서 제공자가 submit을 호출하면 Submitted로 바뀌고 평가자는 Funded 상태에서도 거절할 수 있습니다. Submitted에서는 오직 평가자만 complete(대금을 제공자에게 지급) 또는 reject(클라이언트에게 환불)를 호출할 수 있습니다. Funded나 Submitted 상태에서 expiredAt이 지나면 누구나 claimRefund를 호출해 Expired로 만들고 환불할 수 있습니다. 이 외의 상태 전환은 허용되지 않습니다.
역할
클라이언트는 작업을 생성하고 필요하면 나중에 setProvider로 제공자를 지정하며 setBudget으로 가격에 합의하고 fund로 예치하며 Open 상태에서만 거절할 수 있고 거절·만료 시 환불을 받습니다. 제공자는 생성 시 또는 이후 지정되며 setBudget으로 가격을 제안할 수 있고 작업을 마치면 submit으로 제출해 Funded를 Submitted로 바꾸며 완료 시 대금을 받습니다. 제공자는 complete나 reject를 호출할 수 없습니다. 평가자는 작업마다 생성 시 지정되는 단일 주소로, Submitted 상태에서는 오직 평가자만 완료·거절을 판정하고 Funded 상태에서는 제출 전에 거절할 수 있습니다. 평가자는 클라이언트 자신일 수도 있고 영지식 증명 검증이나 오프체인 신호 집계 같은 임의 조건을 수행하는 스마트 컨트랙트일 수도 있습니다.
선택적 제공자
createJob 호출 시 provider를 address(0)으로 넘기면 제공자 없이 작업을 생성할 수 있습니다. 이 경우 클라이언트는 fund를 호출하기 전에 반드시 setProvider(jobId, provider)로 제공자를 지정해야 합니다. setProvider는 클라이언트만 호출할 수 있고 작업이 Open이 아니거나 이미 제공자가 설정돼 있거나 provider가 0 주소면 되돌립니다. fund도 제공자가 아직 설정되지 않았으면 되돌립니다. 이 구조는 입찰이나 생성 후 배정 같은 흐름을 지원합니다.
핵심 함수의 되돌림 조건
fund(jobId, expectedBudget)은 작업이 Open이 아니거나, 호출자가 클라이언트가 아니거나, 예산이 0이거나, 제공자가 설정되지 않았거나, 전달한 expectedBudget이 실제 job.budget과 다르면(프런트러닝 방지) 되돌립니다. submit(jobId, deliverable)은 작업이 Funded가 아니거나 호출자가 해당 작업의 제공자가 아니면 되돌리며 deliverable은 오프체인 결과물의 해시나 IPFS CID 같은 참조값입니다. complete(jobId, reason)은 Submitted가 아니거나 호출자가 평가자가 아니면 되돌리고 에스크로된 자금을 제공자에게(선택적 플랫폼 수수료를 뗀 뒤) 전달합니다. reject(jobId, reason)은 Open일 때는 클라이언트만, Funded나 Submitted일 때는 평가자만 호출할 수 있습니다. claimRefund(jobId)는 Funded나 Submitted이고 expiredAt을 지났을 때 호출 가능하며 전체 에스크로를 클라이언트에게 돌려주고 Expired로 바꿉니다.
어테스테이션과 평판 연동
complete와 reject에는 선택적인 reason(bytes32)을 붙일 수 있습니다. 이는 오프체인 증거의 해시 같은 감사용 증명 커밋먼트로, 이벤트에 포함되어 색인되고 평판 시스템과 결합할 수 있습니다. 이 표준 자체는 평판 시스템을 내장하지 않지만 ERC-8004(신뢰 없는 에이전트)와의 연동을 권장합니다. 작업이 종결 상태에 도달하면 Completed는 제공자에게 긍정적 신호, Rejected는 거절 이유와 거절한 쪽에 따라 부정적이거나 중립적 신호, Expired는 중립적이거나 다소 부정적인 신호로 매핑하도록 권장합니다. 평가자는 ERC-8004 평판 레지스트리에 피드백을 기록하거나 검증 레지스트리에 증명을 올릴 수 있으며 이런 연동은 후크를 통해 핵심 컨트랙트와 분리된 채로 구현할 수 있습니다.
수수료
구현체는 완료(Completed) 시점에만 베이시스 포인트 단위의 플랫폼 수수료를 설정 가능한 금고(treasury)로 떼어갈 수 있습니다. 이 표준은 수수료를 반드시 요구하지는 않으며 수수료가 있더라도 환불(거절·만료) 시에는 적용되지 않고 오직 완료 시에만 공제됩니다.
후크(Hooks)
작업마다 선택적으로 후크 컨트랙트를 지정할 수 있으며 핵심 로직을 수정하지 않고 프로토콜을 확장하기 위한 장치입니다. 후크는 beforeAction과 afterAction 두 함수만 가진 IACPHook 인터페이스를 구현하며 selector로 어떤 핵심 함수(setProvider, setBudget, fund, submit, complete, reject) 호출인지 구분하고 data로 해당 함수의 매개변수를 전달받습니다. beforeAction은 핵심 로직 실행 전에 호출되어 되돌리면 행동을 막을 수 있고 afterAction은 상태 변경과 토큰 전송이 끝난 뒤 호출되어 되돌리면 트랜잭션 전체가 롤백됩니다. claimRefund는 후크를 거치지 않도록 의도적으로 제외되어 악의적인 후크가 만료 후 환불을 막을 수 없습니다. 사용 예로는 사전 KYC 검사, 완료 후 평판 기록, 맞춤 수수료 분배, 두 단계 에스크로를 이용한 자금 전송, 입찰 방식의 제공자 선정 등이 있습니다.
제안 상태
이 표준은 2026년 2월 제안된 Draft 상태이며 ERC-20을 요구사항으로 둡니다. 아직 커뮤니티 논의와 검토를 거치는 중이라 상태 기계, 후크 인터페이스, 수수료 구조 등 세부 사항이 바뀌거나 제안이 멈출 수 있습니다.
쓸 때 주의할 점
- 평가자는 신뢰가 필요합니다: Submitted 이후에는 평가자가 완료나 거절을 임의로 결정할 수 있어, 고액 작업에는 ERC-8004 평판이나 스테이킹 같은 보완 장치 사용을 권장합니다.
- Funded 이후 클라이언트는 임의 회수 불가: Funded가 되면 거절은 평가자만, 제출은 제공자만 할 수 있어 클라이언트가 일방적으로 자금을 빼갈 수 없고 이는 작업을 시작한 제공자를 보호합니다.
- 분쟁 조정 기능 없음: 이 표준에는 중재나 분쟁 해결 절차가 없어 거절이나 만료는 그대로 최종 결정이 됩니다.
- 후크는 신뢰가 필요한 컨트랙트입니다: 후크는 클라이언트가 지정하고 신뢰하는 컨트랙트로, 악의적이거나 버그 있는 후크는 정상적인 행동을 되돌리거나 임의 로직을 실행할 수 있어 감사되었거나 잘 알려진 후크 사용을 권장합니다. claimRefund만은 후크를 거치지 않아 만료 후 환불은 항상 가능합니다.
- 재진입과 토큰 안전: 토큰을 전송하는 함수는 재진입 가드로 보호해야 하고 ERC-20 토큰 처리에는 SafeERC20 같은 안전한 방식을 사용해야 합니다.