오픈소스 스크립트로 TokenPocket 분실 비밀번호 일괄 대입 복구하는 방법

TokenPocket(토큰포켓) 지갑의 비밀번호를 잊어버렸지만 keystore 파일이나 지갑 백업본이 남아 있다면, 오픈소스 스크립트를 이용한 분실 비밀번호 일괄 대입(배치 공격) 은 충분히 시도해 볼 가치가 있는 현실적인 복구 경로입니다. 핵심은 무작정 모든 조합을 넣는 것이 아니라, 지갑 파일의 암호 구조를 이해하고 후보군을 설계한 뒤 GPU로 병렬 검증하는 것입니다. 이 글에서는 TokenPocket keystore의 구조 분석부터 hashcat·John the Ripper·Python 스크립트를 조합한 단계별 배치 대입 절차, 그리고 실패 확률을 줄이는 실전 노하우까지 정리합니다.

⚠️ 본 가이드는 본인이 소유한 지갑의 비밀번호 복구만을 목적으로 합니다. 타인의 지갑 파일에 대한 접근 시도는 법적 처벌 대상입니다.


1. 먼저 진단하세요: 비밀번호 분실인가, 니모닉 분실인가

복구 전략은 남아 있는 자산의 종류에 따라 완전히 달라집니다. 많은 사용자가 이 단계를 건너뛰고 불필요한 크래킹을 시도하다 시간을 낭비합니다.

| 상황 | 남아 있는 자산 | 권장 접근 |
|---|---|---|
| 비밀번호만 분실 | keystore JSON 파일 | 오픈소스 스크립트 배치 대입 (이 글의 주제) |
| 니모닉(12/24단어) 보유 | 니모닉 문구 | 새 지갑에 재가져오기 — 크래킹 불필요 |
| 니모닉 일부만 기억 | 단어 조각 | BIP39 사전 기반 조합 추론 |
| 파일 자체 분실 | 없음 | 기기 포렌식·백업 복원 외에는 사실상 불가 |

니모닉이 있다면 배치 대입을 시도하지 마세요. 복구 시간이 수 초로 줄어듭니다. 비밀번호 대입은 오직 keystore 파일만 남은 경우의 최후 수단입니다.


2. TokenPocket keystore 파일의 구조 이해

TokenPocket은 로컬 지갑 개인키를 Web3 Secret Storage(keystore JSON) 규격으로 암호화해 저장합니다. 파일을 열어 보면 다음과 같은 필드가 보입니다.

  • address — 지갑 주소 (평문)
  • crypto.cipher — 일반적으로 aes-128-ctr
  • crypto.cipherparams.iv — 초기화 벡터
  • crypto.ciphertext — 암호화된 개인키
  • crypto.kdf — scrypt 또는 pbkdf2
  • crypto.kdfparams — salt, n, r, p, dklen
  • crypto.mac — 파생키 검증용 해시

동작 원리는 단순합니다.

  1. 사용자가 입력한 비밀번호 + salt → KDF(scrypt/PBKDF2) → 파생키 생성
  2. 파생키의 일부로 mac 검증 → 불일치하면 즉시 탈락
  3. 일치하면 AES-CTR로 개인키 복호화

즉 비밀번호 검증이 「MAC 비교」라는 초고속 연산으로 끝나기 때문에, 수백만 개의 후보를 순차 대입하는 배치 공격에 구조적으로 적합합니다. 다만 scrypt는 메모리 집약형이라 CPU만으로는 속도가 나오지 않으므로 GPU 가속이 사실상 필수입니다.

또한 TokenPocket에는 지갑 비밀번호와 결제 비밀번호(6자리 PIN) 가 별도로 존재합니다. 대부분의 분실 사고는 keystore를 여는 지갑 비밀번호에서 발생하며, PIN은 keystore 크래킹과 무관합니다.


오픈소스 스크립트 비밀번호 대입

3. 사용할 오픈소스 도구 조합

| 도구 | 역할 | 비고 |
|---|---|---|
| hashcat | GPU 기반 대량 해시 대입 | mode 15600(scrypt), 15700(PBKDF2-HMAC-SHA256) |
| John the Ripper (jumbo) | CPU 기반 보조 크래킹 | john --list=formats | grep -i eth 로 지원 포맷 확인 |
| btcrecover | 비트코인 계열·이더리움 프리세일 지갑 특화 | keystore JSON에는 부적합, 참고용 |
| eth-account / web3.py | 최종 비밀번호 검증 및 복호화 | Python 라이브러리 |
| 커스텀 Python 배치 스크립트 | 후보 생성·검증 자동화 | 아래 5절 예시 참조 |

btcrecover는 훌륭한 도구지만 TokenPocket keystore 형식을 직접 지원하지 않습니다. 이 글의 목적에서는 hashcat + 자체 스크립트 조합이 가장 효율적입니다.


4. 배치 대입 전체 워크플로

4-1. 에어갭(오프라인) 환경 구성

가장 먼저, 그리고 반드시 지켜야 할 단계입니다. keystore와 후보 사전은 네트워크가 차단된 PC에서만 다루세요.

  • Wi-Fi/이더넷 물리 분리 또는 NIC 비활성화
  • 가능하면 Live USB로 부팅한 임시 OS 사용
  • 작업 종료 후 사용한 USB는 별도 보관
  • 클라우드 동기화 폴더에 keystore를 절대 두지 않기

4-2. keystore → 크래킹용 해시 추출

hashcat은 keystore JSON을 직접 읽지 못하므로 변환 단계가 필요합니다. 커뮤니티에 공개된 keystore 변환 스크립트(예: keystore2hashcat 계열)를 사용해 hash.txt를 만듭니다.

python keystore2hashcat.py keystore.json > hash.txt

변환 후 crypto.kdf 값에 따라 모드를 확정합니다.

  • scrypt → -m 15600
  • pbkdf2 → -m 15700

4-3. 후보군 설계가 승부처입니다

순수 무차별 대입으로 8자리 이상 영문+숫자 조합을 뚫는 것은 사실상 불가능합니다. 반드시 사람의 기억 패턴을 공략하세요.

  • 사전 공격: 이전에 쓰던 비밀번호 목록, 유출 사전(rockyou 등), 자주 쓰는 단어 조합

토큰포켓 지갑 복구

  • 규칙 공격: best64.rule, dive.rule 등으로 대소문자·접미사 변형 자동 확장
  • 마스크 공격: 생년월일(?d?d?d?d?d?d), 전화번호 뒷자리, 기념일 패턴
  • 하이브리드: 사전 단어 + 숫자 4자리 조합
  • 한글 자판 변환: 한글로 입력한 줄 알았는데 영문 자판으로 찍힌 경우(dkssud ↔ 안녕)를 후보에 반드시 포함

4-4. 병렬 실행 예시

# 사전 + 규칙 기반 (PBKDF2 계열)
hashcat -m 15700 -a 0 hash.txt wordlist.txt -r rules/best64.rule --potfile-disable

# 마스크 기반 (영문 4자 + 숫자 4자)
hashcat -m 15600 -a 3 hash.txt ?u?l?l?l?l?d?d?d?d

# 하이브리드 (사전 단어 + 숫자 2자)
hashcat -m 15700 -a 6 hash.txt wordlist.txt ?d?d

--potfile-disable 옵션은 크래킹 결과가 로컬 potfile에 평문으로 남는 것을 막아줍니다. scrypt 모드(15600)는 GPU 메모리를 많이 소모하므로, 메모리 부족 오류가 뜨면 -n·-u 값과 워크로드 프로파일을 낮춰 조정하세요.

4-5. MATCH 확인과 복호화 검증

hashcat이 Status: Cracked를 출력하면 해당 평문을 반드시 별도 스크립트로 재검증합니다. keystore의 mac과 실제 복호화된 개인키가 맞아떨어져야 진짜 성공입니다.


5. Python으로 직접 만드는 배치 검증 스크립트

소규모 후보군(수천~수만 개)이라면 hashcat 없이 Python만으로도 충분합니다. 아래는 가장 단순한 형태의 배치 검증 루프입니다.

import json
from eth_account import Account

with open('keystore.json', 'r', encoding='utf-8') as f:
    ks = json.load(f)

with open('candidates.txt', 'r', encoding='utf-8') as f:
    for line in f:
        pw = line.rstrip('\n')
        if not pw:
            continue
        try:
            pk = Account.decrypt(ks, pw)

![TokenPocket 비밀번호 복구](/assets/upload/15/ddd1988115da1ac34a8d37f3f3d995aa_800_600.jpg)

            print('[MATCH]', pw, pk.hex())
            break
        except Exception:
            pass

이 스크립트는 이해하기 쉽지만 CPU 단일 스레드로 동작하므로 속도가 매우 느립니다. 실전에서는 hashcat으로 대량 스크리닝 → Python으로 최종 검증의 2단계 구조를 권장합니다. 후보 목록은 itertools.product로 생성하되, 메모리 폭발을 막기 위해 제너레이터로 스트리밍하는 것이 안전합니다.


6. 성공률을 높이는 실전 팁

  • 기억 조각을 문서화하세요. 비밀번호 길이, 사용한 특수문자, 대략적인 생성 시기만으로도 탐색 공간이 수십 배 줄어듭니다.
  • 변형 규칙을 직접 작성하세요. best64.rule은 범용이지만, 본인만의 접두사·접미사 규칙을 넣으면 적중률이 크게 올라갑니다.
  • KDF 파라미터를 확인하세요. n 값이 크면 시도 속도가 급감하므로, 현실적인 시간 예산을 먼저 계산해야 합니다.
  • 여러 지갑 파일을 동시에 처리하세요. 동일 비밀번호를 재사용했다면 한 번의 크래킹으로 여러 keystore가 동시에 열립니다. 이때는 hash.txt에 여러 해시를 넣고 일괄 실행합니다.
  • 중단·재개를 활용하세요. hashcat은 세션을 저장하므로 장시간 작업 시 --session과 --restore를 사용하세요.

7. 대입이 실패했을 때의 대안

  • 부분 기억 기반 니모닉 추론: BIP39 2048단어 사전과 체크섬 규칙을 이용해 누락 단어를 역추적
  • 기기 백업 복원: Android/iOS 전체 백업, iTunes·iCloud·ADB 백업에 keystore가 포함된 경우
  • 이전 기기·메모·비밀번호 관리자 점검: 생각보다 많은 사용자가 브라우저 저장 비밀번호에 단서를 남겨둡니다
  • 전문 복구 서비스 상담: 성공 시에만 수수료를 받는 조건인지 반드시 확인

BIP39/BIP32 표준 기반의 니모닉 복구 절차나 MetaMask·Electrum·Ledger 등 지갑별 비밀번호 복구 흐름까지 한눈에 정리해 둔 코인 지갑 복구 전문 가이드(/) 를 함께 참고하면, keystore 크래킹이 실패했을 때 다음 시나리오로 빠르게 전환할 수 있습니다.


8. 보안 수칙과 재발 방지

복구 과정 자체가 자산 탈취 위험을 만듭니다. 다음 원칙을 반드시 지키세요.

  1. 모든 작업은 오프라인에서 수행하고, 결과 평문 비밀번호를 메신저·메일로 전송하지 않습니다.
  2. 크래킹에 사용한 PC는 작업 후 재설치 또는 포맷을 권장합니다.
  3. 복구에 성공하면 즉시 새 지갑을 생성해 자산을 이동하고, 기존 keystore는 안전하게 폐기합니다.
  4. 비밀번호는 비밀번호 관리자에 보관하고, 니모닉은 종이·금속판 등 오프라인 매체에 분할 보관합니다.
  5. 하드웨어 지갑과 멀티시그를 병행해 단일 실패 지점을 제거합니다.

마무리

오픈소스 스크립트를 이용한 TokenPocket 분실 비밀번호 일괄 대입은 구조를 이해하고, 후보군을 설계하고, GPU로 병렬 검증한다는 세 축으로 정리됩니다. keystore의 MAC 검증 구조를 활용하면 탐색 속도를 극대화할 수 있고, 개인화된 후보군을 설계하면 성공 확률은 이론값보다 훨씬 높아집니다. 무엇보다 중요한 것은 속도가 아니라 보안입니다. 모든 과정을 에어갭 환경에서 수행하고, 복구 성공 후에는 즉시 자산을 새 지갑으로 이전하세요. 더 세부적인 지갑별 복구 절차와 예방 전략은 코인 지갑 복구 전문 가이드(/) 에서 계속 확인할 수 있습니다.