Crate linera_execution 

This module manages the execution of the system application and the user applications in a Linera chain.

Re-exports

pub use crate::committee::Committee;

pub use crate::committee::SharedCommittees;

pub use crate::execution_state_actor::ExecutionRequest;

pub use crate::execution_state_actor::ExecutionStateActor;

pub use crate::system::SystemExecutionStateView;

pub use crate::system::SystemMessage;

pub use crate::system::SystemOperation;

pub use crate::system::SystemQuery;

pub use crate::system::SystemResponse;

Modules

committee

The committee of validators and their voting weights for an epoch.

evm

Support for user applications compiled for the EVM

execution_state_actor

Handle requests from the synchronous execution thread of user applications.

system

The system application implementing core chain functionality.

test_utils

Helpers for writing tests that exercise the execution layer.

wasm_test

This assumes that the current directory is one of the crates.

Structs

BaseRuntimeApi

An implementation of the runtime API used to access the common behaviour and the view storage for both contracts and services.

BlobState

The state of a blob of binary data.

ContractEntrypoints

ContractRuntimeApi

An implementation of the system API made available to contracts.

ExecutionRuntimeConfig

Configuration options for the execution runtime available to applications.

ExecutionStateView

A view accessing the execution state of a chain.

FinalizeContext

The context in which a transaction is finalized.

InvalidWasmRuntime

Attempts to create an invalid WasmRuntime instance from a string.

JsVec

A wrapper around a Vec that can be converted to and from a JavaScript array.

MessageContext

The context in which a message is executed.

OperationContext

The context in which an operation is executed.

OutgoingMessage

A posted message together with routing information.

PreparedCheckpoint

Pre-block-computed inputs for a SystemOperation::Checkpoint transaction.

ProcessStreamsContext

The context in which stream updates are processed.

QueryContext

The context in which a query is executed.

QueryOutcome

The outcome of the execution of a query.

ResourceControlPolicy

A collection of prices and limits associated with block execution.

ResourceController

Tracks and controls the resources used during execution, charging fees against an account.

ResourceTracker

The resources used so far by an execution process. Acts as an accumulator for all resources consumed during a specific execution flow. This could be the execution of a block, the processing of a single message, or a specific phase within these broader operations.

RuntimeApiData

Common host data used as the UserData of the system API implementations.

ServiceEntrypoints

ServiceRuntimeApi

An implementation of the system API made available to services.

ServiceRuntimeEndpoint

How to interact with a long-lived service runtime.

ServiceSyncRuntime

The synchronous runtime used to execute service queries.

TestExecutionRuntimeContext

An in-memory ExecutionRuntimeContext implementation used in tests.

ThreadPool

A pool of shared resources, each of which can only be used once at a time.

TransactionOutcome

The TransactionTracker contents after a transaction has finished.

TransactionTracker

Tracks oracle responses and execution outcomes of an ongoing transaction execution, as well as replayed oracle responses.

UserContractCode

An implementation of UserContractModule.

UserServiceCode

An implementation of UserServiceModule.

Enums

BlobOrigin

Provenance of a stored blob: either defined by the genesis config (and thus known a priori to every node holding that config) or published by a confirmed block on some chain.

EvmRuntime

The runtime to use for running EVM smart contracts.

ExecutionError

A type for errors happening during execution.

Message

A message to be sent and possibly executed in the receiver’s block.

MessageKind

The kind of outgoing message being sent.

Operation

An operation to be executed in a block.

ProtocolFlag

A flag that enables an optional protocol feature.

Query

An query to be sent and possibly executed in the receiver’s block.

QueryResponse

The response to a query.

ServiceRuntimeRequest

A request to the service runtime actor.

WasmContractModule

A user contract in a compiled WebAssembly module.

WasmExecutionError

Errors that can occur when executing a user application in a WebAssembly module.

WasmRuntime

The runtime to use for running the application.

WasmServiceModule

A user service in a compiled WebAssembly module.

Constants

LINERA_SOL

The Linera.sol library code to be included in solidity smart contracts using Linera features.

LINERA_TYPES_SOL

The LineraTypes.sol library code defining the Solidity types used to interface with Linera features.

Traits

BalanceHolder

How to access the balance of an account.

BaseRuntime

The runtime API shared by the contract and service parts of an application.

ContractRuntime

The runtime API available to the contract part of an application.

ExecutionRuntimeContext

Requirements for the extra field in our state views (and notably the ExecutionStateView).

ServiceRuntime

The runtime API available to the service part of an application.

UserContract

The public entry points provided by the contract part of an application.

UserContractModule

A factory trait to obtain a UserContract from a UserContractModule

UserService

The public entry points provided by the service part of an application.

UserServiceModule

A factory trait to obtain a UserService from a UserServiceModule

WithWasmDefault

Trait used to select a default WasmRuntime, if one is available.

Type Aliases

ContractSyncRuntimeHandle

A handle to the synchronous runtime used when executing contracts.

ServiceSyncRuntimeHandle

A handle to the synchronous runtime used when executing services.

UserContractInstance

An implementation of UserContract.

UserServiceInstance

An implementation of UserService.