WalletConnect를 사용하여 앱을 dApp에 연결하는 방법은 무엇입니까?

WalletConnect 프로토콜 이해

1. WalletConnect는 개인 키를 노출하지 않고 암호화폐 지갑과 분산 애플리케이션 간의 안전한 통신을 가능하게 하는 오픈 소스 프로토콜입니다.

2. 페어링 중에 설정된 대칭 키를 사용하여 dApp과 지갑 간에 암호화된 페이로드를 전달하는 중계 서버를 통해 작동합니다.

3. 페어링 프로세스에서는 체인 ID, 필수 권한 및 앱 정보와 같은 메타데이터가 포함된 세션 제안이 포함된 QR 코드 또는 딥 링크를 생성합니다.

4. 사용자는 모바일 지갑으로 QR 코드를 스캔하거나 딥 링크를 클릭하여 신뢰할 수 있는 클라이언트 인터페이스에서 연결 승인을 시작합니다.

5. 승인되면 영구적인 종단 간 암호화 세션이 설정되어 장치 전반에 걸쳐 서명된 거래와 지갑 상호 작용이 가능해집니다.

WalletConnect v2 SDK 통합

1. 개발자는 EVM 및 비 EVM 체인과의 완전한 호환성을 위해 @walletconnect/core 및 @walletconnect/sign-client와 함께 @walletconnect/modal 패키지를 설치합니다.

2. 분석 및 릴레이 라우팅을 활성화하려면 WalletConnect Cloud 대시보드에서 프로젝트 ID를 가져와 클라이언트 초기화 중에 전달해야 합니다.

3. 선택적 테마 옵션과 지원되는 지갑으로 모달 UI가 초기화되어 맞춤 UI 개발 없이 원활한 사용자 온보딩이 가능합니다.

4. 세션 네임스페이스는 필수 체인, 계정 및 메소드를 선언하도록 구성됩니다(예: eth_signTransaction 또는 cosmos_signAmino).

5. 연결, 연결 해제 및 session_update에 대한 이벤트 리스너가 등록되어 상태 변경을 처리하고 이에 따라 애플리케이션 UI를 업데이트합니다.

실시간 지갑 요청 처리

1. dApp이 거래 서명을 요청할 때 거래 데이터, 가스 한도 및 수신자 주소와 같은 체인별 매개변수가 포함된 요청 개체를 구성합니다.

2. 요청은 request() 메소드를 사용하여 활성 세션을 통해 전송되며 연결된 지갑 인터페이스 내부에 프롬프트가 트리거됩니다.

3. 지갑은 서명된 트랜잭션이 포함된 성공 응답이나 거부 오류를 반환하며, 두 가지 모두 dApp 로직에 의해 정상적으로 처리되어야 합니다.

4. 일괄 작업의 경우 여러 요청을 대기열에 넣을 수 있지만 중계 네트워크에서 부과한 세션 수준 속도 제한 및 시간 초과 임계값을 준수해야 합니다.

5. 보류 중인 요청은 고유 ID를 통해 추적되며, 동시 지갑 상호 작용 중 경합 상태를 방지하기 위해 동일한 ID를 사용하여 응답이 일치됩니다.

보안 고려 사항 및 모범 사례

1. 세션 키를 클라이언트 측에 저장하지 마십시오. WalletConnect에 내장된 지속성 레이어를 사용하거나 플랫폼별 지침을 준수하는 보안 저장 메커니즘을 사용하세요.

2. 알려진 dApp 출처에 대해 모든 수신 세션 제안을 검증하고 엄격한 도메인 허용 목록을 시행하여 피싱 시도를 완화합니다.

3. 앱 기능에 의해 명시적으로 정당화되지 않는 한 모든 계정에 대한 액세스 또는 무제한 서명 기능과 같은 과도한 권한을 요청하는 세션을 거부합니다.

4. 지갑이 응답하지 않는 동안 무기한 정지 상태를 방지하기 위해 120초를 초과하는 보류 중인 요청에 대한 시간 초과 처리를 구현합니다.

5. 프로덕션 환경에서 사용되는 모든 릴레이 끝점을 감사하고 규정 준수 요구 사항에 따라 메시지 라우팅 인프라에 대한 완전한 제어가 요구되는 자체 호스팅 릴레이를 선호합니다.

자주 묻는 질문

Q: WalletConnect를 하드웨어 지갑과 함께 사용할 수 있나요? 예, Ledger 및 Trezor를 포함한 여러 하드웨어 지갑 제공업체는 Bluetooth 또는 USB 인터페이스를 통해 세션 설정 및 서명을 지원하는 WalletConnect 호환 앱을 제공합니다.

Q: 릴레이 서버가 오프라인이 되면 어떻게 되나요? 암호화 키가 로컬에 보관되므로 세션은 활성 상태로 유지됩니다. 새로운 세션 제안 및 알림에만 릴레이 가용성이 필요합니다. 기존 연결은 수동으로 종료될 때까지 계속 작동합니다.

Q: WalletConnect는 Solana dApp과 호환되나요? 예, WalletConnect v2는 solana: 네임스페이스와 solana_signTransaction 및 solana_signMessage와 같은 해당 메소드를 지정하는 네임스페이스 구성을 통해 Solana를 지원합니다.

Q: 사용자가 dApp을 방문할 때마다 다시 페어링해야 합니까? 아니요, 로컬 저장소가 보존되면 브라우저를 다시 시작해도 세션이 유지됩니다. 사용자는 언제든지 수동으로 연결을 끊거나 지갑 설정을 통해 액세스를 취소할 수 있습니다.