Akun Garuda (Smart Account)

Akun Garuda adalah rekening utama Dompet Garuda di jaringan. Bentuknya Smart Account proxy (account abstraction, ERC-4337): aset dan aktivitas GDC berpusat di alamat Akun Garuda, sementara perangkat pengguna hanya berperan sebagai penanda tangan.

Setelah Garuda ID aktif, alamat terima, kirim, dan QR GDC memakai Akun Garuda, bukan alamat penanda tangan di perangkat.

Model produk (tetap)

Konsep	Peran
Garuda ID	Identitas digital (@username) di ekosistem Garuda
Penanda tangan	EOA di perangkat. Membuka wallet dan menandatangani transaksi
Akun Garuda	Smart Account proxy on-chain. Rekening utama untuk GDC

Arah produk yang berlaku:

1. Akun Garuda (proxy) adalah rekening utama. Tidak ada pengembalian ke model “EOA perangkat sebagai rekening GDC utama”.
2. Pengguna baru setelah Garuda ID mendapat Akun Garuda dari factory proxy terkini (tanpa gerbang upgrade versi).
3. Pengguna Akun Garuda lama (akun non-proxy / factory lama) wajib menyelesaikan upgrade versi sebelum masuk beranda, lalu memakai alamat proxy baru sebagai rekening utama.
4. Alamat penanda tangan dan Akun Garuda berbeda. Itu disengaja: kontrol tanda tangan tetap di perangkat, saldo serta aktivitas GDC di Smart Account.

Mengapa proxy Smart Account

1. Satu alamat rekening untuk terima, kirim, dan QR setelah Garuda ID aktif
2. Logika akun dapat diperbarui lewat UUPS pada implementasi, tanpa mengganti peran penanda tangan pengguna
3. Signer tetap di pengguna: transaksi ditandatangani dari perangkat
4. Siap account abstraction: sponsor gas (paymaster) dapat menanggung biaya jaringan sesuai kuota layanan

Integrator Dompet Garuda resmi tidak perlu mengelola EntryPoint atau paymaster secara manual untuk alur pengguna standar.

Alur pengguna di Dompet Garuda

1. Buat atau impor wallet (seed phrase / password)
2. Buat Garuda ID (wajib sebelum masuk dashboard)
3. Sistem menyiapkan Akun Garuda (proxy factory terkini)
4. Jika akun lama terdeteksi, selesaikan layar Versi baru tersedia sekali
5. Bagikan @username atau alamat Akun Garuda untuk menerima GDC

Produksi: wallet.garudachain.id

Upgrade dari akun lama

Akun Garuda versi lama (deploy CREATE2 non-proxy) diganti menjadi proxy permanen. Dompet memindahkan aset liquid ke alamat baru saat upgrade.

Catatan untuk pengguna dan dukungan:

• Staking yang masih terkunci tetap di akun lama sampai masa kunci selesai, lalu dapat dipulihkan
• NFT yang masih listing di pasar perlu dibatalkan listing dulu sebelum dipindahkan
• Panel pemulihan di beranda membantu menyelaraskan sisa aset setelah upgrade

Jangan mengarahkan pengguna untuk “kembali memakai alamat perangkat sebagai rekening GDC”. Penanda tangan hanya untuk autentikasi dan tanda tangan.

Yang boleh dipublikasikan ke pengguna

• Garuda ID adalah identitas (@username), bukan NIK
• Alamat QR / terima setelah aktivasi adalah Akun Garuda
• Perangkat hanya untuk autentikasi dan tanda tangan
• Saldo GDC utama ada di Akun Garuda
• Garuda Pay (Rp) memakai saldo Pay, terpisah dari alamat GDC on-chain

Yang tidak perlu ditampilkan ke publik

Hindari mempublikasikan detail operasional internal, misalnya:

• Kunci privat, seed phrase, atau skrip operator
• Endpoint admin, allowlist sponsor, atau parameter kuota internal
• Alamat treasury / float / kontrak operasional yang tidak ditujukan untuk pengguna
• Runbook VPS, hardfork, atau prosedur break-glass
• Alamat factory / logic internal kecuali diperlukan untuk integrator yang sudah disepakati

Untuk pengguna, cukup jelaskan peran Garuda ID, Akun Garuda, dan penanda tangan.

Integrasi wallet pihak ketiga

MetaMask dan wallet EOA lain dapat terhubung ke Garuda Chain (Chain ID 8846) sebagai akun tanda tangan biasa. Fitur Akun Garuda (proxy) dan Garuda ID adalah pengalaman Dompet Garuda resmi.

Lihat juga:

• Wallet Integration
• RPC Endpoints
• Chain Overview

Explorer

Cek aktivitas on-chain Akun Garuda:

https://explorer.garudachain.id/accounts/<alamat-akun-garuda>

Pastikan alamat yang dicek adalah Akun Garuda, bukan hanya penanda tangan di perangkat, jika pengguna sudah mengaktifkan Akun Garuda.