Lewati ke isi

Prinsip Utility NFT: Garuda Chain

Status: Kebijakan pengembangan wajib
Berlaku untuk: Wallet, API, Explorer, Smart Contract, metadata, dan koleksi baru
Terakhir diperbarui: 2026-07-04

1. Pernyataan Misi

Garuda Chain tidak membangun NFT sebagai koleksi gambar.

Setiap NFT di ekosistem Garuda harus memberikan utilitas nyata: fungsi, hak akses, identitas, sertifikat, reputasi, atau manfaat ekonomis/sosial yang dapat dirasakan dan diverifikasi oleh pemiliknya melalui Garuda Wallet.

Target: Utility NFT sebagai fondasi identitas dan layanan digital Indonesia di Garuda Chain, bukan aset spekulatif atau galeri visual.

2. Prinsip Utama (Wajib)

2.1 Utilitas dulu, gambar bukan tujuan

Wajib Dilarang
Setiap NFT punya minimal satu utilitas yang dieksekusi di sistem (API, kontrak, atau Wallet) NFT hanya untuk "punya gambar langka"
Utilitas dijelaskan dalam metadata attributes (trait Utility, Access, dll.) Metadata hanya nama + gambar tanpa fungsi
Manfaat bisa diuji di staging sebelum rilis Rilis visual dulu, utilitas "nanti"

2.2 Jenis utilitas yang diakui

Setiap NFT baru harus masuk minimal satu kategori berikut:

Kategori Contoh manfaat nyata
Identitas Keanggotaan terverifikasi, KYC badge, profil merchant
Hak akses Whitelist drop, tier API, fitur Wallet terkunci
Sertifikat Pelatihan, event, kompetensi, penyelesaian program
Reputasi Tingkat kepercayaan merchant, kontributor, validator komunitas
Manfaat ekonomi Diskon MDR, bonus reward, APY staking, potongan biaya
Layanan Loyalty stamp, bukti transaksi, voucher terpakai on-chain
Fungsi operasional Hak mint turunan, delegasi, voting (governance)

2.3 Prioritas pengembangan

Urutan keputusan produk dan teknis:

  1. Pengalaman pengguna: orang awam bisa paham tanpa jargon Web3
  2. Kemudahan penggunaan: maksimal 2-3 langkah untuk merasakan manfaat
  3. Keamanan: verifikasi on-chain + auth; tidak ada utilitas "palsu" di UI saja
  4. Skalabilitas: utilitas harus bekerja untuk ribuan/m juta pemegang
  5. Efek visual: terakhir; cukup jelas dan konsisten, bukan prioritas

2.4 Satu wallet, utilitas jelas

  • Garuda Digital Card: satu keanggotaan utama per wallet (sudah berlaku).
  • NFT turunan (sertifikat, loyalty, badge) memperluas utilitas, tidak menggantikan identitas inti.
  • Hindari fragmentasi: pengguna tidak perlu mengelola puluhan NFT tanpa manfaat masing-masing.

2.5 Kejujuran UI

  • Panel "Manfaat" / perks hanya menampilkan Aktif jika backend/kontrak benar-benar menerapkan utilitas.
  • Jangan tampilkan janji manfaat yang belum diimplementasi sebagai status aktif.
  • Explorer publik: sorot utilitas dan verifikasi, bukan hanya gambar.

3. Definisi Selesai (Definition of Done)

NFT atau fitur NFT tidak boleh rilis ke production kecuali semua terpenuhi:

  • [ ] Utilitas terdokumentasi: apa yang pemilik dapatkan, syarat, dan cara pakai
  • [ ] Utilitas dieksekusi: logika di API (perks, mdr, community, dll.) atau kontrak
  • [ ] Verifikasi: Wallet/API bisa cek ownerOf / isHolder / kategori on-chain
  • [ ] Metadata: field Utility atau setara di attributes; bukan hanya image
  • [ ] UX: alur di Wallet jelas (bukan hanya di Explorer)
  • [ ] Staging: diuji di *.staging.garudachain.id
  • [ ] Keamanan: tidak membuka endpoint write tanpa auth yang sesuai
  • [ ] Backward compatible: tidak merusak Garuda Digital Card & marketplace yang ada

4. Pola Teknis yang Disarankan

4.1 On-chain

  • Gunakan NFTCategory di GarudaNFTMarketplace: MEMBERSHIP, CERTIFICATE, COLLECTIBLE, IDENTITY, PROPERTY.
  • COLLECTIBLE hanya jika koleksi punya utilitas terikat (mis. hak akses drop + whitelist), bukan seni untuk dipajang saja.
  • Metadata tokenURI → API /gnft/metadata/:tokenId dengan atribut utilitas eksplisit.

4.2 API

  • Utilitas holder: GET /api/v1/network/gnft/perks/:address
  • Penerapan manfaat: modul terpusat (nft/perks.ts, garudaPay/mdr.ts, community/reward): bukan duplikasi di UI saja.
  • Konstanta utilitas (multiplier, diskon %) satu sumber kebenaran.

4.3 Wallet

  • Tab Cards = pusat utilitas NFT, bukan galeri.
  • Setiap kartu/NFT: tampilkan manfaat aktif + aksi (pakai diskon, klaim, verifikasi).
  • Bahasa Indonesia, hindari istilah teknis di layar utama.

4.4 Explorer

  • Halaman detail NFT: judul produk + serial; sembunyikan PII di publik.
  • Tampilkan trait utilitas dan link ke layanan terkait (Wallet, merchant).

5. Peta Utilitas Saat Ini

NFT / fitur Utilitas nyata Status Catatan
Garuda Digital Card Keanggotaan + KYC ✅ Live Identitas utama
Bonus check-in +15% / +25% kolektor Reward GDC ✅ Live API applyGnftCheckInBoost (check-in only)
Pasar GNFT Jual/beli dengan GDC ✅ Live Manfaat ekonomi
Diskon MDR merchant Biaya platform turun ⚠️ UI only Harus diimplementasi
BatikNFT / WayangMint / NusaArt Whitelist akses drop ✅ Live (whitelist) POST /utility/cultural-drop/join · mint drop on-chain menyusul
Tier "collector" (≥3 kartu) Check-in ×1.25 ✅ Live COLLECTOR_CHECK_IN_BOOST_MULTIPLIER
Event Ticket (ERC-1155 id 3) Akses pintu event ✅ Live Verify API + QR Cards
ERC-1155 loyalty stamp Stamp pelanggan UMKM ✅ Live Automasi Pay

Tindakan: Item ⚠️ dan ❌ tidak boleh dipasarkan sebagai "utility" sampai memenuhi Definition of Done.

6. Contoh Baik vs Buruk

✅ Diperbolehkan

  • Sertifikat pelatihan UMKM: NFT CERTIFICATE; merchant bisa tunjukkan badge verifikasi di QR Pay; metadata berisi program & tanggal.
    API: GET /api/v1/utility/merchant-trust/:address · Wallet chip di Settings / Receive / bayar merchant.
  • Garuda Digital Card: membuka bonus check-in, pasar, dan (setelah diimplementasi) diskon MDR.
  • Loyalty stamp: ERC-1155; 10 transaksi Garuda Pay → voucher; bisa dipakai, bukan dikoleksi.
  • Stamp regional (Jakarta / Bandung): ERC-1155 id 4/5; mint otomatis bila merchantCity charge cocok; penuh → voucher mitra daerah. Tidak mengubah MDR.
  • Soft staking boost: +5%/+10% pada estimasi APR tampilan di Staking Hub untuk holder GNFT; tidak mengubah kontrak / tidak gate stake.
  • Soft gas discount: −5%/−10% pada estimasi gas tampilan di Bridge; tidak mengubah fee bridge GDC / drip gas-aid / tidak gate bridge.
  • Bukti aset UMKM (PROPERTY): ERC-721 kategori 2; mint admin; tampil di Cards + verifikasi Explorer. Bukan akta kepemilikan hukum.

Urutan rekomendasi berikutnya

Roadmap utilitas inti (1-8) selesai. Iterasi berikutnya opsional berdasarkan permintaan produk.

❌ Tidak diperbolehkan

  • Drop "seni batik" tanpa whitelist, tanpa hak akses, tanpa manfaat di Wallet/API.
  • Koleksi 10.000 gambar dengan roadmap utilitas "coming soon" tanpa tanggal dan tanpa kode.
  • Perks panel menampilkan "Diskon MDR aktif" padahal mdr.ts tidak mengecek GNFT.
  • NFT hanya untuk flex di profil sosial tanpa fungsi di Garuda Chain.

7. Peran Ekosistem

Pengguna Utility NFT membantu dengan…
Rakyat Indonesia Reward harian, identitas digital, sertifikat keterampilan, pembayaran
UMKM Badge kepercayaan, biaya lebih rendah, loyalty pelanggan, bukti transaksi
Developer API perks, kategori kontrak, metadata standar, sandbox staging

8. Proses Persetujuan NFT Baru

  1. Proposal utilitas (1 halaman): siapa pemilik, apa manfaat, bagaimana verifikasi, bagaimana UX di Wallet.
  2. Review: tolak jika utilitas tidak bisa diuji atau hanya visual.
  3. Implementasi: API + Wallet + metadata (minimal staging).
  4. Checklist DoD: section 3.
  5. Rilis production: setelah staging stabil.

Tidak ada pengecualian untuk "koleksi edisi terbatas" tanpa utilitas yang terikat.

9. Referensi Terkait

  • Garuda Utility Engine
  • Kontrak: contracts/src/nft/GarudaNFT.sol
  • Perks API: apps/api/src/nft/perks.ts
  • Metadata: apps/api/src/nft/metadata.ts
  • Katalog koleksi: apps/api/src/nft/collections.ts

10. Ringkasan Satu Kalimat

Jika pemegang NFT tidak bisa merasakan manfaatnya lewat Garuda Wallet dalam 30 detik, itu bukan Utility NFT Garuda Chain.