Langsung ke konten utama
GET
Cantumkan Versi IDL
Parameter jalur, skema respons, dan contoh di halaman ini dihasilkan dari definisi OpenAPI. Daftar Versi IDL menampilkan riwayat antarmuka program dari katalog IDL yang digunakan oleh Parsed Events dan Parsed Streams untuk mendekode instruksi. Setiap item merupakan satu versi yang diidentifikasi berdasarkan slot saat versi tersebut mulai aktif. Item diurutkan dari yang paling lama, sehingga item terakhir adalah versi saat ini. Teruskan slot apa pun dari respons ke Dapatkan IDL untuk mengambil dokumen IDL versi tersebut. Penjelajah Orb menggunakan endpoint ini untuk menampilkan IDL program.

Kasus Penggunaan

  • Lacak perubahan antarmuka. Lakukan polling Daftar Versi IDL untuk program yang Anda gunakan. Saat versi baru muncul, ambil versi tersebut dan versi sebelumnya dengan Dapatkan IDL, lalu bandingkan instructions keduanya. Instruksi admin atau otoritas baru perlu ditinjau dari sisi keamanan.
  • Periksa cakupan katalog. 404 berarti katalog tidak memiliki IDL untuk program tersebut. Program seperti SPL Token didekode oleh dekoder bawaan dan juga menampilkan 404.

Contoh: Mendeteksi Versi IDL Baru

Skrip ini mencantumkan versi IDL program, mengambil dua versi terbaru, dan menampilkan instruksi yang ditambahkan atau dihapus:
diff-idl-versions.js
Untuk mendeteksi perubahan dari waktu ke waktu, simpan slot dari versi terakhir yang telah Anda lihat, lalu bandingkan dengannya pada setiap polling.

Kredit

Setiap permintaan menggunakan 10 kredit dan tersedia pada semua paket. Contoh di atas membuat tiga permintaan, sehingga menggunakan 30 kredit. Lihat Kredit.

Kesalahan

Kesalahan lainnya menampilkan isi JSON dengan pesan error, seperti {"error": "no IDLs found for program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"}.

Parameter Permintaan

string
wajib
Alamat program yang dikodekan dalam base58.

Otorisasi

api-key
string
query
wajib

Parameter Path

programId
string
wajib

Alamat program yang dikodekan dengan base58.

Contoh:

"KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD"

Respons

Versi IDL program, diurutkan berdasarkan slot secara menaik.

slot
integer<uint64>
wajib

Slot saat versi IDL ini mulai aktif. Teruskan nilainya ke Dapatkan IDL untuk mengambil versi ini.

sources
string[]
wajib

Lokasi tempat Peristiwa Terurai menemukan versi ini. Nilainya mencakup anchor, program_metadata, dan github, serta nilai lain mungkin ditambahkan. Satu versi dapat memiliki lebih dari satu sumber.