feat: simulate, aliases, ECDSA R account contract + touchid wallet

[Thunkar]

TLDR;

A bunch of improvements for aztec-wallet. Try this!

cd ~/repos/aztec-packages/noir-projects/noir-contracts
aztec-wallet create-account -a main
aztec-wallet deploy token_contract@Token --args accounts:main Test TST 18 -ac main
aztec-wallet send mint_public -ca contracts:last --args accounts:main 42 -ac main
aztec-wallet simulate balance_of_public -ca contracts:last --args accounts:main -ac main

Aliases (explicit and automatic)

Options on the wallet were getting out of hand. The ability to alias accounts partially alleviated the issue, but even moderately complex requests required +5 parameters that had to be copied all over the place.

To solve this problem, the wallet now has a more general concept of aliases, plus autogeneration of some of them. For example:

# set an explicit alias on an account
aztec-wallet create-account -a main

# Used the `accounts:main` alias in an argument and `main` alias in the `-ac` option. 
# The wallet is smart enough to deduce you're probably referring to an account in the latter. 
# Finally, set an explicit alias on the deployed contract, `my_contract`
aztec-wallet deploy ../target/contract_artifact-MyContract.json --args accounts:main -ac main -a my_contract

But wait! There's more. You could have done:

# `last` is an automatic alias on the latest object you created. In this case, the latest account!
aztec-wallet deploy ../target/contract_artifact-MyContract.json --args accounts:last -ac last -a my_contract

So now, it is possible to do:

# Used the `contracts:last` alias to refer to the address of the last contract that was deployed. 
# Used the `artifacts:last` alias to refer to the path of the artifact of the last contract that was deployed.
azctec-wallet send my_function -c artifacts:last -ac contracts:last --args accounts:main -ac main

# But we can do better!
# Notice how the `-ca` argument (contract artifact) is omitted, 
# as the wallet is smart enough to assume that you're probably referring to the path of the artifact of the contract that was deployed at `contracts:last`
azctec-wallet send my_function -ca contracts:last --args accounts:main -ac main

# in this case, this is equivalent to:
azctec-wallet send my_function -ca contracts:my_contract --args accounts:main -ac main

Nargo project detection

For the deploy subcommand argument and in every instance you would provide a -c (contract artifact) option you could just execute the wallet from the contract folder (where Nargo.toml is located)

cd to/the/folder/that/contains/your/contract
# The wallet can detect you're in a nargo workspace and pick the artifact path automatically
aztec-wallet deploy --args accounts:main -ac last

If it's not an isolated contract but a workspace (much like noir-projects/noir-contracts)

cd to/the/nargo/workspace/that/contains/your/contract
# It is possible to just provide the package and omit the contract name, but any ambiguity will result on the command failing
aztec-wallet deploy contract_package@ContractName --args accounts:main -ac last

ECDSA secp256r1 and secp256k1 account contracts + SSH_AGENT and TouchID support

It is now possible to create accounts with other than SchnorrAccountContract as backend (even though it's still the default). Particularly interesting is the ECDSA secp256r1 + SSH agent account, which will use the default SSH_SOCK_AUTH env variable to establish connection with a running SSH agent to perform authentication. On a Mac this can be combined with secretive for a secure enclave hardware wallet!

# After installing secretive, this env variable is provided in a wizard. It can also be checked using its "help" menu

export SSH_AUTH_SOCK=/Users/<myUser>/Library/Containers/com.maxgoedjen.Secretive.SecretAgent/Data/socket.ssh 

aztec-wallet create-account -a main -t ecdsasecp256r1ssh

You will be prompted to use one of the stored SSH keys inside the agent (identified by their public key), and once selected, your account will use TouchID to sign any requests the wallet might create.

Simulate

Wallet is now able to simulate functions (including unconstrained!)

aztec-wallet simulate balance_of_private -c contracts:token --args accounts:main -ac main

[AztecBot]

Benchmark results

Metrics with a significant change:

• protocol_circuit_simulation_time_in_ms (private-kernel-tail-to-public): 2,347 (-31%)
• avm_simulation_time_ms (Token:transfer_public): 23.7 (-43%)
• avm_simulation_time_ms (Token:_increase_public_balance): 77.8 (+656%)
• avm_simulation_time_ms (FPC:pay_refund_with_shielded_rebate): 71.4 (-48%)
• protocol_circuit_witness_generation_time_in_ms (base-parity): 280 (-53%)
• protocol_circuit_proving_time_in_ms (base-parity): 1,078 (-38%)

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,747 (+1%)	1,547	707	755 (+1%)	767
proof_construction_time_sha256_30_ms	11,775 (+4%)	3,160 (+3%)	1,395	1,444 (+1%)	1,470 (+1%)
proof_construction_time_sha256_100_ms	43,958 (+3%)	12,472 (+4%)	5,638 (+2%)	5,537	5,460 (+2%)
proof_construction_time_poseidon_hash_ms	78.0	34.0	34.0	58.0 (-3%)	87.0 (-1%)
proof_construction_time_poseidon_hash_30_ms	1,525 (+1%)	418	200	221 (+1%)	269 (+1%)
proof_construction_time_poseidon_hash_100_ms	5,621 (+2%)	1,519	677	735	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	740	740	740
l1_rollup_calldata_gas	6,704	6,718	6,716
l1_rollup_execution_gas	611,971	612,136	612,285
l2_block_processing_time_in_ms	261 (+3%)	441 (-1%)	831 (+3%)
l2_block_building_time_in_ms	9,665	18,751 (-1%)	37,577
l2_block_rollup_simulation_time_in_ms	9,665	18,751 (-1%)	37,577
l2_block_public_tx_process_time_in_ms	8,029	16,928 (-1%)	35,684

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	2,778	3,611 (-2%)
node_database_size_in_bytes	12,730,448	16,826,448 (-1%)
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	94.6	412 (+1%)	21,846	44,858	N/A	N/A	N/A	N/A
private-kernel-inner	175 (+1%)	730 (+5%)	72,545	45,005	N/A	N/A	N/A	N/A
private-kernel-tail	684	882 (+7%)	53,216	50,574	N/A	N/A	N/A	N/A
base-parity	5.96 (+2%)	⚠️ 280 (-53%)	160	96.0	⚠️ 1,078 (-38%)	13,188	19.0	65,536
root-parity	110	112 (-14%)	69,084	96.0	27,874 (-10%)	13,188	19.0	4,194,304
base-rollup	2,958 (-1%)	5,591 (+4%)	182,736	664	86,492 (-13%)	14,020	45.0	16,777,216
root-rollup	97.2	103 (-9%)	54,525	716	25,190 (-11%)	13,988	44.0	4,194,304
public-kernel-setup	90.7 (-1%)	2,735 (-3%)	103,513	70,710	15,381 (-13%)	128,708	3,629	2,097,152
public-kernel-app-logic	105	4,189 (+1%)	103,513	70,710	8,784 (-14%)	128,708	3,629	1,048,576
public-kernel-tail	578 (-1%)	29,602 (-6%)	403,238	11,326	92,458 (-10%)	27,204	457	16,777,216
private-kernel-reset-tiny	193 (+5%)	882 (+6%)	68,621	44,750	N/A	N/A	N/A	N/A
private-kernel-tail-to-public	⚠️ 2,347 (-31%)	1,633 (+4%)	942,862	1,697	N/A	N/A	N/A	N/A
public-kernel-teardown	86.8	4,202 (+3%)	103,513	70,710	16,371 (-12%)	128,708	3,629	2,097,152
merge-rollup	59.8	N/A	35,742	664	N/A	N/A	N/A	N/A
undefined	N/A	N/A	N/A	N/A	66,973 (-5%)	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 (+1%)	N/A	N/A
ContractInstanceDeployer:deploy	1,408	11,731	18.4 (+1%)	N/A	N/A
MultiCallEntrypoint:entrypoint	1,920	11,731	479	N/A	N/A
FeeJuice:deploy	1,376	11,731	392 (+3%)	N/A	N/A
SchnorrAccount:constructor	1,312	11,731	179 (+2%)	N/A	N/A
SchnorrAccount:entrypoint	2,304	11,731	539	N/A	N/A
Token:privately_mint_private_note	1,280	11,731	223 (-1%)	N/A	N/A
FPC:fee_entrypoint_public	1,344	11,731	32.7 (+5%)	N/A	N/A
Token:transfer	1,312	11,731	458 (+3%)	N/A	N/A
AuthRegistry:set_authorized (avm)	18,491	N/A	N/A	147,296	2,663 (+8%)
FPC:prepare_fee (avm)	22,958	N/A	N/A	147,360	3,297 (+3%)
Token:transfer_public (avm)	61,614	N/A	N/A	147,360	17,230 (-5%)
AuthRegistry:consume (avm)	41,719	N/A	N/A	147,328	7,633 (+2%)
FPC:pay_refund (avm)	26,227	N/A	N/A	147,328	7,488 (+1%)
Benchmarking:create_note	1,344	11,731	170 (-1%)	N/A	N/A
SchnorrAccount:verify_private_authwit	1,280	11,731	27.5	N/A	N/A
Token:unshield	1,376	11,731	730 (-1%)	N/A	N/A
FPC:fee_entrypoint_private	1,376	11,731	965 (-1%)	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	93.7 (-2%)	8,139
FeeJuice:set_portal	10.1 (-26%)	2,362
Token:constructor	124 (+1%)	31,107
FPC:constructor	95.1 (+3%)	22,380
FeeJuice:mint_public	78.5 (+1%)	6,150
Token:mint_public	83.6 (+2%)	11,720
Token:assert_minter_and_mint	89.1 (+1%)	8,028
AuthRegistry:set_authorized	11.0 (+5%)	4,537
FPC:prepare_fee	287 (-3%)	8,812
Token:transfer_public	⚠️ 23.7 (-43%)	47,374
FPC:pay_refund	65.0 (+1%)	12,114
Benchmarking:increment_balance	1,020 (+1%)	7,450
Token:_increase_public_balance	⚠️ 77.8 (+656%)	8,960
FPC:pay_refund_with_shielded_rebate	⚠️ 71.4 (-48%)	12,663

Public DB Access

Time to access various public DBs.

Function	time_ms
get-nullifier-index	0.156 (-2%)

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.18 (+2%)	3.92 (+1%)	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.114 (+3%)	0.111 (+2%)	N/A	N/A	N/A	N/A	N/A
batch_insert_into_append_only_tree_32_depth_ms	N/A	N/A	11.4 (+1%)	18.0	31.4 (+1%)	58.7 (-1%)	114 (+1%)
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.110 (+2%)	0.104	0.102 (+1%)	0.101 (-1%)	0.102
batch_insert_into_indexed_tree_20_depth_ms	N/A	N/A	14.7 (+3%)	26.8 (+5%)	44.1 (-1%)	82.3 (-1%)	163 (+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.112 (+3%)	0.109 (+6%)	0.107 (-1%)	0.102	0.103
batch_insert_into_indexed_tree_40_depth_ms	N/A	N/A	16.6 (+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	63,593	665,008

Transaction size based on fee payment method

| Metric | |
| - | |

[AztecBot]

⚠️ Performance Alert ⚠️

Possible performance regression was detected for benchmark 'C++ Benchmark'.
Benchmark result of this commit is worse than the previous benchmark result exceeding threshold 1.05.

Benchmark suite	Current: 3f6532c	Previous: 7a763c0	Ratio
commit(t)	3926932903 ns/iter	3657771025 ns/iter	1.07

This comment was automatically generated by workflow using github-action-benchmark.

CC: @ludamad @codygunton

[nventuro]

Same here for the r

[Maddiaa0]

Its just the names of the curves!

secp256r1 has r in it as its the NIST curve w/ (r)andom params
sepc256k1 has k in it as its a Koblitz curve (also with random params but i guess koblitz is the important factor)

[rahul-kothari]

I think the real suggestion here is - it isn't obvious especially for external devs

[Thunkar]

I'm open to renaming it, but using the full ecdsa_secp256r1_account_contract seems a little bit long...

[nventuro]

I see, thanks! ECDSA is much broader than those two curves however, I'd at least include them in a comment a the top of the cotnract file.

[Thunkar]

You're right and is not even that long of a name. Will fix it in the next PR 👍

[sklppy88]

This is really great work, love it! 🚀

[sklppy88]

Do we want any sort of protection on overwriting an alias here ?

[Thunkar]

Absolutely, but I want to do something more general for every alias, so the operation can be aborted/the user is prompted to force. Also include a generic -f option to "just do it" in non-interactive mode.

The PR is gigantic as it is, so I'm working on it for the next one 😄

[github-actions]

Changes to circuit sizes

Generated at commit: 313bc4606dc8aa90d891c78dc01acdd299524d7f, compared to commit: 78ae6b4f50cd0431c5dbd938c0cd791db5e2de4d

🧾 Summary (100% most significant diffs)

Program	ACIR opcodes (+/-)	%	Circuit size (+/-)	%
private_kernel_tail	+3,899 ❌	+26.59%	+207,790 ❌	+450.32%
private_kernel_tail_to_public	+984 ❌	+1.34%	+55,269 ❌	+46.20%
public_kernel_tail	-2,177 ✅	-0.22%	+145,097 ❌	+1.59%
public_kernel_teardown	-76 ✅	-0.03%	-173 ✅	-0.01%
public_kernel_setup	-72 ✅	-0.03%	-170 ✅	-0.01%
public_kernel_app_logic	-76 ✅	-0.03%	-77 ✅	-0.01%
private_kernel_tail_to_public_simulated	0 ➖	0.00%	-16 ✅	-0.44%
public_kernel_app_logic_simulated	0 ➖	0.00%	-16 ✅	-0.44%
public_kernel_setup_simulated	0 ➖	0.00%	-16 ✅	-0.44%
public_kernel_teardown_simulated	0 ➖	0.00%	-16 ✅	-0.44%
rollup_base	-4,997 ✅	-1.43%	-210,357 ✅	-2.39%
private_kernel_empty	-222 ✅	-10.37%	-444 ✅	-4.84%
private_kernel_empty_simulated	0 ➖	0.00%	-222 ✅	-33.08%
private_kernel_tail_simulated	0 ➖	0.00%	-222 ✅	-33.08%
public_kernel_tail_simulated	0 ➖	0.00%	-222 ✅	-33.23%

---

Full diff report 👇

Program	ACIR opcodes (+/-)	%	Circuit size (+/-)	%
private_kernel_tail	18,565 (+3,899)	+26.59%	253,933 (+207,790)	+450.32%
private_kernel_tail_to_public	74,403 (+984)	+1.34%	174,909 (+55,269)	+46.20%
public_kernel_tail	1,004,156 (-2,177)	-0.22%	9,273,080 (+145,097)	+1.59%
public_kernel_teardown	296,066 (-76)	-0.03%	1,657,162 (-173)	-0.01%
public_kernel_setup	216,967 (-72)	-0.03%	1,576,422 (-170)	-0.01%
public_kernel_app_logic	294,456 (-76)	-0.03%	595,988 (-77)	-0.01%
private_kernel_tail_to_public_simulated	1 (0)	0.00%	3,621 (-16)	-0.44%
public_kernel_app_logic_simulated	1 (0)	0.00%	3,618 (-16)	-0.44%
public_kernel_setup_simulated	1 (0)	0.00%	3,618 (-16)	-0.44%
public_kernel_teardown_simulated	1 (0)	0.00%	3,618 (-16)	-0.44%
rollup_base	344,426 (-4,997)	-1.43%	8,608,937 (-210,357)	-2.39%
private_kernel_empty	1,919 (-222)	-10.37%	8,735 (-444)	-4.84%
private_kernel_empty_simulated	1 (0)	0.00%	449 (-222)	-33.08%
private_kernel_tail_simulated	1 (0)	0.00%	449 (-222)	-33.08%
public_kernel_tail_simulated	1 (0)	0.00%	446 (-222)	-33.23%