Skip to main content
Version: Devnet (v3.0.0-devnet.5)

Developing Smart Contracts

Aztec.nr is the smart contract development framework for Aztec. It is a set of utilities that help you write Noir programs to deploy on the Aztec network.

Contract Development​

Prerequisites​

Flow​

  1. Write your contract and specify your contract dependencies. Every contract written for Aztec will have aztec-nr as a dependency. Add it to your Nargo.toml with
# Nargo.toml
[dependencies]
aztec = { git="https://github.com/AztecProtocol/aztec-packages/", tag="v3.0.0-devnet.5", directory="noir-projects/smart-contracts/aztec" }

Update your main.nr contract file to use the Aztec.nr macros for writing contracts.

use dep::aztec::macros::aztec;

#[aztec]
pub contract Counter {
    // Your contract code here
}

and import dependencies from the Aztec.nr library.

use dep::aztec::macros::aztec;

#[aztec]
pub contract Counter {
    use aztec::{
        macros::{functions::{external, initializer}, storage::storage},
        oracle::debug_log::debug_log_format, protocol_types::{address::AztecAddress, traits::ToField},
        state_vars::Map,
    };

    // your contract code here
}
info

You can see a complete example of a simple counter contract written with Aztec.nr here.

  1. Profile the private functions in your contract to get a sense of how long generating client side proofs will take
  2. Write unit tests directly in Noir and end-to-end tests with TypeScript
  3. Compile your contract
  4. Deploy your contract with Aztec.js

Section Contents​