Enum game_of_chance_io::Action

pub enum Action {
    Start {
        duration: u64,
        participation_cost: u128,
        fungible_token: Option<ActorId>,
    },
    PickWinner,
    Enter,
}

Sends the contract info about what it should do.

Variants

Start

Fields

duration: u64

The duration (in milliseconds) of the players entry stage.

After that, no one will be able to enter a game round and a winner should be picked.

participation_cost: u128

The price of a participation in a game round.

fungible_token: Option<ActorId>

A currency (or FT contract [ActorId]) of a game round.

Determines fungible tokens in which a prize fund and a participation cost will be collected. None means that the native value will be used instead of fungible tokens.

Starts a game round and allows to participate in it.

Requirements

• msg::source() must be the game administrator.
• The current game round must be over.
• ft_actor_id mustn’t be [ActorId::zero()].

On success, replies with Event::Started.

PickWinner

Randomly picks a winner from current game round participants (players) and sends a prize fund to it.

The randomness of a winner pick depends on exec::block_timestamp(). Not the best source of entropy, but, in theory, it’s impossible to exactly predict a winner if the time of an execution of this action is unknown.

If no one participated in the round, then a winner will be [ActorId::zero()].

Requirements

• msg::source() must be the game administrator.
• The players entry stage must be over.
• A winner mustn’t already be picked.

On success, replies with Event::Winner.

Enter

Pays a participation cost and adds msg::source() to the current game round participants (players).

A participation cost and its currency can be queried from the contract state.

Requirements

• The players entry stage mustn’t be over.
• msg::source() mustn’t already participate.
• msg::source() must have enough currency to pay a participation cost.
• If the current game round currency is the native value (fungible_token is None), msg::source() must send this action with the amount of the value exactly equal to a participation cost.

On success, replies with Event::PlayerAdded.

Trait Implementations

impl Clone for Action

fn clone(&self) -> Action

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Action

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

Formats the value using the given formatter.

impl Decode for Action

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

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self> ) -> Result<DecodeFinished, Error>where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl Encode for Action

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

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

fn size_hint(&self) -> usize

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

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

Convert self to an owned vector.

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

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

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl Hash for Action

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Action

fn cmp(&self, other: &Action) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<Action> for Action

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

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

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

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

impl PartialOrd<Action> for Action

fn partial_cmp(&self, other: &Action) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl TypeInfo for Action

type Identity = Action

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl Copy for Action

impl EncodeLike<Action> for Action

impl Eq for Action

impl StructuralEq for Action

impl StructuralPartialEq for Action