Struct BlobTransactionSidecar

#[repr(C)]
pub struct BlobTransactionSidecar {
    pub blobs: Vec<Blob>,
    pub commitments: Vec<Bytes48>,
    pub proofs: Vec<Bytes48>,
}

Available on crate feature kzg-sidecar only.

This represents a set of blobs, and its corresponding commitments and proofs.

This type encodes and decodes the fields without an rlp header.

Fields

blobs: Vec<Blob>

The blob data.

commitments: Vec<Bytes48>

The blob commitments.

proofs: Vec<Bytes48>

The blob proofs.

Implementations

impl BlobTransactionSidecar

pub const fn new( blobs: Vec<Blob>, commitments: Vec<Bytes48>, proofs: Vec<Bytes48>, ) -> Self

Constructs a new BlobTransactionSidecar from a set of blobs, commitments, and proofs.

pub fn from_kzg( blobs: Vec<Blob>, commitments: Vec<Bytes48>, proofs: Vec<Bytes48>, ) -> Self

Available on crate feature kzg only.

Creates a new instance from the given KZG types.

pub fn validate( &self, blob_versioned_hashes: &[B256], proof_settings: &KzgSettings, ) -> Result<(), BlobTransactionValidationError>

Available on crate feature kzg only.

Verifies that the versioned hashes are valid for this sidecar’s blob data, commitments, and proofs.

Takes as input the KzgSettings, which should contain the parameters derived from the KZG trusted setup.

This ensures that the blob transaction payload has the same number of blob data elements, commitments, and proofs. Each blob data element is verified against its commitment and proof.

Returns BlobTransactionValidationError::InvalidProof if any blob KZG proof in the response fails to verify, or if the versioned hashes in the transaction do not match the actual commitment versioned hashes.

pub fn versioned_hashes(&self) -> impl Iterator<Item = B256> + '_

Returns an iterator over the versioned hashes of the commitments.

pub fn versioned_hash_for_blob(&self, blob_index: usize) -> Option<B256>

Returns the versioned hash for the blob at the given index, if it exists.

pub fn size(&self) -> usize

Calculates a size heuristic for the in-memory size of the BlobTransactionSidecar.

pub fn try_from_blobs(blobs: Vec<Blob>) -> Result<Self, Error>

Available on crate features kzg and arbitrary only.

Tries to create a new BlobTransactionSidecar from the given blobs.

pub fn rlp_encoded_length(&self) -> usize

Calculates the length of the BlobTransactionSidecar when encoded as RLP.

pub fn rlp_encode(&self, out: &mut dyn BufMut)

Encodes the BlobTransactionSidecar as RLP bytes.

pub fn rlp_decode(buf: &mut &[u8]) -> Result<Self>

Decodes the BlobTransactionSidecar from RLP bytes.

Trait Implementations

impl<'a> Arbitrary<'a> for BlobTransactionSidecar

Available on crate feature arbitrary only.

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for BlobTransactionSidecar

fn clone(&self) -> BlobTransactionSidecar

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BlobTransactionSidecar

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

Formats the value using the given formatter.

impl Decodable for BlobTransactionSidecar

fn decode(buf: &mut &[u8]) -> Result<Self>

Decodes the inner BlobTransactionSidecar fields from RLP bytes, without a RLP header.

impl Default for BlobTransactionSidecar

fn default() -> BlobTransactionSidecar

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BlobTransactionSidecar

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encodable for BlobTransactionSidecar

fn encode(&self, out: &mut dyn BufMut)

Encodes the inner BlobTransactionSidecar fields as RLP bytes, without a RLP header.

fn length(&self) -> usize

Returns the length of the encoding of this type in bytes.

impl Hash for BlobTransactionSidecar

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 IntoIterator for BlobTransactionSidecar

type Item = BlobTransactionSidecarItem

The type of the elements being iterated over.

type IntoIter = IntoIter<BlobTransactionSidecarItem>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for BlobTransactionSidecar

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

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 BlobTransactionSidecar

impl StructuralPartialEq for BlobTransactionSidecar