Cleos

 

Subcommands

version client - Retrieve version information of the client

Suggest Edits

version client

Retrieve version information of the client

 

Positionals

none

Usage

$ ./cleos version client
Suggest Edits

convert

Pack and unpack transactions

 

subcommands

Suggest Edits

pack_transaction

From plain signed json to packed form

 

Positionals

  • transaction TEXT - The plain signed json (string)

Options

  • --pack-action-data - Pack all action data within transaction, needs interaction with nodeos

Usage

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": []
}'

Output

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

unpack_transaction

From packed to plain signed json form

 

Positionals

  • transaction TEXT - The packed transaction json (string containing packed_trx and optionally compression fields.)

Options

  • --unpack-action-data - Unpack all action data within transaction, needs interaction with nodeos

Usage

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

Output

{
  "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": []
}
Suggest Edits

pack_action_data

From json action data to packed form

 

Positionals

  • account TEXT - The name of the account that hosts the contract
  • name TEXT - The name of the function that's called by this action
  • unpacked_action_data TEXT - The action data expressed as json

Options

none

Usage

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

Output

000000008090b1ca000000000091b1ca000075982aea3055
Suggest Edits

unpack_action_data

From packed to json action data form

 

Positionals

  • account TEXT - The name of the account that hosts the contract
  • name TEXT - The name of the function that's called by this action
  • packed_action_data TEXT - The action data expressed as packed hex string

Options

Usage

 cleos convert unpack_action_data eosio unlinkauth 000000008090b1ca000000000091b1ca000075982aea3055

Output

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

create

Create various items, on and off the blockchain

 

Subcommands

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

Suggest Edits

create key

Creates a new keypair and prints the public and private keys.

 

Positionals

None

Options

  • --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.

Usage

$ ./cleos create key -f myKey.txt
$ ./cleos create key --to-console

Output



Private key: 5KCkcSxYKZfh5Cr8CCunS2PiUKzNZLhtfBjudaUnad3PDargFQo
Public key: EOS5uHeBsURAT6bBXNtvwKtWaiDSDJSdSmc96rHVws5M1qqVCkAm6
Suggest Edits

create account

Creates a new account on the blockchain (assumes system contract does not restrict RAM usage.)

 

Positionals

  • creator TEXT - The name of the account creating the new account
  • name TEXT - The name of the new account
  • 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
  • -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)
  • -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

Important Note

If the system contract is loaded, (for example a production network) then use cleos system newaccount instead

Usage

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
  -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)
  -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

Command

A set of EOS keys is required to create an account. A set of EOS keys can be generated by using ./cleos create key.

using public keys 

$ ./cleos create account inita tester EOS4toFS3YXEQCkuuw1aqDLrtHim86Gz9u3hBdcBw5KNPZcursVHq EOS7d9A3uLe6As66jzN8j44TXJUqJSK3bFjjEEqR4oTvNAB3iM9SA

using permission levels

$ ./cleos create account eosio eosio.token eosio@active eosio@active

Output

{
  "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": []
      }
    ]
  }
}
Suggest Edits

get

Retrieves various items and information from the blockchain.

 

Subcommands

  • info Get current blockchain information
  • block Retrieve a full block from the blockchain
  • account Retrieve an account from the blockchain
  • code Retrieve the code and ABI for an account
  • abi Retrieve the ABI for an account
  • table Retrieve the contents of a database table
  • scope Retrieve a list of scopes and tables owned by a contract
  • currency Retrieve information related to standard currencies
  • accounts Retrieve accounts associated with a public key
  • servants Retrieve accounts which are servants of a given
  • transaction Retrieve a transaction from the blockchain
  • actions Retrieve all actions with specific account name referenced in authorization or receiver
  • schedule Retrieve the producer schedule
Suggest Edits

get info

Gets current blockchain information.

 

Positionals

This command does not accept any parameters.

Options

This command has no options

Usage

$ ./cleos get info

This command simply returns the current blockchain state information.

{
  "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"
}
Suggest Edits

get block

Retrieves a full block from the blockchain.

 

Positionals

  • block TEXT - The number or ID of the block to retrieve

Options

This command has no options

Usage

$ ./cleos get block 1
$ ./cleos get block
#0000000130d70e94e0022fd2fa035cabb9e542c34ea27f572ac90b5a7aa3d891

This will output a block object similar to the following

{
  "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
}
Suggest Edits

get account

Retrieves an account from the blockchain.

 

Positionals

  • name TEXT - The name of the account to retrieve

Options

  • -j,--json - Output in JSON format

Usage

Get formatted data for user 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>

Get JSON data for user 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"
  }
}
Suggest Edits

get code

Retrieves the code and ABI for an account.

 

Positionals

  • name TEXT - The name of the account whose code should be retrieved

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

Usage

Simply output the hash of eosio.token contract

$ cleos get code eosio.token
code hash: f675e7aeffbf562c033acfaf33eadff255dacb90d002db51c7ad7cbf057eb791

Retrieve and save abi for eosio.token contract

$ cleos get code eosio.token -a eosio.token.abi
code hash: f675e7aeffbf562c033acfaf33eadff255dacb90d002db51c7ad7cbf057eb791
saving abi to eosio.token.abi

Retrieve and save wast code for eosio.token contract

$ cleos get code eosio.token -c eosio.token.wast
code hash: f675e7aeffbf562c033acfaf33eadff255dacb90d002db51c7ad7cbf057eb791
saving wast to eosio.token.wast
Suggest Edits

get table

Retrieves the contents of a database table.

 

Positionals

contract TEXT - The contract who owns the table
scope TEXT - The scope within the contract in which the table is found
table TEXT - The name of the table as specified by the contract abi

Options

-b,--binary UINT - Return the value as BINARY rather than using abi to interpret as JSON
-l,--limit UINT - The maximum number of rows to return
-L,--lower TEXT - JSON representation of lower bound value of key, defaults to first
--show-payer BOOLEAN - show RAM payer (default: false)
-r,--reverse BOOLEAN - Iterate in reverse order (default: false)
-U,--upper TEXT - JSON representation of upper bound value value of key, defaults to last
--index TEXT - Index number, 1 - primary (first), 2 - secondary index (in order defined by multi_index), 3 - third index, etc. Number or name of index can be specified, e.g. 'secondary' or '2'.
--key-type TEXT - The key type of --index, primary only supports (i64), all others support (i64, i128, i256, float64, float128, sha256). Special type 'name' indicates an account name.

Usage

Find the bid name with the lowest bid

cleos get table eosio eosio namebids --key-type i64 --index 2 -r -l 1
{
  "rows": [{
      "newname": "com",
      "high_bidder": "a123",
      "high_bid": 100000,
      "last_bid_time": "1541667021500000"
    }
  ],
  "more": true
}

Or to show all name bids from high to low, including the RAM payer information

cleos get table eosio eosio namebids --key-type i64 --index 2 -r --show-payer
{
  "rows": [{
      "data": {
        "newname": "com",
        "high_bidder": "a123",
        "high_bid": 100000,
        "last_bid_time": "1541667021500000"
      },
      "payer": "a123"
    },{
      "data": {
        "newname": "abc",
        "high_bidder": "a123",
        "high_bid": 110000,
        "last_bid_time": "1541667021500000"
      },
      "payer": "a123"
    },{
      "data": {
        "newname": "ddd",
        "high_bidder": "a123",
        "high_bid": 120000,
        "last_bid_time": "1541667021500000"
      },
      "payer": "a123"
    },{
      "data": {
        "newname": "zoo",
        "high_bidder": "a123",
        "high_bid": 9990000,
        "last_bid_time": "1541667022000000"
      },
      "payer": "a123"
    }
  ],
  "more": false
}
Suggest Edits

get currency

Exposes subcommands for accessing standard currencies.

 

Subcommands

currency balance - Retrieve the balance of an account for a given currency
currency stats - Retrieve the stats of for a given currency

Suggest Edits

get currency balance

Retrieve the balance of an account for a given currency

 

Positionals

contract TEXT - The contract that operates the currency
account TEXT - The account to query balances for
symbol TEXT - The symbol for the currency if the contract operates multiple currencies

Options

There are no options for this subcommand

Usage

Get balance of eosio from eosio.token contract for SYS symbol.

$ cleos get currency balance eosio.token eosio SYS
999999920.0000 SYS
Suggest Edits

get currency stats

Retrieve the stats of for a given currency

 

Positionals

contract TEXT - The contract that operates the currency
symbol TEXT - The symbol for the currency if the contract operates multiple currencies

Options

There are no options for this subcommand

Usage

Get stats of the SYS token from the eosio.token contract.

$ cleos get currency stats eosio.token SYS
{
  "SYS": {
    "supply": "1000000000.0000 SYS",
    "max_supply": "10000000000.0000 SYS",
    "issuer": "eosio"
  }
}
Suggest Edits

get accounts

Retrieves all accounts associated with a defined public key.

 

This command will not return privileged accounts.

Positionals

public_key TEXT - The public key to retrieve accounts for

Options

There are no options for this command

Usage

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

get servants

 

Positionals

  • account Text - Reference account to return accounts created by this account.

Options

There are no options for this command

Usage

$ cleos get servants eosio
Suggest Edits

get transaction

Retrieves a transaction from the blockchain.

 

Positionals

`id`` TEXT - ID of the transaction to retrieve

Options

There are no options for this command

Usage

Command

$ ./cleos get transaction

Output

Example

$ ./cleos get transaction eb4b94b72718a369af09eb2e7885b3f494dd1d8a20278a6634611d5edd76b703
{
  "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": []
      }
    ]
  }
}

Important Note

The above transaction id will not exist on your blockchain

Suggest Edits

get actions

Retrieves all actions with specific account name referenced in their scope.

 

We can also query list of actions that have an account as a receiver. The only accounts queryable are those listed as the receiver in the --filter-on receiver:action:actor option.

Positionals

  • account_name TEXT - name of account to query on

Options

There are no options for this command

Usage

Get actions belonging to eosio, the response you receive will differ.

$ ./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":"useraaaaaaae","to":"useraaaaaaaa","quantity":"0.000...
#  977   2018-06-01T19:54:05.000     eosio.token::transfer => eosio.token   a0c9e5bc... {"from":"useraaaaaaab","to":"useraaaaaaaa","quantity":"0.000...
#  978   2018-06-01T19:54:05.000     eosio.token::transfer => eosio.token   3749d0d1... {"from":"useraaaaaaab","to":"useraaaaaaah","quantity":"0.000...
#  979   2018-06-01T19:54:05.000     eosio.token::transfer => eosio.token   dda205b0... {"from":"useraaaaaaai","to":"useraaaaaaaj","quantity":"0.000...
#  980   2018-06-01T19:54:05.000     eosio.token::transfer => eosio.token   14089e9b... {"from":"useraaaaaaab","to":"useraaaaaaae","quantity":"0.000...
#  981   2018-06-01T19:54:05.000     eosio.token::transfer => eosio.token   6882cefc... {"from":"useraaaaaaaj","to":"useraaaaaaab","quantity":"0.000...
...
Suggest Edits

get abi

Retrieve the ABI for an account

 

Positionals

  • name TEXT - 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

Example

cleos get abi eosio
{
  "version": "eosio::abi/1.1",
  "types": [],
  "structs": [{
      "name": "abi_hash",
      "base": "",
      "fields": [{
          "name": "owner",
          "type": "name"
        },{
          "name": "hash",
          "type": "checksum256"
        }
      ]
    },{
      "name": "authority",
      "base": "",
      "fields": [{
          "name": "threshold",
          "type": "uint32"
        },{
          "name": "keys",
          "type": "key_weight[]"
        },{
          "name": "accounts",
          "type": "permission_level_weight[]"
        },{
          "name": "waits",
          "type": "wait_weight[]"
        }
      ]
    },{
      "name": "bid_refund",
      "base": "",
      "fields": [{
          "name": "bidder",
          "type": "name"
        },{
          "name": "amount",
          "type": "asset"
        }
      ]
    },{
      "name": "bidname",
      "base": "",
      "fields": [{
          "name": "bidder",
          "type": "name"
        },{
          "name": "newname",
          "type": "name"
        },{
          "name": "bid",
          "type": "asset"
        }
      ]
    },{
      "name": "bidrefund",
      "base": "",
      "fields": [{
          "name": "bidder",
          "type": "name"
        },{
          "name": "newname",
          "type": "name"
        }
      ]
    },{
      "name": "block_header",
      "base": "",
      "fields": [{
          "name": "timestamp",
          "type": "uint32"
        },{
          "name": "producer",
          "type": "name"
        },{
          "name": "confirmed",
          "type": "uint16"
        },{
          "name": "previous",
          "type": "checksum256"
        },{
          "name": "transaction_mroot",
          "type": "checksum256"
        },{
          "name": "action_mroot",
          "type": "checksum256"
        },{
          "name": "schedule_version",
          "type": "uint32"
        },{
          "name": "new_producers",
          "type": "producer_schedule?"
        }
      ]
    },{
      "name": "blockchain_parameters",
      "base": "",
      "fields": [{
          "name": "max_block_net_usage",
          "type": "uint64"
        },{
          "name": "target_block_net_usage_pct",
          "type": "uint32"
        },{
          "name": "max_transaction_net_usage",
          "type": "uint32"
        },{
          "name": "base_per_transaction_net_usage",
          "type": "uint32"
        },{
          "name": "net_usage_leeway",
          "type": "uint32"
        },{
          "name": "context_free_discount_net_usage_num",
          "type": "uint32"
        },{
          "name": "context_free_discount_net_usage_den",
          "type": "uint32"
        },{
          "name": "max_block_cpu_usage",
          "type": "uint32"
        },{
          "name": "target_block_cpu_usage_pct",
          "type": "uint32"
        },{
          "name": "max_transaction_cpu_usage",
          "type": "uint32"
        },{
          "name": "min_transaction_cpu_usage",
          "type": "uint32"
        },{
          "name": "max_transaction_lifetime",
          "type": "uint32"
        },{
          "name": "deferred_trx_expiration_window",
          "type": "uint32"
        },{
          "name": "max_transaction_delay",
          "type": "uint32"
        },{
          "name": "max_inline_action_size",
          "type": "uint32"
        },{
          "name": "max_inline_action_depth",
          "type": "uint16"
        },{
          "name": "max_authority_depth",
          "type": "uint16"
        }
      ]
    },{
      "name": "buyram",
      "base": "",
      "fields": [{
          "name": "payer",
          "type": "name"
        },{
          "name": "receiver",
          "type": "name"
        },{
          "name": "quant",
          "type": "asset"
        }
      ]
    },{
      "name": "buyrambytes",
      "base": "",
      "fields": [{
          "name": "payer",
          "type": "name"
        },{
          "name": "receiver",
          "type": "name"
        },{
          "name": "bytes",
          "type": "uint32"
        }
      ]
    },{
      "name": "canceldelay",
      "base": "",
      "fields": [{
          "name": "canceling_auth",
          "type": "permission_level"
        },{
          "name": "trx_id",
          "type": "checksum256"
        }
      ]
    },{
      "name": "claimrewards",
      "base": "",
      "fields": [{
          "name": "owner",
          "type": "name"
        }
      ]
    },{
      "name": "connector",
      "base": "",
      "fields": [{
          "name": "balance",
          "type": "asset"
        },{
          "name": "weight",
          "type": "float64"
        }
      ]
    },{
      "name": "delegatebw",
      "base": "",
      "fields": [{
          "name": "from",
          "type": "name"
        },{
          "name": "receiver",
          "type": "name"
        },{
          "name": "stake_net_quantity",
          "type": "asset"
        },{
          "name": "stake_cpu_quantity",
          "type": "asset"
        },{
          "name": "transfer",
          "type": "bool"
        }
      ]
    },{
      "name": "delegated_bandwidth",
      "base": "",
      "fields": [{
          "name": "from",
          "type": "name"
        },{
          "name": "to",
          "type": "name"
        },{
          "name": "net_weight",
          "type": "asset"
        },{
          "name": "cpu_weight",
          "type": "asset"
        }
      ]
    },{
      "name": "deleteauth",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "permission",
          "type": "name"
        }
      ]
    },{
      "name": "eosio_global_state",
      "base": "blockchain_parameters",
      "fields": [{
          "name": "max_ram_size",
          "type": "uint64"
        },{
          "name": "total_ram_bytes_reserved",
          "type": "uint64"
        },{
          "name": "total_ram_stake",
          "type": "int64"
        },{
          "name": "last_producer_schedule_update",
          "type": "block_timestamp_type"
        },{
          "name": "last_pervote_bucket_fill",
          "type": "time_point"
        },{
          "name": "pervote_bucket",
          "type": "int64"
        },{
          "name": "perblock_bucket",
          "type": "int64"
        },{
          "name": "total_unpaid_blocks",
          "type": "uint32"
        },{
          "name": "total_activated_stake",
          "type": "int64"
        },{
          "name": "thresh_activated_stake_time",
          "type": "time_point"
        },{
          "name": "last_producer_schedule_size",
          "type": "uint16"
        },{
          "name": "total_producer_vote_weight",
          "type": "float64"
        },{
          "name": "last_name_close",
          "type": "block_timestamp_type"
        }
      ]
    },{
      "name": "eosio_global_state2",
      "base": "",
      "fields": [{
          "name": "new_ram_per_block",
          "type": "uint16"
        },{
          "name": "last_ram_increase",
          "type": "block_timestamp_type"
        },{
          "name": "last_block_num",
          "type": "block_timestamp_type"
        },{
          "name": "total_producer_votepay_share",
          "type": "float64"
        },{
          "name": "revision",
          "type": "uint8"
        }
      ]
    },{
      "name": "eosio_global_state3",
      "base": "",
      "fields": [{
          "name": "last_vpay_state_update",
          "type": "time_point"
        },{
          "name": "total_vpay_share_change_rate",
          "type": "float64"
        }
      ]
    },{
      "name": "exchange_state",
      "base": "",
      "fields": [{
          "name": "supply",
          "type": "asset"
        },{
          "name": "base",
          "type": "connector"
        },{
          "name": "quote",
          "type": "connector"
        }
      ]
    },{
      "name": "init",
      "base": "",
      "fields": [{
          "name": "version",
          "type": "varuint32"
        },{
          "name": "core",
          "type": "symbol"
        }
      ]
    },{
      "name": "key_weight",
      "base": "",
      "fields": [{
          "name": "key",
          "type": "public_key"
        },{
          "name": "weight",
          "type": "uint16"
        }
      ]
    },{
      "name": "linkauth",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "code",
          "type": "name"
        },{
          "name": "type",
          "type": "name"
        },{
          "name": "requirement",
          "type": "name"
        }
      ]
    },{
      "name": "name_bid",
      "base": "",
      "fields": [{
          "name": "newname",
          "type": "name"
        },{
          "name": "high_bidder",
          "type": "name"
        },{
          "name": "high_bid",
          "type": "int64"
        },{
          "name": "last_bid_time",
          "type": "time_point"
        }
      ]
    },{
      "name": "newaccount",
      "base": "",
      "fields": [{
          "name": "creator",
          "type": "name"
        },{
          "name": "name",
          "type": "name"
        },{
          "name": "owner",
          "type": "authority"
        },{
          "name": "active",
          "type": "authority"
        }
      ]
    },{
      "name": "onblock",
      "base": "",
      "fields": [{
          "name": "header",
          "type": "block_header"
        }
      ]
    },{
      "name": "onerror",
      "base": "",
      "fields": [{
          "name": "sender_id",
          "type": "uint128"
        },{
          "name": "sent_trx",
          "type": "bytes"
        }
      ]
    },{
      "name": "permission_level",
      "base": "",
      "fields": [{
          "name": "actor",
          "type": "name"
        },{
          "name": "permission",
          "type": "name"
        }
      ]
    },{
      "name": "permission_level_weight",
      "base": "",
      "fields": [{
          "name": "permission",
          "type": "permission_level"
        },{
          "name": "weight",
          "type": "uint16"
        }
      ]
    },{
      "name": "producer_info",
      "base": "",
      "fields": [{
          "name": "owner",
          "type": "name"
        },{
          "name": "total_votes",
          "type": "float64"
        },{
          "name": "producer_key",
          "type": "public_key"
        },{
          "name": "is_active",
          "type": "bool"
        },{
          "name": "url",
          "type": "string"
        },{
          "name": "unpaid_blocks",
          "type": "uint32"
        },{
          "name": "last_claim_time",
          "type": "time_point"
        },{
          "name": "location",
          "type": "uint16"
        }
      ]
    },{
      "name": "producer_info2",
      "base": "",
      "fields": [{
          "name": "owner",
          "type": "name"
        },{
          "name": "votepay_share",
          "type": "float64"
        },{
          "name": "last_votepay_share_update",
          "type": "time_point"
        }
      ]
    },{
      "name": "producer_key",
      "base": "",
      "fields": [{
          "name": "producer_name",
          "type": "name"
        },{
          "name": "block_signing_key",
          "type": "public_key"
        }
      ]
    },{
      "name": "producer_schedule",
      "base": "",
      "fields": [{
          "name": "version",
          "type": "uint32"
        },{
          "name": "producers",
          "type": "producer_key[]"
        }
      ]
    },{
      "name": "refund",
      "base": "",
      "fields": [{
          "name": "owner",
          "type": "name"
        }
      ]
    },{
      "name": "refund_request",
      "base": "",
      "fields": [{
          "name": "owner",
          "type": "name"
        },{
          "name": "request_time",
          "type": "time_point_sec"
        },{
          "name": "net_amount",
          "type": "asset"
        },{
          "name": "cpu_amount",
          "type": "asset"
        }
      ]
    },{
      "name": "regproducer",
      "base": "",
      "fields": [{
          "name": "producer",
          "type": "name"
        },{
          "name": "producer_key",
          "type": "public_key"
        },{
          "name": "url",
          "type": "string"
        },{
          "name": "location",
          "type": "uint16"
        }
      ]
    },{
      "name": "regproxy",
      "base": "",
      "fields": [{
          "name": "proxy",
          "type": "name"
        },{
          "name": "isproxy",
          "type": "bool"
        }
      ]
    },{
      "name": "rmvproducer",
      "base": "",
      "fields": [{
          "name": "producer",
          "type": "name"
        }
      ]
    },{
      "name": "sellram",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "bytes",
          "type": "int64"
        }
      ]
    },{
      "name": "setabi",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "abi",
          "type": "bytes"
        }
      ]
    },{
      "name": "setacctcpu",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "cpu_weight",
          "type": "int64?"
        }
      ]
    },{
      "name": "setacctnet",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "net_weight",
          "type": "int64?"
        }
      ]
    },{
      "name": "setacctram",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "ram_bytes",
          "type": "int64?"
        }
      ]
    },{
      "name": "setalimits",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "ram_bytes",
          "type": "int64"
        },{
          "name": "net_weight",
          "type": "int64"
        },{
          "name": "cpu_weight",
          "type": "int64"
        }
      ]
    },{
      "name": "setcode",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "vmtype",
          "type": "uint8"
        },{
          "name": "vmversion",
          "type": "uint8"
        },{
          "name": "code",
          "type": "bytes"
        }
      ]
    },{
      "name": "setparams",
      "base": "",
      "fields": [{
          "name": "params",
          "type": "blockchain_parameters"
        }
      ]
    },{
      "name": "setpriv",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "is_priv",
          "type": "uint8"
        }
      ]
    },{
      "name": "setram",
      "base": "",
      "fields": [{
          "name": "max_ram_size",
          "type": "uint64"
        }
      ]
    },{
      "name": "setramrate",
      "base": "",
      "fields": [{
          "name": "bytes_per_block",
          "type": "uint16"
        }
      ]
    },{
      "name": "undelegatebw",
      "base": "",
      "fields": [{
          "name": "from",
          "type": "name"
        },{
          "name": "receiver",
          "type": "name"
        },{
          "name": "unstake_net_quantity",
          "type": "asset"
        },{
          "name": "unstake_cpu_quantity",
          "type": "asset"
        }
      ]
    },{
      "name": "unlinkauth",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "code",
          "type": "name"
        },{
          "name": "type",
          "type": "name"
        }
      ]
    },{
      "name": "unregprod",
      "base": "",
      "fields": [{
          "name": "producer",
          "type": "name"
        }
      ]
    },{
      "name": "updateauth",
      "base": "",
      "fields": [{
          "name": "account",
          "type": "name"
        },{
          "name": "permission",
          "type": "name"
        },{
          "name": "parent",
          "type": "name"
        },{
          "name": "auth",
          "type": "authority"
        }
      ]
    },{
      "name": "updtrevision",
      "base": "",
      "fields": [{
          "name": "revision",
          "type": "uint8"
        }
      ]
    },{
      "name": "user_resources",
      "base": "",
      "fields": [{
          "name": "owner",
          "type": "name"
        },{
          "name": "net_weight",
          "type": "asset"
        },{
          "name": "cpu_weight",
          "type": "asset"
        },{
          "name": "ram_bytes",
          "type": "int64"
        }
      ]
    },{
      "name": "voteproducer",
      "base": "",
      "fields": [{
          "name": "voter",
          "type": "name"
        },{
          "name": "proxy",
          "type": "name"
        },{
          "name": "producers",
          "type": "name[]"
        }
      ]
    },{
      "name": "voter_info",
      "base": "",
      "fields": [{
          "name": "owner",
          "type": "name"
        },{
          "name": "proxy",
          "type": "name"
        },{
          "name": "producers",
          "type": "name[]"
        },{
          "name": "staked",
          "type": "int64"
        },{
          "name": "last_vote_weight",
          "type": "float64"
        },{
          "name": "proxied_vote_weight",
          "type": "float64"
        },{
          "name": "is_proxy",
          "type": "bool"
        },{
          "name": "flags1",
          "type": "uint32"
        },{
          "name": "reserved2",
          "type": "uint32"
        },{
          "name": "reserved3",
          "type": "asset"
        }
      ]
    },{
      "name": "wait_weight",
      "base": "",
      "fields": [{
          "name": "wait_sec",
          "type": "uint32"
        },{
          "name": "weight",
          "type": "uint16"
        }
      ]
    }
  ],
  "actions": [{
      "name": "bidname",
      "type": "bidname",
      "ricardian_contract": "# Action - `{{ bidname }}`\n\n## Description\n\nThe `{{ bidname }}` action places a bid on a premium account name, in the knowledge that the high bid will purchase the name.\n\nAs an authorized party I {{ signer }} wish to bid on behalf of {{ bidder }} the amount of {{ bid }} toward purchase of the account name {{ newname }}.\n"
    },{
      "name": "bidrefund",
      "type": "bidrefund",
      "ricardian_contract": ""
    },{
      "name": "buyram",
      "type": "buyram",
      "ricardian_contract": "# Action - `{{ buyram }}`\n\n### Description\n\nThis action will attempt to reserve about {{quant}} worth of RAM on behalf of {{receiver}}. \n\n{{buyer}} authorizes this contract to transfer {{quant}} to buy RAM based upon the current price as determined by the market maker algorithm.\n\n{{buyer}} accepts that a 0.5% fee will be charged on the amount spent and that the actual RAM received may be slightly less than expected due to the approximations necessary to enable this service.\n{{buyer}} accepts that a 0.5% fee will be charged if and when they sell the RAM received.\n{{buyer}} accepts that rounding errors resulting from limits of computational precision may result in less RAM being allocated.\n{{buyer}} acknowledges that the supply of RAM may be increased at any time up to the limits of off-the-shelf computer equipment and that this may result in RAM selling for less than purchase price.\n{{buyer}} acknowledges that the price of RAM may increase or decrease over time according to supply and demand.\n{{buyer}} acknowledges that RAM is non-transferrable. \n{{buyer}} acknowledges RAM currently in use by their account cannot be sold until it is freed and that freeing RAM may be subject to terms of other contracts.\n\n"
    },{
      "name": "buyrambytes",
      "type": "buyrambytes",
      "ricardian_contract": "# Action - `{{ buyrambytes }}`\n\n### Description\n\nThis action will attempt to reserve about {{bytes}} bytes of RAM on behalf of {{receiver}}. \n\n{{buyer}} authorizes this contract to transfer sufficient EOS tokens to buy the RAM based upon the current price as determined by the market maker algorithm.\n\n{{buyer}} accepts that a 0.5% fee will be charged on the EOS spent and that the actual RAM received may be slightly less than requested due to the approximations necessary to enable this service.\n{{buyer}} accepts that a 0.5% fee will be charged if and when they sell the RAM received.\n{{buyer}} accepts that rounding errors resulting from limits of computational precision may result in less RAM being allocated.\n{{buyer}} acknowledges that the supply of RAM may be increased at any time up to the limits of off-the-shelf computer equipment and that this may result in RAM selling for less than purchase price.\n{{buyer}} acknowledges that the price of RAM may increase or decrease over time according to supply and demand.\n{{buyer}} acknowledges that RAM is non-transferable. \n{{buyer}} acknowledges RAM currently in use by their account cannot be sold until it is freed and that freeing RAM may be subject to terms of other contracts.\n\n"
    },{
      "name": "canceldelay",
      "type": "canceldelay",
      "ricardian_contract": "# Action - `{{ canceldelay }}`\n\n### Description\n\nThe `{{ canceldelay }}` action cancels an existing delayed transaction.\n\nAs an authorized party I {{ signer }} wish to invoke the authority of {{ canceling_auth }} to cancel the transaction with ID {{ trx_id }}.\n"
    },{
      "name": "claimrewards",
      "type": "claimrewards",
      "ricardian_contract": "# Action - `{{ claimrewards }}`\n\n## Description\n\nThe `{{ claimrewards }}` action allows a block producer (active or standby) to claim the system rewards due them for producing blocks and receiving votes.\n\nAs an authorized party I {{ signer }} wish to have the rewards earned by {{ owner }} deposited into the {{ owner }} account.\n"
    },{
      "name": "delegatebw",
      "type": "delegatebw",
      "ricardian_contract": "# Action - `{{ delegatebw }}`\n\n## Description\n\nThe intent of the `{{ delegatebw }}` action is to stake tokens for bandwidth and/or CPU and optionally transfer ownership.\n\nAs an authorized party I {{ signer }} wish to stake {{ stake_cpu_quantity }} for CPU and {{ stake_net_quantity }} for bandwidth from the liquid tokens of {{ from }} for the use of delegatee {{ to }}. \n  \n    {{if transfer }}\n    \nIt is {{ transfer }} that I wish these tokens to become immediately owned by the delegatee.\n \n    {{/if}}\n\nAs signer I stipulate that, if I am not the beneficial owner of these tokens, I have proof that Iu2019ve been authorized to take this action by their beneficial owner(s). \n"
    },{
      "name": "deleteauth",
      "type": "deleteauth",
      "ricardian_contract": ""
    },{
      "name": "init",
      "type": "init",
      "ricardian_contract": ""
    },{
      "name": "linkauth",
      "type": "linkauth",
      "ricardian_contract": ""
    },{
      "name": "newaccount",
      "type": "newaccount",
      "ricardian_contract": "# Action - `{{ newaccount }}`\n\n### Description\n\nThe `{{ newaccount }}` action creates a new account.\n\nAs an authorized party I {{ signer }} wish to exercise the authority of {{ creator }} to create a new account on this system named {{ name }} such that the new account's owner public key shall be {{ owner }} and the active public key shall be {{ active }}.\n"
    },{
      "name": "onblock",
      "type": "onblock",
      "ricardian_contract": ""
    },{
      "name": "onerror",
      "type": "onerror",
      "ricardian_contract": ""
    },{
      "name": "refund",
      "type": "refund",
      "ricardian_contract": "# Action - `{{ refund }}`\n\n### Description\n\nThe intent of the `{{ refund }}` action is to return previously unstaked tokens to an account after the unstaking period has elapsed. \n\nAs an authorized party I {{ signer }} wish to have the unstaked tokens of {{ owner }} returned.\n"
    },{
      "name": "regproducer",
      "type": "regproducer",
      "ricardian_contract": "# Action - `{{ regproducer }}`\n\n## Description\n\nThe intent of the `{{ regproducer }}` action is to register an account as a BP candidate.\n\nI, {{producer}}, hereby nominate myself for consideration as an elected block producer.\n\nIf {{producer}} is selected to produce blocks by the eosio contract, I will sign blocks with {{producer_key}} and I hereby attest that I will keep this key secret and secure.\n\nIf {{producer}} is unable to perform obligations under this contract I will resign my position by resubmitting this contract with the null producer key.\n\nI acknowledge that a block is 'objectively valid' if it conforms to the deterministic blockchain rules in force at the time of its creation, and is 'objectively invalid' if it fails to conform to those rules.\n\n{{producer}} hereby agrees to only use {{producer_key}} to sign messages under the following scenarios:\nproposing an objectively valid block at the time appointed by the block scheduling algorithm\npre-confirming a block produced by another producer in the schedule when I find said block objectively valid\nconfirming a block for which {{producer}} has received 2/3+ pre-confirmation messages from other producers\n\nI hereby accept liability for any and all provable damages that result from my:\nsigning two different block proposals with the same timestamp with {{producer_key}}\nsigning two different block proposals with the same block number with {{producer_key}}\nsigning any block proposal which builds off of an objectively invalid block\nsigning a pre-confirmation for an objectively invalid block\nsigning a confirmation for a block for which I do not possess pre-confirmation messages from 2/3+ other producers\n\nI hereby agree that double-signing for a timestamp or block number in concert with 2 or more other producers shall automatically be deemed malicious and subject to a fine equal to the past year of compensation received and imediate disqualification from being a producer, and other damages. An exception may be made if {{producer}} can demonstrate that the double-signing occured due to a bug in the reference software; the burden of proof is on {{producer}}.\n\nI hereby agree not to interfere with the producer election process. I agree to process all producer election transactions that occur in blocks I create, to sign all objectively valid blocks I create that contain election transactions, and to sign all pre-confirmations and confirmations necessary to facilitate transfer of control to the next set of producers as determined by the system contract.\n\nI hereby acknowledge that 2/3+ other elected producers may vote to disqualify {{producer}} in the event {{producer}} is unable to produce blocks or is unable to be reached, according to criteria agreed to among producers.\n\nIf {{producer}} qualifies for and chooses to collect compensation due to votes received, {{producer}} will provide a public endpoint allowing at least 100 peers to maintain synchronization with the blockchain and/or submit transactions to be included. {{producer}} shall maintain at least 1 validating node with full state and signature checking and shall report any objectively invalid blocks produced by the active block producers. Reporting shall be via a method to be agreed to among producers, said method and reports to be made public.\n\nThe community agrees to allow {{producer}} to authenticate peers as necessary to prevent abuse and denial of service attacks; however, {{producer}} agrees not to discriminate against non-abusive peers.\n\nI agree to process transactions on a FIFO best-effort basis and to honestly bill transactions for measured execution time.\n\nI {{producer}} agree not to manipulate the contents of blocks in order to derive profit from:\nthe order in which transactions are included\nthe hash of the block that is produced\n\nI, {{producer}}, hereby agree to disclose and attest under penalty of perjury all ultimate beneficial owners of my company who own more than 10% and all direct shareholders.\n\nI, {{producer}}, hereby agree to cooperate with other block producers to carry out our respective and mutual obligations under this agreement, including but not limited to maintaining network stability and a valid blockchain.\n\nI, {{producer}}, agree to maintain a website hosted at {{url}} which contains up-to-date information on all disclosures required by this contract.\n\nI, {{producer}}, agree to set {{location}} such that {{producer}} is scheduled with minimal latency between my previous and next peer.\n\nI, {{producer}}, agree to maintain time synchronization within 10 ms of global atomic clock time, using a method agreed to among producers.\n\nI, {{producer}}, agree not to produce blocks before my scheduled time unless I have received all blocks produced by the prior producer.\n\nI, {{producer}}, agree not to publish blocks with timestamps more than 500ms in the future unless the prior block is more than 75% full by either CPU or network bandwidth metrics.\n\nI, {{producer}}, agree not to set the RAM supply to more RAM than my nodes contain and to resign if I am unable to provide the RAM approved by 2/3+ producers, as shown in the system parameters.\n"
    },{
      "name": "regproxy",
      "type": "regproxy",
      "ricardian_contract": ""
    },{
      "name": "rmvproducer",
      "type": "rmvproducer",
      "ricardian_contract": ""
    },{
      "name": "sellram",
      "type": "sellram",
      "ricardian_contract": "# Action - `{{ sellram }}`\n\n## Description\n\nThe `{{ sellram }}` action sells unused RAM for tokens.\n\nAs an authorized party I {{ signer }} wish to sell {{ bytes }} of unused RAM from account {{ account }}. \n"
    },{
      "name": "setabi",
      "type": "setabi",
      "ricardian_contract": ""
    },{
      "name": "setacctcpu",
      "type": "setacctcpu",
      "ricardian_contract": ""
    },{
      "name": "setacctnet",
      "type": "setacctnet",
      "ricardian_contract": ""
    },{
      "name": "setacctram",
      "type": "setacctram",
      "ricardian_contract": ""
    },{
      "name": "setalimits",
      "type": "setalimits",
      "ricardian_contract": ""
    },{
      "name": "setcode",
      "type": "setcode",
      "ricardian_contract": ""
    },{
      "name": "setparams",
      "type": "setparams",
      "ricardian_contract": ""
    },{
      "name": "setpriv",
      "type": "setpriv",
      "ricardian_contract": ""
    },{
      "name": "setram",
      "type": "setram",
      "ricardian_contract": ""
    },{
      "name": "setramrate",
      "type": "setramrate",
      "ricardian_contract": ""
    },{
      "name": "undelegatebw",
      "type": "undelegatebw",
      "ricardian_contract": "# Action - `{{ undelegatebw }}`\n\n## Description\n\nThe intent of the `{{ undelegatebw }}` action is to unstake tokens from CPU and/or bandwidth. \n\nAs an authorized party I {{ signer }} wish to unstake {{ unstake_cpu_quantity }} from CPU and {{ unstake_net_quantity }} from bandwidth from the tokens owned by {{ from }} previously delegated for the use of delegatee {{ to }}. \n\nIf I as signer am not the beneficial owner of these tokens I stipulate I have proof that Iu2019ve been authorized to take this action by their beneficial owner(s). \n"
    },{
      "name": "unlinkauth",
      "type": "unlinkauth",
      "ricardian_contract": ""
    },{
      "name": "unregprod",
      "type": "unregprod",
      "ricardian_contract": "# Action - `{{ unregprod }}`\n\n## Description\n\nThe `{{ unregprod }}` action unregisters a previously registered block producer candidate.\n\nAs an authorized party I {{ signer }} wish to unregister the block producer candidate {{ producer }}, rendering that candidate no longer able to receive votes.\n"
    },{
      "name": "updateauth",
      "type": "updateauth",
      "ricardian_contract": ""
    },{
      "name": "updtrevision",
      "type": "updtrevision",
      "ricardian_contract": ""
    },{
      "name": "voteproducer",
      "type": "voteproducer",
      "ricardian_contract": "# Action - `{{ voteproducer }}`\n\n## Description\n\nThe intent of the `{{ voteproducer }}` action is to cast a valid vote for up to 30 BP candidates. \n\nAs an authorized party I {{ signer }} wish to vote on behalf of {{ voter }} in favor of the block producer candidates {{ producers }} with a voting weight equal to all tokens currently owned by {{ voter }} and staked for CPU or bandwidth. \n\nIf I am not the beneficial owner of these shares I stipulate I have proof that Iu2019ve been authorized to vote these shares by their beneficial owner(s). \n\nI stipulate I have not and will not accept anything of value in exchange for these votes, on penalty of confiscation of these tokens, and other penalties. \n\nI acknowledge that using any system of automatic voting, re-voting, or vote refreshing, or allowing such a system to be used on my behalf or on behalf of another, is forbidden and doing so violates this contract.\n"
    }
  ],
  "tables": [{
      "name": "abihash",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "abi_hash"
    },{
      "name": "bidrefunds",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "bid_refund"
    },{
      "name": "delband",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "delegated_bandwidth"
    },{
      "name": "global",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "eosio_global_state"
    },{
      "name": "global2",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "eosio_global_state2"
    },{
      "name": "global3",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "eosio_global_state3"
    },{
      "name": "namebids",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "name_bid"
    },{
      "name": "producers",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "producer_info"
    },{
      "name": "producers2",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "producer_info2"
    },{
      "name": "rammarket",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "exchange_state"
    },{
      "name": "refunds",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "refund_request"
    },{
      "name": "userres",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "user_resources"
    },{
      "name": "voters",
      "index_type": "i64",
      "key_names": [],
      "key_types": [],
      "type": "voter_info"
    }
  ],
  "ricardian_clauses": [{
      "id": "constitution",
      "body": "This Constitution is a multi-party contract entered into by the Members by virtue of their use of this blockchain.\n\n# Article I - No Initiation of Violence\nMembers shall not initiate violence or the threat of violence against another Member. Lawful prosecution of crimes with the goal of preserving life, liberty and property does not constitute initiation of violence.\n\n# Article II - No Perjury\nMembers shall be liable for losses caused by false or misleading attestations and shall forfeit any profit gained thereby.\n\n# Article III - Rights\nThe Members grant the right of contract and of private property to each other, therefore no property shall change hands except with the consent of the owner, by a valid Arbitratoru2019s order, or via community referendum. This Constitution creates no positive rights for or between any Members.\n\n# Article IV - No Vote Buying\nNo Member shall offer nor accept anything of value in exchange for a vote of any type, nor shall any Member unduly influence the vote of another.\n\n# Article V - No Fiduciary\nNo Member nor EOS token holder shall have fiduciary responsibility to support the value of the EOS token. The Members do not authorize anyone to hold assets, borrow, nor contract on behalf of EOS token holders collectively. This blockchain has no owners, managers or fiduciaries; therefore, no Member shall have beneficial interest in more than 10% of the EOS token supply.\n\n# Article VI - Restitution\nEach Member agrees that penalties for breach of contract may include, but are not limited to, fines, loss of account, and other restitution.\n\n# Article VII - Open Source\nEach Member who makes available a smart contract on this blockchain shall be a Developer. Each Developer shall offer their smart contracts via a free and open source license, and each smart contract shall be documented with a Ricardian Contract stating the intent of all parties and naming the Arbitration Forum that will resolve disputes arising from that contract.\n\n# Article VIII - Language\nMulti-lingual contracts must specify one prevailing language in case of dispute and the author of any translation shall be liable for losses due to their false, misleading, or ambiguous attested translations.\n\n# Article IX - Dispute Resolution\nAll disputes arising out of or in connection with this Constitution shall be finally settled under the Rules of Dispute Resolution of the EOS Core Arbitration Forum by one or more arbitrators appointed in accordance with the said Rules.\n\n# Article X - Choice of Law\nChoice of law for disputes shall be, in order of precedence, this Constitution and the Maxims of Equity.\n\n# Article XI - Amending\nThis Constitution and its subordinate documents shall not be amended except by a vote of the token holders with no less than 15% vote participation among tokens and no fewer than 10% more Yes than No votes, sustained for 30 continuous days within a 120 day period.\n\n# Article XII - Publishing\nMembers may only publish information to the Blockchain that is within their right to publish. Furthermore, Members voluntarily consent for all Members to permanently and irrevocably retain a copy, analyze, and distribute all broadcast transactions and derivative information.\n\n# Article XIII - Informed Consent\nAll service providers who produce tools to facilitate the construction and signing of transactions on behalf of other Members shall present to said other Members the full Ricardian contract terms of this Constitution and other referenced contracts. Service providers shall be liable for losses resulting from failure to disclose the full Ricardian contract terms to users.\n\n# Article XIV - Severability\nIf any part of this Constitution is declared unenforceable or invalid, the remainder will continue to be valid and enforceable.\n\n# Article XV - Termination of Agreement\nA Member is automatically released from all revocable obligations under this Constitution 3 years after the last transaction signed by that Member is incorporated into the blockchain. After 3 years of inactivity an account may be put up for auction and the proceeds distributed to all Members according to the system contract provisions then in effect for such redistribution.\n\n# Article XVI - Developer Liability\nMembers agree to hold software developers harmless for unintentional mistakes made in the expression of contractual intent, whether or not said mistakes were due to actual or perceived negligence.\n\n# Article XVII - Consideration\nAll rights and obligations under this Constitution are mutual and reciprocal and of equally significant value and cost to all parties.\n\n# Article XVIII - Acceptance\nA contract is deemed accepted when a member signs a transaction which incorporates a TAPOS proof of a block whose implied state incorporates an ABI of said contract and said transaction is incorporated into the blockchain.\n\n# Article XIX - Counterparts\nThis Constitution may be executed in any number of counterparts, each of which when executed and delivered shall constitute a duplicate original, but all counterparts together shall constitute a single agreement.\n\n# Article XX - Interim Constitution\nThis constitution is interim and is intended to remain in effect until a permanent constitution is written and ratified in a referendum.\n"
    }
  ],
  "error_messages": [],
  "abi_extensions": [],
  "variants": []
}
Suggest Edits

get schedule

Retrieve the producer schedule

 

Positionals

This command does not accept any parameters.

Options

  • -h,--help - Print this help message and exit
  • -j,--json - Output in JSON format

Example

cleos get schedule
active schedule version 695
    Producer      Producer key
    ============= ==================
    atticlabeosb  EOS7PfA3A4UdfMu2wKbuXdbHn8EWAxbMnFoFWui4X2zsr2oPwdQJP
    bitfinexeos1  EOS4tkw7LgtURT3dvG3kQ4D1sg3aAtPDymmoatpuFkQMc7wzZdKxc
    cochainworld  EOS5QDSQyh96SmktA28dteEchc1QCVdqKYG4YVDHGGATMYxqy33wi
    eos42freedom  EOS4tw7vH62TcVtMgm2tjXzn9hTuHEBbGPUK2eos42ssY7ip4LTzu
    eosauthority  EOS4va3CTmAcAAXsT26T3EBWqYHgQLshyxsozYRgxWm9tjmy17pVV
    eosbeijingbp  EOS5dGpcEhwB4VEhhXEcqtZs9EQj5HeetuXDnsAGVHMXHAFdMjbdj
    eosbixinboot  EOS7QC1XfAtkYeLjbHQjcDWVqUsxuSJ3YRhNyG93VAv2u3uHopGVp
    eoscanadacom  EOS7eycxAbCtKyfoJc8uRZcmt1AmArjXcz8aonLUTzahk5rHc18NJ
    eoscannonchn  EOS73cTi9V7PNg4ujW5QzoTfRSdhH44MPiUJkUV6m3oGwj7RX7kML
    eosflytomars  EOS6Agpfp38bTyRjJDmB4Qb1EpQSq7wnEAsALXgXE7KFSzKjokkFD
    eoshenzhenio  EOS8EJrMphgHJx5EkHQ4ryodbvnocZEC1xp5T1FnRsT7XtzYA1FE7
    eoshuobipool  EOS5XKswW26cR5VQeDGwgNb5aixv1AMcKkdDNrC59KzNSBfnH6TR7
    eosiosg11111  EOS7zVBQMhV7dZ5zRQwBgDmmbFCHA6YcmwW6Dq5CePGpqLR1ZsVAc
    eoslaomaocom  EOS8QgURqo875qu3a8vgZ58qBeu2cTehe9zAWRfpdCXAQipicu1Fi
    eosliquideos  EOS4v1n2j5kXbCum8LLEc8zQLpeLK9rKVFmsUgLCWgMDN38P6PcrW
    eosnationftw  EOS5x4RBDk7ekzKp8ixsntAxWoQjMG1eRxKh1LSDH6UCX7TsyxTEr
    eosnewyorkio  EOS6GVX8eUqC1gN1293B3ivCNbifbr1BT6gzTFaQBXzWH9QNKVM4X
    eosriobrazil  EOS7RioGoHQnhv2fJEiciP9Q7J8JgfJYFcyofVkmCqMop8Q1PzgqP
    jedaaaaaaaaa  EOS6nB9Ar5sghWjqk27bszCiA9zxQtXZCaAaEkf2nwUm9iP5MEJTT
    starteosiobp  EOS4wZZXm994byKANLuwHD6tV3R3Mu3ktc41aSVXCBaGnXJZJ4pwF
    zbeosbp11111  EOS7rhgVPWWyfMqjSbNdndtCK8Gkza3xnDbUupsPLMZ6gjfQ4nX81

pending schedule empty

proposed schedule empty
Suggest Edits

get transaction_id

Get transaction id given transaction object

 

Positionals

  • transaction TEXT - The JSON string or filename defining the transaction for which transaction id we want to retrieve (required). The JSON file must contain a packed transaction for it to function correctly.

Options

  • -h,--help - Print this help message and exit

Usage

cleos get transaction_id ./ptrx.json
374708fff7719dd5979ec875d56cd2286f6d3cf7ec317a3b25632aab28ec37bb

Description

Sets or updates the blockchain state.

Commands

  • [code] Create or update the code on an account
    abi Create or update the abi on an account
    contract Create or update the contract on an account
    account set or update blockchain account state
    action set or update blockchain action state
Suggest Edits

set contract

Creates or updates the contract on an account.

 

Positionals

  • account TEXT - The account to publish a contract for
  • contract-dir TEXT - The path containing the .wasm and .abi
  • wast-file TEXT - The file containing the contract or .wasm
  • abi-file TEXT - The .abi for the contract

Options

  • -h,--help Print this help message and exit
  • -a,--abi TEXT - The ABI for the contract
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

Here we deploy the standard currency contract.

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

This will output something similar to...

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": "00000079b822651d0000e8150061736d0100000001390a60017e0060037e7e7f017f60047e7e7f7f017f60017f0060057e7e7e7f7f017f60027f7f0060027f7f017f60027e7f0060000060027e7e00029d010a03656e7606617373657274000503656e76086c6f61645f693634000403656e76067072696e7469000003656e76067072696e746e000003656e76067072696e7473000303656e760b726561644d657373616765000603656e760a72656d6f76655f693634000103656e760b7265717569726541757468000003656e760d726571756972654e6f74696365000003656e760973746f72655f6936340002030706000007030809040401700000050301000107cc0107066d656d6f72790200205f5a4e33656f733133726571756972654e6f74696365454e535f344e616d6545000a1e5f5a4e33656f7331317265717569726541757468454e535f344e616d6545000b345f5a4e3863757272656e6379313273746f72654163636f756e74454e33656f73344e616d6545524b4e535f374163636f756e7445000c355f5a4e3863757272656e637932336170706c795f63757272656e63795f7472616e7366657245524b4e535f385472616e7366657245000d04696e6974000e056170706c79000f0a9d0d060600200010080b0600200010070b3400024020012903084200510d0020004280808080a8d7bee3082001411010091a0f0b20004280808080a8d7bee308200110061a0b8a0604017e027f047e017f4100410028020441206b2208360204200029030821052000290300210720002903102104411010042004100241c000100442808080c887d7c8b21d100341d00010042007100341e000100420051003200029030021052000290308100820051008200029030010072000290300210142002105423b210441f00021034200210603400240024002400240024020054206560d0020032c00002202419f7f6a41ff017141194b0d01200241a0016a21020c020b420021072005420b580d020c030b200241ea016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b2007421f83200442ffffffff0f838621070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b420021052008420037031820082006370310200142808080c887d7c8b21d4280808080a8d7bee308200841106a411010011a200041086a2903002101423b210441f00021034200210603400240024002400240024020054206560d0020032c00002202419f7f6a41ff017141194b0d01200241a0016a21020c020b420021072005420b580d020c030b200241ea016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b2007421f83200442ffffffff0f838621070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b2008200637030020084200370308200142808080c887d7c8b21d4280808080a8d7bee3082008411010011a200841186a2203290300200041106a22022903005a418001100020032003290300200229030022057d370300200520082903087c20055a41b00110002008200829030820022903007c370308200029030021050240024020032903004200510d0020054280808080a8d7bee308200841106a411010091a0c010b20054280808080a8d7bee308200841106a10061a0b200041086a290300210502400240200841086a2903004200510d0020054280808080a8d7bee3082008411010091a0c010b20054280808080a8d7bee308200810061a0b4100200841206a3602040b980303027f057e017f4100410028020441106b220736020442002103423b210241e00121014200210403400240024002400240024020034207560d0020012c00002200419f7f6a41ff017141194b0d01200041a0016a21000c020b420021052003420b580d020c030b200041ea016a41002000414f6a41ff01714105491b21000b2000ad42388642388721050b2005421f83200242ffffffff0f838621050b200141016a2101200342017c2103200520048421042002427b7c2202427a520d000b42002103423b210241f00021014200210603400240024002400240024020034206560d0020012c00002200419f7f6a41ff017141194b0d01200041a0016a21000c020b420021052003420b580d020c030b200041ea016a41002000414f6a41ff01714105491b21000b2000ad42388642388721050b2005421f83200242ffffffff0f838621050b200141016a2101200342017c2103200520068421062002427b7c2202427a520d000b2007428094ebdc033703082007200637030020044280808080a8d7bee3082007411010091a4100200741106a3602040bb10303027f047e017f4100410028020441206b220836020442002105423b210441e00121034200210603400240024002400240024020054207560d0020032c00002202419f7f6a41ff017141194b0d01200241a0016a21020c020b420021072005420b580d020c030b200241ea016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b2007421f83200442ffffffff0f838621070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b024020062000520d0042002105423b210441f00121034200210603400240024002400240024020054207560d0020032c00002202419f7f6a41ff017141194b0d01200241a0016a21020c020b420021072005420b580d020c030b200241ea016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b2007421f83200442ffffffff0f838621070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b20062001520d00200842003703102008420037030820084200370318200841086a4118100541174b4180021000200841086a100d0b4100200841206a3602040b0bff010b0041040b04200500000041100b2254686973206170706561727320746f2062652061207472616e73666572206f6620000041c0000b0220000041d0000b072066726f6d20000041e0000b0520746f20000041f0000b086163636f756e7400004180010b2c696e746567657220756e646572666c6f77207375627472616374696e6720746f6b656e2062616c616e6365000041b0010b26696e7465676572206f766572666c6f7720616464696e6720746f6b656e2062616c616e6365000041e0010b0963757272656e6379000041f0010b097472616e7366657200004180020b1e6d6573736167652073686f72746572207468616e2065787065637465640000fd02046e616d651006617373657274020000086c6f61645f693634050000000000067072696e74690100067072696e746e0100067072696e747301000b726561644d6573736167650200000a72656d6f76655f693634030000000b726571756972654175746801000d726571756972654e6f7469636501000973746f72655f6936340400000000205f5a4e33656f733133726571756972654e6f74696365454e535f344e616d65450101301e5f5a4e33656f7331317265717569726541757468454e535f344e616d6545010130345f5a4e3863757272656e6379313273746f72654163636f756e74454e33656f73344e616d6545524b4e535f374163636f756e74450201300131355f5a4e3863757272656e637932336170706c795f63757272656e63795f7472616e7366657245524b4e535f385472616e73666572450901300131013201330134013501360137013804696e69740801300131013201330134013501360137056170706c7909013001310132013301340135013601370138010b4163636f756e744e616d65044e616d6502087472616e7366657200030466726f6d0b4163636f756e744e616d6502746f0b4163636f756e744e616d65087175616e746974790655496e743634076163636f756e740002036b65790655496e7436340762616c616e63650655496e74363401000000b298e982a4087472616e736665720100000080bafac608076163636f756e74"
      }
    ],
    "output": [{
        "notify": [],
        "sync_transactions": [],
        "async_transactions": []
      }
    ]
  }
}
Suggest Edits

set account permission

Creates or updates an account's permission

 

Positionals

  • account TEXT - The account to set/delete a permission authority for
  • permission TEXT - The permission name to set/delete an authority for
  • authority TEXT - [delete] NULL, [create/update] public key, JSON string, or filename defining the authority
  • parent TEXT - [create] The permission name of this parents permission (Defaults to: "Active")

Options

  • -h,--help Print this help message and exit
  • --add-code [code] add 'eosio.code' permission to specified permission authority
  • --remove-code [code] remove 'eosio.code' permission from specified permission authority
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)
  • -j,--json Print result as json

Usage

To modify permissions of an account, you must have the authority over the account and the permission of which you are modifying.

Basic usage, set new key to a permission

$ ./cleos set account permission testaccount active EOSPUBLICKEY owner -p testaccount@owner

Basic usage, set an account (instead of a key) as authority for a permission.

$ ./cleos set account permission testaccount active diffaccount owner -p testaccount@owner

Advanced Usage, weight/thresholds

$ ./cleos set account permission testaccount active '{"threshold" : 100, "keys" : [], "accounts" : [{"permission":{"actor":"user1","permission":"active"},"weight":25}, {"permission":{"actor":"user2","permission":"active"},"weight":75}]}' owner -p testaccount@owner

The JSON object used in this command is actually composed of two different types of objects

The authority JSON object ...

{
  "threshold"       : 100,    /*An integer that defines cumulative signature weight required for authorization*/
  "keys"            : [],     /*An array made up of individual permissions defined with an EOSIO-style PUBLIC KEY*/
  "accounts"        : []      /*An array made up of individual permissions defined with an EOSIO-style ACCOUNT*/
}

Returns

...contains 0 or more objects in the keys array

{
  "key"           : "EOS8X7Mp7apQWtL6T2sfSZzBcQNUqZB7tARFEm9gA9Tn9nbMdsvBB",
  "weight"        : 25      /*Set the weight of a signature from this permission*/
}

...contains 0 or more objects in the accounts array

{
  "permission" : {
    "actor"       : "sandwich",
    "permission"  : "active"
  },
  "weight"      : 75      /*Set the weight of a signature from this permission*/
}
Suggest Edits

set action permission

Set's authorization for a contract's specific action

 

Positionals

  • account TEXT - The account to set/delete a permission authority for (required)
  • code TEXT - The account that owns the code for the action
  • type TEXT the type of the action
  • requirement TEXT - The permission name require for executing the given action

Options

  • -h,--help - Print this help message and exit
  • `-a,--abi' TEXT - The ABI for the contract
  • `-x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

#cleos set action permission @ACCOUNT @CONTRACT ACTION_NAME PERMISSION_NAME

#Link a `voteproducer` action to the 'voting' permissions
cleos set action permission sandwichfarm eosio.system voteproducer voting -p sandwichfarm@voting

#Now can execute the transaction with the previously set permissions. 
cleos system voteproducer approve sandwichfarm someproducer -p sandwichfarm@voting
 

Positionals

  • account TEXT - The account to set code for (required)
  • code-file TEXT - The fullpath containing the contract WAST or WASM (required)

Options

  • -h,--help Print this help message and exit
  • `-a,--abi' TEXT - The ABI for the contract
  • `-x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)
  • --add-code Add eosio.code permission level to the account's active authority
  • --remove-code Remove eosio.code permission level to the account's active authority

Usage

cleos set code someaccount1 ./path/to/wasm
Suggest Edits

set abi

Create or update the abi on an account

 

Positionals

  • account TEXT - The account to set code for (required)
  • abi-file TEXT - The fullpath containing the contract WAST or WASM (required)

Options

  • -h,--help Print this help message and exit
  • `-a,--abi' TEXT - The ABI for the contract
  • `-x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

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

transfer

Transfer a token

 

Positional Parameters

  • sender TEXT - The account sending tokens
  • recipient TEXT - The account receiving tokens
  • amount TEXT - The amount of tokens to send and the token symbol
  • memo TEXT - The memo for the transfer

Options

  • -c, --contractTEXT - The contract which controls the token. Defaults to eosio.token.

Usage

Transfer 1 SYS from inita to tester

$ ./cleos transfer useraaaaaaaa useraaaaaaac "1.0000 SYS" "hello world"
$ ./cleos transfer useraaaaaaaa useraaaaaaac -c eosio.token "1.0000 SYS" "hello world"

The response will look something like this

executed transaction: ac989464a987e9061d4eabdfad0e5707a23ba769798a01f3ce010c5b3775b554  128 bytes  490 us
#   eosio.token <= eosio.token::transfer        {"from":"useraaaaaaaa","to":"useraaaaaaac","quantity":"1.0000 SYS","memo":"hello world"}

Subcommands

Suggest Edits

net connect

Connect to a peer

 

Positionals

  • host TEXT - The hostname:port to connect to. (required)

Options

None

Example

cleos net connect http://somehost.com:1234
Suggest Edits

net disconnect

Disconnect from a peer

 

Positionals

  • host TEXT - The hostname:port to disconnect from (required)

Options

none

Usage

cleos net disconnect http://somehost.com:1234
Suggest Edits

net status

Returns status of a specific peer defined by url

 

Positionals

  • host TEXT - The hostname:port to query status of connection (required)

Options

None

Example

cleos net status http://somepeer:1234
#returns status of a configured peer
Suggest Edits

net peers

Returns JSON of currently connected peers

 

Positionals

None

Options

None

Usage

cleos net peers 
#returns JSON of currently connected peers

Description

Subcommand used to interact with the local wallet.

Subcommands

  • create Create a new wallet locally
  • open Open an existing wallet
  • lock Lock wallet
  • lock_all Lock all unlocked wallets
  • unlock Unlock wallet
  • import Import private key into wallet
  • list List opened wallets, * = unlocked
  • keys List of private keys from all unlocked wallets in wif format.
  • create_key Create a public/private key pair.
  • private_keys List of private keys from all unlocked wallets in wif format.
Suggest Edits

create

Creates a wallet with the specified name. If no name is given, the wallet will be created with the name 'default'.

 

Positionals

None

Options

  • -n, --name TEXT - The name of the new wallet
  • -f, --file TEXT - Name of file to write wallet password output to. (Must be set, unless "--to-console" is passed
  • --to-console - Print password to console

Usage

$ ./cleos wallet create --to-console
or
$ ./cleos wallet create -n second-wallet --to-console
or
$ ./cleos wallet create --name my-new-wallet --file my-new-wallet.txt

Outputs

Creating wallet: default
Save password to use in the future to unlock this wallet.
Without password imported keys will not be retrievable.
"PW5JD9cw9YY288AXPvnbwUk5JK4Cy6YyZ83wzHcshu8F2akU9rRWE"
or
Creating wallet: second-wallet
Save password to use in the future to unlock this wallet.
Without password imported keys will not be retrievable.
"PW5Ji6JUrLjhKAVn68nmacLxwhvtqUAV18J7iycZppsPKeoGGgBEw"
Suggest Edits

open

Opens an existing wallet.

 

Positionals

None

Options

  • -n, --name TEXT - The name of the wallet to open.

Usage

$ ./cleos wallet open
or
$ ./cleos wallet open -n second-wallet

Outputs

Opened: default
Suggest Edits

lock

Locks a wallet.

 

Positionals

None

Options

  • -n, --name TEXT - The name of the wallet to lock

Usage

$ cleos wallet lock
or
$ ./cleos wallet lock -n second-wallet

Outputs

Locked: 'default'
or
Locked: 'second-wallet'
Suggest Edits

lock_all

Locks all unlocked wallets.

 

Positionals

None

Options

None

Usage

$ ./cleos wallet lock_all

Outputs

Locked All Wallets
Suggest Edits

unlock

Unlocks a wallet.

 

Positionals

None

Options

  • -n, --name TEXT - The name of the wallet to unlock.
  • --password TEXT - The password returned by wallet create.

Usage

To unlock a wallet, specify the password provided when it was created.

$ ./cleos wallet unlock -n second-wallet --password PW5Ji6JUrLjhKAVn68nmacLxwhvtqUAV18J7iycZppsPKeoGGgBEw

Outputs

Unlocked: 'second-wallet'
Suggest Edits

import

Imports private key into wallet.

 

Positionals

None

Options

  • -n, --name TEXT - The name of the wallet to import key into.
  • --private-key TEXT - Private key in WIF format to import.

Usage

$ ./cleos wallet import --private-key 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3

Outputs

imported private key for: EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV
Suggest Edits

list

Lists opened wallets, * = unlocked.

 

Positionals

None

Options

None

Usage

$ ./cleos wallet list

Outputs

Wallets:
[
  "default *",
  "second-wallet *"
]

or when there are no wallets
Wallets:
[
]
Suggest Edits

keys

List of public keys from all unlocked wallets. These are the keys that could be used to sign transactions.

 

Positionals

None.

Options

None.

Usage

$ ./cleos wallet keys

Outputs

[[
    "EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV",
    "5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3"
  ]
]
Suggest Edits

create_key

Creates a key pair within the wallet so that you don't need to manually import it like you would with cleos create key. By default this will create a key with the type "favored" by the wallet, which is a K1 key. But this command also lets you create a key in R1 format.

 

Positionals

key_type TEXT - "K1" or "R1" Key type to create

Options

-n,--name TEXT=default The name of the wallet to create key into

Usage

$ cleos wallet create_key K1

Outputs

Created new private key with a public key of: "EOS67xHKzQArkWZN6rKLCq7NLvaj8kurwxzRxoTVz6cgDJkiWdGug"
Suggest Edits

private_keys

It is possible to query for the public and private key pairs of an individual wallet. The wallet must already be unlocked and you must give the password again.

 

Positionals

None

Options

-n,--name TEXT - The name of the wallet to list keys from, otherwise - default
--password TEXT - The password returned by wallet create

Usage

cleos wallet private_keys

Outputs

Positionals

  • transaction TEXT - The JSON string or filename defining the transaction to sign (required)

Options

  • -k,--private-key TEXT - The private key that will be used to sign the transaction
    *-c,--chain-id TEXT - The chain id that will be used to sign the transaction
  • -p,--push-transaction - Push transaction after signing

Description

Pushes arbitrary transactions to the blockchain.

Commands

push action Push a transaction with a single action
push transaction Push an arbitrary JSON transaction
push transactions Push an array of arbitrary JSON transactions

Suggest Edits

push action

Push a transaction with a single action

 

Positionals

  • contract Type: Text - The account providing the contract to execute
  • action Type: Text - The action to execute on the contract
  • data Type: Text - The arguments to the contract

Output

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
  • -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)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission'
  • --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

Example

cleos push action eosio.token transfer '{"from":"bob","to":"alice","quantity":"20.0000 SYS","memo":"some SYS for you alice!"}' -p bob@active
Suggest Edits

push transaction

Push an arbitrary JSON transaction

 

Positionals

  • transaction (text) The JSON of the transaction to push, or the name of a JSON file containing the transaction

Options

This command has no options

Example

cleos push transaction {}
Suggest Edits

push transactions

 

Positionals

Pushes an array of arbitrary JSON transactions.

Options

This command has no options

Examples

 

Subcommands

Suggest Edits

multisig propose

 

Positionals

proposal_name TEXT - Proposal name (string)
requested_permissions TEXT - The JSON string or filename defining requested permissions
trx_permissions TEXT - The JSON string or filename defining transaction permissions
contract TEXT - Contract to wich deferred transaction should be delivered
action TEXT - Action of deferred transaction
data TEXT - The JSON string or filename defining the action to propose
proposer TEXT - Account proposing the transaction
proposal_expiration UINT - Proposal expiration interval in hours

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

Suggest Edits

multisig review

 

Positionals

  • proposer TEXT - Proposer name (string)
  • proposal_name TEXT - Proposal name (string)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

Suggest Edits

multisig approve

 

Positionals

  • proposer TEXT - Proposer name (string)
  • proposal_name TEXT - Proposal name (string)
  • permissions TEXT - The JSON string of filename defining approving permissions

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

Suggest Edits

multisig unapprove

 

Positionals

  • proposer TEXT - Proposer name (string)
  • proposal_name TEXT - Proposal name (string)
  • permissions TEXT - The JSON string of filename defining approving permissions

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

Suggest Edits

multisig cancel

 

Positionals

  • proposer TEXT - Proposer name (string)
  • proposal_name TEXT - Proposal name (string)
  • canceler TEXT - Canceler name (string)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

Suggest Edits

multisig exec

 

Positionals

  • proposer TEXT - Proposer name (string)
  • proposal_name TEXT - Proposal name (string)
  • executer TEXT - Account paying for execution (string)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

System commands can only be used on installations that have the system contracts loaded. Please see here for more details.

Suggest Edits

system newaccount

Create an account, buy ram, stake for bandwidth for the account

 

Positionals

  • creator TEXT - The name of the account creating the new account
  • name TEXT - The name of the new account
  • OwnerKey TEXT - The owner public key for the new account
  • ActiveKey TEXT - The active public key for the new account

Options

  • -h,--help Print this help message and exit
  • --stake-net TEXT - The amount of EOS delegated for net bandwidth
  • --stake-cpu TEXT - The amount of EOS delegated for CPU bandwidth
  • --buy-ram-kbytes UINT - The amount of RAM bytes to purchase for the new account in kibibytes (KiB), default is 8 KiB
  • --buy-ram TEXT - The amount of RAM bytes to purchase for the new account in EOS
  • --transfer - Transfer voting power and right to unstake EOS to receiver
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

Prerequisites

  • An existing account
  • A username that follows naming conventions
  • two keypairs (for maximum security)
cleos system newaccount eosio someusername EOS123456.. EOS123456...
Suggest Edits

system regproducer

Register a new producer

 

Positionals

  • account TEXT - The account to register as a producer
  • producer_key TEXT - The producer's public key
  • url TEXT - URL where info about producer can be found
  • location UINT - Relative location for purpose of nearest neighbor scheduling

Options

  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system regproducer accountname1 EOS1234534... http://producer.site Antarctica
Suggest Edits

system unregprod

Unregister an existing producer

 

Positionals

account TEXT - The account to unregister as a producer

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

cleos system unregprod accountname1
Suggest Edits

system voteproducer

Vote for a producer

 

Subcommands

voteproducer proxy - Vote your stake through a proxy
voteproducer prods - Vote for one or more producers
voteproducer approve -Add one producer to list of voted producers
voteproducer unapprove - Remove one producer from list of voted producers

Suggest Edits

system voteproducer proxy

Vote your stake through a proxy

 

Positionals

  • voter TEXT - The voting account
  • proxy TEXT - The proxy account

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system voteproducer proxy accountname1 proxyaccount
Suggest Edits

system voteproducer prods

Vote for one or more producers

 

Positionals

  • voter TEXT - The voting account
  • producers TEXT ... - The account(s) to vote for. All options from this position and following will be treated as the producer list.

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

cleos system voteproducer prods someproducr1 someproducr2 someproducr3 someproducr4
Suggest Edits

system voteproducer approve

Add one producer to list of voted producers

 

Positionals

  • voter TEXT - The voting account
  • producer TEXT - The account to vote for

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system voteproducer approve someproducr1
Suggest Edits

system voteproducer unapprove

Remove one producer from list of voted producers

 

Positionals

  • voter TEXT - The voting account
  • producer TEXT - The account to remove from voted producers

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

cleos system voteproducer unapprove someproducr1
Suggest Edits

system listproducers

Returns a list of producers

 

Returns a list of producers in text or json format including

  • Producer account name
  • Producer key
  • Producer URL
  • Producer's scaled votes

Positionals

None

Options

-h,--help - Print this help message and exit
-j,--json - Output in JSON format
-l,--limit UINT - The maximum number of rows to return
-L,--lower TEXT - Lower bound value of key, defaults to first

Usage

cleos system listproducers
Suggest Edits

system delegatebw

Delegate bandwidth

 

Positionals

  • from TEXT - The account delegating bandwidth
  • receiver TEXT - The account to delegate bandwidth from
  • stake_net_quantity TEXT - The amount of EOS to delegate for network bandwidth
  • stake_cpu_quantity TEXT - The amount of EOS to delegate for CPU bandwidth

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

cleos system delegatebw accountname1 accountname2 "1 SYS" "1 SYS"
Suggest Edits

system undelegatebw

Undelegate bandwidth

 

Positionals

  • from TEXT - The account undelegating bandwidth
  • receiver TEXT - The account to undelegate bandwidth from
  • unstake_net_quantity TEXT - The amount of EOS to undelegate for network bandwidth
  • unstake_cpu_quantity TEXT - The amount of EOS to undelegate for CPU bandwidth

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

Usage

cleos system undelegatebw accountname1 accountname2 "0.5 SYS" "0.5 SYS"
Suggest Edits

system listbw

List bandwidth delegated from an account

 

Returns list of delegated bandwidth from an account in either text or json.

Positionals

  • account TEXT - The account delegated bandwidth

Options

-h,--help - Print this help message and exit
-j,--json - Output in JSON format

Usage

cleos system listbw someaccount1
Suggest Edits

system bidname

place a bid on "premium" usernames (account names less than 12 characters)

 

Positionals

  • bidder TEXT - The bidding account (required)
  • newname TEXT - The bidding name (required)
  • bid TEXT - The amount of CORE SYMBOL to bid (required)

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
  • -d,--dont-broadcast - don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission'
  • --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)

Usage

cleos system bidname accountname1 bob "10 SYS"
Suggest Edits

system buyram

Buy RAM

 

Positionals

  • payer TEXT - Theaccount paying for RAM
  • receiver TEXT - The account receiving bought RAM
  • tokens TEXT - The amount of EOS to pay for RAM

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

#buy ram for yourself
cleos system buyram someaccount1 someaccount1 "10 EOS"

#buy ram for someone else
cleos system buyram someaccount1 someaccount2 "1 EOS"
Suggest Edits

system sellram

Sell RAM

 

Positionals

  • account TEXT - The account to receive EOS for sold RAM
  • bytes UINT - Number of RAM bytes to sell

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

#sell 1000 bytes
cleos system sellram someaccount1 1000 
Suggest Edits

system claimrewards

Claim producer rewards

 

Positionals

  • owner TEXT - The account to claim rewards for

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

cleos system claimrewards smeproducr22
Suggest Edits

system regproxy

Register an account as a proxy (for voting)

 

Positionals

proxy TEXT - The proxy account to register

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

cleos system regproxy someaccount1
Suggest Edits

system unregproxy

Unregister an account as a proxy (for voting)

 

Positionals

  • proxy TEXT - The proxy account to unregister

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

cleos system unregproxy someaccount1
Suggest Edits

system canceldelay

Cancel a delayed transaction

 

Positionals

  • canceling_account TEXT - Account from authorization on the original delayed transaction
  • canceling_permission TEXT - Permission from authorization on the original delayed transaction
  • trx_id TEXT - The transaction id of the original delayed transaction

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Usage

cleos system canceldelay someaccount1 active s0MEtxID...
Suggest Edits

bidnameinfo

Returns data about a particular name and it's bidding status

 

Positionals

  • name TEXT - The name to lookup

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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission'
  • --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)

Usage

cleos system bidnameinfo bob
Suggest Edits

system rex

 

Subcommands

deposit - Deposit into owner's REX fund by transfering from owner's liquid token balance
withdraw - Withdraw from owner's REX fund by transfering to owner's liquid token balance
buyrex - Buy REX using tokens in owner's REX fund
lendrex - Deposit tokens to REX fund and use the tokens to buy REX
unstaketorex - Buy REX using staked tokens
sellrex - Sell REX tokens
cancelrexorder - Cancel queued REX sell order if one exists
mvtosavings - Move REX tokens to savings bucket
mvfromsavings - Move REX tokens out of savings bucket
rentcpu - Rent CPU bandwidth for 30 days
rentnet - Rent Network bandwidth for 30 days
fundcpuloan - Deposit into a CPU loan fund
fundnetloan - Deposit into a Network loan fund
defundcpuloan - Withdraw from a CPU loan fund
defundnetloan - Withdraw from a Network loan fund
consolidate - Consolidate REX maturity buckets into one that matures in 4 days
updaterex - Update REX owner vote stake and vote weight
rexexec - Perform REX maintenance by processing expired loans andunfilledll orders
closerex - Delete unused REX-related user table entries

Suggest Edits

system rex deposit

Deposit into owner's REX fund by transfering from owner's liquid token balance

 

Positionals

  • owner TEXT - Account which owns the REX fund (required)
  • amount TEXT - Amount to be deposited into REX fund (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex deposit accountname1 "1 SYS"
Suggest Edits

system rex withdraw

Withdraw from owner's REX fund by transfering to owner's liquid token balance

 

Positionals

  • owner TEXT - Account which owns the REX fund (required)
  • amount TEXT - Amount to be withdrawn from REX fund (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex withdraw accountname1 "1 SYS"
Suggest Edits

system rex buyrex

Buy REX using tokens in owner's REX fund

 

Positionals

  • from TEXT - Account buying REX tokens (required)
  • amount TEXT - Amount to be taken from REX fund and used in buying REX (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex buyrex accountname1 "1 REX"
Suggest Edits

system rex lendrex

Deposit tokens to REX fund and use the tokens to buy REX

 

Positionals

  • from TEXT - Account buying REX tokens (required)
  • amount TEXT - Amount to be taken from REX fund and used in buying REX (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex lendrex accountname1 "1 REX"
Suggest Edits

system rex cancelrexorder

Cancel queued REX sell order if one exists

 

Positionals

  • owner TEXT - Owner account of sell order (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex cancelrexorder accountname1
Suggest Edits

system rex mvtosavings

Move REX tokens to savings bucket

 

Positionals

  • owner TEXT - Account which owns the REX fund (required)
  • rex TEXT - Amount to be Amount of REX to be moved to savings bucket (required) into REX fund (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex mvtosavings accountname1 "1 REX"
Suggest Edits

system rex mvfromsavings

Move REX tokens out of savings bucket

 

Positionals

  • owner TEXT - Account which owns the REX fund (required)
  • rex TEXT - Amount of REX to be moved out of savings bucket (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex mvfromsavings accountname1 "1 REX"
Suggest Edits

system rex rentcpu

Rent CPU bandwidth for 30 days

 

Positionals

  • from TEXT - Account buying REX tokens (required)
  • receiver TEXT - Account to whom rented CPU bandwidth is staked (required)
  • loan_payment TEXT - Loan fee to be paid, used to calculate amount of rented bandwidth (required)
  • loan_fund TEXT - Loan fund to be used in automatic renewal, can be 0 tokens (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex rentcpu accountname1 accountname2 "1 EOS" 0
Suggest Edits

system rex rentnet

Rent Network bandwidth for 30 days

 

Positionals

  • from TEXT - Account buying REX tokens (required)
  • receiver TEXT - Account to whom rented NET bandwidth is staked (required)
  • loan_payment TEXT - Loan fee to be paid, used to calculate amount of rented bandwidth (required)
  • loan_fund TEXT - Loan fund to be used in automatic renewal, can be 0 tokens (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex rentnet accountname1 accountname2 "1 EOS" 0
Suggest Edits

system rex fundcpuloan

Deposit into a CPU loan fund

 

Positionals

  • from TEXT - Loan owner (required)
  • loan_num TEXT - Loan ID (required)
  • payment TEXT - Amount to be deposited (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex fundcpuloan accountname1 abc123 "1 EOS"
Suggest Edits

system rex fundnetloan

Deposit into a Network loan fund

 

Positionals

  • from TEXT - Loan owner (required)
  • loan_num TEXT - Loan ID (required)
  • payment TEXT - Amount to be deposited (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex fundnetloan accountname1 abc123 "1 EOS"
Suggest Edits

system rex defundcpuloan

Withdraw from a CPU loan fund

 

Positionals

  • from TEXT - Loan owner (required)
  • loan_num TEXT - Loan ID (required)
  • payment TEXT - Amount to be deposited (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex defundcpuloan accountname1 abc123 "1 EOS"
Suggest Edits

system rex defundnetloan

Withdraw from a Network loan fund

 

Positionals

  • from TEXT - Loan owner (required)
  • loan_num TEXT - Loan ID (required)
  • payment TEXT - Amount to be deposited (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex defundnetloan accountname1 abc123 "1 EOS"
Suggest Edits

system rex consolidate

Consolidate REX maturity buckets into one that matures in 4 days

 

Positionals

  • owner TEXT - Account which owns the REX fund (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex consolidate accountname1
Suggest Edits

system rex updaterex

Update REX owner vote stake and vote weight

 

Positionals

  • owner TEXT - Account which owns the REX fund (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex updaterex accountname1
Suggest Edits

system rex rexexec

Perform REX maintenance by processing expired loans and unfilled sell orders

 

Positionals

  • user TEXT - User executing the action (required)
  • max TEXT - Maximum number of CPU loans, Network loans, and sell orders to be processed (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex rexexec accountname1 10
Suggest Edits

system rex closerex

Delete unused REX-related user table entries

 

Positionals

  • owner TEXT - Account which owns the REX fund (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex closerex accountname1
Suggest Edits

system rex unstaketorex

Buy REX using staked tokens

 

Positionals

  • from TEXT - Account buying REX tokens (required)
  • receiver TEXT - Account that tokens have been staked to (required)
  • from_cpu TEXT - Amount to be unstaked from CPU resources and used in REX purchase (required)
  • from_net TEXT - Amount to be unstaked from Net resources and used in REX purchase (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex unstaketorex accountname1 accountname2 "1 EOS" 0
Suggest Edits

system rex sellrex

Sell REX tokens

 

Positionals

  • from TEXT - Account selling REX tokens (required)
  • rex TEXT - Amount of REX tokens to be sold (required)

Options

  • -h,--help Print this help message and exit
  • -x,--expiration TEXT - 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
  • -d,--dont-broadcast - Don't broadcast transaction to the network (just print to stdout)
  • -r,--ref-block TEXT - Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • -p,--permission TEXT - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@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)

Examples

cleos system rex sellrex accountname1 "1 REX"