System
Description The subcommands can be used to send cyber.system contract action to the blockchain.
Subcommands
System Newaccount — Create a new account on the blockchain with initial resources.
System Regproducer — Register a new producer.
System Unregprod — Unregister an existing producer.
System Voteproducer Proxy — Vote your stake through a proxy.
System Voteproducer Prods — Vote for a producer.
System Listproducers — List producers.
System Delegatebw — Delegate bandwidth.
System Undelegatebw — Undelegate bandwidth.
System Claimbw — Claim undelegated bandwidth.
System Listbw — List delegated bandwidth.
System Bidname — Name bidding.
System Bidnameinfo — Get bidname info.
System Setproxylvl — Set an account proxy level.
System Regproxy — Register an account as a proxy (for voting).
System Unregproxy — Unregister an account as a proxy (for voting).
System Stake — Stake assets to gain resources.
System Canceldelay — Cancel a delayed transaction.
Create a new account on the blockchain with initial resources.
(string) creator— The name of the account creating the new account (required).(string) name— The name of the new account (required).(string) OwnerKey— The owner public key or permission level for the new account (required).(string) ActiveKey— The active public key or permission level for the new account.
--stakeTEXT — The amount of tokens delegated for the account--transfer— Transfer voting power and right to unstake tokens to receiver.-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'creator@active').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system newaccount [OPTIONS] <creator> <name> <OwnerKey> [<ActiveKey>]
'alice' creates 'bob' and transfers him 50 tokens irrevocably.
$ cleos system newaccount --stake=50.0000,CYBER --transfer alice bob XXX...XXX
Register a new producer.
(string) account— The account to register as a producer (required).(string) producer_key— The producer's public key (required).
--min-own-stake— A min value the producer guarantees to stake.-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'account@active').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system regproducer [OPTIONS] <account> <producer_key>
Unregister an existing producer.
(string) account— An account to unregister from producers (required).
-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'account@active').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system unregprod [OPTIONS] <account>
This subcommand can be used to vote your stake through a proxy.
(string) voter— The voting account (required).(string) proxy— The proxy accoun (required).(string) quantity— An asset quantity that the voter delegates to the proxy to vote for the producer (required).
-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'voter@active').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system voteproducer proxy [OPTIONS] <voter> <proxy> <quantity>
This subcommand can be used to vote for a producer.
(string) voter— A voting account (required).(string) producer— An account to vote for (required).(string) quantity— An asset quantity that the voter votes for the producer (required).
-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'voter@active').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system voteproducer prods [OPTIONS] <voter> <producer> <quantity>
This subcommand can be used to obtain a list of producers.
No parameters required for this subcommand.
--json,-j— Output in JSON format.-l,--limitUINT — The maximum number of rows to return.-L,--lowerTEXT — Lower bound value of key, defaults to first.
$ cleos system listproducers [OPTIONS]
This subcommand can be used to delegate bandwidth.
(string) from— The account to delegate bandwidth from (required).(string) receiver— The account to receive the delegated bandwidth (required).(string) stake_quantity— The amount of tokens to stake (required).
--transfer— Transfer voting power and right to unstake tokens to receiver.-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'from@active').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system delegatebw [OPTIONS] <from> <receiver> <stake_quantity>
'alice' delegates 10 tokens to 'bob'
cleos system delegatebw alice bob "10.0000 CYBER"
This subcommand can be used to undelegate bandwidth.
(string) from— The account undelegating bandwidth (required).(string) receiver— The account to undelegate bandwidth from (required).(string) unstake_quantity— The amount of tokens to undelegate (required).
-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'from@active').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system undelegatebw [OPTIONS] <from> <receiver> <unstake_quantity>
This subcommand can be used to claim undelegated bandwidth.
This operation can only be performed 30 days after completion of undelegatebw (see Sake Usage Guide).
(string) from— An account claims undelegated stake (required).(string) receiver— An account returning stake (required).(string) token_code— An asset symbol claimed (required).
No options required for this subcommand.
$ cleos system claimbw <from> <receiver> <token_code>
'alice' credits the amount of staked tokens returned from 'bob' to a stake.
$ cleos system claimbw alice bob "CYBER"
This subcommand can be used to list delegated bandwidth.
(string) account— The account delegated bandwidth (required).
--json,-j— Output in JSON format.
$ cleos system listbw [OPTIONS] <account>
'alice' receives a list of users to whom she delegated bandwidth (staked tokens).
$ cleos system listbw alice
Name bidding subcommand.
(string) bidder— The bidding account (required).(string) newname— The name which the bid is done for (required).(string) bid— The amount of system tokens to bid (it is asset structure) (required).
-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'bidder@active').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system bidname [OPTIONS] <bidder> <newname> <bid>
'accountname1' bids 100 tokens to buy 'alice' name at an auction.
$ cleos system bidname accountname1 alice "100.0000 CYBER"
This subcommand can be used to get bidname info.
(string) newname— The name to lookup to lookup (required).
--json,-j— Output in JSON format.
$ cleos system [OPTIONS] <newname>
$ cleos system bidnameinfo alice
This subcommand can be used to set an account proxy level.
(string) account— An account whose proxy level will be set (required).(uint) level— A proxy level to set (required).
--symbol— A symbol of an asset used in the system.-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'account@active').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system setproxylvl [OPTIONS] <account> <level>
This subcommand can be used to register an account as a proxy (for voting).
(string) proxy— A proxy account to register (required).
--symbolTEXT — A token symbol used by producers.--levelUINT — A proxy level (must be greater than 0, but less than MAX_LEVEL. Default MAX_LEVEL value is 1 ).--feeUINT — A part of the fee proxies get for a block producing (takes an ineteger value from 0 to 10000 inclusive (10000 means 100,00 %).-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'proxy@active').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system regproxy [OPTIONS] <proxy>
'alice' registers as a proxy having level=1 and fee=50(%).
$ cleos system regproxy --symbol=4,CYBER --level=1 --fee=5000 alice
Unregister an account as a proxy (for voting).
(string) proxy— The proxy account to unregister (required).
--symbolTEXT — A token symbol used by producers.-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'proxy@active').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system unregproxy [OPTIONS] <proxy>
'alice' stops registering as a proxy account.
$ cleos system unregproxy --symbol=4,CYBER alice
This subcommand can be used to stake assets to gain resources.
(string) account— An account who stakes assets (required).(string) quantity— Assets quantity to stake (required).
--beneficiaryTEXT — An account gaining resources.
$ cleos system stake [OPTIONS] <account> <quantity>
cleos system stake alice "100.0000 CYBER" --beneficiary=bob
This subcommand can be used to cancel a delayed transaction.
(string) canceling_account— Account from authorization on the original delayed transaction (required).(string) canceling_permission— Permission from authorization on the original delayed transaction (required).(string) trx_id— The transaction id of the original delayed transaction (required).
-x,--expirationTEXT — Set the time (in seconds) before a transaction expires, defaults to 30 s.-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— Do not broadcast transaction to the network (just print tostdout).--return-packed— Used in conjunction with--dont-broadcastto get the packed transaction.-r,--ref-blockTEXT — Set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake).-p,--permissionTEXT — An account and permission level to authorize, as in 'account@permission' (defaults to 'canceling_account@canceling_permission').--max-cpu-usage-msUINT — 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-usageUINT — Set an upper limit on the net usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-ram-usageUINT — Set an upper limit on the ram usage budget (in bytes) for the transaction (defaults to 0 which means no limit).--max-storage-usage— Set an upper limit on the storage usage budget, (in bytes) for the transaction (defaults to 0 which means no limit).--delay-secUINT — Set thedelay_secseconds, defaults to 0 s.--bandwidth-providerTEXT — Set an account which provide own bandwidth for transaction.--dont-declare-names— Do not adddeclarenamesaction for resolved account names.
$ cleos system canceldelay [OPTIONS] <canceling_account> <canceling_permission> <trx_id>
