Описание Golos API. Часть 2

Автор: @asuleymanov

В прошлой статье было описано много команд. Если быть точным 54. В этой статье я постараюсь описать оставшиеся команды из раздела Database_API. А также приоткрою завесу тайны на некоторые команды из прошлого выпуска.
В общем в данный выпуск вошли три группы команд. Условно разделю их на три типа:

  1. Невыясненные
    • сюда вошли команды результаты вызова которых не ясны. В основном это связано с тем, что так и не нашлось вразумительное объяснение, какой параметр надо передавать.
  2. Команды из прошлого выпуска
    • сюда вошли 4 команды из прошлого выпуска, так как удалось разобраться что за параметр необходимо передавать.
  3. Неразобранные
    • сюда вошли команды описание которых не вошло в прошлый выпуск.

Невыясненные

set_subscribe_callback
Параметры:"method":"set_subscribe_callback", "params":[["cb","clearfilter"]], "id":0
Описание: Не выяснено.

set_pending_transaction_callback
Параметры:"method":"set_pending_transaction_callback", "params":["cb"], "id":1
Описание: Не выяснено.

set_block_applied_callback
Параметры:"method":"set_block_applied_callback", "params":["cb"], "id":2
Описание: Не выяснено.

cancel_all_subscriptions
Параметры:"method":"cancel_all_subscriptions", "params":["cb"], "id":3
Описание: Не выяснено.

Команды из прошлого выпуска

get_ops_in_block

Параметры:"method":"get_ops_in_block", "params":[block_num,only_virtual], "id":21

Описание: Отображает операции которые были в указанном блоке. При этом если параметр only_virtual выставлен в значение true то отображаются только виртуальные операции(что это выяснить так и не удалось)

@ropox
Как я понимаю, "виртуальные операции" операции сделанные самим блокчейном. author_reward, curation_reward. Их не увидеть по команде get_block, только вот так. get_ops_in_block или get_account_history. К примеру блок 6754128.

get_transaction_hex

Параметры:"method":"get_transaction_hex", "params":["trx"], "id":53

Описание: Отображает HEX строку(что именно это такое не ясно). В параметр передается подписанная транзакция.

get_potential_signatures

Параметры:"method":"get_potential_signatures", "params":["trx"], "id":56

Описание: Отображает потенциальный ключ для данной транзакции. В параметр передается подписанная транзакция.

verify_authority

Параметры:"method":"verify_authority", "params":["trx"], "id":57

Описание: Отвечает TRUE если транзакция подписана правильно. В параметр передается подписанная транзакция.

P.S. Описание транзакции, т.е. её составление я попробую разобрать в следующей статье.

Не разобранные

Отступление. Все нижеописанные команды в виде параметр принимают структуру/объект такого вида(условно назову его dsc):

uint32 limit = 0  - количество возвращаемых записей не может быть больше 100. По умолчанию 0 
map[string] select_authors - массив содержит имена авторов 
map[string] select_tags - Список тегов, сообщения без этих тегов фильтруются
map[string] filter_tags - Список тегов, сообщения с этими тегами фильтруются;
uint32 truncate_body = 0 - Количество байтов возвращаемого тела сообщения, 0 для всех, *параметр не обязателен*
string start_author - имя автора с которого начинать искать, *параметр не обязателен*
string start_permlink - ссылка публикации с которой начинать искать, *параметр не обязателен*
string parent_author - имя автора стартовавшего дискуссию, *параметр не обязателен*
string parent_permlink - постоянная ссылка на родительскую дискуссию, *параметр не обязателен*

Пояснения. Вначале указан тип параметра, а потом сам параметр.

get_discussions_by_trending
Параметры:"method":"get_discussions_by_trending", "params":[dsc], "id":6
Описание: Отображает ограниченное количество публикаций начиная с самой дорогой по вознаграждению.

get_discussions_by_trending30
Параметры:"method":"get_discussions_by_trending30", "params":[dsc], "id":7
Описание: Отображает ограниченное количество публикаций по вознаграждению.

get_discussions_by_created
Параметры:"method":"get_discussions_by_created", "params":[dsc], "id":8
Описание: Отображает ограниченное количество публикаций начиная с самой новой.

get_discussions_by_active
Параметры:"method":"get_discussions_by_active", "params":[dsc], "id":9
Описание: Отображает ограниченное количество записей в которых была активность начиная с самой новой.

get_discussions_by_cashout
Параметры:"method":"get_discussions_by_cashout", "params":[dsc], "id":10
Описание: Отображает ограниченное количество публикаций, отсортированных по времени выплат.

get_discussions_by_payout
Параметры:"method":"get_discussions_by_payout", "params":[dsc], "id":11
Описание: Отображает ограниченное количество публикаций , отсортированных по выплатам.

get_discussions_by_votes
Параметры:"method":"get_discussions_by_votes", "params":[dsc], "id":12
Описание: Отображает ограниченное количество публикаций, отсортированных по величине голосов.

get_discussions_by_children
Параметры:"method":"get_discussions_by_children", "params":[dsc], "id":13
Описание: Отображает ограниченное количество публикаций, отсортированных по количеству комментариев.

get_discussions_by_hot
Параметры:"method":"get_discussions_by_hot", "params":[dsc], "id":14
Описание: Отображает ограниченное количество публикаций, отсортированных по популярности.

get_discussions_by_feed
Параметры:"method":"get_discussions_by_feed", "params":[dsc], "id":15
Описание: Отображает ограниченное количество публикаций, из фида конкретного автора

get_discussions_by_blog
Параметры:"method":"get_discussions_by_blog", "params":[dsc], "id":16
Описание: Отображает ограниченное количество публикаций, из блога конкретного автора.

get_discussions_by_comments
Параметры:"method":"get_discussions_by_comments", "params":[dsc], "id":17
Описание: Отображает ограниченное количество публикаций, из комментариев конкретного автора.

get_discussions_by_promoted
Параметры:"method":"get_discussions_by_feed", "params":[dsc], "id":18
Описание: Отображает ограниченное количество публикаций, отсортированных с помощью увеличенной суммы баланса (К сожалению мне так и не удалось понять что тут имеется ввиду.)

Историческая справка

  • Статья № 1
    • Начало разбора команд из раздела Database_Api
  • Статья № 2
    • Окончание разбора команд из раздела Database_Api
  • Статья № 3
    • Разбор команд из разделов Market_History_API и Follow_API

P.S. Большая часть статьи это переосмысленный перевод

Автор: @asuleymanov

results matching ""

    No results matching ""