Enum ContractModerators 

pub enum ContractModerators {
    ContractOwner,
    AppointedModerators(BTreeSet<Identifier>),
    Elected(Box<ElectedModerators>),
}

Who may send a ContractUserModeration transition for the contract.

With the first two kinds the contract owner always may, named or not; a moderator set is fixed in the config and changed only by a contract update. With the third the moderators are an elected team, and until one is seated the interim moderators the declaration names; the declaration is fixed at creation and never changes.

Variants

ContractOwner

Only the contract owner moderates.

AppointedModerators(BTreeSet<Identifier>)

The moderators the contract appoints, beside its owner, who always may moderate. Non-empty, at most SystemLimits::max_contract_moderators, each an identity that exists. The owner may be appointed too, and then counts toward that limit; appointing it changes nothing about who may moderate.

Elected(Box<ElectedModerators>)

A team elected by masternodes moderates, once one is seated; until then the interim moderators of the declaration do. Declarable only when the contract is created, and never left or changed by an update. Boxed: the declaration is the largest kind by far, and a contract’s config is embedded by value wherever a contract is.

Implementations

impl ContractModerators

pub fn identity_ids(&self) -> Option<&BTreeSet<Identifier>>

The identities the kind names, the owner among them only when it is named: the appointed set, or the appointed interim set of an elected declaration. None when nobody is named.

pub fn names(&self, identity_id: &Identifier) -> bool

Whether identity_id is one of the identities the kind names.

pub fn elected(&self) -> Option<&ElectedModerators>

The elected declaration, None for the merged kinds.

pub fn may_moderate( &self, owner_id: &Identifier, identity_id: &Identifier, ) -> bool

Whether identity_id may moderate a contract owned by owner_id. Under an elected declaration, whether it may during the interim: the owner alone, the owner and the appointed interim set, or nobody, the moderated types unusable or unmoderated meanwhile.

Once a charter is seated on an elected contract its team moderates instead, and the interim moderators no longer may. Who is on the team is read from the moderation charters contract, so that is decided where state is read, not here.

pub fn protects(&self, owner_id: &Identifier, identity_id: &Identifier) -> bool

Whether identity_id is protected from moderation on a contract owned by owner_id: it can be neither banned nor suspended, and its documents can not be deleted. Whoever may moderate is, and so is the owner of an elected contract whose declaration says so. Under an elected declaration this is the interim’s protection; once a charter is seated, the leader and the active members of its team are protected instead, with the owner when the declaration says so, as state says.

pub fn interim_blocks_document_type(&self, document_type_name: &str) -> bool

Whether every document transition of the document type is refused while no team is seated: an elected declaration in its interim with nobody moderating blocks its moderated types until one is. Whether one is, is state’s to say.

pub fn team(&self, owner_id: &Identifier) -> BTreeSet<Identifier>

The moderation team of a contract owned by owner_id: the identities that share its moderators fee pot. It is the set the contract appoints, the owner among them only when appointed, and the owner alone when nobody is appointed. Under an elected declaration it is the interim’s team: the same by kind, and nobody while the moderated types are not yet usable, so that the pot accumulates for the team to come.

The team is about earnings, not authority: an owner who is not on it still may moderate (Self::may_moderate).

Like Self::may_moderate and Self::protects, this reads the config alone, so for an elected contract it describes the interim only. Once a charter is seated its claim of the moderators pot is refused and its moderations too; who is on the seated team is read from the moderation charters contract, which a client asks rather than this.

Trait Implementations

impl<'__de, __Context> BorrowDecode<'__de, __Context> for ContractModerators

fn borrow_decode<__D: BorrowDecoder<'__de, Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given BorrowDecode.

impl<'__de, __Context> BorrowDecodeUntrusted<'__de, __Context> for ContractModerators

fn borrow_decode_untrusted<__D: BorrowUntrustedDecoder<'__de, Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Borrow-decode with explicit untrusted field dispatch and resource handling.

impl Clone for ContractModerators

fn clone(&self) -> ContractModerators

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ContractModerators

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<__Context> Decode<__Context> for ContractModerators

fn decode<__D: Decoder<Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.

impl<__Context> DecodeUntrusted<__Context> for ContractModerators

fn decode_untrusted<__D: UntrustedDecoder<Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Decode with explicit untrusted field dispatch and resource handling.

impl Default for ContractModerators

fn default() -> ContractModerators

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ContractModerators

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for ContractModerators

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Encode for ContractModerators

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), EncodeError>

Encode a given type.

impl Eq for ContractModerators

impl JsonSafeFields for ContractModerators

Available on crate feature json-conversion only.

impl PartialEq for ContractModerators

fn eq(&self, other: &ContractModerators) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ContractModerators

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ContractModerators