OpenParable
Skip to content
← Back to skills

Aztec Wallet

Apps & Automation
aztec-wallet

Aztec Wallet is an Agent Skill for apps & automation published in the AztecProtocol/aztec-packages repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Run cli-wallet commands against a live Aztec network. Deploy contracts, send transactions, query state, bridge funds, and manage accounts.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/AztecProtocol/aztec-packages/blob/HEAD/.claude/skills/aztec-wallet/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/aztec-wallet, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Aztec Wallet

Run @aztec/cli-wallet commands against a live Aztec network. Handles network resolution, cli-wallet installation, account setup, and alias management automatically.

Known Networks

NetworkRPC EndpointNotes
next-nethttps://nextnet.aztec-labs.comRuns nightly from next branch
testnethttps://rpc.testnet.aztec-labs.comRuns nightly from v4-next branch

Custom RPC URLs (starting with http:// or https:// or IP addresses) are also accepted. If an IP address is provided without a port assume a default port of 8080.

Step 1: Parse User Request

Determine from the user's message:

  • Network: A known name from the table above, or a custom RPC URL
  • Command: What the user wants to do — deploy, send, call, bridge, account setup, etc.
  • Private key (optional): defaults to 0xc140de (schnorr account, salt 0)

If the request is ambiguous, ask the user to clarify.

Step 2: Resolve RPC URL

  • Known network name → look up from the table
  • Unknown network → ask the user for their RPC URL
  • Custom URL → use directly

Do NOT run any bash commands (no curl, no version query). The agent handles that.

Step 3: Delegate to Agent

Spawn the aztec-wallet agent with a structured prompt:

FIRST: Read .claude/agents/aztec-wallet.md for full operational instructions.

Then execute the following:

NETWORK: <network-name or "custom">
RPC_URL: <resolved-url>
WORKING_DIR: /tmp/aztec-wallet-<network-name>/
PRIVATE_KEY: <hex, default 0xc140de>
SALT: 0

COMMAND: <what the user wants to do, in natural language or as a cli-wallet command>

The agent will query the node version, install the matching cli-wallet, set up the account, and execute the command.

IMPORTANT — shared WORKING_DIR: When spawning multiple agents (e.g. different accounts on the same network), they must ALL use the same WORKING_DIR (/tmp/aztec-wallet-<network-name>/). Do NOT create per-agent directories. Per-account isolation is already handled by INSTANCE_HASH inside the agent, which creates separate data_$INSTANCE_HASH subdirectories based on the private key and salt. Sharing the working dir also avoids redundant npm installs.

Alias Conventions

The cli-wallet has a persistent alias system. Use it consistently:

  • Account alias: default for the auto-created account, or user-provided names
  • Contract alias: lowercase artifact name without "Contract" suffix (e.g. TokenContract → token)
  • Aliases are prefixed by type when used: accounts:default, contracts:token
  • When the user says "the token contract" or "on token", interpret as alias contracts:token
  • When the user says "transfer to Grego", figure out from context which contract and function they mean

Examples

  • /aztec-wallet testnet status → show L2 address, balance, known contracts (no tx sent)
  • /aztec-wallet testnet deploy TokenContract → deploy Token, alias as token
  • /aztec-wallet testnet send mint_to_public on token --args <addr> 1000 → mint tokens
  • /aztec-wallet testnet call balance_of_public on token --args <addr> → read balance
  • /aztec-wallet testnet send mint_to_private on token --args <addr> 1000 → mint tokens to private balance
  • /aztec-wallet testnet send transfer on token --args <recipient> 150 → private transfer (register recipient first)
  • /aztec-wallet testnet bridge 1000 to <address> → bridge Fee Juice (requires Sepolia ETH on L1)
  • /aztec-wallet next-net setup-account → create account, show L2 address for bridging
  • /aztec-wallet https://my-rpc.com deploy ./path/to/artifact.json → custom RPC + custom contract

Notes on Private Transfers

  • The recipient does not need their account deployed on-chain to receive private tokens
  • The sender must register-sender <recipient-address> before sending private tokens
  • The recipient will need a deployed account to later spend those tokens
  • bridge-fee-juice requires Sepolia ETH on the L1 address — it won't work with an unfunded key