binius_circuits/lasso/
batch.rs

1// Copyright 2024-2025 Irreducible Inc.
2
3use anyhow::Ok;
4use binius_core::oracle::OracleId;
5use binius_field::{
6	as_packed_field::{PackScalar, PackedType},
7	ExtensionField, PackedFieldIndexable, TowerField,
8};
9use itertools::Itertools;
10
11use super::lasso::lasso;
12use crate::builder::{
13	types::{F, U},
14	ConstraintSystemBuilder,
15};
16pub struct LookupBatch {
17	lookup_us: Vec<Vec<OracleId>>,
18	u_to_t_mappings: Vec<Vec<usize>>,
19	lookup_col_lens: Vec<usize>,
20	lookup_t: Vec<OracleId>,
21	executed: bool,
22}
23
24impl Drop for LookupBatch {
25	fn drop(&mut self) {
26		if !self.executed {
27			tracing::warn!("LookupBatch dropped before calling execute!");
28		}
29	}
30}
31
32impl LookupBatch {
33	pub fn new(t_oracles: impl IntoIterator<Item = OracleId>) -> Self {
34		Self {
35			lookup_t: t_oracles.into_iter().collect_vec(),
36			lookup_us: vec![],
37			u_to_t_mappings: vec![],
38			lookup_col_lens: vec![],
39			executed: false,
40		}
41	}
42
43	pub fn add(
44		&mut self,
45		lookup_u: impl IntoIterator<Item = OracleId>,
46		u_to_t_mapping: Vec<usize>,
47		lookup_u_col_len: usize,
48	) {
49		self.lookup_us.push(lookup_u.into_iter().collect_vec());
50		self.u_to_t_mappings.push(u_to_t_mapping);
51		self.lookup_col_lens.push(lookup_u_col_len);
52	}
53
54	pub fn execute<FC>(mut self, builder: &mut ConstraintSystemBuilder) -> Result<(), anyhow::Error>
55	where
56		FC: TowerField,
57		U: PackScalar<FC>,
58		F: ExtensionField<FC>,
59		PackedType<U, FC>: PackedFieldIndexable,
60	{
61		let channel = builder.add_channel();
62
63		lasso::<FC>(
64			builder,
65			"batched lasso",
66			&self.lookup_col_lens,
67			&self.u_to_t_mappings,
68			&self.lookup_us,
69			&self.lookup_t,
70			channel,
71		)?;
72
73		self.executed = true;
74
75		Ok(())
76	}
77}