Enum RejectedReason 

pub enum RejectedReason<N>
where
    N: Network,
{
    DuplicateProgramID(ProgramID<N>),
    Finalize {
        program_id: ProgramID<N>,
        edition: u16,
        resource: Identifier<N>,
        index: usize,
        command: Box<Command<N>>,
    },
    VM(Option<(ProgramID<N>, u16)>, Option<Identifier<N>>),
}

The reason a transaction was rejected.

Variants

DuplicateProgramID(ProgramID<N>)

The transaction was rejected due to a duplicate program ID deployment in the same block.

Finalize

The transaction was rejected due to a failed finalize command. (program ID, edition, resource, index, command). Note: We do not log the actual error message from the finalize command, as it may contain sensitive information or lead to DOS vectors by storing string representations of large structs.

Fields

program_id: ProgramID<N>

edition: u16

resource: Identifier<N>

index: usize

command: Box<Command<N>>

VM(Option<(ProgramID<N>, u16)>, Option<Identifier<N>>)

The transaction was rejected due to a VM error not captured by a finalize command. The programID and resource are logged if they are available.

Implementations

impl<N> RejectedReason<N>

where N: Network,

pub fn from_indexed_finalize_error<C>( error: IndexedFinalizeError<N, C>, ) -> RejectedReason<N>

where C: ToString,

Initializes the rejected reason from an indexed finalize error.

C may be any type whose Display output is a valid Command<N> string (e.g. Command<N> itself or String). If the command string cannot be re-parsed, the reason falls back to VM so that a bad string never causes a panic in consensus code.

Trait Implementations

impl<N> Clone for RejectedReason<N>

where N: Clone + Network,

fn clone(&self) -> RejectedReason<N>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<N> Debug for RejectedReason<N>

where N: Network,

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

Prints the rejected reason as a JSON-string.

impl<'de, N> Deserialize<'de> for RejectedReason<N>

where N: Network,

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

where D: Deserializer<'de>,

Deserializes the rejected reason from a string or bytes.

impl<N> Display for RejectedReason<N>

where N: Network,

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

Displays the rejected reason as a JSON-string.

impl<N> FromBytes for RejectedReason<N>

where N: Network,

fn read_le<R>(reader: R) -> Result<RejectedReason<N>, Error>

where R: Read,

Reads the rejected reason from a buffer.

fn from_bytes_le(bytes: &[u8]) -> Result<Self, Error>

where Self: Sized,

Returns Self from a byte array in little-endian order.

fn from_bytes_le_unchecked(bytes: &[u8]) -> Result<Self, Error>

where Self: Sized,

Same behavior as Self::from_bytes_le but avoids costly checks. This shall only be called when deserializing from a trusted source, such as local storage.

fn read_le_unchecked<R>(reader: R) -> Result<Self, Error>

where R: Read, Self: Sized,

Same behavior as Self::read_le but avoids costly checks. This shall only be called when deserializing from a trusted source, such as local storage.

fn read_le_with_unchecked<R>(reader: R, unchecked: bool) -> Result<Self, Error>

where R: Read, Self: Sized,

Helper function that deserializes either unchecked or checked based on the given boolean flag.

impl<N> FromStr for RejectedReason<N>

where N: Network,

fn from_str( reason: &str, ) -> Result<RejectedReason<N>, <RejectedReason<N> as FromStr>::Err>

Initializes the rejected reason from a JSON-string.

type Err = Error

The associated error which can be returned from parsing.

impl<N> PartialEq for RejectedReason<N>

where N: PartialEq + Network,

fn eq(&self, other: &RejectedReason<N>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<N> Serialize for RejectedReason<N>

where N: Network,

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

where S: Serializer,

Serializes the rejected reason into string or bytes.

impl<N> ToBytes for RejectedReason<N>

where N: Network,

fn write_le<W>(&self, writer: W) -> Result<(), Error>

where W: Write,

Writes the rejected reason to a buffer.

fn to_bytes_le(&self) -> Result<Vec<u8>, Error>

where Self: Sized,

Returns self as a byte array in little-endian order.

impl<N> Eq for RejectedReason<N>

where N: Eq + Network,

impl<N> StructuralPartialEq for RejectedReason<N>

where N: Network,