Перейти к основному содержанию
GET
Получить список версий IDL
Параметры пути, схема ответа и примеры на этой странице сгенерированы из определения OpenAPI. List IDL Versions возвращает историю интерфейса программы из каталога IDL, который Parsed Events и Parsed Streams используют для декодирования инструкций. Каждый элемент представляет собой одну версию, идентифицируемую по слоту, в котором она стала активной. Элементы отсортированы от самой старой версии к самой новой, поэтому последний элемент соответствует текущей версии. Передайте любое значение slot из ответа в Get IDL, чтобы получить документ IDL для этой версии. Обозреватель Orb использует эти конечные точки для отображения IDL программ.

Варианты использования

  • Отслеживание изменений интерфейса. Периодически вызывайте List IDL Versions для программы, от которой зависит ваше приложение. Когда появится новая версия, получите ее и предыдущую версию с помощью Get IDL и сравните их instructions. Появление новой инструкции администратора или уполномоченного субъекта требует проверки безопасности.
  • Проверка охвата каталога. Значение 404 означает, что в каталоге нет IDL для программы. Такие программы, как SPL Token, вместо этого декодируются встроенными декодерами и также возвращают 404.

Пример: обнаружение новой версии IDL

Этот скрипт выводит список версий IDL программы, получает две последние версии и выводит инструкции, которые были добавлены или удалены:
diff-idl-versions.js
Чтобы отслеживать изменения с течением времени, сохраните slot последней обнаруженной версии и сравнивайте с ним результат каждого опроса.

Кредиты

Каждый запрос стоит 10 кредитов и доступен на всех тарифных планах. В приведенном выше примере выполняются три запроса, поэтому он стоит 30 кредитов. См. раздел Кредиты.

Ошибки

При других ошибках возвращается тело JSON с сообщением error, например {"error": "no IDLs found for program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"}.

Параметры запроса

string
обязательно
Адрес программы в кодировке base58.

Авторизации

api-key
string
query
обязательно

Параметры пути

programId
string
обязательно

Адрес программы в кодировке base58.

Пример:

"KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD"

Ответ

Версии IDL программы, отсортированные по slot в порядке возрастания.

slot
integer<uint64>
обязательно

Слот, в котором эта версия IDL стала активной. Передайте его методу «Получить IDL», чтобы получить эту версию.

sources
string[]
обязательно

Источники, в которых Parsed Events нашел эту версию. Возможные значения включают anchor, program_metadata и github; в будущем могут быть добавлены другие. У версии может быть несколько источников.