Skip to content

fix(aztec-up): strip leading v prefix from version strings#21813

Merged
nchamo merged 2 commits intomerge-train/fairiesfrom
fix/aztec-up-strip-v-prefix
Mar 23, 2026
Merged

fix(aztec-up): strip leading v prefix from version strings#21813
nchamo merged 2 commits intomerge-train/fairiesfrom
fix/aztec-up-strip-v-prefix

Conversation

@nchamo
Copy link
Copy Markdown
Contributor

@nchamo nchamo commented Mar 19, 2026

Problem

When a user runs aztec-up install v4.1.0-nightly.20260313 (note the v prefix), the version string fails the semver regex check because the pattern expects the string to start with a digit (^[0-9]+\.…). The code then falls through to alias resolution, which tries to fetch https://install.aztec-labs.com/aliases/v4.1.0-nightly.20260313. That endpoint doesn't exist, so the user gets a confusing error:

Error: Could not resolve alias 'v4.1.0-nightly.20260313'

This is a common UX pitfall -- many version managers and tools (git tags, GitHub releases, docker images) use a v prefix on versions, so users naturally copy-paste or type versions with the prefix.

Fix

Strip a leading v from the version argument at the top of resolve_version using bash parameter expansion (${1#v}). This is a no-op when no v prefix is present, so existing usage is unaffected.

The fix is applied in both places where resolve_version is defined:

  • aztec-up/bin/0.0.1/aztec-up: the version manager CLI
  • aztec-up/bin/0.0.1/aztec-install: the bootstrap script (run via curl | bash)

Fixes F-440

@nchamo nchamo requested a review from charlielye as a code owner March 19, 2026 20:48
@nchamo nchamo self-assigned this Mar 19, 2026
@nchamo nchamo requested a review from nventuro March 19, 2026 21:07
Comment thread aztec-up/bin/0.0.1/aztec-up Outdated
@nchamo nchamo requested review from mverzilli and nventuro March 20, 2026 15:33
Copy link
Copy Markdown
Contributor

@mverzilli mverzilli left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. Probably out of scope for this PR, but the uninstall command doesn't use resolve_version so there's a behavior asymmetry

@nchamo
Copy link
Copy Markdown
Contributor Author

nchamo commented Mar 23, 2026

Looks good. Probably out of scope for this PR, but the uninstall command doesn't use resolve_version so there's a behavior asymmetry

That's actually intended, since versions can be installed with aliases, but they are resolved and installed with actual versions. I did create a issue to fix something for the uninstall though: #21892

@nchamo nchamo dismissed nventuro’s stale review March 23, 2026 17:57

Bug was fixed as requested, and we have another approval already

@nchamo nchamo merged commit 32a5796 into merge-train/fairies Mar 23, 2026
23 checks passed
@nchamo nchamo deleted the fix/aztec-up-strip-v-prefix branch March 23, 2026 17:57
@AztecBot
Copy link
Copy Markdown
Collaborator

❌ Failed to cherry-pick to v4-next due to conflicts. (🤖) View backport run.

AztecBot pushed a commit that referenced this pull request Mar 23, 2026
…gs (#21813)

Cherry-pick of merge commit 32a5796 with conflicts in aztec-up/bin/0.0.1/aztec-install.
AztecBot pushed a commit that referenced this pull request Mar 23, 2026
…gs (#21813)

Cherry-pick of merge commit 32a5796 (PR #21813) with conflicts in aztec-up/bin/0.0.1/aztec-install.
nchamo pushed a commit that referenced this pull request Mar 23, 2026
AztecBot added a commit that referenced this pull request Mar 24, 2026
github-merge-queue Bot pushed a commit that referenced this pull request Mar 24, 2026
BEGIN_COMMIT_OVERRIDE
fix: explicitly handle initial block case for
getBlockHashMembershipWitness (#21836)
fix(aztec-up): narrow PATH cleanup regex to avoid removing user PATH
entries (#21828)
fix: use anchor block on getL1ToL2MsgWitness (#21872)
fix: make sure queries are not made ahead of the anchor block (#21874)
fix(aztec-up): strip leading `v` prefix from version strings (#21813)
END_COMMIT_OVERRIDE
Thunkar pushed a commit that referenced this pull request Mar 24, 2026
AztecBot added a commit that referenced this pull request Mar 25, 2026
BEGIN_COMMIT_OVERRIDE
fix(aztec-up): narrow PATH cleanup regex to avoid removing user PATH
entries (#21828)
fix: consolidate blob source test into single summary log with supernode
detection (#21719)
fix: use anchor block on getL1ToL2MsgWitness (#21872)
fix: make sure queries are not made ahead of the anchor block (#21874)
chore(docs): backport docs infrastructure changes to v4 (#21437)
chore: backport PR #21836 (fix: explicitly handle initial block case for
getBlockHashMembershipWitness) to v4-next (#21891)
chore: backport PR #21813 (fix(aztec-up): strip leading v prefix from
version strings) to v4-next (#21912)
docs: document defi-wonderland immutable macro (#21764)
fix: pin typescript and harden lockfile check in docs examples CI (v4
backport) (#21914)
docs: expand circuit profiling guide and document kernel gate cost
overhead (#21770)
feat: cli-wallet (#21757)
chore: sync backport staging with v4-next HEAD (#21931)
fix: bot gas estimations (backport #21945) (#21947)
refactor(aztec-nr): use logging wrappers in
compute_note_hash_and_nullifier (#21897)
fix: backport v4 next staging (#21934)
fix: make PXE#getSyncedBlockHeader a concurrency=1 job to prevent IDB tx
liveness issues (#21944)
feat: add error page mapping for incompatible oracles (#21943)
fix(aztec-up): validate semver in uninstall to prevent path traversal
(#21892)
chore: merge v4-next into backport staging (fix ancestry) (#21954)
fix(aztec-up): add truncation protection to install scripts (#21896)
fix: noir format in compute_note_hash_and_nullifier.nr (#21956)
fix(stdlib): decode `EthAddress`, `FunctionSelector` and wrapped field
structs in `AbiDecoder` (#21926)
chore: update noir to nightly-2026-02-12-patch.1 (#21960)
fix: ensure empty docs examples does not populate yarn lock backport
(#21963)
fix: docs examples does not build on simple bootstrap backport (#21964)
fix: add rc/testnet version detection to API reference pages (#21966)
docs: document EmbeddedWallet automatic gas estimation and private
authwits (#21790)
fix(pxe): robust error handling in message processing (backport #21093)
(#21981)
chore: manually recreate backport (#21969)
chore: (A-779) load all accounts before calling
LogService.#getSecretsForSenders (#21923)
END_COMMIT_OVERRIDE
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants