ERC-8426 NFT 지갑 패스 확장 (Wallet Pass Extension for NFTs)

Draft · NFT·멀티토큰 · 2026-08-07 작성

NFT 컨트랙트가 애플 월렛·구글 월렛 패스로도 제공됨을 표준 방식으로 알려, 어떤 지갑·마켓플레이스든 지갑에 추가 기능을 띄우고 소유권 이전 시 안전하게 처리하도록 합니다.

왜 필요한가

월렛 패스(애플 월렛, 구글 월렛)는 스마트폰에 기본 탑재된 프로그래머블 화면으로, 앱 설치 없이도 실시간 상태를 보여주고 플랫폼 푸시 업데이트를 받을 수 있습니다. 이미 여러 NFT 서비스가 멤버십, 티켓, 적립 포인트 같은 온체인 상태를 월렛 패스에 연결하고 있지만 각 프로젝트가 저마다 독자적인 연동 다리를 만듭니다. 그 결과 지갑, 마켓플레이스, 인덱서는 어떤 토큰에 패스가 있는지 알아낼 공통된 방법이 없고 패스 발행자들 사이에는 패스 콘텐츠가 오래됐다는 신호를 공유할 창구도 없습니다. 또한 패스 링크와 소유권을 어떻게 연결할지, 토큰이 전송됐을 때 무엇을 해야 할지 같은 보안 판단을 통합마다 각자 다시 설계하다 보니 결과가 서비스마다 들쭉날쭉해집니다.

구현해야 하는 것

심층 설명

세 가지 역할: Contract, Pass Issuer, Client

이 표준은 책임을 세 대상에 나눠 각각 독립적으로 지킵니다. Contract는 온체인에서 IERC721WalletPass 인터페이스, passURI, 이벤트만 구현합니다. Pass Issuer는 passURI가 가리키는 오프체인 서버로 매니페스트를 서비스하고 패스를 발급하며 모든 인가 검사를 수행합니다. Client는 매니페스트를 읽고 지갑에 추가 버튼을 보여주거나 챌린지 서명을 받는 지갑앱, 마켓플레이스, 인덱서 등입니다. Contract는 특정 Pass Issuer나 Client에 의존하지 않고 조건을 만족하는 어떤 Pass Issuer도 해당 Contract의 토큰을 서비스할 수 있습니다.

passURI와 패스 매니페스트 구조

passURI(tokenId)는 접근 제한이 없는 public view 함수로, tokenId가 유효하지 않으면 실패하고 패스 매니페스트 문서를 가리키는 URI를 반환합니다. 매니페스트는 JSON으로 version(현재 1), formats(플랫폼별 획득 URL, 최소 1개, apple·google 키가 정의되며 모르는 키는 무시), updatedAt(선택, 콘텐츠 최종 변경 유닉스 타임스탬프), issuer(선택, 플랫폼 서명자 식별 정보) 필드를 가집니다. Pass Issuer는 Content-Type을 application/json으로 응답해야 하며 공개 구성에서는 CORS 헤더를 공개 데이터처럼 느슨하게 허용할 수 있습니다.

발행자 신원 커밋먼트(passIssuer, 선택)

컨트랙트는 선택적으로 IERC721WalletPassIssuer(인터페이스 ID 0x470be7e9)를 구현해 passIssuer() 함수로 플랫폼 서명자 정보를 온체인에 기록할 수 있습니다. 이를 구현하면 Pass Issuer는 매니페스트의 issuer 필드를 이 값과 정확히 일치시켜야 하고 클라이언트는 온체인 값과 매니페스트, 실제 패스 서명자를 서로 비교해 불일치하면 설치를 거부해야 합니다. 불일치는 서버가 다른 서명자로 패스를 발급하고 있거나, 아직 온체인에 기록되지 않은 발행자 교체가 진행 중이라는 뜻입니다.

획득 URL: 공개 구성과 게이트 구성

획득 URL(acquisition URL)은 토큰별 패스를 실제로 받는 주소입니다. 공개 구성에서는 접근 제어 없이 매니페스트가 제공되며 passURI 자체가 공개 view 함수이므로 이 URL을 캐퍼빌리티 형태로 만들어도 소유 증명으로는 취급될 수 없습니다. 게이트 구성에서는 소유 계정 통제 증명을 거쳐야만 매니페스트나 패스를 받을 수 있고 이 경우에만 URL 소지가 소유 증명 역할을 할 수 있습니다. 게이트 구성의 Pass Issuer는 전송을 감지하거나 새 소유자의 첫 claim 시점 중 먼저 오는 쪽에서 획득 URL을 회전시켜야 합니다.

게이트 획득: 401과 챌린지

증명 없는 매니페스트 요청은 (레이트리밋이 아니면) HTTP 401과 error가 proof_required, challenge 필드를 담은 본문으로 응답해야 합니다. 챌린지 엔드포인트는 address 쿼리 파라미터로 GET 요청을 받아 챌린지 메시지를 반환하고 클라이언트는 서명 후 Wallet-Pass-Proof(base64url 메시지)와 Wallet-Pass-Signature(0x 헥스 서명) 두 헤더를 담아 매니페스트를 재요청합니다. Pass Issuer는 이 증명을 챌린지 플로어 기준과 최신 온체인 소유권 조회로 검증한 뒤에만 Cache-Control: no-store로 매니페스트를 돌려줍니다. 획득 URL은 계정별로 발급·회전되며 엔타이틀먼트를 잃은 계정이 다시 자격을 얻으면 '첫 claim'으로 취급되어 새 URL을 받습니다.

패스로 트리거되는 액션의 인가: 두 가지 체크

패스를 통해 온체인 상태를 바꾸는 모든 액션은 두 가지 독립 체크를 모두 통과해야 합니다. 첫째는 소유 계정 통제 증명으로, 서버가 발급한 챌린지(토큰, 액션, 단일 사용 논스, 만료 시각, 검증자 신원을 포함)에 대한 서명입니다. 외부소유계정은 키 서명, 컨트랙트 계정은 ERC-1271, 아직 배포되지 않은 카운터팩추얼 계정은 ERC-6492로 검증하며 챌린지는 ERC-4361(Sign-In with Ethereum) 형식이 권장됩니다. 둘째는 요청 시점의 최신 온체인 ownerOf 조회(latest 블록)로, 발급이나 URL 발행 시점이 아니라 지금 소유자인지 확인합니다. 첫째 체크는 패스나 링크가 유출되어 전달되는 경우를 막고 둘째 체크는 토큰이 팔린 뒤에도 패스가 계속 작동하는 전송 창을 막습니다. 체크가 하나만 있으면 다른 쪽 구멍이 그대로 열립니다.

서명이 없을 때: 캐퍼빌리티 구성

이메일로 온보딩되는 커스터디얼 서비스는 서버가 키를 들고 있어 액션마다 사용자 서명을 받을 수 없습니다. 이런 경우 캐퍼빌리티 구성에서는 추측 불가능한 고엔트로피 URL이 소유 통제 증명(체크1) 역할을 대신할 수 있지만 조건이 엄격합니다. 해당 링크는 토큰·액션·발급 계정에 결박되고 전송이나 소유자 요청 시 회전해야 하며 토큰 전송·소각·승인이나 엔타이틀먼트·권한 변경을 일으킬 수 없고 반복 실행 효과가 한정되고 문서화되어야 합니다. 둘째 체크(최신 소유권 조회)는 이 구성에서도 예외 없이 그대로 적용됩니다. 이 대체는 전달 방지를 포기하는 대신 그 피해 범위를 명시적으로 제한하는 절충입니다.

제안 상태: Draft

이 ERC는 현재 Draft 상태로, 아직 커뮤니티 논의와 수정이 진행 중인 초안입니다. 인터페이스 식별자, 매니페스트 필드, 인가 플로어의 세부 사항이 최종 확정 전에 바뀔 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs