Skip to content

docs: expand circuit profiling guide and document kernel gate cost overhead#21770

Merged
AztecBot merged 1 commit into
nextfrom
josh/ecodr-841-docs-update-circuit-profiling-and-gate-count-guidelines
Mar 23, 2026
Merged

docs: expand circuit profiling guide and document kernel gate cost overhead#21770
AztecBot merged 1 commit into
nextfrom
josh/ecodr-841-docs-update-circuit-profiling-and-gate-count-guidelines

Conversation

@critesjosh

@critesjosh critesjosh commented Mar 18, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Moves kernel overhead explanation (gate counts per phase, design tips, large-circuit reassurance) from the profiling how-to guide into foundational-topics/advanced/circuits/private_kernel.md where it belongs conceptually
  • Slims the profiling guide to link there instead of duplicating content
  • Updates cross-references in writing_efficient_contracts.md and transactions.md
  • Clarifies that a typical single-function transaction involves two private calls (account entrypoint + user function), so private_kernel_inner is correctly included in the cost breakdown

Test plan

  • Verify links resolve correctly in local dev server (yarn start from docs/)
  • Confirm private_kernel.md#performance-impact anchor works from all linking pages

🤖 Generated with Claude Code

@critesjosh

critesjosh commented Mar 18, 2026

Copy link
Copy Markdown
Contributor Author

Merge after #21437

@critesjosh critesjosh changed the title docs: move kernel overhead content to foundational-topics docs: expand circuit profiling guide and document kernel gate cost overhead Mar 20, 2026
@critesjosh critesjosh marked this pull request as ready for review March 20, 2026 15:50
@critesjosh critesjosh requested review from a team and ciaranightingale March 20, 2026 15:50
@AztecBot AztecBot force-pushed the josh/ecodr-841-docs-update-circuit-profiling-and-gate-count-guidelines branch from c963470 to da3199c Compare March 23, 2026 19:31
@AztecBot AztecBot enabled auto-merge March 23, 2026 19:31
@critesjosh
docs: expand circuit profiling guide and document kernel gate cost ov…
b41bd04 
…erhead

## Summary

- Moves kernel overhead explanation (gate counts per phase, design tips, large-circuit reassurance) from the profiling how-to guide into `foundational-topics/advanced/circuits/private_kernel.md` where it belongs conceptually
- Slims the profiling guide to link there instead of duplicating content
- Updates cross-references in `writing_efficient_contracts.md` and `transactions.md`
- Clarifies that a typical single-function transaction involves two private calls (account entrypoint + user function), so `private_kernel_inner` is correctly included in the cost breakdown

## Test plan

- [ ] Verify links resolve correctly in local dev server (`yarn start` from docs/)
- [ ] Confirm `private_kernel.md#performance-impact` anchor works from all linking pages

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@AztecBot AztecBot force-pushed the josh/ecodr-841-docs-update-circuit-profiling-and-gate-count-guidelines branch from da3199c to b41bd04 Compare March 23, 2026 19:33
@AztecBot AztecBot added this pull request to the merge queue Mar 23, 2026
Merged via the queue into next with commit e4ca309 Mar 23, 2026
18 checks passed
@AztecBot AztecBot deleted the josh/ecodr-841-docs-update-circuit-profiling-and-gate-count-guidelines branch March 23, 2026 20:06
AztecBot added a commit that referenced this pull request Mar 23, 2026
@AztecBot
docs: expand circuit profiling guide and document kernel gate cost ov…
daee646 
…erhead (#21770)

## Summary

- Moves kernel overhead explanation (gate counts per phase, design tips,
large-circuit reassurance) from the profiling how-to guide into
`foundational-topics/advanced/circuits/private_kernel.md` where it
belongs conceptually
- Slims the profiling guide to link there instead of duplicating content
- Updates cross-references in `writing_efficient_contracts.md` and
`transactions.md`
- Clarifies that a typical single-function transaction involves two
private calls (account entrypoint + user function), so
`private_kernel_inner` is correctly included in the cost breakdown

## Test plan

- [ ] Verify links resolve correctly in local dev server (`yarn start`
from docs/)
- [ ] Confirm `private_kernel.md#performance-impact` anchor works from
all linking pages

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@AztecBot AztecBot mentioned this pull request Mar 23, 2026
Merged
@AztecBot

AztecBot commented Mar 23, 2026

Copy link
Copy Markdown
Collaborator

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

AztecBot added a commit that referenced this pull request Mar 24, 2026
@AztecBot
docs: expand circuit profiling guide and document kernel gate cost ov…
ae19e7c 
…erhead (#21770)

## Summary

- Moves kernel overhead explanation (gate counts per phase, design tips,
large-circuit reassurance) from the profiling how-to guide into
`foundational-topics/advanced/circuits/private_kernel.md` where it
belongs conceptually
- Slims the profiling guide to link there instead of duplicating content
- Updates cross-references in `writing_efficient_contracts.md` and
`transactions.md`
- Clarifies that a typical single-function transaction involves two
private calls (account entrypoint + user function), so
`private_kernel_inner` is correctly included in the cost breakdown

## Test plan

- [ ] Verify links resolve correctly in local dev server (`yarn start`
from docs/)
- [ ] Confirm `private_kernel.md#performance-impact` anchor works from
all linking pages

🤖 Generated with [Claude Code](https://claude.com/claude-code)
This was referenced Mar 24, 2026
Closed
Closed
Thunkar pushed a commit that referenced this pull request Mar 24, 2026
@AztecBot @Thunkar
docs: expand circuit profiling guide and document kernel gate cost ov…
6cee116 
…erhead (#21770)

## Summary

- Moves kernel overhead explanation (gate counts per phase, design tips,
large-circuit reassurance) from the profiling how-to guide into
`foundational-topics/advanced/circuits/private_kernel.md` where it
belongs conceptually
- Slims the profiling guide to link there instead of duplicating content
- Updates cross-references in `writing_efficient_contracts.md` and
`transactions.md`
- Clarifies that a typical single-function transaction involves two
private calls (account entrypoint + user function), so
`private_kernel_inner` is correctly included in the cost breakdown

## Test plan

- [ ] Verify links resolve correctly in local dev server (`yarn start`
from docs/)
- [ ] Confirm `private_kernel.md#performance-impact` anchor works from
all linking pages

🤖 Generated with [Claude Code](https://claude.com/claude-code)
AztecBot added a commit that referenced this pull request Mar 25, 2026
@AztecBot
chore: Accumulated backports to v4-next (#21899)
f4ccd73 
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

Reviewers

@ciaranightingale ciaranightingale Awaiting requested review from ciaranightingale

1 more reviewer

@sklppy88 sklppy88 sklppy88 approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

backport-to-v4-next

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@critesjosh @AztecBot @sklppy88