Subgraph adalah primitif pengindeksan data inti dari The Graph Protocol — API terbuka yang mengindeks event smart contract tertentu dan status dari blockchain, mengorganisirnya ke dalam database GraphQL terstruktur yang dapat di-query oleh developer secara efisien — memecahkan masalah fundamental bahwa querying data blockchain langsung dari node itu mahal secara komputasi dan canggung secara struktural: kamu harus memindai setiap blok untuk event relevan, menggabungkan data di berbagai kontrak, dan mengagregasi perubahan status secara manual, sedangkan subgraph mendefinisikan kontrak mana yang dipantau, event mana yang diindeks, dan cara mengubah data event mentah menjadi entitas siap-aplikasi.
Cara Kerja
Tiga komponen:
- Manifest (
subgraph.yaml): Mendefinisikan kontrak dan event mana yang akan diindeks - Schema (
schema.graphql): Mendefinisikan entitas data (seperti tabel database) - Mappings (
src/mapping.ts): Kode AssemblyScript yang mengubah event menjadi entitas schema
Contoh query GraphQL:
“`graphql
{
pools(where: { volumeUSD_gt: “1000000” }, orderBy: volumeUSD, orderDirection: desc) {
id
token0 { symbol }
token1 { symbol }
volumeUSD
feeTier
}
}
“`
Hosted Service vs. Decentralized Network
| Hosted Service | Decentralized Network | |
|---|---|---|
| Biaya | Gratis | Bayar GRT per query |
| Kontrol | Tim Graph Protocol | Indexer terdistribusi |
| Status | Sedang deprecated | Aktif — masa depan protokol |
| Kepercayaan | Terpusat | Trustless |
Indexer melakukan stake GRT untuk melayani query; kurator menandai subgraph mana yang akan diindeks; developer membayar GRT per query di jaringan terdesentralisasi.
Subgraph Utama
- Uniswap v3: Pool, swap, posisi, biaya
- Compound: Pasar, peminjaman, likuidasi
- ENS: Nama, registrasi, transfer
- MakerDAO: Vault, biaya stabilitas, likuidasi
- Aave: Cadangan, posisi pengguna, akrual bunga
Sebagai 2024, ribuan subgraph ada untuk sebagian besar protokol EVM utama di Ethereum, Polygon, Arbitrum, Optimism, dan chain lainnya.
Contoh Penggunaan
Frontend Uniswap memiliki subgraph yang mengindeks setiap pembuatan pool, swap, penambahan/penghapusan likuiditas, dan pengumpulan biaya. Platform analitik seperti Dune atau frontend Uniswap sendiri meng-query subgraph ini untuk mendukung tampilan data real-time.
Istilah Terkait
Lihat Juga
Sumber
- The Graph Documentation — thegraph.com/docs. Dokumentasi teknis resmi subgraph, manifest, schema, dan jaringan terdesentralisasi.
- “How The Graph Protocol Powers Web3 Data” — The Graph Blog (2021). Penjelasan ekosistem subgraph dan model indexer/kurator.
- The Graph Explorer — thegraph.com/explorer. Direktori semua subgraph yang dipublikasikan dan antarmuka query.