Skip to content
This repository has been archived by the owner on Aug 2, 2022. It is now read-only.

Update the authority example [docs] #9123

Merged
merged 7 commits into from
Jun 3, 2020
Merged

Update the authority example [docs] #9123

Changes from 6 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
758d63b
Update the authority structure
dixia May 21, 2020
1df2564
update 2nd & 3rd JSON
dixia May 21, 2020
2a0e61b
put back permission
dixia May 21, 2020
2b8f250
remove old account name syntax
dixia May 21, 2020
e99c5b7
update
dixia May 21, 2020
17c9253
update 3rd example
dixia May 21, 2020
01e6619
Simplify the JSON payload
dixia Jun 2, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions docs/02_cleos/03_command-reference/set/set-account.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ set parameters dealing with account permissions
- `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")
- `parent` _TEXT_ - [create] The permission name of this parents permission (Defaults to: "active")
## Options

`-h,--help` Print this help message and exit
Expand Down Expand Up @@ -38,17 +38,18 @@ To modify the permissions of an account, you must have the authority over the ac
The first example associates a new key to the active permissions of an account.

```sh
cleos set account permission test active '{"threshold" : 1, "keys" : [{"permission":{"key":"EOS8X7Mp7apQWtL6T2sfSZzBcQNUqZB7tARFEm9gA9Tn9nbMdsvBB","permission":"active"},"weight":1}], "accounts" : [{"permission":{"account":"acc2","permission":"active"},"weight":50}]}' owner
cleos set account permission test active '{"threshold":1,"keys":[{"key":"EOS8X7Mp7apQWtL6T2sfSZzBcQNUqZB7tARFEm9gA9Tn9nbMdsvBB","permission":"active","weight":1}],"accounts":[{"permission":{"actor":"acc2","permission":"active"},"weight":50}]}' owner
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this first example correct? It's similar to the third example below, except the extra "permission" field after "key".

Copy link
Contributor Author

@dixia dixia Jun 1, 2020 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes the updated version is correct. The current example has an "account" field which is out-of-date field name

```
This second example 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.
This second example 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.

```sh
cleos set account permission test active '{"threshold" : 1, "keys" : [], "accounts" : [{"permission":{"account":"sandwich","permission":"active"},"weight":1},{"permission":{"account":"acc1","permission":"active"},"weight":50}]}' owner
cleos set account permission test active '{"threshold":1,"keys":[],"accounts":[{"permission":{"actor":"acc1","permission":"active"},"weight":50},{"permission":{"actor":"sandwich","permission":"active"},"weight":1}]}' owner
```
The third example demonstrates how to setup permissions for multisig.

The third example demonstrates how to set up permissions for multisig.

```sh
cleos set account permission test active '{"threshold" : 100, "keys" : [{"permission":{"key":"EOS8X7Mp7apQWtL6T2sfSZzBcQNUqZB7tARFEm9gA9Tn9nbMdsvBB","permission":"active"},"weight":25}], "accounts" : [{"permission":{"account":"@sandwich","permission":"active"},"weight":75}]}' owner
cleos set account permission test active '{"threshold" : 100, "keys" : [{"key":"EOS8X7Mp7apQWtL6T2sfSZzBcQNUqZB7tARFEm9gA9Tn9nbMdsvBB","weight":25}], "accounts" : [{"permission":{"actor":"sandwich","permission":"active"},"weight":75}]}' owner
```
The JSON object used in this command is actually composed of two different types of objects

Expand Down