Struct ContractModerationReason 

pub struct ContractModerationReason {
    pub code: Option<u16>,
    pub text: String,
    pub documents: Vec<ContractModerationDocument>,
    pub reason_document_id: Option<Identifier>,
}

Why a moderator banned, suspended or warned an identity, or deleted a document. Every such action carries one, and it is stored with the entry or the record, so whoever reads the list reads the reason.

Nothing checks what a moderator writes: the text is free, so is the code, and the documents a reason cites are not looked up. A cited document may have been deleted since, by its author or by a moderator (whose deletion left a record), or may never have existed. The one exception is the reason document a seated elected team names: it must be one its proposal lists.

Fields

code: Option<u16>

Reserved for the ban codes a contract may declare in a later protocol version. No contract declares any today, so this is expected to be None. A value is accepted and stored as written, and is not checked against anything.

text: String

Free text, at most SystemLimits::max_contract_moderation_reason_length bytes of UTF-8. May be empty.

documents: Vec<ContractModerationDocument>

The documents the reason is about: the posts a warning or a ban is for, at most SystemLimits::max_contract_moderation_reason_documents, none twice. Left out of the JSON when there are none.

reason_document_id: Option<Identifier>

The reason document of the moderation charters system contract the action is taken on (protocol version 14). A seated elected team’s ban, suspension, warning or document deletion must name one its proposal lists (ModerationReasonNotListedError); for every other moderator it is stored as written and checked against nothing. Last, so that a reason written before it existed decodes; left out of the JSON when there is none.

Implementations

impl ContractModerationReason

pub fn from_text(text: impl Into<String>) -> Self

A reason without a code, about no document, naming no reason document.

pub fn with_reason_document(self, reason_document_id: Identifier) -> Self

The same reason, naming the reason document reason_document_id.

pub fn with_documents(self, documents: Vec<ContractModerationDocument>) -> Self

The same reason, about documents.

pub fn validate( &self, platform_version: &PlatformVersion, ) -> SimpleConsensusValidationResult

Checks the length of the text and the documents cited: at most the limit, each with a document type name a contract could admit (one to 64 bytes), and none twice. The code is not checked, and neither is whether a cited document, or its type, exists.

Trait Implementations

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

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 ContractModerationReason

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 ContractModerationReason

fn clone(&self) -> ContractModerationReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContractModerationReason

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

Formats the value using the given formatter.

impl<__Context> Decode<__Context> for ContractModerationReason

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 ContractModerationReason

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 ContractModerationReason

fn default() -> ContractModerationReason

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ContractModerationReason

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encode for ContractModerationReason

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

Encode a given type.

impl Eq for ContractModerationReason

impl JsonSafeFields for ContractModerationReason

Available on crate feature json-conversion only.

impl PartialEq for ContractModerationReason

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContractModerationReason

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ContractModerationReason