01 · 로그인
로그인과 지갑 생성
유저가 하는 일은 "구글로 계속하기" 한 번이다. 그 뒤에 지갑이 만들어지고 서버에 등록되지만 화면에는 나오지 않는다.
| 단계 | 내용 |
|---|---|
| 로그인 | Dynamic이 구글 OAuth를 진행하고 자기 이름으로 서명한 JWT를 돌려준다 |
| 지갑 | 그 계정의 EVM 지갑이 없으면 만들고, 있으면 share에서 복구한다. 계정당 한 번뿐이다 |
| 검증 | 백엔드가 발급자 JWKS로 iss·exp·서명을 확인하고 sub로 유저를 UPSERT한 뒤 자체 세션 JWT를 발급한다. 이후 모든 API는 이 토큰으로 돈다 |
| 바인딩 | GET /wallet/address로 서버가 아는 주소를 먼저 확인한다. 없으면 챌린지를 받아 앱이 서명하고 POST /wallet/bind로 등록한다. 이미 있으면 기기 주소와 대조만 한다 |
지갑 — 논커스터디
| 항목 | 내용 |
|---|---|
| 키 보관 | TSS-MPC로 share를 나눠 보관하고, 서명할 때도 키를 한 곳에 합치지 않는다 |
| 서버가 아는 것 | 주소뿐이다. 스키마에 개인키 컬럼 자체가 없다 |
| 예치 서명 | EIP-712 페이로드는 서버가 만들고 서명은 앱이 한다. 릴레이어가 대신 제출한다 |
| 출금 | 가스는 어느 쪽이든 유저가 내지 않는다. 현행 볼트는 msg.sender 지분을 태우는 구조라 앱이 직접 보내고 서버가 그만큼 ETH를 선지급하며, 새로 배포한 볼트는 서명만 받아 릴레이어가 제출한다 |
| 복구 | share가 구글 계정에 묶여 있어, 앱을 지우거나 기기를 바꿔도 같은 계정으로 로그인하면 같은 주소가 돌아온다 |
| 벤더 교체 | 앱이 지갑을 WalletProvider 인터페이스 뒤에 격리했다. 인증이 지갑에 묶여 있지 않아 구현체를 갈아끼워도 계정과 원장은 유지된다 |
주소 등록은 소유 증명으로 한다. 앱이 챌린지에 서명하면 서버가 서명에서 주소를 복구해
제출된 주소와 대조한 뒤 저장한다. 클라이언트가 보낸 주소를 그대로 믿지 않는다.
지갑이 없으면 저금이 409 WALLET_NOT_BOUND로 막히고, 서버가 대신 만들어주지 않는다.
앱 데이터를 전부 지우고 같은 구글 계정으로 다시 로그인해 확인했다. 같은 주소가 돌아왔고 바인딩 시각도 처음 값 그대로였다. 새로 만든 게 아니라 복구된 것이다.
