Get

Get
Description
The subcommands can be used to retrieve various items and information from the blockchain.
Subcommands
​Abi — Retrieve the ABI for an account.
​Account — Retrieve an account from the blockchain.
​Accounts — Retrieve accounts associated with a public key.
​Actions — Retrieve all actions with specific account name referenced in authorization or receiver.
​Block — Retrieve a full block from the blockchain.
​Code — Retrieve the code and ABI for an account.
​Currency Balance — Retrieve the balance of an account for a given currency.
​Currency Stats — Retrieve the stats of for a given currency.
​Info — Get current blockchain information.
​Schedule — Retrieve the producer schedule.
​Scope — Retrieve a list of scopes and tables owned by a contract.
​Servants — Retrieve accounts which are servants of a given account.
​Table — Retrieve the contents of a database table.
​Transaction — Retrieve a transaction from the blockchain.
​Transaction ID — Get transaction id given transaction object.
Abi
Description
The subcommand retrieves the ABI for an account.
Positional Parameters
(string) name — The name of the account whose abi should be retrieved (required).
Options
-f, --file TEXT — The name of the file to save the contract .abi to instead of writing to console.
Command
$ cleos get abi [OPTIONS] <name>
Examples
Retrieve and save abi for cyber.stake contract.
$ cleos get abi cyber.stake -f cyber.stake.abi
saving abi to cyber.stake.abi
Account
Description
The subcommand retrieves an account from the blockchain.
Positional Parameters
(string) name — The name of the account to retrieve (required).
(string) core-symbol — The expected core symbol of the chain you are querying.
Options
--json, -j — Output in JSON format.
Command
$ cleos get account [OPTIONS] <name> [<core-symbol>]
Examples
Get formatted data for user cyberio.
$ cleos get account cyberio
Get JSON data for user cyberio.
$ cleos get account cyberio --json
Accounts
Description
The subcommand retrieves accounts associated with a public key.
Positional Parameters
(string) public_key — The public key to retrieve accounts for (required).
Options
--json, -j — Output in JSON format.
Command
$ cleos get accounts [OPTIONS] <public_key>
Examples
$ cleos get accounts GLS7w...NuSPAfXJHAhWt
{
  "account_names": [
    "testaccount"
  ]
}
Actions
Description
The subcommand retrieves all actions with specific account name referenced in authorization or receiver.
Positional Parameters
(string) account_name — Name of account to query on (required).
(int_32) pos — Sequence number of action for this account, -1 for last.
(int_32) offset — Get actions [pos, pos + offset] for positive offset or [pos - offset, pos] for negative offset.
Options
-j, --json — Print full json.
--full — Do not truncate action output.
--pretty — Pretty print full action json.
--console — Print console output generated by action.
Command
$ cleos get actions [OPTIONS] <account_name> [<pos>] [<offset>]
Examples
Retrieve and save abi for cyber.token contract.
$ cleos get actions cyber.token
#  seq    when                            contract::action => receiver      trx id...   args
================================================================================================================
#  1101   2020-02-02T10:34:01.000     cyber.token::transfer => cyber.token   a3fgh5f4... {"from":"userae","to":"useraa","quantity":"0.000...
#  1102   2020-02-02T10:34:01.000     cyber.token::transfer => cyber.token   rt48fhrh... {"from":"userab","to":"useraa","quantity":"0.000...
#  1103   2020-02-02T10:34:01.000     cyber.token::transfer => cyber.token   6gg093dg... {"from":"userab","to":"userah","quantity":"0.000...
#  1104   2020-02-02T10:34:01.000     cyber.token::transfer => cyber.token   2ws8d55t... {"from":"userai","to":"useraj","quantity":"0.000...
...
Block
Description
The subcommand retrieves a full block from the blockchain.
Positional Parameters
(string) block — The number or ID of the block to retrieve (required).
Options
--header-state — Get block header state from fork database instead.
Command
$ cleos get block [OPTIONS] <block>
Examples
$ cleos get block 7315
or
$ cleos get block 0000...5ye0ort10e
Result output is a block object similar to the following
{
  "timestamp": "2020-02-02T10:38:32.000",
  "producer": "",
  "confirmed": 21,
  "previous": "006...9bd",
  "transaction_mroot": "1434...d09",
  "action_mroot": "dea...469",
  "schedule_version": 59218,
  "new_producers": null,
  "header_extensions": [],
  "producer_signature": "SIG_K1_J...eR",
  "transactions": [],
  "block_extensions": [],
  "id": "006...58f22d10",
  "block_num": 7315,
  "ref_block_prefix": 744221143
}
Code
Description
The subcommand retrieves the code and ABI for an account
Positional Parameters
(string) name — The name of the account whose code should be retrieved (required).
Options
-c, --code TEXT — The name of the file to save the contract .wast to.
-a, --abi TEXT — The name of the file to save the contract .abi to.
--wasm — Save contract as wasm.
Command
$ cleos get code [OPTIONS] <name>
Examples
Simply output the hash of cyber.token contract
$ cleos get code cyber.token
code hash: 3eadff2...0d002
Retrieve and save abi for cyber.token contract.
$ cleos get code cyber.token -a cyber.token.abi
code hash: 3eadff2...0d002
saving abi to cyber.token.abi
Retrieve and save wast code for cyber.token contract.
$ cleos get code cyber.token -c cyber.token.wast
code hash: 3eadff2...0d002
saving wast to cyber.token.wast
Currency Balance
Description
The subcommand retrieves the balance of an account for a given currency.
Positional Parameters
(string) contract — The contract that operates the currency (required).
(string) account — The account to query balances for (required).
(string) symbol — The symbol for the currency if the contract operates multiple currencies.
Options
No options required for this subcomand.
Command
$ cleos get balance <contract> <account> [<symbol>]
Examples
Get balance of eosio from cyber.token contract for SYS symbol.
$ cleos get currency balance cyber.token cyberio SYS
  10000.0000 SYS
Currency Stats
Description
The subcommand retrieves the stats of for a given currency.
Positional Parameters
(string) contract — The contract that operates the currency (required).
(string) symbol — The symbol for the currency if the contract operates multiple currencies (required).
Options
No options required for this subcomand.
Command
$ cleos get stats <contract> <symbol>
Examples
Get stats of the SYS token from the cyber.token contract.
$ cleos get currency stats eosio.token SYS
{
  "SYS": {
    "supply": "10000.0000 SYS",
    "max_supply": "100000.0000 SYS",
    "issuer": "cyberio"
  }
}
Info
Description
The subcommand gets current blockchain information.
Positional Parameters
No parameters required for this subcommand.
Options
No options required for this subcommand.
Command
$ cleos get info
Examples
This subcommand returns the current blockchain state information.
$ cleos get info
{
  "server_version": "5ad0",
  "head_block_num": 7342,
  "last_irreversible_block_num": 7325,
  "head_block_id": "006...58f2442",
  "head_block_time": "2020-02-02T17:23:40",
  "head_block_producer": "zaheader",
  "recent_slots": "111...111",
  "participation_rate": "1.00000000000000000"
}
Schedule
Description
The subcommand retrieves the producer schedule.
Positional Parameters
No parameters required for this subcommand.
Options
-j, --json —  Output in JSON format.
Command
$ cleos get schedule [OPTIONS]
Examples
This subcommand returns the current producer schedule.
$ cleos get schedule
active schedule version 0
    Producer      Producer key
    ============= ==================
    cyberio       GLS7w...NuSPAfXJHAhWt
​
pending schedule empty
​
proposed schedule empty
Scope
Description
The subcommand retrieves a list of scopes and tables owned by a contract
Positional Parameters
(string) contract — The contract who owns the table (required).
Options
-t, --table TEXT — The name of the table as filter.
-l, --limit UINT — The maximum number of rows to return.
-L, --lower TEXT — Lower bound of scope.
-U, --upper TEXT — Upper bound of scope.
-r, --reverse —  Iterate in reverse order.
Command
$ cleos get scope [OPTIONS] <contract>
Servants
Description
The subcommand retrieves accounts which are servants of a given account.
Positional Parameters
(string) account — The name of the controlling account (required).
Options
No options required for this subcommand.
Command
$ cleos get servants <account>
Examples
$ cleos get servants alice
Output
{
  "controlling_account": [
    "alice"
  ]
}
Table
Description
The subcommand retrieves the contents of a database table.
Positional Parameters
(string) account — The account who owns the table (required).
(string) scope — The scope within the contract in which the table is found (required).
(string) table — The name of the table as specified by the contract abi (required).
Options
--index — Index name. The same as in abi decription. If not set the index name will be primary.
-b, --binary — Return the value as BINARY rather than using abi to interpret as JSON.
-l, --limit — The maximum number of rows to return.
-k, --key — Deprecated.
-L, --lower — JSON representation of lower bound value of key, defaults to first.
-U, --upper — JSON representation of upper bound value of key, defaults to last.
--key-type — Deprecated.
--encode-type — The encoding type of key_type (i64 , i128 , float64, float128) only support decimal encoding (e.g. 'dec'). i256 - supports both 'dec' and 'hex', ripemd160 and sha256 is 'hex' only.
-r, --reverse — Iterate in reverse order.
--show-payer — show RAM payer.
Command
$ cleos get table [OPTIONS] <account> <scope> <table>
Examples
Get the data from the accounts table for the cyber.token contract, for user cyberio.
$ cleos get table cyber.token cyberio accounts
Transaction
Description
The subcommand retrieves a transaction from the blockchain.
Positional Parameters
(string) id — ID of the transaction to retrieve (required).
Options
-b, --block-hint UINT — The block number this transaction may be in.
Command
$ cleos get transaction [OPTIONS] <id>
Examples
$ cleos get transaction w234b9...dd76brt5
Transaction ID
Description
The subcommand gets transaction id given transaction object.
Positional Parameters
(string) transaction — The JSON string or filename defining the transaction which transaction ID will be retrieved (required).
Options
No options required for this subcommand.
Command
$ cleos get transaction_id <transaction>
Create
Multisig
Last updated 8 months ago