팬텀 지갑을 솔라나 DApp에 연결하는 방법

팬텀 지갑 통합 이해

1. 팬텀 지갑은 사용자가 제어하는 ​​개인 키와 솔라나 기반 분산형 애플리케이션 간의 직접적인 통신을 가능하게 하는 비수탁형 인터페이스 역할을 합니다.

2. 통합은 지갑 감지, 계정 승인 및 거래 제출을 위한 표준화된 방법을 제공하는 Solana Web3.js SDK를 사용합니다.

3. 지갑은 브라우저 환경에 전역 window.solana 개체를 노출하여 DApp 프런트엔드가 외부 종속성 없이 개체의 존재를 감지할 수 있도록 합니다.

4. 연결 시작은 공개 키 정보나 서명 기능을 노출하기 전에 명시적인 사용자 승인을 요청하는 보안 모달을 트리거합니다.

5. 일단 연결되면 DApp은 읽기 전용 공개 키 참조를 수신합니다. 즉, 개인 키나 시드 문구가 사용자 장치 밖으로 나가지 않습니다.

단계별 연결 작업 흐름

1. DApp은 먼저 window.solana 가 있는지 확인하고 isPhantom 속성을 지원하는지 확인하여 Phantom이 설치되어 있는지 확인해야 합니다.

2. 개발자는 solana.connect() 호출하여 Phantom 확장이 네트워크 컨텍스트와 요청된 범위가 포함된 권한 대화 상자를 표시하도록 요청합니다.

3. 사용자 확인 시 Phantom은 publicKey , account 및 chainId 포함된 객체를 반환하여 주소 파생 및 잔액 쿼리를 활성화합니다.

4. 후속 상호작용에서는 solana.signTransaction() 또는 solana.signAllTransactions() 호출해야 하며, 각각 지갑 샌드박스 내에서 로컬 암호화 서명을 호출합니다.

5. 서명된 모든 트랜잭션은 직렬화되어 DApp의 구성된 RPC 엔드포인트를 통해 제출됩니다. Phantom 자체는 이를 중계하거나 브로드캐스트하지 않습니다.

연결 중 보안 고려 사항

1. Phantom은 엄격한 출처 검증을 시행합니다. 등록되지 않은 도메인이나 악성 도메인으로부터의 연결은 확장 수준에서 차단됩니다.

2. 지갑은 어떤 작업도 자동 승인하지 않습니다. 모든 서명 요청에는 동일한 사이트에서 반복되는 작업의 경우에도 수동 사용자 상호 작용이 필요합니다.

3. 세션 지속성은 현재 탭과 도메인으로 제한됩니다. 탭을 닫거나 다른 곳으로 이동하면 활성 연결이 즉시 종료됩니다.

4. 피싱 방지 주소 표시를 통해 사용자는 확인 모드에서 잘리거나 난독화된 버전이 아닌 전체 44자 SOL 주소를 볼 수 있습니다.

5. 트랜잭션 시뮬레이션 기능을 통해 개발자는 제출 전에 지침 논리를 사전 검증하여 실패하거나 비용이 많이 드는 작업의 위험을 줄일 수 있습니다.

일반적인 통합 함정

1. Phantom을 모든 브라우저에서 사용할 수 있다고 가정합니다. Brave 및 Firefox는 설치 후에도 수동 확장 기능 활성화가 필요합니다.

2. 폴백 없이 RPC 엔드포인트를 하드코딩하면 사용자가 선택한 네트워크(mainnet-beta, devnet, testnet)가 DApp의 구성과 일치하지 않을 때 오류가 발생합니다.

3. disconnect 이벤트 리스너를 무시하면 세션 종료에도 불구하고 "연결됨" 표시기가 계속 표시되는 오래된 UI 상태가 발생합니다.

4. 성공적으로 연결되기 전에 solana.publicKey 에 액세스하려고 하면 null 참조 오류가 발생하고 흐름 실행이 중단됩니다.

5. 오래된 Web3.js 버전을 사용하면 버전이 지정된 트랜잭션에 대한 Phantom의 업데이트된 메시지 직렬화 형식과의 호환성이 중단됩니다.

자주 묻는 질문

Q: Phantom은 동일한 DApp 세션 내에서 Solana가 아닌 체인에 연결할 수 있나요? 예. Phantom은 Ethereum 및 Polygon 네트워크를 지원합니다. 체인을 전환하면 자동 주소 다시 파생이 트리거되고 이에 따라 chainId 필드가 업데이트됩니다.

Q: Phantom은 DApp 연결 중에 하드웨어 지갑 페어링을 지원합니까? 예. Ledger가 연결되고 Phantom이 이를 사용하도록 구성되면 모든 서명 작업은 소프트웨어 기반 키 저장소 대신 Ledger 장치를 통해 라우팅됩니다.

Q: 사용자가 연결 요청을 거부하면 어떻게 되나요? solana.connect() 가 반환한 Promise는 WalletConnectionError 로 거부되며 공개 키나 세션 데이터가 DApp에 노출되지 않습니다.

Q: 연결을 시작하기 전에 Phantom이 잠겨 있는지 또는 비밀번호 입력이 필요한지 여부를 감지할 수 있는 방법이 있습니까? 아니요. Phantom은 잠금 상태와 같은 내부 상태를 노출하지 않습니다. 연결 흐름 자체는 필요한 경우 비밀번호 입력을 요청하고 인증이 성공한 경우에만 진행됩니다.