Good morning everyone! Today I’m excited to share a new, highly requested piece of documentation that covers SNS asset canisters!
Asset canisters are used to store the frontend assets related to a dapp, or in the context of SNS, the frontend of the SNS DAO such as the dashboard that users can interact with proposals through.
The contents of the asset canister must be configured prior to the launch of the SNS, and any changes afterwards must be made by a principal with the Prepare
permission. Principals with this Prepare
permission can make a batch of changes to the asset canister and then ‘lock’ those changes. To have those changes applied, a proposal must be submitted. Anyone can submit the proposal for the ‘locked’ changes. Once changes are proposed, they can be voted on by the SNS DAO. If approved, the SNS governance canister is the only one that can commit the approved changes. This configuration assures that changes to the asset canister are only made by approved proposals. These changes are referred to as ‘upgrades’.
This new documentation covers the following topics relating to SNS asset canisters:
- Deploying an asset canister
* Deploying locally for testing
* Deploying on the mainnet - Configuring an asset canister’s permissions
* Granting permissions
* Revoking permissions
* Listing permissions - SNS GenericNervousSystemFunctions
- Submitting an SNS proposal and upgrading an asset canister
Additionally, this documentation will soon include detailed information regarding registering and submitting generic functions proposals, including CLI walkthroughs of how to execute these workflows.
You can find the new SNS asset canister documentation here.
As always, please let us know your thoughts and any feedback you may have!