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

Add set-controller to doc #232

Merged
merged 2 commits into from
Sep 29, 2020
Merged

Add set-controller to doc #232

merged 2 commits into from
Sep 29, 2020

Conversation

lsgunnlsgunn
Copy link
Contributor

Overview
Add CLI reference for new subcommand

Comment on lines 619 to 627
You can use the `+dfx canister set-controller+` command to specify a user or canister as the controlling identity for a specific canister.

For example, you might create a new identity called `+pubsadmin+` then run the `+dfx canister set-controller+` to specify that you want the `+pubsadmin+` identity to be the controller of the `+my_wallet+` canister by running the following commands:

....
dfx identity new pubsadmin
dfx canister set-controller my_wallet pubsadmin
....

Copy link
Contributor

Choose a reason for hiding this comment

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

Based on the discussion we had in the architecture meeting, you would not need to do set controller on the wallet canister. The get-principal command will be sent to the Onboarding team and they will set the controller to the user provided principal.
Therefore, this example should change to just show setting the controller of a normal hello canister or similar


Use the `+dfx canister set-controller+` command to specify the identity name or principal to use as the new **controller** for a specified canister on the Internet Computer network.
A controller identity has special rights to manage the canister it controls.
For example, only a controlling identity can be used to upgrade or transfer cycles to the canister under its control.
Copy link
Contributor

Choose a reason for hiding this comment

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

This is true but you can also specify a custodian in the wallet canister so multiple identities can transfer cycles to it. Therefore, I would just remove this and just specify that only the controller may install, reinstall, upgrade etc.

@lsgunnlsgunn lsgunnlsgunn merged commit cb384f7 into master Sep 29, 2020
@lsgunnlsgunn lsgunnlsgunn deleted the LG/new-set-controller-cmd branch September 29, 2020 18:25
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants