Справка по командам cleos¶

Ниже собрана документация по подкомандам cleos: одна страница вместо разрозненных файлов. Внутренние ссылки ведут на якоря этой страницы.

Оглавление¶

version
create
convert
get
set
transfer
net
wallet
sign
push
multisig
system

cleos version¶

Описание¶

Получить сведения о версии

Команда¶

cleos version

Подкоманды¶

client — версия клиента

cleos version client

Вывод¶

Build version: 7f854a61

`client`¶

Описание¶

Получить сведения о версии клиента

Позиционные параметры¶

нет

Использование¶

cleos version client

cleos create¶

Описание¶

Создать различные сущности вне и в блокчейне

Подкоманды¶

key — создать новую пару ключей и вывести публичный и приватный ключ
account — создать новый аккаунт в блокчейне

Create various items, on and off the blockchain
Usage: cleos create SUBCOMMAND

Subcommands:
  key                         Create a new keypair and print the public and private keys
  account                     Create a new account on the blockchain

`key`¶

Описание¶

Создаёт новую пару ключей и выводит публичный и приватный ключ

Использование¶

Usage: cleos create key [OPTIONS]

Options:
  -h,--help                   Print this help message and exit
  --r1                        Generate a key using the R1 curve (iPhone), instead of the K1 curve (Bitcoin)
  -f,--file TEXT              Name of file to write private/public key output to. (Must be set, unless "--to-console" is passed
  --to-console                Print private/public keys to console.

Команда¶

cleos create key -f passwd

Вывод¶

Private key: 5KCkcSxYKZfh5Cr8CCunS2PiUKzNZLhtfBjudaUnad3PDargFQo
Public key: EOS5uHeBsURAT6bBXNtvwKtWaiDSDJSdSmc96rHVws5M1qqVCkAm6

`account`¶

Описание¶

Создать новый аккаунт в блокчейне (предполагается, что системный контракт не ограничивает использование RAM)

Использование¶

Usage: cleos create account [OPTIONS] creator name OwnerKey [ActiveKey]

Positionals:
  creator TEXT                The name of the account creating the new account (required)
  name TEXT                   The name of the new account (required)
  OwnerKey TEXT               The owner public key or permission level for the new account (required)
  ActiveKey TEXT              The active public key or permission level for the new account

Options:
  -h,--help                   Print this help message and exit
  -x,--expiration             set the time in seconds before a transaction expires, defaults to 30s
  -f,--force-unique           force the transaction to be unique. this will consume extra bandwidth and remove any protections against accidently issuing the same transaction multiple times
  -s,--skip-sign              Specify if unlocked wallet keys should be used to sign transaction
  -j,--json                   print result as json
  --json-file TEXT            save result in json format into a file
  -d,--dont-broadcast         don't broadcast transaction to the network (just print to stdout)
  --return-packed             used in conjunction with --dont-broadcast to get the packed transaction
  -r,--ref-block TEXT         set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  --use-old-rpc               use old RPC push_transaction, rather than new RPC send_transaction
  -p,--permission TEXT ...    An account and permission level to authorize, as in 'account@permission' (defaults to 'creator@active')
  --max-cpu-usage-ms UINT     set an upper limit on the milliseconds of cpu usage budget, for the execution of the transaction (defaults to 0 which means no limit)
  --max-net-usage UINT        set an upper limit on the net usage budget, in bytes, for the transaction (defaults to 0 which means no limit)
  --delay-sec UINT            set the delay_sec seconds, defaults to 0s

Команда¶

Для создания аккаунта нужна пара ключей COOPOS. Ключи COOPOS можно сгенерировать командой cleos create key.

cleos create account inita tester EOS4toFS3YXEQCkuuw1aqDLrtHim86Gz9u3hBdcBw5KNPZcursVHq EOS7d9A3uLe6As66jzN8j44TXJUqJSK3bFjjEEqR4oTvNAB3iM9SA

Вывод¶

{
  "transaction_id": "6acd2ece68c4b86c1fa209c3989235063384020781f2c67bbb80bc8d540ca120",
  "processed": {
    "refBlockNum": "25217",
    "refBlockPrefix": "2095475630",
    "expiration": "2017-07-25T17:54:55",
    "scope": [
      "eos",
      "inita"
    ],
    "signatures": [],
    "messages": [{
        "code": "eos",
        "type": "newaccount",
        "authorization": [{
            "account": "inita",
            "permission": "active"
          }
        ],
        "data": "c9251a0000000000b44c5a2400000000010000000102bcca6347d828d4e1868b7dfa91692a16d5b20d0ee3d16a7ca2ddcc7f6dd03344010000010000000102bcca6347d828d4e1868b7dfa91692a16d5b20d0ee3d16a7ca2ddcc7f6dd03344010000010000000001c9251a000000000061d0640b000000000100010000000000000008454f5300000000"
      }
    ],
    "output": [{
        "notify": [],
        "sync_transactions": [],
        "async_transactions": []
      }
    ]
  }
}

cleos convert¶

Описание¶

Упаковка и распаковка транзакций

Подкоманды¶

pack_transaction — из обычного подписанного JSON в упакованный вид
unpack_transaction — из упакованного в обычный подписанный JSON
pack_action_data — из JSON данных действия в упакованный вид
unpack_action_data — из упакованных данных действия в JSON

`pack transaction`¶

Описание¶

Из обычного подписанного JSON в упакованный вид

Позиционные параметры¶

transaction TEXT — обычная подписанная транзакция в JSON (строка)

Опции¶

-h,--help — вывести справку и выйти
--pack-action-data — упаковать все данные действий внутри транзакции (требуется обращение к nodeos)

Использование¶

cleos convert pack_transaction '{
  "expiration": "2018-08-02T20:24:36",
  "ref_block_num": 14207,
  "ref_block_prefix": 1438248607,
  "max_net_usage_words": 0,
  "max_cpu_usage_ms": 0,
  "delay_sec": 0,
  "context_free_actions": [],
  "actions": [{
      "account": "eosio",
      "name": "newaccount",
      "authorization": [{
          "actor": "eosio",
          "permission": "active"
        }
      ],
      "data": "0000000000ea305500a6823403ea30550100000001000240cc0bf90a5656c8bb81f0eb86f49f89613c5cd988c018715d4646c6bd0ad3d8010000000100000001000240cc0bf90a5656c8bb81f0eb86f49f89613c5cd988c018715d4646c6bd0ad3d801000000"
    }
  ],
  "transaction_extensions": []
}'

Вывод¶

{
  "signatures": [],
  "compression": "none",
  "packed_context_free_data": "",
  "packed_trx": "8468635b7f379feeb95500000000010000000000ea305500409e9a2264b89a010000000000ea305500000000a8ed3232660000000000ea305500a6823403ea30550100000001000240cc0bf90a5656c8bb81f0eb86f49f89613c5cd988c018715d4646c6bd0ad3d8010000000100000001000240cc0bf90a5656c8bb81f0eb86f49f89613c5cd988c018715d4646c6bd0ad3d80100000000"
}

`unpack transaction`¶

Описание¶

Из упакованного вида в обычный подписанный JSON

Позиционные параметры¶

transaction TEXT — JSON упакованной транзакции (строка с полями packed_trx и при необходимости compression)

Опции¶

-h,--help — вывести справку и выйти
--unpack-action-data — распаковать все данные действий внутри транзакции (требуется обращение к nodeos)

Использование¶

cleos convert unpack_transaction '{
  "signatures": [
    "SIG_K1_KmRbWahefwxs6uyCGNR6wNRjw7cntEeFQhNCbyg8S92Kbp7zdSSVGTD2QS7pNVWgcU126zpxaBp9CwUxFpRwSnfkjd46bS"
  ],
  "compression": "none",
  "packed_context_free_data": "",
  "packed_trx": "8468635b7f379feeb95500000000010000000000ea305500409e9a2264b89a010000000000ea305500000000a8ed3232660000000000ea305500a6823403ea30550100000001000240cc0bf90a5656c8bb81f0eb86f49f89613c5cd988c018715d4646c6bd0ad3d8010000000100000001000240cc0bf90a5656c8bb81f0eb86f49f89613c5cd988c018715d4646c6bd0ad3d80100000000"
}'

Вывод¶

{
  "expiration": "2018-08-02T20:24:36",
  "ref_block_num": 14207,
  "ref_block_prefix": 1438248607,
  "max_net_usage_words": 0,
  "max_cpu_usage_ms": 0,
  "delay_sec": 0,
  "context_free_actions": [],
  "actions": [{
      "account": "eosio",
      "name": "newaccount",
      "authorization": [{
          "actor": "eosio",
          "permission": "active"
        }
      ],
      "data": "0000000000ea305500a6823403ea30550100000001000240cc0bf90a5656c8bb81f0eb86f49f89613c5cd988c018715d4646c6bd0ad3d8010000000100000001000240cc0bf90a5656c8bb81f0eb86f49f89613c5cd988c018715d4646c6bd0ad3d801000000"
    }
  ],
  "transaction_extensions": [],
  "signatures": [
    "SIG_K1_KmRbWahefwxs6uyCGNR6wNRjw7cntEeFQhNCbyg8S92Kbp7zdSSVGTD2QS7pNVWgcU126zpxaBp9CwUxFpRwSnfkjd46bS"
  ],
  "context_free_data": []
}

`pack action data`¶

Описание¶

Из JSON данных действия в упакованный вид

Позиционные параметры¶

account TEXT — аккаунт, на котором развёрнут контракт
name TEXT — имя вызываемого действия
unpacked_action_data TEXT — данные действия в JSON

Опции¶

-h,--help — вывести справку и выйти

Использование¶

 cleos convert pack_action_data eosio unlinkauth '{"account":"test1", "code":"test2", "type":"eosioeosio"}'

Вывод¶

000000008090b1ca000000000091b1ca000075982aea3055

`unpack action data`¶

Описание¶

Из упакованных данных действия в JSON

Позиционные параметры¶

account TEXT — аккаунт, на котором развёрнут контракт
name TEXT — имя вызываемого действия
packed_action_data TEXT — данные действия в виде упакованной hex-строки

Опции¶

-h,--help — вывести справку и выйти

Использование¶

 cleos convert unpack_action_data eosio unlinkauth 000000008090b1ca000000000091b1ca000075982aea3055

Вывод¶

{
  "account": "test1",
  "code": "test2",
  "type": "eosioeosio"
}

cleos get¶

Описание¶

Получить различные данные и сведения из блокчейна

Подкоманды¶

info — текущая информация о блокчейне
block — полный блок из блокчейна
account — аккаунт из блокчейна
code — код и ABI аккаунта
abi — ABI аккаунта
table — содержимое таблицы БД
scope — список scope и таблиц контракта
currency — сведения о стандартных валютах
accounts — аккаунты, связанные с публичным ключом
servants — аккаунты-подчинённые (servants) для заданного аккаунта
transaction — транзакция из блокчейна
actions — действия, где в авторизации или у получателя указан заданный аккаунт
schedule — расписание продюсеров
transaction_id — id транзакции по объекту транзакции

`info`¶

Описание¶

Получить текущую информацию о блокчейне

Позиционные параметры¶

Параметры не принимаются.

Опции¶

-h, --help — вывести справку и выйти

Пример¶

cleos get info

Команда возвращает текущее состояние блокчейна.

{
  "server_version": "7451e092",
  "head_block_num": 6980,
  "last_irreversible_block_num": 6963,
  "head_block_id": "00001b4490e32b84861230871bb1c25fb8ee777153f4f82c5f3e4ca2b9877712",
  "head_block_time": "2017-12-07T09:18:48",
  "head_block_producer": "initp",
  "recent_slots": "1111111111111111111111111111111111111111111111111111111111111111",
  "participation_rate": "1.00000000000000000"
}

`block`¶

Описание¶

Получить полный блок из блокчейна

Позиционные параметры¶

block TEXT — номер или id блока

Опции¶

--header-state — состояние заголовка блока из fork database
--info — краткая информация о блоке только по номеру

Пример¶

Полный блок:¶

cleos get block 1

или

cleos get block 0000000130d70e94e0022fd2fa035cabb9e542c34ea27f572ac90b5a7aa3d891

Вывод — объект блока, похожий на следующий:

{
  "timestamp": "2018-03-02T12:00:00.000",
  "producer": "",
  "confirmed": 1,
  "previous": "0000000000000000000000000000000000000000000000000000000000000000",
  "transaction_mroot": "0000000000000000000000000000000000000000000000000000000000000000",
  "action_mroot": "0000000000000000000000000000000000000000000000000000000000000000",
  "schedule_version": 0,
  "new_producers": null,
  "header_extensions": [],
  "producer_signature": "SIG_K1_111111111111111111111111111111111111111111111111111111111111111116uk5ne",
  "transactions": [],
  "block_extensions": [],
  "id": "0000000130d70e94e0022fd2fa035cabb9e542c34ea27f572ac90b5a7aa3d891",
  "block_num": 1,
  "ref_block_prefix": 3526296288
}

Информация о блоке:¶

cleos get block --info 1

Вывод — объект block info, похожий на следующий:

{
  "block_num": 1,
  "ref_block_num": 1,
  "id": "0000000130d70e94e0022fd2fa035cabb9e542c34ea27f572ac90b5a7aa3d891",
  "timestamp": "2018-03-02T12:00:00.000",
  "producer": "",
  "confirmed": 1,
  "previous": "0000000000000000000000000000000000000000000000000000000000000000",
  "transaction_mroot": "0000000000000000000000000000000000000000000000000000000000000000",
  "action_mroot": "0000000000000000000000000000000000000000000000000000000000000000",
  "schedule_version": 0,
  "producer_signature": "SIG_K1_111111111111111111111111111111111111111111111111111111111111111116uk5ne",
  "ref_block_prefix": 3526296288
}

Примечания¶

Объект block info фиксированного размера и не содержит полей: new_producers, header_extensions, transactions, block_extensions.

`account`¶

Описание¶

Получить аккаунт из блокчейна

Позиционные параметры¶

name TEXT — имя запрашиваемого аккаунта
core-symbol TEXT — ожидаемый базовый символ сети

Опции¶

-j,--json — вывод в формате JSON

Примеры¶

Форматированные данные для пользователя eosio¶

cleos get account eosio

privileged: true
permissions:
     owner     1:    1 EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV
        active     1:    1 EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV
memory:
     quota:        -1 bytes  used:      1.22 Mb   

net bandwidth: (averaged over 3 days)
     used:                -1 bytes
     available:           -1 bytes
     limit:               -1 bytes

cpu bandwidth: (averaged over 3 days)
     used:                -1 us
     available:           -1 us   
     limit:               -1 us   

producers:     <not voted>

JSON для пользователя eosio¶

cleos get account eosio --json

{
  "account_name": "eosio",
  "privileged": true,
  "last_code_update": "2018-05-23T18:00:25.500",
  "created": "2018-03-02T12:00:00.000",
  "ram_quota": -1,
  "net_weight": -1,
  "cpu_weight": -1,
  "net_limit": {
    "used": -1,
    "available": -1,
    "max": -1
  },
  "cpu_limit": {
    "used": -1,
    "available": -1,
    "max": -1
  },
  "ram_usage": 1279625,
  "permissions": [{
      "perm_name": "active",
      "parent": "owner",
      "required_auth": {
        "threshold": 1,
        "keys": [{
            "key": "EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV",
            "weight": 1
          }
        ],
        "accounts": [],
        "waits": []
      }
    },{
      "perm_name": "owner",
      "parent": "",
      "required_auth": {
        "threshold": 1,
        "keys": [{
            "key": "EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV",
            "weight": 1
          }
        ],
        "accounts": [],
        "waits": []
      }
    }
  ],
  "total_resources": null,
  "delegated_bandwidth": null,
  "voter_info": {
    "owner": "eosio",
    "proxy": "",
    "producers": [],
    "staked": 0,
    "last_vote_weight": "0.00000000000000000",
    "proxied_vote_weight": "0.00000000000000000",
    "is_proxy": 0,
    "deferred_trx_id": 0,
    "last_unstake_time": "1970-01-01T00:00:00",
    "unstaking": "0.0000 SYS"
  }
}

См. также¶

Протокольный документ Accounts and Permissions.

`code`¶

Описание¶

Получить код и ABI аккаунта

Позиционные параметры¶

name TEXT — аккаунт, чей код нужно получить

Опции¶

-c,--code TEXT — файл для сохранения контракта .wast
-a,--abi TEXT — файл для сохранения контракта .abi
--wasm — сохранить контракт как wasm

Примеры¶

Вывести только хэш кода контракта eosio.token

cleos get code eosio.token

code hash: f675e7aeffbf562c033acfaf33eadff255dacb90d002db51c7ad7cbf057eb791

Получить и сохранить ABI контракта eosio.token

cleos get code eosio.token -a eosio.token.abi

code hash: f675e7aeffbf562c033acfaf33eadff255dacb90d002db51c7ad7cbf057eb791
saving abi to eosio.token.abi

Получить и сохранить WAST контракта eosio.token

cleos get code eosio.token -c eosio.token.wast

code hash: f675e7aeffbf562c033acfaf33eadff255dacb90d002db51c7ad7cbf057eb791
saving wast to eosio.token.wast

`abi`¶

Описание¶

Получить ABI аккаунта

Позиционные параметры¶

name TEXT — аккаунт, чей ABI нужно получить

Опции¶

-f,--file TEXT — файл для сохранения .abi вместо вывода в консоль

Примеры¶

Получить и сохранить ABI контракта eosio.token

cleos get abi eosio.token -f eosio.token.abi

saving abi to eosio.token.abi

`table`¶

Описание¶

Получить содержимое таблицы базы данных

Позиционные параметры¶

account TEXT — аккаунт, на котором развёрнут смарт-контракт, владеющий таблицей

scope TEXT — scope внутри контракта, в котором находится таблица

table TEXT — имя таблицы по ABI контракта

Опции¶

-l,--limit UINT — максимальное число возвращаемых строк

-k,--key TEXT — (устарело) имя ключа для индексации по ABI, по умолчанию первичный ключ

-L,--lower TEXT — JSON нижней границы ключа, по умолчанию первая запись

-U,--upper TEXT — JSON верхней границы ключа, по умолчанию последняя запись

--index TEXT — номер индекса: 1 — primary (первый), 2 — вторичный (в порядке multi_index), 3 — третий и т.д. Можно указать номер или имя индекса, например secondary или 2

--key-type TEXT — тип ключа для --index; для primary только i64. Остальные поддерживают i64, i128, i256, float64, float128, ripemd160, sha256. Специальный тип name — имя аккаунта

--encode-type TEXT — кодировка для --key_type: dec для десятичного представления (i[64|128|256], float[64|128]); hex для шестнадцатеричного (i256, ripemd160, sha256)

-b,--binary UINT — вернуть значение в BINARY без интерпретации ABI как JSON

-r,--reverse — обход в обратном порядке

--show-payer — показать плательщика RAM

Пример¶

Данные таблицы accounts контракта eosio.token для пользователя eosio,

cleos get table eosio.token eosio accounts

{
  "rows": [{
      "balance": "999999920.0000 SYS"
    }
  ],
  "more": false
}

`scope`¶

Описание¶

Получить список scope и таблиц, принадлежащих контракту

Позиционные параметры¶

contract TEXT — владелец таблицы

Опции¶

-t,--table TEXT — фильтр по имени таблицы
-l,--limit UINT — максимальное число возвращаемых строк
-L,--lower TEXT — нижняя граница scope
-U,--upper TEXT — верхняя граница scope
-r,--reverse — обход в обратном порядке

`currency`¶

Описание¶

Подкоманды для работы со стандартными валютами

Подкоманды¶

currency balance — баланс аккаунта для заданной валюты

currency stats — статистика для заданной валюты

`currency-balance`¶

Описание¶

Получить баланс аккаунта для заданной валюты

Позиционные параметры¶

contract TEXT — контракт, управляющий валютой

account TEXT — аккаунт, по которому запрашиваются балансы

symbol TEXT — символ валюты, если контракт обслуживает несколько валют

Опции¶

У этой подкоманды нет опций

Пример¶

Баланс eosio у контракта eosio.token для символа SYS.

cleos get currency balance eosio.token eosio SYS

999999920.0000 SYS

`currency-stats`¶

Описание¶

Получить статистику для заданной валюты

Позиционные параметры¶

contract TEXT — контракт, управляющий валютой

symbol TEXT — символ валюты, если контракт обслуживает несколько валют

Опции¶

У этой подкоманды нет опций

Пример¶

Статистика токена SYS контракта eosio.token.

cleos get currency stats eosio.token SYS

{
  "SYS": {
    "supply": "1000000000.0000 SYS",
    "max_supply": "10000000000.0000 SYS",
    "issuer": "eosio"
  }
}

`accounts`¶

Описание¶

Получить все аккаунты, связанные с указанным публичным ключом

Note

Команда не возвращает привилегированные аккаунты.

Позиционные параметры¶

public_key TEXT — публичный ключ для поиска аккаунтов

Опции¶

-j,--json — вывод в формате JSON

Пример¶

cleos get accounts EOS8mUftJXepGzdQ2TaCduNuSPAfXJHf22uex4u41ab1EVv9EAhWt
{
  "account_names": [
    "testaccount"
  ]
}

`servants`¶

Описание¶

Получить аккаунты-подчинённые (controlled) для заданного аккаунта

Сведения¶

Команда

cleos get servants

Вывод

Usage: cleos get servants account

Positionals:
  account TEXT                The name of the controlling account

Команда¶

cleos get servants inita

Вывод¶

{
  "controlled_accounts": [
    "tester"
  ]
}

`transaction`¶

Описание¶

Получить транзакцию из блокчейна

Позиционные параметры¶

id TEXT — id запрашиваемой транзакции

Опции¶

-b,--block-hint UINT — номер блока, в котором транзакция может находиться

Команда

cleos get transaction

Вывод

Пример¶

href="#__codelineno-50-1">cleos get transaction eb4b94b72718a369af09eb2e7885b3f494dd1d8a20278a6634611d5edd76b703 href="#__codelineno-51-1">{ "transaction_id": "eb4b94b72718a369af09eb2e7885b3f494dd1d8a20278a6634611d5edd76b703", "processed": { "refBlockNum": 2206, "refBlockPrefix": 221394282, "expiration": "2017-09-05T08:03:58", "scope": [ "inita", "tester" ], "signatures": [ "1f22e64240e1e479eee6ccbbd79a29f1a6eb6020384b4cca1a958e7c708d3e562009ae6e60afac96f9a3b89d729a50cd5a7b5a7a647540ba1678831bf970e83312" ], "messages": [{ "code": "eos", "type": "transfer", "authorization": [{ "account": "inita", "permission": "active" } ], "data": { "from": "inita", "to": "tester", "amount": 1000, "memo": "" }, "hex_data": "000000008040934b00000000c84267a1e80300000000000000" } ], "output": [{ "notify": [{ "name": "tester", "output": { "notify": [], "sync_transactions": [], "async_transactions": [] } },{ "name": "inita", "output": { "notify": [], "sync_transactions": [], "async_transactions": [] } } ], "sync_transactions": [], "async_transactions": [] } ] } }

Важно

Указанный id транзакции может отсутствовать в вашей цепочке

`transaction-status`¶

Описание¶

Текущее состояние цепочки и при наличии — информация о статусе транзакции по её id.

Для работы запроса должна быть включена функция статуса финальности транзакций: в плагине chain у nodeos задать опцию --transaction-finality-status-max-storage-size-gb \<size\>.

Позиционные параметры¶

id TEXT — id транзакции для запроса статуса (обязательно)

Опции¶

-h, --help — вывести справку и выйти

Пример¶

cleos get transaction-status 6438df82216dfaf46978f703fb818b49110dbfc5d9b521b5d08c342277438b29

Команда возвращает состояние цепочки и при наличии — статус транзакции.

{
    "state": "IN_BLOCK",
    "block_number": 90,
    "block_id": "0000005accfd59ba80a05380f60d51687406337b2aedd28b7daa33fdb8c16b5a",
    "block_timestamp": "2022-04-27T16:11:26.500",
    "expiration": "2022-04-27T16:11:56.000",
    "head_number": 186,
    "head_id": "000000bab27da51f76f483bb629b532510c22e2eb1acc632f5b37b421adecf63",
    "head_timestamp": "2022-04-27T16:12:14.500",
    "irreversible_number": 25,
    "irreversible_id": "0000001922118216bc16bf2c60d950598d80af3beca820eab751f7beecdb29e4",
    "irreversible_timestamp": "2022-04-27T16:10:54.000",
    "earliest_tracked_block_id": "000000129cee97f3e27312f0184d52d006a470f0e620553dfb4c5b4f3c856ab2",
    "earliest_tracked_block_number": 18
}

`actions`¶

Описание¶

Получить действия, где заданный аккаунт указан в авторизации или как получатель

Позиционные параметры¶

account_name TEXT — аккаунт для запроса (обязательно)
pos INT — порядковый номер действия для этого аккаунта, -1 — последнее (необязательно)
offset INT — диапазон действий: при положительном offset — [pos, pos + offset], при отрицательном — [pos - offset, pos]

Опции¶

-j,--json — полный JSON
--full — не обрезать вывод действия
--pretty — форматировать полный JSON действия
--console — вывести консольный вывод, сгенерированный действием

Примеры¶

Список действий для eosio.token

cleos get actions eosio.token

#  seq  when                              contract::action => receiver      trx id...   args
================================================================================================================
#  976   2018-06-01T19:54:05.000     eosio.token::transfer => eosio.token   1d1fe154... {"from":"userae","to":"useraa","quantity":"0.000...
#  977   2018-06-01T19:54:05.000     eosio.token::transfer => eosio.token   a0c9e5bc... {"from":"userab","to":"useraa","quantity":"0.000...
#  978   2018-06-01T19:54:05.000     eosio.token::transfer => eosio.token   3749d0d1... {"from":"userab","to":"userah","quantity":"0.000...
#  979   2018-06-01T19:54:05.000     eosio.token::transfer => eosio.token   dda205b0... {"from":"userai","to":"useraj","quantity":"0.000...
#  980   2018-06-01T19:54:05.000     eosio.token::transfer => eosio.token   14089e9b... {"from":"userab","to":"userae","quantity":"0.000...
#  981   2018-06-01T19:54:05.000     eosio.token::transfer => eosio.token   6882cefc... {"from":"useraj","to":"userab","quantity":"0.000...
...

`schedule`¶

Описание¶

Получить расписание продюсеров

Опции¶

-h, --help — вывести справку и выйти
-j, --json — вывод в формате JSON

Пример¶

cleos get schedule

Команда возвращает текущее расписание продюсеров.

active schedule version 0
    Producer      Producer key
    ============= ==================
    eosio         EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV

pending schedule empty

proposed schedule empty

`transaction id`¶

Описание¶

Получить id транзакции по объекту транзакции

Позиционные параметры¶

transaction TEXT — JSON-строка или файл с транзакцией, для которой нужен id (обязательно)

Опции¶

-h,--help — вывести справку и выйти

cleos set¶

Описание¶

Задать или обновить состояние блокчейна.

Команды¶

Задать или обновить состояние блокчейна

Usage: cleos set [OPTIONS] SUBCOMMAND

Options:
  -h,--help                   Print this help message and exit

Подкоманды¶

code — создать или обновить код на аккаунте
abi — создать или обновить ABI на аккаунте
contract — создать или обновить контракт на аккаунте
account — задать или обновить состояние аккаунта
action — задать или обновить состояние действия

`set-code`¶

Описание¶

Задать или обновить код аккаунта в блокчейне.

Позиционные параметры¶

account TEXT — аккаунт, для которого задаётся код (обязательно)
code-file TEXT — полный путь к файлу контракта WAST или WASM (обязательно)

Опции¶

-h,--help — вывести справку и выйти -a,--abi TEXT — ABI контракта

-c,--clear — удалить контракт с аккаунта

--suppress-duplicate-check — не проверять дубликаты

-x,--expiration TEXT — время в секундах до истечения транзакции, по умолчанию 30 с

-f,--force-unique — принудительно сделать транзакцию уникальной (дополнительный расход bandwidth, снимается защита от случайной повторной отправки)

-s,--skip-sign — использовать ли ключи разблокированного кошелька для подписи транзакции

-j,--json — вывести результат в JSON

-d,--dont-broadcast — не транслировать транзакцию в сеть (только вывести в stdout)

--return-packed — вместе с --dont-broadcast получить упакованную транзакцию

-r,--ref-block TEXT — номер блока или id блока для TAPOS (Transaction as Proof-of-Stake)

-p,--permission Type:Text — аккаунт и уровень разрешения для авторизации в виде account@permission (по умолчанию account@active)

-r,--ref-block TEXT — номер блока или id блока для TAPOS (Transaction as Proof-of-Stake)
-p,--permission TEXT — аккаунт и уровень разрешения для авторизации в виде account@permission (по умолчанию account@active)
--max-cpu-usage-ms UINT — верхний предел миллисекунд бюджета CPU на выполнение транзакции (0 — без ограничения)
--max-net-usage UINT — верхний предел бюджета net в байтах (0 — без ограничения)
--delay-sec UINT — задержка delay_sec в секундах, по умолчанию 0 с

cleos set code someaccount1 ./path/to/wasm

`set-abi`¶

Описание¶

Создать или обновить ABI на аккаунте

Позиционные параметры¶

account TEXT — аккаунт, для которого задаётся код (обязательно)
abi-file TEXT — полный путь к файлу контракта WAST или WASM (обязательно)

Опции¶

-h,--help — вывести справку и выйти
`-a,--abi' TEXT — ABI контракта
`-x,--expiration TEXT — время в секундах до истечения транзакции, по умолчанию 30 с
-f,--force-unique — принудительно сделать транзакцию уникальной (дополнительный расход bandwidth, снимается защита от случайной повторной отправки)
-s,--skip-sign — использовать ли ключи разблокированного кошелька для подписи транзакции
-d,--dont-broadcast — не транслировать транзакцию в сеть (только вывести в stdout)
-r,--ref-block TEXT — номер блока или id блока для TAPOS (Transaction as Proof-of-Stake)
-p,--permission TEXT — аккаунт и уровень разрешения для авторизации в виде account@permission (по умолчанию account@active)
--max-cpu-usage-ms UINT — верхний предел миллисекунд бюджета CPU на выполнение транзакции (0 — без ограничения)
--max-net-usage UINT — верхний предел бюджета net в байтах (0 — без ограничения)
--delay-sec UINT — задержка delay_sec в секундах, по умолчанию 0 с

Использование¶

cleos set abi someaccount1 ./path/to/abi.abi

`set-contract`¶

Описание¶

Создать или обновить контракт на аккаунте.

Позиционные параметры¶

account TEXT — аккаунт, для которого публикуется контракт wast-file TEXT — файл с контрактом WAST или WASM abi-file TEXT — ABI контракта

Опции¶

-h,--help — вывести справку и выйти

-a,--abi TEXT — ABI контракта

-c,--clear — удалить контракт с аккаунта

--suppress-duplicate-check — не проверять дубликаты

-x,--expiration TEXT — время в секундах до истечения транзакции, по умолчанию 30 с

-f,--force-unique — принудительно сделать транзакцию уникальной (дополнительный расход bandwidth, снимается защита от случайной повторной отправки)

-s,--skip-sign — использовать ли ключи разблокированного кошелька для подписи транзакции

-d,--dont-broadcast — не транслировать транзакцию в сеть (только вывести в stdout)

--return-packed — вместе с --dont-broadcast получить упакованную транзакцию

-r,--ref-block TEXT — номер блока или id блока для TAPOS (Transaction as Proof-of-Stake)

-p,--permission TEXT — аккаунт и уровень разрешения для авторизации в виде account@permission (по умолчанию account@active)

--max-cpu-usage-ms UINT — верхний предел миллисекунд бюджета CPU на выполнение транзакции (0 — без ограничения)

--max-net-usage UINT — верхний предел бюджета net в байтах (0 — без ограничения)

--delay-sec UINT — задержка delay_sec в секундах, по умолчанию 0 с

Пример¶

Развёртывание стандартного контракта валюты.

cleos set contract currency ../../../contracts/currency/currency.wast ../../../contracts/currency/currency.abi

Вывод может быть примерно таким:

Reading WAST...
Assembling WASM...
Publishing contract...

{
  "transaction_id": "9990306e13f630a9c5436a5a0b6fb8fe2c7f3da2f342b4898a39c4a2c17dcdb3",
  "processed": {
    "refBlockNum": 1208,
    "refBlockPrefix": 3058534156,
    "expiration": "2017-08-24T18:29:52",
    "scope": [
      "currency",
      "eos"
    ],
    "signatures": [],
    "messages": [{
        "code": "eos",
        "type": "setcode",
        "authorization": [{
            "account": "currency",
            "permission": "active"
          }
        ],
        "data": "00000079b822651d0000e8150061736d0100000001390a60017e0060037e7e7f017f60047e7e7f7f017f60017f0060057e7e7e7f7f017f60027f7f0060027f7f017f60027e7f0060000060027e7e00029d010a03656e7606617373657274000503656e76086c6f61645f693634000403656e76067072696e7469000003656e76067072696e746e000003656e76067072696e7473000303656e760b726561644d657373616765000603656e760a72656d6f76655f693634000103656e760b7265717569726541757468000003656e760d726571756972654e6f74696365000003656e760973746f72655f6936340002030706000007030809040401700000050301000107cc0107066d656d6f72790200205f5a4e33656f733133726571756972654e6f74696365454e535f344e616d6545000a1e5f5a4e33656f7331317265717569726541757468454e535f344e616d6545000b345f5a4e3863757272656e6379313273746f72654163636f756e74454e33656f73344e616d6545524b4e535f374163636f756e7445000c355f5a4e3863757272656e637932336170706c795f63757272656e63795f7472616e7366657245524b4e535f385472616e7366657245000d04696e6974000e056170706c79000f0a9d0d060600200010080b0600200010070b3400024020012903084200510d0020004280808080a8d7bee3082001411010091a0f0b20004280808080a8d7bee308200110061a0b8a0604017e027f047e017f4100410028020441206b2208360204200029030821052000290300210720002903102104411010042004100241c000100442808080c887d7c8b21d100341d00010042007100341e000100420051003200029030021052000290308100820051008200029030010072000290300210142002105423b210441f00021034200210603400240024002400240024020054206560d0020032c00002202419f7f6a41ff017141194b0d01200241a0016a21020c020b420021072005420b580d020c030b200241ea016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b2007421f83200442ffffffff0f838621070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b420021052008420037031820082006370310200142808080c887d7c8b21d4280808080a8d7bee308200841106a411010011a200041086a2903002101423b210441f00021034200210603400240024002400240024020054206560d0020032c00002202419f7f6a41ff017141194b0d01200241a0016a21020c020b420021072005420b580d020c030b200241ea016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b2007421f83200442ffffffff0f838621070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b2008200637030020084200370308200142808080c887d7c8b21d4280808080a8d7bee3082008411010011a200841186a2203290300200041106a22022903005a418001100020032003290300200229030022057d370300200520082903087c20055a41b00110002008200829030820022903007c370308200029030021050240024020032903004200510d0020054280808080a8d7bee308200841106a411010091a0c010b20054280808080a8d7bee308200841106a10061a0b200041086a290300210502400240200841086a2903004200510d0020054280808080a8d7bee3082008411010091a0c010b20054280808080a8d7bee308200810061a0b4100200841206a3602040b980303027f057e017f4100410028020441106b220736020442002103423b210241e00121014200210403400240024002400240024020034207560d0020012c00002200419f7f6a41ff017141194b0d01200041a0016a21000c020b420021052003420b580d020c030b200041ea016a41002000414f6a41ff01714105491b21000b2000ad42388642388721050b2005421f83200242ffffffff0f838621050b200141016a2101200342017c2103200520048421042002427b7c2202427a520d000b42002103423b210241f00021014200210603400240024002400240024020034206560d0020012c00002200419f7f6a41ff017141194b0d01200041a0016a21000c020b420021052003420b580d020c030b200041ea016a41002000414f6a41ff01714105491b21000b2000ad42388642388721050b2005421f83200242ffffffff0f838621050b200141016a2101200342017c2103200520068421062002427b7c2202427a520d000b2007428094ebdc033703082007200637030020044280808080a8d7bee3082007411010091a4100200741106a3602040bb10303027f047e017f4100410028020441206b220836020442002105423b210441e00121034200210603400240024002400240024020054207560d0020032c00002202419f7f6a41ff017141194b0d01200241a0016a21020c020b420021072005420b580d020c030b200241ea016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b2007421f83200442ffffffff0f838621070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b024020062000520d0042002105423b210441f00121034200210603400240024002400240024020054207560d0020032c00002202419f7f6a41ff017141194b0d01200241a0016a21020c020b420021072005420b580d020c030b200241ea016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b20062001520d00200842003703102008420037030820084200370318200841086a4118100541174b4180021000200841086a100d0b4100200841206a3602040b0bff010b0041040b04200500000041100b2254686973206170706561727320746f2062652061207472616e73666572206f6620000041c0000b0220000041d0000b072066726f6d20000041e0000b0520746f20000041f0000b086163636f756e7400004180010b2c696e746567657220756e646572666c6f77207375627472616374696e6720746f6b656e2062616c616e6365000041b0010b26696e7465676572206f766572666c6f7720616464696e6720746f6b656e2062616c616e6365000041e0010b0963757272656e6379000041f0010b097472616e7366657200004180020b1e6d6573736167652073686f72746572207468616e2065787065637465640000fd02046e616d651006617373657274020000086c6f61645f693634050000000000067072696e74690100067072696e746e0100067072696e747301000b726561644d6573736167650200000a72656d6f76655f693634030000000b726571756972654175746801000d726571756972654e6f7469636501000973746f72655f6936340400000000205f5a4e33656f733133726571756972654e6f74696365454e535f344e616d65450101301e5f5a4e33656f7331317265717569726541757468454e535f344e616d6545010130345f5a4e3863757272656e6379313273746f72654163636f756e74454e33656f73344e616d6545524b4e535f374163636f756e74450201300131355f5a4e3863757272656e637932336170706c795f63757272656e63795f7472616e7366657245524b4e535f385472616e73666572450901300131013201330134013501360137013804696e69740801300131013201330134013501360137056170706c7909013001310132013301340135013601370138010b4163636f756e744e616d65044e616d6502087472616e7366657200030466726f6d0b4163636f756e744e616d6502746f0b4163636f756e744e616d65087175616e746974790655496e743634076163636f756e740002036b65790655496e7436340762616c616e63650655496e74363401000000b298e982a4087472616e736665720100000080bafac608076163636f756e74"
      }
    ],
    "output": [{
        "notify": [],
        "sync_transactions": [],
        "async_transactions": []
      }
    ]
  }
}

`set-account`¶

Описание¶

Задать параметры, связанные с разрешениями аккаунта

Ввод JSON

Команда требует JSON, зависящий от внутренних определений классов. Такой ввод может меняться в будущих версиях ПО COOPOS.

Позиционные параметры¶

account TEXT — аккаунт, для которого задаётся или удаляется полномочие разрешения
permission TEXT — имя разрешения, для которого задаётся или удаляется полномочие
authority TEXT — [delete] NULL, [create/update] публичный ключ, JSON-строка или файл с описанием полномочия
parent TEXT — [create] имя родительского разрешения (по умолчанию: active)

Опции¶

-h,--help — вывести справку и выйти

--add-code [code] — добавить разрешение eosio.code к указанному полномочию

--remove-code [code] — убрать разрешение eosio.code из указанного полномочия