ERC-8017 페이아웃 레이스 지급 버킷 (Payout Race)
Draft · 금고·DeFi · 2025-08-31 작성
컨트랙트가 보유한 단일 자산 전체를, 정해진 금액을 먼저 지불한 호출자에게 그대로 넘겨주는 선착순 결제 구조를 정의합니다.
왜 필요한가
프로토콜은 수수료나 수익 같은 꾸준한 현금 흐름을 다른 자산으로 바꿔야 할 때가 많습니다. 토큰 바이백, 비축 자산 적립, 인센티브 예산 마련, 금고 재조정이 대표적입니다. 이때 AMM을 쓰면 결과가 외부 풀의 유동성, 슬리피지, 수수료에 좌우되고 풀 상황이 바뀔 때마다 설정을 다시 조정해야 합니다. 온체인 경매를 계속 돌리는 방식은 운영이 복잡하고 가스비도 많이 듭니다. ERC-8017은 정해진 금액을 지불하면 버킷에 쌓인 자산 전체를 선착순으로 넘기는 결정적인 구조를 제시해 작고 감사하기 쉬운 컨트랙트로 이 문제를 해결합니다.
구현해야 하는 것
function payoutAsset() external view returns (address);: 버킷에서 나가는 지급 자산 주소를 반환합니다. address(0)이면 ETH입니다.function desiredAsset() external view returns (address);: 구매자가 내야 하는 결제 자산 주소를 반환합니다. address(0)이면 ETH입니다.function requiredPayment() external view returns (uint256);: 레이스를 이기기 위해 내야 하는 고정 결제액을 반환합니다.function paymentSink() external view returns (address);: 구매자의 결제액이 전달되는 목적지 주소를 반환합니다.function purchase(address to) external payable returns (uint256 dispensed);: 고정 결제액을 내고 버킷에 있는 지급 자산 전체를 to에게 받습니다.function setRequiredPayment(uint256 amount) external;: 관리자가 고정 결제액을 변경합니다.function setPaymentSink(address sink) external;: 관리자가 결제 수신처를 변경합니다.event Purchased(address indexed buyer, address indexed to, uint256 dispensed, uint256 paid);: 구매가 성공해 지급 자산이 전달됐을 때 발생합니다.event PaymentConfigUpdated(address desiredAsset, uint256 requiredPayment, address sink);: 결제 설정(결제 자산, 결제액, 수신처)이 바뀌었을 때 발생합니다.
심층 설명
선착순 전체 지급 방식
purchase를 호출하면 컨트랙트는 함수 진입 시점, 외부 호출을 하기 전에 payoutAsset의 현재 잔액(payoutAsset이 address(0)이면 address(this).balance, 아니면 balanceOf)을 지급액으로 확정합니다. 이 금액을 to에게 한 번의 호출로 전부 전송해야 하며 금액이 0이면 반드시 되돌려야 합니다. 즉 바구니에 쌓인 자산을 쪼개지 않고 전부 넘기는 전부 아니면 전무 방식입니다.
자산 쌍과 불변성
payoutAsset(지급 자산)과 desiredAsset(결제 자산)은 동시에 address(0)이 될 수 없습니다. 즉 ETH로 ETH를 사는 구조는 금지됩니다. 두 자산 모두 초기화 이후에는 절대 바뀌지 않아야 하며 컨트랙트는 이를 바꿀 수 있는 세터를 노출해서는 안 됩니다. 각 자산이 address(0)이면 ETH, 아니면 해당 ERC-20 토큰을 의미합니다.
결제 수금 규칙
구매자는 requiredPayment()와 정확히 같은 금액을 내야 합니다. desiredAsset이 address(0)(ETH)이면 msg.value가 requiredPayment와 같아야 하며 그 ETH는 paymentSink()로 전달됩니다. desiredAsset이 ERC-20이면 msg.value는 반드시 0이어야 하고 컨트랙트가 desiredAsset에서 transferFrom(msg.sender, paymentSink(), requiredPayment())를 호출해 결제를 받습니다.
관리자 설정과 이벤트
setRequiredPayment와 setPaymentSink는 권한이 있는 역할로만 호출할 수 있어야 하며 값이 바뀔 때마다 PaymentConfigUpdated 이벤트를 발생시켜야 합니다. 접근 제어 방식은 명세에서 정하지 않으며 EIP-173 스타일 소유권이나 역할 기반 패턴을 권장합니다. 일부 배포는 정책이나 규제 이유로 소유권을 포기하거나 역할을 제한할 수 있습니다.
선택적 확장: permit과 rescue
컨트랙트는 EIP-2612 permit 서명을 받아 같은 트랜잭션에서 승인과 결제를 끝내는 purchaseWithPermit을 추가로 제공할 수 있습니다. 이 경우 desiredAsset이 ERC-20이어야 하고 desiredAsset이 EIP-2612를 지원하지 않거나 permit 이후 허용량이 부족하면 되돌려야 합니다. 또한 payoutAsset이 아닌 다른 자산(의도치 않게 들어온 ERC-20이나 ETH)을 회수하는 관리자 전용 rescue 함수를 둘 수 있으며 이 함수는 payoutAsset을 옮길 수 없고 Rescued 이벤트를 남겨야 합니다.
파라미터 설정과 변질 상황
이 구조는 가치가 꾸준히 쌓일 때 가장 잘 작동합니다. 큰 금액이 한 번에 들어오면 필요 결제액을 훌쩍 넘겨 첫 호출자에게 초과분이 그대로 새어 나갈 수 있습니다. 지급 자산 가치가 오르면 구매가 멈추고 떨어지면 너무 자주 발생해 가치가 손실될 수도 있습니다. requiredPayment를 낮추면 변경 시점에 이미 쌓인 자산이 새 기준을 넘어 있어 서처가 싸게 가져갈 수 있고 올리면 차익거래로 수수료를 벌던 서처나 MEV 봇을 파산시킬 위험이 있습니다. 완화책으로 타임락, 예고 기간, 블록당 입금 한도, 변경 후 쿨다운, TWAP 기반 조정 등을 제시합니다.
고려된 대안: 멀티 자산 스윕
단일 지급 자산 대신 허용 목록에 등록된 여러 토큰을 구매 성공 시 같은 방식으로 한꺼번에 쓸어서 보내는 방식도 고려됐습니다. 이 ERC는 이 확장을 검토했지만 채택하지 않고 단일 자산 버킷으로 범위를 좁혔습니다.
제안 상태
ERC-8017은 현재 Draft 상태로, 명세가 아직 바뀌거나 중단될 수 있는 제안입니다.
쓸 때 주의할 점
- 재진입과 호출 순서: 결제를 받기 전에 지급액을 먼저 확정하고 결제를 모은 뒤 지급을 완료하기까지 콜백이 들어오지 않도록 Checks-Effects-Interactions 패턴과 재진입 가드를 써야 합니다.
- 수신자 제약: 받는 주소 to는 지급되는 자산을 받을 수 있어야 합니다. ETH 지급은 payable fallback이 필요하고 ERC-20 지급은 to가 transfer에서 되돌리는 컨트랙트가 아니어야 합니다.
- 결제 수신처 제약: paymentSink는 결제 자산을 받을 수 있어야 합니다. ETH라면 payable이어야 하고 ERC-20이라면 transferFrom으로 들어오는 금액을 거부하면 안 됩니다.
- 의도치 않은 전송: 컨트랙트로 직접 들어온 ETH나 ERC-20은 다음 지급에 그대로 포함됩니다. 운영자는 이를 연동 단계에서 고려해야 하며 payoutAsset이 아닌 자산을 회수하는 관리자 전용 rescue로 실수를 완화할 수 있습니다.
- 관리자 변경 보호: requiredPayment나 paymentSink를 바꿀 수 있는 세터는 거버넌스로 보호해야 합니다. 타임락, 예고 기간이 있는 변경, 바뀌면 안 되는 파라미터의 불변화 등이 흔한 완화책입니다.