ERC-7677 페이마스터 웹 서비스 연동 표준 (Paymaster Web Service Capability)

Review · 계정·지갑 · 2024-04-03 작성

앱이 지갑에 페이마스터(수수료 대납 서비스)의 웹 주소를 전달하고 지갑이 그 서비스와 표준화된 방식으로 통신해 앱이 사용자의 거래 수수료를 대신 내 주는 거래를 만들 수 있게 합니다.

왜 필요한가

계정 추상화(ERC-4337) 지갑에서는 페이마스터(paymaster)라는 별도 주체가 사용자 대신 거래 수수료를 낼 수 있고, 페이마스터는 보통 웹 서비스 형태로 운영됩니다. 그런데 이 표준이 나오기 전에는 앱이 지갑에게 특정 페이마스터 웹 서비스와 통신해 달라고 알려 줄 방법이 없었고 지갑이 그 서비스와 어떤 형식으로 주고받아야 하는지도 정해져 있지 않았습니다. 기존에 느슨하게 쓰이던 pm_sponsorUserOperation 방식은 서비스마다 가스 추정 방법이 달라 추정값이 제각각이었고 때로는 부족하기도 했습니다. 그 결과 앱 개발자가 사용자의 수수료를 대신 내 주고 싶어도 지갑과 페이마스터 서비스를 묶어 줄 공통 통로가 없어 후원 거래를 구현하기 어려웠습니다.

구현해야 하는 것

심층 설명

두 단계 RPC: 스텁 값과 최종 값

페이마스터 웹 서비스는 JSON-RPC 메서드 두 개를 구현합니다. pm_getPaymasterStubData는 서명 전 사용자 작업, 엔트리포인트 주소, 체인 ID, 컨텍스트 객체를 받아 가스 추정에 쓸 스텁 값을 돌려줍니다. 엔트리포인트 v0.7이면 paymasterVerificationGasLimit 같은 페이마스터 고유 가스값을 돌려줄 수 있고(MAY), paymasterPostOpGasLimit은 반드시 돌려줘야 합니다(MUST). postOp 가스는 페이마스터가 내는 비용이라 지갑의 추정을 신뢰할 수 없기 때문입니다. 지갑은 번들러에 가스 추정을 맡길 때 이 값들을 쓰는 것이 좋습니다(SHOULD). 서비스는 이 단계에서 들어온 사용자 작업을 검증해 후원하지 않을 요청이면 여기서 거절하는 것이 좋습니다(SHOULD). pm_getPaymasterData는 같은 형태의 파라미터를 받아 실제 제출에 쓰일 최종 값을 돌려줍니다. 두 메서드 모두 사용자 작업 파라미터에 서명이 없는데, 사용자는 다른 필드가 모두 채워진 뒤에 서명하기 때문입니다.

엔트리포인트 버전 감지와 isFinal

서비스는 계정이 쓰는 엔트리포인트 버전을 감지해 맞는 필드를 돌려줘야 합니다(MUST). v0.6이면 paymasterAndData 하나로, v0.7이면 paymaster와 paymasterData로 나눠 돌려줍니다. paymasterData에 서명이 들어가지 않는 경우처럼 pm_getPaymasterStubData 호출만으로 유효한 페이마스터 필드가 완성되는 때가 있는데, 이때 서비스는 isFinal: true를 돌려줘 두 번째 호출인 pm_getPaymasterData를 생략하게 할 수 있습니다(MAY).

sponsor 객체와 아이콘 표시 규칙

pm_getPaymasterStubData는 거래를 후원하는 주체를 나타내는 sponsor 객체를 돌려줄 수 있습니다(MAY). name은 후원자 이름이고 icon은 이미지를 가리키는 URI로 선택 사항입니다. 지갑은 이 정보를 사용자에게 보여 줄 수 있습니다(MAY). icon 문자열은 RFC-2397에 정의된 데이터 URI여야 하고(MUST), 이미지는 최소 96x96px 해상도의 정사각형이 좋습니다(SHOULD). 형식은 지갑에서 그리기 쉽도록 PNG, WebP, SVG 같은 무손실 또는 벡터 형식이 권장됩니다. SVG는 자바스크립트를 실행할 수 있으므로 지갑은 신뢰할 수 없는 코드가 실행되지 않도록 반드시 img 태그로 렌더링해야 합니다(MUST).

paymasterService 기능의 앱 쪽과 지갑 쪽 구현

앱은 EIP-5792 wallet_sendCalls 호출의 capabilities 필드에 paymasterService를 넣고 url과 context를 전달합니다. context는 서비스 제공자가 정의하는 자유 형식 객체로, 예시에서는 policyId 같은 값이 들어갑니다. 지갑은 wallet_getCapabilities 응답에서 체인별로 paymasterService의 supported: true를 돌려줘 지원 사실을 알려야 하고(MUST), 전달받은 서비스를 호출해 그 값을 쓰는 것이 좋습니다(SHOULD). 다만 사용자가 지갑이 제공하는 다른 페이마스터를 고르게 하는 지갑처럼 예외가 있을 수 있습니다. 서비스 장애나 사용자의 다른 선택으로 앱이 지정한 페이마스터가 결국 쓰이지 않을 수 있으므로, 앱은 자신이 전달한 페이마스터가 수수료를 내는 주체라고 가정해서는 안 됩니다(MUST NOT).

가스 추정을 지갑에 맡긴 이유

기존의 느슨한 표준인 pm_sponsorUserOperation은 페이마스터 관련 필드와 함께 갱신된 가스값까지 돌려줬습니다. 그런데 서비스 제공자마다 가스 추정 방식이 달라 추정값이 서로 다르고 때로는 부족하다는 문제가 있습니다. 그래서 이 표준은 가스 추정을 지갑에 맡깁니다. 지갑은 사용자 작업이 어느 번들러로 제출될지 같은 맥락을 더 많이 알기 때문입니다. 지갑이 정한 추정값을 기준으로 서비스에 후원을 요청하는 구조입니다. 다만 페이마스터 고유 가스값은 번들러가 과소 추정하기 쉬워서, 이 값만큼은 사정을 가장 잘 아는 페이마스터 서비스가 pm_getPaymasterStubData에서 직접 돌려줄 수 있게 했습니다.

체인 ID 파라미터를 둔 이유

페이마스터 서비스 제공자는 지금까지 보통 체인마다 별도 URL을 발급해 왔고, 멀티체인 URL은 일반적이지 않았습니다. 그래도 지갑이 어느 체인용 요청인지 전달할 방법은 필요합니다. 선택지는 체인당 URL 하나라는 관행을 그대로 표준화하는 것과 요청에 체인 ID 파라미터를 요구하는 것 두 가지였고 이 표준은 후자가 더 나은 추상화라고 봤습니다. 이렇게 하면 원하는 제공자는 멀티체인 URL을 제공할 수 있고 체인별 URL을 쓰는 제공자는 추가 파라미터를 무시하면 되므로 손해가 거의 없습니다. 체인별 URL 제공자를 쓰는 앱 개발자는 다른 체인에 보낼 때 URL만 바꾸면 됩니다.

스텁 데이터가 지켜야 할 제약

preVerificationGas는 사용자 작업의 크기와 0 바이트 대 비0 바이트 비율에 크게 좌우됩니다. 스텁 값 기준으로 추정한 preVerificationGas가 최종 값 기준으로 필요한 양보다 낮으면, 번들러가 eth_sendUserOperation에서 preVerificationGas 부족 오류를 돌려줍니다. 이를 막기 위해 서비스는 최종 데이터와 길이가 같고 0 바이트(0x00) 개수가 최종 데이터보다 많지 않은 스텁을 돌려줘야 합니다(MUST). 코드 경로에도 함정이 있습니다. 0x01을 반복한 단순 스텁은 시뮬레이션이 실패할 수 있고 유효한 스텁이라도 validatePaymasterUserOp나 postOp가 최종 값과 다른 코드 경로를 타면, 예를 들어 일찍 반환해 버리면 가스 한도가 낮게 추정돼 제출 후 out of gas 오류가 납니다. 따라서 스텁은 최종 사용자 작업과 같은 코드 경로를 타는 시뮬레이션을 만들어야 합니다(MUST).

전제 표준과 제안 상태

이 표준은 두 가지 위에 서 있습니다. 페이마스터라는 수수료 대납 구조 자체는 ERC-4337이 정의하고, 앱과 지갑이 고급 기능 지원 여부를 주고받는 틀은 EIP-5792가 정의합니다. ERC-7677은 그 위에 새 지갑 기능 하나(paymasterService)와, 그 전제가 되는 페이마스터 웹 서비스 표준 인터페이스를 더한 것입니다. 원문 상태는 검토(Review)로, 아직 최종 확정되지 않아 명세가 바뀔 수 있는 제안입니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs