ERC-7512 감사 보고서 온체인 표현 (Onchain Representation for Audits)
Draft · 서명·인증 · 2023-09-05 작성
스마트 컨트랙트 감사 결과를 컨트랙트가 읽을 수 있는 형식으로 온체인에 표현하는 표준입니다. 누가 감사했고 어떤 ERC 구현이 검증됐는지를 감사인의 서명과 함께 체인 위에서 확인할 수 있게 합니다.
왜 필요한가
스마트 컨트랙트 감사는 보안의 핵심 수단이지만 그 결과는 보통 체인 밖 문서로만 존재합니다. 그래서 어떤 컨트랙트가 감사를 받았는지, ERC-20이나 ERC-721 같은 표준을 올바르게 구현했는지를 다른 컨트랙트가 체인 위에서 확인할 방법이 없습니다. 원문은 이런 확인이 필요한 영역으로 브리지, 토큰 컨트랙트, 스마트 계정(ERC-4337)의 모듈, 전송 시 콜백을 일으키는 토큰 표준 간 상호작용을 듭니다. 예를 들어 브리지의 토큰 보관 컨트랙트에 결함이 있으면 운영이 멈추거나 담보 없는 자산이 발행될 수 있고 표준과 다르게 동작하는 토큰은 자금 손실로 이어질 수도 있습니다. 감사 여부를 온체인에서 검증할 수 있으면 그 자체로 버그가 없다는 보장은 아니지만 혁신적인 온체인 보안 시스템을 만드는 중요한 빌딩 블록이 되고 생태계 전체의 보안 보장을 강화할 수 있습니다.
심층 설명
AuditSummary 데이터 구조
감사 요약(AuditSummary)은 여섯 필드로 구성됩니다. auditor는 감사 기관 정보로 name(표시용 이름), uri(추가 정보를 얻을 주소), authors(감사를 수행하고 보고서를 작성한 사람 목록)를 담습니다. auditedContract는 감사 대상으로, chainId는 EIP-155 체인 ID의 bytes32 표현이어야 하고 deployment는 컨트랙트 배포 주소(address)여야 합니다. issuedAt은 auditHash로 식별되는 원본 감사가 발행된 시점을 담아야 합니다. ercs는 대상 컨트랙트가 구현한 ERC 목록으로, 나열된 ERC는 완전히 구현되어 있어야 하며 빈 목록일 수 있습니다. auditHash는 원본 감사 문서의 해시여야 하고 auditUri는 감사 문서를 받을 수 있는 출처를 가리키는 것이 좋습니다.
EIP-712 서명과 SignedAuditSummary
서명에는 도구 호환성이 좋은 EIP-712를 사용합니다. 주 타입은 AuditSummary이고 도메인은 name과 version만 갖는 EIP712Domain으로 값은 "ERC-7652: Onchain Audit Representation"과 "1.0"입니다. 생성한 서명을 붙여 SignedAuditSummary를 만들며 여기에는 signedAt(서명 시점)과 auditorSignature가 추가됩니다. 서명 타입(SignatureType)은 SECP256K1, BLS, ERC1271, SECP256R1 네 가지입니다. SECP256K1과 SECP256R1의 데이터는 r, s, v의 인코딩이고 ERC1271의 데이터는 chainId, address, blocknumber, 서명 바이트의 ABI 인코딩입니다. BLS는 아직 정해지지 않았습니다(TBD).
발견 사항은 다루지 않습니다
이 ERC는 감사의 발견 사항(findings)을 일부러 정의하지 않습니다. 심각도 분류를 어떻게 통일할지, 어떤 데이터를 온체인과 오프체인에 나눠 담을지 등을 엄밀히 정의하기 어려워 범위 밖으로 두었습니다. 서명된 감사 요약은 chainId와 deployment로 특정된 컨트랙트 인스턴스가 보안 감사를 받았고 나열된 ERC를 올바르게 구현한다는 뜻이며 보통 배포와 연결되는 최종 감사 리비전에 해당합니다. 다만 이 ERC를 컨트랙트가 안전하다는 증명으로 여겨서는 안 되며 관련 데이터를 추출하는 방법론일 뿐입니다. 데이터의 품질, 범위, 보장 수준에 대한 평가는 이 ERC를 통합하는 쪽의 몫입니다.
감사 요약 하나에 컨트랙트 하나
한 번의 감사가 프로토콜을 이루는 여러 컨트랙트를 다루는 경우가 많지만 초기 버전의 단순함을 위해 감사 요약 하나는 컨트랙트 하나만 참조합니다. 같은 감사에서 여러 컨트랙트를 봤다면 같은 요약을 각 컨트랙트 인스턴스에 연결할 수 있습니다. 이 방식은 인스턴스별로 지원하는 ercs를 정확히 연결할 수 있다는 장점이 있지만 감사인이 여러 번 서명해야 한다는 단점이 있습니다. 또 컨트랙트의 동작은 배포된 체인에 따라 달라지므로 chainId와 배포 주소를 함께 기록하고 범위를 EVM 기반 스마트 컨트랙트 감사로 한정해 파라미터를 더 잘 정의할 수 있게 했습니다.
키 공개와 프록시 문제
서명 키를 특정 감사인과 연결하는 방법으로는 감사인이 서명의 공개 부분을 자신의 웹사이트, 전문 페이지, 소셜 매체 등으로 공개해야 한다고 적습니다. 공개 저장소를 만드는 것은 확장으로 가능하지만 이 ERC의 범위 밖입니다. 폴리모픽(업그레이드 가능한) 컨트랙트와 프록시는 이 ERC에서 명시적으로 다루지 않으며 그 적절한 관리는 감사인과 구현자에게 맡깁니다. 비EVM 체인 지원, 다중 컨트랙트 감사와 폴리모픽 컨트랙트 지원 개선, 감사인 키 관리, 발견 사항 정의는 향후 확장 과제로 남아 있습니다.
참조 구현과 제안 상태
참조 구현은 아직 없습니다(TBD). 감사 요약을 담은 JSON으로 서명을 만드는 스크립트와 서명된 감사 요약을 검증하는 컨트랙트가 구현될 예정입니다. 이 제안은 Draft 상태로, 내용이 바뀌거나 진행이 멈출 수 있는 초기 단계의 제안입니다.
쓸 때 주의할 점
- 감사인 키 관리: 이 ERC는 참여하는 감사인의 올바른 키 관리를 전제로 합니다. 감사인의 키가 유출되면 실제로는 표준을 지키지 못하는 컨트랙트가 감사받고 ERC를 준수하는 것처럼 보일 수 있습니다. 보호 수단으로, 키 유출 시 보조 키로 기존 서명을 철회할 수 있도록 감사인의 연합(예: 감사 회사)을 정의하는 방안이 언급됩니다.