Sui 지갑에 맞춤형 토큰을 추가하는 방법

사용자 정의 토큰 통합 이해

1. Sui Wallet은 Sui 블록체인에 배포된 모든 토큰을 자동으로 감지하거나 표시하지 않습니다.

2. 토큰은 코인 유형의 개체 ID 로 알려진 온체인 식별자를 사용하여 지갑의 토큰 목록에 명시적으로 등록되어야 합니다.

3. 코인 유형은 0x[address]::[module]::[struct] 라는 엄격한 형식을 따릅니다. 여기서 각 세그먼트는 Move 패키지 배포에서 파생됩니다.

4. 사용자는 임의의 문자열을 추가할 수 없습니다. Sui 네트워크에서 인식되는 유효하고 배포되고 검증된 코인 유형만 허용됩니다.

5. 대소문자, 간격, 모듈 경로가 정확히 일치하지 않으면 토큰 추가 시 거부됩니다.

수동 추가를 위한 전제 조건

1. 활성 계정이 있는 완전히 동기화된 Sui Wallet 확장 프로그램 또는 모바일 앱.

2. 토큰의 공식 문서 또는 코인 유형 ID를 확인하는 탐색기 페이지에 액세스합니다.

3. 토큰 계약이 데브넷이나 테스트넷뿐만 아니라 메인넷이나 대상 네트워크에 게시되었는지 확인합니다.

4. 사용자 주소에 있는 토큰 개체의 인스턴스 중 하나 이상에 대한 소유권은 sui client object CLI 명령을 통해 확인됩니다.

5. 토큰이 코인 인터페이스를 올바르게 구현하는지 여부에 대한 지식 - 적절한 코인 특성 준수가 부족한 사용자 정의 구조는 잔액에 나타나지 않습니다.

단계별 토큰 등록

1. Sui Wallet 인터페이스를 열고 토큰 탭으로 이동합니다.

2. 오른쪽 상단에 있는 + 토큰 추가 버튼을 탭하거나 클릭합니다.

3. 기본 목록을 통해 검색하는 대신 Custom Token을 선택합니다.

4. 전체 동전 유형 문자열을 입력 필드에 붙여넣습니다. 잘림이나 별칭은 허용되지 않습니다.

5. 네트워크 호환성을 확인합니다. 지갑은 현재 연결된 네트워크(예: 메인넷 대 테스트넷)에 대해 유형을 검증합니다.

6. 검증에 성공하면 토큰 기호, 이름 및 소수점 정밀도가 온체인 메타데이터에서 자동으로 가져옵니다.

7. 추가를 클릭하여 등록을 완료하고 잔액 동기화를 시작합니다.

확인 및 가시성 문제

1. 추가한 후 자산 보기를 확인합니다. 노드가 로드 중인지 토큰이 반영되는 데 최대 30초가 걸릴 수 있습니다.

2. 토큰이 계속 표시되지 않으면 CLI에서 sui client object --address [your-address]를 사용하여 개체 소유권을 확인하세요.

3. 개체 ID를 검색 창에 붙여넣고 패키지 구조를 검사하여 Sui Explorer와 코인 유형을 대조 확인합니다.

4. 동전 유형 문자열과 함께 후행 공백이나 보이지 않는 유니코드 문자가 복사되지 않았는지 확인하세요.

5. 지갑 삽입이나 스크립트 실행을 방해하는 타사 브라우저 확장을 비활성화합니다.

자주 묻는 질문

Q: 토큰을 소유하지 않고도 토큰을 추가할 수 있나요? A: 아니요. 지갑에는 잔액 데이터를 채우기 위해 코인 개체의 소유 인스턴스가 하나 이상 필요합니다. 소유권 없이 토큰을 추가하면 잔액이 0이 되고 거래 내역이 없습니다.

Q: 내 사용자 지정 토큰에 이름이 "알 수 없음"으로 표시되는 이유는 무엇입니까? 답변: 이는 온체인 패키지에 메타데이터 게시가 부족하거나 Move 모듈의 CoinMetadata 구조에서 이름 및 기호 필드가 비어 있을 때 발생합니다.

Q: 신뢰할 수 없는 출처의 코인 종류를 붙여넣어도 안전한가요? A: 본질적으로 안전하지 않은 것은 아닙니다. 코인 유형 자체는 변경 불가능하고 공개적입니다. 하지만 출처를 확인하면 실수로 악의적인 이름의 클론이나 재진입이 발생하기 쉬운 변형이 추가되는 것을 방지할 수 있습니다.

Q: 지갑 버전을 업데이트한 후 토큰을 다시 추가해야 하나요? A: 아니요. 토큰 구성은 암호화된 지갑 저장소에 로컬로 저장되며 수동으로 삭제하거나 지갑 데이터를 재설정하지 않는 한 업데이트 후에도 유지됩니다.