ERC-7969 DKIM 공개키 해시 레지스트리 (DomainKeys Identified Mail (DKIM) Registry)

Draft · 서명·인증 · 2025-06-11 작성

도메인 소유자가 이메일 인증 기술인 DKIM의 공개키 해시를 온체인에 등록해 누구나 블록체인에서 이메일 서명의 유효성을 신뢰 없이 확인할 수 있게 합니다.

왜 필요한가

DKIM은 이메일이 실제로 그 도메인에서 보낸 것인지 검증하는 서명 기술이지만 이 검증은 메일 서버와 DNS 안에서만 이뤄지고 블록체인에서는 확인할 방법이 없습니다. 계정 추상화(ERC-4337)와 zkEmail 기술이 늘면서 이메일 소유권을 온체인에서 신뢰 없이 증명하려는 수요가 커졌지만 DKIM 공개키를 어디에 어떤 형식으로 등록하고 조회할지에 대한 공통 표준이 없었습니다. 그 결과 프로젝트마다 DKIM 공개키 해시를 각자 다른 방식으로 관리하게 되어 지갑과 컨트랙트 사이에 호환되는 이메일 검증 기반을 만들기 어려웠습니다.

구현해야 하는 것

심층 설명

레지스트리 구조

레지스트리는 domainHash에서 keyHash로, 그리고 다시 유효 여부(bool)로 이어지는 매핑을 저장합니다. 도메인 소유자는 DNS TXT 레코드에서 추출한 DKIM 공개키의 해시를 계산해 제출하고 제3자는 이 매핑을 조회해 특정 도메인이 특정 공개키를 실제로 승인했는지 확인합니다.

도메인 해시 규칙

domainHash는 소문자로 된 도메인 또는 서브도메인 이름 전체 문자열의 해시여야 합니다. 예를 들어 example.com은 keccak256(bytes("example.com"))으로, mail.example.com은 전체 문자열을 하나로 해시합니다. 레지스트리는 도메인과 서브도메인을 서로 독립된 개체로 다루므로, example.com에 등록된 키 해시가 mail.example.com에 자동으로 적용되지 않고 각 서브도메인은 별도로 등록해야 합니다.

키 해시와 공개키 형식 규칙

keyHash는 DKIM 공개키의 암호학적 해시로, keccak256뿐 아니라 영지식증명에 적합한 Poseidon 등 구현체가 선택한 어떤 안전한 해시 함수도 쓸 수 있습니다. 공개키 자체는 RFC 6376 DNS TXT 레코드의 p= 파라미터 값 그대로여야 하며 base64로 인코딩되고 PEM 헤더나 공백·줄바꿈이 전혀 없는 원문 값이어야 합니다. 키는 유효한 RSA 공개키여야 하고 DNS에 게시된 값과 정확히 일치해야 합니다.

등록 절차

등록은 먼저 도메인의 DNS TXT 레코드에서 DKIM 공개키를 가져오고 이어서 p= 파라미터 값을 추출하며 그다음 구현체가 선택한 해시 함수로 원문 공개키의 해시를 계산하고 마지막으로 그 해시를 레지스트리에 등록하는 순서로 진행됩니다. 원문은 RFC 6376의 예시 레코드(p=MIGfMA0G...)를 들어 공개키 문자열 전체를 keccak256으로 해시해 keyHash를 만들고 도메인 이름 "example.org"를 keccak256으로 해시해 domainHash를 만든 뒤 registry.setKeyHash(domainHash, keyHash)로 등록하는 과정을 보여줍니다.

이벤트

KeyHashRegistered는 도메인에 새 DKIM 공개키 해시가 등록될 때 반드시 발생해야 하며 domainHash와 keyHash를 모두 포함합니다. KeyHashRevoked는 도메인의 키 해시가 폐기될 때 반드시 발생해야 하며 domainHash만 포함하고 폐기된 keyHash는 담지 않습니다.

조회 함수

isKeyHashValid(domainHash, keyHash)는 주어진 keyHash가 해당 domainHash에 대해 유효하게 등록돼 있으면 true, 그렇지 않으면 false를 반드시 반환해야 하는 view 함수입니다. 이 함수 하나가 외부에서 레지스트리 상태를 조회하는 유일한 표준 진입점입니다.

참조 구현

원문이 제시하는 참조 구현은 OpenZeppelin의 Ownable을 사용해 setKeyHash, setKeyHashes(여러 키 일괄 등록), revokeKeyHash를 모두 컨트랙트 소유자만 호출할 수 있도록 제한합니다. setKeyHash는 keyHash가 0이면 거부하고 revokeKeyHash는 해당 매핑 항목을 delete해 false로 되돌립니다.

제안 상태

이 ERC는 현재 Draft 상태로, 아직 확정되지 않았으며 인터페이스나 세부 규칙이 바뀌거나 논의가 멈출 수 있는 제안입니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs