지갑 재스캔은 이미 검증된 로컬 블록에서 내 지갑의 주소·스크립트와 일치하는 거래를 다시 찾는 작업입니다. 재인덱스는 노드의 블록 인덱스나 체인 상태 데이터베이스를 로컬 블록 파일에서 다시 구축하는 훨씬 큰 작업입니다. 시드·디스크립터를 가져온 뒤 과거 거래만 안 보이면 재스캔 범위와 timestamp를 먼저 점검하고, 블록 인덱스 손상 같은 명확한 노드 오류가 있을 때만 재인덱스를 검토해야 합니다.
같은 ‘다시 읽기’처럼 보여도 범위가 다릅니다
rescanblockchain은 로컬 블록체인을 지정 높이부터 훑어 현재 지갑과 관련된 거래를 찾습니다. 블록의 합의 유효성을 처음부터 다시 판단하는 명령이 아니라 지갑이 놓친 입출금 기록을 재발견하는 과정입니다. 새 디스크립터를 가져왔거나 백업 지갑을 복구했는데 과거 거래가 비어 있을 때 우선 검토할 수 있습니다.
reindex는 블록 파일을 바탕으로 블록 인덱스와 chainstate를 다시 만드는 노드 수준 작업입니다. 디스크 오류, 손상된 인덱스, 버전 변경에서 명시적으로 요구되는 상황처럼 근거가 있을 때 사용합니다. 지갑 거래 하나가 안 보인다는 이유만으로 reindex부터 실행하면 긴 시간과 I/O를 쓰면서도 잘못된 디스크립터나 범위 문제는 해결하지 못할 수 있습니다.
재스캔은 ‘내 지갑 거래를 다시 찾기’, 재인덱스는 ‘노드 장부 구조를 다시 만들기’입니다.
JOBCOIN 해설
그림은 이 주제의 공통 개념을 단순화한 설명입니다. 아래 항목에서 이 글의 구체적인 조건과 예외를 함께 읽어보세요.
- 같은 ‘다시 읽기’처럼 보여도 범위가 다릅니다
rescanblockchain은 로컬 블록체인을 지정 높이부터 훑어 현재 지갑과 관련된 거래를 찾습니다.
- 증상과 계층을 맞춰 가장 작은 작업부터 선택합니다
체인 높이가 최신이고 다른 지갑 거래는 정상인데 새로 가져온 주소의 과거 입금만 빠졌다면 지갑 스캔 계층을 봅니다.
- 시작 높이와 timestamp를 근거 있게 정합니다
재스캔을 제네시스부터 무조건 시작하면 오래 걸리고 프루닝 노드에서는 필요한 블록이 없을 수 있습니다.
AI로 제작한 개념도 · 실제 가격·거래 내역·통계가 아닙니다.
증상과 계층을 맞춰 가장 작은 작업부터 선택합니다
체인 높이가 최신이고 다른 지갑 거래는 정상인데 새로 가져온 주소의 과거 입금만 빠졌다면 지갑 스캔 계층을 봅니다. 반대로 노드가 시작할 때 블록 데이터베이스 손상 오류를 내거나 검증 체인 자체를 불러오지 못한다면 노드 데이터 계층 문제일 수 있습니다. GUI 잔액, 지갑 RPC, blockchain RPC를 나눠 확인하면 화면 새로고침 문제까지 구분할 수 있습니다.
importdescriptors는 각 디스크립터의 timestamp를 이용해 스캔 시작점을 정합니다. ‘now’는 과거 사용이 없다고 확실한 출력에서만 스캔을 건너뛰는 용도입니다. 이미 사용한 디스크립터에 now를 넣으면 과거 거래를 찾지 못할 수 있습니다. 0을 쓰면 전체 체인을 대상으로 하지만 시간과 로컬 블록 보관 범위를 감당해야 합니다.
| 증상 | 우선 확인 | 검토 작업 |
|---|---|---|
| 복구 지갑의 과거 거래만 누락 | 디스크립터·timestamp·스캔 상태 | 범위를 정한 재스캔 |
| 최근 거래만 아직 안 보임 | 노드 동기화·멤풀·지갑 스캔 | 동기화 완료 대기 |
| 블록 인덱스 손상 오류 | debug.log·디스크 상태 | 백업 후 재인덱스 검토 |
| 프루닝 이전 구간 거래 누락 | pruneheight·최초 사용 높이 | 블록 재확보 후 스캔 |
| 주소 자체가 다름 | 파생 경로·패스프레이즈 | 백업 정보 재검증 |
시작 높이와 timestamp를 근거 있게 정합니다
재스캔을 제네시스부터 무조건 시작하면 오래 걸리고 프루닝 노드에서는 필요한 블록이 없을 수 있습니다. 지갑을 처음 만든 날짜, 첫 입금의 탐색기 블록 높이, 디스크립터 생성 시각을 이용해 약간 앞선 안전 구간을 정하세요. 시각은 블록 시간과 정확히 일치하지 않을 수 있어 importdescriptors가 이른 블록까지 여유를 두는 이유도 이해해야 합니다.
범위를 너무 좁게 잡으면 거래를 놓치고 너무 넓게 잡으면 자원을 낭비합니다. 여러 디스크립터를 함께 가져오면 가장 이른 timestamp가 전체 작업 시간을 좌우할 수 있습니다. 외부 주소와 내부 거스름돈 디스크립터가 모두 있는지, range가 실제 사용 인덱스를 포함하는지도 확인해야 스캔 성공 후 잔액이 완전합니다.
- 백업 원본을 복사하고 지갑 파일을 직접 덮어쓰지 않습니다.
- 현재 blocks·pruned·pruneheight를 기록합니다.
- 디스크립터 checksum, range, internal, timestamp를 확인합니다.
- 첫 사용 블록보다 약간 앞선 시작점을 정합니다.
- getwalletinfo의 scanning 진행과 완료 결과를 저장합니다.
프루닝 노드에서는 없는 블록을 읽을 수 없습니다
재스캔 명령은 네트워크에서 모든 과거 블록을 자동으로 다시 채워 주는 만능 복구가 아닙니다. 필요한 높이가 pruneheight 아래라면 로컬 원시 블록이 삭제됐을 수 있습니다. 이때 스캔 실패나 불완전한 잔액을 키 오류로 오해하지 말고 블록 데이터 가용성부터 확인합니다.
전체 블록을 다시 확보하려면 비프루닝 데이터 디렉터리나 재다운로드 계획이 필요할 수 있습니다. 프루닝 상태에서 reindex를 시작하면 보존된 일부 파일만으로 과거 전 구간을 복구할 수 없어 대규모 다운로드로 이어질 수 있습니다. 중요한 지갑 복구라면 별도 저장장치의 검증된 노드에서 watch-only로 먼저 확인하는 방법도 고려할 수 있습니다.
스캔 성공은 지출 가능성까지 자동 증명하지 않습니다
거래가 발견되고 잔액이 나타나도 해당 출력의 개인키나 필요한 멀티시그 키를 모두 가진다는 뜻은 아닙니다. watch-only 디스크립터는 거래를 볼 수 있지만 서명할 수 없습니다. getaddressinfo와 listdescriptors에서 spendable 여부, 디스크립터 구성, 키 원본을 별도로 확인하세요.
반대로 잔액이 0이라고 해서 온체인 자산이 없다고 단정하지 않습니다. 잘못된 네트워크, 누락된 계정 번호, 패스프레이즈 오타, 파생 경로 차이, gap limit 문제도 같은 화면을 만들 수 있습니다. 재스캔은 올바른 스크립트 집합을 올바른 블록 범위에 적용할 때만 의미가 있습니다.
완료 증거를 남겨 같은 작업을 반복하지 않습니다
스캔 시작·종료 높이, 지갑 이름, 디스크립터 식별 정보, 완료 시각, 발견된 거래 수를 기록합니다. 민감한 xprv나 시드 문구는 로그에 남기지 말고 공개키 기반 디스크립터도 공개 범위를 신중히 관리하세요. 스캔 도중 중단됐다면 마지막 높이와 오류를 보존해야 다음 시도 범위를 정할 수 있습니다.
재인덱스까지 필요했다면 실행 근거와 디스크 검사 결과, 소요 시간, 최종 체인 높이를 별도로 남깁니다. 단순히 GUI에 잔액이 보였다는 사실보다 노드 동기화 완료, 지갑 스캔 완료, 지출 가능 키 확인을 각각 증거로 갖춰야 복구 완료 범위를 정확히 말할 수 있습니다.
자주 묻는 질문
rescanblockchain과 reindex를 같이 실행해야 하나요?
일반적으로 아닙니다. 지갑 거래 탐색 문제라면 재스캔을 먼저 검토하고, 블록 인덱스 손상처럼 노드 수준 근거가 있을 때만 재인덱스를 고려합니다.
timestamp를 now로 넣어도 되나요?
해당 디스크립터가 과거에 절대 사용되지 않았다고 확실할 때만 적합합니다. 과거 입금이 있었다면 더 이른 시각이나 높이에서 스캔해야 합니다.
재스캔이 끝났는데도 잔액이 0이면요?
파생 경로, 계정, 패스프레이즈, 디스크립터 range, 네트워크, 프루닝 보관 범위를 다시 확인하세요. 스캔 완료만으로 입력 스크립트가 옳다고 보장되지는 않습니다.
더 깊이 읽기
본문에서 다룬 개념과 확인 절차를 다음 글에서 이어서 살펴보세요.
