이전 편의 문제 정의와 설계 원칙은 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 / Submitter | UserOperation 제출만 담당. owner approval을 만들 수 없어야 함 |
| Paymaster | sponsor policy와 gas payment만 담당. wallet execution authority를 갖지 않음 |
| Owner approval signer | 사용자 기기의 Passkey proof 또는 Smart Account policy로 한정 |
| 표준 JSON-RPC | eth_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 대응 | 본 설계에서의 준비 |
|---|---|---|
validateUserOp | VERIFY frame | Passkey Verifier를 plug-in 형태로 분리 |
| Paymaster | PAYMENT frame | Fee Policy를 Action과 분리된 object로 관리 |
| Smart Account execute | EXECUTE frame | Action compiler가 실행 payload를 별도로 생성 |
| Bundler | thin relayer 또는 protocol path | Submitter를 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. 현재 경로 inventory | K_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 경로 inventory | K_D 사용처, Wallet Directory 권한 범위, tx worker 권한, Paymaster / Submitter signer 목록, 위험 조합 matrix |
| 1달 | Passkey approval PoC | WebAuthn / 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 자동결제
자동결제는 두 단계로 나눈다.
- 사용자가 자동결제 규칙을 Passkey로 사전 승인하고, Smart Account의 Policy Module에 등록한다.
- 결제 시점이 되면 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 proof | flow 생성, counterfactual address 결정, UserOperation 제출 | Smart Account / Passkey Verifier |
| 두 번째 기기 등록 | 기존 기기 Passkey approval proof | 새 기기 등록 flow 생성, 기존 기기 승인 요청, 제출 | Smart Account / Passkey Verifier |
| 지갑 복구 | recovery proof + 새 기기 Passkey public key | recovery flow 생성, proof 제출, UserOperation 제출 | Smart Account / Recovery Module |
| 자동결제 등록 | 사용자 Passkey approval proof | policy 등록 Action 생성, 제출 | Smart Account / Passkey Verifier |
| 자동결제 실행 | 사전 등록된 on-chain policy | 실행 트리거, UserOperation 제출 | Smart Account / Policy Module |
정리하면, WaaS는 계속 flow를 진행하고 제출을 담당한다. 하지만 사용자 자산 이동에 필요한 권한 근거는 사용자 기기의 approval proof, recovery proof, 또는 Smart Account에 사전 등록된 policy여야 한다.