eip4844 0.8.0

This crate provides an implementation of the cryptography needed for EIP-4844
Documentation
use bls12_381::{lincomb::g1_lincomb, traits::*};
use serialization::{
    deserialize_blob_to_scalars, deserialize_bytes_to_scalar, deserialize_compressed_g1,
    serialize_g1_compressed,
    types::{Bytes48Ref, KZGCommitment, KZGProof as KZGProof4844, SerializedScalar},
};

use crate::{
    verifier::{blob_scalar_to_polynomial, compute_fiat_shamir_challenge},
    BlobRef, Context, Error,
};

impl Context {
    /// Computes the KZG commitment to the polynomial represented by the blob.
    ///
    /// The matching function in the specs is: https://github.com/ethereum/consensus-specs/blob/13ac373a2c284dc66b48ddd2ef0a10537e4e0de6/specs/deneb/polynomial-commitments.md#blob_to_kzg_commitment
    pub fn blob_to_kzg_commitment(&self, blob: BlobRef) -> Result<KZGCommitment, Error> {
        // Deserialize the blob into scalars.
        let blob_scalar = deserialize_blob_to_scalars(blob)?;

        // Convert blob into monomial form.
        let polynomial = blob_scalar_to_polynomial(&self.prover.domain, &blob_scalar);

        // Compute commitment in monomial form.
        let commitment = g1_lincomb(&self.prover.commit_key.g1s, &polynomial)
            .expect("commit_key.g1s.len() == polynomial.len()")
            .to_affine();

        // Serialize the commitment.
        Ok(serialize_g1_compressed(&commitment))
    }

    /// Compute the KZG proof given a blob and a point.
    ///
    /// The matching function in the specs is: https://github.com/ethereum/consensus-specs/blob/017a8495f7671f5fff2075a9bfc9238c1a0982f8/specs/deneb/polynomial-commitments.md#compute_kzg_proof
    #[cfg_attr(feature = "tracing", tracing::instrument(skip_all))]
    pub fn compute_kzg_proof(
        &self,
        blob: BlobRef,
        z: SerializedScalar,
    ) -> Result<(KZGProof4844, SerializedScalar), Error> {
        // Deserialize the blob into scalars.
        let blob_scalar = deserialize_blob_to_scalars(blob)?;

        // Convert blob into monomial form.
        let polynomial = blob_scalar_to_polynomial(&self.prover.domain, &blob_scalar);

        // Deserialize the point into scalar.
        let z = deserialize_bytes_to_scalar(&z)?;

        // Compute evaluation and commitment to quotient at challenge.
        let (proof, y) = self.prover.compute_kzg_proof(&polynomial, z);

        // Serialize the commitment.
        Ok((serialize_g1_compressed(&proof), y.to_bytes_be()))
    }

    /// Compute the KZG proof given a blob and its corresponding commitment.
    ///
    /// Note: This method does not check that the commitment corresponds to the
    /// blob. The method does still check that the commitment is a valid
    /// commitment.
    ///
    /// The matching function in the specs is: https://github.com/ethereum/consensus-specs/blob/017a8495f7671f5fff2075a9bfc9238c1a0982f8/specs/deneb/polynomial-commitments.md#compute_kzg_proof
    pub fn compute_blob_kzg_proof(
        &self,
        blob: BlobRef,
        commitment: Bytes48Ref,
    ) -> Result<KZGProof4844, Error> {
        // Deserialize the blob into scalars.
        let blob_scalar = deserialize_blob_to_scalars(blob)?;

        // Convert blob into monomial form.
        let polynomial = blob_scalar_to_polynomial(&self.prover.domain, &blob_scalar);

        // Deserialize the KZG commitment.
        // We only do this to check if it is in the correct subgroup
        let _ = deserialize_compressed_g1(commitment)?;

        // Compute Fiat-Shamir challenge
        let z = compute_fiat_shamir_challenge(blob, *commitment);

        // Compute evaluation and commitment to quotient at z.
        let (proof, _) = self.prover.compute_kzg_proof(&polynomial, z);

        // Serialize the commitment.
        Ok(serialize_g1_compressed(&proof))
    }
}