From 6a3554e1d0ef5d0e0d8f3196d2c28438e79730d3 Mon Sep 17 00:00:00 2001
From: alejoamiras <2982991+alejoamiras@users.noreply.github.com>
Date: Wed, 24 Dec 2025 13:48:03 +0000
Subject: [PATCH 1/3] fix(docs): polishing rough edges
On this PR we polish some rough edges:
- We unify the "CLI" references under the "CLI" on sidebar. Talked with @critesjosh.
- We obviously modify auto-generation of references to work with the new structure.
- We've moved the sign with FaceID into "Tutorials" (yikes, it needs a better place)
- And we improve the installation of aztec's tooling by directly using the version that is intended. This avoids having some problems than what we have right now (the stable version of the install sh tries to install `aztec-nargo`, but that install doesn't exist for the latest version, so it breaks). This makes it so we point exactly to the install script we need for the intended version.
---
.../docs/aztec-cli/_category_.json | 6 -
.../docs/aztec-cli/local-network-reference.md | 154 -----
.../advanced/how_to_profile_transactions.md | 2 +-
.../docs/{wallet-cli => cli}/_category_.json | 2 +-
.../aztec_cli_reference.md} | 4 +-
.../aztec_wallet_cli_reference.md} | 4 +-
.../docs/resources/glossary.md | 4 +-
.../contract_tutorials/_category_.json | 4 +-
.../contract_tutorials/counter_contract.md | 2 +-
.../contract_tutorials/token_contract.md | 2 +-
.../faceid_wallet.md | 12 +-
.../tutorials/js_tutorials/_category_.json | 2 +-
.../docs/tutorials/local_network.md | 6 +-
.../cli_wallet_reference_autogen.md | 528 ------------------
.../getting_started_on_devnet.md | 10 +-
.../getting_started_on_local_network.md | 8 +-
.../operation/keystore/creating_keystores.md | 8 +-
.../running_delegated_stake.md | 3 +-
docs/docs-network/prerequisites.md | 8 +-
docs/netlify.toml | 20 +
.../CLI_DOCS_README.md | 2 +-
.../update_all_cli_docs.sh | 4 +-
.../update_cli_docs.sh | 35 +-
23 files changed, 64 insertions(+), 766 deletions(-)
delete mode 100644 docs/docs-developers/docs/aztec-cli/_category_.json
delete mode 100644 docs/docs-developers/docs/aztec-cli/local-network-reference.md
rename docs/docs-developers/docs/{wallet-cli => cli}/_category_.json (71%)
rename docs/docs-developers/docs/{aztec-cli/cli_reference.md => cli/aztec_cli_reference.md} (99%)
rename docs/docs-developers/docs/{wallet-cli/cli_wallet_reference.md => cli/aztec_wallet_cli_reference.md} (99%)
rename docs/docs-developers/docs/{wallet-cli => tutorials}/faceid_wallet.md (83%)
delete mode 100644 docs/docs-developers/docs/wallet-cli/cli_wallet_reference_autogen.md
diff --git a/docs/docs-developers/docs/aztec-cli/_category_.json b/docs/docs-developers/docs/aztec-cli/_category_.json
deleted file mode 100644
index cf227211be18..000000000000
--- a/docs/docs-developers/docs/aztec-cli/_category_.json
+++ /dev/null
@@ -1,6 +0,0 @@
-{
- "label": "Aztec CLI",
- "position": 4,
- "collapsible": true,
- "collapsed": true
-}
diff --git a/docs/docs-developers/docs/aztec-cli/local-network-reference.md b/docs/docs-developers/docs/aztec-cli/local-network-reference.md
deleted file mode 100644
index 9bfca89fc97c..000000000000
--- a/docs/docs-developers/docs/aztec-cli/local-network-reference.md
+++ /dev/null
@@ -1,154 +0,0 @@
----
-title: Local Network Reference
-description: Comprehensive reference for the Aztec local network development environment.
-tags: [local_network]
-sidebar_position: 1
----
-
-:::tip
-
-For a quick start, follow the [guide](../../getting_started_on_local_network.md) to install the local network.
-
-:::
-
-## Environment Variables
-
-There are various environment variables you can use when running the whole local network or when running on of the available modes.
-
-**Local Network**
-
-```sh
-LOG_LEVEL=debug # Options are 'fatal', 'error', 'warn', 'info', 'verbose', 'debug', 'trace'
-HOST_WORKDIR='${PWD}' # The location to store log outputs. Will use ~/.aztec where the binaries are stored by default.
-ETHEREUM_HOSTS=http://127.0.0.1:8545 # List of Ethereum JSON RPC URLs. We use an anvil instance that runs in parallel to the local network on docker by default.
-ANVIL_PORT=8545 # The port that docker will forward to the anvil instance (default: 8545)
-L1_CHAIN_ID=31337 # The Chain ID that the Ethereum host is using.
-TEST_ACCOUNTS='true' # Option to deploy 3 test account when local network starts. (default: true)
-MODE='local-network' # Option to start the local network or a standalone part of the system. (default: local-network)
-PXE_PORT=8080 # The port that the PXE will be listening to (default: 8080)
-AZTEC_NODE_PORT=8080 # The port that Aztec Node will be listening to (default: 8080)
-
-## Polling intervals ##
-ARCHIVER_POLLING_INTERVAL_MS=50
-P2P_BLOCK_CHECK_INTERVAL_MS=50
-SEQ_TX_POLLING_INTERVAL_MS=50
-WS_BLOCK_CHECK_INTERVAL_MS=50
-ARCHIVER_VIEM_POLLING_INTERVAL_MS=500
-```
-
-**Aztec Node**
-
-Variables like `DEPLOY_AZTEC_CONTRACTS` & `AZTEC_NODE_PORT` are valid here as described above.
-`TEST_ACCOUNTS` cannot be used here because the Aztec node does not control an Aztec account to deploy contracts from.
-
-```sh
-# P2P config #
-# Configuration variables for connecting a Node to the Aztec Node P2P network. You'll need a running P2P-Bootstrap node to connect to.
-P2P_ENABLED='false' # A flag to enable P2P networking for this node. (default: false)
-P2P_BLOCK_CHECK_INTERVAL_MS=100 # The frequency in which to check for new L2 blocks.
-P2P_PEER_CHECK_INTERVAL_MS=1000 # The frequency in which to check for peers.
-P2P_L2_BLOCK_QUEUE_SIZE=1000 # Size of queue of L2 blocks to store.
-P2P_IP='' # Announce IP of the peer. Defaults to working it out using discV5, otherwise set P2P_QUERY_FOR_IP if you are behind a NAT
-P2P_LISTEN_ADDR=0.0.0.0 # The address on which the P2P service should listen for connections.(default: 0.0.0.0)
-P2P_PORT=40400 # The Port that will be used for sending & listening p2p messages (default: 40400)
-PEER_ID_PRIVATE_KEY='' # An optional peer id private key. If blank, will generate a random key.
-BOOTSTRAP_NODES='' # A list of bootstrap peers to connect to, separated by commas
-P2P_ANNOUNCE_PORT='' # Port to announce to the p2p network
-P2P_NAT_ENABLED='false' # Whether to enable NAT from libp2p
-P2P_MAX_PEERS=100 # The maximum number of peers (a peer count above this will cause the node to refuse connection attempts)
-
-## Aztec Contract Addresses ##
-# When running a standalone node, you need to have deployed Aztec contracts on your Ethereum host, then declare their addresses as env variables.
-REGISTRY_CONTRACT_ADDRESS=0x01234567890abcde01234567890abcde
-INBOX_CONTRACT_ADDRESS=0x01234567890abcde01234567890abcde
-OUTBOX_CONTRACT_ADDRESS=0x01234567890abcde01234567890abcde
-ROLLUP_CONTRACT_ADDRESS=0x01234567890abcde01234567890abcde
-
-## Sequencer variables ##
-SEQ_PUBLISHER_PRIVATE_KEY=0x01234567890abcde01234567890abcde # Private key of an ethereum account that will be used by the sequencer to publish blocks.
-SEQ_MAX_TX_PER_BLOCK=32 # Maximum txs to go on a block. (default: 32)
-SEQ_MIN_TX_PER_BLOCK=1 # Minimum txs to go on a block. (default: 1)
-VALIDATOR_PRIVATE_KEY=0x01234567890abcde01234567890abcde # Private key of the ethereum account that will be used to perform sequencer duties
-```
-
-**Wallet**
-
-Variables like `AZTEC_NODE_URL` and `TEST_ACCOUNTS` are valid here as described above.
-
-```sh
-AZTEC_NODE_URL='http://localhost:8080' # The address of an Aztec Node URL that the wallet will connect to (default: http://localhost:8080)
-TEST_ACCOUNTS='true' # Option to deploy 3 test account when local network starts. (default: true)
-```
-
-**P2P Bootstrap Node**
-
-The P2P Bootstrap node is a standalone app whose purpose is to assist new P2P network participants in acquiring peers.
-
-```sh
-PEER_ID_PRIVATE_KEY='' # The private key to be used by the peer for secure communications with other peers. This key will also be used to derive the Peer ID.
-P2P_IP='' # Announce IP of the peer. Defaults to working it out using discV5, otherwise set P2P_QUERY_FOR_IP if you are behind a NAT
-P2P_LISTEN_ADDR=0.0.0.0 # The address on which the P2P service should listen for connections.(default: 0.0.0.0)
-P2P_PORT=40400 # The Port that will be used for sending & listening p2p messages (default: 40400)
-```
-
-## Contracts
-
-We have shipped a number of example contracts in the `@aztec/noir-contracts.js` [npm package](https://www.npmjs.com/package/@aztec/noir-contracts.js). This is included with the local network by default so you are able to use these contracts to test with.
-
-```bash
-AppSubscriptionContractArtifact
-AuthContractArtifact
-BenchmarkingContractArtifact
-CardGameContractArtifact
-ChildContractArtifact
-ClaimContractArtifact
-ContractClassRegistryContractArtifact
-ContractInstanceRegistryContractArtifact
-CounterContractArtifact
-CrowdfundingContractArtifact
-PrivateTokenContractArtifact
-PrivateVotingContractArtifact
-EcdsaAccountContractArtifact
-EscrowContractArtifact
-FPCContractArtifact
-FeeJuiceContractArtifact
-ImportTestContractArtifact
-LendingContractArtifact
-MultiCallEntrypointContractArtifact
-ParentContractArtifact
-PendingNoteHashesContractArtifact
-PriceFeedContractArtifact
-ReaderContractArtifact
-SchnorrAccountContractArtifact
-SchnorrHardcodedAccountContractArtifact
-SchnorrSingleKeyAccountContractArtifact
-SlowTreeContractArtifact
-StatefulTestContractArtifact
-TestContractArtifact
-TokenBlacklistContractArtifact
-TokenBridgeContractArtifact
-TokenContractArtifact
-UniswapContractArtifact
-```
-
-> Source code: /yarn-project/end-to-end/src/composed/cli_docs_local_network.test.ts#L95-L118
-
-You can see all of our example contracts in the monorepo [here (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/master/noir-projects/noir-contracts/contracts).
-
-## Running Aztec PXE / Node / P2P-Bootstrap node individually
-
-If you wish to run components of the Aztec network stack separately, you can use the `aztec start` command with various options for enabling components.
-
-```bash
-aztec start --node [nodeOptions] --pxe [pxeOptions] --archiver [archiverOptions] --sequencer [sequencerOptions] --prover [proverOptions] --p2p-bootstrap [p2pOptions]
-```
-
-Starting the aztec node alongside a PXE, sequencer or archiver, will attach the components to the node. Eg if you want to run a PXE separately to a node, you can [read this guide](../tutorials/local_network.md#running-multiple-pxes-in-the-local-network).
-
-## Update the local network
-
-To update the local network, run:
-
-```bash
-aztec-up
-```
diff --git a/docs/docs-developers/docs/aztec-nr/framework-description/advanced/how_to_profile_transactions.md b/docs/docs-developers/docs/aztec-nr/framework-description/advanced/how_to_profile_transactions.md
index 389051fdf68d..1207c28aa517 100644
--- a/docs/docs-developers/docs/aztec-nr/framework-description/advanced/how_to_profile_transactions.md
+++ b/docs/docs-developers/docs/aztec-nr/framework-description/advanced/how_to_profile_transactions.md
@@ -9,7 +9,7 @@ This guide shows you how to profile your Aztec transactions to identify bottlene
## Prerequisites
-- `aztec` command installed ([see installation](../../../aztec-cli/local-network-reference.md))
+- `aztec` command installed ([see installation](../../../../getting_started_on_local_network.md))
- `aztec-wallet` installed
- Aztec contract deployed and ready to test
- Basic understanding of proving and gate counts
diff --git a/docs/docs-developers/docs/wallet-cli/_category_.json b/docs/docs-developers/docs/cli/_category_.json
similarity index 71%
rename from docs/docs-developers/docs/wallet-cli/_category_.json
rename to docs/docs-developers/docs/cli/_category_.json
index 9bcac906fada..268e67ea5507 100644
--- a/docs/docs-developers/docs/wallet-cli/_category_.json
+++ b/docs/docs-developers/docs/cli/_category_.json
@@ -1,5 +1,5 @@
{
- "label": "Wallet CLI",
+ "label": "CLI",
"position": 5,
"collapsible": true,
"collapsed": true
diff --git a/docs/docs-developers/docs/aztec-cli/cli_reference.md b/docs/docs-developers/docs/cli/aztec_cli_reference.md
similarity index 99%
rename from docs/docs-developers/docs/aztec-cli/cli_reference.md
rename to docs/docs-developers/docs/cli/aztec_cli_reference.md
index ba10341ffe97..8a96dae6923c 100644
--- a/docs/docs-developers/docs/aztec-cli/cli_reference.md
+++ b/docs/docs-developers/docs/cli/aztec_cli_reference.md
@@ -1,8 +1,8 @@
---
-title: Reference
+title: Aztec Reference
description: Comprehensive auto-generated reference for the Aztec CLI command-line interface with all commands and options.
tags: [cli, reference, autogenerated]
-sidebar_position: 2
+sidebar_position: 1
---
# Aztec CLI Reference
diff --git a/docs/docs-developers/docs/wallet-cli/cli_wallet_reference.md b/docs/docs-developers/docs/cli/aztec_wallet_cli_reference.md
similarity index 99%
rename from docs/docs-developers/docs/wallet-cli/cli_wallet_reference.md
rename to docs/docs-developers/docs/cli/aztec_wallet_cli_reference.md
index 76d9cfe1b195..826de257df3d 100644
--- a/docs/docs-developers/docs/wallet-cli/cli_wallet_reference.md
+++ b/docs/docs-developers/docs/cli/aztec_wallet_cli_reference.md
@@ -1,8 +1,8 @@
---
-title: Reference
+title: Aztec Wallet Reference
description: Comprehensive auto-generated reference for the Aztec Wallet CLI command-line interface with all commands and options.
tags: [cli, reference, autogenerated, wallet]
-sidebar_position: 10
+sidebar_position: 2
---
# Reference
diff --git a/docs/docs-developers/docs/resources/glossary.md b/docs/docs-developers/docs/resources/glossary.md
index 5d13da88c1f9..4d9b403a4f9e 100644
--- a/docs/docs-developers/docs/resources/glossary.md
+++ b/docs/docs-developers/docs/resources/glossary.md
@@ -18,13 +18,13 @@ Aztec is a privacy-first Layer 2 rollup on Ethereum. It supports smart contracts
`aztec` is a CLI tool (with an extensive set of parameters) that enables users to perform a wide range of tasks. It can: compile and test contracts, run a node, run a local network, execute tests, generate contract interfaces for javascript and more.
-Full reference [here](../aztec-cli/cli_reference).
+Full reference [here](../cli/aztec_cli_reference).
### Aztec Wallet
The Aztec Wallet is a CLI wallet, `aztec-wallet`, that allows a user to manage accounts and interact with an Aztec network. It includes a PXE.
-Full reference [here](../wallet-cli/cli_wallet_reference).
+Full reference [here](../cli/aztec_wallet_cli_reference).
### `aztec-up`
diff --git a/docs/docs-developers/docs/tutorials/contract_tutorials/_category_.json b/docs/docs-developers/docs/tutorials/contract_tutorials/_category_.json
index 3900e03c64d8..94fd42c74601 100644
--- a/docs/docs-developers/docs/tutorials/contract_tutorials/_category_.json
+++ b/docs/docs-developers/docs/tutorials/contract_tutorials/_category_.json
@@ -1,6 +1,6 @@
{
"label": "Contract Tutorials",
- "position": 1,
+ "position": 2,
"collapsible": true,
"collapsed": true
-}
\ No newline at end of file
+}
diff --git a/docs/docs-developers/docs/tutorials/contract_tutorials/counter_contract.md b/docs/docs-developers/docs/tutorials/contract_tutorials/counter_contract.md
index fe757e84ae2f..5d6799bec6d7 100644
--- a/docs/docs-developers/docs/tutorials/contract_tutorials/counter_contract.md
+++ b/docs/docs-developers/docs/tutorials/contract_tutorials/counter_contract.md
@@ -8,7 +8,7 @@ import Image from "@theme/IdealImage";
In this guide, we will create our first Aztec.nr smart contract. We will build a simple private counter, where you can keep your own private counter - so no one knows what ID you are at or when you increment! This contract will get you started with the basic setup and syntax of Aztec.nr, but doesn't showcase all of the awesome stuff Aztec is capable of.
-This tutorial is compatible with the Aztec version `#include_aztec_version`. Install the correct version with `aztec-up -v #include_version_without_prefix`. Or if you'd like to use a different version, you can find the relevant tutorial by clicking the version dropdown at the top of the page.
+This tutorial is compatible with the Aztec version `#include_aztec_version`. Install the correct version with `bash -i <(curl -s https://install.aztec.network/#include_version_without_prefix/)`. Or if you'd like to use a different version, you can find the relevant tutorial by clicking the version dropdown at the top of the page.
## Prerequisites
diff --git a/docs/docs-developers/docs/tutorials/contract_tutorials/token_contract.md b/docs/docs-developers/docs/tutorials/contract_tutorials/token_contract.md
index 995fd71e4c79..d4fc6fba5b09 100644
--- a/docs/docs-developers/docs/tutorials/contract_tutorials/token_contract.md
+++ b/docs/docs-developers/docs/tutorials/contract_tutorials/token_contract.md
@@ -22,7 +22,7 @@ This is an intermediate tutorial that assumes you have:
- Completed the [Counter Contract tutorial](./counter_contract.md)
- A Running Aztec local network (see the Counter tutorial for setup)
- Basic understanding of Aztec.nr syntax and structure
-- Aztec toolchain installed (`aztec-up -v #include_version_without_prefix`)
+- Aztec toolchain installed (`bash -i <(curl -s https://install.aztec.network/#include_version_without_prefix/)`)
If you haven't completed the Counter Contract tutorial, please do so first as we'll skip the basic setup steps covered there.
diff --git a/docs/docs-developers/docs/wallet-cli/faceid_wallet.md b/docs/docs-developers/docs/tutorials/faceid_wallet.md
similarity index 83%
rename from docs/docs-developers/docs/wallet-cli/faceid_wallet.md
rename to docs/docs-developers/docs/tutorials/faceid_wallet.md
index 448fbd31d773..a98cb585d1ca 100644
--- a/docs/docs-developers/docs/wallet-cli/faceid_wallet.md
+++ b/docs/docs-developers/docs/tutorials/faceid_wallet.md
@@ -2,11 +2,11 @@
title: Using FaceID to Sign Transactions
tags: [local_network, wallet, cli]
keywords: [wallet, cli wallet, faceid]
-sidebar_position: 5
+sidebar_position: 1
description: In this tutorial, we will use Apple Mac's Secure Enclave to store the private key, and use it in Aztec's CLI Wallet. This enables fully private, native, and ...
---
-In this tutorial, we will use Apple Mac's Secure Enclave to store the private key, and use it in Aztec's [CLI Wallet](./cli_wallet_reference.md). This enables fully private, native, and seedless account abstraction!
+In this tutorial, we will use Apple Mac's Secure Enclave to store the private key, and use it in Aztec's [CLI Wallet](../cli/aztec_wallet_cli_reference.md). This enables fully private, native, and seedless account abstraction!
:::warning
@@ -15,12 +15,12 @@ Aztec is in active development and this has only been tested on MacOS. Please re
:::
:::note
-This tutorial is for the local network and will need adjustments if you want to use it on testnet. Install the local network [here](../../getting_started_on_local_network.md).
+This tutorial is for the local network and will need adjustments if you want to use it on testnet.
:::
## Prerequisites
-For this tutorial, we will need to have the [Local Network](../aztec-cli/local-network-reference.md) installed.
+For this tutorial, we will need to have the [Local Network](../../getting_started_on_local_network.md) installed.
We also need to install Secretive, a nice open-source package that allows us to store keys on the Secure Enclave. You can head to the [secretive releases page](https://github.com/maxgoedjen/secretive/releases) and get the last release's `zip`, unzip and move to Applications, or use [Homebrew](https://brew.sh/):
@@ -84,10 +84,10 @@ aztec-wallet get-alias accounts:my-faceid-wallet
From here, you can deploy contracts, send transactions, and interact with the network - each transaction will prompt you to authenticate with TouchID or your password.
-Check out the [CLI Wallet Reference](./cli_wallet_reference.md) for the full set of available commands, or follow the [Getting Started on Local Network](../../getting_started_on_local_network.md) guide to deploy contracts and interact with the network using your new wallet.
+Check out the [CLI Wallet Reference](../cli/aztec_wallet_cli_reference.md) for the full set of available commands, or follow the [Getting Started on Local Network](../../getting_started_on_local_network.md) guide to deploy contracts and interact with the network using your new wallet.
### What next
-In this tutorial, we created an account with the Aztec's [CLI Wallet](./cli_wallet_reference.md), using the Apple Mac's Secure Enclave to store the private key.
+In this tutorial, we created an account with the Aztec's [CLI Wallet](../cli/aztec_wallet_cli_reference.md), using the Apple Mac's Secure Enclave to store the private key.
You can use a multitude of authentication methods, for example with RSA you could use a passport as a recovery, or even as a signer in a multisig. All of this is based on the [account contract](https://github.com/AztecProtocol/aztec-packages/tree/#include_aztec_version/noir-projects/noir-contracts/contracts/account).
diff --git a/docs/docs-developers/docs/tutorials/js_tutorials/_category_.json b/docs/docs-developers/docs/tutorials/js_tutorials/_category_.json
index d497430c8a5e..132c6fc4c952 100644
--- a/docs/docs-developers/docs/tutorials/js_tutorials/_category_.json
+++ b/docs/docs-developers/docs/tutorials/js_tutorials/_category_.json
@@ -1,6 +1,6 @@
{
"label": "Full-Stack Tutorials",
- "position": 2,
+ "position": 3,
"collapsible": true,
"collapsed": true
}
diff --git a/docs/docs-developers/docs/tutorials/local_network.md b/docs/docs-developers/docs/tutorials/local_network.md
index a1dc002e6371..1d861f0e9582 100644
--- a/docs/docs-developers/docs/tutorials/local_network.md
+++ b/docs/docs-developers/docs/tutorials/local_network.md
@@ -103,7 +103,7 @@ cd your/aztec/project
aztec update . --contract src/contract1 --contract src/contract2
```
-The local network must be running for the update command to work. Make sure it is [installed and running](../aztec-cli/local-network-reference.md).
+The local network must be running for the update command to work. Make sure it is [installed and running](../../getting_started_on_local_network.md).
Follow [updating Aztec.nr packages](#updating-aztecnr-packages) and [updating JavaScript packages](#updating-aztecjs-packages) guides.
@@ -201,7 +201,7 @@ You can enable proving on a per-transaction basis using the `aztec-wallet` CLI b
PXE_PROVER_ENABLED=1 aztec-wallet create-account -a test
```
-Check the [Quickstart](../../getting_started_on_local_network.md) for a refresher on how to send transactions using `aztec-wallet` or check the [reference here](../wallet-cli/cli_wallet_reference.md)
+Check the [Getting Started on Local Network](../../getting_started_on_local_network.md) for a refresher on how to send transactions using `aztec-wallet` or check the [reference here](../cli/aztec_wallet_cli_reference.md)
Note that you do not need to restart the local network in order to start sending proven transactions. You can optionally set this for one-off transactions.
@@ -211,4 +211,4 @@ If this is the first time you are sending transactions with proving enabled, it
You can also profile your transactions to get gate count, if you don't want to prove your transactions but check how many constraints it is. Follow the [guide here](../aztec-nr/framework-description/advanced/how_to_profile_transactions.md)
:::
-You can learn more about custom commands in the [local network reference](../aztec-cli/local-network-reference.md).
+You can learn more about custom commands in the [Aztec CLI Reference](../cli/aztec_cli_reference.md).
diff --git a/docs/docs-developers/docs/wallet-cli/cli_wallet_reference_autogen.md b/docs/docs-developers/docs/wallet-cli/cli_wallet_reference_autogen.md
deleted file mode 100644
index 0c379401bce8..000000000000
--- a/docs/docs-developers/docs/wallet-cli/cli_wallet_reference_autogen.md
+++ /dev/null
@@ -1,528 +0,0 @@
----
-title: Aztec Wallet CLI Reference (Auto-generated)
-description: Comprehensive auto-generated reference for the Aztec Wallet CLI command-line interface with all commands and options.
-tags: [cli, reference, autogenerated, wallet]
-sidebar_position: 10
----
-
-# Aztec Wallet CLI Reference
-
-*This documentation is auto-generated from the `aztec-wallet` CLI help output.*
-
-:::info
-This is an auto-generated reference. For a more curated guide with examples and best practices, see the [manual Aztec Wallet CLI reference](cli_wallet_reference.md).
-:::
-
-
-*Generated: Thu Nov 6 02:38:33 HKT 2025*
-
-*Command: `aztec-wallet`*
-
-## Table of Contents
-
-- [aztec-wallet](#aztec-wallet)
- - [aztec-wallet import-test-accounts](#aztec-wallet-import-test-accounts)
- - [aztec-wallet create-account](#aztec-wallet-create-account)
- - [aztec-wallet deploy-account](#aztec-wallet-deploy-account)
- - [aztec-wallet deploy](#aztec-wallet-deploy)
- - [aztec-wallet send](#aztec-wallet-send)
- - [aztec-wallet simulate](#aztec-wallet-simulate)
- - [aztec-wallet profile](#aztec-wallet-profile)
- - [aztec-wallet bridge-fee-juice](#aztec-wallet-bridge-fee-juice)
- - [aztec-wallet create-authwit](#aztec-wallet-create-authwit)
- - [aztec-wallet authorize-action](#aztec-wallet-authorize-action)
- - [aztec-wallet get-tx](#aztec-wallet-get-tx)
- - [aztec-wallet register-sender](#aztec-wallet-register-sender)
- - [aztec-wallet register-contract](#aztec-wallet-register-contract)
- - [aztec-wallet alias](#aztec-wallet-alias)
- - [aztec-wallet get-alias](#aztec-wallet-get-alias)
- - [aztec-wallet create-secret](#aztec-wallet-create-secret)
-## aztec-wallet
-
-Aztec wallet
-
-**Usage:**
-```bash
-wallet [options] [command]
-```
-
-**Available Commands:**
-
-- `import-test-accounts [options]` - Import test accounts from pxe.
-- `create-account [options]` - Creates an aztec account that can be used for sending transactions.
-- `deploy-account [options] ` - Deploys an already registered aztec account that can be used for sending transactions.
-- `deploy [options] [artifact]` - Deploys a compiled Aztec.nr contract to Aztec.
-- `send [options] ` - Calls a function on an Aztec contract.
-- `simulate [options] ` - Simulates the execution of a function on an Aztec contract.
-- `profile [options] ` - Profiles a private function by counting the unconditional operations in its execution steps
-- `bridge-fee-juice [options] ` - Mints L1 Fee Juice and pushes them to L2.
-- `create-authwit [options] ` - Creates an authorization witness that can be privately sent to a caller so they can perform an action on behalf of the provided account
-- `authorize-action [options] ` - Authorizes a public call on the caller, so they can perform an action on behalf of the provided account
-- `get-tx [options] [txHash]` - Gets the status of the recent txs, or a detailed view if a specific transaction hash is provided
-- `register-sender [options] [address]` - Registers a sender's address in the wallet, so the note synching process will look for notes sent by them
-- `register-contract [options] [address] [artifact]` - Registers a contract in this wallet's PXE
-- `alias ` - Aliases information for easy reference.
-- `get-alias [alias]` - Shows stored aliases
-- `create-secret [options]` - Creates an aliased secret to use in other commands
-- `help [command]` - display help for command
-
-**Options:**
-
-- `-V --version` - output the version number
-- `-d --data-dir ` - Storage directory for wallet data (default: "/Users/aztec/.aztec/wallet")
-- `-p --prover ` - The type of prover the wallet uses (choices: "wasm", "native", "none", default: "native", env: PXE_PROVER)
-- `-n --node-url ` - URL of the Aztec node to connect to (default: "http://host.docker.internal:8080", env: AZTEC_NODE_URL)
-- `-h --help` - display help for command
-
-
-### Subcommands
-
-### aztec-wallet import-test-accounts
-
-```
-Usage: wallet import-test-accounts [options]
-
-Import test accounts from pxe.
-
-Options:
- --json Emit output as json
- -h, --help display help for command
-2025/11/06 02:38:35 socat[72638] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet create-account
-
-```
-Usage: wallet create-account [options]
-
-Creates an aztec account that can be used for sending transactions. Registers
-the account on the PXE and deploys an account contract. Uses a Schnorr
-single-key account which uses the same key for encryption and authentication
-(not secure for production usage).
-
-Options:
- -f, --from Alias or address of the account performing the deployment
- --skip-initialization Skip initializing the account contract. Useful for publicly deploying an existing account.
- --public-deploy Publishes the account contract instance (and the class, if needed). Needed if the contract contains public functions.
- --register-class Register the contract class (useful for when the contract class has not been deployed yet).
- -p, --public-key Public key that identifies a private signing key stored outside of the wallet. Used for ECDSA SSH accounts over the secp256r1 curve.
- -sk, --secret-key Secret key for account. Uses random by default. (env: SECRET_KEY)
- -a, --alias Alias for the account. Used for easy reference in subsequent commands.
- -t, --type Type of account to create (choices: "schnorr", "ecdsasecp256r1", "ecdsasecp256r1ssh", "ecdsasecp256k1", default: "schnorr")
- --register-only Just register the account on the Wallet. Do not deploy or initialize the account contract.
- --json Emit output as json
- --no-wait Skip waiting for the contract to be deployed. Print the hash of deployment transaction
- -v, --verbose Provide timings on all executed operations (synching, simulating, proving) (default: false)
- --payment Fee payment method and arguments.
- Parameters:
- method Valid values: "fee_juice", "fpc-public", "fpc-private", "fpc-sponsored" Default: fee_juice
- asset The asset used for fee payment. Required for "fpc-public" and "fpc-private".
- fpc The FPC contract that pays in fee juice. Not required for the "fee_juice" method.
- claim Whether to use a previously stored claim to bridge fee juice.
- claimSecret The secret to claim fee juice on L1.
- claimAmount The amount of fee juice to be claimed.
- messageLeafIndex The index of the claim in the l1toL2Message tree.
- Format: --payment method=name,asset=address,fpc=address ...
- --gas-limits Gas limits for the tx.
- --max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
- --max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
- --estimate-gas-only Only report gas estimation for the tx, do not send it.
- -h, --help display help for command
-2025/11/06 02:38:37 socat[72822] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet deploy-account
-
-```
-Usage: wallet deploy-account [options]
-
-Deploys an already registered aztec account that can be used for sending
-transactions.
-
-Arguments:
- address The address of the contract to register
-
-Options:
- -f, --from Alias or address of the account performing the deployment
- --json Emit output as json
- --no-wait Skip waiting for the contract to be deployed. Print the hash of deployment transaction
- --register-class Register the contract class (useful for when the contract class has not been deployed yet).
- --public-deploy Publishes the account contract instance (and the class, if needed). Needed if the contract contains public functions.
- --skip-initialization Skip initializing the account contract. Useful for publicly deploying an existing account.
- -v, --verbose Provide timings on all executed operations (synching, simulating, proving) (default: false)
- --payment Fee payment method and arguments.
- Parameters:
- method Valid values: "fee_juice", "fpc-public", "fpc-private", "fpc-sponsored" Default: fee_juice
- asset The asset used for fee payment. Required for "fpc-public" and "fpc-private".
- fpc The FPC contract that pays in fee juice. Not required for the "fee_juice" method.
- claim Whether to use a previously stored claim to bridge fee juice.
- claimSecret The secret to claim fee juice on L1.
- claimAmount The amount of fee juice to be claimed.
- messageLeafIndex The index of the claim in the l1toL2Message tree.
- Format: --payment method=name,asset=address,fpc=address ...
- --gas-limits Gas limits for the tx.
- --max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
- --max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
- --estimate-gas-only Only report gas estimation for the tx, do not send it.
- -h, --help display help for command
-2025/11/06 02:38:39 socat[73008] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet deploy
-
-```
-Usage: wallet deploy [options] [artifact]
-
-Deploys a compiled Aztec.nr contract to Aztec.
-
-Arguments:
- artifact Path to a compiled Aztec contract's artifact in JSON format. If executed inside a nargo workspace, a package and contract name can be specified as package@contract
-
-Options:
- --init The contract initializer function to call (default: "constructor")
- --no-init Leave the contract uninitialized
- -k, --public-key Optional encryption public key for this address. Set this value only if this contract is expected to receive private notes, which will be encrypted using this public key.
- -s, --salt Optional deployment salt as a hex string for generating the deployment address.
- --universal Do not mix the sender address into the deployment.
- --args [args...] Constructor arguments (default: [])
- -f, --from Alias or address of the account to deploy from
- -a, --alias Alias for the contract. Used for easy reference subsequent commands.
- --json Emit output as json
- --no-wait Skip waiting for the contract to be deployed. Print the hash of deployment transaction
- --no-class-registration Don't register this contract class
- --no-public-deployment Don't emit this contract's public bytecode
- --timeout The amount of time in seconds to wait for the deployment to post to L2
- -v, --verbose Provide timings on all executed operations (synching, simulating, proving) (default: false)
- --payment Fee payment method and arguments.
- Parameters:
- method Valid values: "fee_juice", "fpc-public", "fpc-private", "fpc-sponsored" Default: fee_juice
- asset The asset used for fee payment. Required for "fpc-public" and "fpc-private".
- fpc The FPC contract that pays in fee juice. Not required for the "fee_juice" method.
- claim Whether to use a previously stored claim to bridge fee juice.
- claimSecret The secret to claim fee juice on L1.
- claimAmount The amount of fee juice to be claimed.
- messageLeafIndex The index of the claim in the l1toL2Message tree.
- Format: --payment method=name,asset=address,fpc=address ...
- --gas-limits Gas limits for the tx.
- --max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
- --max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
- --estimate-gas-only Only report gas estimation for the tx, do not send it.
- -h, --help display help for command
-2025/11/06 02:38:40 socat[73175] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet send
-
-```
-Usage: wallet send [options]
-
-Calls a function on an Aztec contract.
-
-Arguments:
- functionName Name of function to execute
-
-Options:
- --args [args...] Function arguments (default: [])
- -c, --contract-artifact Path to a compiled Aztec contract's artifact in JSON format. If executed inside a nargo workspace, a package and contract name can be specified as package@contract
- -ca, --contract-address Aztec address of the contract.
- -a, --alias Alias for the transaction hash. Used for easy reference in subsequent commands.
- -aw, --auth-witness Authorization witness to use for the transaction. If using multiple, pass a comma separated string
- -f, --from Alias or address of the account to send the transaction from
- --no-wait Print transaction hash without waiting for it to be mined
- -v, --verbose Provide timings on all executed operations (synching, simulating, proving) (default: false)
- --payment Fee payment method and arguments.
- Parameters:
- method Valid values: "fee_juice", "fpc-public", "fpc-private", "fpc-sponsored" Default: fee_juice
- asset The asset used for fee payment. Required for "fpc-public" and "fpc-private".
- fpc The FPC contract that pays in fee juice. Not required for the "fee_juice" method.
- claim Whether to use a previously stored claim to bridge fee juice.
- claimSecret The secret to claim fee juice on L1.
- claimAmount The amount of fee juice to be claimed.
- messageLeafIndex The index of the claim in the l1toL2Message tree.
- Format: --payment method=name,asset=address,fpc=address ...
- --gas-limits Gas limits for the tx.
- --max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
- --max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
- --estimate-gas-only Only report gas estimation for the tx, do not send it.
- -h, --help display help for command
-2025/11/06 02:38:42 socat[73359] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet simulate
-
-```
-Usage: wallet simulate [options]
-
-Simulates the execution of a function on an Aztec contract.
-
-Arguments:
- functionName Name of function to simulate
-
-Options:
- --args [args...] Function arguments (default: [])
- -ca, --contract-address Aztec address of the contract.
- -c, --contract-artifact Path to a compiled Aztec contract's artifact in JSON format. If executed inside a nargo workspace, a package and contract name can be specified as package@contract
- -sk, --secret-key The sender's secret key (env: SECRET_KEY)
- -aw, --auth-witness Authorization witness to use for the simulation
- -f, --from Alias or address of the account to simulate from
- -v, --verbose Provide timings on all executed operations (synching, simulating, proving) (default: false)
- --payment Fee payment method and arguments.
- Parameters:
- method Valid values: "fee_juice", "fpc-public", "fpc-private", "fpc-sponsored" Default: fee_juice
- asset The asset used for fee payment. Required for "fpc-public" and "fpc-private".
- fpc The FPC contract that pays in fee juice. Not required for the "fee_juice" method.
- claim Whether to use a previously stored claim to bridge fee juice.
- claimSecret The secret to claim fee juice on L1.
- claimAmount The amount of fee juice to be claimed.
- messageLeafIndex The index of the claim in the l1toL2Message tree.
- Format: --payment method=name,asset=address,fpc=address ...
- --gas-limits Gas limits for the tx.
- --max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
- --max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
- --estimate-gas-only Only report gas estimation for the tx, do not send it.
- -h, --help display help for command
-2025/11/06 02:38:44 socat[73475] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet profile
-
-```
-Usage: wallet profile [options]
-
-Profiles a private function by counting the unconditional operations in its
-execution steps
-
-Arguments:
- functionName Name of function to simulate
-
-Options:
- --args [args...] Function arguments (default: [])
- -ca, --contract-address Aztec address of the contract.
- -c, --contract-artifact Path to a compiled Aztec contract's artifact in JSON format. If executed inside a nargo workspace, a package and contract name can be specified as package@contract
- --debug-execution-steps-dir Directory to write execution step artifacts for bb profiling/debugging.
- -aw, --auth-witness Authorization witness to use for the simulation
- -f, --from Alias or address of the account to simulate from
- --payment Fee payment method and arguments.
- Parameters:
- method Valid values: "fee_juice", "fpc-public", "fpc-private", "fpc-sponsored" Default: fee_juice
- asset The asset used for fee payment. Required for "fpc-public" and "fpc-private".
- fpc The FPC contract that pays in fee juice. Not required for the "fee_juice" method.
- claim Whether to use a previously stored claim to bridge fee juice.
- claimSecret The secret to claim fee juice on L1.
- claimAmount The amount of fee juice to be claimed.
- messageLeafIndex The index of the claim in the l1toL2Message tree.
- Format: --payment method=name,asset=address,fpc=address ...
- --gas-limits Gas limits for the tx.
- --max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
- --max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
- --estimate-gas-only Only report gas estimation for the tx, do not send it.
- -h, --help display help for command
-2025/11/06 02:38:46 socat[73649] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet bridge-fee-juice
-
-```
-Usage: wallet bridge-fee-juice [options]
-
-Mints L1 Fee Juice and pushes them to L2.
-
-Arguments:
- amount The amount of Fee Juice to mint and bridge.
- recipient Aztec address of the recipient.
-
-Options:
- --l1-rpc-urls List of Ethereum host URLs. Chain identifiers
- localhost and testnet can be used (comma
- separated) (default:
- ["http://host.docker.internal:8545"])
- -m, --mnemonic The mnemonic to use for deriving the Ethereum
- address that will mint and bridge (default: "test
- test test test test test test test test test test
- junk")
- --mint Mint the tokens on L1 (default: false)
- --l1-private-key The private key to the eth account bridging
- -c, --l1-chain-id Chain ID of the ethereum host (default: 31337,
- env: L1_CHAIN_ID)
- --json Output the claim in JSON format
- --no-wait Wait for the bridged funds to be available in L2,
- polling every 60 seconds
- --interval The polling interval in seconds for the bridged
- funds (default: "60")
- -h, --help display help for command
-2025/11/06 02:38:48 socat[73882] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet create-authwit
-
-```
-Usage: wallet create-authwit [options]
-
-Creates an authorization witness that can be privately sent to a caller so they
-can perform an action on behalf of the provided account
-
-Arguments:
- functionName Name of function to authorize
- caller Account to be authorized to perform the action
-
-Options:
- --args [args...] Function arguments (default: [])
- -ca, --contract-address Aztec address of the contract.
- -c, --contract-artifact Path to a compiled Aztec contract's artifact in JSON format. If executed inside a nargo workspace, a package and contract name can be specified as package@contract
- -f, --from Alias or address of the account to simulate from
- -a, --alias Alias for the authorization witness. Used for easy reference in subsequent commands.
- -h, --help display help for command
-2025/11/06 02:38:49 socat[74097] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet authorize-action
-
-```
-Usage: wallet authorize-action [options]
-
-Authorizes a public call on the caller, so they can perform an action on behalf
-of the provided account
-
-Arguments:
- functionName Name of function to authorize
- caller Account to be authorized to perform the action
-
-Options:
- --args [args...] Function arguments (default: [])
- -ca, --contract-address Aztec address of the contract.
- -c, --contract-artifact Path to a compiled Aztec contract's artifact in JSON format. If executed inside a nargo workspace, a package and contract name can be specified as package@contract
- -f, --from Alias or address of the account to simulate from
- -h, --help display help for command
-2025/11/06 02:38:51 socat[74325] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet get-tx
-
-```
-Usage: wallet get-tx [options] [txHash]
-
-Gets the status of the recent txs, or a detailed view if a specific transaction
-hash is provided
-
-Arguments:
- txHash A transaction hash to get the receipt for.
-
-Options:
- -p, --page The page number to display (default: 1)
- -s, --page-size The number of transactions to display per page
- (default: 10)
- -h, --help display help for command
-2025/11/06 02:38:53 socat[74531] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet register-sender
-
-```
-Usage: wallet register-sender [options] [address]
-
-Registers a sender's address in the wallet, so the note synching process will
-look for notes sent by them
-
-Arguments:
- address The address of the sender to register
-
-Options:
- -a, --alias Alias for the sender. Used for easy reference in
- subsequent commands.
- -h, --help display help for command
-2025/11/06 02:38:55 socat[74757] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet register-contract
-
-```
-Usage: wallet register-contract [options] [address] [artifact]
-
-Registers a contract in this wallet's PXE
-
-Arguments:
- address The address of the contract to register
- artifact Path to a compiled Aztec contract's artifact in
- JSON format. If executed inside a nargo workspace,
- a package and contract name can be specified as
- package@contract
-
-Options:
- --init The contract initializer function to call
- (default: "constructor")
- -k, --public-key Optional encryption public key for this address.
- Set this value only if this contract is expected
- to receive private notes, which will be encrypted
- using this public key.
- -s, --salt Optional deployment salt as a hex string for
- generating the deployment address.
- --deployer The address of the account that deployed the
- contract
- --args [args...] Constructor arguments (default: [])
- -a, --alias Alias for the contact. Used for easy reference in
- subsequent commands.
- -h, --help display help for command
-2025/11/06 02:38:57 socat[74814] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet alias
-
-```
-Usage: wallet alias [options]
-
-Aliases information for easy reference.
-
-Arguments:
- type Type of alias to create (choices: "accounts", "contracts",
- "artifacts", "secrets", "transactions", "authwits")
- key Key to alias.
- value Value to assign to the alias.
-
-Options:
- -h, --help display help for command
-2025/11/06 02:38:58 socat[74996] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet get-alias
-
-```
-Usage: wallet get-alias [options] [alias]
-
-Shows stored aliases
-
-Arguments:
- alias Alias to retrieve
-
-Options:
- -h, --help display help for command
-2025/11/06 02:39:00 socat[75164] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
-
-### aztec-wallet create-secret
-
-```
-Usage: wallet create-secret [options]
-
-Creates an aliased secret to use in other commands
-
-Options:
- -a, --alias Key to alias the secret with
- -h, --help display help for command
-2025/11/06 02:39:02 socat[75350] E bind(5, {LEN=16 AF=2 0.0.0.0:12345}, 16): Address already in use
-
-```
diff --git a/docs/docs-developers/getting_started_on_devnet.md b/docs/docs-developers/getting_started_on_devnet.md
index 66c5d8672477..caa8eb04d407 100644
--- a/docs/docs-developers/getting_started_on_devnet.md
+++ b/docs/docs-developers/getting_started_on_devnet.md
@@ -38,16 +38,10 @@ If you're new to Aztec and want to understand local development first, check out
Before working with devnet, ensure you have:
1. [Docker](https://docs.docker.com/get-started/get-docker/) installed
-2. Aztec CLI installed:
+2. Aztec CLI with Devnet version installed:
```sh
-bash -i <(curl -s https://install.aztec.network)
-```
-
-3. The devnet version installed:
-
-```bash
-aztec-up #include_devnet_version
+bash -i <(curl -s https://install.aztec.network/#include_devnet_version/)
```
:::warning
diff --git a/docs/docs-developers/getting_started_on_local_network.md b/docs/docs-developers/getting_started_on_local_network.md
index ef60f393ea19..85ca3170469b 100644
--- a/docs/docs-developers/getting_started_on_local_network.md
+++ b/docs/docs-developers/getting_started_on_local_network.md
@@ -43,13 +43,7 @@ Docker needs to be running in order to install the local network. Find instructi
Run:
```bash
-bash -i <(curl -s https://install.aztec.network)
-```
-
-Once the installation is complete, install the specific version:
-
-```bash
-aztec-up #include_version_without_prefix
+bash -i <(curl -s https://install.aztec.network/#include_version_without_prefix/)
```
This will install the following tools:
diff --git a/docs/docs-network/operation/keystore/creating_keystores.md b/docs/docs-network/operation/keystore/creating_keystores.md
index 01479f92e785..7a4000bbe76f 100644
--- a/docs/docs-network/operation/keystore/creating_keystores.md
+++ b/docs/docs-network/operation/keystore/creating_keystores.md
@@ -28,13 +28,7 @@ Before creating keystores, ensure you have:
First, install the Aztec CLI using the official installer:
```bash
-bash -i <(curl -s https://install.aztec.network)
-```
-
-Then install the correct version for the current network:
-
-```bash
-aztec-up 2.1.7
+bash -i <(curl -s https://install.aztec.network/2.1.9/)
```
Verify your CLI installation:
diff --git a/docs/docs-network/operation/sequencer_management/running_delegated_stake.md b/docs/docs-network/operation/sequencer_management/running_delegated_stake.md
index 8a37881880ff..79b99e81b78a 100644
--- a/docs/docs-network/operation/sequencer_management/running_delegated_stake.md
+++ b/docs/docs-network/operation/sequencer_management/running_delegated_stake.md
@@ -22,8 +22,7 @@ Before proceeding, ensure you have:
- Aztec CLI v2.1.9 or later installed:
```bash
-bash -i <(curl -s https://install.aztec.network)
-aztec-up --version 2.1.9
+bash -i <(curl -s https://install.aztec.network/2.1.9/)
```
### Contract Addresses
diff --git a/docs/docs-network/prerequisites.md b/docs/docs-network/prerequisites.md
index a0cfa7d0ee22..8e301d9156c4 100644
--- a/docs/docs-network/prerequisites.md
+++ b/docs/docs-network/prerequisites.md
@@ -57,13 +57,7 @@ The Aztec toolchain provides CLI utilities for key generation, validator registr
Install the Aztec toolchain using the official installer:
```bash
-bash -i <(curl -s https://install.aztec.network)
-```
-
-Install the correct version for the current network:
-
-```bash
-aztec-up #include_testnet_version
+bash -i <(curl -s https://install.aztec.network/#include_testnet_version/)
```
### L1 Ethereum Node Access
diff --git a/docs/netlify.toml b/docs/netlify.toml
index 92f5b647fd3c..24df8cc02e35 100644
--- a/docs/netlify.toml
+++ b/docs/netlify.toml
@@ -33,6 +33,26 @@
from = "/developers/reference/smart_contract_reference/storage/*"
to = "/developers/docs/aztec-nr/framework-description/how_to_define_storage"
+# [[redirects]]
+# from = "/developers/docs/aztec-cli/cli_reference"
+# to = "/developers/docs/cli/aztec_cli_reference"
+
+# [[redirects]]
+# from = "/developers/docs/aztec-cli/local-network-reference"
+# to = "/developers/docs/cli/aztec_cli_reference"
+
+# [[redirects]]
+# from = "/developers/docs/wallet-cli/cli_wallet_reference"
+# to = "/developers/docs/cli/aztec_wallet_cli_reference"
+
+# [[redirects]]
+# from = "/developers/docs/wallet-cli/cli_wallet_reference_autogen"
+# to = "/developers/docs/cli/aztec_wallet_cli_reference"
+
+# [[redirects]]
+# from = "/developers/docs/wallet-cli/faceid_wallet"
+# to = "/developers/docs/tutorials/faceid_wallet"
+
[[redirects]]
from = "/getting_started"
to = "/developers/getting_started_on_local_network"
diff --git a/docs/scripts/cli_reference_generation/CLI_DOCS_README.md b/docs/scripts/cli_reference_generation/CLI_DOCS_README.md
index e916cdd86f40..ecd424167039 100644
--- a/docs/scripts/cli_reference_generation/CLI_DOCS_README.md
+++ b/docs/scripts/cli_reference_generation/CLI_DOCS_README.md
@@ -103,7 +103,7 @@ These scripts generate the documentation and deploy it to the docs directories:
./docs/scripts/cli_reference_generation/update_all_cli_docs.sh v2.0.2
# Output both CLIs to a custom directory instead of deploying to docs folders
-# Uses default filenames: cli_reference.md and cli_wallet_reference.md
+# Uses default filenames: aztec_cli_reference.md and aztec_wallet_cli_reference.md
./docs/scripts/cli_reference_generation/update_all_cli_docs.sh v2.0.2 /tmp/
# Output a single CLI to a custom directory
diff --git a/docs/scripts/cli_reference_generation/update_all_cli_docs.sh b/docs/scripts/cli_reference_generation/update_all_cli_docs.sh
index 8e5b59cd74e8..99955011074d 100755
--- a/docs/scripts/cli_reference_generation/update_all_cli_docs.sh
+++ b/docs/scripts/cli_reference_generation/update_all_cli_docs.sh
@@ -49,9 +49,9 @@ echo ""
echo "Files updated:"
for cli in "${CLIS[@]}"; do
if [[ "$cli" == "aztec" ]]; then
- filename="cli_reference.md"
+ filename="aztec_cli_reference.md"
else
- filename="cli_wallet_reference.md"
+ filename="aztec_wallet_cli_reference.md"
fi
if [[ -n "$OUTPUT_DIR" ]]; then
echo " - $OUTPUT_DIR/$filename"
diff --git a/docs/scripts/cli_reference_generation/update_cli_docs.sh b/docs/scripts/cli_reference_generation/update_cli_docs.sh
index 00ed49ff0fa8..3c1cb9bff75d 100755
--- a/docs/scripts/cli_reference_generation/update_cli_docs.sh
+++ b/docs/scripts/cli_reference_generation/update_cli_docs.sh
@@ -6,7 +6,7 @@
# ./scripts/cli_reference_generation/update_cli_docs.sh aztec # Updates aztec CLI, all versions
# ./scripts/cli_reference_generation/update_cli_docs.sh aztec-wallet current # Updates aztec-wallet CLI, current only
# ./scripts/cli_reference_generation/update_cli_docs.sh aztec v2.0.2 # Updates aztec CLI, v2.0.2 only
-# ./scripts/cli_reference_generation/update_cli_docs.sh aztec v2.0.2 /tmp/ # Outputs to /tmp/cli_reference.md
+# ./scripts/cli_reference_generation/update_cli_docs.sh aztec v2.0.2 /tmp/ # Outputs to /tmp/aztec_cli_reference.md
set -euo pipefail # Added 'u' for undefined variable check, 'o pipefail' for pipe failures
@@ -105,17 +105,17 @@ readonly TEMP_WITH_FRONTMATTER="$TEMP_DIR/cli_final.md"
# Configuration per CLI (compatible with bash 3.2+)
case "$CLI_NAME" in
aztec)
- DISPLAY_NAME="Aztec CLI"
- TITLE="Aztec CLI Reference"
- OUTPUT_FILE="cli_reference.md"
- SIDEBAR_POSITION="3"
+ DISPLAY_NAME="Aztec CLI Reference"
+ TITLE="Aztec Reference"
+ OUTPUT_FILE="aztec_cli_reference.md"
+ SIDEBAR_POSITION="1"
COMMAND="aztec"
;;
aztec-wallet)
- DISPLAY_NAME="Aztec Wallet CLI"
- TITLE="Reference"
- OUTPUT_FILE="cli_wallet_reference.md"
- SIDEBAR_POSITION="10"
+ DISPLAY_NAME="Aztec Wallet CLI Reference"
+ TITLE="Aztec Wallet Reference"
+ OUTPUT_FILE="aztec_wallet_cli_reference.md"
+ SIDEBAR_POSITION="2"
COMMAND="aztec-wallet"
;;
esac
@@ -183,22 +183,13 @@ fi
update_version() {
local version=$1
local target_dir=""
- local cli_dir=""
-
- # Determine CLI-specific directory
- case "$CLI_NAME" in
- aztec)
- cli_dir="aztec-cli"
- ;;
- aztec-wallet)
- cli_dir="wallet-cli"
- ;;
- esac
+ # All CLI docs now go to the unified 'cli' directory
if [[ "$version" == "current" ]]; then
- target_dir="$DOCS_ROOT/docs-developers/docs/${cli_dir}"
+ target_dir="$DOCS_ROOT/docs-developers/docs/cli"
else
- target_dir="$DOCS_ROOT/developer_versioned_docs/version-${version}/docs/${cli_dir}"
+ # Versioned docs also use the unified cli directory
+ target_dir="$DOCS_ROOT/developer_versioned_docs/version-${version}/docs/cli"
fi
if [[ ! -d "$target_dir" ]]; then
From cbbe8eb377ab85e8a819c39586733aa9d44edf1b Mon Sep 17 00:00:00 2001
From: Alejo Amiras
Date: Wed, 24 Dec 2025 17:38:11 +0000
Subject: [PATCH 2/3] chore: update
docs/scripts/cli_reference_generation/update_cli_docs.sh
Co-authored-by: josh crites
---
docs/scripts/cli_reference_generation/update_cli_docs.sh | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/scripts/cli_reference_generation/update_cli_docs.sh b/docs/scripts/cli_reference_generation/update_cli_docs.sh
index 3c1cb9bff75d..e28bb44b778f 100755
--- a/docs/scripts/cli_reference_generation/update_cli_docs.sh
+++ b/docs/scripts/cli_reference_generation/update_cli_docs.sh
@@ -106,7 +106,7 @@ readonly TEMP_WITH_FRONTMATTER="$TEMP_DIR/cli_final.md"
case "$CLI_NAME" in
aztec)
DISPLAY_NAME="Aztec CLI Reference"
- TITLE="Aztec Reference"
+ TITLE="Aztec CLI Reference"
OUTPUT_FILE="aztec_cli_reference.md"
SIDEBAR_POSITION="1"
COMMAND="aztec"
From 17721052e8859562f1db65acf5d426d6e8348226 Mon Sep 17 00:00:00 2001
From: Alejo Amiras
Date: Fri, 26 Dec 2025 08:55:58 -0300
Subject: [PATCH 3/3] fix(docs): applies all josh's comments (#19250)
---
.../docs/aztec-js/how_to_test.md | 2 +-
.../docs/cli/aztec_cli_reference.md | 52 ++++--
.../docs/cli/aztec_wallet_cli_reference.md | 154 +++++++++++++-----
.../contract_tutorials/_category_.json | 2 +-
.../docs/tutorials/faceid_wallet.md | 2 +-
.../tutorials/js_tutorials/_category_.json | 2 +-
.../update_cli_docs.sh | 2 +-
7 files changed, 159 insertions(+), 57 deletions(-)
diff --git a/docs/docs-developers/docs/aztec-js/how_to_test.md b/docs/docs-developers/docs/aztec-js/how_to_test.md
index ed1b1d8a039f..e79dbda03aea 100644
--- a/docs/docs-developers/docs/aztec-js/how_to_test.md
+++ b/docs/docs-developers/docs/aztec-js/how_to_test.md
@@ -1,5 +1,5 @@
---
-title: Testing Aztec.nr contracts with TypeScript
+title: Testing Smart Contracts
tags: [contracts, tests]
sidebar_position: 8
description: Learn how to write and run tests for your Aztec.js applications.
diff --git a/docs/docs-developers/docs/cli/aztec_cli_reference.md b/docs/docs-developers/docs/cli/aztec_cli_reference.md
index 8a96dae6923c..6c6461a82b1d 100644
--- a/docs/docs-developers/docs/cli/aztec_cli_reference.md
+++ b/docs/docs-developers/docs/cli/aztec_cli_reference.md
@@ -1,6 +1,6 @@
---
-title: Aztec Reference
-description: Comprehensive auto-generated reference for the Aztec CLI command-line interface with all commands and options.
+title: Aztec CLI Reference
+description: Comprehensive auto-generated reference for the Aztec CLI Reference command-line interface with all commands and options.
tags: [cli, reference, autogenerated]
sidebar_position: 1
---
@@ -9,7 +9,8 @@ sidebar_position: 1
*This documentation is auto-generated from the `aztec` CLI help output.*
-*Generated: Tue Nov 11 00:40:17 HKT 2025*
+
+*Generated: Wed 24 Dec 2025 17:46:59 UTC*
*Command: `aztec`*
@@ -617,6 +618,7 @@ Options:
deployment (default: 0)
-c, --l1-chain-id Chain ID of the ethereum host (default:
31337, env: L1_CHAIN_ID)
+ --salt The optional salt to use in deployment
--json Output the contract addresses in JSON
format
--test-accounts Populate genesis state with initial fee
@@ -1404,19 +1406,27 @@ Options:
Base URLs for snapshots index, comma-separated.
*Environment: `$SYNC_SNAPSHOTS_URLS`*
-**LOCAL NETWORK**
+- `--fisherman-mode`
+ Whether to run in fisherman mode.
+ *Environment: `$FISHERMAN_MODE`*
+
+**SANDBOX**
-- `--local-network`
- Starts Aztec Local Network
+- `--sandbox`
+ Starts Aztec Sandbox
-- `--local-network.noPXE`
- Do not expose PXE service on local network start
+- `--sandbox.noPXE`
+ Do not expose PXE service on sandbox start
*Environment: `$NO_PXE`*
-- `--local-network.l1Mnemonic ` (default: `test test test test test test test test test test test junk`)
+- `--sandbox.l1Mnemonic ` (default: `test test test test test test test test test test test junk`)
Mnemonic for L1 accounts. Will be used
*Environment: `$MNEMONIC`*
+- `--sandbox.deployAztecContractsSalt `
+ Numeric salt for deploying L1 Aztec contracts before starting the sandbox. Needs mnemonic or private key to be set.
+ *Environment: `$DEPLOY_AZTEC_CONTRACTS_SALT`*
+
**API**
- `--port ` (default: `8080`)
@@ -1530,6 +1540,14 @@ Options:
- `--archiver.skipValidateBlockAttestations `
Whether to skip validating block attestations (use only for testing).
+- `--archiver.maxAllowedEthClientDriftSeconds ` (default: `300`)
+ Maximum allowed drift in seconds between the Ethereum client and current time.
+ *Environment: `$MAX_ALLOWED_ETH_CLIENT_DRIFT_SECONDS`*
+
+- `--archiver.ethereumAllowNoDebugHosts ` (default: `true`)
+ Whether to allow starting the archiver without debug/trace method support on Ethereum hosts
+ *Environment: `$ETHEREUM_ALLOW_NO_DEBUG_HOSTS`*
+
**SEQUENCER**
- `--sequencer`
@@ -1637,6 +1655,9 @@ Options:
- `--sequencer.injectFakeAttestation `
Inject a fake attestation (for testing only)
+- `--sequencer.shuffleAttestationOrdering `
+ Shuffle attestation ordering to create invalid ordering (for testing only)
+
- `--sequencer.txPublicSetupAllowList `
The list of functions calls allowed to run in setup
*Environment: `$TX_PUBLIC_SETUP_ALLOWLIST`*
@@ -1657,6 +1678,10 @@ Options:
True to use publishers in invalid states (timed out, cancelled, etc) if no other is available
*Environment: `$SEQ_PUBLISHER_ALLOW_INVALID_STATES`*
+- `--sequencer.publisherForwarderAddress `
+ Address of the forwarder contract to wrap all L1 transactions through (for testing purposes only)
+ *Environment: `$SEQ_PUBLISHER_FORWARDER_ADDRESS`*
+
- `--sequencer.blobSinkUrl `
The URL of the blob sink
*Environment: `$BLOB_SINK_URL`*
@@ -1743,6 +1768,10 @@ Options:
True to use publishers in invalid states (timed out, cancelled, etc) if no other is available
*Environment: `$PROVER_PUBLISHER_ALLOW_INVALID_STATES`*
+- `--proverNode.publisherForwarderAddress `
+ Address of the forwarder contract to wrap all L1 transactions through (for testing purposes only)
+ *Environment: `$PROVER_PUBLISHER_FORWARDER_ADDRESS`*
+
- `--proverNode.publisherPrivateKeys `
The private keys to be used by the publisher.
*Environment: `$PROVER_PUBLISHER_PRIVATE_KEYS`*
@@ -2161,7 +2190,7 @@ Options:
A list of metric prefixes to publicly export
*Environment: `$PUBLIC_OTEL_INCLUDE_METRICS`*
-- `--tel.publicMetricsOptOut `
+- `--tel.publicMetricsOptOut ` (default: `true`)
Whether to opt out of sharing optional telemetry
*Environment: `$PUBLIC_OTEL_OPT_OUT`*
@@ -2336,8 +2365,7 @@ Usage: aztec update [options] [projectPath]
Updates Nodejs and Noir dependencies
Arguments:
- projectPath Path to the project directory (default:
- "/Users/aztec/code/aztec-packages/docs")
+ projectPath Path to the project directory
Options:
--contract [paths...] Paths to contracts to update dependencies (default:
diff --git a/docs/docs-developers/docs/cli/aztec_wallet_cli_reference.md b/docs/docs-developers/docs/cli/aztec_wallet_cli_reference.md
index 826de257df3d..ef3f67547bb3 100644
--- a/docs/docs-developers/docs/cli/aztec_wallet_cli_reference.md
+++ b/docs/docs-developers/docs/cli/aztec_wallet_cli_reference.md
@@ -1,16 +1,16 @@
---
-title: Aztec Wallet Reference
-description: Comprehensive auto-generated reference for the Aztec Wallet CLI command-line interface with all commands and options.
+title: Aztec Wallet CLI Reference
+description: Comprehensive auto-generated reference for the Aztec Wallet CLI Reference command-line interface with all commands and options.
tags: [cli, reference, autogenerated, wallet]
sidebar_position: 2
---
-# Reference
+# Aztec Wallet CLI Reference
*This documentation is auto-generated from the `aztec-wallet` CLI help output.*
-*Generated: Wed Dec 10 21:36:08 -03 2025*
+*Generated: Wed 24 Dec 2025 17:50:03 UTC*
*Command: `aztec-wallet`*
@@ -28,6 +28,7 @@ sidebar_position: 2
- [aztec-wallet create-authwit](#aztec-wallet-create-authwit)
- [aztec-wallet authorize-action](#aztec-wallet-authorize-action)
- [aztec-wallet get-tx](#aztec-wallet-get-tx)
+ - [aztec-wallet cancel-tx](#aztec-wallet-cancel-tx)
- [aztec-wallet register-sender](#aztec-wallet-register-sender)
- [aztec-wallet register-contract](#aztec-wallet-register-contract)
- [aztec-wallet alias](#aztec-wallet-alias)
@@ -46,7 +47,7 @@ wallet [options] [command]
- `import-test-accounts [options]` - Import test accounts from pxe.
- `create-account [options]` - Creates an aztec account that can be used for sending transactions.
-- `deploy-account [options] ` - Deploys an already registered aztec account that can be used for sending transactions.
+- `deploy-account [options]` - Deploys an already registered aztec account that can be used for sending transactions.
- `deploy [options] [artifact]` - Deploys a compiled Aztec.nr contract to Aztec.
- `send [options] ` - Calls a function on an Aztec contract.
- `simulate [options] ` - Simulates the execution of a function on an Aztec contract.
@@ -55,6 +56,7 @@ wallet [options] [command]
- `create-authwit [options] ` - Creates an authorization witness that can be privately sent to a caller so they can perform an action on behalf of the provided account
- `authorize-action [options] ` - Authorizes a public call on the caller, so they can perform an action on behalf of the provided account
- `get-tx [options] [txHash]` - Gets the status of the recent txs, or a detailed view if a specific transaction hash is provided
+- `cancel-tx [options] ` - Cancels a pending tx by reusing its nonce with a higher fee and an empty payload
- `register-sender [options] [address]` - Registers a sender's address in the wallet, so the note synching process will look for notes sent by them
- `register-contract [options] [address] [artifact]` - Registers a contract in this wallet's PXE
- `alias ` - Aliases information for easy reference.
@@ -65,8 +67,9 @@ wallet [options] [command]
**Options:**
- `-V --version` - output the version number
-- `-d --data-dir ` - Storage directory for wallet data (default: "/Users/aztec/.aztec/wallet")
-- `-p --prover ` - The type of prover the wallet uses (choices: "wasm", "native", "none", default: "native", env: PXE_PROVER)
+- `-d --data-dir ` - Storage directory for wallet data
+- `-p --prover ` - The type of prover the wallet uses (only applies if not using a remote PXE) (choices: "wasm", "native", "none", default: "native", env: PXE_PROVER)
+- `--remote-pxe` - Connect to an external PXE RPC server instead of the local one (default: false, env: REMOTE_PXE)
- `-n --node-url ` - URL of the Aztec node to connect to (default: "http://host.docker.internal:8080", env: AZTEC_NODE_URL)
- `-h --help` - display help for command
@@ -81,15 +84,21 @@ Usage: wallet import-test-accounts [options]
Import test accounts from pxe.
Options:
- --json Emit output as json
- -h, --help display help for command
-2025/12/10 21:36:09 socat[62917] E exactly 2 addresses required (there are 3); use option "-h" for help
+ -u, --rpc-url URL of the PXE (default:
+ "http://host.docker.internal:8080", env: PXE_URL)
+ --json Emit output as json
+ -h, --help display help for command
+[17:50:05.462] INFO: wallet Using local PXE service
+[17:50:05.463] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:04 socat[75555] E exactly 2 addresses required (there are 3); use option "-h" for help
```
### aztec-wallet create-account
```
+[17:50:06.230] INFO: wallet Using local PXE service
+[17:50:06.231] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
Usage: wallet create-account [options]
Creates an aztec account that can be used for sending transactions. Registers
@@ -98,72 +107,76 @@ single-key account which uses the same key for encryption and authentication
(not secure for production usage).
Options:
- -f, --from Alias or address of the account performing the deployment
--skip-initialization Skip initializing the account contract. Useful for publicly deploying an existing account.
--public-deploy Publishes the account contract instance (and the class, if needed). Needed if the contract contains public functions.
- --register-class Register the contract class (useful for when the contract class has not been deployed yet).
-p, --public-key Public key that identifies a private signing key stored outside of the wallet. Used for ECDSA SSH accounts over the secp256r1 curve.
+ -u, --rpc-url URL of the PXE (default: "http://host.docker.internal:8080", env: PXE_URL)
-sk, --secret-key Secret key for account. Uses random by default. (env: SECRET_KEY)
-a, --alias Alias for the account. Used for easy reference in subsequent commands.
-t, --type Type of account to create (choices: "schnorr", "ecdsasecp256r1", "ecdsasecp256r1ssh", "ecdsasecp256k1", default: "schnorr")
- --register-only Just register the account on the Wallet. Do not deploy or initialize the account contract.
+ --register-only Just register the account on the PXE. Do not deploy or initialize the account contract.
--json Emit output as json
--no-wait Skip waiting for the contract to be deployed. Print the hash of deployment transaction
-v, --verbose Provide timings on all executed operations (synching, simulating, proving) (default: false)
--payment Fee payment method and arguments.
Parameters:
method Valid values: "fee_juice", "fpc-public", "fpc-private", "fpc-sponsored" Default: fee_juice
+ feePayer The account paying the fee.
asset The asset used for fee payment. Required for "fpc-public" and "fpc-private".
fpc The FPC contract that pays in fee juice. Not required for the "fee_juice" method.
claim Whether to use a previously stored claim to bridge fee juice.
claimSecret The secret to claim fee juice on L1.
claimAmount The amount of fee juice to be claimed.
messageLeafIndex The index of the claim in the l1toL2Message tree.
- Format: --payment method=name,asset=address,fpc=address ...
+ feeRecipient Recipient of the fee.
+ Format: --payment method=name,feePayer=address,asset=address ...
--gas-limits Gas limits for the tx.
--max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
--max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
+ --estimate-gas Whether to automatically estimate gas limits for the tx.
--estimate-gas-only Only report gas estimation for the tx, do not send it.
-h, --help display help for command
-2025/12/10 21:36:10 socat[62945] E exactly 2 addresses required (there are 3); use option "-h" for help
+2025/12/24 14:50:05 socat[75563] E exactly 2 addresses required (there are 3); use option "-h" for help
```
### aztec-wallet deploy-account
```
-Usage: wallet deploy-account [options]
+Usage: wallet deploy-account [options]
Deploys an already registered aztec account that can be used for sending
transactions.
-Arguments:
- address The address of the contract to register
-
Options:
- -f, --from Alias or address of the account performing the deployment
+ -f, --from Alias or address of the account to deploy
+ -u, --rpc-url URL of the PXE (default: "http://host.docker.internal:8080", env: PXE_URL)
--json Emit output as json
--no-wait Skip waiting for the contract to be deployed. Print the hash of deployment transaction
--register-class Register the contract class (useful for when the contract class has not been deployed yet).
--public-deploy Publishes the account contract instance (and the class, if needed). Needed if the contract contains public functions.
- --skip-initialization Skip initializing the account contract. Useful for publicly deploying an existing account.
-v, --verbose Provide timings on all executed operations (synching, simulating, proving) (default: false)
--payment Fee payment method and arguments.
Parameters:
method Valid values: "fee_juice", "fpc-public", "fpc-private", "fpc-sponsored" Default: fee_juice
+ feePayer The account paying the fee.
asset The asset used for fee payment. Required for "fpc-public" and "fpc-private".
fpc The FPC contract that pays in fee juice. Not required for the "fee_juice" method.
claim Whether to use a previously stored claim to bridge fee juice.
claimSecret The secret to claim fee juice on L1.
claimAmount The amount of fee juice to be claimed.
messageLeafIndex The index of the claim in the l1toL2Message tree.
- Format: --payment method=name,asset=address,fpc=address ...
+ feeRecipient Recipient of the fee.
+ Format: --payment method=name,feePayer=address,asset=address ...
--gas-limits Gas limits for the tx.
--max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
--max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
+ --estimate-gas Whether to automatically estimate gas limits for the tx.
--estimate-gas-only Only report gas estimation for the tx, do not send it.
-h, --help display help for command
-2025/12/10 21:36:11 socat[62955] E exactly 2 addresses required (there are 3); use option "-h" for help
+[17:50:07.000] INFO: wallet Using local PXE service
+[17:50:07.001] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:06 socat[75571] E exactly 2 addresses required (there are 3); use option "-h" for help
```
@@ -183,7 +196,9 @@ Options:
-k, --public-key Optional encryption public key for this address. Set this value only if this contract is expected to receive private notes, which will be encrypted using this public key.
-s, --salt Optional deployment salt as a hex string for generating the deployment address.
--universal Do not mix the sender address into the deployment.
+ -u, --rpc-url URL of the PXE (default: "http://host.docker.internal:8080", env: PXE_URL)
--args [args...] Constructor arguments (default: [])
+ -sk, --secret-key The sender's secret key (env: SECRET_KEY)
-f, --from Alias or address of the account to deploy from
-a, --alias Alias for the contract. Used for easy reference subsequent commands.
--json Emit output as json
@@ -201,13 +216,17 @@ Options:
claimSecret The secret to claim fee juice on L1.
claimAmount The amount of fee juice to be claimed.
messageLeafIndex The index of the claim in the l1toL2Message tree.
+ feeRecipient Recipient of the fee.
Format: --payment method=name,asset=address,fpc=address ...
--gas-limits Gas limits for the tx.
--max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
--max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
+ --estimate-gas Whether to automatically estimate gas limits for the tx.
--estimate-gas-only Only report gas estimation for the tx, do not send it.
-h, --help display help for command
-2025/12/10 21:36:12 socat[62985] E exactly 2 addresses required (there are 3); use option "-h" for help
+[17:50:07.772] INFO: wallet Using local PXE service
+[17:50:07.773] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:07 socat[75599] E exactly 2 addresses required (there are 3); use option "-h" for help
```
@@ -222,13 +241,16 @@ Arguments:
functionName Name of function to execute
Options:
+ -u, --rpc-url URL of the PXE (default: "http://host.docker.internal:8080", env: PXE_URL)
--args [args...] Function arguments (default: [])
-c, --contract-artifact Path to a compiled Aztec contract's artifact in JSON format. If executed inside a nargo workspace, a package and contract name can be specified as package@contract
-ca, --contract-address Aztec address of the contract.
-a, --alias Alias for the transaction hash. Used for easy reference in subsequent commands.
+ -sk, --secret-key The sender's secret key (env: SECRET_KEY)
-aw, --auth-witness Authorization witness to use for the transaction. If using multiple, pass a comma separated string
-f, --from Alias or address of the account to send the transaction from
--no-wait Print transaction hash without waiting for it to be mined
+ --no-cancel Do not allow the transaction to be cancelled. This makes for cheaper transactions.
-v, --verbose Provide timings on all executed operations (synching, simulating, proving) (default: false)
--payment Fee payment method and arguments.
Parameters:
@@ -239,19 +261,24 @@ Options:
claimSecret The secret to claim fee juice on L1.
claimAmount The amount of fee juice to be claimed.
messageLeafIndex The index of the claim in the l1toL2Message tree.
+ feeRecipient Recipient of the fee.
Format: --payment method=name,asset=address,fpc=address ...
--gas-limits Gas limits for the tx.
--max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
--max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
+ --estimate-gas Whether to automatically estimate gas limits for the tx.
--estimate-gas-only Only report gas estimation for the tx, do not send it.
-h, --help display help for command
-2025/12/10 21:36:13 socat[62995] E exactly 2 addresses required (there are 3); use option "-h" for help
+[17:50:08.514] INFO: wallet Using local PXE service
+[17:50:08.515] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:07 socat[75607] E exactly 2 addresses required (there are 3); use option "-h" for help
```
### aztec-wallet simulate
```
+[17:50:09.287] INFO: wallet Using local PXE service
Usage: wallet simulate [options]
Simulates the execution of a function on an Aztec contract.
@@ -260,6 +287,7 @@ Arguments:
functionName Name of function to simulate
Options:
+ -u, --rpc-url URL of the PXE (default: "http://host.docker.internal:8080", env: PXE_URL)
--args [args...] Function arguments (default: [])
-ca, --contract-address Aztec address of the contract.
-c, --contract-artifact Path to a compiled Aztec contract's artifact in JSON format. If executed inside a nargo workspace, a package and contract name can be specified as package@contract
@@ -276,13 +304,16 @@ Options:
claimSecret The secret to claim fee juice on L1.
claimAmount The amount of fee juice to be claimed.
messageLeafIndex The index of the claim in the l1toL2Message tree.
+ feeRecipient Recipient of the fee.
Format: --payment method=name,asset=address,fpc=address ...
--gas-limits Gas limits for the tx.
--max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
--max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
+ --estimate-gas Whether to automatically estimate gas limits for the tx.
--estimate-gas-only Only report gas estimation for the tx, do not send it.
-h, --help display help for command
-2025/12/10 21:36:14 socat[63023] E exactly 2 addresses required (there are 3); use option "-h" for help
+[17:50:09.288] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:08 socat[75615] E exactly 2 addresses required (there are 3); use option "-h" for help
```
@@ -298,10 +329,12 @@ Arguments:
functionName Name of function to simulate
Options:
+ -u, --rpc-url URL of the PXE (default: "http://host.docker.internal:8080", env: PXE_URL)
--args [args...] Function arguments (default: [])
-ca, --contract-address Aztec address of the contract.
-c, --contract-artifact Path to a compiled Aztec contract's artifact in JSON format. If executed inside a nargo workspace, a package and contract name can be specified as package@contract
--debug-execution-steps-dir Directory to write execution step artifacts for bb profiling/debugging.
+ -sk, --secret-key The sender's secret key (env: SECRET_KEY)
-aw, --auth-witness Authorization witness to use for the simulation
-f, --from Alias or address of the account to simulate from
--payment Fee payment method and arguments.
@@ -313,19 +346,24 @@ Options:
claimSecret The secret to claim fee juice on L1.
claimAmount The amount of fee juice to be claimed.
messageLeafIndex The index of the claim in the l1toL2Message tree.
+ feeRecipient Recipient of the fee.
Format: --payment method=name,asset=address,fpc=address ...
--gas-limits Gas limits for the tx.
--max-fees-per-gas Maximum fees per gas unit for DA and L2 computation.
--max-priority-fees-per-gas Maximum priority fees per gas unit for DA and L2 computation.
+ --estimate-gas Whether to automatically estimate gas limits for the tx.
--estimate-gas-only Only report gas estimation for the tx, do not send it.
-h, --help display help for command
-2025/12/10 21:36:15 socat[63033] E exactly 2 addresses required (there are 3); use option "-h" for help
+[17:50:10.052] INFO: wallet Using local PXE service
+[17:50:10.053] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:09 socat[75641] E exactly 2 addresses required (there are 3); use option "-h" for help
```
### aztec-wallet bridge-fee-juice
```
+[17:50:10.813] INFO: wallet Using local PXE service
Usage: wallet bridge-fee-juice [options]
Mints L1 Fee Juice and pushes them to L2.
@@ -345,6 +383,8 @@ Options:
junk")
--mint Mint the tokens on L1 (default: false)
--l1-private-key The private key to the eth account bridging
+ -u, --rpc-url URL of the PXE (default:
+ "http://host.docker.internal:8080", env: PXE_URL)
-c, --l1-chain-id Chain ID of the ethereum host (default: 31337,
env: L1_CHAIN_ID)
--json Output the claim in JSON format
@@ -353,7 +393,8 @@ Options:
--interval The polling interval in seconds for the bridged
funds (default: "60")
-h, --help display help for command
-2025/12/10 21:36:16 socat[63061] E exactly 2 addresses required (there are 3); use option "-h" for help
+[17:50:10.814] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:10 socat[75649] E exactly 2 addresses required (there are 3); use option "-h" for help
```
@@ -370,19 +411,25 @@ Arguments:
caller Account to be authorized to perform the action
Options:
+ -u, --rpc-url URL of the PXE (default: "http://host.docker.internal:8080", env: PXE_URL)
--args [args...] Function arguments (default: [])
-ca, --contract-address Aztec address of the contract.
-c, --contract-artifact Path to a compiled Aztec contract's artifact in JSON format. If executed inside a nargo workspace, a package and contract name can be specified as package@contract
+ -sk, --secret-key The sender's secret key (env: SECRET_KEY)
-f, --from Alias or address of the account to simulate from
-a, --alias Alias for the authorization witness. Used for easy reference in subsequent commands.
-h, --help display help for command
-2025/12/10 21:36:17 socat[63079] E exactly 2 addresses required (there are 3); use option "-h" for help
+[17:50:11.562] INFO: wallet Using local PXE service
+[17:50:11.563] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:10 socat[75675] E exactly 2 addresses required (there are 3); use option "-h" for help
```
### aztec-wallet authorize-action
```
+[17:50:12.330] INFO: wallet Using local PXE service
+[17:50:12.331] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
Usage: wallet authorize-action [options]
Authorizes a public call on the caller, so they can perform an action on behalf
@@ -393,12 +440,14 @@ Arguments:
caller Account to be authorized to perform the action
Options:
+ -u, --rpc-url URL of the PXE (default: "http://host.docker.internal:8080", env: PXE_URL)
--args [args...] Function arguments (default: [])
-ca, --contract-address Aztec address of the contract.
-c, --contract-artifact Path to a compiled Aztec contract's artifact in JSON format. If executed inside a nargo workspace, a package and contract name can be specified as package@contract
+ -sk, --secret-key The sender's secret key (env: SECRET_KEY)
-f, --from Alias or address of the account to simulate from
-h, --help display help for command
-2025/12/10 21:36:18 socat[63107] E exactly 2 addresses required (there are 3); use option "-h" for help
+2025/12/24 14:50:11 socat[75685] E exactly 2 addresses required (there are 3); use option "-h" for help
```
@@ -414,36 +463,51 @@ Arguments:
txHash A transaction hash to get the receipt for.
Options:
+ -u, --rpc-url URL of the PXE (default:
+ "http://host.docker.internal:8080", env: PXE_URL)
-p, --page The page number to display (default: 1)
-s, --page-size The number of transactions to display per page
(default: 10)
-h, --help display help for command
-2025/12/10 21:36:19 socat[63117] E exactly 2 addresses required (there are 3); use option "-h" for help
+[17:50:13.095] INFO: wallet Using local PXE service
+[17:50:13.096] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:12 socat[75694] E exactly 2 addresses required (there are 3); use option "-h" for help
```
+### aztec-wallet cancel-tx
+
+*Help for this command is currently unavailable due to a technical issue with option serialization.*
+
+
### aztec-wallet register-sender
```
+[17:50:14.608] INFO: wallet Using local PXE service
Usage: wallet register-sender [options] [address]
Registers a sender's address in the wallet, so the note synching process will
look for notes sent by them
Arguments:
- address The address of the sender to register
+ address The address of the sender to register
Options:
- -a, --alias Alias for the sender. Used for easy reference in
- subsequent commands.
- -h, --help display help for command
-2025/12/10 21:36:20 socat[63127] E exactly 2 addresses required (there are 3); use option "-h" for help
+ -u, --rpc-url URL of the PXE (default:
+ "http://host.docker.internal:8080", env: PXE_URL)
+ -f, --from Alias or address of the account to simulate from
+ -a, --alias Alias for the sender. Used for easy reference in
+ subsequent commands.
+ -h, --help display help for command
+[17:50:14.609] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:13 socat[75728] E exactly 2 addresses required (there are 3); use option "-h" for help
```
### aztec-wallet register-contract
```
+[17:50:15.362] INFO: wallet Using local PXE service
Usage: wallet register-contract [options] [address] [artifact]
Registers a contract in this wallet's PXE
@@ -467,10 +531,14 @@ Options:
--deployer The address of the account that deployed the
contract
--args [args...] Constructor arguments (default: [])
+ -u, --rpc-url URL of the PXE (default:
+ "http://host.docker.internal:8080", env: PXE_URL)
+ -f, --from Alias or address of the account to simulate from
-a, --alias Alias for the contact. Used for easy reference in
subsequent commands.
-h, --help display help for command
-2025/12/10 21:36:21 socat[63155] E exactly 2 addresses required (there are 3); use option "-h" for help
+[17:50:15.363] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:14 socat[75736] E exactly 2 addresses required (there are 3); use option "-h" for help
```
@@ -489,13 +557,17 @@ Arguments:
Options:
-h, --help display help for command
-2025/12/10 21:36:21 socat[63165] E exactly 2 addresses required (there are 3); use option "-h" for help
+[17:50:16.114] INFO: wallet Using local PXE service
+[17:50:16.115] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:15 socat[75762] E exactly 2 addresses required (there are 3); use option "-h" for help
```
### aztec-wallet get-alias
```
+[17:50:16.891] INFO: wallet Using local PXE service
+[17:50:16.892] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
Usage: wallet get-alias [options] [alias]
Shows stored aliases
@@ -505,7 +577,7 @@ Arguments:
Options:
-h, --help display help for command
-2025/12/10 21:36:22 socat[63195] E exactly 2 addresses required (there are 3); use option "-h" for help
+2025/12/24 14:50:16 socat[75770] E exactly 2 addresses required (there are 3); use option "-h" for help
```
@@ -519,6 +591,8 @@ Creates an aliased secret to use in other commands
Options:
-a, --alias Key to alias the secret with
-h, --help display help for command
-2025/12/10 21:36:23 socat[63205] E exactly 2 addresses required (there are 3); use option "-h" for help
+[17:50:17.657] INFO: wallet Using local PXE service
+[17:50:17.658] INFO: kv-store:lmdb-v2 Starting data store with maxReaders 16
+2025/12/24 14:50:17 socat[75798] E exactly 2 addresses required (there are 3); use option "-h" for help
```
diff --git a/docs/docs-developers/docs/tutorials/contract_tutorials/_category_.json b/docs/docs-developers/docs/tutorials/contract_tutorials/_category_.json
index 94fd42c74601..852419cf5598 100644
--- a/docs/docs-developers/docs/tutorials/contract_tutorials/_category_.json
+++ b/docs/docs-developers/docs/tutorials/contract_tutorials/_category_.json
@@ -1,6 +1,6 @@
{
"label": "Contract Tutorials",
- "position": 2,
+ "position": 1,
"collapsible": true,
"collapsed": true
}
diff --git a/docs/docs-developers/docs/tutorials/faceid_wallet.md b/docs/docs-developers/docs/tutorials/faceid_wallet.md
index a98cb585d1ca..57681484f93e 100644
--- a/docs/docs-developers/docs/tutorials/faceid_wallet.md
+++ b/docs/docs-developers/docs/tutorials/faceid_wallet.md
@@ -2,7 +2,7 @@
title: Using FaceID to Sign Transactions
tags: [local_network, wallet, cli]
keywords: [wallet, cli wallet, faceid]
-sidebar_position: 1
+sidebar_position: 3
description: In this tutorial, we will use Apple Mac's Secure Enclave to store the private key, and use it in Aztec's CLI Wallet. This enables fully private, native, and ...
---
diff --git a/docs/docs-developers/docs/tutorials/js_tutorials/_category_.json b/docs/docs-developers/docs/tutorials/js_tutorials/_category_.json
index 132c6fc4c952..d497430c8a5e 100644
--- a/docs/docs-developers/docs/tutorials/js_tutorials/_category_.json
+++ b/docs/docs-developers/docs/tutorials/js_tutorials/_category_.json
@@ -1,6 +1,6 @@
{
"label": "Full-Stack Tutorials",
- "position": 3,
+ "position": 2,
"collapsible": true,
"collapsed": true
}
diff --git a/docs/scripts/cli_reference_generation/update_cli_docs.sh b/docs/scripts/cli_reference_generation/update_cli_docs.sh
index e28bb44b778f..bf277cee410a 100755
--- a/docs/scripts/cli_reference_generation/update_cli_docs.sh
+++ b/docs/scripts/cli_reference_generation/update_cli_docs.sh
@@ -113,7 +113,7 @@ case "$CLI_NAME" in
;;
aztec-wallet)
DISPLAY_NAME="Aztec Wallet CLI Reference"
- TITLE="Aztec Wallet Reference"
+ TITLE="Aztec Wallet CLI Reference"
OUTPUT_FILE="aztec_wallet_cli_reference.md"
SIDEBAR_POSITION="2"
COMMAND="aztec-wallet"