Mulai Cepat Longsor
Mulai Cepat Longsor
Dalam panduan singkat ini, kita akan memulai dengan proyek awal yang sederhana dan kemudian menyelesaikannya dengan mengindeks beberapa data nyata yang sebenarnya. Ini adalah dasar yang sangat baik untuk memulai ketika mengembangkan Proyek SubQuery Anda sendiri.
Jika Anda mencari panduan untuk Substrat/Polkadot, Anda dapat membaca Panduan memulai cepat khusus Substrat/Polkadot.
Di akhir panduan ini, Anda akan memiliki proyek SubQuery yang berjalan pada node SubQuery dengan titik akhir GraphQL tempat dimana Anda dapat membuat kueri data.
Jika Anda belum melakukannya, sebaiknya Anda membiasakan diri dengan terminologi yang digunakan di SubQuery.
Tujuan dari panduan memulai cepat ini adalah untuk mengindeks semua log Setuju token Trenggiling, hanya membutuhkan waktu 10-15 menit
Persiapan
Lingkungan Pengembangan Lokal
Pasang CLI SubQuery
Instal SubQuery CLI secara global di terminal Anda dengan menggunakan NPM:
# NPM
npm install -g @subql/cli
Harap dicatat bahwa kami JANGAN mendorong penggunaan yarn global untuk menginstal @subql/cli karena manajemen ketergantungannya yang buruk yang dapat menyebabkan kesalahan di lini depan.
Anda kemudian dapat menjalankan bantuan untuk melihat perintah dan penggunaan yang tersedia yang disediakan oleh CLI
bantuan subql
Inisialisasi Proyek Pemula SubQuery
Di dalam direktori tempat Anda ingin membuat proyek SubQuery, cukup jalankan perintah berikut untuk memulai.
subql init
Anda akan ditanyai pertanyaan tertentu saat proyek SubQuery diinisialisasi:
- Nama Proyek: Nama untuk proyek SubQuery Anda
- Keluarga Jaringan: Keluarga jaringan blockchain layer-1 yang proyek SubQuery ini akan dikembangkan untuk diindeks, gunakan tombol panah pada keyboard Anda untuk memilih dari opsi, untuk panduan ini kita akan menggunakan "Longsor"
- Jaringan: Jaringan spesifik yang akan diindeks oleh proyek SubQuery ini, gunakan tombol panah pada keyboard Anda untuk memilih dari opsi, untuk panduan ini kami akan menggunakan "Longsor"
- Template: Pilih template proyek SubQuery yang akan memberikan titik awal untuk memulai pengembangan, sebaiknya pilih "Proyek Pemula"
- Git repository (Opsional): Berikan URL Git ke repo tempat proyek SubQuery ini akan dihosting (saat dihosting di SubQuery Explorer)
- RPC endpoint (Diperlukan): Berikan URL HTTPS ke titik akhir RPC yang sedang berjalan yang akan digunakan secara default untuk proyek ini. Node RPC ini harus berupa node arsip (memiliki status rantai penuh). Untuk panduan ini kita akan menggunakan nilai default "avalanche.api.onfinality.io"
- Authors (Diperlukan): Masukkan pemilik proyek SubQuery ini di sini (misal. nama Anda!)
- Description (Opsional): Anda dapat memberikan paragraf singkat tentang proyek Anda yang menjelaskan data apa yang ada di dalamnya dan apa yang dapat dilakukan pengguna dengannya
- Version (Diperlukan): Masukkan nomor versi khusus atau gunakan default (
1.0.0) - License (Diperlukan): Berikan lisensi perangkat lunak untuk proyek ini atau terima default (
Apache-2.0)
Setelah proses inisialisasi selesai, Anda akan melihat folder dengan nama proyek Anda telah dibuat di dalam direktori. Isi direktori ini harus identik dengan apa yang tercantum dalam Struktur Direktori.
Terakhir, di bawah direktori proyek, jalankan perintah berikut untuk menginstal dependensi proyek baru.
::: code-tabs @tab:active yarn shell cd PROJECT_NAME yarn install
Membuat Perubahan pada Proyek Anda
Dalam paket awal yang baru saja Anda inisialisasi, kami telah menyediakan konfigurasi standar untuk proyek baru Anda. Anda terutama akan mengerjakan file-file berikut:
- Skema GraphQL di
schema.graphql - Manifes Proyek di
project.yaml - Fungsi Pemetaan di direktori
src/mappings/
Tujuan dari panduan memulai cepat ini adalah untuk mengadaptasi proyek awal standar untuk mengindeks semua log transaksi Trenggiling Setujui.
Memperbarui File Skema GraphQL Anda
schema.graphql file mendefinisikan berbagai skema GraphQL. Karena cara kerja bahasa kueri GraphQL, file skema pada dasarnya menentukan bentuk data Anda dari SubQuery. Ini adalah tempat yang bagus untuk memulai karena memungkinkan Anda untuk menentukan tujuan akhir Anda di depan.
Kami akan memperbarui file schema.graphql untuk menghapus semua entitas yang ada dan membaca sebagai berikut
type PangolinApproval @entity {
id: ID!
transactionHash: String!
blockNumber: String!
blockHash: String!
addressFrom: String
addressTo: String
amount: String
}
Penting: Saat Anda membuat perubahan apa pun pada file skema, pastikan Anda membuat ulang direktori tipe Anda. Lakukan ini sekarang.
Anda akan menemukan model yang dihasilkan di direktori /src/types/models. Untuk informasi lebih lanjut tentang file schema.graphql, lihat dokumentasi kami di bawah Build/GraphQL Schema
Memperbarui File Manifes Proyek
File Projek Manifest (project.yaml) dapat dilihat sebagai titik masuk proyek Anda dan ini mendefinisikan sebagian besar detail tentang bagaimana SubQuery akan mengindeks dan mengubah data rantai.
Kami tidak akan melakukan banyak perubahan pada file manifes karena sudah diatur dengan benar, tetapi kami perlu mengubah penangan kami. Ingat kami berencana untuk mengindeks semua log persetujuan Trenggiling, sebagai hasilnya, kami perlu memperbarui bagian sumber data untuk membaca yang berikut ini.
dataSources:
- kind: avalanche/Runtime
startBlock: 57360 # Block when the Pangolin contract was created
options:
# Must be a key of assets
abi: erc20
## Pangolin token https://snowtrace.io/token/0x60781c2586d68229fde47564546784ab3faca982
address: "0x60781C2586D68229fde47564546784ab3fACA982"
assets:
erc20:
file: "./node_modules/@pangolindex/exchange-contracts/artifacts/contracts/pangolin-core/interfaces/IPangolinERC20.sol/IPangolinERC20.json"
mapping:
file: "./dist/index.js"
handlers:
- handler: handleLog
kind: avalanche/LogHandler
filter:
## Follows standard log filters https://docs.ethers.io/v5/concepts/events/
function: Approve(address spender, uint256 rawAmount)
# address: "0x60781C2586D68229fde47564546784ab3fACA982"
Ini berarti kita akan menjalankan fungsi pemetaan handleLog setiap kali ada log menyetujui pada setiap transaksi dari kontrak Trenggiling.
Untuk informasi selengkapnya tentang file Project Manifest (project.yaml), lihat dokumentasi kami di Build/Manifest File
Tambahkan Fungsi Pemetaan
Fungsi pemetaan menentukan bagaimana data rantai diubah menjadi entitas GraphQL yang dioptimalkan yang sebelumnya telah kita definisikan dalam file schema.graphql.
Navigasikan ke fungsi pemetaan default di direktori src/mappings. Anda akan melihat tiga fungsi yang diekspor, handleBlock, handleLog, dan handleTransaction. Anda dapat menghapus fungsi handleBlock dan handleTransaction, kita hanya berurusan dengan fungsi handleLog.
Fungsi handleLog menerima data peristiwa setiap kali peristiwa cocok dengan filter yang kami tentukan sebelumnya di project.yaml kami. Kami akan memperbaruinya untuk memproses semua persetujuan log transaksi dan menyimpannya ke entitas GraphQL yang kami buat sebelumnya.
Anda dapat memperbarui fungsi handleLog sebagai berikut (perhatikan impor tambahan):
import { PangolinApproval } from "../types";
import { AvalancheLog } from "@subql/types-avalanche";
export async function handleLog(event: AvalancheLog): Promise<void> {
const pangolinApprovalRecord = new PangolinApproval(
`${event.blockHash}-${event.logIndex}`
);
pangolinApprovalRecord.transactionHash = event.transactionHash;
pangolinApprovalRecord.blockHash = event.blockHash;
pangolinApprovalRecord.blockNumber = event.blockNumber;
# topics store data as an array
pangolinApprovalRecord.addressFrom = event.topics[0];
pangolinApprovalRecord.addressTo = event.topics[1];
pangolinApprovalRecord.amount = event.topics[2];
await pangolinApprovalRecord.save();
}
Apa yang dilakukan adalah menerima Log Longsor yang menyertakan data log transaksi pada muatan. Kami mengekstrak data ini dan kemudian membuat instance entitas PangolinApproval baru yang kami definisikan sebelumnya di file schema.graphql. Kami menambahkan informasi tambahan dan kemudian menggunakan fungsi .save() untuk menyimpan entitas baru (SubQuery akan secara otomatis menyimpan ini ke database).
Untuk informasi lebih lanjut tentang fungsi pemetaan, lihat dokumentasi kami di bawah Build/Mappings
Bangun Proyek
Untuk menjalankan Proyek SubQuery baru Anda, pertama-tama kita perlu membangun pekerjaan kita. Jalankan perintah build dari direktori root proyek.
::: code-tabs @tab:active yarn shell yarn build @tab npm shell npm run-script build :::
Penting: Setiap kali Anda membuat perubahan pada fungsi pemetaan, Anda harus membangun kembali proyek Anda
Menjalankan dan Membuat Kueri Proyek Anda
Jalankan Proyek Anda dengan Docker
Setiap kali Anda membuat Proyek SubQuery baru, Anda harus selalu menjalankannya secara lokal di komputer Anda untuk mengujinya terlebih dahulu. Cara termudah untuk melakukannya adalah dengan menggunakan Docker.
Semua konfigurasi yang mengontrol bagaimana node SubQuery dijalankan didefinisikan dalam file docker-compose.yml ini. Untuk proyek baru yang baru saja diinisialisasi, Anda tidak perlu mengubah apa pun di sini, tetapi Anda dapat membaca lebih lanjut tentang file dan pengaturannya di Jalankan bagian Proyek
Di bawah direktori proyek jalankan perintah berikut:
::: code-tabs @tab:active yarn shell yarn start:docker @tab npm shell npm run-script start:docker :::
Mungkin perlu beberapa saat untuk mengunduh paket yang diperlukan (@subql/node,
@subql/query</7 >, dan Postgres) untuk pertama kalinya tetapi segera Anda akan melihat node SubQuery yang sedang berjalan. Sabar pada proses di sini.
Kueri Proyek Anda
Buka browser Anda dan buka http://localhost:3000.
Anda akan melihat taman bermain GraphQL ditampilkan di explorer dan skema yang siap untuk kueri. Di kanan atas taman bermain, Anda akan menemukan tombol Dokumen yang akan membuka undian dokumentasi. Dokumentasi ini dibuat secara otomatis dan membantu Anda menemukan entitas dan metode apa yang dapat Anda kueri.
Untuk proyek pemula SubQuery baru, Anda dapat mencoba kueri berikut untuk mengetahui cara kerjanya atau pelajari lebih lanjut tentang bahasa Kueri GraphQL.
query {
pangolinApprovals(first: 5) {
nodes {
id
blockNumber
blockHash
transactionHash
addressFrom
addressTo
amount
}
}
}
Publikasikan Proyek SubQuery Anda
SubQuery menyediakan layanan terkelola gratis saat Anda dapat menerapkan proyek baru Anda. Anda dapat menerapkannya ke Proyek SubQuery dan menanyakannya menggunakan Explorer kami.
Baca panduan untuk memublikasikan proyek baru Anda ke Proyek SubQuery, Perhatikan bahwa Anda harus menerapkan melalui IPFS.
Langkah selanjutnya
Selamat, Anda sekarang memiliki proyek SubQuery yang berjalan secara lokal yang menerima permintaan GraphQL API untuk mentransfer data dari bLuna.
Sekarang setelah Anda memiliki wawasan tentang cara membangun proyek SubQuery dasar, pertanyaannya adalah dari mana dari sini? Jika Anda merasa percaya diri, Anda dapat mempelajari lebih lanjut tentang tiga file utama. File manifes, skema GraphQL, dan file pemetaan di bawah bagian Build dari dokumen ini.
Jika tidak, lanjutkan ke bagian Akademi kami di mana terdapat lokakarya, tutorial, dan contoh proyek yang lebih mendalam. Di sana kita akan melihat modifikasi yang lebih canggih, dan kita akan menyelami lebih dalam dalam menjalankan proyek SubQuery dengan menjalankan proyek yang tersedia dan open source.
Terakhir, jika Anda mencari lebih banyak cara untuk menjalankan dan memublikasikan proyek Anda, Jalankan & Bagian Publikasikan memberikan informasi mendetail tentang semua cara untuk menjalankan proyek SubQuery Anda dan fitur agregasi dan langganan GraphQL lanjutan lainnya.