Tonkeeper를 TON dApp에 연결하는 방법

지갑 준비 및 네트워크 확인

1. tonkeeper.com 또는 iOS, Android 또는 데스크톱 플랫폼용 검증된 앱 스토어에서 공식 Tonkeeper 애플리케이션을 설치하세요.

2. Tonkeeper를 실행하고 TON 메인넷에서 작동하는지 확인합니다. 상단 표시줄의 네트워크 표시기를 확인하여 이를 확인합니다. "Testnet"이 표시되면 설정에 액세스하고 Tonkeeper 로고를 5번 탭하여 개발자 메뉴를 연 다음 메인넷으로 전환하세요.

3. 대부분의 dApp에서 요구하는 초기 거래 수수료 및 계약 배포 비용을 충당하기 위해 지갑에 최소 0.1TON이 포함되어 있는지 확인하십시오.

4. 24단어 복구 문구를 안전한 오프라인 위치에 백업하세요. 이 단계는 되돌릴 수 없으며 온체인 상호 작용 전에 필수입니다.

5. 타사 확장 프로그램이나 오버레이가 지갑의 UI 렌더링이나 서명 프롬프트를 방해하지 않는지 확인하세요.

dApp 인터페이스를 통한 연결 시작

1. JavaScript가 활성화된 Chrome, Edge 또는 Safari와 같은 지원되는 브라우저를 사용하여 대상 TON 기반 dApp으로 이동합니다.

2. 일반적으로 dApp 인터페이스의 오른쪽 상단에 있는 "지갑 연결" 버튼을 찾아 클릭하세요.

3. 표시된 지갑 목록에서 “Tonkeeper”를 선택하세요. dApp의 연결 흐름에서 명시적으로 지시하지 않는 한 QR 코드 스캔을 피하세요.

4. 공개 주소를 공유하고 세션 요청에 서명할 수 있는 권한을 요청하는 팝업 모달이 Tonkeeper 내부에 나타납니다. “승인”을 탭하세요.

5. dApp은 연결된 주소를 표시하고 자동 잔액 동기화를 트리거할 수 있습니다. 개인 키나 시드 문구는 전송되지 않습니다.

주소 형식 및 호환성 처리

1. Tonkeeper는 기본적으로 반송 가능한 형식(예: EQB4c1b2ede12aa76f4a44353944258bcc8f99e9c7c474711a152c78b43218e296 )으로 주소를 생성합니다. 이는 자동 오류 수정을 지원하고 사용자 대면 상호 작용에 선호됩니다.

2. 일부 dApp에는 스마트 계약 호출을 위해 반송 불가능한 주소가 필요합니다. Tonkeeper는 "계정 정보" > "주소 복사" > 토글 옵션에서 두 가지 변형을 모두 제공합니다.

3. dApp이 작업체인 ID(기본 체인의 경우 0) 및 계정 ID 구성 요소를 올바르게 구문 분석하는지 확인합니다. 일치하지 않는 작업 체인 처리로 인해 자동 연결 오류가 발생합니다.

4. dApp이 TonConnect 프로토콜 v2를 사용하는 경우 Tonkeeper 버전이 ≥4.12.0인지 확인하십시오. 이전 버전에는 다중 서명 세션 핸드셰이크에 대한 지원이 부족합니다.

5. 주소 문자열을 수동으로 편집하거나 자르지 마십시오. 체크섬 및 접두사 인코딩은 기본 공개 키에 암호화 방식으로 바인딩됩니다.

서명 및 거래 승인 흐름

1. 트랜잭션 또는 데이터 서명 요청을 시작할 때 dApp은 메서드 이름, 매개변수 및 만료 타임스탬프가 포함된 구조화된 페이로드를 보냅니다.

2. Tonkeeper는 정확한 작업 유형( sendMessage 또는 signData ), 대상 주소, 금액 및 첨부된 메모를 보여주는 기본 확인 화면을 표시합니다.

3. 사용자는 각 작업을 명시적으로 승인해야 합니다. 일괄 승인이나 자동 서명 정책은 설계상 허용되지 않습니다.

4. 승인되면 Tonkeeper는 정규화된 페이로드에 대해 Ed25519 서명을 계산하고 이를 서명된 메시지 해시와 함께 dApp에 반환합니다.

5. 서명에 실패하면 항상 블록체인 수준에서 즉시 거부됩니다. 부분 실행이나 대체 실행은 발생하지 않습니다.

일반적인 연결 실패 문제 해결

1. 지갑이 커넥터 목록에 표시되지 않으면 브라우저 캐시를 지우고 WebSocket 또는 삽입된 스크립트를 필터링하는 광고 차단기 또는 개인정보 보호 확장 프로그램을 비활성화합니다.

2. 지속적인 "잘못된 세션" 오류는 만료된 TonConnect 페어링을 나타냅니다. dApp에서 "지갑 연결 끊기"를 클릭하여 다시 연결한 다음 연결을 다시 시작하세요.

3. 공백 또는 정지된 확인 모달은 일반적으로 오래된 Tonkeeper 버전에서 발생합니다. 공식 앱 스토어 또는 tonkeeper.com/download를 통해 업데이트하세요.

4. dApp 디스플레이와 Tonkeeper의 "계정 정보" 간의 주소 불일치는 잘못된 네트워크 컨텍스트를 나타냅니다. dApp 백엔드와 지갑이 모두 동일한 TON 네트워크 엔드포인트에서 작동하는지 다시 확인하세요.

5. 서명 요청 중 반복되는 시간 초과 메시지는 불안정한 로컬 인터넷 또는 ISP 수준 WebSocket 차단을 나타냅니다. 모바일 데이터로 전환하거나 Tonkeeper 설정에서 Tor 모드를 활성화하세요.

자주 묻는 질문

Q: 재승인 없이 Tonkeeper를 여러 dApp에 동시에 연결할 수 있나요? 답변: 예—Tonkeeper는 dApp 도메인별로 영구 세션 키를 유지합니다. 각각의 새 원본에는 일회성 페어링이 필요하지만 수동으로 취소하지 않는 한 후속 상호 작용에서는 재인증을 건너뜁니다.

Q: dApp에 연결하면 내 거래 내역이나 잔액 세부정보에 대한 액세스 권한이 부여되나요? A: 아니요. 공개 주소만 공유됩니다. 모든 잔액 및 내역 쿼리는 사용자의 동의 및 명시적인 RPC 호출에 의해 제어되는 TON API 엔드포인트를 통해 수행되어야 합니다.

Q: Tonkeeper를 선택했는데도 일부 dApp에 "지원되지 않는 지갑"이 표시되는 이유는 무엇입니까? A: 이는 dApp이 Tonkeeper의 현재 어댑터 레이어와 호환되지 않는 레거시 TonConnect v1 또는 사용자 정의 RPC 래퍼를 적용할 때 발생합니다. 지원되는 최소 SDK 버전에 대해서는 dApp의 설명서를 확인하세요.

Q: HTTPS가 아닌 도메인에서 호스팅되는 dApp에 Tonkeeper를 연결하는 것이 안전한가요? A: 아니요 - Tonkeeper는 HTTP 원본에 대한 연결을 완전히 차단합니다. 유효한 인증서가 있는 TLS 보안 도메인만 지갑 세션을 시작할 수 있습니다.