Aztec Starter

Sandbox

This repo is meant to be a starting point for writing Aztec contracts and tests on the Aztec sandbox (local development environment).

You can find the Easy Private Voting contract in ./src/main.nr. A simple integration test is in ./src/test/e2e/index.test.ts.

The corresponding tutorial can be found in the Aztec docs here.

Testnet

If you are interested in trying out this repo with the testnet, try the testnet branch. The testnet branch is more suitable for simple interactions with the testnet via script, or as a reference to see how to do something against a live, remote network. The main branch should be used for getting started with writing contracts and rapid, local testing.

---

🚀 Getting Started

Use Node.js version 22.15.0.

Start your codespace from the codespace dropdown.

Get the sandbox, aztec-cli, and other tooling with this command:

bash -i <(curl -s https://install.aztec.network)

Install the correct version of the toolkit with:

aztec-up 0.87.9

Start the sandbox with:

aztec start --sandbox

---

📦 Install Packages

yarn install

---

🏗 Compile

aztec-nargo compile

or

yarn compile

---

🔧 Codegen

Generate the contract artifact JSON and TypeScript interface:

yarn codegen

---

⚠️ Tests and scripts set up and run the Private Execution Environment (PXE) and store PXE data in the ./store directory. If you restart the sandbox, you will need to delete the ./store directory to avoid errors.

Transaction Profiling

Make sure the sandbox is running before profiling.

aztec start --sandbox

Then run an example contract deployment profile with:

yarn profile

🧪 Test

Make sure the sandbox is running before running tests.

aztec start --sandbox

Then test with:

yarn test

Testing will run the TypeScript tests defined in index.test.ts inside ./src/test/e2e, as well as the Aztec Testing eXecution Environment (TXE) tests defined in first.nr (imported in the contract file with mod test;).

Note: The Typescript tests spawn an instance of the sandbox to test against, and close it once the TS tests are complete.

---

Scripts

You can find a handful of scripts in the ./scripts folder.

• ./scripts/deploy_account.ts is an example of how to deploy a schnorr account.
• ./scripts/deploy_contract.ts is an example of how to deploy a contract.
• ./scripts/fees.ts is an example of how to pay for a contract deployment using various fee payment methods.
• ./scripts/multiple_pxe.ts is an example of how to deploy a contract from one PXE instance and interact with it from another.
• ./scripts/profile_deploy.ts shows how to profile a transaction and print the results.

❗ Error Resolution

⚠️ Tests and scripts set up and run the Private Execution Environment (PXE) and store PXE data in the ./store directory. If you restart the sandbox, you will need to delete the ./store directory to avoid errors.

🔄 Update Node.js and Noir Dependencies

yarn update

🔄 Update Contract

Get the contract code from the monorepo. The script will look at the versions defined in ./Nargo.toml and fetch that version of the code from the monorepo.

yarn update

You may need to update permissions with:

chmod +x .github/scripts/update_contract.sh

AI Agent Contributor Guide

This repository includes an AGENTS.md file with detailed instructions for setting up your environment, running tests, and creating pull requests. Please read it before contributing changes.

💬 Join the Community: