WalletConnect 세션에서 원격으로 로그아웃하는 방법

WalletConnect 세션 지속성 이해

1. WalletConnect 세션은 dApp과 지갑 간에 암호화된 페이로드를 중계하는 브리지 서버를 통해 설정됩니다.

2. 승인되면 세션은 대칭적으로 암호화된 페어링 키를 dApp의 프런트엔드 스토리지와 지갑의 내부 상태 모두에 로컬로 저장합니다.

3. dApp이나 지갑 제공자가 명시적으로 구현하지 않는 한 프로토콜에 의해 자동 시간 제한이 적용되지 않습니다.

4. 캐시된 저장소가 그대로 유지되는 한 브라우저를 다시 시작하고 장치를 재부팅해도 세션 데이터는 유지됩니다.

5. 중앙 집중식 취소 메커니즘이 없다는 것은 원격 로그아웃이 수동 개입이나 지갑 측 제어에 의존해야 한다는 것을 의미합니다.

지갑 수준 세션 종료 옵션

1. Trust Wallet, MetaMask Mobile 및 Rainbow와 같은 대부분의 모바일 지갑은 활성 WalletConnect 페어링이 나타나는 "연결된 사이트" 섹션을 노출합니다.

2. 사용자는 각 dApp 항목 옆에 있는 "연결 끊기"를 탭하여 개별 세션을 수동으로 연결 해제할 수 있습니다. 이렇게 하면 브리지 서버에 대한 DELETE 요청이 트리거됩니다.

3. 일부 지갑은 일괄 종료를 지원하므로 사용자는 한 번의 작업으로 모든 활성 WalletConnect 연결을 취소할 수 있습니다.

4. 특정 지갑은 일반적으로 30~90일 동안 활동이 없으면 사용하지 않은 세션에 대해 자동 만료 정책을 구현합니다.

5. Ledger Live와 같은 하드웨어 지갑은 WalletConnect 세션을 직접 저장하지 않습니다. 대신 연결 수명주기에 대한 모든 권한을 유지하는 동반 앱에 세션 관리를 위임합니다.

개발자 제어 원격 로그아웃 메커니즘

1. DApp 개발자는 WalletConnect v2 SDK의 killSession 메소드를 통합하여 프로그래밍 방식으로 활성 페어링을 종료할 수 있습니다.

2. 이를 위해서는 초기 핸드셰이크 중에 생성된 고유 식별자인 세션 주제와 연결된 지갑의 유효한 서명 권한이 필요합니다.

3. session.disconnect() 를 호출하면 구조화된 JSON-RPC 요청이 브리지에 전송되어 양쪽 끝의 공유 암호화 키가 무효화됩니다.

4. 개발자는 오래된 계정 표시나 잘못된 거래 프롬프트를 방지하기 위해 연결 해제 후 즉시 UI 상태 업데이트를 처리해야 합니다.

5. 피어 메타데이터, 네임스페이스 및 만료 타임스탬프를 포함한 세션 메타데이터는 성공적으로 종료되면 로컬 IndexedDB 및 메모리에서 제거됩니다.

브라우저 보관 정리 절차

1. localStorage 및 sessionStorage를 지우면 캐시된 세션 제안과 페어링 URI가 제거되지만 활성 브리지 연결은 무효화되지 않습니다.

2. IndexedDB는 활성 세션, 키 및 이벤트 리스너를 포함한 핵심 WalletConnect 클라이언트 상태를 유지합니다. 이 데이터베이스를 삭제하면 프런트엔드 지속성이 유지됩니다.

3. 서비스 워커는 브리지 통신 로직을 캐시할 수 있습니다. 등록을 취소하면 승인 후 백그라운드 페이로드 릴레이가 계속되지 않습니다.

4. 일부 dApp에서 사용되는 타사 iframe 격리는 WalletConnect 스토리지에 대한 직접 액세스를 방지합니다. 대신 명시적인 지갑 시작 취소가 필요합니다.

5. 브라우저 수준 사이트 데이터 삭제에는 dApp 도메인과 관련된 모든 출처가 포함되어 저장된 페어링 식별자 및 세션 주제가 제거됩니다.

자주 묻는 질문

Q: 브라우저 쿠키를 삭제하면 WalletConnect에서 로그아웃되나요? 답변: 아니요. WalletConnect에서는 쿠키를 사용하지 않습니다. 세션 상태는 HTTP 쿠키가 아닌 localStorage, sessionStorage 및 IndexedDB에 있습니다.

Q: 휴대폰을 분실한 경우 WalletConnect 세션을 취소할 수 있나요? A: 예. 지갑이 원격 삭제를 지원하거나 클라우드 동기화 세션 관리 기능이 있는 경우 지갑의 웹 인터페이스에 로그인하여 페어링을 종료할 수 있습니다.

Q: Disconnect()를 호출했는데 지갑이 응답하지 않으면 어떻게 되나요? A: 세션은 지갑 측에서 활성 상태로 유지됩니다. dApp은 로컬 상태만 업데이트합니다. 브리지는 지갑이 연결 해제를 확인하거나 시간 초과될 때까지 페어링을 유지합니다.

Q: 지갑 상호작용 없이 강제로 로그아웃하는 방법이 있나요? A: 기본적으로는 아닙니다. WalletConnect는 상호 동의를 중심으로 설계되었습니다. 일방적인 종료는 프로토콜의 보안 모델을 위반하며 지갑별 확장 또는 백엔드 조정이 필요합니다.