Files
pezkuwi-subxt/substrate/frame/alliance
georgepisaltu 9185195185 Make IdentityInfo generic in pallet-identity (#1661)
Fixes #179 

# Description

This PR makes the structure containing identity information used in
`pallet-identity` generic through the pallet `Config`. Additionally, the
old structure is now available in a separate module called `simple`
(pending rename) and is compatible with the new interface.

Another change in this PR is that while the `additional` field in
`IdentityInfo` stays for backwards compatibility reasons, the associated
costs are stil present in the pallet through the `additional` function
in the `IdentityInformationProvider` interface. This function is marked
as deprecated as it is only a temporary solution to the backwards
compatibility problem we had. In short, we could have removed the
additional fields in the struct and done a migration, but we chose to
wait and do it off-chain through the genesis of the system parachain.
After we move the identity pallet to the parachain, additional fields
will be migrated into the existing fields and the `additional` key-value
store will be removed. Until that happens, this interface will provide
the necessary information to properly account for the associated costs.

Additionally, this PR fixes an unrelated issue; the `IdentityField` enum
used to represent the fields as bitflags couldn't store more than 8
fields, even though it was marked as `#[repr(u64)]`. This was because of
the `derive` implementation of `TypeInfo`, which assumed `u8` semantics.
The custom implementation of this trait in
https://github.com/paritytech/polkadot-sdk/commit/0105cc0396b7a53d0b290f48b1225847f6d17321
fixes the issue.

---------

Signed-off-by: georgepisaltu <george.pisaltu@parity.io>
Co-authored-by: Sam Johnson <sam@durosoft.com>
Co-authored-by: joe petrowski <25483142+joepetrowski@users.noreply.github.com>
2023-10-24 13:47:11 +02:00
..

Alliance Pallet

The Alliance Pallet provides a collective that curates a list of accounts and URLs, deemed by the voting members to be unscrupulous actors. The Alliance

  • provides a set of ethics against bad behavior, and
  • provides recognition and influence for those teams that contribute something back to the ecosystem.

Overview

The network initializes the Alliance via a Root call. After that, anyone with an approved identity and website can join as an Ally. The MembershipManager origin can elevate Allies to Fellows, giving them voting rights within the Alliance.

Voting members of the Alliance maintain a list of accounts and websites. Members can also vote to update the Alliance's rule and make announcements.

Terminology

  • Rule: The IPFS CID (hash) of the Alliance rules for the community to read and the Alliance members to enforce. Similar to a Charter or Code of Conduct.
  • Announcement: An IPFS CID of some content that the Alliance want to announce.
  • Member: An account that is already in the group of the Alliance, including three types: Fellow, or Ally. A member can also be kicked by the MembershipManager origin or retire by itself.
  • Fellow: An account who is elevated from Ally by other Fellows.
  • Ally: An account who would like to join the Alliance. To become a voting member (Fellow), it will need approval from the MembershipManager origin. Any account can join as an Ally either by placing a deposit or by nomination from a voting member.
  • Unscrupulous List: A list of bad websites and addresses; items can be added or removed by voting members.

Interface

Dispatchable Functions

For General Users

  • join_alliance - Join the Alliance as an Ally. This requires a slashable deposit.

For Members (All)

  • give_retirement_notice - Give a retirement notice and start a retirement period required to pass in order to retire.
  • retire - Retire from the Alliance and release the caller's deposit.

For Voting Members

  • propose - Propose a motion.
  • vote - Vote on a motion.
  • close - Close a motion with enough votes or that has expired.
  • set_rule - Initialize or update the Alliance's rule by IPFS CID.
  • announce - Make announcement by IPFS CID.
  • nominate_ally - Nominate a non-member to become an Ally, without deposit.
  • elevate_ally - Approve an ally to become a Fellow.
  • kick_member - Kick a member and slash its deposit.
  • add_unscrupulous_items - Add some items, either accounts or websites, to the list of unscrupulous items.
  • remove_unscrupulous_items - Remove some items from the list of unscrupulous items.
  • abdicate_fellow_status - Abdicate one's voting rights, demoting themself to Ally.

Root Calls

  • init_members - Initialize the Alliance, onboard fellows and allies.
  • disband - Disband the Alliance, remove all active members and unreserve deposits.