docs: fix issues with Creating Accounts page (backport #22673)#22697
Merged
critesjosh merged 2 commits intoApr 21, 2026
Merged
Conversation
Cherry-pick of 1c4aa0c from PR #22673. Conflict markers preserved AS-IS in this commit; resolved in follow-up. Original PR description: ## Summary Three issues on `/developers/docs/aztec-js/how_to_create_account` that block users following the guide end-to-end. **1. Install command missing `@aztec/noir-contracts.js`.** The Sponsored FPC snippet imports `@aztec/noir-contracts.js/SponsoredFPC`, but the Install dependencies section only lists `@aztec/aztec.js` and `@aztec/wallets`. **2. Misleading info-note wording.** Reworded info note below the Sponsored FPC snippet. **3. Invisible `feeJuiceAccount` in Verify deployment.** Wrap the second account creation in a new `docs:start:create_fee_juice_account` block; switch `verify_account_deployment` to reference `newAccount`.
- Renamed v4.2.0 versioned docs path to v4.2.0-aztecnr-rc.2 (already done by automerge). - Install command: kept 4.2.0-aztecnr-rc.2 version suffix while adding the new @aztec/noir-contracts.js dependency from PR #22673. - Sponsored-FPC info note: kept the existing per-branch fragment anchors (#sponsored-fee-payment-contracts in the versioned doc, #sponsored-fpc-devnet-and-local-only in docs-developers) while adopting the PR's reworded sentence.
critesjosh
approved these changes
Apr 21, 2026
710da40
into
backport-to-v4-next-staging
23 of 26 checks passed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Backport of #22673 to
backport-to-v4-next-staging.The automatic patch-apply backport failed due to two conflicts. Resolved manually following the standard 3-commit backport pattern (without the build-fixes commit — this PR is docs-only and required no code adaptation).
Commits
docs: fix issues with Creating Accounts page (backport #22673)—git cherry-pickof upstream squash commit1c4aa0c. Committed with conflict markers in place so reviewers can see exactly what conflicted.fix: resolve cherry-pick conflicts— minimal edits to the conflicted hunks only.Conflicts and how they were resolved
Both conflicts boil down to v4-next-staging using different naming than
nextfor things the PR also touched, so a clean three-way merge wasn't possible.docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/docs/aztec-js/how_to_create_account.mdThe original PR edits live under
version-v4.2.0/...; on this branch the directory is renamed toversion-v4.2.0-aztecnr-rc.2/..., which forced both hunks into a path-rename conflict.4.2.0-aztecnr-rc.2version suffix used everywhere else in this file, while still adopting the PR's intended addition of@aztec/noir-contracts.js.#sponsored-fee-payment-contractsanchor since the target heading in this branch'show_to_pay_fees.mdis still### Sponsored Fee Payment Contracts. Switching to#sponsored-fpcwould have broken the link on this branch.docs/docs-developers/docs/aztec-js/how_to_create_account.md#sponsored-fpc-devnet-and-local-onlysince that branch'show_to_pay_fees.mdheading is### Sponsored FPC (devnet and local only).Verification
docs:start:create_fee_juice_account/docs:end:create_fee_juice_accountmarkers exist indocs/examples/ts/aztecjs_connection/index.ts, so the#include_codereference in the docs-developers file resolves.Original PR description below for context.
Summary
Three issues on
/developers/docs/aztec-js/how_to_create_accountthat block users following the guide end-to-end.1. Install command missing
@aztec/noir-contracts.js. The Sponsored FPC snippet imports@aztec/noir-contracts.js/SponsoredFPC, but the Install dependencies section only lists@aztec/aztec.jsand@aztec/wallets. Users hitCannot find module '@aztec/noir-contracts.js/SponsoredFPC'.2. Misleading info-note wording. Reworded the note below the Sponsored FPC snippet — "setting up" implied the user needed to deploy/configure the canonical contract.
3. Invisible
feeJuiceAccountin Verify deployment. The variable was created betweendocs:start/docs:endmarkers in the shared example file, so it never made it into the rendered page. Wrapped it in a newdocs:start:create_fee_juice_accountblock; switchedverify_account_deploymentto referencenewAccountwith an inline note for the Fee Juice path.ClaudeBox log: https://claudebox.work/s/ae934d6a0d27b8f5?run=1