Links

Cli-wallet API

Страница содержит справочную информацию о методах в cli_wallet API для блокчейна версии HF18. Для каждого метода приводится перечень используемых в нем параметров с кратким их описанием, а также функциональное назначение этого метода.

about()

variant_object about()const
Возвращает информацию о времени компиляции и о клиенте, в том числе версию клиента, версию git graphene/fc, версии boost, openssl и зависимостей.

add_operation_copy_to_builder_transaction()

void add_operation_copy_to_builder_transaction(
transaction_handle_type src_handle,
transaction_handle_type dst_handle,
uint32_t op_index
)
Параметры: src_handle — уникальный номер конструктора, из которого копируется операция; dst_handle — уникальный номер конструктора, на который копируется операция; op_index — номер копируемой операции.
Используется для копирования операции между конструкторами транзакций.

add_operation_to_builder_transaction()

void add_operation_to_builder_transaction(transaction_handle_type handle, const operation& op)
Параметры: handle — уникальный номер конструктора; op — добавляемая операция.
Используется для добавления операции в список операций конструктора транзакций.

approve_proposal()

signed_transaction approve_proposal(
const std::string& author, const std::string& title,
const approval_delta& delta,
bool broadcast
)
Параметры: author — автор предложенной транзакции; title — заголовок предложенной на подпись транзакции; delta — список подписей, необходимых для одобрения (или удаления) транзакции. broadcast — “true”, если транзакция пересылается на демон; “false”, если выполняется базовый контроль с выдачей подписанной транзакции на консоль.
Возвращает подписанную версию транзакции.

begin_builder_transaction()

transaction_handle_type wallet_api::begin_builder_transaction()
Метод вызывает операцию создания конструктора транзакций и возвращает уникальный номер созданного конструктора. Начальное значение уникального номера принимается равным «0» и увеличивается на единицу с каждым вызовом метода.

cancel_order()

annotated_signed_transaction wallet_api::cancel_order(
string owner,
uint32_t orderid,
bool broadcast
)
Параметры: owner — имя аккаунта, созданного заявку на отмену транзакции; orderid — идентификационный номер заявки на отмену транзакции; broadcast — "true", если транзакция пересылается на демон.
Возвращает транзакцию, выполнение которой отменяется.

cancel_transfer_from_savings()

annotated_signed_transaction wallet_api::cancel_transfer_from_savings(
string from,
uint32_t request_id,
bool broadcast
)
Параметры: from — имя аккаунта, инициировавшего отмену; reques_id — идентификационный номер заявки, используемый в вызове transfer_from_savings() для отмены или перевызова операции; broadcast — "true", если транзакция пересылается на демон.
Возвращает подписанную транзакцию, выполнение которой отменяется.

change_recovery_account()

annotated_signed_transaction wallet_api::change_recovery_account(
string owner,
string new_recovery_account,
bool broadcast
)
Параметры: owner — имя аккаунта; new_recovery_account — новое имя, которое будет присвоено восстановленному аккаунту; broadcast— "true", если транзакция пересылается на демон.
Возвращает подписанную транзакцию на изменение данных аккаунта.

convert_sbd()

annotated_signed_transaction wallet_api::convert_sbd(string from, asset amount, bool broadcast)
Параметры: from — имя аккаунта, запрашивающего конвертацию своей криптовалюты вида SBD; amount — сумма средств в виде SBD для конвертации; broadcast — "true", если транзакция пересылается на демон.
Используется для конвертации SBD в STEEM в соответствии с их отношением, приведенным в current_median_history, за неделю с момента выполнения операции.

check_memo()

void wallet_api::check_memo(
const string& memo,
const golos::api::account_api_object& account
)const
Параметры: memo — поле, записи которого проверяются; account — имя аккаунта.
Проверяет записи из поля memo, относящиеся к личным ключам аккаунта и импортированные в кошелек.

create_account()

annotated_signed_transaction wallet_api::create_account(
string creator,
string new_account_name,
string json_meta,
bool broadcast
)
Параметры: creator — пользователь, который создает новый аккаунт; new_account_name — имя нового аккаунта; json_meta — метаданные профиля нового аккаунта поля json_metadata; broadcast — "true", если транзакция пересылается на демон; "false", если выполняется базовый контроль с выдачей подписанной транзакции на консоль.
Используется для создания нового аккаунта и генерацией ключей owner, active, и memo для этого аккаунта. За создание аккаунта в качестве комиссионных отчислений с баланса кошелька создателя аккаунта (автора) снимается определенная сумма fee. Величина этих отчислений не может быть меньше значения параметра account_creation_fee, устанавливаемого по результатам голосования делегатов.

create_account_delegated()

annotated_signed_transaction wallet_api::create_account_delegated(
string creator, asset steem_fee,
asset delegated_vests,
string new_account_name,
string json_meta,
bool broadcast
)
Параметры: creator — пользователь, который создает новый аккаунт; steem_fee — сумма комиссионных отчислений в криптовалюте Голос, снимаемая с баланса кошелька пользователя за создание нового аккаунта и зачисляемая на баланс кошелька созданного аккаунта в криптовалюте Сила Голоса. Эта сумма не может быть возвращена обратно в кошелек создателя аккаунта; delegated_vests — сумма комиссионных отчислений в криптовалюте Сила Голоса, снимаемая с баланса кошелька пользователя за операцию делегирования и зачисляемая на баланс кошелька нового аккаунта в криптовалюте Сила Голоса. Эта сумма может быть возвращена обратно в кошелек создателя аккаунта по истечении определенного периода, устанавливаемого голосованием делегатов; new_account_name — имя нового аккаунта; json_meta — метаданные профиля нового аккаунта поля json_metadata; bool broadcast — "true", если транзакция пересылается на демон; "false", если выполняется базовый контроль с выдачей подписанной транзакции на консоль.
Используется для создания аккаунта с делегированием. Автоматически генерирует публичные ключи owner, active, posting и memo для нового аккаунта.

create_account_with_keys()

annotated_signed_transaction wallet_api::create_account_with_keys(
string creator, string newname,
string json_meta, asset fee,
public_key_type owner,
public_key_type active,
public_key_type posting,
public_key_type memo,
bool broadcast
)const
Параметры: creator — пользователь, который создает новый аккаунт; newname — имя нового аккаунта; json_meta — метаданные профиля нового аккаунта поля json_metadata; fee — сумма комиссионных отчислений в криптовалюте Голос, снимаемая с баланса кошелька пользователя за создание нового аккаунта и зачисляемая на баланс кошелька созданного аккаунта в криптовалюте Сила Голоса. Эта сумма не может быть меньше значения account_creation_fee, устанавливаемого по результатам голосования делегатов; owner — значение публичного ключа owner нового аккаунта; active — значение публичного ключа active нового аккаунта; posting — значение публичного ключа posting нового аккаунта; memo — значение публичного ключа memo нового аккаунта; broadcast — "true", если транзакция пересылается на демон.
Используется для создания аккаунта, требуется явное задание ключей.

create_account_with_keys_delegated()

annotated_signed_transaction wallet_api::create_account_with_keys_delegated(
string creator, asset steem_fee,
asset delegated_vests,
string new_account_name,
string json_meta, public_key_type owner,
public_key_type active,
public_key_type posting,
public_key_type memo,
bool broadcast
)const
Параметры: creator — пользователь, который создает новый аккаунт; steem_fee — сумма комиссионных отчислений в криптовалюте Голос, снимаемая с баланса кошелька пользователя за создание нового аккаунта и зачисляемая на баланс кошелька созданного аккаунта в криптовалюте Сила Голоса. Эта сумма не может быть возвращена обратно в кошелек создателя аккаунта; delegated_vests — сумма комиссионных отчислений в криптовалюте Сила Голоса, снимаемая с баланса кошелька пользователя за операцию делегирования и зачисляемая на баланс кошелька нового аккаунта в криптовалюте Сила Голоса. Эта сумма может быть возвращена обратно в кошелек создателя аккаунта по истечении определенного периода, устанавливаемого голосованием делегатов; new_account_name — имя нового аккаунта; json_meta — метаданные профиля нового аккаунта поля json_metadata; owner — значение публичного ключа owner нового аккаунта; active — значение публичного ключа active нового аккаунта; posting — значение публичного ключа posting нового аккаунта; memo — значение публичного ключа memo нового аккаунта; broadcast — “true”, если транзакция пересылается на демон.
Используется для создания нового аккаунта через вызов операции account_create. Требуется явное задание ключей owner, active, posting и memo для нового аккаунта.

create_order()

annotated_signed_transaction wallet_api::create_order(
string owner,
uint32_t order_id,
asset amount_to_sell,
asset min_to_receive,
bool fill_or_kill,
uint32_t expiration,
bool broadcast
)
Параметры: owner — имя аккаунта, создаваемого заказ; order_id — идентификационный номер заказа, присваиваемый аккаунтом, создающий этот заказ; amount_to_sell — сумма средств в виде SBD или STEAM, выставляемая на продажу; min_to_receive — минимальная сумма средств, предполагаемая к получению; fill_or_kill — “true”, если заказ следует отменить в случае его немедленного невыполнения; expiration — время отведенное на выполнение заказа, по истечении которого он будет отменен; broadcast — “true”, если транзакция пересылается на демон.
Используется для создания заказа на продажу с кошелька ограниченной суммы средств в виде SBD или STEAM по цене в соответствии с отношением amount_to_sell / min_to_receive. Возвращает подписанную транзакцию.

database_info()

variant_object database_info()const
Возвращает справочную информацию о текущем статусе разделяемой памяти, в том числе: общий объем разделяемой памяти, размер свободного и зарезервированного пространства для определенных нужд, а также список индексов, хранящихся в разделяемой памяти (название индекса, количество записей).

decline_voting_rights()

annotated_signed_transaction wallet_api::decline_voting_rights(
string account,
bool decline,
bool broadcast
)
Параметры: account — имя аккаунта, который лишается права голоса; decline — “true”, если аккаунт лишается права голоса; broadcast — “true”, если транзакция пересылается на демон.
Используется для лишения права голоса аккаунта с указанным именем. Возвращает подписанную транзакцию.

decrypt_memo()

string wallet_api::decrypt_memo( string encrypted_memo )
Параметр: encrypted_memo — запись, приведенная для прочтения.
Возвращает текст в расшифрованном виде (если это возможно), находящийся в кошельке и зашифрованный с помощью одного из известных личных ключей.

delegate_vesting_shares()

annotated_signed_transaction wallet_api::delegate_vesting_shares(
string delegator,
string delegatee,
asset vesting_shares,
bool broadcast
)
Параметры: delegator — имя аккаунта, который делегирует Силу Голоса; delegatee — имя аккаунта, на который делегируется Сила Голоса; vesting_shares — сумма делегирования; broadcast — “true”, если транзакция пересылается на демон.
Используется для делегирования части криптовалюты Силы Голоса (значение в GESTS) с одного аккаунта на другой.

encrypt_keys()

void encrypt_keys()
Используется для шифрования текста (примечания) с помощью одного из личных ключей.

escrow_approve()

annotated_signed_transaction wallet_api::escrow_approve(
string from,
string to,
string agent,
string who,
uint32_t escrow_id,
bool approve,
bool broadcast
)
Параметры: from — имя аккаунта, передающего средства на условное депонирование; to — имя аккаунта, принимающего средства на условное депонирование; agent — имя аккаунта, выступающего в качестве агента в случае возникновения спорных ситуаций; who — имя аккаунта, утверждающего сделку (to или agent); escrow_id — идентификационный номер операции; approve — “true”, если сделка утверждается. Иначе транзакция отменяется с возвратом средств аккаунту с именем from; broadcast — “true”, если транзакция пересылается на демон.
Используется для утверждения предложенной транзакции с операцией передачи средств на условное депонирование. Средства могут быть разблокированы только после утверждения транзакции. Возвращает подписанную транзакцию.

escrow_dispute()

annotated_signed_transaction wallet_api::escrow_dispute(
string from,
string to,
string agent,
string who,
uint32_t escrow_id,
bool broadcast
)
Параметры: from — имя аккаунта, передавшего средства на условное депонирование; to — имя аккаунта, принявшего средства на условное депонирование; agent — имя аккаунта, выступающего в качестве агента в случае возникновения спорных ситуаций; who — имя аккаунта, открывшего спор (from или to); escrow_id — идентификационный номер операции; broadcast — “true”, если транзакция пересылается на демон.
Используется для открытия спора по передачи средств на условное депонирование. Спор может быть открыт до истечения срока, отведенного на условное депонирование. Возвращает подписанную транзакцию.

escrow_release()

annotated_signed_transaction wallet_api::escrow_release(
string from,
string to,
string agent,
string who,
string receiver,
uint32_t escrow_id,
asset sbd_amount,
asset steem_amount,
bool broadcast
)
Параметры: from — имя аккаунта, передавшего средства на условное депонирование; to — имя аккаунта, изначально принявшего средства на условное депонирование; agent — имя аккаунта, выступающего в качестве агента в случае возникновения спорных ситуаций; who — имя аккаунта, утвердившего сделку; receiver — имя аккаунта, в кошелек которого поступят отпущенные средства; escrow_id — идентификационный номер операции; sbd_amount — сумма отпущенных средств в виде SBD; steem_amount — сумма отпущенных средств в виде STEEM; broadcast — “true”, если транзакция пересылается на демон.
Используется для разблокирования (освобождение) средств, передаваемых на условное депонирование. Возвращает подписанную транзакцию.

escrow_transfer()

annotated_signed_transaction wallet_api::escrow_transfer(
string from,
string to,
string agent,
uint32_t escrow_id,
asset sbd_amount,
asset steem_amount,
asset fee,
time_point_sec ratification_deadline,
time_point_sec escrow_expiration,
string json_meta,
bool broadcast
)
Параметры: from — имя аккаунта, от которого передаются средства на условное депонирование; to — имя аккаунта, к которому передаются средства на условное депонирование; agent — имя аккаунта, выступающего в качестве агента в случае возникновения спорных ситуаций; escrow_id — идентификационный номер операции (значения from и escrow_id должны составлять уникальную пару); sbd_amount — сумма средств в виде SBD, передаваемых на условное депонирование; steem_amount — сумма средств в виде STEEM, передаваемых на условное депонирование; fee — комиссионные отчисления для агента; ratification_deadline — время, до наступления которого транзакция должна быть одобрена аккаунтами с именами to и agent; escrow_expiration — время, по истечении которого любая из сторон может потребовать возврат средств; json_meta — метаданные в кодировке JSON; broadcast — “true”, если транзакция пересылается на демон.
Используется для передачи средств в виде STEEM или SBD на условное депонирование от одного аккаунта другому. Возвращает подписанную транзакцию.

find_first_unused_derived_key_index()

int find_first_unused_derived_key_index(const fc::ecc::private_key& parent_key)
Параметр: parent_key — родительский ключ.
Используется для генерации ключей, производных от родительского. Генерация ключей начинается с индекса «0» с последующим приращением его на единицу. Если очередные индексы будут отсутствовать (обнаружение незарегистрированных ключей) в блокчейне, процесс прекращается. Алгоритм поиска зарегистрированного ключа в блокчейне по очередному индексу предусматривает возможное отсутствие нескольких номеров (наличие «дыр») в последовательности. Размер «дыры» не должен превышать более пяти подряд идущих номеров.

follow()

annotated_signed_transaction wallet_api::follow(
string& follower,
string& following,
const set<string>& what,
bool broadcast
)
Параметры: follower — имя аккаунта, являющегося последователем другого; following — имя аккаунта, от которого наследуется набор вещей; what — набор вещей, который наследуется (посты, комментарии, голоса, игнорирования); broadcast — “true”, если транзакция пересылается на демон.
Помечает одного аккаунта как последователь (наследник) другого. Требует для последователя авторизацию ключом posting. Возвращает подписанную транзакцию.

get_account()

golos::api::account_api_object get_account(string account_name)const
Параметр: account_name — имя аккаунта, информация о котором предоставляется.
Возвращает информацию об аккаунте с заданным именем, имеющемся в базе данных блокчейна.

get_account_history()

map< uint32_t, golos::plugins::operation_history::applied_operation >
wallet_api::get_account_history(
string account,
uint32_t from,
uint32_t limit
)
Параметры: account — аккаунт, история которого запрашивается; from — порядковый номер операции. «-1» — означает последний номер операции; limit — максимальное количество запрашиваемых элементов. Принимает значение 0-1000.
Возвращает историю всех действий в виде транзакций пользователя в сети GOLOS.

get_active_witnesses()

vector< account_name_type > wallet_api::get_active_witnesses()const
Возвращает список всех активных делегатов, создавших блоки в текущем окружении (21 блок).

get_block ()

optional<signed_block_with_info> wallet_api::get_block (uint32_t num)
Параметр: num — номер блока.
Возвращает расширенную информацию по блоку с номером num.

get_conversion_requests()

vector< database_api::convert_request_api_object > wallet_api::get_conversion_requests(
string owner_account
)
Параметр: owner_account — имя аккаунта, создавшего запросы.
Возвращает текущие запросы на конвертацию указанным пользователем, в том числе все ожидающие запросы

get_encrypted_memo()

string wallet_api::get_encrypted_memo( string from, string to, string memo )
Параметры: from — имя аккаунта, с кошелька которого снимаются средства; to — имя аккаунта, в кошелек которого поступают средства; memo — текст заметки (примечания).
Возвращает заметку в зашифрованном виде, если ее текст начинается с символа «#». В противном случае возвращает заметку в ее оригинальном виде.

get_feed_history()

witness_api::feed_history_api_object wallet_api::get_feed_history()const
Возвращает историю конверсий GBG / GOLOS на блокчейне.

get_inbox()

vector<extended_message_object> wallet_api::get_inbox(
const std::string& to,
time_point newest,
uint16_t limit,
std::uint64_t offset
)
Параметры: to — имя аккаунта, для которого запрашиваются входящие к нему сообщения; newest — время, с момента которого запрашиваются сообщения; limit — пороговое значение на количество запрашиваемых сообщений; offset — смещение (в секундах) к заданному времени newest.
Используется для просмотра входящих личных сообщений для аккаунта с именем to, хранящихся в блокчейне.

get_miner_queue()

vector<account_name_type> wallet_api::get_miner_queue()const
Возвращает список майнеров, ожидающих создание блоков.

get_open_orders()

vector< database_api::extended_limit_order > wallet_api::get_open_orders( string owner )
Параметр: owner — пользователь, для которого отображается список заявок.
Возвращает список заявок на внутренней бирже на покупку и продажу в сети GOLOS для указанного пользователя.

get_ops_in_block()

vector< golos::plugins::operation_history::applied_operation > wallet_api::get_ops_in_block(
uint32_t block_num,
bool only_virtual
)
Параметры: num — номер (позиция) блока; only_virtual — только виртуальные операции.
Возвращает виртуальные операции в заданном блоке.

get_order_book()

market_history::order_book wallet_api::get_order_book(uint32_t limit)
Параметр: limit — максимальное количество заказов для возврата заявок и запросов (максимальное значение — 1000).
Возвращает список заявок на внутренней бирже на покупку и продажу в сети GOLOS.

get_outbox()

vector<extended_message_object> wallet_api::get_outbox(
const std::string& from,
time_point newest,
uint16_t limit,
std::uint64_t offset
)
Параметры: from — имя аккаунта, для которого запрашиваются исходящие от него сообщения; newest — время, с момента которого запрашиваются сообщения; limit — пороговое значение на количество запрашиваемых сообщений; offset — смещение (в секундах) к заданному времени newest.
Используется для просмотра исходящих личных сообщений для аккаунта с именем from, хранящихся в блокчейне.

get_owner_history()

vector< database_api::owner_authority_history_api_object > wallet_api::get_owner_history(
string account
)const
Параметры: account — пользователь, история которого отображается.
Возвращает историю полномочий (прав собственности) пользователя в блокчейне.

get_private_key()

fc::ecc::private_key get_private_key(const public_key_type pubkey)const
Параметр: pubkey — тип публичного ключа.
Используется для получения личного ключа в формате WIF, соответствующего публичному ключу. Личный ключ к этому моменту должен быть в кошельке. Возвращает подтверждение о наличие ключа или его отсутствие.

get_private_key_for_account()

fc::ecc::private_key get_private_key_for_account(
const golos::api::account_api_object& account
)const
Параметр: account — имя аккаунта, получающего ключ.
Возвращает данные ключа active в формате WIF.

get_private_key_from_password()

pair<public_key_type,string> wallet_api::get_private_key_from_password(
string account,
string role,
string password
)const
Параметры: account — имя аккаунта, который получает ключ; role — тип ключа (active | owner | posting | memo); password — пароль, который будет использоваться во время генерации ключа.
Возвращает публичный ключ, соответствующий сгенерированному личному ключу, а также личный ключ в формате WIF.

get_proposed_transactions()

std::vector<database_api::proposal_api_object> get_proposed_transactions(
std::string account,
uint32_t from,
uint32_t limit
)
Параметры: account — аккаунт, информацию о предложенных транзакциях которого необходимо получить; from — начальный номер транзакции; limit — пороговое значение количества транзакций.
Используется для получения информации о всех предложенных транзакциях применительно к одному и тому же аккаунту. Для получения информации об ограниченном количестве транзакций, необходимо задать начальный номер транзакции from и пороговое значение limit.

get_prototype_operation()

operation get_prototype_operation(string operation_type)
Параметр: operation_type — тип операции. Операция должна быть определена в файле steem/chain/operations.hpp.
Используется для получения и заполнения шаблона для операции, создаваемой с помощью вызова add_operation_to_builder_transaction(). Возвращает неинициализированный объект в виде заданной последовательности операций. Созданный объект может быть дополнен любой операцией с помощью вызова add_operation_to_builder_transaction().

get_transaction()

annotated_signed_transaction wallet_api::get_transaction(transaction_id_type id)const
Параметр: id — идентификатор транзакции.
Возвращает информацию о транзакции с указанном идентификатором.

get_wallet_filename()

string get_wallet_filename()
Возвращает текущее имя файла кошелька. Данное имя файла используется при автоматическом сохранении кошелька.

get_withdraw_routes()

vector< database_api::withdraw_vesting_route_api_object > wallet_api::get_withdraw_routes(
string account,
database_api::withdraw_route_type type
)const
Параметры: account — пользователь, для которого запрашивается возврат; type — тип возврата (задается строкой вида incoming, outgoing или all).
Возвращает перечень переводов, осуществляющих на счет пользователя в зависимости от задаваемого типа возврата (входящий, исходящий или все).

get_witness()

optional < witness_api::witness_api_object > get_witness(string owner_account)
Параметр: owner_account — имя или идентификатор делегата.
Возвращает информацию о заданном делегате, хранимую в блокчейне.

gethelp()

string wallet_api::gethelp(const string & method)const
Параметр: method — имя API команды, информация о которой запрашивается.
Возвращает справочную информацию по отдельной команде API.

help()

string wallet_api::help()const
Возвращает на терминал справочный перечень всех команд, поддерживаемых приложением wallet API. Информация содержит команды, их аргументы и возвращаемые типы. Для получения более подробной информации по отдельной команде следует использовать get_help().

get_withdraw_routes()

vector< database_api::withdraw_vesting_route_api_object > wallet_api::get_withdraw_routes(
string account,
database_api::withdraw_route_type type
)const
Параметры: account — имя аккаунта, запрашивающего маршруты; type — тип вывода (входящий, исходящий или все).
Возвращает маршруты вывода средств для аккаунта.

import_key()

bool import_key(string wif_key)
Параметр: wif_key — личный ключ в формате WIF.
Используется для импорта личного ключа в формате WIF в кошелек для его дальнейшего использования аккаунтом при подписании транзакций. Пример использования команды:
import_key 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3

info()

variant wallet_api::info()const
Возвращает актуальную информацию о блокчейне, в том числе: witness_majority_version — актуальное состояние делегирования; hardfork_version — версию HF Golos; head_block_num — актуальный номер блока; head_block_id — идентификатор блока; head_block_age — время жизни блока (в секундах); median_sbd_price — медианное значение SBD; account_creation_fee — размер комиссионных отчислений, требуемых на создание аккаунта без делегирования; create_account_min_golos_fee — минимальный размер комиссионных отчислений в криптовалюте Голос, требуемых на создание аккаунта с делегированием; create_account_min_delegation — минимально возможное количество Силы Голоса при создании аккаунта с делегированием; create_account_delegation_time — минимально возможное время (в секундах) «заморозки» делегированной Силы Голоса при создании аккаунта с делегированием; min_delegation — минимально возможное количество Силы Голоса для делегирования на аккаунт.

is_locked()

bool wallet_api::is_locked()const
Проверяет состояние кошелька: заблокирован или нет. Если кошелек находится в заблокированном состоянии, находящиеся в нем личные ключи использованы быть не могут. Состояние ключа изменяется вызовами lock() или unlock(). Возвращает “true”, если кошелек заблокирован.

is_new()

bool wallet_api::is_new()const
Проверяет состояние кошелька: новый (пароль еще не установлен) или нет. Установка пароля осуществляется с помощью вызова set_password(). Во время выполнении этой команды кошелек переводится в заблокированное состояние. Возвращает “true”, если кошелек новый.

list_accounts()

vector< account_name_type > wallet_api::list_accounts(const string& lowerbound, uint32_t limit)
Параметры: lowerbound — имя первого возвращаемого аккаунта. Если такое имя отсутствует, список будет начинаться с имени, непосредственно следующего за lowerbound; limit — значение, ограничивающее количество выводимых на монитор имен аккаунтов. Максимальное значение — 1000.
Используется для получения списка всех аккаунтов, зарегистрированных в блокчейне. Задание параметров lowerbound и limit позволяет формировать страницу в удобной для просмотра форме. Для просмотра всего списка имен аккаунтов рекомендуется вначале значение lowerbound устанавливать в виде пустой строки (“”). Затем на каждой итерации параметру lowerbound передавать последнее возвращаемое имя аккаунта для следующего вызова list_accaunt(). Возвращает список всех зарегистрированных в блокчейне имен аккаунтов с соответствующими им идентификаторами, отсортированный по именам в алфавитном порядке.

list_keys()

map<public_key_type, string> wallet_api::list_keys()
Используется для выдачи (распечатки) всех личных ключей, принадлежащих кошельку. Данные ключей выдаются в формате WIF. Ключи могут быть импортированы в другой кошелек вызовом import_key. Возвращает карту, содержащую личные ключи, индексированные по их публичному ключу.

list_my_accounts()

vector< golos::api::account_api_object > wallet_api::list_my_accounts()
Используется для получения информации об аккаунтах с помощью личного ключа, имеющегося в кошельке. Кошелек должен быть предварительно разблокирован. Метод использует вызов get_account().

list_witnesses()

vector< account_name_type > wallet_api::ist_witnesses(const string& lowerbound, uint32_t limit)
Параметры: lowerbound — имя первого возвращаемого делегата. Если такое имя отсутствует, список будет начинаться с имени, непосредственно следующего за lowerbound; limit — значение, ограничивающее количество выводимых на монитор имен делегатов. Максимальное значение — 1000.
Используется для получения списка всех имен делегатов, зарегистрированных в блокчейне. В списке также выделяются имена делегатов, голосующих на данный момент. Задание параметров lowerbound и limit позволяет формировать страницу в удобной для просмотра форме. Для просмотра всего списка имен делегатов рекомендуется вначале значение lowerbound устанавливать в виде пустой строки (“”). Затем на каждой итерации параметру lowerbound передавать последнее возвращаемое имя делегата для следующего вызова list_witnesses(). Возвращает список всех зарегистрированных в блокчейне имен делегатов с соответствующими им идентификаторами, отсортированный по именам в алфавитном порядке.

load_wallet_file()

bool wallet_api::load_wallet_file(string wallet_filename)
Параметр: wallet_filename — имя файла кошелька в формате JSON, который загружается.
Используется для загрузки заданного кошелька платформы Graphene. Перед тем, как новый кошелек будет загружен, текущий кошелек закрывается. Если поле wallet_filename задано пустым, выполнится перезагрузка существующего файла кошелька. Возвращает “true”, если заданный кошелек успешно загружен.

lock()

void wallet_api::lock()
Используется для немедленного блокирования кошелька.

normalize_brain_key()

string normalize_brain_key(string s)
Параметр: s — brain-ключ в оригинальном формате.
Используется для преобразования формата brain-ключа с целью снижения риска возникновения ошибок при повторных вводах-выводах ключа из памяти. Оригинальный формат brain-ключа преобразуется в формат, используемый для генерации личных ключей. Новый формат содержит верхние регистры всех символов ASCII, а также упакованные последовательно идущие пробелы в один. Возвращает brain-ключ в нормализованном виде.

post_comment()

annotated_signed_transaction wallet_api::post_comment(
string author,
string permlink,
string parent_author,
string parent_permlink,
string title, string body,
string json,
bool broadcast
)
Параметры: author — имя аккаунта, являющего автором комментария; permlink — ссылка на комментарий; parent_author — имя аккаунта комментария верхнего уровня. Пустая строка означает верхний уровень комментария; parent_permlink — категория ссылки (для случая, если parent_author — пустая строка); title — заголовок комментария; body — тело комментария; json — метаданные комментария в формате JSON; broadcast — “true”, если транзакция пересылается на демон.
Используется для публикации или обновления комментария. Возвращает подписанную транзакцию.

preview_builder_transaction()

transaction preview_builder_transaction(transaction_handle_type handle)
Параметр: handle — уникальный номер получаемого конструктора.
Возвращает уникальный номер для очередного создаваемого конструктора транзакций.

propose_builder_transaction()

signed_transaction propose_builder_transaction(
transaction_handle_type handle,
std::string author,
std::string title,
std::string memo,
time_point_sec expiration,
time_point_sec review_period_time,
bool broadcast
)
Параметры: handle — уникальный номер создаваемого конструктора транзакций; author — автор предлагаемой транзакции; title — заголовок предлагаемой транзакции; memo — примечание, текст которого дополняет смысловое значение заголовка; expiration — время, по истечении которого прекращается подписание транзакции; review_period_time — период, выделенный для подписания транзакции; broadcast — “true”, если транзакция пересылается на демон.
Используется для создания конструктора предлагаемых транзакций. Возвращает созданный конструктор транзакций под номером handle.

publish_feed()

annotated_signed_transaction wallet_api::publish_feed(
string witness,
price exchange_rate,
bool broadcast
)
Параметры: witness — делегат, публикующий ценовой тариф (потолок котировок); exchange_rate — предлагаемый курс обмена; broadcast — “true”, если транзакция пересылается на демон.
Используется для публикации потолка котировок криптовалют. Делегат может публиковать потолок котировок криптовалют STEEM:SBD на бирже. Медианное значение этих котировок используется для обработки запросов на конвертацию SBD в STEEM. Возвращает подписанную транзакцию.

quit()

void wallet_api::quit()
Ипользуется для выхода из кошелька.

recover_account()

annotated_signed_transaction wallet_api::recover_account(
string account_to_recover,
authority recent_authority,
authority new_authority,
bool broadcast
)
Параметры: account_to_recover — имя аккаунта; у которого восстанавливаются полномочия; recent_authority — недавние полномочия аккаунта; new_authority — новые полномочия, которые задаются в запросе на восстановление; broadcast — “true”, если транзакция пересылается на демон.
Используется для восстановления полномочий (авторизацию) аккаунта с использованием запроса на восстановление, созданного самим аккаунтом. Синтаксис этой команды содержит сериализованный объект авторизации. Пример авторизации объекта показан в следующей строке:
recover_account "account_to_recover"
{ " weight_threshold": 1,"account_auths": [], "key_auths": [["old_public_key",1]] }
{"weight_threshold": 1,"account_auths": [], "key_auths": [["new_public_key",1]]} true

remove_builder_transaction()

void remove_builder_transaction(transaction_handle_type handle)
Параметр: handle — уникальный номер конструктора транзакций. Этот номер уменьшается на единицу после каждого вызова метода.
Используется для удаления конструктора транзакций по заданному идентификационному номеру.

replace_operation_in_builder_transaction()

void replace_operation_in_builder_transaction(
transaction_handle_type handle,
unsigned op_index,
const operation& new_op
)
Параметры: handle — уникальный номер конструктора; op_index — номер операции в конструкторе транзакций, которую необходимо заменить; op — заменяющая операция.
Используется для замены операции под номером op_index в конструкторе транзакций на операцию op.

request_account_recovery()

annotated_signed_transaction wallet_api::request_account_recovery(
string recovery_account,
string account_to_recover,
authority new_authority,
bool broadcast
)
Параметры: recovery_account — имя аккаунта, создающего запрос на восстановление; account_to_recover — имя аккаунта, который необходимо восстановить; new_authority — новая авторизация “owner” для восстанавливаемого аккаунта; broadcast — “true”, если транзакция пересылается на демон.
Создает запрос на восстановление аккаунта. Синтаксис этой команды содержит сериализованный объект авторизации. Передача авторизации приведена в следующем примере:
request_account_recovery "recovery_account" "account_to_recover"
{"weight_threshold": 1,"account_auths": [], "key_auths": [["new_public_key",1]]} true

save_wallet_file()

void wallet_api::save_wallet_file(string wallet_filename)
Параметр: wallet_filename — имя нового файла формата JSON, в который сохраняется кошелек.
Используется для сохранения кошелька в файл с заданным именем. Если поле wallet_filename задается пустым, кошелек сохраняется в старый файл. Для выполнения операции «Сохранить как …» следует использовать вызов set_wallet_filename().

serialize_transaction()

string wallet_api::serialize_transaction(signed_transaction tx)const
Параметр: tx — подписанная транзакция для сериализации.
Конвертирует подписанную транзакцию в формате JSON в ее бинарное представление. Возвращает подписанную транзакцию в бинарном представлении, имеющую вид неструктурированной (бесформенной) строки, в которой могут содержаться нулевые символы.

set_password()

void wallet_api::set_password(string password)
Параметр: password— новый пароль.
Используется для установки нового пароля для кошелька. Кошелек должен быть либо новым, либо предварительно открытым командой unlocked().

set_transaction_expiration()

void set_transaction_expiration(uint32_t seconds)
Параметр: seconds — период времени в секундах.
Возвращает заданный период времени (в секундах) в будущем, обозначающим срок действия транзакции.

set_voting_proxy()

signed_transaction set_voting_proxy(
string account_to_modify,
string voting_account,
bool broadcast
)
Параметры: account_to_modify— имя или идентификационный номер аккаунта, чьи полномочия в голосовании изменяются; voting_account — имя аккаунта (заместитель), который наделяется полномочиями в голосовании. Пустая строка означает отсутствие заместителя; broadcast — “true”, если транзакция пересылается на демон.
Используется для установки полномочий в голосовании для аккаунта. Если пользователь не желает принимать активное участие в голосовании, он может разрешить другому аккаунту (заместителю) использовать его долю голоса при голосовании. Наделение полномочиями заместителя в голосовании не удаляет предыдущие голоса аккаунта из блокчейна, они будут сохранены, но игнорированы. Если аккаунт позже аннулирует полномочия заместителя в голосовании, его предыдущие голоса снова вступят в силу.

set_withdraw_vesting_route()

annotated_signed_transaction wallet_api::set_withdraw_vesting_route(
string from,
string to,
uint16_t percent,
bool auto_vest,
bool broadcast
)
Параметры: from — имя аккаунта, с кошелька которого снимаются средства в виде VESTS; to — имя аккаунта, в кошелек которого возвращаются средства в виде VESTS или STEEM; percent — процент отчисления от суммы возвращаемых средств аккаунту с именем “to”. Это значение должно устанавливаться в пределах от 1 до 100000 включительно (например, 100 составляет 1 %, 10000 составляет 100 %); auto_vest — “true”, если аккаунт с именем “from” должен получить средства в виде VESTS, и “false”, если в виде STEEM; broadcast — “true”, если подписанную транзакцию необходимо переслать на демон.
Используется для настройки маршрута вывода средств, полученных по наделенным акциям. При возврате наделенных акций получаемые средства будут перенаправлены к аккаунтам с именами “from” и “to” в соответствии с указанными весовыми долями.

sign_builder_transaction()

signed_transaction wallet_api::sign_builder_transaction(
transaction_handle_type handle,
bool broadcast
)
Параметры: handle — уникальный номер конструктора транзакций; broadcast — “true”, если подписанные транзакции необходимо переслать на демон.
Используется для подписания всех транзакций в конструкторе транзакций. Возвращает подписанные транзакции в конструкторе транзакций под номером handle.

sign_transaction()

annotated_signed_transaction wallet_api::sign_transaction(signed_transaction tx, bool broadcast)
Параметры: tx — транзакция; предоставленная на подпись; broadcast — “true”, если подписанную транзакцию необходимо переслать на демон.
Используется для предоставления на подпись полностью сформированную транзакцию. Транзакция подписывается необходимыми ключами и пересылается при необходимости на демон. Возвращает подписанную версию транзакции.

suggest_brain_key()