Gambaran Chain¶
Arsitektur¶
┌─────────────────────────────────────────────────────────┐
│ Garuda Chain Mainnet │
├─────────────┬──────────────┬────────────┬───────────────┤
│ Validators │ RPC Gateway │ API Layer │ Explorer │
│ (IBFT 2.0) │ rpc.* │ api.* │ explorer.* │
├─────────────┴──────────────┴────────────┴───────────────┤
│ Smart Contracts: GDC · PayHub · Staking · Identity · … │
└─────────────────────────────────────────────────────────┘
Komponen Monorepo¶
| Path | Deskripsi |
|---|---|
chain/ |
Konfigurasi Besu IBFT 2.0, genesis, konfigurasi validator |
contracts/ |
Smart contract (Foundry / Solidity) |
packages/sdk/ |
TypeScript SDK @garuda-chain/sdk |
apps/explorer/ |
Block explorer (Next.js) |
apps/wallet/ |
Dompet Garuda (Vite + React) |
apps/api/ |
REST + GraphQL API |
apps/faucet/ |
Faucet testnet |
apps/metrics-exporter/ |
Metrik Prometheus |
deploy/ |
Caddy, monitoring, aset statis |
Dompet Garuda dan Akun Garuda¶
Dompet Garuda memisahkan Garuda ID (identitas), Akun Garuda (rekening Smart Account on-chain untuk GDC), dan kunci perangkat (otorisasi transaksi). Detail: Akun Garuda. Parameter protokol on-chain dijelaskan di Tata Kelola.
Konsensus¶
- Protokol: IBFT 2.0 (Proof of Authority, BFT) pada Hyperledger Besu
- Waktu blok: sekitar 2 detik
- Validator genesis: 5
- Target validator: 21. Ini adalah target perluasan. Jumlah validator yang aktif saat ini adalah 5.
- Finalitas: instan setelah supermajority validator menandatangani blok
- Catatan: Kontrak staking dan
GarudaValidatorRegistrymencatat pendaftaran on-chain. Daftar tersebut belum mengubah validator Besu. Penambahan node memerlukan persetujuan IBFT dari validator yang sudah aktif.
Smart Contract Utama¶
| Kontrak | Fungsi |
|---|---|
| GDC | Token ERC-20 native |
| GarudaTreasury | Treasury multi-sig |
| GarudaPayHub | Pembayaran, QR, escrow |
| GarudaStaking | Staking fleksibel dan validator |
| GarudaGovernance | Voting DAO |
| GarudaIdentity | DID, KYC/KYB |
| GarudaValidatorRegistry | Registry on-chain untuk stake dan status. Belum mengubah validator Besu. |
Detail deployment: Smart Contract
Monitoring¶
Stack observability: Prometheus + Grafana + Loki
- Tinggi blok, TPS, kesehatan RPC
- CPU, RAM, disk (node-exporter)
- Metrik validator (Besu :9545)
- Agregasi log (Promtail → Loki)
Stack observability di server production mencakup Prometheus, Grafana, dan Loki.