ERC-7272 이더리움 접근 토큰 (Ethereum Access Token)

Draft · 서명·인증 · 2023-07-03 작성

오프체인 서비스가 발급한 서명 메시지(EAT)로 특정 스마트컨트랙트 함수 호출을 승인하는 표준입니다. 누가, 어떤 함수를, 언제까지 호출할 수 있는지를 온체인에서 검증합니다.

왜 필요한가

스마트컨트랙트에서 함수 접근을 제한하는 기존 방법은 역할 기반 접근 제어나 특정 NFT 보유 확인 같은 온체인 방식이 대부분입니다. 그런데 이런 방식은 짧은 시간만 유효한 접근 권한을 주기 어렵고 자격 기준이 바뀔 때마다 체인 위 데이터를 고쳐야 합니다. 온체인 명부(레지스트리)를 쓰는 경우 운영자가 명부를 항상 최신으로 유지해야 하고 갱신이 늦어지는 사이에 자격이 없어진 사람이 잘못 접근할 수 있습니다. 또 대부분의 체인은 공개되어 있어서 민감한 개인정보를 근거로 권한을 주려면 그 정보를 체인에 올려 조회해야 하는 프라이버시 문제가 생깁니다. 이 표준은 오프체인 서비스가 사용자를 원하는 방식으로 먼저 확인한 뒤, 특정 계정에 묶인 짧은 유효기간의 승인 토큰을 발급하게 해서 이 문제를 풉니다. 사용자가 승인을 요청하러 오는 구조라서 발급자는 그때마다 자격을 다시 확인할 수 있고 개인 식별 정보는 체인에 남지 않습니다.

심층 설명

EAT의 구성과 JWT와의 차이

이더리움 접근 토큰(Ethereum Access Token, EAT)은 서명과 만료 시각으로 구성됩니다. 구체적으로는 uint8 v, bytes32 r, bytes32 s의 서명 값과 uint256 expiry입니다. 서명은 EIP-712 타입 구조화 데이터 해싱·서명 표준으로 EAT 페이로드에 대해 만듭니다. 원문은 EAT가 단기 인가에 쓰인다는 점에서 JSON Web Token(JWT)과 비슷하지만 온체인에서 검증되도록 설계되었고 스마트컨트랙트 함수 호출 승인에 맞춰져 있다는 점이 다르다고 설명합니다.

서명 페이로드: AccessToken과 FunctionCall

서명 대상인 AccessToken 구조체에는 uint256 expiry와 FunctionCall functionCall 두 필드가 있습니다. FunctionCall은 네 필드로 구성됩니다. functionSignature는 호출되는 함수의 식별자(bytes4)로 msg.sig와 일치해야 합니다. target은 호출 대상 컨트랙트 주소입니다. caller는 현재 호출자 주소로 msg.sender와 일치해야 합니다. parameters는 calldata에서 앞쪽 파라미터인 v, r, s, expiry를 제거한 나머지입니다. expiry는 유닉스 타임스탬프이며 검증 시 토큰이 만료되지 않았는지를 확인하는 기준이 됩니다.

온체인 검증이 보장하는 것

EAT는 발급 시점에 특정 파라미터에 묶여야 하며(MUST), 온체인 검증은 다음을 보장합니다. 호출되는 함수가 기대한 함수인지, 함수 파라미터가 기대한 값인지, 호출자가 기대한 계정인지, 승인된 기간 안의 호출인지(만료 여부 확인), 호출 대상 컨트랙트가 기대한 컨트랙트인지, 그리고 기대한 발급자 중 하나가 서명한 유효한 승인인지를 모두 확인합니다. 이렇게 여섯 가지를 묶어 검증하기 때문에 세밀한 접근 제어가 가능합니다.

AccessTokenConsumer와 AccessTokenVerifier

참조 구현은 두 컨트랙트를 씁니다. AccessTokenConsumer는 일부 함수에 권한을 걸려는 컨트랙트가 상속하는 쪽이고 AccessTokenVerifier는 EAT 검증을 담당합니다. Consumer가 Verifier를 호출해 EAT의 무결성을 확인합니다. Verifier의 verify() 함수는 서명과 AccessToken을 입력으로 받아 토큰이 만료되지 않았는지 확인하고 재구성한 EIP-712 다이제스트와 서명으로 서명자를 복원한 뒤, 그 서명자가 유효한 기대 서명자인지 검증합니다.

설계 근거: 일회용, EIP-712, ZKP 비교

참조 구현은 EAT의 재사용 불가(일회용)를 보장하지만 다른 구현은 다른 방식을 택해도 됩니다. EIP-712를 따르면 기존 이더리움 인프라와 호환되고 최소한의 코드 수정으로 접근 제어를 만들 수 있으며 발급된 EAT가 특정 체인에 묶이는 것도 보장됩니다. 영지식 증명(ZKP)과 비교하면, ZKP는 복잡성이 커지는 비용이 있고 종류가 다양해 상호운용성이 떨어지는 반면, EAT는 서명된 메시지에 가까워 다루기 단순하고 ecrecover를 모든 이더리움 컨트랙트에서 바로 쓸 수 있습니다. 적용 범위는 넓어서 특수 함수인 receive와 fallback을 제외한 어떤 함수에도 EAT를 걸 수 있습니다.

Draft 단계의 제안

이 제안은 2023년 7월에 만들어졌고 현재 Draft 상태입니다. 아직 확정된 표준이 아니므로 명세의 세부 내용이 바뀔 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs