feat: stamping aztec version into contract artifacts by benesjan · Pull Request #22550 · AztecProtocol/aztec-packages

benesjan · 2026-04-15T06:47:02Z

Injects aztec stack version into Noir contract artifacts as it's a very useful info for debugging and other purposes (like verifying our backwards compatibility infra works).

Closes F-549

benesjan · 2026-04-15T06:47:53Z

This stack of pull requests is managed by Graphite. Learn more about stacking.

benesjan · 2026-04-15T08:33:32Z

+ *
 * Does not include public bytecode, apart from the public_dispatch function.
- * @param compiled - Noir build output.
- * @returns Aztec contract build artifact.


Updated the docs here as they were misleading - on the input is not nargo output but the postr-processed nargo output (transpiled, aztec prefixes stripped from fn names etc.)

…22590) When working on [another PR](#22550) of mine I realized that we are having a problem and that is that we have 2 paths by which contracts get compiled: 1. one is via aztec-packages bootstrap, 2. another is via `aztec compile` This started to become problematic as our contract compilation pipeline was getting more complicated: 1. nargo compile, 2. transpile, 3. strip prefixes, 4. and with that PR also inject aztec version This meant that the duplication started to have real cost. In this PR I clean this up a bit by moving the prefix stripping into the `bb aztec_process` command. This results that the compilation pipeline is simply: 1. `nargo compile`, 2. `bb aztec_process` Given that it's just 2 commands it is fine to have it be duplicated between `bootstrap.sh` and `aztec compile`. Once this is merged I will try to refactor #22550 such that the version is also injected only in `bb aztec_process`. ## AI Summary - Moved `__aztec_nr_internals__` prefix stripping into `bb aztec_process` (C++), which already handles transpilation and VK generation - Simplified the bootstrap `compile` function to just call `nargo compile` + `bb aztec_process`, removing ~50 lines of manual VK generation shell code - Removed the separate `stripInternalPrefixes()` TypeScript function from the CLI path - Deleted the now-unused `strip_aztec_nr_prefix.sh` script - Updated protocol-fuzzer scripts and docs to reflect the unified pipeline Both compilation paths (bootstrap and `aztec compile`) now go through `bb aztec_process` for all post-nargo processing, eliminating the duplication. Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

benesjan · 2026-05-05T14:39:02Z

 export -f get_contract_path

+# Stamps the aztec version into a contract artifact JSON in place. Mirrors stampAztecVersion in
+# yarn-project/aztec/src/cli/cmds/compile.ts so monorepo-built artifacts match those produced by `aztec compile`.


It's unfortunate that this is a duplicate of the typescript functionality but merging the 2 possible contract compilation paths (bootstrap.sh in monorepo and aztec compile) is not practical.

mverzilli

🚀

Injects aztec stack version into Noir contract artifacts as it's a very useful info for debugging and other purposes (like verifying our backwards compatibility infra works). Closes [F-549](https://linear.app/aztec-labs/issue/F-549/include-aztecnr-and-stack-versions-in-contract-artifact) --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

AztecBot · 2026-05-05T16:45:09Z

✅ Successfully backported to backport-to-v4-next-staging #22959.

## Summary Fixes the merge-train/fairies CI failure introduced by #22550 (`feat: stamping aztec version into contract artifacts`). That PR added `aztecVersion` as a required field on `ContractArtifact` but missed updating the hand-rolled fixture in `pxe/src/storage/backwards_compatibility_tests/schema_tests.ts`, breaking the `yarn tsgo -b --emitDeclarationOnly` step: ``` pxe/src/storage/backwards_compatibility_tests/schema_tests.ts(658,3): error TS2741: Property 'aztecVersion' is missing in type '{...}' but required in type 'ContractArtifact'. ``` ## Fix - Add `aztecVersion: 'schema-fixture-version'` to `buildSchemaContractArtifact()` so the literal satisfies `ContractArtifact`. Uses a deterministic test-only string (rather than `DEV_VERSION`) to keep the snapshot stable across release version bumps. - Update `__snapshots__/ContractStore.json` to include the new field in the serialized hex bytes (insertion is between `name` and `functions`, matching declaration order in `ContractArtifactSchema`). ## Schema-version impact `ARTIFACT_VERSION_BEFORE_INJECTION` is the schema's default for missing `aztecVersion`, so this is **read-defaultable**, not breaking — `PXE_DATA_SCHEMA_VERSION` does not need bumping. CI log: http://ci.aztec-labs.com/1777999383723761 ClaudeBox log: https://claudebox.work/s/0e57df71aab3db0e?run=1

BEGIN_COMMIT_OVERRIDE feat: stamping aztec version into contract artifacts (#22550) feat(pxe): deduplicate class ID verification per contract (#22966) END_COMMIT_OVERRIDE

BEGIN_COMMIT_OVERRIDE refactor: `getPackageVersion` fn cleanup (AztecProtocol#22941) fix(ci): skip acceptance test for canary -commit. tags (AztecProtocol#22951) fix: closing db, correct stub side effects (AztecProtocol#22939) feat: wallet-sdk heartbeat (AztecProtocol#22948) chore: pxe db schema compatibility test (AztecProtocol#22872) feat: stamping aztec version into contract artifacts (AztecProtocol#22550) fix: add aztecVersion to PXE schema_tests fixture (AztecProtocol#22960) feat(pxe): deduplicate class ID verification per contract (AztecProtocol#22966) chore: add noirfmt.toml to noir-contracts and run nargo fmt (AztecProtocol#22971) feat(aztec-nr): Initial handshake registry contract with non interactive handshake function (AztecProtocol#22854) chore: merge next into merge-train/fairies (AztecProtocol#22991) fix(aztec-up): Aztec installer does not shadow user installed binaries on PATH (AztecProtocol#22902) test(ci): drop e2e_kernelless_simulation from backwards-compat e2e (AztecProtocol#23005) feat(ci): notify #team-fairies when backwards-compat e2e fails on nightly (AztecProtocol#23006) chore: merge next into merge-train/fairies (AztecProtocol#23021) fix: better DeployMethod (AztecProtocol#22985) refactor(pxe): batch RPC calls for note and event validation (AztecProtocol#22988) END_COMMIT_OVERRIDE

benesjan force-pushed the jan/f-549-include-aztecnr-and-stack-versions-in-contract-artifact branch from 5d6c31a to b03cf2f Compare April 15, 2026 06:47

benesjan added ci-draft Run CI on draft PRs. and removed ci-draft Run CI on draft PRs. labels Apr 15, 2026

benesjan commented Apr 15, 2026

View reviewed changes

Comment thread noir-projects/noir-contracts/bootstrap.sh Outdated

benesjan commented Apr 15, 2026

View reviewed changes

Comment thread ci3/source_refname Outdated

benesjan force-pushed the jan/f-549-include-aztecnr-and-stack-versions-in-contract-artifact branch from 30b81d7 to c050f2c Compare April 15, 2026 08:41

benesjan marked this pull request as ready for review April 15, 2026 08:41

benesjan requested a review from charlielye as a code owner April 15, 2026 08:41

benesjan requested review from ludamad and mverzilli and removed request for charlielye April 15, 2026 09:10

benesjan force-pushed the jan/f-549-include-aztecnr-and-stack-versions-in-contract-artifact branch from c050f2c to af53a43 Compare April 15, 2026 13:17

benesjan removed request for ludamad and mverzilli April 15, 2026 14:20

benesjan added claudebox Owned by claudebox. it can push to this PR. and removed claudebox Owned by claudebox. it can push to this PR. labels Apr 15, 2026

benesjan marked this pull request as draft April 16, 2026 01:28

benesjan force-pushed the jan/f-549-include-aztecnr-and-stack-versions-in-contract-artifact branch from af53a43 to 0647f10 Compare April 16, 2026 01:29

benesjan marked this pull request as ready for review April 16, 2026 01:51

benesjan changed the base branch from merge-train/fairies to graphite-base/22550 April 16, 2026 02:52

benesjan force-pushed the jan/f-549-include-aztecnr-and-stack-versions-in-contract-artifact branch from b413d74 to 4881317 Compare April 16, 2026 02:52

benesjan changed the base branch from graphite-base/22550 to jan/fix-verdaccio-install April 16, 2026 02:52

benesjan mentioned this pull request Apr 16, 2026

fix: install verdaccio to local prefix to avoid EACCES #22588

Merged

benesjan marked this pull request as draft April 16, 2026 03:17

benesjan mentioned this pull request Apr 16, 2026

refactor: unify contract compilation pipeline via bb aztec_process #22590

Merged

Base automatically changed from jan/fix-verdaccio-install to next April 16, 2026 05:30

benesjan changed the base branch from next to graphite-base/22550 April 17, 2026 14:01

benesjan added 9 commits May 5, 2026 14:36

cleanup

c05a1e6

fix

480d528

wip

ccac028

cleanup

f80a278

cleanup

a7c036b

wip

a594498

cleanup after rebase

4ede494

cuter naming

d5bafa4

fix

3d9e599

benesjan force-pushed the jan/f-549-include-aztecnr-and-stack-versions-in-contract-artifact branch from 38fe387 to 3d9e599 Compare May 5, 2026 14:37

benesjan commented May 5, 2026

View reviewed changes

benesjan marked this pull request as ready for review May 5, 2026 14:39

build fix

17a98c7

benesjan requested a review from mverzilli May 5, 2026 16:14

mverzilli approved these changes May 5, 2026

View reviewed changes

benesjan added the backport-to-v4-next label May 5, 2026

benesjan enabled auto-merge (squash) May 5, 2026 16:42

benesjan merged commit 7073efe into merge-train/fairies May 5, 2026
29 checks passed

benesjan deleted the jan/f-549-include-aztecnr-and-stack-versions-in-contract-artifact branch May 5, 2026 16:42

AztecBot mentioned this pull request May 5, 2026

feat: merge-train/fairies #22952

Merged

AztecBot mentioned this pull request May 5, 2026

chore: Accumulated backports to v4-next #22959

Merged

AztecBot mentioned this pull request May 5, 2026

fix: add aztecVersion to PXE schema_tests fixture #22960

Merged

AztecBot mentioned this pull request May 5, 2026

chore: backport add aztecVersion to PXE schema_tests fixture (#22960) to v4-next #22962

Closed

AztecBot mentioned this pull request May 11, 2026

chore(v4): release 4.3.1 #20979

Closed

AztecBot mentioned this pull request May 22, 2026

fix: preserve contract artifact permissions (#23174) #23509

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: stamping aztec version into contract artifacts#22550

feat: stamping aztec version into contract artifacts#22550
benesjan merged 14 commits into
merge-train/fairiesfrom
jan/f-549-include-aztecnr-and-stack-versions-in-contract-artifact

benesjan commented Apr 15, 2026 •

edited

Loading

Uh oh!

benesjan commented Apr 15, 2026 •

edited

Loading

Uh oh!

benesjan Apr 15, 2026

Uh oh!

Uh oh!

Uh oh!

benesjan May 5, 2026

Uh oh!

mverzilli left a comment

Uh oh!

Uh oh!

AztecBot commented May 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

benesjan commented Apr 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

benesjan commented Apr 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

benesjan Apr 15, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

benesjan May 5, 2026

Choose a reason for hiding this comment

Uh oh!

mverzilli left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

AztecBot commented May 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

benesjan commented Apr 15, 2026 •

edited

Loading

benesjan commented Apr 15, 2026 •

edited

Loading