🚀 Quick Start

Tanpa install (via npx):

npx eip7702-tool

Atau dari source:

git clone https://github.com/nemoobc/EIP-7702-TOOL.git
cd EIP-7702-TOOL
npm install
npm start

Butuh Node.js v18+. Untuk fitur Mining PoW: npm install --include=optional (solver native).

Pertama kali? Pilih menu 2. Create Wallet, lalu funding di Sepolia via menu 17. Mining POW atau faucet. Default network sudah Sepolia testnet — aman untuk eksperimen.

✨ Fitur

🌐 Jaringan

| Network | Chain ID | | Network | Chain ID | |:--------|:--------:|-|:--------|:--------:| | Ethereum Mainnet | 1 | | Base | 8453 | | Sepolia (default) 🟢 | 11155111 | | Polygon | 137 | | Arbitrum One | 42161 | | BNB Smart Chain | 56 | | OP Mainnet | 10 | | Custom | any |

🏗️ Cara Kerja EIP-7702

┌─────────┐   sign auth    ┌──────────────┐   type-4 tx   ┌─────────────┐
│   EOA   │ ─────────────► │ Authorization│ ────────────► │ Kode akun   │
│ (target)│                │ {chainId,    │               │ 0xef0100‖impl│
└─────────┘                │  impl,nonce} │               └──────┬──────┘
                           └──────────────┘                      │ delegatecall
                     sponsor bayar gas ─────────►        ┌──────▼──────┐
                                                         │ Kontrak impl│
                                                         │ rescue/batch│
                                                         └─────────────┘

• Self-sponsored: EOA mengirim tx sendiri (auth nonce = nonce + 1)
• Sponsored: pihak lain membayar gas; EOA hanya tanda tangan authorization
• Revoke: delegasi ke alamat 0x0 → akun kembali EOA biasa

Tool ini menangani RLP encoding, signing, nonce management, dan estimasi gas secara otomatis.

📚 Panduan Singkat

Kirim ETH / Token

Pilih menu 10/11 → pilih wallet → masukkan tujuan → mode manual/MAX → konfirmasi. Input bisa dalam ETH atau USD (konversi otomatis via CoinGecko).

Rescue Assets (wallet terkunci)

Menu 8 → deploy kontrak rescue (sekali, lalu reuse) → target hanya sign authorization → sponsor membayar gas → aset pindah atomik ke alamat SAFE.

Approval Manager

Menu 18 → pilih mode scan:

• Token populer — 19 token bawaan (USDT, USDC, DAI, WETH, WBTC, LINK, UNI, AAVE, SHIB, MATIC, ARB, OP, PEPE, CRV, SNX, SUSHI, COMP, MKR, LDO) + alamat token kustom
• Menyeluruh — semua token apa pun via Etherscan API (API key gratis); riwayat approval diambil dari event log blockchain lalu diverifikasi allowance() per spender

Lalu pilih yang mau di-revoke:

• Self — owner bayar gas
• Sponsor — via EIP-7702 atomic dengan kontrak approvalRevoker

Di RPC publik, mode populer dibatasi riwayat ~1M blok terakhir. Mode menyeluruh tidak terpengaruh karena data diambil dari Etherscan.

Wizard Deploy

Menu 15 → pilih ERC-20/721/1155 → kombinasikan fitur (mintable, burnable, pausable, roles, permit, flash minting, UUPS proxy) → deploy → verifikasi otomatis ke Sourcify & Blockscout.

Mining POW (Sepolia)

Menu 17 → ambil CAPTCHA token dari sepolia-faucet.pk910.de → mining CryptoNight berjalan → checkpoint claim tiap 0.05 ETH → opsional auto-delegate EIP-7702 setelah claim.

🧪 Testing

Suite test on-chain sudah dihapus dari repo (keputusan maintainer). Verifikasi rilis dilakukan langsung terhadap tool di jaringan lokal.

Validasi v3.4.0 — dijalankan end-to-end pada fork lokal (anvil, hardfork Prague) dari 11 jaringan: Ethereum mainnet & Sepolia, BSC testnet, Polygon mainnet & Amoy, Arbitrum One & Sepolia, OP Mainnet & Sepolia, Base & Base Sepolia — mencakup create/import wallet, kirim ETH & token, delegasi EIP-7702 self/sponsored, batch call atomik, rescue ETH, revoke delegation, wizard deploy ERC-20, approval scan, gas fee, dan menu mining PoW.

Catatan: fork lokal BSC mainnet saat ini tidak stabil bukan karena tool, melainkan crash di anvil (foundry) saat mining blok pada fork tersebut — alur identik telah lolos di BSC testnet.

🔒 Security

• Private key tidak pernah meninggalkan komputer — wallet disimpan sebagai kestore terenkripsi di ~/.wallet-cli/wallets/
• Transaksi mainnet selalu meminta konfirmasi manual (ketik "YA")
• Kontrak rescue/batch/revoker punya access control ketat: hanya rescuer/deployer yang bisa memanggil
• Registry kontrak deploy di-scope per chainId — tidak ada reuse lintas-jaringan

Rekomendasi tambahan:

• Gunakan wallet baru khusus testing, jangan wallet utama
• Untuk mainnet, pakai RPC berbayar (Alchemy/QuickNode) — RPC publik sering tidak mendukung tx type-4
• Backup folder ~/.wallet-cli/wallets/ dan mnemonic di tempat aman

Laporkan kerentanan: buka Security Advisory (jangan public issue).

⚠️ Disclaimer

Software ini disediakan apa adanya, tanpa jaminan apa pun. Transaksi blockchain bersifat final dan tidak dapat dibatalkan. Pengguna bertanggung jawab penuh atas private key, transaksi, dan penggunaan tool ini di jaringan mana pun. Verifikasi setiap alamat dan jumlah sebelum konfirmasi.

❓ FAQ

Transaksi gagal di mainnet? RPC publik rate-limited / tidak support type-4 → ganti ke Alchemy/QuickNode. Cek juga saldo gas.

Support hardware wallet? Belum. Saat ini JSON keystore saja.

Berapa banyak token discan Approval Manager? 19 token populer + token kustom yang Anda tambahkan.

Support multi-chain? Ya — Mainnet, Sepolia, Arbitrum, OP, Base, Polygon, BSC, dan custom network.

🔧 Troubleshooting

| Error | Solusi | |-------|--------| | RPC provider does not support EIP-7702 | Ganti ke Alchemy/QuickNode | | Insufficient funds for gas | Tambah saldo ETH | | Transaction nonce too low | Tunggu beberapa detik, ulangi | | Solver CryptoNight belum tersedia | npm install --include=optional (butuh Python untuk build native) | | Password salah atau file wallet rusak | Cek password / buat wallet baru | | Session tidak ditemukan (mining) | Session expired, buat session baru |

💝 Donate

Ethereum / Sepolia: 0x5e02fac179dfbd8a63fa7058011b348fdbba7158

📜 Lisensi

MIT — lihat LICENSE.