Talisman Wallet을 Polkadot dApp에 연결하는 방법

탈리스만 지갑 통합 이해

1. Talisman Wallet은 Astar, Moonbeam 및 Lientry와 같은 파라체인을 지원하는 Polkadot 생태계를 위해 특별히 설계된 브라우저 확장 및 모바일 애플리케이션입니다.

2. Polkadot-JS 확장 인터페이스 표준을 구현하여 Substrate 기반 체인에 구축된 dApp과 원활한 상호 작용을 가능하게 합니다.

3. window.ethereum 주입에 의존하는 Ethereum 지갑과 달리 Talisman은 window.talismanEthereum 및 window.injectedWeb3 개체를 주입하여 서명 및 계정 관리 기능을 노출합니다.

4. 지갑은 EVM 지원 파라체인에 연결될 때 표준 기판 외부 및 EVM 호환 트랜잭션을 모두 지원합니다.

5. UI 레이어는 외부 리디렉션이나 딥링크 없이 브라우저 컨텍스트에서 직접 거래 확인을 렌더링합니다.

연결 설정을 위한 전제 조건

1. 사용자는 https://talisman.xyz/download 에서 공식 Talisman 브라우저 확장 프로그램을 설치해야 합니다. 타사 빌드는 지원되지 않으며 키 보안이 손상될 수 있습니다.

2. dApp은 @polkadot/api v12+를 사용하여 Polkadot-JS API를 초기화하고 대상 파라체인의 런타임에 대한 적절한 유형 정의를 포함해야 합니다.

3. 프런트엔드 코드는 연결을 시도하기 전에 window.injectedWeb3을 감지해야 합니다. 부재는 지갑이 설치되지 않았거나 비활성화되었음을 의미하기 때문입니다.

4. 네트워크 구성은 dApp의 의도된 체인과 일치해야 합니다. Talisman은 알려진 신뢰할 수 있는 공급자에 대해 RPC 엔드포인트를 검증하고 기본적으로 확인되지 않은 사용자 지정 URL을 거부합니다.

5. 모바일 사용자의 경우 Talisman 모바일 앱은 QR 코드 스캔을 통해 페어링되어야 합니다. 이는 Noise Protocol Framework 핸드셰이크를 사용하여 암호화된 세션을 설정합니다.

단계별 연결 흐름

1. dApp은 @polkadot/extension-dapp에서 web3Enable('MyDapp')을 호출하여 주입된 공급자에 액세스할 수 있는 권한을 요청합니다.

2. Talisman은 각각 인코딩된 주소, genesisHash 및 networkId 메타데이터를 포함하는 사용 가능한 계정 목록으로 응답합니다.

3. dApp은 계정을 선택하고 api.tx.* 메소드를 통해 signAndSendTransaction 호출을 시작하여 Talisman의 모달 오버레이를 트리거합니다.

4. 사용자는 승인 또는 거부하기 전에 수수료 견적, 중량, 팔레트 호출 구조 등의 외부 세부 정보를 검토합니다.

5. 승인 시 Talisman은 Schnorrkel(sr25519) 또는 Ed25519 키를 사용하여 페이로드에 서명하고 제출을 위해 서명된 트랜잭션을 dApp에 반환합니다.

연결 오류 처리

1. window.injectedWeb3이 정의되지 않은 경우 dApp은 사용자에게 확장 프로그램을 설치하거나 활성화하도록 지시하는 메시지를 표시해야 합니다.

2. web3Enable 중에 "공급자를 찾을 수 없음" 오류는 일반적으로 Talisman이 개인 모드에서 실행 중이거나 현재 출처를 차단했음을 의미합니다.

3. 서명을 거부하면 코드 1011이 포함된 오류 개체가 생성됩니다. 이는 암호화 실패가 아닌 사용자 취소를 나타냅니다.

4. 잘못된 genesisHash 불일치로 인해 오류 코드 1002가 발생합니다. 이는 Talisman이 메인넷용으로 구성되어 있는 동안 dApp이 테스트넷에 연결되거나 그 반대의 경우에 발생합니다.

5. 만료된 세션 토큰으로 인해 QR 페어링 중 시간 초과 오류가 발생합니다. 새로운 QR 코드는 90초마다 다시 생성되어야 합니다.

자주 묻는 질문

Q: Talisman은 하드웨어 지갑 통합을 지원합니까? A: 예, Talisman은 기본적으로 Polkadot 및 Kusama 네트워크용 Ledger 장치를 지원합니다. 사용자는 Ledger에 Polkadot 앱을 설치하고 Talisman 설정에서 블라인드 서명을 활성화해야 합니다.

Q: Talisman을 이더리움 호환 dApp에 연결할 수 있나요? A: 해당 dApp이 Moonbeam 또는 Moonriver와 같은 EVM 지원 Polkadot 파라체인에 배포된 경우에만 해당됩니다. Talisman은 Ethereum 메인넷에 window.ethereum을 노출하지 않습니다.

Q: Talisman이 내 사용자 지정 RPC 엔드포인트를 거부하는 이유는 무엇입니까? A: Talisman은 감사를 받은 RPC 제공업체의 선별된 목록을 유지 관리합니다. 사용자 정의 엔드포인트에는 확장 팝업의 개발자 모드 토글을 통한 수동 허용 목록이 필요합니다.

Q: Talisman이 잠겨 있는지 또는 잠금 해제되어 있는지 프로그래밍 방식으로 감지할 수 있는 방법이 있습니까? A: 아니요. Talisman은 부채널 유출을 방지하기 위해 의도적으로 내부 상태를 숨깁니다. 관찰할 수 있는 유일한 신호는 web3Accounts()에 대한 성공적인 응답 또는 특정 오류 코드와 함께 실패하는 것입니다.