Merge branch 'main' into sports

.github/workflows/lint-and-test.yml

@@ -136,7 +136,6 @@ jobs:
         run: bash crates/proof-of-sql/examples/posql_db/run_example.sh
       - name: Run posql_db example (Without Blitzar)
         run: bash crates/proof-of-sql/examples/posql_db/run_example.sh --no-default-features --features="rayon"
-
   clippy:
     name: Clippy
     runs-on: large-8-core-32gb-22-04

Cargo.toml

@@ -20,8 +20,8 @@ ark-poly = { version = "0.4.0" }
 ark-serialize = { version = "0.4.0" }
 ark-std = { version = "0.4.0", default-features = false }
 arrayvec = { version = "0.7", default-features = false }
-arrow = { version = "51.0" }
-arrow-csv = { version = "51.0" }
+arrow = { version = "51.0.0" }
+arrow-csv = { version = "51.0.0" }
 bit-iter = { version = "1.1.1" }
 bigdecimal = { version = "0.4.5", default-features = false, features = ["serde"] }
 blake3 = { version = "1.3.3", default-features = false }

crates/proof-of-sql/Cargo.toml

@@ -115,6 +115,10 @@ required-features = [ "arrow" ]
 name = "books"
 required-features = [ "arrow" ]
 
+[[example]]
+name = "programming_books"
+required-features = ["arrow"]
+
 [[example]]
 name = "brands"
 required-features = [ "arrow" ]
@@ -131,6 +135,14 @@ required-features = [ "arrow" ]
 name = "sushi"
 required-features = [ "arrow" ]
 
+[[example]]
+name = "countries"
+required-features = [ "arrow" ]
+
+[[example]]
+name = "rockets"
+required-features = [ "arrow" ]
+
 [[bench]]
 name = "posql_benches"
 harness = false

crates/proof-of-sql/examples/countries/countries_gdp.csv

@@ -0,0 +1,35 @@
+Country,Continent,GDP,GDPP
+UnitedStates,NorthAmerica,21137,63543
+China,Asia,14342,10261
+Japan,Asia,5081,40293
+Germany,Europe,3846,46329
+India,Asia,2875,2099
+UnitedKingdom,Europe,2825,42330
+France,Europe,2716,41463
+Italy,Europe,2001,33279
+Brazil,SouthAmerica,1839,8718
+Canada,NorthAmerica,1643,43119
+Russia,EuropeAsia,1637,11229
+SouthKorea,Asia,1622,31489
+Australia,Oceania,1382,53799
+Spain,Europe,1316,28152
+Mexico,NorthAmerica,1265,9958
+Indonesia,Asia,1119,4152
+Netherlands,Europe,902,52477
+SaudiArabia,Asia,793,23206
+Turkey,EuropeAsia,761,9005
+Switzerland,Europe,703,81392
+Argentina,SouthAmerica,449,9921
+Sweden,Europe,528,52073
+Nigeria,Africa,448,2190
+Poland,Europe,594,15673
+Thailand,Asia,509,7306
+SouthAfrica,Africa,350,5883
+Philippines,Asia,402,3685
+Colombia,SouthAmerica,323,6458
+Egypt,Africa,302,3012
+Pakistan,Asia,278,1450
+Bangladesh,Asia,302,1855
+Vietnam,Asia,283,2900
+Chile,SouthAmerica,252,13120
+Finland,Europe,268,48888

crates/proof-of-sql/examples/countries/main.rs

@@ -0,0 +1,132 @@
+//! This is a non-interactive example of using Proof of SQL with a countries dataset.
+//! To run this, use `cargo run --release --example countries`.
+//!
+//! NOTE: If this doesn't work because you do not have the appropriate GPU drivers installed,
+//! you can run `cargo run --release --example countries --no-default-features --features="arrow cpu-perf"` instead. It will be slower for proof generation.
+
+use arrow::datatypes::SchemaRef;
+use arrow_csv::{infer_schema_from_files, ReaderBuilder};
+use proof_of_sql::{
+    base::database::{
+        arrow_schema_utility::get_posql_compatible_schema, OwnedTable, OwnedTableTestAccessor,
+        TestAccessor,
+    },
+    proof_primitive::dory::{
+        DynamicDoryCommitment, DynamicDoryEvaluationProof, ProverSetup, PublicParameters,
+        VerifierSetup,
+    },
+    sql::{parse::QueryExpr, postprocessing::apply_postprocessing_steps, proof::QueryProof},
+};
+use rand::{rngs::StdRng, SeedableRng};
+use std::{fs::File, time::Instant};
+
+// We generate the public parameters and the setups used by the prover and verifier for the Dory PCS.
+// The `max_nu` should be set such that the maximum table size is less than `2^(2*max_nu-1)`.
+const DORY_SETUP_MAX_NU: usize = 8;
+// This should be a "nothing-up-my-sleeve" phrase or number.
+const DORY_SEED: [u8; 32] = *b"7a1b3c8d2e4f9g6h5i0j7k2l8m3n9o1p";
+
+/// # Panics
+/// Will panic if the query does not parse or the proof fails to verify.
+fn prove_and_verify_query(
+    sql: &str,
+    accessor: &OwnedTableTestAccessor<DynamicDoryEvaluationProof>,
+    prover_setup: &ProverSetup,
+    verifier_setup: &VerifierSetup,
+) {
+    // Parse the query:
+    println!("Parsing the query: {sql}...");
+    let now = Instant::now();
+    let query_plan = QueryExpr::<DynamicDoryCommitment>::try_new(
+        sql.parse().unwrap(),
+        "countries".parse().unwrap(),
+        accessor,
+    )
+    .unwrap();
+    println!("Done in {} ms.", now.elapsed().as_secs_f64() * 1000.);
+
+    // Generate the proof and result:
+    print!("Generating proof...");
+    let now = Instant::now();
+    let (proof, provable_result) = QueryProof::<DynamicDoryEvaluationProof>::new(
+        query_plan.proof_expr(),
+        accessor,
+        &prover_setup,
+    );
+    println!("Done in {} ms.", now.elapsed().as_secs_f64() * 1000.);
+
+    // Verify the result with the proof:
+    print!("Verifying proof...");
+    let now = Instant::now();
+    let result = proof
+        .verify(
+            query_plan.proof_expr(),
+            accessor,
+            &provable_result,
+            &verifier_setup,
+        )
+        .unwrap();
+    let result = apply_postprocessing_steps(result.table, query_plan.postprocessing());
+    println!("Verified in {} ms.", now.elapsed().as_secs_f64() * 1000.);
+
+    // Display the result
+    println!("Query Result:");
+    println!("{result:?}");
+}
+
+fn main() {
+    let mut rng = StdRng::from_seed(DORY_SEED);
+    let public_parameters = PublicParameters::rand(DORY_SETUP_MAX_NU, &mut rng);
+    let prover_setup = ProverSetup::from(&public_parameters);
+    let verifier_setup = VerifierSetup::from(&public_parameters);
+
+    let filename = "./crates/proof-of-sql/examples/countries/countries_gdp.csv";
+    let inferred_schema =
+        SchemaRef::new(infer_schema_from_files(&[filename.to_string()], b',', None, true).unwrap());
+    let posql_compatible_schema = get_posql_compatible_schema(&inferred_schema);
+
+    let countries_batch = ReaderBuilder::new(posql_compatible_schema)
+        .with_header(true)
+        .build(File::open(filename).unwrap())
+        .unwrap()
+        .next()
+        .unwrap()
+        .unwrap();
+
+    // Load the table into an "Accessor" so that the prover and verifier can access the data/commitments.
+    let mut accessor =
+        OwnedTableTestAccessor::<DynamicDoryEvaluationProof>::new_empty_with_setup(&prover_setup);
+    accessor.add_table(
+        "countries.countries".parse().unwrap(),
+        OwnedTable::try_from(countries_batch).unwrap(),
+        0,
+    );
+
+    prove_and_verify_query(
+        "SELECT COUNT(*) AS total_countries FROM countries",
+        &accessor,
+        &prover_setup,
+        &verifier_setup,
+    );
+
+    prove_and_verify_query(
+        "SELECT country FROM countries WHERE continent = 'Asia'",
+        &accessor,
+        &prover_setup,
+        &verifier_setup,
+    );
+
+    prove_and_verify_query(
+        "SELECT country FROM countries WHERE gdp > 500 AND gdp < 1500",
+        &accessor,
+        &prover_setup,
+        &verifier_setup,
+    );
+
+    prove_and_verify_query(
+        "SELECT SUM(gdp) AS total_market_cap FROM countries WHERE country = 'China' OR country = 'India'",
+        &accessor,
+        &prover_setup,
+        &verifier_setup,
+    );
+}

crates/proof-of-sql/examples/posql_db/main.rs

@@ -5,6 +5,7 @@ mod commit_accessor;
 mod csv_accessor;
 /// TODO: add docs
 mod record_batch_accessor;
+
 use arrow::{
     datatypes::{DataType, Field, Schema},
     record_batch::RecordBatch,
@@ -273,7 +274,7 @@ fn main() {
             end_timer(timer);
             println!(
                 "Verified Result: {:?}",
-                RecordBatch::try_from(query_result).unwrap()
+                RecordBatch::try_from(query_result.table).unwrap()
             );
         }
     }

crates/proof-of-sql/examples/posql_db/record_batch_accessor.rs

@@ -2,9 +2,9 @@ use arrow::record_batch::RecordBatch;
 use bumpalo::Bump;
 use indexmap::IndexMap;
 use proof_of_sql::base::{
+    arrow::arrow_array_to_column_conversion::ArrayRefExt,
     database::{
-        ArrayRefExt, Column, ColumnRef, ColumnType, DataAccessor, MetadataAccessor, SchemaAccessor,
-        TableRef,
+        Column, ColumnRef, ColumnType, DataAccessor, MetadataAccessor, SchemaAccessor, TableRef,
     },
     scalar::Scalar,
 };

crates/proof-of-sql/examples/programming_books/main.rs

@@ -0,0 +1,133 @@
+//! This is a non-interactive example of using Proof of SQL with an extended books dataset.
+//! To run this, use `cargo run --example programming_books`.
+//!
+//! NOTE: If this doesn't work because you do not have the appropriate GPU drivers installed,
+//! you can run `cargo run --example programming_books --no-default-features --features="arrow cpu-perf"` instead. It will be slower for proof generation.
+
+use arrow::datatypes::SchemaRef;
+use arrow_csv::{infer_schema_from_files, ReaderBuilder};
+use proof_of_sql::{
+    base::database::{
+        arrow_schema_utility::get_posql_compatible_schema, OwnedTable, OwnedTableTestAccessor,
+        TestAccessor,
+    },
+    proof_primitive::dory::{
+        DynamicDoryCommitment, DynamicDoryEvaluationProof, ProverSetup, PublicParameters,
+        VerifierSetup,
+    },
+    sql::{parse::QueryExpr, postprocessing::apply_postprocessing_steps, proof::QueryProof},
+};
+use rand::{rngs::StdRng, SeedableRng};
+use std::{fs::File, time::Instant};
+
+const DORY_SETUP_MAX_NU: usize = 8;
+const DORY_SEED: [u8; 32] = *b"ebab60d58dee4cc69658939b7c2a582d";
+
+/// # Panics
+/// Will panic if the query does not parse or the proof fails to verify.
+fn prove_and_verify_query(
+    sql: &str,
+    accessor: &OwnedTableTestAccessor<DynamicDoryEvaluationProof>,
+    prover_setup: &ProverSetup,
+    verifier_setup: &VerifierSetup,
+) {
+    // Parse the query:
+    println!("Parsing the query: {sql}...");
+    let now = Instant::now();
+    let query_plan = QueryExpr::<DynamicDoryCommitment>::try_new(
+        sql.parse().unwrap(),
+        "programming_books".parse().unwrap(),
+        accessor,
+    )
+    .unwrap();
+    println!("Done in {} ms.", now.elapsed().as_secs_f64() * 1000.);
+
+    // Generate the proof and result:
+    print!("Generating proof...");
+    let now = Instant::now();
+    let (proof, provable_result) = QueryProof::<DynamicDoryEvaluationProof>::new(
+        query_plan.proof_expr(),
+        accessor,
+        &prover_setup,
+    );
+    println!("Done in {} ms.", now.elapsed().as_secs_f64() * 1000.);
+
+    // Verify the result with the proof:
+    print!("Verifying proof...");
+    let now = Instant::now();
+    let result = proof
+        .verify(
+            query_plan.proof_expr(),
+            accessor,
+            &provable_result,
+            &verifier_setup,
+        )
+        .unwrap();
+    let result = apply_postprocessing_steps(result.table, query_plan.postprocessing());
+    println!("Verified in {} ms.", now.elapsed().as_secs_f64() * 1000.);
+
+    // Display the result
+    println!("Query Result:");
+    println!("{result:?}");
+}
+
+fn main() {
+    let mut rng = StdRng::from_seed(DORY_SEED);
+    let public_parameters = PublicParameters::rand(DORY_SETUP_MAX_NU, &mut rng);
+    let prover_setup = ProverSetup::from(&public_parameters);
+    let verifier_setup = VerifierSetup::from(&public_parameters);
+
+    let filename = "./crates/proof-of-sql/examples/programming_books/programming_books.csv";
+    let inferred_schema =
+        SchemaRef::new(infer_schema_from_files(&[filename.to_string()], b',', None, true).unwrap());
+    let posql_compatible_schema = get_posql_compatible_schema(&inferred_schema);
+
+    let books_extra_batch = ReaderBuilder::new(posql_compatible_schema)
+        .with_header(true)
+        .build(File::open(filename).unwrap())
+        .unwrap()
+        .next()
+        .unwrap()
+        .unwrap();
+
+    // Load the table into an "Accessor" so that the prover and verifier can access the data/commitments.
+    let mut accessor =
+        OwnedTableTestAccessor::<DynamicDoryEvaluationProof>::new_empty_with_setup(&prover_setup);
+    accessor.add_table(
+        "programming_books.books".parse().unwrap(),
+        OwnedTable::try_from(books_extra_batch).unwrap(),
+        0,
+    );
+
+    // Query 1: Count the total number of books
+    prove_and_verify_query(
+        "SELECT COUNT(*) AS total_books FROM books",
+        &accessor,
+        &prover_setup,
+        &verifier_setup,
+    );
+
+    // Query 2: Find books with a rating higher than 4.5
+    prove_and_verify_query(
+        "SELECT title, author FROM books WHERE rating > 4.5",
+        &accessor,
+        &prover_setup,
+        &verifier_setup,
+    );
+
+    // Query 3: List all programming books published after 2000
+    prove_and_verify_query(
+        "SELECT title, publication_year FROM books WHERE genre = 'Programming' AND publication_year > 2000",
+        &accessor,
+        &prover_setup,
+        &verifier_setup,
+    );
+
+    // Query 4: Find the top 5 authors with the most books
+    prove_and_verify_query(
+        "SELECT author, COUNT(*) AS book_count FROM books GROUP BY author ORDER BY book_count DESC LIMIT 5",
+        &accessor,
+        &prover_setup,
+        &verifier_setup,
+    );
+}

crates/proof-of-sql/examples/programming_books/programming_books.csv

@@ -0,0 +1,11 @@
+title,author,publication_year,genre,rating
+The Pragmatic Programmer,Andrew Hunt,1999,Programming,4.5
+Clean Code,Robert C. Martin,2008,Programming,4.7
+The Clean Coder,Robert C. Martin,2011,Programming,4.6
+Design Patterns,Erich Gamma,1994,Software Engineering,4.8
+Refactoring,Martin Fowler,1999,Programming,4.5
+Effective Java,Joshua Bloch,2008,Programming,4.7
+Introduction to Algorithms,Thomas H. Cormen,2009,Computer Science,4.8
+Code Complete,Steve McConnell,2004,Programming,4.6
+The Mythical Man-Month,Fred Brooks,1975,Software Engineering,4.3
+Algorithms,Robert Sedgewick,1983,Computer Science,4.5