cleos

Documentation
Search…
INTRODUCTION
USERS
DEVELOPMENT ENVIRONMENT
Cleos Command Reference
Explorer Command Reference
DEVPORTAL
VALIDATORS
cleos
Introduction
cleos is a command line tool that interfaces with the REST API exposed by nodeos. Developers can also use cleos to deploy and test CyberWay smart contracts. To use cleos, you need the end point (IP address and port number) of a running nodeos instance.
Cleos Commands
For a list of all cleos commands, run:
1
$ cleos --help
Copied!
1
Command Line Interface to EOSIO Client
2
Usage: cleos [OPTIONS] SUBCOMMAND
3
​
4
Options:
5
  -h,--help                   Print this help message and exit
6
  -u,--url TEXT=http://127.0.0.1:8888/
7
                              the http/https URL where nodeos is running
8
  --wallet-url TEXT=unix:///user-name/eosio-wallet/keosd.sock
9
                              the http/https URL where keosd is running
10
  -r,--header                 pass specific HTTP header; repeat this option to pass multiple headers
11
  -n,--no-verify              don't verify peer certificate when using HTTPS
12
  --no-auto-keosd             don't automatically launch a keosd if one is not currently running
13
  -v,--verbose                output verbose errors and action console output
14
  --print-request             print HTTP request to STDERR
15
  --print-response            print HTTP response to STDERR
16
​
17
Subcommands:
18
  version                     Retrieve version information
19
  create                      Create various items, on and off the blockchain
20
  convert                     Pack and unpack transactions
21
  resolve                     Resolve domain names and usernames to account
22
  get                         Retrieve various items and information from the blockchain
23
  set                         Set or update blockchain state
24
  transfer                    Transfer tokens from account to account
25
  net                         Interact with local p2p network connections
26
  wallet                      Interact with local wallet
27
  sign                        Sign a transaction
28
  push                        Push arbitrary transactions to the blockchain
29
  multisig                    Multisig contract commands
30
  wrap                        Deprecated. Do nothing.
31
  system                      Send cyber.system contract action to the blockchain.
Copied!
Cleos Subcommands
To get help with any particular subcommand, run cleos SUBCOMMAND --help. For instance:
1
$ cleos create --help
Copied!
1
ERROR: RequiredError: Subcommand required
2
Create various items, on and off the blockchain
3
Usage: cleos create SUBCOMMAND
4
​
5
Subcommands:
6
  key                         Create a new keypair and print the public and private keys
7
  account                     Create a new account on the blockchain
8
                              (assumes system contract does not restrict RAM usage)
Copied!
cleos can also provide usage help for subcommands within subcommands. For instance:
1
$ cleos create account --help
Copied!
1
Create a new account on the blockchain (assumes system contract does not restrict RAM usage)
2
Usage: cleos create account [OPTIONS] creator name OwnerKey [ActiveKey]
3
​
4
Positionals:
5
  creator TEXT                The name of the account creating the new account (required)
6
  name TEXT                   The name of the new account (required)
7
  OwnerKey TEXT               The owner public key or permission level for the new account (required)
8
  ActiveKey TEXT              The active public key or permission level for the new account
9
​
10
Options:
11
  -h,--help                   Print this help message and exit
12
  -x,--expiration             set the time in seconds before a transaction expires, defaults to 30s
13
  -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
14
  -s,--skip-sign              Specify if unlocked wallet keys should be used to sign transaction
15
  -j,--json                   print result as json
16
  -d,--dont-broadcast         don't broadcast transaction to the network (just print to stdout)
17
  --return-packed             used in conjunction with --dont-broadcast to get the packed transaction
18
  -r,--ref-block TEXT         set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
19
  -p,--permission TEXT ...    An account and permission level to authorize, as in '[email protected]' (defaults to '[email protected]')
20
  --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)
21
  --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)
22
  --max-ram-usage UINT        set an upper limit on the ram usage budget, in bytes, for the transaction (defaults to 0 which means no limit)
23
  --max-storage-usage UINT    set an upper limit on the storage usage budget, in bytes, for the transaction (defaults to 0 which means no limit)
24
  --delay-sec UINT            set the delay_sec seconds, defaults to 0s
25
  --bandwidth-provider TEXT ...
26
                              set an account which provide own bandwidth for transaction
27
  --dont-declare-names        don't add `declarenames` action for resolved account names
Copied!
Cleos Example
The following cleos command creates a local wallet named mywallet and displays the password to the screen:
1
cleos wallet create -n mywallet --to-console
Copied!
1
Creating wallet: mywallet
2
Save password to use in the future to unlock this wallet.
3
Without password imported keys will not be retrievable.
4
"GL...4gEE9sUG3D"
Copied!
nodeos
keosd
Last modified 2yr ago
Copy link
Contents