You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CLAUDE.md
+9-11Lines changed: 9 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
6
6
7
7
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.
8
8
9
-
**Aztec version: `4.0.0-devnet.2-patch.1`** — pinned across `Nargo.toml`, `package.json`, `config/*.json`, and README. All must stay in sync when updating.
9
+
**Aztec version: `4.2.0-aztecnr-rc.2`** — pinned across `Nargo.toml`, `package.json`, `config/*.json`, and README. All must stay in sync when updating.
@@ -113,7 +111,7 @@ Devnet PRs target `next`. Testnet PRs target `testnet`. Each branch pins its own
113
111
-**ESM project**: `"type": "module"` in package.json. All TS scripts run via `node --loader ts-node/esm`.
114
112
-**Private-public interaction**: `play_round` is private (creates `GameRoundNote` notes), then enqueues a public call (`validate_and_play_round`) to update round counters. `finish_game` reads private notes, sums them, and enqueues a public call to reveal totals.
115
113
-**Fee payment**: All transactions use `SponsoredFeePaymentMethod` via the SponsoredFPC contract.
116
-
-**Wallet setup**: `EmbeddedWallet.create()` with `ephemeral: true` for tests; prover is enabled only on devnet.
114
+
-**Wallet setup**: `EmbeddedWallet.create()` with `ephemeral: true` for tests.
117
115
-**PXE store**: Data persists in `./store`. Must delete after local network restart to avoid stale state errors.
118
116
119
117
## Simulate Before Send (IMPORTANT)
@@ -152,7 +150,7 @@ When updating the Aztec version, update all of these locations:
152
150
153
151
1.`Nargo.toml` — `aztec` dependency tag
154
152
2.`package.json` — all `@aztec/*` dependency versions
155
-
3.`config/local-network.json`, `config/devnet.json`, and/or `config/testnet.json` — `settings.version` (update the configs relevant to the branch you're on)
153
+
3.`config/local-network.json` and/or `config/testnet.json` — `settings.version` (update the configs relevant to the branch you're on)
156
154
4.`README.md` — install command version
157
155
158
156
> **Note:** The `next` and `testnet` branches may pin different Aztec versions. Only update the config files relevant to the branch.
Copy file name to clipboardExpand all lines: ONBOARDING.md
+24-58Lines changed: 24 additions & 58 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# Onboarding: From Ethereum to Aztec
2
2
3
-
This guide takes you from "reading code in a browser" to "deploying on devnet" — progressively, with no install required until Phase 3.
3
+
This guide takes you from "reading code in a browser" to "deploying contracts" — progressively, with no install required until Phase 3.
4
4
5
5
**What you'll learn:** How Aztec contracts work by studying a Pod Racing game — a two-player competitive game that uses private state to implement commit-reveal in a single transaction.
6
6
@@ -9,7 +9,7 @@ This guide takes you from "reading code in a browser" to "deploying on devnet"
9
9
***Phases 1-2** need only a browser (read code, compile in a Codespace)
10
10
***Phases 3-6** need local tools (deploy, interact, extend, advanced topics)
11
11
12
-
**Aztec version pinned in this repo:**`4.0.0-devnet.2-patch.1` (check `Nargo.toml` and `package.json` for source of truth)
12
+
**Aztec version pinned in this repo:**`4.2.0-aztecnr-rc.2` (check `Nargo.toml` and `package.json` for source of truth)
> **Important:** Always call `.simulate()` before `.send()`. Simulation runs the transaction locally and surfaces revert reasons immediately. Without it, a failing transaction hangs until timeout with an opaque error.
893
876
@@ -1017,7 +1000,7 @@ yarn test:js
1017
1000
1018
1001
## Phase 6: Advanced Topics
1019
1002
1020
-
**Goal:** Explore multi-wallet patterns, fee strategies, devnet, and profiling.
1003
+
**Goal:** Explore multi-wallet patterns, fee strategies, and profiling.
It then deploys a Token contract from wallet1, creates an account on wallet2, mints tokens to wallet2's account, registers the token contract on wallet2, and reads balances.
1038
1021
@@ -1058,20 +1041,7 @@ yarn multiple-wallet
1058
1041
yarn fees
1059
1042
```
1060
1043
1061
-
### 6.3 — Deploying to Devnet
1062
-
1063
-
All scripts support a `::devnet` suffix:
1064
-
1065
-
```bash
1066
-
yarn deploy::devnet
1067
-
yarn deploy-account::devnet
1068
-
yarn interaction-existing-contract::devnet
1069
-
yarn test::devnet
1070
-
```
1071
-
1072
-
Devnet uses real provers and connects to the Aztec devnet at `https://next.devnet.aztec-labs.com` with Sepolia as the L1. Timeouts are longer (deploy: 20 min, tx: 3 min) to account for real proving time.
1073
-
1074
-
### 6.4 — Transaction Profiling
1044
+
### 6.3 — Transaction Profiling
1075
1045
1076
1046
**`scripts/profile_deploy.ts`** shows how to profile a transaction:
1077
1047
@@ -1088,7 +1058,7 @@ The `.profile()` method runs the transaction through the prover and returns deta
1088
1058
yarn profile
1089
1059
```
1090
1060
1091
-
### 6.5 — Querying Blocks
1061
+
### 6.4 — Querying Blocks
1092
1062
1093
1063
**`scripts/get_block.ts`** shows how to query the Aztec node directly:
1094
1064
@@ -1137,7 +1107,6 @@ yarn get-block
1137
1107
|`scripts/get_block.ts`| Block querying |
1138
1108
|`config/config.ts`| Config manager (loads JSON by env) |
1139
1109
|`config/local-network.json`| Local network configuration |
0 commit comments