Enum serp_example_ocw::Call

pub enum Call<T: Trait> {
    submit_price(u32),
    submit_price_unsigned(T::BlockNumber, u32),
    submit_price_unsigned_with_signed_payload(PricePayload<T::Public, T::BlockNumber>, T::Signature),
    // some variants omitted
}

Dispatchable calls.

Each variant of this enum maps to a dispatchable function from the associated module.

Variants

submit_price(u32)

Submit new price to the list.

This method is a public function of the module and can be called from within a transaction. It appends given price to current list of prices. In our example the offchain worker will create, sign & submit a transaction that calls this function passing the price.

The transaction needs to be signed (see ensure_signed) check, so that the caller pays a fee to execute it. This makes sure that it’s not easy (or rather cheap) to attack the chain by submitting excesive transactions, but note that it doesn’t ensure the price oracle is actually working and receives (and provides) meaningful data. This example is not focused on correctness of the oracle itself, but rather its purpose is to showcase offchain worker capabilities.

submit_price_unsigned(T::BlockNumber, u32)

Submit new price to the list via unsigned transaction.

Works exactly like the submit_price function, but since we allow sending the transaction without a signature, and hence without paying any fees, we need a way to make sure that only some transactions are accepted. This function can be called only once every T::UnsignedInterval blocks. Transactions that call that function are de-duplicated on the pool level via validate_unsigned implementation and also are rendered invalid if the function has already been called in current “session”.

It’s important to specify weight for unsigned calls as well, because even though they don’t charge fees, we still don’t want a single block to contain unlimited number of such transactions.

This example is not focused on correctness of the oracle itself, but rather its purpose is to showcase offchain worker capabilities.

submit_price_unsigned_with_signed_payload(PricePayload<T::Public, T::BlockNumber>, T::Signature)

Trait Implementations

impl<T: Trait> Clone for Call<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Trait> Debug for Call<T>

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

Formats the value using the given formatter.

impl<T: Trait> Decode for Call<T> where
    T::BlockNumber: Decode,
    T::BlockNumber: Decode,
    PricePayload<T::Public, T::BlockNumber>: Decode,
    PricePayload<T::Public, T::BlockNumber>: Decode,
    T::Signature: Decode,
    T::Signature: Decode, 

fn decode<__CodecInputEdqy: Input>(
    __codec_input_edqy: &mut __CodecInputEdqy
) -> Result<Self, Error>

Attempt to deserialise the value from input.

impl<T: Trait> Encode for Call<T> where
    T::BlockNumber: Encode,
    T::BlockNumber: Encode,
    PricePayload<T::Public, T::BlockNumber>: Encode,
    PricePayload<T::Public, T::BlockNumber>: Encode,
    T::Signature: Encode,
    T::Signature: Encode, 

fn encode_to<__CodecOutputEdqy: Output>(
    &self,
    __codec_dest_edqy: &mut __CodecOutputEdqy
)

Convert self to a slice and append it to the destination.

pub fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

pub fn encode(&self) -> Vec<u8, Global>

Convert self to an owned vector.

pub fn using_encoded<R, F>(&self, f: F) -> R where
    F: FnOnce(&[u8]) -> R, 

Convert self to a slice and then invoke the given closure with it.

impl<T: Trait> EncodeLike<Call<T>> for Call<T> where
    T::BlockNumber: Encode,
    T::BlockNumber: Encode,
    PricePayload<T::Public, T::BlockNumber>: Encode,
    PricePayload<T::Public, T::BlockNumber>: Encode,
    T::Signature: Encode,
    T::Signature: Encode, 

impl<T: Trait> Eq for Call<T>

impl<T: Trait> GetCallName for Call<T>

fn get_call_name(&self) -> &'static str

Return the function name of the Call.

fn get_call_names() -> &'static [&'static str]

Return all function names.

impl<T: Trait> GetDispatchInfo for Call<T>

fn get_dispatch_info(&self) -> DispatchInfo

Return a DispatchInfo, containing relevant information of this dispatch.

impl<T: Trait> PartialEq<Call<T>> for Call<T>

fn eq(&self, _other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: Trait> UnfilteredDispatchable for Call<T>

type Origin = T::Origin

The origin type of the runtime, (i.e. frame_system::Trait::Origin).

fn dispatch_bypass_filter(
    self,
    _origin: Self::Origin
) -> DispatchResultWithPostInfo

Dispatch this call but do not check the filter in origin.