Struct ProposedBlock

pub struct ProposedBlock {
    pub chain_id: ChainId,
    pub epoch: Epoch,
    pub transactions: Vec<Transaction>,
    pub height: BlockHeight,
    pub timestamp: Timestamp,
    pub authenticated_owner: Option<AccountOwner>,
    pub previous_block_hash: Option<CryptoHash>,
}

A block containing operations to apply on a given chain, as well as the acknowledgment of a number of incoming messages from other chains.

• Incoming messages must be selected in the order they were produced by the sending chain, but can be skipped.
• When a block is proposed to a validator, all cross-chain messages must have been received ahead of time in the inbox of the chain.
• This constraint does not apply to the execution of confirmed blocks.

Fields

chain_id: ChainId

The chain to which this block belongs.

epoch: Epoch

The number identifying the current configuration.

transactions: Vec<Transaction>

The transactions to execute in this block. Each transaction can be either incoming messages or an operation.

height: BlockHeight

The block height.

timestamp: Timestamp

The timestamp when this block was created. This must be later than all messages received in this block, but no later than the current time.

authenticated_owner: Option<AccountOwner>

The user signing for the operations in the block and paying for their execution fees. If set, this must be the owner in the block proposal. None means that the default account of the chain is used. This value is also used as recipient of potential refunds for the message grants created by the operations.

previous_block_hash: Option<CryptoHash>

Certified hash (see Certificate below) of the previous block in the chain, if any.

Implementations

impl ProposedBlock

pub async fn chain_id(&self, ctx: &Context<'_>) -> Result<&ChainId>

pub async fn epoch(&self, ctx: &Context<'_>) -> Result<&Epoch>

pub async fn height(&self, ctx: &Context<'_>) -> Result<&BlockHeight>

pub async fn timestamp(&self, ctx: &Context<'_>) -> Result<&Timestamp>

pub async fn authenticated_owner( &self, ctx: &Context<'_>, ) -> Result<&Option<AccountOwner>>

pub async fn previous_block_hash( &self, ctx: &Context<'_>, ) -> Result<&Option<CryptoHash>>

impl ProposedBlock

pub fn published_blob_ids(&self) -> BTreeSet<BlobId>

Returns all the published blob IDs in this block’s operations.

pub fn has_only_rejected_messages(&self) -> bool

Returns whether the block contains only rejected incoming messages, which makes it admissible even on closed chains.

pub fn incoming_messages(&self) -> impl Iterator<Item = &PostedMessage>

Returns an iterator over all incoming PostedMessages in this block.

pub fn message_count(&self) -> usize

Returns the number of incoming messages.

pub fn transaction_refs(&self) -> impl Iterator<Item = &Transaction>

Returns an iterator over all transactions as references.

pub fn operations(&self) -> impl Iterator<Item = &Operation>

Returns all operations in this block.

pub fn incoming_bundles(&self) -> impl Iterator<Item = &IncomingBundle>

Returns all incoming bundles in this block.

pub fn check_proposal_size( &self, maximum_block_proposal_size: u64, ) -> Result<(), ChainError>

Trait Implementations

impl BlockTestExt for ProposedBlock

fn with_authenticated_owner( self, authenticated_owner: Option<AccountOwner>, ) -> Self

Returns the block with the given authenticated owner.

fn with_operation(self, operation: impl Into<Operation>) -> Self

Returns the block with the given operation appended at the end.

fn with_transfer( self, owner: AccountOwner, recipient: Account, amount: Amount, ) -> Self

Returns the block with a transfer operation appended at the end.

fn with_simple_transfer(self, chain_id: ChainId, amount: Amount) -> Self

Returns the block with a simple transfer operation appended at the end.

fn with_burn(self, amount: Amount) -> Self

Returns the block with the burn operation (transfer to a special address) appended at the end.

fn with_incoming_bundle(self, incoming_bundle: IncomingBundle) -> Self

Returns the block with the given message appended at the end.

fn with_timestamp(self, timestamp: impl Into<Timestamp>) -> Self

Returns the block with the specified timestamp.

fn with_epoch(self, epoch: impl Into<Epoch>) -> Self

Returns the block with the specified epoch.

async fn into_proposal_with_round<S: Signer + ?Sized>( self, owner: AccountOwner, signer: &S, round: Round, ) -> Result<BlockProposal, S::Error>

Returns a block proposal without any hashed certificate values or validated block.

async fn into_first_proposal<S: Signer + ?Sized>( self, owner: AccountOwner, signer: &S, ) -> Result<BlockProposal, S::Error>

Returns a block proposal in the first round in a default ownership configuration (Round::MultiLeader(0)) without any hashed certificate values or validated block.

impl Clone for ProposedBlock

fn clone(&self) -> ProposedBlock

Returns a copy of the value.

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

Performs copy-assignment from source.

impl ContainerType for ProposedBlock

async fn resolve_field(&self, ctx: &Context<'_>) -> ServerResult<Option<Value>>

Resolves a field value and outputs it as a json value async_graphql::Value.

fn collect_all_fields<'a>( &'a self, ctx: &ContextBase<'a, &'a Positioned<SelectionSet>>, fields: &mut Fields<'a>, ) -> Result<(), ServerError>

where Self: Send + Sync,

Collect all the fields of the container that are queried in the selection set.

fn find_entity( &self, _: &ContextBase<'_, &Positioned<Field>>, _params: &ConstValue, ) -> impl Future<Output = Result<Option<ConstValue>, ServerError>> + Send

Find the GraphQL entity with the given name from the parameter.

impl Debug for ProposedBlock

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProposedBlock

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for ProposedBlock

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 OutputType for ProposedBlock

fn type_name() -> Cow<'static, str>

Type the name.

fn create_type_info(registry: &mut Registry) -> String

Create type information in the registry and return qualified typename.

async fn resolve( &self, ctx: &ContextSelectionSet<'_>, _field: &Positioned<Field>, ) -> ServerResult<Value>

Resolve an output value to async_graphql::Value.

fn qualified_type_name() -> String

Qualified typename.

fn introspection_type_name(&self) -> Cow<'static, str>

Introspection type name

impl PartialEq for ProposedBlock

fn eq(&self, other: &ProposedBlock) -> 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 Serialize for ProposedBlock

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ProposedBlock

impl ObjectType for ProposedBlock

impl StructuralPartialEq for ProposedBlock