ERC-7962 키 해시 기반 토큰 (Key Hash Based Tokens)
Review · 토큰 · 2025-05-16 작성
이더리움 주소 대신 공개키의 해시(keyHash)로 토큰 소유권을 기록해, 주소를 체인에 남기지 않고 NFT와 대체가능 토큰을 보유하고 전송할 수 있게 하는 표준입니다.
왜 필요한가
기존 ERC-721과 ERC-20은 토큰 소유권을 이더리움 주소에 묶습니다. 주소는 누구나 볼 수 있고 신원과 연결될 수 있어서 어떤 토큰을 누가 들고 있는지가 그대로 드러나고 프라이버시가 약해집니다. 또 전송 트랜잭션은 보통 소유자 주소가 직접 보내야 하므로, 토큰을 옮기려면 그 주소에 가스비로 쓸 이더가 있어야 하고 가스를 대신 내 주는 구조를 만들기도 어렵습니다. 이 제안은 소유권을 주소가 아니라 공개키의 해시로 관리해, 주소를 노출하지 않고도 소유를 증명할 수 있게 합니다. 익명 수집품, 사적인 거래, 탈중앙 신원 같은 용도에 맞고 소유권과 가스비 지불을 분리해 제3자가 가스를 대납하는 일괄 처리나 가스 후원도 가능해집니다. 스텔스 주소(ERC-5564)의 프라이버시 원칙을 토큰 소유권까지 넓히는 제안입니다.
구현해야 하는 것
event KeyHashTransfer721(uint256 indexed tokenId, bytes32 indexed fromKeyHash, bytes32 indexed toKeyHash);: NFT의 소유 keyHash가 바뀔 때마다 발생하는 이벤트입니다. 발행은 fromKeyHash가 0, 소각은 toKeyHash가 0으로 기록됩니다.function name() external view returns (string memory);: 토큰 이름을 돌려줍니다.function symbol() external view returns (string memory);: 토큰 심볼을 돌려줍니다.function tokenURI(uint256 tokenId) external view returns (string memory);: 토큰 메타데이터 URI를 돌려줍니다. 메타데이터가 없으면 빈 문자열을 돌려줄 수 있습니다.function totalSupply() external view returns (uint256);: 전체 발행량을 돌려줍니다.function ownerOf(uint256 tokenId) external view returns (bytes32);: 해당 토큰의 소유자를 주소가 아니라 keyHash(bytes32)로 돌려줍니다.function nonces(bytes32 keyHash) external view returns (uint256);: 해당 keyHash의 다음 유효한 서명이 사용해야 할 논스 값을 돌려줍니다.function transfer(uint256 tokenId, bytes32 toKeyHash, bytes memory key, bytes memory signature, uint256 deadline) external;: 소유자의 공개키와 EIP-712 서명을 제시해 NFT의 소유 keyHash를 toKeyHash로 바꿉니다. 누구나 호출해 가스를 대신 낼 수 있습니다.function decimals() external view returns (uint8);: 토큰의 소수점 자릿수를 돌려줍니다.function balanceOf(bytes32 keyHash) external view returns (uint256);: 주소 대신 keyHash에 연결된 잔액을 돌려줍니다.function transfer(bytes32 fromKeyHash, bytes32 toKeyHash, uint256 amount, bytes memory key, bytes memory signature, uint256 deadline, bytes32 leftKeyHash) external;: fromKeyHash의 잔액에서 amount를 toKeyHash로 보내고 남는 금액 전부를 새 잔돈용 keyHash인 leftKeyHash로 옮깁니다.
심층 설명
키 해시 소유권 모델
key는 0x04로 시작하는 65바이트 비압축 secp256k1 공개키이고 구현은 key.length == 65 && key[0] == 0x04를 반드시 검증해야 합니다. keyHash는 keccak256(key)로 만든 bytes32 값이며 소유권 식별자로 쓰입니다. ERC-KeyHash721은 tokenId에서 keyHash로 가는 매핑을, ERC-KeyHash20은 keyHash에서 잔액으로 가는 매핑을 유지해야 합니다. 서명 검증에 쓰는 주소는 0x04 접두사를 뺀 64바이트 XY에 대한 keccak256(key[1:])에서 파생합니다. NFT는 keyHash가 0이 아니면 존재하는 것으로 봅니다.
KeyHash721의 transfer 명세
transfer(tokenId, toKeyHash, key, signature, deadline)는 현재 소유 keyHash에서 toKeyHash로 NFT를 옮깁니다. 서명 메시지는 EIP-712 구조체 Transfer(tokenId, toKeyHash, nonce, deadline)입니다. 요구 조건은 토큰이 존재할 것(fromKeyHash가 0이 아님), keccak256(key)가 현재 fromKeyHash와 같을 것, 서명이 유효할 것, block.timestamp가 deadline 이하일 것, toKeyHash가 0이 아닐 것입니다. 성공하면 KeyHashTransfer721(tokenId, fromKeyHash, toKeyHash)를 발행합니다. ownerOf는 주소 대신 bytes32 keyHash를 돌려줍니다.
KeyHash20의 UTXO식 잔돈 분리
KeyHash20의 transfer는 비트코인의 UTXO 모델을 본떠, amount를 toKeyHash로 보내고 남은 잔액 전부(balance - amount)를 leftKeyHash로 옮깁니다. 결과적으로 balanceOf[fromKeyHash]는 0이 되고 toKeyHash와 leftKeyHash에 금액이 더해집니다. leftKeyHash는 toKeyHash나 fromKeyHash와 같으면 안 되고 0이어도 안 됩니다. 전송 시 key가 calldata에 공개되므로, 잔돈을 fromKeyHash에 남기면 공개키가 이미 알려진 keyHash에 자금이 남게 됩니다. 엄격 모드는 잔액을 가진 모든 keyHash의 공개키가 아직 공개되지 않았음을 보장합니다. 잔돈이 0이어도 KeyHashTransfer20 이벤트는 정확히 한 번 발행해야 합니다.
서명 검증 절차와 논스
검증 순서는 이렇습니다. keccak256(key)가 현재 keyHash와 같은지 확인하고 EIP-712 다이제스트를 계산한 뒤 ecrecover로 서명자 주소를 복구합니다. 서명자는 address(uint160(uint256(keccak256(key[1:]))))와 같아야 하며 검증을 통과한 뒤 _keyNonces[keyHash]를 올려 재사용을 막고 block.timestamp가 deadline 이하인지 확인합니다. 논스는 keyHash별, 컨트랙트별로 관리하고 nonces(bytes32)로 조회합니다. 컨트랙트 간 재사용은 EIP-712 도메인의 verifyingContract와 chainId가 막습니다. 지갑이 도메인을 알 수 있도록 ERC-5267의 eip712Domain()을 반드시 구현해야 하고 같은 컨트랙트의 같은 keyHash에 대한 작업은 서명자가 순서대로 처리해야 합니다.
이벤트와 인덱싱 규칙
소유권이나 잔액의 모든 변화는 이벤트로 관측할 수 있어야 합니다. KeyHash721에서 토큰 생성은 fromKeyHash = bytes32(0), 소각은 toKeyHash = bytes32(0)으로 KeyHashTransfer721을 발행합니다. KeyHash20에서 생성은 KeyHashTransfer20(bytes32(0), keyHash, bytes32(0), amount, 0), 소각은 KeyHashTransfer20(keyHash, bytes32(0), bytes32(0), amount, 0)입니다. 인덱서는 이벤트마다 fromKeyHash에서 amount + leftAmount를 빼고 toKeyHash에 amount, leftKeyHash에 leftAmount를 더하되 bytes32(0)에 대한 갱신은 무시합니다. 지갑은 자신이 통제하는 keyHash 집합으로 인덱스된 toKeyHash와 leftKeyHash 토픽을 필터링해 모든 보유 내역을 복원할 수 있습니다.
approve의 의도적 생략과 일회용 키
이 표준에는 approve가 없습니다. key는 일회용으로 설계되어 전송 트랜잭션에서만 공개되고 한 번 공개된 뒤에는 보유분을 새 keyHash로 옮기는 것이 일반적입니다. 구현은 이미 공개된 keyHash의 재사용을 금지할 수 있습니다(MAY). 트랜잭션은 아무 주소나 제출할 수 있으므로 권한은 호출자 주소가 아니라 key에서 파생한 주소의 서명에 묶입니다. mint와 destroy 같은 관리 기능은 핵심 인터페이스가 아니며 제공한다면 엄격한 접근 제어와 정확한 공급량 계산, 주소를 노출하지 않는 프라이버시 모델 유지를 권고합니다. 또한 bytes32 keyHash를 쓰기 때문에 기존 ERC-721, ERC-20과 호환되지 않으며 어댑터로 기존 시스템과 연결할 수 있습니다.
제안 상태
이 제안은 현재 Review 상태입니다. 아직 검토 중인 단계이므로 인터페이스와 세부 명세가 앞으로 바뀔 수 있습니다.
쓸 때 주의할 점
- 공개키 노출과 연결 가능성: 전송할 때 공개키(key)가 calldata에 공개되고 그에 대응하는 이더리움 주소를 keccak256(key[1:])로 체인 밖에서 계산할 수 있습니다. 토큰이나 잔액마다 새 키 쌍을 쓰고 toKeyHash, leftKeyHash에 새 키를 사용해 연결 가능성을 줄여야 합니다.
- 거래 그래프는 공개됨: fromKeyHash, toKeyHash, leftKeyHash가 같은 calldata에 함께 나타나므로 컨트랙트 안의 자금 흐름은 공개적으로 추적할 수 있고 잔돈 keyHash의 사슬을 무한히 따라갈 수 있습니다. balanceOf가 공개이고 leftKeyHash가 새 값이어야 하므로 전송 전 잔액도 amount + balanceOf(leftKeyHash)로 계산됩니다. 금액이나 흐름의 비밀이 필요하면 영지식 증명이나 믹싱 같은 추가 장치가 필요합니다.
- 키 분실과 유출: key에 대응하는 비밀키를 잃어버리거나 유출당하면 토큰 통제권을 잃습니다. 비밀키는 안전한 시스템에 보관해야 하며 keyHash 자체는 체인에 공개되는 값이라 따로 보호할 필요가 없습니다.
- 서명 가변성 거부: 구현은 변형 가능한 서명을 거부해야 합니다. s 값은 곡선 차수의 아래쪽 절반에 있어야 하고 v는 27 또는 28이어야 합니다. OpenZeppelin의 ECDSA 헬퍼는 이 검사를 기본으로 수행합니다.
- 가스 비용 증가: 서명 검증과 EIP-712 해싱 때문에 일반 토큰보다 가스 비용이 늘어납니다. 구현을 최적화하고 가스 후원으로 비용을 상쇄하는 방안을 고려해야 합니다.