ERC-7984 기밀 대체가능 토큰 (Confidential Fungible Token)
Draft · 토큰 · 2025-07-03 작성
전송 금액과 잔액을 bytes32 포인터로 가려 외부에 공개하지 않으면서, 계좌 기반 모델로 토큰을 주고받고 제3자에게 전송 권한을 맡길 수 있게 하는 표준입니다.
왜 필요한가
ERC-20 같은 기존 대체가능 토큰은 모든 계정의 잔액과 전송 금액이 블록체인에 그대로 공개되어 누구나 조회할 수 있습니다. 그런데 급여 지급, 기관 간 정산, 기밀 디파이처럼 금액을 외부에 드러내면 안 되는 용도에는 이런 투명성이 오히려 걸림돌이 됩니다. 이를 해결하려고 완전동형암호(FHE), 영지식증명, 보안 엔클레이브 등 서로 다른 기밀 기술로 금액을 가리는 토큰들이 만들어지고 있지만, 공통 인터페이스가 없으면 각 프로젝트가 저마다 다른 방식으로 잔액과 전송을 표현하게 되어 지갑, 거래소, 디파이 프로토콜이 토큰마다 따로 연동 코드를 짜야 합니다.
구현해야 하는 것
function name() external view returns (string memory): 토큰 이름을 반환합니다.function symbol() external view returns (string memory): 토큰 심볼을 반환합니다.function decimals() external view returns (uint8): 토큰이 쓰는 소수점 자리수를 평문 uint8로 반환합니다.function contractURI() external view returns (string memory): 토큰의 메타데이터 URI를 반환합니다.function confidentialTotalSupply() external view returns (bytes32): 전체 발행량을 가리키는 포인터를 반환합니다.function confidentialBalanceOf(address account) external view returns (bytes32): 지정한 계정의 잔액을 가리키는 포인터를 반환합니다.function isOperator(address holder, address spender) external view returns (bool): spender가 현재 holder 대신 전송할 권한이 있는지 확인합니다.function setOperator(address operator, uint48 until) external: operator에게 until 시각까지 호출자 대신 전송할 권한을 부여합니다.function confidentialTransfer(address to, bytes32 amount) external returns (bytes32): 호출자의 잔액에서 to로 amount만큼 기밀 전송합니다.function confidentialTransfer(address to, bytes32 amount, bytes calldata data) external returns (bytes32): 증명 등 구현별 데이터를 함께 실어 기밀 전송합니다.function confidentialTransferFrom(address from, address to, bytes32 amount) external returns (bytes32): operator가 from의 잔액에서 to로 기밀 전송합니다.function confidentialTransferFrom(address from, address to, bytes32 amount, bytes calldata data) external returns (bytes32): 구현별 데이터를 함께 실어 operator가 대신 기밀 전송합니다.function confidentialTransferAndCall(address to, bytes32 amount, bytes calldata callData) external returns (bytes32): 기밀 전송 후 to 컨트랙트의 콜백을 호출합니다.function confidentialTransferAndCall(address to, bytes32 amount, bytes calldata data, bytes calldata callData) external returns (bytes32): 구현별 데이터와 콜백용 callData를 함께 실어 기밀 전송 후 콜백을 호출합니다.function confidentialTransferFromAndCall(address from, address to, bytes32 amount, bytes calldata callData) external returns (bytes32): operator가 대신 기밀 전송한 뒤 to 컨트랙트의 콜백을 호출합니다.function confidentialTransferFromAndCall(address from, address to, bytes32 amount, bytes calldata data, bytes calldata callData) external returns (bytes32): 구현별 데이터를 함께 실어 operator가 대신 기밀 전송한 뒤 콜백을 호출합니다.function onConfidentialTransferReceived(address operator, address from, bytes32 amount, bytes calldata data) external returns (bytes32 success);: AndCall 전송을 받은 컨트랙트가 전송 수락 여부를 처리하는 콜백 함수입니다.event ConfidentialTransfer(address indexed from, address indexed to, bytes32 indexed amount): 기밀 잔액이 바뀔 때마다 발생하며, 발행 시 from은 영 주소, 소각 시 to는 영 주소입니다.event OperatorSet(address indexed holder, address indexed operator, uint48 until): holder와 operator 쌍의 권한 만료 시각이 설정될 때 발생합니다.event AmountDisclosed(bytes32 indexed handle, uint256 amount): 포인터로 가려진 금액이 구현별 방식으로 공개될 때 발생할 수 있습니다.
심층 설명
포인터 기반 금액
이 표준에서 모든 금액은 bytes32로 표현되는 포인터입니다. 포인터는 실제 숫자 값이 아니라 그 값이 체인 위나 오프체인 어딘가에 저장되어 있음을 가리키는 참조일 뿐이며, 포인터를 풀어내고 조작하는 방식은 구현마다 다릅니다. 이렇게 설계한 이유는 FHE(완전동형암호), 영지식증명, 보안 엔클레이브 등 서로 다른 프라이버시 기술을 쓰는 구현체 모두가 같은 인터페이스를 준수할 수 있도록 하기 위해서입니다.
기본 정보 조회와 ERC-165
준수 토큰은 ERC-165를 구현해야 하며 supportsInterface가 인터페이스ID 0x4958f2a4에 대해 true를 반환해야 합니다. name(), symbol(), decimals()는 각각 토큰 이름, 심볼, 평문 uint8로 표현한 소수점 자리수를 반환합니다. contractURI()는 토큰 메타데이터 URI를 반환하며 ERC-7572 스키마를 따르는 것이 권장됩니다. confidentialTotalSupply()와 confidentialBalanceOf(account)는 총 발행량과 계정별 잔액을 각각 bytes32 포인터로 반환합니다.
오퍼레이터 모델
setOperator(operator, until)을 호출하면 호출자는 operator에게 자신을 대신해 토큰을 전송할 권한을 평문 uint48 타임스탬프인 until까지 부여합니다. 승인된 동안 operator는 holder의 토큰을 금액 제한 없이 전송할 수 있고, 한 계정은 여러 operator를 동시에 가질 수 있습니다. isOperator(holder, spender)는 현재 권한이 유효한지 확인합니다. 금액 한도를 지정하는 ERC-20식 approve 대신 시간 제한 방식을 쓴 이유는 외부 기밀 연산 시스템이 승인 금액까지 추적해야 하는 부담을 없애기 위해서입니다.
기밀 전송 함수군
confidentialTransfer(to, amount)와 data를 받는 오버로드는 호출자 본인의 잔액에서 to로 금액을 옮기며, 잔액이 부족하면 리버트할 수 있습니다. confidentialTransferFrom(from, to, amount)은 operator가 from의 잔액에서 to로 옮기는 함수로, 호출자가 from의 operator가 아니면 반드시 리버트합니다. data 매개변수는 암호학적 증명 등 구현별 정보를 담는 용도이며, 모든 전송 함수는 실제로 이동한 금액의 포인터를 반환합니다.
AndCall 콜백 흐름
confidentialTransferAndCall 계열 함수는 전송 로직이 끝난 뒤 to 주소에 콜백을 실행합니다. to에 코드가 없으면 콜백은 아무 동작 없이 성공으로 처리됩니다. 코드가 있으면 operator, from, 실제 전송 금액, callData를 담아 onConfidentialTransferReceived를 호출하며, 이 호출이 리버트하면 전체 트랜잭션이 리버트됩니다. 콜백이 false를 반환하면 토큰 컨트랙트는 받은 토큰을 원래 발신자에게 되돌리려 시도하는데, 수신 컨트랙트가 콜백 안에서 토큰을 이미 써버렸다면 이 반환은 실패할 수 있습니다.
이벤트
ConfidentialTransfer는 기밀 잔액이 바뀔 때마다, 금액이 0인 전송을 포함해 반드시 발생해야 하며, 발행 시 from은 영 주소, 소각 시 to는 영 주소여야 합니다. OperatorSet은 setOperator 호출을 포함해 holder·operator 쌍의 만료 시각이 설정될 때마다 발생해야 합니다. AmountDisclosed는 구현별 메커니즘으로 포인터 금액이 공개로 전환될 때 발생할 수 있습니다.
기술 중립 설계와 제안 상태
amount를 숫자가 아닌 bytes32 포인터로 둔 것은 FHE, 영지식증명, 보안 엔클레이브 등 어떤 기밀 기술을 쓰든 같은 인터페이스로 호환되게 하려는 선택입니다. 이 제안은 아직 Draft 상태로, 세부 규정이 바뀌거나 논의가 멈출 수 있습니다.
쓸 때 주의할 점
- 포인터 메커니즘 의존: 보안은 하부 포인터 기반 메커니즘에 의존하므로, 구현체는 사이드채널 공격을 막고 오프체인 연산의 키 관리를 제대로 해야 합니다.
- 콜백 재진입과 가스 그리핑: AndCall류 콜백은 재진입과 가스 그리핑 위험을 수반하므로, 콜백을 쓸 때는 재진입 방지 장치와 가스 한도 설정을 고려해야 합니다.