Set
Description The subcommands can be required to set or update the blockchain state.
Subcommands
Set Code — Create or update the code on an account.
Set Abi — Create or update the abi on an account.
Set Contract — Create or update the contract on an account.
Set Account — Set or update blockchain account state.
Set Action — Set or update blockchain action state.
Create or update the code on an account.
(string) account— The account to set code for (required).(string) code-file— The fullpath containing the contract WASM.
-c,--clear— Remove code on an account.--suppress-duplicate-check— Do not check for duplicate.-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 set code [OPTIONS] <account> [<code-file>]
$ cleos set code alice ./path/to/wasm
Create or update the contract on an account.
(string) account— The account to set the ABI for (required).(string) abi-file— The fullpath containing the contract ABI.
-c,--clear— Remove abi on an account.--suppress-duplicate-check— Do not check for duplicate.-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 set abi [OPTIONS] <account> [<abi-file>]
$ cleos set abi alice ./path/to/abi.abi
Create or update the contract on an account.
(string) account— The account to publish a contract for (required).(string) contract-dir— The path containing the .wasm and .abi.(string) wasm-file— The file containing the contract WASM relative to contract-dir.
abi-file,-a,--abi— The ABI for the contract relative to contract-dir.-c,--clear— Remove contract on an account.--suppress-duplicate-check— Do not check for duplicate.-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 set contract [OPTIONS] <account> [<contract-dir>] [<wasm-file>]
Deployind the stake contract.
$ cleos set contract currency ../contracts/cyber.stake/stake.wasm ../contracts/cyber.stake/stake.abi
Set parameters dealing with account permissions.
(string) account— The account to set/delete a permission authority for (required).(string) permission— The permission name to set/delete an authority for (required).(string) authority— [delete] NULL, [create/update] public key, JSON string or filename defining the authority, [code] contract name.(string) parent— [create] The permission name of this parents permission, defaults to 'active'.
--add-code— [code] add '${code}' permission to specified permission authority.--remove-code— [code] remove '${code}' permission from specified permission authority.-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.
To modify the permissions of an account, you must have the authority over the account and the permission of which you are modifying.
$ cleos set account permission [OPTIONS] <account> <permission> [<authority>] [<parent>]
Example 1 Associates a new key to the active permissions of an account.
$ cleos set account permission test active '{"threshold" : 1, "keys" : [{"permission":{"key":"GLS7...L6T2s","permission":"active"},"weight":1}], "accounts" : [{"permission":{"account":"bob","permission":"active"},"weight":50}]}' owner
Example 2 Modifies the same account permission, but removes the key set in the last example, and grants active authority of the @test account to another account.
$ cleos set account permission test active '{"threshold" : 1, "keys" : [], "accounts" : [{"permission":{"account":"sandwich","permission":"active"},"weight":1},{"permission":{"account":"alice","permission":"active"},"weight":50}]}' owner
Example 3 Demonstrates how to setup permissions for multisig.
cleos set account permission test active '{"threshold" : 100, "keys" : [{"permission":{"key":"GLS7...L6T2s","permission":"active"},"weight":25}], "accounts" : [{"permission":{"account":"@sandwich","permission":"active"},"weight":75}]}' owner
Set parmaters dealing with account permissions.
(string) account— The account to set/delete a permission authority for (required).(string) code— The account that owns the code for the action (required).(type) type— The type of the action (required).(type) requirement— [delete] NULL, [set/update] The permission name require for executing the given action (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 set action permission [OPTIONS] <account> <code> <type> <requirement>
Link a 'voteproducer' action to the 'voting' permissions
$ cleos set action permission alice cyber.system voteproducer voting -p alice@voting
Now can execute the transaction with the previously set permissions.
$ cleos system voteproducer approve alice someproducer -p alice@voting
