ERC-7895 서브 계정 연결 지갑 API (API for Hierarchical Accounts)
Draft · 계정·지갑 · 2025-02-18 작성
앱이 wallet_addSubAccount를 호출해 앱 전용 스마트 계정을 범용 지갑이 소유자가 되는 서브 계정으로 추가하거나 새로 만들도록 요청할 수 있게 합니다.
왜 필요한가
앱마다 전용으로 만드는 임베디드 계정이 늘어나면서 사용자는 여러 주소를 따로 기억하고 관리해야 합니다. 스마트 계정 하나가 다른 스마트 계정을 소유하는 계층적 소유 관계는 이미 기술적으로 가능하지만 앱이 이런 임베디드 계정의 존재를 사용자의 범용 지갑에 알려줄 표준화된 방법이 없었습니다. 그 결과 사용자는 범용 지갑으로 앱 전용 계정을 한곳에서 통제하지 못하고 자산이 여러 계정에 흩어진 채로 남습니다.
구현해야 하는 것
addSubAccount: { account: CreateAccount | DeployedAccount | UndeployedAccount; }: wallet_connect 호출 안에 포함할 수 있는 capability로, 연결 과정에서 바로 서브 계정을 추가합니다.subAccounts: { address: `0x${string}`; factory?: `0x${string}`; factoryData?: `0x${string}`; }[];: 범용 계정에 연결된 모든 서브 계정 목록(이미 추가된 것 포함)을 조회하는 응답 형식입니다.addSubAccount: { supported: true, keyTypes: ("address" | "p256" | "webcrypto-p256" | "webauthn-p256")[]; }: wallet_getCapabilities 응답에 포함되어 지갑이 서브 계정 추가를 지원하는지와 지원하는 서명 키 종류를 알려줍니다.
심층 설명
세 가지 계정 유형
CreateAccount는 키를 지정하지 않으면 지갑이 서명 키를 직접 생성·관리하고 앱이 원하면 keys 배열로 서명 키를 지정할 수 있습니다. DeployedAccount는 이미 배포된 기존 계정을 address만으로 지갑에 가져오는(import) 방식입니다. UndeployedAccount는 앱이 이미 만들었지만 아직 배포하지 않은 계정으로, address, factory, factoryData를 모두 요구하며 지갑이 배포 시점을 결정합니다.
소유 관계 검증 규칙
CreateAccount의 경우 지갑은 범용 계정을 새로 만든 계정의 소유자로 만들어야 합니다(SHOULD). UndeployedAccount의 경우 지갑은 factoryData를 디코딩하거나 배포를 시뮬레이션해서 범용 계정과의 계층 관계가 실제로 성립하는지 검증해야 합니다(SHOULD).
응답 필드의 선택성
응답의 factory와 factoryData는 선택 항목이며 가능하면 포함되어야 합니다(SHOULD). 이미 배포된 계정(DeployedAccount)의 경우에는 이 필드들이 없을 수 있습니다.
wallet_connect 확장 capability
이 제안은 ERC-5792 capability 규격을 포함하는 연결 RPC에 맞춰 addSubAccount capability로 연결 시점에 바로 서브 계정을 추가하고 subAccounts capability로 범용 계정에 연결된 모든 서브 계정(추가된 것 포함) 목록을 조회할 수 있게 합니다.
wallet_getCapabilities 지원 선언
ERC-5792의 wallet_getCapabilities 응답에 체인별로 addSubAccount 항목이 추가되어 supported 여부와 지갑이 받아들이는 서명 키 타입(address, p256, webcrypto-p256, webauthn-p256) 목록을 알려줍니다.
메서드 이름 선정 배경
wallet_linkAccount, wallet_importAddress, wallet_addAddress 등의 이름과 생성·추적을 별도 RPC로 나누는 방식도 검토되었으나, 단일 메서드 wallet_addSubAccount로 통합되었습니다. 이 이름은 EOA를 포함한 용도까지 포괄하기에 더 적합하다고 설명합니다.
아직 변경될 수 있는 초안
이 제안은 현재 Draft 상태이므로 메서드 이름, 파라미터 구조, capability 세부 내용이 앞으로 바뀌거나 논의가 중단될 수 있습니다.
쓸 때 주의할 점
- capability 증가에 따른 상호작용 위험: 기능이 늘어날수록 예측하기 어려운 상호작용이 생길 수 있어 주의가 필요합니다. 앱 전용 계정은 자산 측면에서 더 큰 위험을 지니지만 범용 계정이 이를 소유하면 사용자 자산에 추가적인 보안을 더할 수 있습니다.
- 계정 데이터와 프라이버시: 계정 데이터와 공유되는 capability 정보는 데이터 유출이나 중간자 공격을 막기 위해 안전하게 처리되어야 합니다.