> For the complete documentation index, see [llms.txt](/llms.txt)

# Aztec Wallet CLI Reference

*This documentation is auto-generated from the `aztec-wallet` CLI help output.*

*Generated: Tue 27 Oct 2026 21:28:23 UTC*

*Command: `aztec-wallet`*

## Table of Contents

* [aztec-wallet](#aztec-wallet)

  * [aztec-wallet alias](#aztec-wallet-alias)
  * [aztec-wallet authorize-action](#aztec-wallet-authorize-action)
  * [aztec-wallet bridge-fee-juice](#aztec-wallet-bridge-fee-juice)
  * [aztec-wallet create-account](#aztec-wallet-create-account)
  * [aztec-wallet create-authwit](#aztec-wallet-create-authwit)
  * [aztec-wallet create-secret](#aztec-wallet-create-secret)
  * [aztec-wallet deploy](#aztec-wallet-deploy)
  * [aztec-wallet deploy-account](#aztec-wallet-deploy-account)
  * [aztec-wallet get-alias](#aztec-wallet-get-alias)
  * [aztec-wallet get-fee-juice-balance](#aztec-wallet-get-fee-juice-balance)
  * [aztec-wallet get-tx](#aztec-wallet-get-tx)
  * [aztec-wallet import-test-accounts](#aztec-wallet-import-test-accounts)
  * [aztec-wallet profile](#aztec-wallet-profile)
  * [aztec-wallet register-contract](#aztec-wallet-register-contract)
  * [aztec-wallet register-sender](#aztec-wallet-register-sender)
  * [aztec-wallet send](#aztec-wallet-send)
  * [aztec-wallet simulate](#aztec-wallet-simulate)

## aztec-wallet

Aztec wallet

**Usage:**

```bash
aztec-wallet [options] [command]
```

**Available Commands:**

* `alias <type> <key> <value>` - Aliases information for easy reference.
* `authorize-action [options] <functionName> <caller>` - Authorizes a public call on the caller, so they can perform an action on behalf of the provided account
* `bridge-fee-juice [options] <amount> <recipient>` - Mints L1 Fee Juice and pushes them to L2.
* `create-account [options]` - Creates an aztec account that can be used for sending transactions.
* `create-authwit [options] <functionName> <caller>` - Creates an authorization witness that can be privately sent to a caller so they can perform an action on behalf of the provided account
* `create-secret [options]` - Creates an aliased secret to use in other commands
* `deploy [options] [artifact]` - Deploys a compiled Aztec.nr contract to Aztec.
* `deploy-account [options] <address>` - Deploys an already registered aztec account that can be used for sending transactions.
* `get-alias [alias]` - Shows stored aliases
* `get-fee-juice-balance [options] <address>` - Checks the Fee Juice balance for a given address.
* `get-tx [options] [txHash]` - Gets the status of the recent txs, or a detailed view if a specific transaction hash is provided
* `help [command]` - display help for command
* `import-test-accounts [options]` - Import test accounts from pxe.
* `profile [options] <functionName>` - Profiles a private function by counting the unconditional operations in its execution steps
* `register-contract [options] [address] [artifact]` - Registers a contract in this wallet's PXE
* `register-sender [options] [address]` - Registers a sender's address in the wallet, so the note synching process will look for notes sent by them
* `send [options] <functionName>` - Calls a function on an Aztec contract.
* `simulate [options] <functionName>` - Simulates the execution of a function on an Aztec contract.

**Options:**

* `-V --version` - output the version number
* `-d --data-dir <string>` - Storage directory for wallet data (default: "\~/.aztec/wallet")
* `-p --prover <string>` - The type of prover the wallet uses (choices: "wasm", "native", "none", default: "native", env: PXE\_PROVER)
* `-n --node-url <string>` - URL of the Aztec node to connect to (default: "<http://localhost:8080>", env: AZTEC\_NODE\_URL)
* `-h --help` - display help for command

### Subcommands

### aztec-wallet alias

Aliases information for easy reference.

**Usage:**

```bash
aztec-wallet alias [options] <type> <key> <value>
```

**Options:**

* `-h, --help` - display help for command

### aztec-wallet authorize-action

Authorizes a public call on the caller, so they can perform an action on behalf of the provided account

**Usage:**

```bash
aztec-wallet authorize-action [options] <functionName> <caller>
```

**Options:**

* `--args [args...]` - Function arguments (default: \[])
* `-ca, --contract-address <address>` - Aztec address of the contract.
* `-c, --contract-artifact <fileLocation>` - 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 <string>` - Alias or address of the account to simulate from
* `-h, --help` - display help for command

### aztec-wallet bridge-fee-juice

Mints L1 Fee Juice and pushes them to L2.

**Usage:**

```bash
aztec-wallet bridge-fee-juice [options] <amount> <recipient>
```

**Options:**

* `--l1-rpc-urls <string>` - List of Ethereum host URLs. Chain identifiers localhost and testnet can be used (comma separated) (default: \["http\://localhost:8545"])
* `-m, --mnemonic <string>` - 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 <string>` - The private key to the eth account bridging
* `-c, --l1-chain-id <number>` - 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 <number>` - The polling interval in seconds for the bridged funds (default: "60")
* `-h, --help` - display help for command

### aztec-wallet create-account

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 account which uses an immutable key for authentication.

**Usage:**

```bash
aztec-wallet create-account [options]
```

**Options:**

* `-f, --from <string>` - 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 <string>` - Public key that identifies a private signing key stored outside of the wallet. Used for ECDSA SSH accounts over the secp256r1 curve.
* `-sk, --signing-key <string>` - Signing key for account. Uses random by default. (env: SIGNING\_KEY)
* `-a, --alias <string>` - Alias for the account. Used for easy reference in subsequent commands.
* `-t, --type <string>` - Type of account to create (choices: "schnorr", "schnorr\_initializerless", "ecdsasecp256r1", "ecdsasecp256r1ssh", "ecdsasecp256k1", default: "schnorr")
* `-s, --salt <hex string>` - Optional deployment salt as a hex string for generating the deployment address. Defaults to 0.
* `--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
* `--wait-for-status <status>` - Tx status to wait for: 'proposed' or 'checkpointed' (default: "proposed")
* `-v, --verbose` - Provide timings on all executed operations (synching, simulating, proving) (default: false)
* `--payment <options>` - 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.
* `--gas-limits <da=100,l2=100,teardownDA=10,teardownL2=10>` - Gas limits for the tx.
* `--max-fees-per-gas <da=100,l2=100>` - Maximum fees per gas unit for DA and L2 computation.
* `--max-priority-fees-per-gas <da=0,l2=0>` - 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

### aztec-wallet create-authwit

Creates an authorization witness that can be privately sent to a caller so they can perform an action on behalf of the provided account

**Usage:**

```bash
aztec-wallet create-authwit [options] <functionName> <caller>
```

**Options:**

* `--args [args...]` - Function arguments (default: \[])
* `-ca, --contract-address <address>` - Aztec address of the contract.
* `-c, --contract-artifact <fileLocation>` - 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 <string>` - Alias or address of the account to simulate from
* `-a, --alias <string>` - Alias for the authorization witness. Used for easy reference in subsequent commands.
* `-h, --help` - display help for command

### aztec-wallet create-secret

Creates an aliased secret to use in other commands

**Usage:**

```bash
aztec-wallet create-secret [options]
```

**Options:**

* `-a, --alias <string>` - Key to alias the secret with
* `-h, --help` - display help for command

### aztec-wallet deploy

Deploys a compiled Aztec.nr contract to Aztec.

**Usage:**

```bash
aztec-wallet deploy [options] [artifact]
```

**Options:**

* `--init <string>` - The contract initializer function to call (default: "constructor")
* `--no-init` - Leave the contract uninitialized
* `-k, --public-key <string>` - 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 <hex string>` - Optional deployment salt as a hex string for generating the deployment address. Defaults to random.
* `--universal` - Do not mix the sender address into the deployment.
* `--args [args...]` - Constructor arguments (default: \[])
* `-f, --from <string>` - Alias or address of the account to deploy from
* `-a, --alias <string>` - 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 <number>` - The amount of time in seconds to wait for the deployment to post to L2
* `--wait-for-status <status>` - Tx status to wait for: 'proposed' or 'checkpointed' (default: "proposed")
* `-v, --verbose` - Provide timings on all executed operations (synching, simulating, proving) (default: false)
* `--payment <options>` - 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.
* `--gas-limits <da=100,l2=100,teardownDA=10,teardownL2=10>` - Gas limits for the tx.
* `--max-fees-per-gas <da=100,l2=100>` - Maximum fees per gas unit for DA and L2 computation.
* `--max-priority-fees-per-gas <da=0,l2=0>` - 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

### aztec-wallet deploy-account

Deploys an already registered aztec account that can be used for sending transactions.

**Usage:**

```bash
aztec-wallet deploy-account [options] <address>
```

**Options:**

* `-f, --from <string>` - 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.
* `--wait-for-status <status>` - Tx status to wait for: 'proposed' or 'checkpointed' (default: "proposed")
* `-v, --verbose` - Provide timings on all executed operations (synching, simulating, proving) (default: false)
* `--payment <options>` - 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.
* `--gas-limits <da=100,l2=100,teardownDA=10,teardownL2=10>` - Gas limits for the tx.
* `--max-fees-per-gas <da=100,l2=100>` - Maximum fees per gas unit for DA and L2 computation.
* `--max-priority-fees-per-gas <da=0,l2=0>` - 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

### aztec-wallet get-alias

Shows stored aliases

**Usage:**

```bash
aztec-wallet get-alias [options] [alias]
```

**Options:**

* `-h, --help` - display help for command

### aztec-wallet get-fee-juice-balance

Checks the Fee Juice balance for a given address.

**Usage:**

```bash
aztec-wallet get-fee-juice-balance [options] <address>
```

**Options:**

* `--json` - Emit output as json
* `--exact` - Show exact balance with all 18 decimal places
* `-h, --help` - display help for command

### aztec-wallet get-tx

Gets the status of the recent txs, or a detailed view if a specific transaction hash is provided

**Usage:**

```bash
aztec-wallet get-tx [options] [txHash]
```

**Options:**

* `-p, --page <number>` - The page number to display (default: 1)
* `-s, --page-size <number>` - The number of transactions to display per page (default: 10)
* `-h, --help` - display help for command

### aztec-wallet import-test-accounts

Import test accounts from pxe.

**Usage:**

```bash
aztec-wallet import-test-accounts [options]
```

**Options:**

* `--json` - Emit output as json
* `-h, --help` - display help for command

### aztec-wallet profile

Profiles a private function by counting the unconditional operations in its execution steps

**Usage:**

```bash
aztec-wallet profile [options] <functionName>
```

**Options:**

* `--args [args...]` - Function arguments (default: \[])
* `-ca, --contract-address <address>` - Aztec address of the contract.
* `-c, --contract-artifact <fileLocation>` - 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 <address>` - Directory to write execution step artifacts for bb profiling/debugging.
* `-aw, --auth-witness <string,...>` - Authorization witness to use for the simulation
* `-f, --from <string>` - Alias or address of the account to simulate from
* `--payment <options>` - 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.
* `--gas-limits <da=100,l2=100,teardownDA=10,teardownL2=10>` - Gas limits for the tx.
* `--max-fees-per-gas <da=100,l2=100>` - Maximum fees per gas unit for DA and L2 computation.
* `--max-priority-fees-per-gas <da=0,l2=0>` - 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

### aztec-wallet register-contract

Registers a contract in this wallet's PXE

**Usage:**

```bash
aztec-wallet register-contract [options] [address] [artifact]
```

**Options:**

* `--init <string>` - The contract initializer function to call (default: "constructor")
* `-k, --public-key <string>` - 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 <hex string>` - Optional deployment salt as a hex string for generating the deployment address.
* `--deployer <string>` - The address of the account that deployed the contract
* `--args [args...]` - Constructor arguments (default: \[])
* `-a, --alias <string>` - Alias for the contact. Used for easy reference in subsequent commands.
* `-h, --help` - display help for command

### aztec-wallet register-sender

Registers a sender's address in the wallet, so the note synching process will look for notes sent by them

**Usage:**

```bash
aztec-wallet register-sender [options] [address]
```

**Options:**

* `-a, --alias <string>` - Alias for the sender. Used for easy reference in subsequent commands.
* `-h, --help` - display help for command

### aztec-wallet send

Calls a function on an Aztec contract.

**Usage:**

```bash
aztec-wallet send [options] <functionName>
```

**Options:**

* `--args [args...]` - Function arguments (default: \[])
* `-c, --contract-artifact <fileLocation>` - 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 <address>` - Aztec address of the contract.
* `-a, --alias <string>` - Alias for the transaction hash. Used for easy reference in subsequent commands.
* `-aw, --auth-witness <string,...>` - Authorization witness to use for the transaction. If using multiple, pass a comma separated string
* `-f, --from <string>` - Alias or address of the account to send the transaction from
* `--no-wait` - Print transaction hash without waiting for it to be mined
* `--wait-for-status <status>` - Tx status to wait for: 'proposed' or 'checkpointed' (default: "proposed")
* `-v, --verbose` - Provide timings on all executed operations (synching, simulating, proving) (default: false)
* `--payment <options>` - 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.
* `--gas-limits <da=100,l2=100,teardownDA=10,teardownL2=10>` - Gas limits for the tx.
* `--max-fees-per-gas <da=100,l2=100>` - Maximum fees per gas unit for DA and L2 computation.
* `--max-priority-fees-per-gas <da=0,l2=0>` - 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

### aztec-wallet simulate

Simulates the execution of a function on an Aztec contract.

**Usage:**

```bash
aztec-wallet simulate [options] <functionName>
```

**Options:**

* `--args [args...]` - Function arguments (default: \[])
* `-ca, --contract-address <address>` - Aztec address of the contract.
* `-c, --contract-artifact <fileLocation>` - 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, --signing-key <string>` - The sender's signing key (env: SIGNING\_KEY)
* `-aw, --auth-witness <string,...>` - Authorization witness to use for the simulation
* `-f, --from <string>` - Alias or address of the account to simulate from
* `-v, --verbose` - Provide timings on all executed operations (synching, simulating, proving) (default: false)
* `--payment <options>` - 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.
* `--gas-limits <da=100,l2=100,teardownDA=10,teardownL2=10>` - Gas limits for the tx.
* `--max-fees-per-gas <da=100,l2=100>` - Maximum fees per gas unit for DA and L2 computation.
* `--max-priority-fees-per-gas <da=0,l2=0>` - 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