Stellar 니모닉 복구 과정에서 자주 발생하는 오류와 해결 방법

Stellar 지갑을 복구할 때 니모닉(복구 문구)을 입력하면 단어 하나만 틀려도 오류가 발생할 수 있습니다. 대부분의 문제는 단어 수, 철자, 순서, 체크섬, 파생 경로, 네트워크 설정에서 비롯됩니다. 아래 순서대로 확인하면 불필요한 시행착오를 줄일 수 있습니다. 단, 복구 문구는 절대 메신저나 웹사이트에 입력하지 말고 공식 지갑 또는 신뢰할 수 있는 지갑에서 안전한 환경으로 진행하세요.

1. 유효하지 않은 니모닉 문구 오류

증상: Invalid mnemonic, 니모닉이 유효하지 않습니다, 단어 수가 올바르지 않습니다.

원인: 단어 수 부족 또는 과다, 지원하지 않는 단어 목록, 오타, 대소문자 혼용, 불필요한 특수문자, 줄바꿈과 공백 문제 등입니다.

해결:

  • 지갑이 요구하는 단어 수(12개 또는 24개 등)를 확인합니다.
  • BIP39 지원 지갑이라면 공식 BIP39 영단어 목록과 대조합니다.
  • 단어는 소문자로 입력하고 앞뒤 공백과 중복 공백을 제거합니다.
  • 복사와 붙여넣기 시 숨은 문자나 줄바꿈이 들어가지 않았는지 확인합니다.
  • 한국어와 영어 등 단어 목록 언어가 지갑 설정과 일치하는지 확인합니다.

2. 체크섬 오류

증상: Checksum failed, 체크섬 오류, 복구 문구를 확인하세요.

원인: 단어 하나의 철자 오류, 단어 순서 바뀜, 단어 누락, 잘못된 단어 목록 사용 등입니다.

해결:

  • 단어 순서를 처음부터 끝까지 다시 확인합니다.
  • 비슷하게 보이는 단어를 주의 깊게 대조합니다.
  • 종이 백업과 화면 입력을 한 단어씩 비교합니다.
  • 자동 완성과 예측 입력을 끄고 직접 입력합니다.
  • 가능하면 오프라인 기기에서 검증합니다.

파생 경로

3. 파생 경로와 지갑 표준 불일치

증상: 복구는 되었지만 잔액이 0으로 표시됨, 다른 주소가 생성됨, Unable to derive keypair.

원인: 지갑마다 BIP39와 BIP44 파생 경로가 다를 수 있습니다. Stellar용 경로(예: coin type 148)와 지갑별 기본 경로가 다를 수 있으며, 동일한 니모닉이 항상 같은 주소를 만든다고 보장할 수 없습니다.

해결:

  • 복구하려는 지갑의 공식 문서에서 지원 파생 경로를 확인합니다.
  • Stellar를 지원하는 지갑에서 계정 인덱스와 파생 경로를 변경해 봅니다.
  • 이전에 사용하던 지갑 앱과 동일한 앱 및 버전으로 먼저 시도합니다.
  • Ledger 등 하드웨어 지갑은 Stellar 앱 설치 여부와 계정 인덱스를 확인합니다.
  • 여러 경로를 시도할 때는 공식 지갑의 고급 설정에서만 진행합니다.

4. 네트워크 불일치(퍼블릭과 테스트넷)

증상: 계정을 찾을 수 없음, 잔액 0, Account not found.

원인: 테스트넷에 연결되어 있거나 다른 네트워크 또는 노드에 연결된 경우입니다.

해결:

  • 지갑 설정에서 네트워크가 Stellar 퍼블릭 네트워크인지 확인합니다.
  • 테스트넷 주소는 퍼블릭 네트워크에서 조회되지 않을 수 있습니다.
  • 블록 탐색기에서 공개 주소(G로 시작)를 검색해 계정 존재 여부를 확인합니다.
  • 계정이 아직 활성화되지 않았다면 최소 잔액과 계정 생성 여부를 확인합니다.

5. 계정 미활성화와 잔액 표시 문제

증상: 복구는 성공했지만 계정이 존재하지 않습니다, 잔액이 보이지 않음.

니모닉 체크섬 오류

원인: Stellar 계정은 최소 잔액으로 활성화되어야 하며, 새 주소만 생성해서는 네트워크에 계정이 생기지 않습니다.

해결:

  • 복구된 주소가 이전에 사용하던 주소와 일치하는지 확인합니다.
  • 탐색기에서 해당 주소의 존재 여부와 잔액을 확인합니다.
  • 주소가 다르면 파생 경로와 지갑 표준 문제를 먼저 해결합니다.
  • 계정이 미활성화 상태라면 공식 지갑의 안내에 따라 최소 잔액으로 활성화합니다.

6. 니모닉 대신 비밀 키(Secret Seed)를 입력한 경우

증상: 형식 오류, Invalid secret key, 지원하지 않는 형식.

원인: 니모닉(단어)과 비밀 키(S로 시작하는 문자열)를 혼동한 경우입니다.

해결:

  • 지갑이 요구하는 입력 형식을 확인합니다.
  • 니모닉 복구 화면에는 단어를, 비밀 키 가져오기 화면에는 S로 시작하는 시드를 입력합니다.
  • 비밀 키 역시 절대 공유하지 말고 안전한 오프라인 환경에서만 사용합니다.

7. 선택적 패스프레이즈(BIP39 Passphrase) 누락

증상: 올바른 니모닉인데 다른 주소가 생성됨, 잔액 0.

원인: 니모닉 외에 추가 패스프레이즈를 설정한 경우, 복구 시 이를 입력하지 않았을 수 있습니다.

해결:

  • 이전 지갑에서 추가 패스프레이즈를 사용했는지 확인합니다.

Stellar 니모닉 복구

  • 지원 지갑의 고급 복구 옵션에서 패스프레이즈 입력란을 확인합니다.
  • 패스프레이즈를 잊은 경우 공식 지원 채널의 안내를 따르되, 복구 문구를 채팅으로 보내지 않습니다.

8. 앱과 브라우저 호환성 및 입력 오류

증상: 버튼 비활성화, 무한 로딩, 입력값 초기화.

원인: 구버전 앱, 브라우저 확장 충돌, 자동 번역, IME 입력 문제 등입니다.

해결:

  • 지갑 앱을 최신 버전으로 업데이트합니다.
  • 브라우저 확장을 비활성화하거나 공식 앱을 사용합니다.
  • 자동 번역과 자동 완성을 끕니다.
  • 모바일에서는 키보드 언어를 영어로 고정하고 입력합니다.
  • 문제가 지속되면 공식 고객 지원에 오류 메시지와 앱 버전만 공유합니다.

안전 체크리스트

  • 복구 문구는 절대 온라인에 공유하지 않습니다.
  • 공식 지갑과 공식 문서의 파생 경로를 확인합니다.
  • 단어 수, 철자, 순서, 공백을 먼저 점검합니다.
  • 퍼블릭 네트워크와 테스트넷 설정을 확인합니다.
  • 복구 후 주소가 기존 주소와 일치하는지 탐색기에서 확인합니다.
  • 의심스러운 사이트에는 니모닉을 입력하지 않습니다.

마무리

Stellar 니모닉 복구 오류는 대부분 입력값과 지갑 설정의 작은 차이에서 발생합니다. 오류 메시지를 기준으로 단어 목록, 체크섬, 파생 경로, 네트워크 순서로 확인하면 해결 가능성이 높습니다. 복구가 어렵다면 공식 지갑 지원 채널에 민감 정보를 제외한 오류 내용만 문의하세요.