feat: note preprocessor

[benesjan]

Adds support for a note preprocessor (filter applied in an unconstrained context) and uses it in the standard token. It's use in standard token results in 3121 gates saved.

Gate diff: 87785 - 84664 = 3121 gates saved

[benesjan]

• feat: note preprocessor #7857 👈
• feat: flamegraph artifact cleanup #7869
• master

This stack of pull requests is managed by Graphite. Learn more about stacking.

Join @benesjan and the rest of your teammates on Graphite

[AztecBot]

Docs Preview

Hey there! 👋 You can check your preview at https://66b6871d6801ee82ab44e237--aztec-docs-dev.netlify.app

[AztecBot]

Benchmark results

Metrics with a significant change:

• protocol_circuit_simulation_time_in_ms (private-kernel-tail-to-public): 2,791 (+23%)
• avm_simulation_time_ms (Token:transfer_public): 54.4 (+55%)

Detailed results

All benchmarks are run on txs on the Benchmarking contract on the repository. Each tx consists of a batch call to create_note and increment_balance, which guarantees that each tx has a private call, a nested private call, a public call, and a nested public call, as well as an emitted private note, an unencrypted log, and public storage read and write.

This benchmark source data is available in JSON format on S3 here.

Proof generation

Each column represents the number of threads used in proof generation.

Metric	1 threads	4 threads	16 threads	32 threads	64 threads
proof_construction_time_sha256_ms	5,646 (-1%)	1,543	698	752 (-2%)	765
proof_construction_time_sha256_30_ms	11,721	3,139	1,402	1,431	1,462
proof_construction_time_sha256_100_ms	42,954 (-2%)	12,303	5,652	5,565	5,484 (-1%)
proof_construction_time_poseidon_hash_ms	78.0	34.0	34.0	58.0 (+2%)	88.0
proof_construction_time_poseidon_hash_30_ms	1,495 (-1%)	416	200 (-1%)	226 (+2%)	265 (-3%)
proof_construction_time_poseidon_hash_100_ms	5,490 (-2%)	1,511	673 (-1%)	738 (+1%)	749 (+1%)

L2 block published to L1

Each column represents the number of txs on an L2 block published to L1.

Metric	4 txs	8 txs	16 txs
l1_rollup_calldata_size_in_bytes	4,324	7,844	14,852
l1_rollup_calldata_gas	49,708	92,394	177,728
l1_rollup_execution_gas	1,294,371	2,042,025	3,869,398
l2_block_processing_time_in_ms	246 (-3%)	444 (+1%)	815 (+3%)
l2_block_building_time_in_ms	9,583 (+1%)	18,771 (+1%)	37,508 (+1%)
l2_block_rollup_simulation_time_in_ms	9,583 (+1%)	18,771 (+1%)	37,508 (+1%)
l2_block_public_tx_process_time_in_ms	7,979 (+1%)	16,920 (+1%)	35,456 (+1%)

L2 chain processing

Each column represents the number of blocks on the L2 chain where each block has 8 txs.

Metric	3 blocks	5 blocks
node_history_sync_time_in_ms	3,004 (+2%)	3,895 (+2%)
node_database_size_in_bytes	12,750,928	16,879,696
pxe_database_size_in_bytes	16,254	26,813

Circuits stats

Stats on running time and I/O sizes collected for every kernel circuit run across all benchmarks.

Circuit	simulation_time_in_ms	witness_generation_time_in_ms	input_size_in_bytes	output_size_in_bytes	proving_time_in_ms	proof_size_in_bytes	num_public_inputs	size_in_gates
private-kernel-init	100 (+4%)	395	21,846	44,858	N/A	N/A	N/A	N/A
private-kernel-inner	168 (-3%)	691 (-1%)	72,545	45,005	N/A	N/A	N/A	N/A
private-kernel-tail	664	762 (+2%)	52,710	52,256	N/A	N/A	N/A	N/A
base-parity	5.96	611 (+4%)	160	96.0	1,723 (+2%)	13,188	19.0	65,536
root-parity	108	132	69,084	96.0	31,023	13,188	19.0	4,194,304
base-rollup	2,971	5,726 (+7%)	187,824	664	98,792 (+1%)	14,020	45.0	16,777,216
root-rollup	96.9 (+1%)	115 (-3%)	54,525	716	29,902 (+8%)	13,988	44.0	4,194,304
public-kernel-setup	91.2 (+1%)	2,808	104,025	71,222	17,700 (+2%)	129,220	3,645	2,097,152
public-kernel-app-logic	106 (+1%)	4,118 (-1%)	104,025	71,222	10,066	129,220	3,645	1,048,576
public-kernel-tail	569 (+1%)	31,852 (+11%)	409,190	16,414	105,062 (-2%)	34,308	679	16,777,216
private-kernel-reset-tiny	184 (-5%)	860 (+2%)	68,621	44,750	N/A	N/A	N/A	N/A
private-kernel-tail-to-public	⚠️ 2,791 (+23%)	1,579 (+3%)	931,564	1,697	N/A	N/A	N/A	N/A
public-kernel-teardown	87.1 (+2%)	4,197 (-1%)	104,025	71,222	18,368 (-1%)	129,220	3,645	2,097,152
merge-rollup	59.8 (+1%)	N/A	35,742	664	N/A	N/A	N/A	N/A
undefined	N/A	N/A	N/A	N/A	68,902 (-1%)	N/A	N/A	N/A

Stats on running time collected for app circuits

Function	input_size_in_bytes	output_size_in_bytes	witness_generation_time_in_ms	proof_size_in_bytes	proving_time_in_ms
ContractClassRegisterer:register	1,344	11,731	341	N/A	N/A
ContractInstanceDeployer:deploy	1,408	11,731	18.2 (+1%)	N/A	N/A
MultiCallEntrypoint:entrypoint	1,920	11,731	472	N/A	N/A
FeeJuice:deploy	1,376	11,731	390 (-1%)	N/A	N/A
SchnorrAccount:constructor	1,312	11,731	175	N/A	N/A
SchnorrAccount:entrypoint	2,304	11,731	530 (-1%)	N/A	N/A
Token:privately_mint_private_note	1,280	11,731	210 (-4%)	N/A	N/A
FPC:fee_entrypoint_public	1,344	11,731	22.7 (-3%)	N/A	N/A
Token:transfer	1,312	11,731	407 (-5%)	N/A	N/A
AuthRegistry:set_authorized (avm)	18,491	N/A	N/A	147,296	2,469 (+1%)
FPC:prepare_fee (avm)	22,958	N/A	N/A	147,360	3,182 (+1%)
Token:transfer_public (avm)	61,614	N/A	N/A	147,360	18,033 (-1%)
AuthRegistry:consume (avm)	41,719	N/A	N/A	147,328	8,025 (+5%)
FPC:pay_refund (avm)	26,227	N/A	N/A	147,328	7,407 (+1%)
Benchmarking:create_note	1,344	11,731	169 (+2%)	N/A	N/A
SchnorrAccount:verify_private_authwit	1,280	11,731	27.4	N/A	N/A
Token:unshield	1,376	11,731	638 (-3%)	N/A	N/A
FPC:fee_entrypoint_private	1,376	11,731	833 (-5%)	N/A	N/A

AVM Simulation

Time to simulate various public functions in the AVM.

Function	time_ms	bytecode_size_in_bytes
FeeJuice:_increase_public_balance	95.0 (+2%)	8,139
FeeJuice:set_portal	10.0 (-1%)	2,362
Token:constructor	120 (-2%)	31,107
FPC:constructor	94.0	22,380
FeeJuice:mint_public	81.3 (+1%)	6,150
Token:mint_public	92.8 (-1%)	11,720
Token:assert_minter_and_mint	79.3 (-1%)	8,028
AuthRegistry:set_authorized	11.1 (+24%)	4,537
FPC:prepare_fee	290 (+1%)	8,812
Token:transfer_public	⚠️ 54.4 (+55%)	47,374
FPC:pay_refund	65.6 (+9%)	12,114
Benchmarking:increment_balance	1,016	7,450
Token:_increase_public_balance	48.9 (-5%)	8,960
FPC:pay_refund_with_shielded_rebate	138 (-1%)	12,663

Public DB Access

Time to access various public DBs.

Function	time_ms
get-nullifier-index	0.162 (+1%)

Tree insertion stats

The duration to insert a fixed batch of leaves into each tree type.

Metric	1 leaves	16 leaves	64 leaves	128 leaves	256 leaves	512 leaves	1024 leaves
batch_insert_into_append_only_tree_16_depth_ms	2.21 (+4%)	3.91 (+2%)	N/A	N/A	N/A	N/A	N/A
batch_insert_into_append_only_tree_16_depth_hash_count	16.8	31.7	N/A	N/A	N/A	N/A	N/A
batch_insert_into_append_only_tree_16_depth_hash_ms	0.115 (+4%)	0.111 (+3%)	N/A	N/A	N/A	N/A	N/A
batch_insert_into_append_only_tree_32_depth_ms	N/A	N/A	11.3 (-2%)	19.0 (+8%)	31.2 (+3%)	59.7 (+3%)	119 (+6%)
batch_insert_into_append_only_tree_32_depth_hash_count	N/A	N/A	95.9	159	287	543	1,055
batch_insert_into_append_only_tree_32_depth_hash_ms	N/A	N/A	0.109 (-2%)	0.110 (+7%)	0.102 (+2%)	0.103 (+2%)	0.105 (+5%)
batch_insert_into_indexed_tree_20_depth_ms	N/A	N/A	14.5 (+2%)	25.5 (+1%)	43.1 (+1%)	82.8 (+2%)	160 (-1%)
batch_insert_into_indexed_tree_20_depth_hash_count	N/A	N/A	109	207	355	691	1,363
batch_insert_into_indexed_tree_20_depth_hash_ms	N/A	N/A	0.109 (+2%)	0.103	0.104	0.103 (+2%)	0.102 (-1%)
batch_insert_into_indexed_tree_40_depth_ms	N/A	N/A	16.4 (+1%)	N/A	N/A	N/A	N/A
batch_insert_into_indexed_tree_40_depth_hash_count	N/A	N/A	132	N/A	N/A	N/A	N/A
batch_insert_into_indexed_tree_40_depth_hash_ms	N/A	N/A	0.106 (+1%)	N/A	N/A	N/A	N/A

Miscellaneous

Transaction sizes based on how many contract classes are registered in the tx.

Metric	0 registered classes	1 registered classes
tx_size_in_bytes	64,756	668,997

Transaction size based on fee payment method

| Metric | |
| - | |

[nventuro]

Great work, thanks! I was surprised by the gate reduction since filter was only supposed to be 2k gates. However, I run the flamegraph and verified that the unknown section is also reduced by 1k gates, explaining where the extra savings came from. Lucky us!