ERC-7962 키 해시 기반 토큰 (Key Hash Based Tokens)

Review · 토큰 · 2025-05-16 작성

이더리움 주소 대신 공개키의 해시(keyHash)로 토큰 소유권을 기록해, 주소를 체인에 남기지 않고 NFT와 대체가능 토큰을 보유하고 전송할 수 있게 하는 표준입니다.

왜 필요한가

기존 ERC-721과 ERC-20은 토큰 소유권을 이더리움 주소에 묶습니다. 주소는 누구나 볼 수 있고 신원과 연결될 수 있어서 어떤 토큰을 누가 들고 있는지가 그대로 드러나고 프라이버시가 약해집니다. 또 전송 트랜잭션은 보통 소유자 주소가 직접 보내야 하므로, 토큰을 옮기려면 그 주소에 가스비로 쓸 이더가 있어야 하고 가스를 대신 내 주는 구조를 만들기도 어렵습니다. 이 제안은 소유권을 주소가 아니라 공개키의 해시로 관리해, 주소를 노출하지 않고도 소유를 증명할 수 있게 합니다. 익명 수집품, 사적인 거래, 탈중앙 신원 같은 용도에 맞고 소유권과 가스비 지불을 분리해 제3자가 가스를 대납하는 일괄 처리나 가스 후원도 가능해집니다. 스텔스 주소(ERC-5564)의 프라이버시 원칙을 토큰 소유권까지 넓히는 제안입니다.

구현해야 하는 것

심층 설명

키 해시 소유권 모델

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 상태입니다. 아직 검토 중인 단계이므로 인터페이스와 세부 명세가 앞으로 바뀔 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs