git.delta.rocks / unique-network / refs/commits / 9d0fd83a5da6

difftreelog

source

pallets/identity/README.md2.4 KiBsourcehistory
1# Identity Module23- [`identity::Config`](https://docs.rs/pallet-identity/latest/pallet_identity/trait.Config.html)4- [`Call`](https://docs.rs/pallet-identity/latest/pallet_identity/enum.Call.html)56## Overview78A federated naming system, allowing for multiple registrars to be added from a specified origin.9Registrars can set a fee to provide identity-verification service. Anyone can put forth a10proposed identity for a fixed deposit and ask for review by any number of registrars (paying11each of their fees). Registrar judgements are given as an `enum`, allowing for sophisticated,12multi-tier opinions.1314Some judgements are identified as *sticky*, which means they cannot be removed except by15complete removal of the identity, or by the registrar. Judgements are allowed to represent a16portion of funds that have been reserved for the registrar.1718A super-user can remove accounts and in doing so, slash the deposit.1920All accounts may also have a limited number of sub-accounts which may be specified by the owner;21by definition, these have equivalent ownership and each has an individual name.2223The number of registrars should be limited, and the deposit made sufficiently large, to ensure24no state-bloat attack is viable.2526## Interface2728### Dispatchable Functions2930#### For general users31* `set_identity` - Set the associated identity of an account; a small deposit is reserved if not32  already taken.33* `clear_identity` - Remove an account's associated identity; the deposit is returned.34* `request_judgement` - Request a judgement from a registrar, paying a fee.35* `cancel_request` - Cancel the previous request for a judgement.3637#### For general users with sub-identities38* `set_subs` - Set the sub-accounts of an identity.39* `add_sub` - Add a sub-identity to an identity.40* `remove_sub` - Remove a sub-identity of an identity.41* `rename_sub` - Rename a sub-identity of an identity.42* `quit_sub` - Remove a sub-identity of an identity (called by the sub-identity).4344#### For registrars45* `set_fee` - Set the fee required to be paid for a judgement to be given by the registrar.46* `set_fields` - Set the fields that a registrar cares about in their judgements.47* `provide_judgement` - Provide a judgement to an identity.4849#### For super-users50* `add_registrar` - Add a new registrar to the system.51* `kill_identity` - Forcibly remove the associated identity; the deposit is lost.5253[`Call`]: ./enum.Call.html54[`Config`]: ./trait.Config.html5556License: Apache-2.0