Alphea App

Phase 6 구현 완료 — SDK GoTrue 인증 전환¶

commit:server|dceda06

적용된 변경¶

sdk/auth.go (완전 재작성)

• 제거: Authenticate(ctx, AuthConfig), AuthenticateWithWallet(ctx, WalletAuthConfig, Signer), AuthConfig, WalletAuthConfig, Signer 인터페이스 (Phase 1에서 서버 측이 제거한 Challenge / Verify RPC 호출하여 이미 broken 상태)
• 신규: AuthenticateWithGoTrueToken(ctx, GoTrueAuthConfig) -> (*AuthResult, error)
  • 호스트 앱은 supabase-flutter/swift/js 클라이언트로 GoTrue 로그인 수행 후 토큰을 SDK에 주입
  • 내부 동작:
    1. deriveWalletAddress(privateKey) → 노드 서명 주소
    2. NodeService.NodeChallenge(nodeID) — public RPC
    3. signChallenge(privateKey, challenge)
    4. NodeService.RegisterNode(nodeID, challenge, signature, walletAddress, deviceMeta) with Authorization: Bearer <gotrueToken> — 서버가 owner_user_id = JWT.sub 로 기록
  • Result: nodeID + nodeToken + gotrueToken + walletAddress + privateKey echo (호스트 앱이 NodeConfig.UserJWT 으로 이어받으라고)
• nodeIDForKeypair(walletAddress, deviceID) 헬퍼: rn_<short> / rn_<short>_<device> 패턴 (서버 nodeIDForAccount 과 동일)
• AuthResult.WalletAddress 의 의미: 노드 서명 keypair address (소유자 wallet 아님). 주석 추가

sdk/call.go

• rpcCallWithHeaders(httpClient, serverAddr, path, reqJSON, extraHeaders) 공용 헬퍼 추가
• rpcCallWithAuth(httpClient, serverAddr, path, reqJSON, bearerToken) — NodeAgent 없이 RegisterNode 에 Bearer 주입
• 기존 rpcCall 은 내부적으로 rpcCallWithHeaders(..., nil) 호출

sdk/node.go

• NodeConfig.UserJWT string 필드 추가 (GoTrue access token 캠시, 토큰 갱신 경로에 사용)
• NodeAgent.UpdateUserJWT(token) 퍼블릭 메소드: 호스트 앱이 Supabase 세션 갱신 시 호출. tokenManager 의 내부 캐시도 함께 갱신
• newTokenManager 시그니쳐에 userJWT 인자 추가

sdk/token.go (완전 재작성)

• tokenManager 구조체에 userJWT 필드 + updateUserJWT(token) 메소드
• refreshToken 로직:
  1. 캐시된 userJWT 없으면 즉시 에러 (token refresh requires a GoTrue JWT; call NodeAgent.UpdateUserJWT first)
  2. NodeChallenge (public) → challenge
  3. signChallenge(privateKey, ...)
  4. rpcCallWithAuth(..., RegisterNode, ..., userJWT) — agent transport 의 (만료된) 노드 토큰 대신 저장된 GoTrue JWT 를 최종 주입
  5. 응답 access_token 를 새 노드 토큰으로 반환, attempts reset
• ownerWalletAddress 제거, walletAddress (서명 키) 필드만 서버에 전송

sdk/mobile/mobile.go

• 제거: Authenticate, AuthenticateWithTimezone, AuthenticateWithWallet, Signer 인터페이스, signerAdapter, 내부 authenticate(...) 헬퍼
• 신규: AuthenticateWithGoTrueToken(serverAddr, gotrueToken, privateKey, deviceID, platform, timezone) -> string (gomobile-compatible JSON return)
• NodeAgent.UpdateUserJWT(token) gomobile 익스포트 추가

뎍번 변경 없는 곳

• sdk/api.go — Phase 2/4 에서 이미 wallet_address payload 제거 완료
• WalletService / FriendsService 호출들 — 이미 user JWT 헤더와 호환

검증¶

• go build ./... PASS
• go vet ./... PASS
• go test ./... PASS (SDK 단위·integration 테스트 전체)

DoD 체크¶

• make build, make test 통과
• sdk.Authenticate / AuthenticateWithWallet 완전 제거
• sdk.AuthenticateWithGoTrueToken 이 RegisterNode 경로로 노드 토큰 획득
• tokenManager 가 user JWT 을 RegisterNode Authorization 헤더에 실어 호출
• sdk/mobile 가 새 인증 API로 포팅됨 (gomobile 호환)

호스트 앱 사용 헤닜온 예시¶

// Flutter 예시 (supabase-flutter 사용)
final sess = await supabase.auth.signInWithPassword(email: ..., password: ...);
final gotrueToken = sess.session!.accessToken;

final kp = Alphea.generateKeypair(); // SDK provides locally
final authResultJson = await Alphea.authenticateWithGoTrueToken(
  serverAddr: 'https://edge-rpc.alphea.io',
  gotrueToken: gotrueToken,
  privateKey: kp.privateKey,
  deviceID: deviceID,
  platform: 'ios',
  timezone: 'Asia/Seoul',
);
final agent = Alphea.newNodeAgentFromAuth(authResultJson, listener);
agent.start();

// 세션 갱신 시
supabase.auth.onAuthStateChange.listen((event) {
  final freshToken = event.session?.accessToken;
  if (freshToken != null) agent.updateUserJWT(freshToken);
});

Phase 완전 종결¶

Go 원본 (서버 + SDK) GoTrue 백포트가 6개 phase 로 종결:

• Phase 1–5: 서버 측
• Phase 6 (본 이슈): Mobile SDK 측