Chuyển đến nội dung chính
GET
Liệt kê các phiên bản IDL
Các tham số đường dẫn, lược đồ phản hồi và ví dụ trên trang này được tạo từ định nghĩa OpenAPI. List IDL Versions trả về lịch sử giao diện của một chương trình từ danh mục IDL mà Parsed Events và Parsed Streams sử dụng để giải mã các lệnh. Mỗi mục là một phiên bản, được xác định bằng slot mà phiên bản đó bắt đầu có hiệu lực. Các mục được sắp xếp từ cũ nhất đến mới nhất, vì vậy mục cuối cùng là phiên bản hiện tại. Truyền bất kỳ slot nào từ phản hồi đến Get IDL để truy xuất tài liệu IDL của phiên bản đó. Trình khám phá Orb sử dụng các endpoint này để hiển thị IDL của chương trình.

Trường hợp sử dụng

  • Theo dõi các thay đổi giao diện. Thăm dò List IDL Versions cho chương trình mà bạn phụ thuộc vào. Khi một phiên bản mới xuất hiện, hãy truy xuất phiên bản đó và phiên bản trước bằng Get IDL, rồi so sánh instructions của chúng. Một lệnh quản trị hoặc lệnh cấp quyền mới cần được xem xét về bảo mật.
  • Kiểm tra mức độ bao phủ của danh mục. 404 có nghĩa là danh mục không có IDL cho chương trình. Thay vào đó, các chương trình như SPL Token được giải mã bằng bộ giải mã tích hợp và cũng trả về 404.

Ví dụ: Phát hiện phiên bản IDL mới

Tập lệnh này liệt kê các phiên bản IDL của một chương trình, truy xuất hai phiên bản mới nhất và in ra các lệnh đã được thêm hoặc xóa:
diff-idl-versions.js
Để phát hiện các thay đổi theo thời gian, hãy lưu slot của phiên bản cuối cùng bạn đã thấy và so sánh với giá trị đó sau mỗi lần thăm dò.

Credit

Mỗi yêu cầu tốn 10 credit và khả dụng trên tất cả các gói. Ví dụ trên thực hiện ba yêu cầu, vì vậy tốn 30 credit. Xem Credit.

Lỗi

Các lỗi khác trả về nội dung JSON có thông báo error, chẳng hạn như {"error": "no IDLs found for program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"}.

Tham số yêu cầu

string
bắt buộc
Địa chỉ chương trình, được mã hóa bằng base58.

Ủy quyền

api-key
string
query
bắt buộc

Tham số đường dẫn

programId
string
bắt buộc

Địa chỉ chương trình, được mã hóa bằng base58.

Ví dụ:

"KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD"

Phản hồi

Các phiên bản IDL của chương trình, được sắp xếp theo slot tăng dần.

slot
integer<uint64>
bắt buộc

Slot nơi phiên bản IDL này bắt đầu có hiệu lực. Truyền giá trị này cho Lấy IDL để truy xuất phiên bản này.

sources
string[]
bắt buộc

Nơi Sự kiện đã phân tích tìm thấy phiên bản này. Các giá trị bao gồm anchor, program_metadata và github; có thể sẽ có thêm các giá trị khác. Một phiên bản có thể có nhiều nguồn.