Crate odra

A Rust library for writing smart contracts for the Casper Blockchain.

Example

The following example is a simple counter smart contract. The contract stores a single value, which can be incremented or decremented. The counter value can be initialized at contract creation time.

use odra::prelude::*;

#[odra::module]
struct Counter {
    count: odra::Var<u32>,
}

#[odra::module]
impl Counter {
    pub fn init(&mut self, count: u32) {
        self.count.set(count);
    }

    pub fn increment(&mut self) {
        self.count.set(self.count.get_or_default() + 1);
    }

    pub fn decrement(&mut self) {
        self.count.set(self.count.get_or_default() - 1);
    }

    pub fn get_count(&self) -> u32 {
        self.count.get_or_default()
    }
}

Re-exports

• pub use odra_core::casper_event_standard;
• pub use odra_core::casper_types;
• pub use odra_schema as schema;

Modules

• args
  This module provides types and traits for working with entrypoint arguments.
• arithmetic
  Safe, overflowing addition and subtraction utilities.
• contract_def
  Encapsulates a set of structures that abstract out a smart contract layout.
• entry_point_callback
  A module that contains structs representing entry points and entry point callers.
• host
  A module that provides the interface for interacting with the host environment.
• module
  Module definition and implementation.
• prelude
  Common API for no_std and std to access alloc and core crate types.
• uints
  Unsigned integer utilities.

Structs

• CallDef
  Represents a call definition, which includes the method name, runtime arguments, attached value, and mutability flag.
• ContractCallResult
  Represents the result of a contract call.
• ContractEnv
  Represents the environment accessible in the contract context.
• ExecutionEnv
  Represents the environment accessible in the contract execution context.
• List
  Data structure for an indexed, iterable collection.
• ListIter
  An iterator over the elements of a List.
• Mapping
  Data structure for storing key-value pairs.
• Sequence
  A module that stores a single value in the storage that can be read or incremented.
• SubModule
  A wrapper struct for a module implementing the Module trait.
• Var
  Data structure for storing a single value.

Enums

• Address
  An enum representing an AccountHash or a ContractPackageHash.
• AddressError
  Error that can occur while operating on an Address.
• CollectionError
  Error that can occur while operating on a collection.
• DeployReport
  Represents a deploy report, which includes the gas used and the deploy details.
• EventError
  Event-related errors.
• ExecutionError
  An error that can occur during smart contract execution
• OdraError
  General error type in Odra framework
• VmError
  An internal virtual machine error

Traits

• ContractContext
  Trait representing the context of a smart contract.
• ContractRef
  Trait that needs to be implemented by all contract refs.
• UnwrapOrRevert
  A trait that allows safe unwrapping in the context of a smart contract. On failure the contract does not panic, but reverts calling ContractEnv::revert. Works with Result and Option.

Type Aliases

• GasReport
  A Vector of deploy reports makes a full gas report.
• OdraResult
  Represents the result of a contract call.

Attribute Macros

• event
  This macro is used to implement the boilerplate code for the event and contract schema.
• external_contract
  Provides implementation of a reference to an external contract.
• module
  Core element of the Odra framework, entry point for writing smart contracts.
• odra_error
  Implements Into<odra::OdraError> for an error enum.
• odra_type
  Implements boilerplate for a type to be used in an Odra module.

Derive Macros

• Event
• IntoRuntimeArgs
  Implements Into<odra::casper_types::RuntimeArgs> for a struct.