Coinbase Wallet을 DApp에 연결하는 방법은 무엇입니까?

지갑 통합 아키텍처

1. Coinbase Wallet은 EIP-1193 및 EIP-1474 표준과 호환되는 주입된 공급자로 운영됩니다. 브라우저 확장으로 설치되거나 모바일 딥링킹을 통해 실행될 때 브라우저 컨텍스트에서 전역 이더리움 개체를 노출합니다.

2. 지갑은 이더리움 메인넷과 Base, Optimism, Arbitrum 및 Polygon을 포함한 여러 EVM 호환 체인을 모두 지원합니다. 체인 구성은 DApp의 대상 네트워크 매개변수와 일치해야 합니다.

3. 연결을 시작하려면 모달 인터페이스를 통한 명시적인 사용자 동의가 필요합니다. Coinbase Wallet의 클라이언트 측 SDK에서 시행하는 현재 보안 정책에서는 자동 또는 자동 인증이 허용되지 않습니다.

4. 세션 지속성은 도메인 원본으로 범위가 지정된 로컬 저장소에 의존합니다. 각 dApp은 자체 격리된 세션 상태를 유지하여 사이트 간 지갑 상태 유출을 방지합니다.

5. 연결 해제 이벤트는 계정 노출 및 거래 서명 기능을 포함하여 이전에 부여된 모든 권한을 즉시 취소합니다.

프런트엔드 구현 단계

1. npm을 통해 공식 Coinbase Wallet SDK를 가져옵니다: npm install @coinbase/wallet-sdk . 이 패키지에는 형식화된 인터페이스, 오류 처리 유틸리티 및 체인 인식 공급자 래퍼가 포함되어 있습니다.

2. 필수 필드인 appName, appLogoUrl 및 대상 블록체인 RPC 엔드포인트에 해당하는 jsonRpcUrl이 있는 CoinbaseWalletSDK를 사용하여 지갑 커넥터를 인스턴스화합니다.

3. 공급자 인스턴스를 초기화하고 activate() 를 호출하여 연결 흐름을 시작합니다. 그러면 사용자에게 액세스를 승인하거나 거부하라는 메시지를 표시하는 기본 모달이 열립니다.

4. 성공하면 반환된 공급자 개체는 accountChanged 및 chainChanged 이벤트를 내보내 연결된 주소 및 네트워크 상태에 대한 반응형 UI 업데이트를 활성화합니다.

5. 모든 후속 계약 호출 또는 거래 제출은 서명 라우팅이 활성 세션과 일관되게 유지되도록 이 제공자 인스턴스를 통해 라우팅되어야 합니다.

보안 시행 메커니즘

1. 모든 거래 요청은 서명 생성 전에 기기 내 검증을 거칩니다. 지갑에는 수신자, 값, 가스 매개변수 및 함수 호출 데이터를 포함한 전체 페이로드 세부 정보가 표시됩니다.

2. 스마트 계약 상호작용에는 명시적인 함수 이름과 매개변수 유형 확인이 필요합니다. ABI 디코딩은 지갑의 샌드박스 런타임 환경 내에서 로컬로 수행됩니다.

3. 거부된 거래는 타임스탬프 및 작업 해시와 함께 지갑의 내부 감사 추적에 기록되며 지갑의 내역 탭을 통해 사용자만 액세스할 수 있습니다.

4. 피싱 탐지는 알려진 악성 도메인에 대해 실시간으로 실행됩니다. 블랙리스트에 있는 원본에서 연결을 시도하면 즉시 경고 배너가 트리거되고 추가 상호 작용이 차단됩니다.

5. 개인 키 자료는 장치의 보안 영역을 벗어나지 않습니다. 서명 작업은 지갑의 격리된 암호화 모듈 내에서만 발생합니다.

공통 권한 범위

1. eth_accounts : 현재 선택된 이더리움 주소에 대한 읽기 전용 액세스 권한을 부여합니다. 기본 지갑 감지 및 잔액 표시에 필요합니다.

2. eth_signTypedData_v4 : EIP-712를 준수하는 구조화된 메시지 서명을 활성화합니다. 로그인 흐름과 오프체인 증명에 사용됩니다.

3. eth_sendTransaction : 서명된 이더리움 거래의 브로드캐스트를 승인합니다. 사용자가 수동으로 확인한 후에만 트리거됩니다.

4. personal_sign : 레거시 일반 텍스트 서명을 지원합니다. 형식화된 데이터를 위해 더 이상 사용되지 않지만 이전 버전과의 호환성을 위해 유지됩니다.

5. eth_sign : 원시 해시 서명을 허용합니다. 검증된 도메인 평판 점수가 있는 화이트리스트 dApp으로 제한됩니다.

자주 묻는 질문

Q: Coinbase Wallet이 개발 중에 로컬 호스트의 연결 시도를 거부하는 이유는 무엇입니까? A: 기본적으로 지갑은 보안상의 이유로 HTTPS 전용 출처를 적용합니다. 개발자는 mkcert와 같은 도구를 사용하거나 설정에서 사용할 수 있는 지갑의 개발자 모드 토글을 사용하여 HTTPS를 통해 로컬 dApp을 제공해야 합니다.

Q: 연결 후 프로그래밍 방식으로 네트워크를 전환할 수 있습니까? A: 예, wallet_switchEthereumChain RPC 방법을 통해 가능합니다. 지갑은 변경 사항을 적용하기 전에 대상 체인 ID, 블록 탐색기 URL 및 기본 통화 기호를 나열하는 확인 화면을 표시합니다.

Q: 연결된 상태에서 사용자가 지갑 내에서 선택한 계정을 변경하면 어떻게 되나요? A: 지갑은 새 주소 배열이 포함된 accountChanged 이벤트를 내보냅니다. DApp은 이 이벤트를 수신하고 이에 따라 다시 연결할 필요 없이 UI 요소를 업데이트해야 합니다.

Q: 연결 프롬프트를 표시하지 않고 Coinbase Wallet이 설치되었는지 여부를 감지할 수 있습니까? A: 예, 활성화 방법을 호출하기 전에 window.ethereum?.isCoinbaseWallet 이 있는지 확인하면 됩니다. 이 속성은 공식 지갑 확장 프로그램이나 모바일 앱이 감지된 경우에만 true를 반환합니다.