0xpolygonzero / plonky-block-proof-gen

Generates block proofs from proof IR

Plonky block proof generator

Library for generating proofs from proof IR.

DEPRECATION NOTICE

The content of this project has been merged into 0xPolygonZero/proof-protocol-decoder. This repository is hence deprecated and archived.

General Usage (Extremely rough, will change)

For the time being, the only library that produces proof IR is currently plonky-edge-block-trace-parser. Down the road, the IR will be produced by decoding the proof gen protocol.

In proof_gen.rs, there are three core functions:

• generate_txn_proof
• generate_agg_proof
• generate_block_proof

Both libraries are currently targeting the latest plonky2. One noteworthy piece of data that all proofs need is this:

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BlockHashes {
    pub prev_hashes: Vec<H256>,
    pub cur_hash: H256,
}

Note that prev_hashes is going to be 256 elements long (!) most of the time.

generate_txn_proof takes in the output from the parser lib (TxnProofGenIR).

generate_agg_proof takes in the two child proofs (wrapped in `AggregatableProof`` to support txn or agg proofs).

generate_block_proof is a bit less obvious. You give it an agg proof that contains all txns in the entire block, but also pass in an optional previous block proof. The previous block proof is able to be None on checkpoint heights.

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

plonky-block-proof-gen's Issues

Future deprecation

Once https://github.com/0xPolygonZero/zero-bin is updated with the merger between the proof-protocol-decoder and plonky-block-proof-gen, we should consider archiving this repo in read-only, and updating the README to redirect to the new https://github.com/0xPolygonZero/proof-protocol-decoder.