BTC Self-Recovery Toolkit

Tool pribadi untuk memeriksa mana dari backup seed phrase Bitcoin milik Anda sendiri yang masih memiliki saldo.

PERINGATAN: Tool ini hanya untuk seed phrase yang Anda miliki sendiri. Menggunakan seed phrase orang lain = pencurian. Jangan lakukan.

Prinsip Desain: Air-Gap

Tool dibagi menjadi dua skrip yang sengaja dipisah:

Skrip	Mode jaringan	Butuh internet?	Menyentuh seed?
derive_addresses.py	OFFLINE (Airplane Mode di Android)	TIDAK	YA
check_balances.py	ONLINE	YA	TIDAK

Alur (Termux / satu device):

[seeds.txt]  --(AIRPLANE MODE ON)-->  derive_addresses.py  -->  [addresses.json]
                                                                    |
     hapus seeds.txt, matikan Airplane Mode                         |
                                                                    v
                                                       check_balances.py  -->  [balances.csv]

Seed phrase tidak pernah dikirim ke jaringan karena saat diproses perangkat offline.

Instalasi

Di Termux (Android)

Karena di Android Anda hanya punya satu device, "air-gap" disimulasikan dengan Airplane Mode.

1. Install Termux dari F-Droid (versi Play Store sudah usang, jangan dipakai).
2. Beri izin storage (opsional, kalau mau baca/tulis ke ~/storage):

   termux-setup-storage

3. Jalankan skrip setup satu kali selagi masih online:

   bash setup_termux.sh

   Skrip ini menginstal python, libsecp256k1, toolchain build, lalu bip_utils + requests.

Di Linux/Mac biasa (dua mesin terpisah)

Mesin offline:

pip install -r requirements-offline.txt

Mesin online:

pip install -r requirements-online.txt

Pemakaian

1. Siapkan file seeds

Buat seeds.txt, satu seed phrase per baris (12/18/24 kata BIP39). Hapus setelah selesai.

Contoh di Termux, gunakan editor nano:

pkg install -y nano
nano seeds.txt

2. AKTIFKAN Airplane Mode (penting di Termux)

Matikan juga Wi-Fi dan Bluetooth secara manual. Pastikan indikator sinyal hilang.

3. Derive addresses (offline)

python derive_addresses.py --seeds seeds.txt --out addresses.json --accounts 1 --per-account 20

Ini menghasilkan addresses.json yang berisi address untuk empat jenis derivasi standar:

• BIP44 (Legacy, 1...)
• BIP49 (SegWit-compat, 3...)
• BIP84 (Native SegWit, bc1q...)
• BIP86 (Taproot, bc1p...)

4. Hapus seeds.txt

# Timpa isi file lalu hapus (shred tidak selalu ada di Termux)
: > seeds.txt && rm seeds.txt

5. Matikan Airplane Mode

Nyalakan kembali internet.

6. Cek saldo (online)

python check_balances.py --in addresses.json --out balances.csv

Output balances.csv akan menampilkan address, jenis derivasi, saldo (satoshi & BTC), dan jumlah transaksi. Ringkasan per-seed dicetak ke terminal.

Untuk melihat hasil di Termux:

cat balances.csv | column -t -s,

Catatan keamanan

• Setelah selesai, hapus seeds.txt dan addresses.json.
• Seed yang masih punya saldo: segera pindahkan dananya ke wallet baru yang Anda kontrol penuh (hardware wallet sangat disarankan).
• Jangan pernah ketik seed phrase ke website, keyboard pihak ketiga, atau aplikasi selain Termux.
• Di Android: gunakan keyboard AOSP / Gboard offline mode saat mengetik seed. Keyboard pihak ketiga bisa mengirim keystroke ke cloud.
• Pertimbangkan clipboard: jangan copy-paste seed phrase (clipboard manager Android bisa menyimpan riwayat).
• Idealnya: matikan auto-backup Termux di pengaturan Android sebelum mulai.

Troubleshooting Termux

coincurve gagal build Pastikan libsecp256k1, clang, make, rust terinstal:

pkg install -y libsecp256k1 clang make rust binutils libffi openssl
pip install --upgrade pip wheel
pip install -r requirements-offline.txt

pip install lambat Normal di Android, terutama saat build coincurve. Bisa 5-15 menit di HP low-end.

ModuleNotFoundError: bip_utils Pastikan Anda menjalankan python dari Termux yang sama dengan tempat pip install. Jangan campur dengan Python dari aplikasi lain.