Skip to content

feat(docs): private fpc guide#22497

Merged
AztecBot merged 1 commit into
nextfrom
ek/feat-private-fpc-guide
Apr 14, 2026
Merged

feat(docs): private fpc guide#22497
AztecBot merged 1 commit into
nextfrom
ek/feat-private-fpc-guide

Conversation

@sklppy88

@sklppy88 sklppy88 commented Apr 13, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a new guide (how_to_use_private_fee_juice.md) explaining how fully private fee payment works on Aztec, using DeFi Wonderland's community-built PrivateFPC as a concrete example
  • Updates the fee payment overview (how_to_pay_fees.md) with a Private FPC row in the comparison table and a section linking to the new guide
  • Adds a paragraph to the foundational fees concept page (foundational-topics/fees.md) introducing private FPCs
  • Adds a user-facing section to the participant fees page (docs-participate/basics/fees.md) explaining private fee payment and shared anonymity sets
  • Adds indistinguishability to the spellcheck dictionary

Test plan

  • Run yarn start in docs/ and verify the new page renders at /developers/aztec-js/how_to_use_private_fee_juice
  • Verify all internal links resolve (from how_to_pay_fees.md, fees.md concept page, and participant fees.md)
  • Verify external links to defi-wonderland/aztec-fee-payment repo are valid
  • Run yarn spellcheck and confirm no new errors

@sklppy88 sklppy88 requested a review from critesjosh April 13, 2026 09:43
@critesjosh critesjosh force-pushed the ek/feat-private-fpc-guide branch from 280cf90 to 1776960 Compare April 14, 2026 18:01
@critesjosh critesjosh removed their request for review April 14, 2026 18:01
@critesjosh critesjosh marked this pull request as ready for review April 14, 2026 18:24
## Summary

- Adds a new guide (`how_to_use_private_fee_juice.md`) explaining how fully private fee payment works on Aztec, using DeFi Wonderland's community-built `PrivateFPC` as a concrete example
- Updates the fee payment overview (`how_to_pay_fees.md`) with a Private FPC row in the comparison table and a section linking to the new guide
- Adds a paragraph to the foundational fees concept page (`foundational-topics/fees.md`) introducing private FPCs
- Adds a user-facing section to the participant fees page (`docs-participate/basics/fees.md`) explaining private fee payment and shared anonymity sets
- Adds `indistinguishability` to the spellcheck dictionary

## Test plan

- [ ] Run `yarn start` in `docs/` and verify the new page renders at `/developers/aztec-js/how_to_use_private_fee_juice`
- [ ] Verify all internal links resolve (from `how_to_pay_fees.md`, `fees.md` concept page, and participant `fees.md`)
- [ ] Verify external links to `defi-wonderland/aztec-fee-payment` repo are valid
- [ ] Run `yarn spellcheck` and confirm no new errors

Co-authored-by: Esau <esau@aztec-labs.com>
Co-authored-by: critesjosh <jc@joshcrites.com>
@AztecBot AztecBot force-pushed the ek/feat-private-fpc-guide branch from cb5e97c to f85b49d Compare April 14, 2026 18:33
@AztecBot AztecBot enabled auto-merge April 14, 2026 18:33
@AztecBot AztecBot added this pull request to the merge queue Apr 14, 2026
Merged via the queue into next with commit 201d7ba Apr 14, 2026
20 checks passed
@AztecBot AztecBot deleted the ek/feat-private-fpc-guide branch April 14, 2026 19:10
@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 Apr 14, 2026
Cherry-pick of f85b49d from PR #22497.
Conflicts in docs/docs-words.txt — markers preserved for reviewer visibility.
critesjosh added a commit that referenced this pull request Apr 14, 2026
## Summary

Backport of #22497
to v4-next.

Cherry-pick had a minor conflict in `docs/docs-words.txt` (the
`indistinguishability` word addition conflicted with unrelated changes
in the spelling dictionary). Resolved by accepting the incoming word.

### Changes
- Adds `how_to_use_private_fee_juice.md` guide explaining fully private
fee payment using DeFi Wonderland's PrivateFPC
- Updates fee payment overview with Private FPC row in comparison table
- Adds private FPC paragraphs to foundational fees concept page and
participant fees page
- Adds `indistinguishability` to spellcheck dictionary

### Commits
1. Cherry-pick with conflict markers preserved
2. Conflict resolution in docs-words.txt

ClaudeBox log: https://claudebox.work/s/422d20244c5c0f73?run=1
critesjosh added a commit that referenced this pull request Apr 14, 2026
Port changes from #22496 (Nethermind FPC docs) and #22497 (private FPC guide)
to the v4.2.0-aztecnr-rc.2 developer versioned docs.
critesjosh added a commit that referenced this pull request Apr 22, 2026
Ports changes from #22496 (Nethermind FPC docs) and #22497 (private FPC
guide) to the v4.2.0 developer versioned docs, plus related updates to
source docs (docs-developers), transaction phases explanation, and
runnable TypeScript examples.

Files:
- developer_versioned_docs/version-v4.2.0: how_to_pay_fees.md,
  how_to_use_private_fee_juice.md, foundational-topics/fees.md,
  foundational-topics/transactions.md
- docs-developers: how_to_pay_fees.md, how_to_use_private_fee_juice.md,
  foundational-topics/fees.md, foundational-topics/transactions.md
- examples/ts: aztecjs_advanced/index.ts, aztecjs_connection/index.ts
chrismarino pushed a commit to chrismarino/aztec-packages that referenced this pull request May 5, 2026
…#22541)

## Summary

- Ports changes from AztecProtocol#22496 (Nethermind FPC docs) and AztecProtocol#22497 (private
FPC guide) to the `v4.2.0-aztecnr-rc.2` developer versioned docs
- Updates `how_to_pay_fees.md` with new payment methods table,
deprecation notice, third-party FPC section (Nethermind example), and
private fee payment section
- Updates `fees.md` (foundational topics) with expanded FPC payment
methods description, new "How FPCs work" section, and teardown phase
clarification
- Updates `how_to_create_account.md` anchor links to match renamed
heading
- Adds new `how_to_use_private_fee_juice.md` guide (DeFi Wonderland's
PrivateFPC)

## Test plan

- [ ] `yarn start` in `docs/` — verify versioned pages render correctly
- [ ] Confirm internal links resolve (anchors to
`#sponsored-fpc-devnet-and-local-only`,
`#third-party-fpcs-on-testnet-and-mainnet`, `#how-fpcs-work`, and the
new private FPC guide)
- [ ] Verify external links to Nethermind and Wonderland repos are valid
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.

3 participants