ERC-8187 토큰 풀러 인터페이스 (Token Puller)

Draft · 금고·DeFi · 2026-02-27 작성

자금을 예치하거나 투자해 둔 채로도, 승인된 지출자가 정해진 한도 안에서 필요할 때 토큰을 직접 당겨 가져갈 수 있게 하는 표준 인터페이스입니다.

왜 필요한가

ERC-20의 approve/transferFrom이나 ERC-2612 permit은 지출자가 토큰을 가져가려면 소유자의 지갑에 미리 현금처럼 쓸 수 있는 잔액이 있어야 합니다. 그래서 소유자는 자금을 예치하거나 투자해 두는 대신 지갑에 그대로 묵혀야 하고 그만큼 얻을 수 있는 수익을 포기하게 됩니다. 또 결제 수단마다 자금을 나눠 담아 두어야 하고 지갑에 큰 잔액을 쥐고 있을수록 해킹 위험도 커집니다. 구독료나 정기 결제처럼 반복되는 지출은 소유자가 매번 서명하거나 개입해야 하고 한 지출자가 받은 승인 한도를 다른 지출자에게 나눠 위임할 표준 방법도 없습니다.

구현해야 하는 것

심층 설명

approvePull: 온체인 허용량 설정

소유자(msg.sender)가 특정 token에 대해 spender의 pull 허용량을 limit으로 설정합니다. 소유자가 아닌 주소가 호출하면 반드시 되돌려야(revert) 하며 limit을 0으로 설정하면 해당 spender의 권한이 취소됩니다. 기존에 (token, owner, spender) 조합으로 저장된 허용량은 새 limit으로 덮어써야 하고 성공 시 반드시 PullApproval 이벤트를 발생시켜야 합니다.

pullFrom: 토큰 당겨오기

spender가 owner로부터 amount만큼의 token을 to로 전송받는 핵심 함수입니다. 호출자의 허용량이 amount 이상이어야 하며 허용량이 무한(type(uint256).max)이 아니면 사용한 만큼 차감해야 합니다. 무한 허용량이면 차감을 생략할 수 있습니다. owner가 직접 호출하는 경우에는 허용량 검사를 생략할 수 있어 이 경우 Puller는 소싱 로직만 대신 처리하는 역할을 합니다. 소싱이 실패하거나 허용량이 부족하거나 전송이 되돌려지면 전체 호출도 되돌려야 하고 성공하면 TokensPulled 이벤트를 발생시켜야 합니다.

transferPullAllowance: 허용량 위임·반납

현재 spender(msg.sender)가 보유한 허용량의 일부(amount)를 다른 toSpender에게 (token, owner) 조합으로 넘겨줍니다. amount와 현재 허용량이 둘 다 무한이면 msg.sender의 허용량을 0으로, toSpender의 허용량을 무한으로 설정합니다. 그 외에는 msg.sender의 허용량을 amount만큼 줄이고 toSpender의 허용량을 늘립니다. toSpender를 address(0)으로 지정하면 허용량을 늘리지 않고 줄이기만 하는 방식으로 허용량을 반납할 수 있습니다. 자기 자신에게 전송하는 것은 금지되며 성공 시 TransferPullAllowance 이벤트를 발생시킵니다.

조회 함수: pullAllowance와 maxPullable

pullAllowance(token, owner, spender)는 spender가 owner로부터 당길 수 있는 token의 양을 돌려주는 조회 함수입니다. maxPullable(token, owner, upTo)는 owner로부터 실제로 당길 수 있는 최대량을 반환하며 upTo는 그 값에 도달하면 계산을 일찍 멈출 수 있게 하는 매개변수입니다. 반환값은 항상 0과 upTo 사이여야 하고 특정 spender가 실제로 당길 수 있는 최대량은 maxPullable(token, owner, pullAllowance(token, owner, spender))로 계산할 수 있습니다.

permitPull: 오프체인 서명 승인

owner의 온체인 트랜잭션 없이, EIP-712로 서명된 PullPermit 구조체(token, owner, spender, limit, nonce, deadline)로 허용량을 설정하거나 갱신합니다. 서명은 ERC-6492 규칙에 따라 EOA는 ecrecover, 컨트랙트 지갑은 ERC-1271, 아직 배포되지 않은 지갑은 매직 접미사 방식으로 검증해야 합니다. block.timestamp가 deadline을 넘겼거나 서명이 유효하지 않거나 nonce가 맞지 않으면 되돌려야 합니다. 성공하면 owner의 nonce를 증가시키고 허용량을 limit으로 덮어쓰며 PullApproval 이벤트를 발생시킵니다. 누구나(spender나 relayer 포함) 이 함수를 호출할 수 있습니다.

pullFromWithPermit: 승인과 인출을 한 번에

limit과 amount가 같은 PullPermit 서명을 이용해 허용량 설정과 토큰 인출을 하나의 트랜잭션에서 원자적으로 처리합니다. 서명의 spender는 반드시 msg.sender와 같아야 합니다. 내부적으로 permitPull을 호출하는 것과 동등하게 동작하되 이 호출이 실패해도 전체 트랜잭션을 되돌리지 않아야 합니다. 이는 누군가 먼저 permit을 제출해 선점하는 선행 실행 서비스 거부(front-run DoS) 공격을 피하기 위함입니다. permit이 실제로 적용됐다면 PullApproval에 이어 TokensPulled 이벤트가, 적용되지 않았다면 TokensPulled 이벤트만 발생합니다.

이벤트와 ERC-2612/5267 연동

PullApproval은 approvePull 또는 permitPull로 허용량이 설정·갱신될 때 발생하며 transferPullAllowance에서는 발생하지 않습니다. TokensPulled는 pullFrom과 pullFromWithPermit 호출이 성공할 때마다 반드시 발생하고 amount는 실제로 to에 전송된 금액과 정확히 같아야 합니다. TransferPullAllowance는 허용량 위임이나 반납이 성공할 때마다 발생하며 address(0)으로 반납하는 경우에도 이벤트는 그대로 발생해야 합니다. 구현체는 ERC-2612에 따른 nonces(owner)를 반드시 노출해야 하고 ERC-5267을 통해 도메인 정보를 노출하는 것이 권장됩니다.

아직 확정되지 않은 제안

이 ERC는 현재 Draft 상태로, 2026년 2월 27일 제안되어 아직 커뮤니티 논의와 검토 과정에 있습니다. 함수 시그니처나 세부 규칙이 앞으로 바뀌거나, 논의가 멈춘 채 더 진행되지 않을 수도 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs