Skip to content

docs: add getting started on testnet guide#22366

Open
AztecBot wants to merge 5 commits intonextfrom
claudebox/testnet-getting-started-docs
Open

docs: add getting started on testnet guide#22366
AztecBot wants to merge 5 commits intonextfrom
claudebox/testnet-getting-started-docs

Conversation

@AztecBot
Copy link
Copy Markdown
Collaborator

@AztecBot AztecBot commented Apr 7, 2026

Summary

Adds a new "Getting Started on Testnet" documentation page addressing developer questions about deploying to testnet. This was requested because the docs currently guide developers to the local network but don't explain how to use testnet.

The guide uses the Sponsored FPC at 0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923c for fee payment, so developers can get started without bridging Fee Juice from L1.

The new page covers:

  • Installing the correct testnet version of the CLI
  • Registering the Sponsored FPC and using it for fee payment
  • Creating and deploying accounts
  • Deploying and interacting with contracts (Token example)
  • Viewing transactions on Aztecscan
  • Registering existing contracts in PXE
  • Link to manual fee bridging docs for advanced users

Also updates:

  • sidebars-developer.js — added testnet page between local network and devnet
  • networks.md — added Sponsored FPC address for testnet, updated links and notes
  • how_to_pay_fees.md — removed conditional blocks saying Sponsored FPC isn't on testnet
  • getting_started_on_devnet.md — removed stale testnet warning about Sponsored FPC
  • getting_started_on_local_network.md — cross-links to testnet guide

Test plan

  • Run yarn start in docs/ and verify the new page renders correctly
  • Verify sidebar shows the testnet page between local network and devnet
  • Verify cross-links from networks.md and local network page work
  • Verify preprocessor macros (#include_testnet_version) resolve correctly
  • Confirm Sponsored FPC address 0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923c is correct and funded

@AztecBot AztecBot added ci-draft Run CI on draft PRs. claudebox Owned by claudebox. it can push to this PR. labels Apr 7, 2026
@AztecBot AztecBot force-pushed the claudebox/testnet-getting-started-docs branch from aa42adb to 11fcf02 Compare April 7, 2026 17:07
@critesjosh critesjosh marked this pull request as ready for review April 7, 2026 18:17
AztecBot and others added 5 commits April 8, 2026 15:03
Updated testnet getting started guide to use the Sponsored FPC at
0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923c
instead of requiring users to bridge Fee Juice manually.

Also updated networks.md, how_to_pay_fees.md, and devnet guide
to reflect that Sponsored FPC is now available on testnet.
Copy getting_started_on_testnet.md to both versioned doc directories
(v4.2.0-aztecnr-rc.2 and v4.1.0-rc.2), update versioned sidebars,
and fix Sponsored FPC availability notes in versioned fee docs.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport-to-v4-next ci-draft Run CI on draft PRs. claudebox Owned by claudebox. it can push to this PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants