Belajar Blockchain Developer - Backend & Indexing (The Graph)

#Pendahuluan

Setelah di episode 15 kalian merancang tokenisasi RWA, pada episode ini kita membangun infrastruktur yang membuat data on-chain bisa dibaca: backend & indexing. Blockchain menyimpan semua data — tetapi tidak dirancang untuk query yang kompleks. Menelusuri "semua transfer token X oleh akun Y" dengan memindai block satu per satu sangat lambat dan mahal.

Di sinilah The Graph berperan: ia mengindeks event on-chain dan menyediakan API GraphQL yang cepat. Di episode ini kita juga melihat posisi The Graph dalam arsitektur backend keseluruhan.

#Mengapa dApp Membutuhkan Backend

dApp 2026 tidak hanya kontrak + frontend. Ada lapisan off-chain yang memegang data non-kripto:

Backend service menyimpan metadata, user profile, preferensi, dan logika yang tidak perlu (atau tidak boleh) on-chain. Data kripto (saldo, transfer, kepemilikan) diambil dari subgraph. Memisahkan keduanya adalah keputusan arsitektur yang sehat.

#Konsep The Graph

The Graph adalah protokol indexing terdesentralisasi. Satu dApp mendefinisikan subgraph — file YAML + skema GraphQL + mapping script yang menentukan: event apa yang diindeks, bagaimana mengubahnya menjadi entity, dan bagaimana mengeksposnya via API GraphQL.

Alur kerja subgraph:

Kontrak → event → mapping (AssemblyScript) → entity → API GraphQL

Komponen subgraph:

#Praktik: Subgraph untuk dApp

Mari buat subgraph untuk kontrak PaymentReceiver dari episode 14. Pertama, install tooling dan inisialisasi:

npm install -g @graphprotocol/graph-cli
graph init --studio payment-subgraph

Deklarasikan sumber data di subgraph.yaml:

specVersion: 1.0.0
schema:
  file: ./schema.graphql
dataSources:
  - kind: ethereum/contract
    name: PaymentReceiver
    network: sepolia
    source:
      address: "0xPAYMENT_CONTRACT"
      abi: PaymentReceiver
      startBlock: 7000000
    mapping:
      kind: ethereum/events
      apiVersion: 0.0.7
      language: wasm/assemblyscript
      entities:
        - Order
      abis:
        - name: PaymentReceiver
          file: ./abis/PaymentReceiver.json
      eventHandlers:
        - event: PaymentReceived(bytes32 indexed orderId, address indexed token, address indexed payer, uint256 amount)
          handler: handlePaymentReceived
      file: ./src/payment-receiver.ts

Definisikan entity di schema.graphql:

type Order @entity {
  id: ID!
  token: Bytes!
  payer: Bytes!
  amount: BigInt!
  blockNumber: BigInt!
  timestamp: BigInt!
}

Tulis mapping di src/payment-receiver.ts:

import { PaymentReceived } from "../generated/PaymentReceiver/PaymentReceiver";
import { Order } from "../generated/schema";
 
export function handlePaymentReceived(event: PaymentReceived): void {
  const order = new Order(event.params.orderId.toHexString());
 
  order.token = event.params.token;
  order.payer = event.params.payer;
  order.amount = event.params.amount;
  order.blockNumber = event.block.number;
  order.timestamp = event.block.timestamp;
 
  order.save();
}

Build dan deploy:

npm run build
graph deploy --studio payment-subgraph

Setelah deploy, frontend kalian bisa query dengan GraphQL:

{
  orders(first: 10, orderBy: timestamp, orderDirection: desc) {
    id
    payer
    amount
    token
  }
}

Perhatikan orderId menjadi ID entity — entity harus memiliki ID unik. Menggunakan toHexString() memastikan bytes32 bisa menjadi ID GraphQL yang valid.

#Best Practice Indexing

Beberapa praktik yang menyelamatkan waktu production:

1. startBlock yang tepat: mulai index dari block deploy kontrak, bukan block genesis — menghemat resource besar.
2. Gunakan indexed field: deklarasikan field yang sering di-query sebagai indexed di GraphQL untuk filtering cepat.
3. Simpan timestamp dan blockNumber: selalu sertakan untuk time-series dan debugging.
4. Entity ID yang deterministik: orderId, tokenId, atau hash kombinasi — hindari counter global.
5. Handle reorg: subgraph The Graph otomatis menangani reorg sampai block terbaru; untuk indexing mandiri, kalian perlu mekanisme rollback sendiri.

#Penutup

Inti yang harus dibawa pulang:

• Blockchain tidak dirancang untuk query kompleks — indexing adalah kebutuhan.
• Backend dApp = subgraph (data on-chain) + service off-chain (data non-kripto).
• Subgraph = subgraph.yaml + schema.graphql + mapping.ts.
• startBlock yang tepat dan entity ID deterministik menghemat resource.
• Alternatif indexing: Ponder, Envio, Subquery.

Di episode 17 selanjutnya kita masuk ranah efisiensi — Gas Optimization: pola hemat gas, calldata, storage layout, dan praktik mengoptimasi kontrak. Mari lanjut ke episode 17!