본문으로 건너뛰기

2026-07-19

deviceId에서 userHash로 전환 — 텔레메트리 사용자 식별값을 SDK가 생성하던 설치 단위 deviceId에서 dApp이 제공하는 userHash(VerifyVASP UserHash 규격, IVMS101 기반 SHA-256)로 변경했습니다.

추가​

  • AppKit에 userHash 옵션을 추가해 dApp이 텔레메트리 사용자 식별값을 직접 전달하도록 했습니다.
  • 사용자 식별값 함수 제공: computeUserHash(IVMS101 → 64자 16진수 UserHash), getOrCreateFallbackUserHash(설치 단위 UUID 자동 생성), resolveUserHash
  • 데모 dApp(connect/payment)이 쿼리와 환경 변수의 IVMS101 값으로부터 userHash를 결정해 AppKit에 전달하도록 변경했습니다.

변경​

  • SDK가 더 이상 자체 deviceId(랜덤 UUID)를 생성·관리하지 않음 — dApp 제공 userHash를 사용
  • 텔레메트리·릴레이 발행 메시지·콘솔 이벤트의 사용자 식별 필드를 deviceId/device_id에서 userHash/user_hash로 변경했습니다.
  • userHash 열을 VARCHAR(36)에서 VARCHAR(64)로 확대해 64자 16진수 UserHash를 저장할 수 있게 했습니다.

참고​

  • 콘솔의 device 분석 지표(활성/신규/방문)는 이제 유니크 userHash 기준으로 집계됨(지표 이름은 유지)