WalletConnect QR 코드를 올바르게 스캔하는 방법

WalletConnect QR 코드 스캔 메커니즘

1. WalletConnect는 QR 코드 스캔을 통해 시작되는 안전한 엔드투엔드 암호화 페어링 프로세스를 사용합니다.

2. QR 코드에는 dApp의 메타데이터, 체인 ID 및 고유 브리지 URL을 포함하여 base64로 인코딩된 세션 제안 페이로드가 포함되어 있습니다.

3. 개인 키나 시드 문구는 QR 코드를 통해 전송되지 않습니다. 임시 세션 매개변수만 교환됩니다.

4. 모바일 지갑은 WalletConnect의 분산형 릴레이 네트워크를 통해 릴레이 연결을 설정하기 전에 dApp의 출처와 서명을 검증합니다.

5. 스캔되면 지갑에 요청된 방법, 계정 및 네임스페이스를 나열하는 권한 프롬프트가 표시됩니다. 트랜잭션 서명이 발생하기 전에 사용자 승인이 필수입니다.

장치별 스캔 요구 사항

1. iOS 장치에서는 지갑 앱에 대한 카메라 액세스가 활성화되어 있어야 합니다. 스캔 후 릴레이 연결을 유지하려면 백그라운드 앱 새로 고침이 활성 상태로 유지되어야 합니다.

2. Android 12 이상을 실행하는 Android 기기는 더 엄격한 카메라 권한을 적용합니다. 사용자는 처음 실행 시 '앱을 사용하는 동안' 액세스 권한을 수동으로 부여해야 합니다.

3. 일부 OEM 스킨(예: Xiaomi MIUI, Huawei EMUI)은 배터리 절약 모드가 활성화되면 전경 카메라 사용을 차단합니다. 안정적인 스캔을 위해서는 이 모드를 비활성화해야 합니다.

4. 듀얼 카메라 설정이 있는 태블릿은 명시적으로 전환하지 않는 한 기본적으로 전면 카메라로 설정될 수 있습니다. 잘못된 카메라 선택으로 인해 초점 실패 및 시간 초과 오류가 발생합니다.

5. 렌즈가 손상되거나 심하게 긁힌 장치는 종종 QR 코드 모듈을 잘못 읽습니다. 렌즈를 청소하고 적절한 주변 조명을 확보하면 스캔 성공률이 68% 이상 향상됩니다.

일반적인 스캔 오류 및 수정 사항

1. 지갑 앱 내부의 비어 있거나 회색으로 표시된 카메라 보기는 카메라 권한이 없음을 나타냅니다. 시스템 설정을 통해 이를 다시 부여하면 문제가 즉시 해결됩니다.

2. 지속적인 "잘못된 QR 코드" 메시지는 일반적으로 만료된 세션 URI에서 발생합니다. dApp은 일반적으로 5분 동안 유효한 시간 제한 제안을 생성합니다.

3. QR 코드가 200×200픽셀 미만으로 렌더링되거나 저해상도 프로젝터에 표시되면 스캔이 실패합니다. 최소 권장 렌더링 크기는 72dpi에서 300×300픽셀입니다.

4. 화면 눈부심, 최신 디스플레이의 반사 방지 코팅 또는 편광 선글라스로 인한 간섭으로 인해 광학 인식이 방해됩니다. 시야각을 조정하면 대부분의 잘못된 부정이 제거됩니다.

5. 오래된 릴레이 엔드포인트를 캐시하는 월렛 앱은 핸드셰이크 협상에 실패할 수 있습니다. 앱 데이터를 지우거나 최신 버전으로 업데이트하면 호환성이 복원됩니다.

검사 중 보안 유효성 검사

1. 모든 WalletConnect 세션에는 도메인 확인이 포함됩니다. 지갑에는 프런트엔드 URL뿐만 아니라 제안서에서 추출된 dApp의 확인된 도메인 이름이 표시됩니다.

2. 지갑은 승인 메시지를 표시하기 전에 dApp의 ENS 이름 또는 SSL 인증서 지문을 알려진 악성 레지스트리와 대조 확인합니다.

3. 세션 암호화는 secp256k1을 통해 ECDH(Elliptic Curve Diffie-Hellman)를 사용합니다. 세션 키 자료는 dApp 또는 릴레이 서버에 노출되지 않습니다.

4. 릴레이 메시지는 지갑의 세션 키로 서명되고 ECDSA를 사용하여 확인됩니다. 변조 시도는 즉시 세션 종료를 유발합니다.

5. WalletConnect 세션에서 발생하는 모든 서명 요청에 대해 생체 인식 확인이 시행됩니다. 비밀번호 전용 대체는 기본적으로 비활성화되어 있습니다.

자주 묻는 질문

Q: 동일한 WalletConnect QR 코드를 여러 번 스캔할 수 있나요? A: 각 QR 코드에는 일회용 세션 URI가 포함되어 있습니다. 만료되었거나 이미 사용된 코드를 다시 스캔하면 중계 서버에서 거부됩니다.

Q: WalletConnect QR 코드를 스캔하면 내 지갑 주소가 dApp에 즉시 노출되나요? A: 아니요. dApp은 세션 설정 후에 지갑의 공개 키만 받습니다. 주소 노출은 첫 번째 계정 요청 중 명시적인 사용자 동의가 있는 경우에만 발생합니다.

Q: QR 코드가 표시되어 있음에도 불구하고 지갑에 "Connection timed out(연결 시간 초과)" 메시지가 표시되는 이유는 무엇입니까? 답변: 이는 네트워크 수준의 오류를 나타냅니다. 지갑이 WalletConnect의 릴레이 인프라에 도달할 수 없거나 DNS 구성 오류 또는 방화벽 차단으로 인해 dApp의 브리지 엔드포인트에 연결할 수 없습니다.

Q: 신뢰할 수 없는 웹사이트에서 WalletConnect QR 코드를 스캔해도 안전합니까? A: 스캔 자체는 안전하지만 세션 요청을 승인하면 dApp에 제한된 RPC 액세스 권한이 부여됩니다. 확인하기 전에 항상 지갑 승인 화면에 표시된 도메인이 예상 dApp 출처와 일치하는지 확인하세요.