팬텀 지갑을 NFT 마켓플레이스에 연결하는 방법

팬텀 지갑 통합 이해

1. Phantom Wallet은 Magic Eden, Tensor 및 Solanart와 같은 NFT 마켓플레이스를 포함하여 Solana 기반 분산형 애플리케이션에 대한 비수탁형 게이트웨이로 작동합니다.

2. 브라우저 확장 기능과 모바일 앱은 솔라나 지갑 표준을 준수하는 지갑 연결 API를 노출하여 원활한 dApp 상호 운용성을 가능하게 합니다.

3. EIP-1193 이벤트에 의존하는 Ethereum 지갑과 달리 Phantom은 최신 프런트엔드 프레임워크와 호환되는 solana:connect 및 solana:disconnect 이벤트를 생성합니다.

4. 연결을 시작하려면 명시적인 사용자 동의가 필요합니다. Phantom의 보안 모델에서는 자동 또는 자동 인증이 허용되지 않습니다.

5. 일단 연결되면 지갑은 NFT를 발행하거나 구매하는 데 필요한 공개 키, 최근 블록해시, 거래 서명 인터페이스를 노출합니다.

단계별 연결 작업 흐름

1. 마켓플레이스 프런트엔드는 먼저 브라우저 컨텍스트에서 window.solana 또는 window.phantom을 확인하여 Phantom이 설치되어 있는지 감지해야 합니다.

2. 감지되면 사이트는 phantom.connect() 를 호출하여 사용자에게 연결 승인을 묻는 모달을 트리거합니다.

3. 승인 시 Phantom은 지갑의 공개 키와 signTransaction 메소드가 포함된 서명자 객체를 주입합니다.

4. 그런 다음 마켓플레이스는 @solana/web3.js를 사용하여 Solana 거래를 구성하고, 여기에 필요한 지침(예: 토큰 전송, 메타데이터 프로그램 호출)을 입력하고 서명을 위해 이를 Phantom에 전달합니다.

5. Phantom은 명령 의미를 검증하고 수수료 견적 및 대상 계정을 표시하며 명시적인 사용자 확인 후에만 서명합니다.

일반적인 연결 실패

1. 개발자가 사전 connect() 호출 없이 서명을 시도하거나 사용자 연결을 끊은 후 WalletNotConnectedError가 발생합니다.

2. BlockhashNotFoundError는 오래된 블록해시를 사용하여 트랜잭션을 구축할 때 발생합니다. 시장에서는 제출할 때마다 새로운 블록해시를 가져와야 합니다.

3. 트랜잭션 구성 실패는 잘못된 토큰 발행 주소 또는 누락된 계정 키와 같이 명령 매개변수가 프로그램 기대치와 일치하지 않을 때 발생합니다.

4. Phantom은 확인되지 않은 프로그램 ID와의 거래를 거부합니다. 마켓플레이스는 Metaplex의 토큰 메타데이터 프로그램 또는 Bubblegum과 같은 프로그램을 사전 화이트리스트에 추가해야 합니다.

5. phantom://solana/connect를 통해 연결을 시작한 후 dApp이 제대로 리디렉션되지 않으면 Mobile Phantom 사용자에게 딥링크 시간 초과가 발생할 수 있습니다.

연결 중 보안 고려 사항

1. Phantom은 개인 키를 프런트엔드 환경에 노출하지 않으므로 마켓플레이스는 개인 키를 일시적으로라도 저장하거나 기록해서는 안 됩니다.

2. 모든 거래 페이로드는 signTransaction을 호출하기 전에 수신자 주소 적법성, 금액 한도 및 프로그램 ID 신뢰성에 대해 클라이언트 측에서 검증되어야 합니다.

3. 피싱 방지 도메인 바인딩이 시행됩니다. Phantom은 지갑 개발자 온보딩 중에 등록되거나 DNS TXT 레코드를 통해 확인된 도메인으로부터의 연결만 허용합니다.

4. 서명 요청에는 사람이 읽을 수 있는 작업 설명이 포함되어야 합니다. Phantom은 블라인드 서명 공격을 방지하기 위해 이러한 내용을 사용자에게 그대로 표시합니다.

5. 재연결 로직은 자동 재시도 루프를 피해야 합니다. 반복적으로 실패한 연결 시도는 Phantom의 남용 방지 조절 메커니즘을 트리거합니다.

다중 체인 호환성 제약

1. Phantom의 Solana 통합은 기본적이고 완벽하게 최적화되어 있으며 Ethereum 및 Polygon 지원은 대기 시간 및 가스 추정 차이를 도입하는 크로스 체인 브리지 추상화에 의존합니다.

2. Solana가 아닌 체인에서 운영되는 NFT 마켓플레이스에 연결할 때 Phantom은 MetaMask와 같은 주입된 공급자에게 서명을 위임하므로 통합된 UI 일관성이 손실됩니다.

3. Bitcoin 통합은 읽기 전용으로 유지됩니다. Phantom은 Bitcoin 트랜잭션 서명을 지원하지 않으므로 Ordinals 기반 NFT 플랫폼에 대한 유틸리티가 제한됩니다.

4. 기본 및 Arbitrum 연결에는 명시적인 체인 매개변수 주입이 필요합니다. 생략하면 지갑 감지에도 불구하고 지원되지 않는 체인 오류가 발생합니다.

5. 크로스체인 NFT 목록에는 체인별로 별도의 지갑 연결 흐름이 필요하므로 프런트엔드 복잡성과 사용자 마찰이 증가합니다.

자주 묻는 질문

Q: Phantom은 OpenSea와 같은 Ethereum 기반 NFT 마켓플레이스에 연결할 수 있나요? A: 그렇습니다. 하지만 내장된 MetaMask 호환 공급자 레이어를 통해서만 가능합니다. 이더리움 체인에서는 솔라나 스타일의 API에 직접 접근할 수 없습니다.

Q: Phantom이 때때로 모바일 브라우저에 "Connection timed out"을 표시하는 이유는 무엇입니까? 답변: 모바일 Safari 및 Chrome은 딥링킹 동작을 제한합니다. Phantom은 OS가 리디렉션을 차단하거나 앱이 설치되지 않은 경우 자동으로 실패하는 범용 링크를 사용합니다.

Q: 사용자 상호 작용 없이 Phantom을 연결할 수 있습니까? A: 아니요. Phantom은 모든 연결 세션에 대해 명시적인 옵트인을 시행합니다. 영구 세션은 브라우저를 다시 시작하거나 탭을 닫은 후 수동으로 재승인해야 합니다.

Q: 마켓플레이스가 유효하지 않은 프로그램 ID로 거래에 서명하려고 하면 어떻게 됩니까? A: Phantom은 InvalidProgramIdError 로 요청을 즉시 거부하고 인식할 수 없는 계약 주소를 나타내는 경고를 표시합니다.