Merge pull request #253 from AztecProtocol/josh/update-version-4.1.0

Update Aztec version to 4.1.0

Author: critesjosh

.claude/commands/update-version.md

@@ -36,6 +36,7 @@ Read these files to understand current state:
 - `package.json`
 - `config/local-network.json`
 - `config/devnet.json`
+- `config/testnet.json`
 - `README.md`
 - `CLAUDE.md`
 
@@ -54,6 +55,10 @@ aztec = { git = "https://github.com/AztecProtocol/aztec-nr/", tag = "v<VERSION>"
 
 **4. `config/devnet.json`** — Update `settings.version` to the new npm version.
 
+**4b. `config/testnet.json`** — Update `settings.version` to the new npm version.
+
+> **Note:** Only update the config files relevant to the current branch. On `next`, update `local-network.json` and `devnet.json`. On `testnet`, update `local-network.json` and `testnet.json`. Leave other branch configs as-is.
+
 **5. `README.md`** — Update the install command version in the Getting Started section:
 ```bash
 export VERSION=<NEW_VERSION>
@@ -173,7 +178,15 @@ Based on the API research from Step 7 and any changes revealed by `yarn codegen`
 
 ### Step 11: Run Noir TXE tests
 
-Run `yarn test:nr` to execute the Noir unit tests in the TXE simulator (no network needed).
+Run the Noir unit tests in the TXE simulator (no network needed).
+
+**Known issue:** `yarn test:nr` (which runs `aztec test`) may hang due to a wrapper script issue. If it hangs for more than 30 seconds with no output, use this workaround:
+
+1. Kill any process on port 8081: `lsof -ti:8081 | xargs kill -9 2>/dev/null`
+2. Start the TXE server manually: `aztec start --txe --port 8081 &`
+3. Wait a few seconds for it to start
+4. Run nargo test directly: `nargo test --silence-warnings --oracle-resolver http://localhost:8081`
+5. Kill the TXE server when done
 
 If tests fail, diagnose and fix the contract test code. Iterate until tests pass.
 

CLAUDE.md

@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 Aztec Starter — a Pod Racing game contract built with Noir on the Aztec network. Two players allocate points across 5 tracks over 3 rounds with private state; scores are revealed at the end (commit-reveal pattern). The player who wins more tracks (best of 5) wins.
 
-**Aztec version: `4.1.0-rc.2`** — pinned across `Nargo.toml`, `package.json`, `config/*.json`, and README. All must stay in sync when updating.
+**Aztec version: `4.1.0`** — pinned across `Nargo.toml`, `package.json`, `config/*.json`, and README. All must stay in sync when updating.
 
 ## Build & Development Commands
 

Nargo.toml

@@ -5,4 +5,4 @@ authors = [ "" ]
 compiler_version = ">=0.18.0"
 
 [dependencies]
-aztec = { git = "https://github.com/AztecProtocol/aztec-nr/", tag = "v4.1.0-rc.2", directory = "aztec" }
+aztec = { git = "https://github.com/AztecProtocol/aztec-nr/", tag = "v4.1.0", directory = "aztec" }

ONBOARDING.md

@@ -9,7 +9,7 @@ This guide takes you from "reading code in a browser" to "deploying on devnet" 
 * **Phases 1-2** need only a browser (read code, compile in a Codespace)
 * **Phases 3-6** need local tools (deploy, interact, extend, advanced topics)
 
-**Aztec version pinned in this repo:** `4.1.0-rc.2` (check `Nargo.toml` and `package.json` for source of truth)
+**Aztec version pinned in this repo:** `4.1.0` (check `Nargo.toml` and `package.json` for source of truth)
 
 **Links:**
 
@@ -164,7 +164,7 @@ fn create_game(game_id: Field) {
     // Ensure this game_id hasn't been used yet (player1 must be zero address)
     assert(self.storage.races.at(game_id).read().player1.eq(AztecAddress::zero()));
 
-    let player1 = self.msg_sender();
+    let player1 = self.context.maybe_msg_sender().unwrap();
     debug_log_format(
         "Creating game {0} by player {1}",
         [game_id, player1.to_field()],
@@ -193,7 +193,7 @@ Creates a new game. Checks the game ID isn't taken (player1 must be zero address
 fn join_game(game_id: Field) {
     let maybe_existing_game = self.storage.races.at(game_id).read();
 
-    let player2 = self.msg_sender();
+    let player2 = self.context.maybe_msg_sender().unwrap();
     debug_log_format("Player {0} joining game {1}", [player2.to_field(), game_id]);
 
     // Add the caller as player2 (validates that player1 exists and player2 is empty)
@@ -314,7 +314,7 @@ fn play_round(
     // Validate that total points don't exceed 9 (you can't max out all tracks)
     assert(track1 + track2 + track3 + track4 + track5 < 10);
 
-    let player = self.msg_sender();
+    let player = self.context.maybe_msg_sender().unwrap();
     debug_log_format(
         "Player {0} playing round {1} in game {2}",
         [player.to_field(), round as Field, game_id],
@@ -336,11 +336,11 @@ fn play_round(
 
     // Enqueue a public function call to update the round counter
     // This reveals that a round was played, but not the point allocation
-    self.enqueue_self.validate_and_play_round(
+    self.enqueue(PodRacing::at(self.context.this_address()).validate_and_play_round(
         player,
         game_id,
         round,
-    );
+    ));
 }
 ```
 
@@ -361,7 +361,7 @@ Three things happen here that have no direct Ethereum equivalent:
 // This is the "reveal" phase where private choices become public
 #[external("private")]
 fn finish_game(game_id: Field) {
-    let player = self.msg_sender();
+    let player = self.context.maybe_msg_sender().unwrap();
     debug_log_format(
         "Player {0} finishing game {1}",
         [player.to_field(), game_id],
@@ -394,15 +394,15 @@ fn finish_game(game_id: Field) {
 
     // Enqueue public function to store the revealed totals on-chain
     // Now the revealing player's track totals will be publicly visible
-    self.enqueue_self.validate_finish_game_and_reveal(
+    self.enqueue(PodRacing::at(self.context.this_address()).validate_finish_game_and_reveal(
         player,
         game_id,
         total_track1,
         total_track2,
         total_track3,
         total_track4,
         total_track5,
-    );
+    ));
 }
 ```
 
@@ -526,7 +526,7 @@ The `.devcontainer/` configures:
 
 * **Base image:** Ubuntu 24.04 with Node.js v22.15.0
 * **Docker-in-Docker** for running the Aztec local network
-* **Aztec CLI** installed via `curl -fsSL "https://install.aztec.network/4.1.0-rc.2" | VERSION="4.1.0-rc.2" bash -s`
+* **Aztec CLI** installed via `curl -fsSL "https://install.aztec.network/4.1.0" | VERSION="4.1.0" bash -s`
 * **VS Code extension:** `noir-lang.vscode-noir` for Noir syntax highlighting
 * **Dependencies:** `yarn install` runs automatically
 
@@ -737,7 +737,7 @@ pub unconstrained fn setup() -> (TestEnvironment, AztecAddress, AztecAddress) {
 **Aztec toolkit:**
 
 ```bash
-export VERSION=4.1.0-rc.2
+export VERSION=4.1.0
 curl -fsSL "https://install.aztec.network/${VERSION}" | VERSION="${VERSION}" bash -s
 ```
 

README.md

@@ -50,7 +50,7 @@ Use **Node.js version 22.15.0**.
 Install the **Aztec toolkit** (local network, CLI, and other tooling) at the correct version:
 
 ```bash
-export VERSION=4.1.0-rc.2
+export VERSION=4.1.0
 curl -fsSL "https://install.aztec.network/${VERSION}" | VERSION="${VERSION}" bash -s
 ```
 

config/local-network.json

@@ -8,7 +8,7 @@
   },
   "settings": {
     "skipLocalNetwork": false,
-    "version": "4.1.0-rc.2"
+    "version": "4.1.0"
   },
   "timeouts": {
     "deployTimeout": 120000,

config/testnet.json

@@ -8,7 +8,7 @@
   },
   "settings": {
     "skipLocalNetwork": true,
-    "version": "4.1.0-rc.2"
+    "version": "4.1.0"
   },
   "timeouts": {
     "deployTimeout": 1200000,

docs/ONBOARDING.src.md

@@ -9,7 +9,7 @@ This guide takes you from "reading code in a browser" to "deploying on devnet" 
 - **Phases 1-2** need only a browser (read code, compile in a Codespace)
 - **Phases 3-6** need local tools (deploy, interact, extend, advanced topics)
 
-**Aztec version pinned in this repo:** `4.1.0-rc.2` (check `Nargo.toml` and `package.json` for source of truth)
+**Aztec version pinned in this repo:** `4.1.0` (check `Nargo.toml` and `package.json` for source of truth)
 
 **Links:**
 
@@ -262,7 +262,7 @@ The `.devcontainer/` configures:
 
 - **Base image:** Ubuntu 24.04 with Node.js v22.15.0
 - **Docker-in-Docker** for running the Aztec local network
-- **Aztec CLI** installed via `curl -fsSL "https://install.aztec.network/4.1.0-rc.2" | VERSION="4.1.0-rc.2" bash -s`
+- **Aztec CLI** installed via `curl -fsSL "https://install.aztec.network/4.1.0" | VERSION="4.1.0" bash -s`
 - **VS Code extension:** `noir-lang.vscode-noir` for Noir syntax highlighting
 - **Dependencies:** `yarn install` runs automatically
 
@@ -357,7 +357,7 @@ And higher-level helpers:
 **Aztec toolkit:**
 
 ```bash
-export VERSION=4.1.0-rc.2
+export VERSION=4.1.0
 curl -fsSL "https://install.aztec.network/${VERSION}" | VERSION="${VERSION}" bash -s
 ```
 

jest.integration.config.json

@@ -1,7 +1,7 @@
 {
   "preset": "ts-jest/presets/default-esm",
   "transform": {
-    "^.+\\.tsx?$": ["ts-jest", { "useESM": true }]
+    "^.+\\.tsx?$": ["ts-jest", { "useESM": true, "diagnostics": false }]
   },
   "moduleNameMapper": {
     "^(\\.{1,2}/.*)\\.js$": "$1"

package.json

@@ -45,16 +45,16 @@
     "update-readme-version": "node ./.github/scripts/update-readme-version.js"
   },
   "dependencies": {
-    "@aztec/accounts": "4.1.0-rc.2",
-    "@aztec/aztec.js": "4.1.0-rc.2",
-    "@aztec/constants": "4.1.0-rc.2",
-    "@aztec/entrypoints": "4.1.0-rc.2",
-    "@aztec/noir-contracts.js": "4.1.0-rc.2",
-    "@aztec/protocol-contracts": "4.1.0-rc.2",
-    "@aztec/pxe": "4.1.0-rc.2",
-    "@aztec/stdlib": "4.1.0-rc.2",
-    "@aztec/wallet-sdk": "4.1.0-rc.2",
-    "@aztec/wallets": "4.1.0-rc.2",
+    "@aztec/accounts": "4.1.0",
+    "@aztec/aztec.js": "4.1.0",
+    "@aztec/constants": "4.1.0",
+    "@aztec/entrypoints": "4.1.0",
+    "@aztec/noir-contracts.js": "4.1.0",
+    "@aztec/protocol-contracts": "4.1.0",
+    "@aztec/pxe": "4.1.0",
+    "@aztec/stdlib": "4.1.0",
+    "@aztec/wallet-sdk": "4.1.0",
+    "@aztec/wallets": "4.1.0",
     "dotenv": "^17.2.2"
   },
   "devDependencies": {