Garuda Utility Engine¶

Garuda Utility Engine adalah lapisan terpusat untuk hak dan manfaat di ekosistem Garuda Chain. NFT (Garuda Digital Card) adalah salah satu carrier entitlement, bukan satu-satunya modul utilitas.

Wallet / Garuda Pay / Community
              ↓
    GET /api/v1/utility/entitlements/:address
              ↓
    Utility Engine (entitlements + effects)
              ↓
    Resolvers on-chain → Handler manfaat (check-in, MDR, voucher, dll.)

Entitlement¶

ID	Utilitas	Status
`membership.garuda-card`	Keanggotaan on-chain	✅
`reward.check-in-boost`	Bonus check-in komunitas	✅
`reward.soft-staking-boost`	Estimasi APR tampilan di Staking Hub	✅
`reward.soft-gas-discount`	Estimasi gas tampilan di Bridge	✅
`pay.mdr-discount`	Diskon fee MDR merchant	✅
`access.gnft-marketplace`	Pasar GNFT	✅
`access.cultural-drop`	Whitelist drop budaya	✅
`certificate.digital`	Sertifikat verifiable on-chain	✅
`certificate.property-umkm`	Bukti aset UMKM on-chain	✅
`loyalty.stamp`	Cap loyalitas Garuda Pay	✅
`voucher.merchant`	Voucher merchant	✅
`access.event-ticket`	Tiket event on-chain + QR check-in	✅
`identity.verified`	KYC on-chain Garuda Identity	✅
`identity.reputation`	Skor reputasi on-chain	✅
`identity.soulbound-card`	GIDC soulbound	✅
`voucher.signed-pay`	Voucher diskon Garuda Pay (EIP-712)	✅

Manfaat soft boost (staking, gas) hanya memengaruhi tampilan estimasi di Wallet, bukan parameter kontrak on-chain.

API publik¶

`GET /api/v1/utility/entitlements/:address`¶

Ringkasan membership, daftar entitlement, dan display untuk Wallet.

`GET /api/v1/utility/definitions`¶

Daftar definisi entitlement.

Endpoint terkait (pengguna / integrator)¶

Method	Path	Deskripsi
GET	`/api/v1/utility/cultural-drop/status/:address`	Status whitelist drop budaya
POST	`/api/v1/utility/cultural-drop/join`	Daftar whitelist (Wallet)
GET	`/api/v1/utility/event-ticket/events`	Event aktif
GET	`/api/v1/utility/event-ticket/status/:address`	Saldo tiket + payload QR
POST	`/api/v1/utility/event-ticket/verify`	Verifikasi tiket di pintu masuk
GET	`/api/v1/utility/merchant-trust/:address`	Badge kepercayaan merchant
GET	`/api/v1/utility/certificates/:address`	Sertifikat digital pemegang
GET	`/api/v1/utility/multi-token/:address`	Stamp, voucher, tiket ERC-1155
GET	`/api/v1/utility/identity/:address`	Identitas soulbound + reputasi
GET	`/api/v1/utility/vouchers/:address`	Voucher Garuda Pay bertanda tangan

Backward compatible¶

GET /api/v1/network/gnft/perks/:address tetap tersedia dan memakai engine yang sama.

Carrier on-chain¶

Carrier	Contoh utilitas
ERC-721 GNFT (membership)	Check-in, MDR, pasar
ERC-721 Certificate	Sertifikat pelatihan, badge merchant
ERC-1155	Loyalty stamp, voucher, tiket event
GarudaIdentity (GIDC)	KYC, reputasi, identitas soulbound
Voucher signed (API)	Diskon checkout Garuda Pay

Prinsip¶

Lihat Prinsip Utility NFT.