ERC-7699 ERC-20 이체 참조 확장 (ERC-20 Transfer Reference Extension)
Draft · 토큰 · 2024-04-26 작성
ERC-20 토큰을 보낼 때 송금 참조(transfer reference)를 함께 담아, 어떤 주문이나 청구서에 대한 결제인지 받은 쪽이 바로 연결할 수 있게 하는 확장 표준입니다.
왜 필요한가
ERC-20 토큰 표준에는 은행 송금의 '받는 분 통장 메모'처럼 결제에 참조를 붙이는 기능이 없습니다. 전통 금융에서는 SWIFT MT103의 70번 필드(Remittance Information)나 ISO 20022의 RmtInf 필드처럼 송금에 참조를 넣어 어떤 청구서에 대한 결제인지 쉽게 대조합니다. 반면 지금의 토큰 전송은 보낸 사람, 받는 사람, 금액만 남기 때문에, 상점이나 서비스 제공자가 특정 주문·청구서와 입금을 맞추려면 체인 밖의 외부 시스템을 쓰거나 결제 전용 프록시 컨트랙트를 따로 만들어야 합니다. 이 표준은 기존 transfer와 transferFrom에 참조를 담는 최소한의 함수를 더해, 사용자와 상점이 거래를 쉽게 식별하고 정산하도록 돕고 전통 금융과 탈중앙 금융 사이의 간극을 줄이려 합니다.
구현해야 하는 것
function transfer(address to, uint256 amount, bytes calldata transferReference) external returns (bool);: 호출자의 토큰 amount만큼을 to에게 보내면서 transferReference 참조 데이터를 함께 전달합니다. 성공 여부를 불리언으로 돌려줍니다.function transferFrom(address from, address to, uint256 amount, bytes calldata transferReference) external returns (bool);: 승인(allowance)받은 범위에서 from의 토큰을 to에게 보내면서 참조 데이터를 함께 전달합니다. 성공 여부를 불리언으로 돌려줍니다.event TransferReference(bytes32 indexed loggedReference);: 참조가 담긴 전송이 일어났음을 알리는 이벤트로, 기록용 참조 값 loggedReference를 남깁니다.
심층 설명
확장 인터페이스와 이벤트 발생 규칙
이 ERC를 채택한 ERC-20 컨트랙트는 IERC7699 인터페이스(EIP-165 식별자 0x1522573a)를 반드시 구현해야 합니다. 참조를 받는 transfer와 transferFrom은 표준 전송 동작에 더해 loggedReference를 담은 TransferReference 이벤트를 반드시 내야 합니다. 그리고 대응하는 ERC-20 Transfer 이벤트는 TransferReference 이벤트 다음에, 가급적 바로 이어서 발생해야 합니다. 클라이언트가 참조 이벤트에서 짝이 되는 Transfer 로그를 찾을 수 있게 하기 위한 순서 규칙입니다. 금액이 0인 전송도 일반 전송과 똑같이 취급해 TransferReference 이벤트를 내야 합니다.
transferReference와 loggedReference는 다를 수 있음
호출 시 넘기는 transferReference는 길이 제한이 없는 bytes 타입이고 이벤트에 남는 loggedReference는 bytes32 타입입니다. 참조가 33바이트 미만이면 그대로 복사해 남길 수도 있고 구조화된 참조 데이터를 가공·유도한 값을 남길 수도 있으며 이는 구현자의 몫입니다. 따라서 두 값이 같을 것이라고 기대해서는 안 됩니다. 참조 길이를 표준이 제한하지는 않지만 calldata와 실행 가스 비용 때문에 사용자는 자연히 짧게 쓰도록 유도됩니다.
빈 참조는 이벤트를 내지 않음
transferReference가 빈 값일 수 있습니다. 이 경우, 그리고 오직 이 경우에만 TransferReference 이벤트를 내서는 안 됩니다. 결과적으로 참조 없는 일반 ERC-20 전송과 똑같이 동작합니다. 또한 TransferReference 이벤트는 anonymous 지정자를 붙여 선언해서는 안 됩니다. 이벤트 시그니처가 로그에 남아야 구독 필터로 걸러낼 수 있기 때문입니다.
타입 선택의 이유
transferReference는 처음에 bytes32로 검토됐습니다. 전통 금융처럼 짧은 참조를 쓰거나 참조 내용의 Keccak 256 해시를 쓰도록 유도하려는 생각이었지만 서명을 포함한 참조 데이터를 넘겨 추가 검증 처리를 가능하게 하는 등 구조화된 데이터 호출의 여지를 열어 두기 위해 bytes로 결론 났습니다. 반대로 이벤트 쪽은 bytes calldata로 남기는 방안도 검토됐으나, 구독 필터에 필요한 로그 토픽 인덱싱 과정에서 내용이 해시되어 어차피 bytes32 형태가 됩니다. bytes32 타입이면 32바이트까지는 해시되지 않은, 그대로 읽을 수 있는 참조를 남길 수 있습니다. 파라미터 이름은 결제 참조가 널리 쓰이는 전통 은행 용어에 맞춰 transferReference로 정했습니다.
기존 ERC-20과의 호환성
이 확장은 기존 ERC-20 표준과 완전히 하위 호환됩니다. 새 함수는 기존 transfer·transferFrom과 나란히 함께 쓸 수 있습니다. 업그레이드 가능한 기존 ERC-20 토큰은 저장 구조(storage layout)에 영향 없이 이 기능을 추가하는 업그레이드를 할 수 있고 새로 만드는 토큰은 필요에 따라 채택 여부를 선택하면 됩니다.
제안 상태
이 문서는 2024년 4월에 만들어진 Draft(초안) 상태의 제안입니다. 내용이 앞으로 바뀌거나 진행이 멈출 수 있으므로, 구현 전에 최신 상태를 확인하는 것이 좋습니다.
쓸 때 주의할 점
- 참조 데이터의 프라이버시 노출: 결제 참조는 블록체인에 공개로 남으므로 거래나 당사자에 관한 민감한 정보가 드러날 수 있습니다. 예를 들어 0x20240002라는 참조가 기록되면 받는 쪽의 2024년 두 번째 청구서에 대한 결제라는 사실이 공개됩니다. 구현자와 사용자는 프라이버시 영향을 신중히 따져야 하며 암호화 등 프라이버시 보호 기법으로 참조 데이터를 보호하는 방안을 고려할 수 있습니다.
- 참조 값 조작 가능성: 이 ERC는 참조 데이터에 대한 검증을 규정하지 않습니다. 악의적인 사람이 참조를 조작해 사용자, 상점, 서비스 제공자를 속일 수 있습니다. 공격자가 불법 자금에 남의 참조를 붙이면 받는 쪽이 자금세탁 연루 의심 등 법적·컴플라이언스 위험을 질 수 있고 사용자가 자기가 내지 않은 결제를 발견해 환불 요청이나 분쟁을 제기하면 받는 쪽의 행정 부담이 늘어납니다. 올바른 송금인 확인과 고유하고 검증 가능한 참조 생성 방법을 구현에서 고려할 수 있으나, 이는 이 표준의 범위를 벗어난 확장 영역입니다.