이전 편의 문제 정의와 설계 원칙은 WaaS Non-Custodial 개선 설계 (1)에 있습니다.

6. Migration, 실행 계획, 오픈 질문

6.1 Track B / D 연결점

Track B 연결점은 ERC-4337 역할 분리다. Track A의 핵심은 유저 approval authority를 서버에서 제거하는 것이지만, 운영 blast radius를 줄이려면 Bundler, Paymaster, Submitter, owner approval signer도 분리해야 한다.

항목개선 방향
Bundler / SubmitterUserOperation 제출만 담당. owner approval을 만들 수 없어야 함
Paymastersponsor policy와 gas payment만 담당. wallet execution authority를 갖지 않음
Owner approval signer사용자 기기의 Passkey proof 또는 Smart Account policy로 한정
표준 JSON-RPCeth_sendUserOperation, eth_estimateUserOperationGas, eth_getUserOperationReceipt 등 교체 가능한 표면 제공
에러 모델raw revert forwarding이 아니라 구조화된 client error로 정리

Track D 연결점은 Action을 실행 포맷과 분리하는 것이다.

Action → ERC-4337 UserOperation
Action → EIP-8141 FrameTx = VERIFY + PAYMENT + EXECUTE
4337 요소8141 대응본 설계에서의 준비
validateUserOpVERIFY framePasskey Verifier를 plug-in 형태로 분리
PaymasterPAYMENT frameFee Policy를 Action과 분리된 object로 관리
Smart Account executeEXECUTE frameAction compiler가 실행 payload를 별도로 생성
Bundlerthin relayer 또는 protocol pathSubmitter를 compiler 이후 단계로 격리
EIP-1271유지 또는 VERIFY와 연계Proof of Non-Custody 검증 경로로 유지

되돌리기 어려운 결정은 특정 signer scheme을 wallet address에 하드코딩하는 것이다. 그래서 Passkey P-256을 쓰더라도 verifier plug-in 구조로 둔다.

6.2 기존 유저 이전 계획

전환 목표는 두 가지다.

1. 기존 Smart Account 주소 유지
2. 서버 대리 서명 경로 제거
단계내용
1. 현재 경로 inventoryK_D 사용처, tx worker 권한, Paymaster signer, Submitter key, recovery path 목록화
2. 기존 Smart Account capability 확인verifier module 추가, owner mutation, recovery module 추가, EIP-1271 경로, upgrade path 확인
3. Passkey approval method 등록사용자가 기존 wallet에 Passkey owner 또는 verifier binding 등록
4. Recovery Module 설정User Personal Cloud encrypted backup 또는 기존 기기 approval 기반 recovery path 설정
5. 자동결제 policy 이전signed action 보관 방식이 있다면 Policy Module 기반으로 전환
6. 서버 대리 서명 폐기K_D 기반 owner approval 경로 비활성화, 접근 권한 회수, 폐기 로그 기록
7. 검증proof 없는 UserOperation 실패, Passkey proof 기반 실행 성공, policy 범위 밖 자동결제 실패 테스트

기존 Smart Account가 verifier 교체나 module 추가를 지원하지 않으면 주소 유지와 완전한 non-custodial 전환을 동시에 달성하기 어렵다. 이때 fallback은 아래처럼 나눈다.

fallback조건단점
Wrapper / delegation account기존 account가 제한된 delegation 또는 module call을 지원구조가 복잡하고 사용자 설명이 어려움
Migration smart account기존 주소가 새 account로 권한을 위임할 수 있음기존 account 기능에 의존
신규 주소 + balance migration기존 컨트랙트에서 verifier 교체가 불가능주소 연속성 포기. 사용자 커뮤니케이션 필요

주소 유지를 위해 서버 수탁 경로를 억지로 유지하면 안 된다. 주소 유지와 non-custodial 전환이 충돌하면, 충돌 자체를 명시하고 사용자/법무/감사 관점의 선택지를 분리해야 한다.

6.3 실행 계획과 이해관계자 합의

기간목표산출물
2주현재 custody 경로 inventoryK_D 사용처, Wallet Directory 권한 범위, tx worker 권한, Paymaster / Submitter signer 목록, 위험 조합 matrix
1달Passkey approval PoCWebAuthn / P-256 approval proof, canonical Action Hash, Smart Account validation mock 또는 EIP-1271 demo, proof 없는 UserOp 실패 테스트
3달제한적 전환 설계신규 유저 Passkey-first onboarding, Paymaster signer 분리, recovery passphrase beta, 자동결제 Policy Module 설계, 기존 유저 migration plan 초안

첫 2주에는 내부 inventory뿐 아니라 이해관계자별 합의도 필요하다.

이해관계자먼저 합의할 것
테넌트 앱 개발자SDK Facade API 변경 범위, migration cutoff, 기존 integration 영향
최종 유저Passkey-first onboarding, recovery passphrase 안내, “계정 세션만으로 복구 불가” UX 문구
내부 개발팀K_D 사용처 inventory, Smart Account upgrade path, Paymaster / Submitter signer 분리 계획
감사팀K_D 폐기 timeline, append-only audit log, proof 없는 UserOp 실패 테스트 기준
법무팀non-custodial 전환 문구, 서버가 owner approval을 만들 수 없다는 기술적 근거, 기존 유저 고지 범위

초기 3개월은 되돌리기 어려운 결정을 최소화하고, Action abstraction, verifier plug-in, Wallet Directory의 비권한화, Smart Account 직접 검증 경계를 먼저 고정하는 것이 좋다.

6.4 PAKE를 유지하면서 R-A1 ~ R-A8을 모두 만족시킬 수 있는가?

조건부로 가능하다. 다만 현재처럼 PAKE 출력이나 password-derived material이 wallet signing material로 이어지는 구조라면 불가능하다.

PAKE를 유지하려면 역할을 명확히 줄여야 한다.

PAKE = account/session authentication only
Passkey = wallet execution approval
Recovery proof = approval method 복구/교체
On-chain policy = 반복 실행 권한

결론은 아래와 같다.

PAKE 프로토콜 자체는 유지 가능하다.
하지만 PAKE를 wallet control에 쓰는 현재 사용 모델은 유지할 수 없다.

6.5 PAKE의 “reset 불가”와 K-retail의 높은 패스워드 분실률은 양립 가능한가?

양립 가능하다. 단, password나 PAKE를 wallet control 재료로 쓰지 않는다는 조건이 필요하다.

이 설계에서 password reset의 의미는 아래로 제한한다.

password reset 또는 PAKE record reset = account/session authentication 복구
wallet owner 변경 = 아님
recovery policy 변경 = 아님
approval method 교체 = 별도 recovery proof 필요

포기해야 하는 것은 PAKE가 아니라 아래 모델이다.

password / PAKE reset만으로 wallet control까지 복구되는 모델

6.6 R-A2, R-A5, 서버사이드 자동화의 긴장

세 요구가 충돌하는 이유는 현재 구조에서 K_D가 너무 많은 역할을 하기 때문이다.

K_D
= 서버 대리 서명 수단
= 멀티 디바이스 동기화 보조 수단
= 서버사이드 자동화 수단

이 설계에서는 세 역할을 분리한다.

요구해결 방향
R-A2 서버 대리 서명 제거서버가 owner approval을 만들 수 없게 함. wallet execution은 action-bound Passkey proof 또는 on-chain policy로만 가능
R-A5 멀티 디바이스 유지새 기기 등록은 기존 기기 approval 또는 recovery proof 필요. Wallet Directory는 wallet address 조회만 담당
서버사이드 자동화범용 서버 서명 대신, 사용자가 사전 승인한 on-chain policy 범위 안에서만 실행

R-A5를 “계정 세션만으로 지갑 권한이 완전히 회복된다”로 해석하면 non-custodial과 충돌한다. 그래서 이 설계에서는 아래처럼 재해석한다.

계정 세션만으로 wallet address 조회와 recovery flow 진입은 가능하다.
하지만 wallet authority 회복은 기존 기기 approval 또는 recovery proof가 필요하다.

이건 UX 손실이다. 하지만 서버 수탁 없이 멀티 디바이스와 자동화를 유지하려면 필요한 trade-off라고 본다.

6.7 가장 약한 지점

가장 약한 지점은 기존 Smart Account가 verifier swap / module 추가를 지원하지 않는 경우다.

이 경우 “기존 주소 유지”와 “완전한 non-custodial 전환”을 동시에 만족시키기 어렵다. wrapper account나 migration smart account로 완화할 수는 있지만, 둘 다 기존 컨트랙트 capability에 의존한다. capability가 없으면 신규 주소 전환까지 열어둬야 한다.

실무에서는 첫 2주 안에 아래를 먼저 검증해야 한다.

- 기존 Smart Account의 upgrade path
- owner mutation path
- EIP-1271 검증 경로
- recovery module 추가 가능 여부
- K_D 기반 경로 제거 가능 여부

두 번째 약한 지점은 recovery passphrase UX다. K-retail 사용자에게 high-entropy recovery passphrase는 어려울 수 있다. Guardian을 넣으면 UX는 좋아지지만, guardian threat model이 별도로 필요하다. 그래서 본 설계에서는 guardian을 핵심 경로가 아니라 선택적 보완 경로로 둔다.

6.8 최종 요약

핵심 변화는 다섯 가지다.

1. Tenant App / embedded SDK는 WaaS API Facade를 호출한다.
2. Wallet Directory는 주소 조회용 directory일 뿐 owner source of truth가 아니다.
3. 사용자 approval은 기기 Passkey에서만 생성된다.
4. Smart Account는 WaaS의 승인 상태가 아니라 Passkey proof / recovery proof / policy를 직접 검증한다.
5. PAKE/PIN/비밀번호는 wallet approval 경로에서 제거하고, recovery passphrase는 복구 백업 암호화에만 사용한다.

결론적으로 WaaS는 계속 지갑 인프라를 운영할 수 있다. 다만 사용자 자산 이동에 필요한 최종 승인 권한은 서버가 아니라 사용자 기기와 Smart Account 정책에 남아야 한다.

부록 A. 주요 시나리오별 흐름

아래 시퀀스는 대표 flow를 예시로 보여준다. Tenant App / SDK는 flow 시작, Action preview 표시, 로컬 approval, 상태 확인을 담당한다. Wallet address 조회, Action 생성, Review, Compile, Submit은 WaaS API Facade와 WaaS Flow Backend가 수행한다.

A.1 신규 지갑 생성 · 첫 기기 등록

신규 유저는 먼저 기기에서 Passkey credential을 만든다. 이후 WaaS는 counterfactual wallet address와 canonical Action을 만들고, SDK는 사용자의 로컬 approval proof를 제출한다.

sequenceDiagram
    autonumber
    actor U as 사용자
    participant SDK as Tenant App / WaaS SDK
    participant PK as Passkey / Platform Authenticator
    participant F as WaaS API Facade
    participant B as WaaS Flow Backend
    participant SUB as Submitter / Bundler
    participant EP as ERC-4337 EntryPoint
    participant SA as Smart Account
    participant AR as Passkey Verifier
    participant CB as User Personal Cloud
Encrypted Recovery Backup

    U->>SDK: 지갑 시작
    SDK->>PK: Passkey credential 생성
    PK-->>SDK: credentialId / publicKey 반환

    SDK->>F: POST /flows
type=CREATE_WALLET, passkeyPublicKey
    F->>B: flow 생성
    B->>B: Wallet Directory 조회
    B->>B: counterfactual wallet address 결정
    B->>B: CREATE_WALLET canonical Action 생성
    B->>B: policy / risk / fee 검토
    B->>B: action hash / challenge 생성
    B-->>F: approval request 저장
    F-->>SDK: flowId + Action preview + challenge

    SDK-->>U: Action preview 표시
    SDK->>PK: challenge 서명 요청
    U->>PK: 로컬 사용자 검증
    PK-->>SDK: approval proof 반환

    SDK->>F: POST /flows/{flowId}/approvals
approval proof 제출
    F->>B: flow 재개
    B->>B: proof 정규화
    B->>B: UserOperation 구성
    B->>SUB: 제출 요청
    SUB->>EP: handleOps 호출
    EP->>SA: validateUserOp / execute
    SA->>AR: Passkey proof 검증
    AR-->>SA: 검증 성공
    SA->>SA: Smart Account 배포 / 첫 Passkey 등록
    SA-->>EP: 실행 성공
    EP-->>SUB: 처리 완료
    SUB-->>B: tx result
    B-->>F: confirmed
    F-->>SDK: wallet address 반환
    SDK-->>U: 지갑 생성 완료

    opt 복구 백업 설정
        U->>SDK: 복구 백업 설정
        SDK->>SDK: recovery material 생성
        SDK->>SDK: high-entropy recovery passphrase 설정
        SDK->>SDK: recovery material 로컬 암호화
        SDK->>CB: encrypted recovery backup 업로드
(ciphertext only)
        CB-->>SDK: 저장 완료
        SDK->>F: backup configured 이벤트
        F->>B: 감사 로그 기록
    end

A.2 두 번째 기기 등록 · 지갑 동기화

새 기기가 스스로 wallet authority를 얻으면 안 된다. 새 기기는 등록 요청만 만들고, 기존 등록 기기가 새 기기의 Passkey public key를 포함한 Action을 승인한다.

sequenceDiagram
    autonumber
    actor U as 사용자
    participant NEW as 새 기기 / Tenant App SDK
    participant PK2 as 새 기기 Passkey
    participant OLD as 기존 기기 / Tenant App SDK
    participant PK1 as 기존 기기 Passkey
    participant F as WaaS API Facade
    participant B as WaaS Flow Backend
    participant SUB as Submitter / Bundler
    participant EP as ERC-4337 EntryPoint
    participant SA as Smart Account
    participant AR as Passkey Verifier

    U->>NEW: 새 기기에서 지갑 연결 시작
    NEW->>PK2: 새 기기 Passkey credential 생성
    PK2-->>NEW: credentialId / publicKey 반환

    NEW->>F: POST /flows
type=ADD_DEVICE, newPasskeyPublicKey
    F->>B: flow 생성
    B->>B: Wallet Directory에서 wallet address 조회
    B->>B: 기존 등록 기기 notification route 확인
    B->>B: ADD_DEVICE canonical Action 생성
    B->>B: action hash / challenge 생성
    B-->>F: 기존 기기 승인 대기 상태 저장
    F-->>NEW: flowId + pending_existing_device_approval

    F-->>OLD: 기존 기기에 승인 요청 push / inbox event
    OLD-->>U: 새 기기 등록 Action preview 표시
    OLD->>PK1: challenge 서명 요청
    U->>PK1: 로컬 사용자 검증
    PK1-->>OLD: approval proof 반환

    OLD->>F: POST /flows/{flowId}/approvals
기존 기기 approval proof 제출
    F->>B: flow 재개
    B->>B: proof 정규화
    B->>B: UserOperation 구성
    B->>SUB: 제출 요청
    SUB->>EP: handleOps 호출
    EP->>SA: validateUserOp / execute
    SA->>AR: 기존 등록 Passkey proof 검증
    AR-->>SA: 검증 성공
    SA->>SA: 새 기기 Passkey 등록
    SA-->>EP: 실행 성공
    EP-->>SUB: 처리 완료
    SUB-->>B: tx result
    B-->>F: confirmed
    F-->>NEW: 지갑 동기화 완료
    NEW-->>U: 새 기기 사용 가능

A.3 지갑 복구

복구는 기존 기기가 없는 경우의 흐름이다. WaaS는 복구 flow를 오케스트레이션하지만 recovery material을 보관하지 않는다. 복구 백업은 사용자의 개인 Cloud에 암호문으로 저장되고, 복호화는 사용자 기기의 SDK가 high-entropy recovery passphrase로 수행한다.

sequenceDiagram
    autonumber
    actor U as 사용자
    participant SDK as 새 기기 / Tenant App SDK
    participant PK as 새 기기 Passkey
    participant F as WaaS API Facade
    participant B as WaaS Flow Backend
    participant CB as User Personal Cloud
Encrypted Recovery Backup
    participant SUB as Submitter / Bundler
    participant EP as ERC-4337 EntryPoint
    participant SA as Smart Account
    participant RM as Recovery Module

    U->>SDK: 지갑 복구 시작
    SDK->>F: POST /flows
type=RECOVER_WALLET, tenantUserRef 또는 backup locator
    F->>B: recovery flow 생성
    B->>B: Wallet Directory에서 wallet address 조회
    B->>B: backup locator 후보 확인
    B->>B: recovery challenge 생성
    B-->>F: 복구 가능 상태 저장
    F-->>SDK: flowId + wallet address + backup locator + recovery challenge

    SDK->>CB: 개인 Cloud에서 encrypted recovery backup 다운로드
    CB-->>SDK: encrypted backup ciphertext 반환
    U->>SDK: recovery passphrase 입력
    SDK->>SDK: passphrase entropy policy 확인
    SDK->>SDK: recovery material 로컬 복호화
    SDK->>SDK: recovery proof 생성

    SDK->>PK: 새 기기 Passkey credential 생성
    PK-->>SDK: credentialId / publicKey 반환

    SDK->>F: POST /flows/{flowId}/approvals
newPasskeyPublicKey + recovery proof
    F->>B: flow 재개
    B->>B: RECOVER_WALLET canonical Action 생성
    B->>B: recovery proof 정규화
    B->>B: UserOperation 구성
    B->>SUB: 제출 요청
    SUB->>EP: handleOps 호출
    EP->>SA: validateUserOp / execute
    SA->>RM: recovery proof 검증
    RM-->>SA: 검증 성공
    SA->>SA: 새 Passkey 등록 / 기존 approval method 갱신
    SA-->>EP: 실행 성공
    EP-->>SUB: 처리 완료
    SUB-->>B: tx result
    B-->>F: confirmed
    F-->>SDK: 지갑 복구 성공
    SDK-->>U: 새 기기에서 지갑 사용 가능

A.4 자동결제

자동결제는 두 단계로 나눈다.

  1. 사용자가 자동결제 규칙을 Passkey로 사전 승인하고, Smart Account의 Policy Module에 등록한다.
  2. 결제 시점이 되면 WaaS scheduler 또는 authorized tenant backend가 실행을 트리거한다. Smart Account는 매 실행마다 policy 범위를 검증한다.

자동결제 policy는 최소한 아래 조건을 가진다.

type RecurringPaymentPolicy = {
  policyId: string;
  merchant: string;
  token: string;
  amountCap: string;
  interval: number;
  expiry: number;
  allowedExecutor: string;
  nonce: string;
};

A.4.1 자동결제 규칙 등록

sequenceDiagram
    autonumber
    actor U as 사용자
    participant SDK as Tenant App / WaaS SDK
    participant PK as Passkey / Platform Authenticator
    participant F as WaaS API Facade
    participant B as WaaS Flow Backend
    participant SUB as Submitter / Bundler
    participant EP as ERC-4337 EntryPoint
    participant SA as Smart Account
    participant AR as Passkey Verifier
    participant APM as Policy Module

    Note over U,APM: 1단계 — 사용자가 자동결제 규칙을 사전 승인하고 on-chain policy로 등록

    U->>SDK: 자동결제 설정 시작
    SDK->>F: POST /flows
type=REGISTER_RECURRING_POLICY
    F->>B: flow 생성
    B->>B: 자동결제 policy 초안 생성
    B->>B: POLICY_REGISTER canonical Action 생성
    B->>B: 정책 / 위험 / 수수료 검토
    B->>B: action hash / challenge 생성
    B-->>F: approval request 저장
    F-->>SDK: flowId + policy preview + challenge

    SDK-->>U: 자동결제 규칙 preview 표시
    SDK->>PK: challenge 서명 요청
    U->>PK: 로컬 사용자 검증
    PK-->>SDK: approval proof 반환

    SDK->>F: POST /flows/{flowId}/approvals
approval proof 제출
    F->>B: flow 재개
    B->>B: proof 정규화
    B->>B: UserOperation 구성
    B->>SUB: 제출 요청
    SUB->>EP: handleOps 호출
    EP->>SA: validateUserOp / execute
    SA->>AR: Passkey proof 검증
    AR-->>SA: 검증 성공
    SA->>APM: 자동결제 policy 등록
    APM-->>SA: 등록 완료
    SA-->>EP: 실행 성공
    EP-->>SUB: 처리 완료
    SUB-->>B: tx result
    B-->>F: confirmed
    F-->>SDK: 자동결제 활성화
    SDK-->>U: 자동결제 활성화 안내

A.4.2 결제 시점 실행

sequenceDiagram
    autonumber
    actor U as 사용자
    participant SDK as Tenant App / WaaS SDK
    participant SCH as WaaS Scheduler / authorized tenant backend
    participant F as WaaS API Facade
    participant B as WaaS Flow Backend
    participant PMS as Paymaster Service
    participant SUB as Submitter / Bundler
    participant EP as ERC-4337 EntryPoint
    participant PM as Paymaster Contract
    participant SA as Smart Account
    participant APM as Policy Module

    Note over SCH,APM: 2단계 — 서비스는 실행을 트리거하고 Smart Account가 policy 범위를 검증

    SCH->>F: POST /policies/{policyId}/execute
결제 기한 도래 / 실행 트리거
    F->>B: policy execution flow 생성
    B->>B: 등록된 policy 기준 POLICY_EXECUTE Action 생성
    B->>B: 실행 조건 / 대납 정책 검토
    B->>PMS: paymasterAndData 요청
    PMS-->>B: paymasterAndData 반환
    B->>B: UserOperation 구성
    B->>SUB: 제출 요청
    SUB->>EP: handleOps 호출
    EP->>PM: validatePaymasterUserOp
    PM-->>EP: 승인
    EP->>SA: validateUserOp / execute
    SA->>APM: policy execution 검증
    Note right of APM: merchant / amountCap / interval / allowedExecutor / nonce / expiry 확인
    APM-->>SA: 실행 가능
    SA->>SA: 자동결제 실행
    SA-->>EP: 실행 성공
    EP-->>SUB: 처리 완료
    SUB-->>B: tx result
    B-->>F: 결제 완료
    F-->>SDK: 결제 완료 알림 / webhook
    SDK-->>U: 자동결제 완료 알림

A.5 시나리오별 핵심 차이

시나리오권한 근거서버 역할최종 검증
신규 지갑 생성새 기기 Passkey approval proofflow 생성, counterfactual address 결정, UserOperation 제출Smart Account / Passkey Verifier
두 번째 기기 등록기존 기기 Passkey approval proof새 기기 등록 flow 생성, 기존 기기 승인 요청, 제출Smart Account / Passkey Verifier
지갑 복구recovery proof + 새 기기 Passkey public keyrecovery flow 생성, proof 제출, UserOperation 제출Smart Account / Recovery Module
자동결제 등록사용자 Passkey approval proofpolicy 등록 Action 생성, 제출Smart Account / Passkey Verifier
자동결제 실행사전 등록된 on-chain policy실행 트리거, UserOperation 제출Smart Account / Policy Module

정리하면, WaaS는 계속 flow를 진행하고 제출을 담당한다. 하지만 사용자 자산 이동에 필요한 권한 근거는 사용자 기기의 approval proof, recovery proof, 또는 Smart Account에 사전 등록된 policy여야 한다.