From 98d4ff5e7a9c7be486a679167801ed5d968a5349 Mon Sep 17 00:00:00 2001 From: AztecBot Date: Tue, 7 Apr 2026 14:31:32 +0000 Subject: [PATCH 1/5] docs: add getting started on testnet guide --- .../docs/aztec-js/how_to_pay_fees.md | 14 +- .../getting_started_on_local_network.md | 3 +- .../getting_started_on_testnet.md | 214 ++++++++++++++++++ docs/docs/networks.md | 8 +- docs/sidebars-developer.js | 4 + 5 files changed, 227 insertions(+), 16 deletions(-) create mode 100644 docs/docs-developers/getting_started_on_testnet.md diff --git a/docs/docs-developers/docs/aztec-js/how_to_pay_fees.md b/docs/docs-developers/docs/aztec-js/how_to_pay_fees.md index 72129ca21e6b..82230c3cf9aa 100644 --- a/docs/docs-developers/docs/aztec-js/how_to_pay_fees.md +++ b/docs/docs-developers/docs/aztec-js/how_to_pay_fees.md @@ -23,11 +23,7 @@ This guide walks you through paying transaction fees on Aztec using various paym | Method | Use Case | Privacy | Requirements | | ------------------- | ----------------------------- | ------- | -------------------------- | | Fee Juice (default) | Account already has Fee Juice | Public | Funded account | -#if(devnet) | Sponsored FPC | Testing, free transactions | Public | None | -#else -| Sponsored FPC | Testing, free transactions | Public | None (devnet and local only) | -#endif | Bridge + Claim | Bootstrap from L1 | Public | L1 ETH for gas | ## Mana and Fee Juice @@ -85,17 +81,13 @@ Fee Payment Contracts (FPCs) pay Fee Juice on your behalf. FPCs must use Fee Jui ### Sponsored Fee Payment Contracts -#if(testnet) -:::note -The Sponsored FPC is not available on testnet or mainnet. It is only available on devnet and local network. -::: -#elif(mainnet) +#if(mainnet) :::note -The Sponsored FPC is not available on mainnet. It is only available on devnet and local network. +The Sponsored FPC is not available on mainnet. It is available on testnet, devnet, and local network. ::: #endif -The Sponsored FPC pays fees unconditionally. It is only available on devnet and local network. +The Sponsored FPC pays fees unconditionally. It is available on testnet, devnet, and local network. You can derive the Sponsored FPC address from its deployment parameters, register it with your wallet, and use it to pay for transactions: diff --git a/docs/docs-developers/getting_started_on_local_network.md b/docs/docs-developers/getting_started_on_local_network.md index a323a4a91b18..778e3f29e7d2 100644 --- a/docs/docs-developers/getting_started_on_local_network.md +++ b/docs/docs-developers/getting_started_on_local_network.md @@ -8,7 +8,7 @@ tags: [local_network, testnet] import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -Get started on your local environment using a local network. +Get started on your local environment using a local network. If you'd rather deploy to a live network, read the [getting started on testnet guide](./getting_started_on_testnet.md). The local network is a local development Aztec network running fully on your machine, and interacting with a development Ethereum node. You can develop and deploy on it just like on a testnet or mainnet (when the time comes). The local network makes it faster and easier to develop and test your Aztec applications. @@ -252,4 +252,5 @@ Simulation result: 25n Want to build something cool on Aztec? - Check out the [Token Contract Tutorial](./docs/tutorials/contract_tutorials/token_contract.md) for a beginner tutorial, or jump into more advanced ones +- Ready for a live network? Try [deploying on testnet](./getting_started_on_testnet.md) - Start on your own thing and check out the How To Guides to help you! diff --git a/docs/docs-developers/getting_started_on_testnet.md b/docs/docs-developers/getting_started_on_testnet.md new file mode 100644 index 000000000000..65c3154ea50b --- /dev/null +++ b/docs/docs-developers/getting_started_on_testnet.md @@ -0,0 +1,214 @@ +--- +title: Getting Started on Testnet +sidebar_position: 1 +tags: [testnet] +description: Deploy contracts and send transactions on Aztec testnet using the CLI wallet. +--- + +import { General } from '@site/src/components/Snippets/general_snippets'; + +This guide walks you through deploying your first contract on the Aztec testnet. You will install the CLI tools, get fee juice to pay for transactions, create an account, and deploy and interact with a contract. + +## Testnet vs Local Network + +| Feature | Local Network | Testnet | +|---------|-------------|---------| +| **Environment** | Local machine | Decentralized network on Sepolia | +| **Fees** | Free (test accounts prefunded) | Must bridge Fee Juice from L1 | +| **Block times** | Instant | ~36 seconds | +| **Proving** | Optional | Required | +| **Accounts** | Test accounts pre-deployed | Must create and deploy your own | + +:::info +If you want to develop and iterate quickly without bridging fees, start with the [local network guide](./getting_started_on_local_network.md) or the [devnet guide](./getting_started_on_devnet.md) (which has a sponsored fee contract for free transactions). +::: + +## Prerequisites + +- +- An Ethereum wallet with Sepolia ETH (for bridging Fee Juice). You can get Sepolia ETH from faucets like [Google Cloud Sepolia Faucet](https://cloud.google.com/application/web3/faucet/ethereum/sepolia) or [Alchemy Sepolia Faucet](https://www.alchemy.com/faucets/ethereum-sepolia). + +## Install the Aztec toolchain + +Install the testnet version of the Aztec CLI: + +```bash +VERSION=#include_testnet_version bash -i <(curl -sL https://install.aztec.network/#include_testnet_version) +``` + +:::warning +Testnet is version-dependent. It is currently running version `#include_testnet_version`. Ensure version consistency when interacting with the testnet to avoid errors. +::: + +This installs: + +- **aztec** - Compiles and tests Aztec contracts, launches infrastructure, and provides utility commands +- **aztec-up** - Version manager for the Aztec toolchain (`aztec-up install`, `aztec-up use`, `aztec-up list`) +- **aztec-wallet** - CLI tool for interacting with the Aztec network + +## Set up your environment + +Set the required environment variables: + +```bash +export NODE_URL=https://rpc.testnet.aztec-labs.com +``` + +## Step 1: Bridge Fee Juice from L1 + +Unlike the local network and devnet, testnet does **not** have a Sponsored Fee Payment Contract (FPC). You must bridge Fee Juice from Ethereum Sepolia to pay for transactions on L2. + +The `aztec-wallet bridge-fee-juice` command mints Fee Juice on L1 and bridges it to your L2 address. You need an Ethereum private key with Sepolia ETH for the L1 gas costs. + +First, generate an Aztec account (without deploying it yet): + +```bash +aztec-wallet create-account \ + --node-url $NODE_URL \ + --alias my-wallet \ + --skip-initialization \ + --register-class +``` + +This will print your account address. Now bridge Fee Juice to that address: + +```bash +aztec-wallet bridge-fee-juice \ + --node-url $NODE_URL \ + --l1-rpc-urls https://sepolia.infura.io/v3/YOUR_INFURA_KEY \ + --l1-private-key YOUR_SEPOLIA_PRIVATE_KEY \ + --mint \ + 1000000000000000000 \ + accounts:my-wallet +``` + +Replace `YOUR_INFURA_KEY` with a Sepolia RPC provider key (Infura, Alchemy, etc.) and `YOUR_SEPOLIA_PRIVATE_KEY` with the private key of an Ethereum account that has Sepolia ETH. + +:::note +The `--mint` flag mints Fee Juice on L1 before bridging. This works on testnets where the Fee Juice L1 contract allows minting. The bridging process takes a few minutes as it waits for L1 transactions to be processed and the L2 message to become available. +::: + +## Step 2: Deploy your account + +Once the Fee Juice has been bridged and is available on L2, deploy your account: + +```bash +aztec-wallet deploy-account \ + --node-url $NODE_URL \ + accounts:my-wallet +``` + +:::note +The first transaction may take longer as it downloads proving keys. If you see a `Timeout awaiting isMined` message, the transaction is still processing. Check the block explorer for status. +::: + +## Step 3: Deploy a contract + +Deploy a token contract as an example: + +```bash +aztec-wallet deploy \ + --node-url $NODE_URL \ + --from accounts:my-wallet \ + --alias token \ + TokenContract \ + --args accounts:my-wallet Token TOK 18 +``` + +This deploys the `TokenContract` with: +- `admin`: your wallet address +- `name`: Token +- `symbol`: TOK +- `decimals`: 18 + +On successful deployment, you'll see the contract address and deployment details. + +## Step 4: Interact with your contract + +Mint some tokens: + +```bash +aztec-wallet send mint_to_public \ + --node-url $NODE_URL \ + --from accounts:my-wallet \ + --contract-address token \ + --args accounts:my-wallet 100 +``` + +Check your balance: + +```bash +aztec-wallet simulate balance_of_public \ + --node-url $NODE_URL \ + --from accounts:my-wallet \ + --contract-address token \ + --args accounts:my-wallet +``` + +Move tokens to private state: + +```bash +aztec-wallet send transfer_to_private \ + --node-url $NODE_URL \ + --from accounts:my-wallet \ + --contract-address token \ + --args accounts:my-wallet 25 +``` + +Check your private balance: + +```bash +aztec-wallet simulate balance_of_private \ + --node-url $NODE_URL \ + --from accounts:my-wallet \ + --contract-address token \ + --args accounts:my-wallet +``` + +## Viewing transactions on the block explorer + +You can view your transactions, contracts, and account on the testnet block explorers: + +- [Aztecscan](https://testnet.aztecscan.xyz) +- [Aztec Explorer](https://aztecexplorer.xyz/?network=testnet) + +Search by transaction hash, contract address, or account address to see transaction details, status, and more. + +## Registering existing contracts + +If you want to interact with a contract that was deployed by someone else, you need to register it in your local PXE first: + +```bash +aztec-wallet register-contract \ + --node-url $NODE_URL \ + --alias mycontract \ + +``` + +For example, to register a `TokenContract` deployed by someone else: + +```bash +aztec-wallet register-contract \ + --node-url $NODE_URL \ + --alias external-token \ + 0x1234...abcd TokenContract +``` + +After registration, you can interact with it using `aztec-wallet send` and `aztec-wallet simulate` as shown above. + +## Key differences from devnet + +- **No Sponsored FPC**: You must bridge Fee Juice from L1 to pay for transactions. On devnet, the Sponsored FPC pays fees for free. +- **Decentralized sequencer set**: Testnet runs with multiple validators, unlike devnet's centralized sequencer. +- **Production-like conditions**: Testnet is the staging environment for Alpha. Treat it as production. +- **Longer finalization**: L2 to L1 message finalization takes longer due to the decentralized proving pipeline. + +## Testnet information + +For complete testnet technical details including contract addresses and network configuration, see the [Networks page](/networks#testnet). + +## Next steps + +- Check out the [Tutorials](./docs/tutorials/contract_tutorials/counter_contract.md) for building more complex contracts +- Learn about [paying fees](./docs/aztec-js/how_to_pay_fees.md) with different methods +- Explore [Aztec Playground](https://play.aztec.network/) for an interactive development experience diff --git a/docs/docs/networks.md b/docs/docs/networks.md index 4c88cd2e3263..d568037a20e3 100644 --- a/docs/docs/networks.md +++ b/docs/docs/networks.md @@ -25,10 +25,10 @@ The developer SDK/aztec-nr version (used for writing and compiling contracts) ma | **RPC Endpoint** | `https://aztec-mainnet.drpc.org` | `https://rpc.testnet.aztec-labs.com` | | **Bootnodes** | [http://static.aztec.network/mainnet/bootnodes.json](http://static.aztec.network/mainnet/bootnodes.json) | [http://static.aztec.network/testnet/bootnodes.json](http://static.aztec.network/testnet/bootnodes.json) | | **Block Explorer** | [Aztecscan](https://aztecscan.xyz), [Aztecexplorer](https://aztecexplorer.xyz/?network=mainnet) | [Aztecscan](https://testnet.aztecscan.xyz), [Aztecexplorer](https://aztecexplorer.xyz/?network=testnet) | -| **Getting Started** | [Run a sequencer →](/operate/operators/setup/sequencer_management) | [Run a node →](/operate/operators/setup/running_a_node) | +| **Getting Started** | [Run a sequencer →](/operate/operators/setup/sequencer_management) | [Build on Testnet →](/developers/getting_started_on_testnet) | :::tip Network Roles (Post-Alpha) -**Testnet is your production path.** It's decentralized, live, and stable — treat it as your staging environment for Alpha. If you want to deploy on Alpha, validate on Testnet first. Note: Sponsored FPC is not available on Testnet. +**Testnet is your production path.** It's decentralized, live, and stable — treat it as your staging environment for Alpha. If you want to deploy on Alpha, validate on Testnet first. ::: ## Contract Addresses @@ -132,13 +132,13 @@ Testnet is ideal for testing node configurations, governance proposals, and unde - Fully decentralized sequencer set - Connected to Ethereum Sepolia - Transactions are proven -- No Sponsored FPC — you must handle fee payment +- Sponsored FPC available for fee payment - Good environment for testing node operations ## Next Steps Based on your use case: -- **Building an application?** Start with [Getting Started](/developers/getting_started_on_local_network) +- **Building an application?** Start with the [local network guide](/developers/getting_started_on_local_network) for development, or [deploy on testnet](/developers/getting_started_on_testnet) for production-like testing - **Running infrastructure?** Review [Network Operator Guide](/operate/operators) - **Joining as validator?** See [Sequencer Management](/operate/operators/setup/sequencer_management) diff --git a/docs/sidebars-developer.js b/docs/sidebars-developer.js index e6b15b880d35..35d4dc0a53b6 100644 --- a/docs/sidebars-developer.js +++ b/docs/sidebars-developer.js @@ -17,6 +17,10 @@ const sidebars = { type: "doc", id: "getting_started_on_local_network", }, + { + type: "doc", + id: "getting_started_on_testnet", + }, { type: "doc", id: "ai_tooling", From 44b3ceaeb4cdfb3e3f63462052c1a80066b0e76c Mon Sep 17 00:00:00 2001 From: AztecBot Date: Tue, 7 Apr 2026 15:07:35 +0000 Subject: [PATCH 2/5] docs: use Sponsored FPC on testnet with correct address 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. --- .../docs/aztec-js/how_to_pay_fees.md | 4 +- .../getting_started_on_testnet.md | 93 +++++++++---------- 2 files changed, 45 insertions(+), 52 deletions(-) diff --git a/docs/docs-developers/docs/aztec-js/how_to_pay_fees.md b/docs/docs-developers/docs/aztec-js/how_to_pay_fees.md index 82230c3cf9aa..2c511c583941 100644 --- a/docs/docs-developers/docs/aztec-js/how_to_pay_fees.md +++ b/docs/docs-developers/docs/aztec-js/how_to_pay_fees.md @@ -83,11 +83,11 @@ Fee Payment Contracts (FPCs) pay Fee Juice on your behalf. FPCs must use Fee Jui #if(mainnet) :::note -The Sponsored FPC is not available on mainnet. It is available on testnet, devnet, and local network. +The Sponsored FPC is not available on mainnet. It is available on testnet and local network. ::: #endif -The Sponsored FPC pays fees unconditionally. It is available on testnet, devnet, and local network. +The Sponsored FPC pays fees unconditionally. It is available on testnet and local network. You can derive the Sponsored FPC address from its deployment parameters, register it with your wallet, and use it to pay for transactions: diff --git a/docs/docs-developers/getting_started_on_testnet.md b/docs/docs-developers/getting_started_on_testnet.md index 65c3154ea50b..0f4ccad477e5 100644 --- a/docs/docs-developers/getting_started_on_testnet.md +++ b/docs/docs-developers/getting_started_on_testnet.md @@ -2,31 +2,30 @@ title: Getting Started on Testnet sidebar_position: 1 tags: [testnet] -description: Deploy contracts and send transactions on Aztec testnet using the CLI wallet. +description: Deploy contracts and send transactions on the Aztec testnet using the CLI wallet and the Sponsored FPC for fee payment. --- import { General } from '@site/src/components/Snippets/general_snippets'; -This guide walks you through deploying your first contract on the Aztec testnet. You will install the CLI tools, get fee juice to pay for transactions, create an account, and deploy and interact with a contract. +This guide walks you through deploying your first contract on the Aztec testnet. You will install the CLI tools, create an account using the Sponsored FPC (so you don't need to bridge Fee Juice yourself), and deploy and interact with a contract. ## Testnet vs Local Network | Feature | Local Network | Testnet | |---------|-------------|---------| | **Environment** | Local machine | Decentralized network on Sepolia | -| **Fees** | Free (test accounts prefunded) | Must bridge Fee Juice from L1 | +| **Fees** | Free (test accounts prefunded) | Sponsored FPC available | | **Block times** | Instant | ~36 seconds | | **Proving** | Optional | Required | | **Accounts** | Test accounts pre-deployed | Must create and deploy your own | :::info -If you want to develop and iterate quickly without bridging fees, start with the [local network guide](./getting_started_on_local_network.md) or the [devnet guide](./getting_started_on_devnet.md) (which has a sponsored fee contract for free transactions). +If you want to develop and iterate quickly, start with the [local network guide](./getting_started_on_local_network.md). The local network has instant blocks and no proving, making it faster for development. ::: ## Prerequisites - -- An Ethereum wallet with Sepolia ETH (for bridging Fee Juice). You can get Sepolia ETH from faucets like [Google Cloud Sepolia Faucet](https://cloud.google.com/application/web3/faucet/ethereum/sepolia) or [Alchemy Sepolia Faucet](https://www.alchemy.com/faucets/ethereum-sepolia). ## Install the Aztec toolchain @@ -37,7 +36,7 @@ VERSION=#include_testnet_version bash -i <(curl -sL https://install.aztec.networ ``` :::warning -Testnet is version-dependent. It is currently running version `#include_testnet_version`. Ensure version consistency when interacting with the testnet to avoid errors. +Testnet is version-dependent. It is currently running version `#include_testnet_version`. Maintain version consistency when interacting with the testnet to avoid errors. ::: This installs: @@ -46,63 +45,45 @@ This installs: - **aztec-up** - Version manager for the Aztec toolchain (`aztec-up install`, `aztec-up use`, `aztec-up list`) - **aztec-wallet** - CLI tool for interacting with the Aztec network -## Set up your environment +## Getting started on testnet + +### Step 1: Set up your environment Set the required environment variables: ```bash export NODE_URL=https://rpc.testnet.aztec-labs.com +export SPONSORED_FPC_ADDRESS=0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923c ``` -## Step 1: Bridge Fee Juice from L1 - -Unlike the local network and devnet, testnet does **not** have a Sponsored Fee Payment Contract (FPC). You must bridge Fee Juice from Ethereum Sepolia to pay for transactions on L2. +### Step 2: Register the Sponsored FPC -The `aztec-wallet bridge-fee-juice` command mints Fee Juice on L1 and bridges it to your L2 address. You need an Ethereum private key with Sepolia ETH for the L1 gas costs. - -First, generate an Aztec account (without deploying it yet): +The Sponsored FPC (Fee Payment Contract) pays transaction fees on your behalf, so you don't need to bridge Fee Juice from L1. Register it in your wallet: ```bash -aztec-wallet create-account \ - --node-url $NODE_URL \ - --alias my-wallet \ - --skip-initialization \ - --register-class -``` - -This will print your account address. Now bridge Fee Juice to that address: - -```bash -aztec-wallet bridge-fee-juice \ +aztec-wallet register-contract \ --node-url $NODE_URL \ - --l1-rpc-urls https://sepolia.infura.io/v3/YOUR_INFURA_KEY \ - --l1-private-key YOUR_SEPOLIA_PRIVATE_KEY \ - --mint \ - 1000000000000000000 \ - accounts:my-wallet + --alias sponsoredfpc \ + $SPONSORED_FPC_ADDRESS SponsoredFPC \ + --salt 0 ``` -Replace `YOUR_INFURA_KEY` with a Sepolia RPC provider key (Infura, Alchemy, etc.) and `YOUR_SEPOLIA_PRIVATE_KEY` with the private key of an Ethereum account that has Sepolia ETH. +### Step 3: Create and deploy an account -:::note -The `--mint` flag mints Fee Juice on L1 before bridging. This works on testnets where the Fee Juice L1 contract allows minting. The bridging process takes a few minutes as it waits for L1 transactions to be processed and the L2 message to become available. -::: - -## Step 2: Deploy your account - -Once the Fee Juice has been bridged and is available on L2, deploy your account: +Unlike the local network, testnet has no pre-deployed accounts. Create and deploy your own: ```bash -aztec-wallet deploy-account \ +aztec-wallet create-account \ --node-url $NODE_URL \ - accounts:my-wallet + --alias my-wallet \ + --payment method=fpc-sponsored,fpc=$SPONSORED_FPC_ADDRESS ``` :::note -The first transaction may take longer as it downloads proving keys. If you see a `Timeout awaiting isMined` message, the transaction is still processing. Check the block explorer for status. +The first transaction will take longer as it downloads proving keys. If you see `Timeout awaiting isMined`, the transaction is still processing — this is normal on testnet. ::: -## Step 3: Deploy a contract +### Step 4: Deploy a contract Deploy a token contract as an example: @@ -110,6 +91,7 @@ Deploy a token contract as an example: aztec-wallet deploy \ --node-url $NODE_URL \ --from accounts:my-wallet \ + --payment method=fpc-sponsored,fpc=$SPONSORED_FPC_ADDRESS \ --alias token \ TokenContract \ --args accounts:my-wallet Token TOK 18 @@ -121,9 +103,9 @@ This deploys the `TokenContract` with: - `symbol`: TOK - `decimals`: 18 -On successful deployment, you'll see the contract address and deployment details. +You can check the transaction status on [Aztecscan](https://testnet.aztecscan.xyz). -## Step 4: Interact with your contract +### Step 5: Interact with your contract Mint some tokens: @@ -131,6 +113,7 @@ Mint some tokens: aztec-wallet send mint_to_public \ --node-url $NODE_URL \ --from accounts:my-wallet \ + --payment method=fpc-sponsored,fpc=$SPONSORED_FPC_ADDRESS \ --contract-address token \ --args accounts:my-wallet 100 ``` @@ -145,12 +128,19 @@ aztec-wallet simulate balance_of_public \ --args accounts:my-wallet ``` +This should print: + +``` +Simulation result: 100n +``` + Move tokens to private state: ```bash aztec-wallet send transfer_to_private \ --node-url $NODE_URL \ --from accounts:my-wallet \ + --payment method=fpc-sponsored,fpc=$SPONSORED_FPC_ADDRESS \ --contract-address token \ --args accounts:my-wallet 25 ``` @@ -165,6 +155,12 @@ aztec-wallet simulate balance_of_private \ --args accounts:my-wallet ``` +This should print: + +``` +Simulation result: 25n +``` + ## Viewing transactions on the block explorer You can view your transactions, contracts, and account on the testnet block explorers: @@ -172,11 +168,11 @@ You can view your transactions, contracts, and account on the testnet block expl - [Aztecscan](https://testnet.aztecscan.xyz) - [Aztec Explorer](https://aztecexplorer.xyz/?network=testnet) -Search by transaction hash, contract address, or account address to see transaction details, status, and more. +Search by transaction hash, contract address, or account address to see details and status. ## Registering existing contracts -If you want to interact with a contract that was deployed by someone else, you need to register it in your local PXE first: +To interact with a contract deployed by someone else, you need to register it in your local PXE first: ```bash aztec-wallet register-contract \ @@ -196,12 +192,9 @@ aztec-wallet register-contract \ After registration, you can interact with it using `aztec-wallet send` and `aztec-wallet simulate` as shown above. -## Key differences from devnet +## Paying fees without the Sponsored FPC -- **No Sponsored FPC**: You must bridge Fee Juice from L1 to pay for transactions. On devnet, the Sponsored FPC pays fees for free. -- **Decentralized sequencer set**: Testnet runs with multiple validators, unlike devnet's centralized sequencer. -- **Production-like conditions**: Testnet is the staging environment for Alpha. Treat it as production. -- **Longer finalization**: L2 to L1 message finalization takes longer due to the decentralized proving pipeline. +The Sponsored FPC is convenient for getting started, but you can also pay fees directly by bridging Fee Juice from Ethereum Sepolia. See [Paying Fees](./docs/aztec-js/how_to_pay_fees.md#bridge-fee-juice-from-l1) for details on bridging and other fee payment methods. ## Testnet information From 4ebe07f3a5b96783709d834d4de353d1245e6daa Mon Sep 17 00:00:00 2001 From: AztecBot Date: Tue, 7 Apr 2026 17:07:02 +0000 Subject: [PATCH 3/5] docs: add testnet page to versioned docs and sidebars 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. --- .../docs/aztec-js/how_to_pay_fees.md | 4 +- .../getting_started_on_local_network.md | 2 +- .../getting_started_on_testnet.md | 207 ++++++++++++++++++ .../version-v4.2.0-aztecnr-rc.2-sidebars.json | 4 + 4 files changed, 214 insertions(+), 3 deletions(-) create mode 100644 docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_testnet.md diff --git a/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/docs/aztec-js/how_to_pay_fees.md b/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/docs/aztec-js/how_to_pay_fees.md index 1dcaacd8c744..1e2f314c4909 100644 --- a/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/docs/aztec-js/how_to_pay_fees.md +++ b/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/docs/aztec-js/how_to_pay_fees.md @@ -113,10 +113,10 @@ Fee Payment Contracts (FPC) pay fees on your behalf, typically accepting a diffe ### Sponsored Fee Payment Contracts :::note -The Sponsored FPC is **not** deployed on mainnet or testnet. It is only available on devnet and local network. To pay fees on mainnet, you must either [bridge Fee Juice from L1](#bridge-fee-juice-from-l1) or deploy your own fee-paying contract. +The Sponsored FPC is **not** deployed on mainnet. It is available on testnet and local network. ::: -The Sponsored FPC pays for fees unconditionally without requiring payment in return. It is available on the local network and devnet (deployed by Aztec Labs), but **not on mainnet or testnet**. +The Sponsored FPC pays for fees unconditionally without requiring payment in return. It is available on testnet and local network. You can derive the Sponsored FPC address from its deployment parameters, register it with your wallet, and use it to pay for transactions: diff --git a/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_local_network.md b/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_local_network.md index d003932c3d94..8b086cb7b4e6 100644 --- a/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_local_network.md +++ b/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_local_network.md @@ -8,7 +8,7 @@ tags: [local_network, testnet] import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -Get started on your local environment using a local network. +Get started on your local environment using a local network. If you'd rather deploy to a live network, read the [getting started on testnet guide](./getting_started_on_testnet.md). The local network is a local development Aztec network running fully on your machine, and interacting with a development Ethereum node. You can develop and deploy on it just like on a testnet or mainnet (when the time comes). The local network makes it faster and easier to develop and test your Aztec applications. diff --git a/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_testnet.md b/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_testnet.md new file mode 100644 index 000000000000..0f4ccad477e5 --- /dev/null +++ b/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_testnet.md @@ -0,0 +1,207 @@ +--- +title: Getting Started on Testnet +sidebar_position: 1 +tags: [testnet] +description: Deploy contracts and send transactions on the Aztec testnet using the CLI wallet and the Sponsored FPC for fee payment. +--- + +import { General } from '@site/src/components/Snippets/general_snippets'; + +This guide walks you through deploying your first contract on the Aztec testnet. You will install the CLI tools, create an account using the Sponsored FPC (so you don't need to bridge Fee Juice yourself), and deploy and interact with a contract. + +## Testnet vs Local Network + +| Feature | Local Network | Testnet | +|---------|-------------|---------| +| **Environment** | Local machine | Decentralized network on Sepolia | +| **Fees** | Free (test accounts prefunded) | Sponsored FPC available | +| **Block times** | Instant | ~36 seconds | +| **Proving** | Optional | Required | +| **Accounts** | Test accounts pre-deployed | Must create and deploy your own | + +:::info +If you want to develop and iterate quickly, start with the [local network guide](./getting_started_on_local_network.md). The local network has instant blocks and no proving, making it faster for development. +::: + +## Prerequisites + +- + +## Install the Aztec toolchain + +Install the testnet version of the Aztec CLI: + +```bash +VERSION=#include_testnet_version bash -i <(curl -sL https://install.aztec.network/#include_testnet_version) +``` + +:::warning +Testnet is version-dependent. It is currently running version `#include_testnet_version`. Maintain version consistency when interacting with the testnet to avoid errors. +::: + +This installs: + +- **aztec** - Compiles and tests Aztec contracts, launches infrastructure, and provides utility commands +- **aztec-up** - Version manager for the Aztec toolchain (`aztec-up install`, `aztec-up use`, `aztec-up list`) +- **aztec-wallet** - CLI tool for interacting with the Aztec network + +## Getting started on testnet + +### Step 1: Set up your environment + +Set the required environment variables: + +```bash +export NODE_URL=https://rpc.testnet.aztec-labs.com +export SPONSORED_FPC_ADDRESS=0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923c +``` + +### Step 2: Register the Sponsored FPC + +The Sponsored FPC (Fee Payment Contract) pays transaction fees on your behalf, so you don't need to bridge Fee Juice from L1. Register it in your wallet: + +```bash +aztec-wallet register-contract \ + --node-url $NODE_URL \ + --alias sponsoredfpc \ + $SPONSORED_FPC_ADDRESS SponsoredFPC \ + --salt 0 +``` + +### Step 3: Create and deploy an account + +Unlike the local network, testnet has no pre-deployed accounts. Create and deploy your own: + +```bash +aztec-wallet create-account \ + --node-url $NODE_URL \ + --alias my-wallet \ + --payment method=fpc-sponsored,fpc=$SPONSORED_FPC_ADDRESS +``` + +:::note +The first transaction will take longer as it downloads proving keys. If you see `Timeout awaiting isMined`, the transaction is still processing — this is normal on testnet. +::: + +### Step 4: Deploy a contract + +Deploy a token contract as an example: + +```bash +aztec-wallet deploy \ + --node-url $NODE_URL \ + --from accounts:my-wallet \ + --payment method=fpc-sponsored,fpc=$SPONSORED_FPC_ADDRESS \ + --alias token \ + TokenContract \ + --args accounts:my-wallet Token TOK 18 +``` + +This deploys the `TokenContract` with: +- `admin`: your wallet address +- `name`: Token +- `symbol`: TOK +- `decimals`: 18 + +You can check the transaction status on [Aztecscan](https://testnet.aztecscan.xyz). + +### Step 5: Interact with your contract + +Mint some tokens: + +```bash +aztec-wallet send mint_to_public \ + --node-url $NODE_URL \ + --from accounts:my-wallet \ + --payment method=fpc-sponsored,fpc=$SPONSORED_FPC_ADDRESS \ + --contract-address token \ + --args accounts:my-wallet 100 +``` + +Check your balance: + +```bash +aztec-wallet simulate balance_of_public \ + --node-url $NODE_URL \ + --from accounts:my-wallet \ + --contract-address token \ + --args accounts:my-wallet +``` + +This should print: + +``` +Simulation result: 100n +``` + +Move tokens to private state: + +```bash +aztec-wallet send transfer_to_private \ + --node-url $NODE_URL \ + --from accounts:my-wallet \ + --payment method=fpc-sponsored,fpc=$SPONSORED_FPC_ADDRESS \ + --contract-address token \ + --args accounts:my-wallet 25 +``` + +Check your private balance: + +```bash +aztec-wallet simulate balance_of_private \ + --node-url $NODE_URL \ + --from accounts:my-wallet \ + --contract-address token \ + --args accounts:my-wallet +``` + +This should print: + +``` +Simulation result: 25n +``` + +## Viewing transactions on the block explorer + +You can view your transactions, contracts, and account on the testnet block explorers: + +- [Aztecscan](https://testnet.aztecscan.xyz) +- [Aztec Explorer](https://aztecexplorer.xyz/?network=testnet) + +Search by transaction hash, contract address, or account address to see details and status. + +## Registering existing contracts + +To interact with a contract deployed by someone else, you need to register it in your local PXE first: + +```bash +aztec-wallet register-contract \ + --node-url $NODE_URL \ + --alias mycontract \ + +``` + +For example, to register a `TokenContract` deployed by someone else: + +```bash +aztec-wallet register-contract \ + --node-url $NODE_URL \ + --alias external-token \ + 0x1234...abcd TokenContract +``` + +After registration, you can interact with it using `aztec-wallet send` and `aztec-wallet simulate` as shown above. + +## Paying fees without the Sponsored FPC + +The Sponsored FPC is convenient for getting started, but you can also pay fees directly by bridging Fee Juice from Ethereum Sepolia. See [Paying Fees](./docs/aztec-js/how_to_pay_fees.md#bridge-fee-juice-from-l1) for details on bridging and other fee payment methods. + +## Testnet information + +For complete testnet technical details including contract addresses and network configuration, see the [Networks page](/networks#testnet). + +## Next steps + +- Check out the [Tutorials](./docs/tutorials/contract_tutorials/counter_contract.md) for building more complex contracts +- Learn about [paying fees](./docs/aztec-js/how_to_pay_fees.md) with different methods +- Explore [Aztec Playground](https://play.aztec.network/) for an interactive development experience diff --git a/docs/developer_versioned_sidebars/version-v4.2.0-aztecnr-rc.2-sidebars.json b/docs/developer_versioned_sidebars/version-v4.2.0-aztecnr-rc.2-sidebars.json index d1a66f8279f4..75eaf90f9f30 100644 --- a/docs/developer_versioned_sidebars/version-v4.2.0-aztecnr-rc.2-sidebars.json +++ b/docs/developer_versioned_sidebars/version-v4.2.0-aztecnr-rc.2-sidebars.json @@ -13,6 +13,10 @@ "type": "doc", "id": "getting_started_on_local_network" }, + { + "type": "doc", + "id": "getting_started_on_testnet" + }, { "type": "doc", "id": "ai_tooling" From b36829315b05f01328ea67ad81f683fd51381082 Mon Sep 17 00:00:00 2001 From: Codespace Date: Tue, 7 Apr 2026 14:16:45 -0400 Subject: [PATCH 4/5] add correct versions --- .../version-v4.2.0-aztecnr-rc.2/getting_started_on_testnet.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_testnet.md b/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_testnet.md index 0f4ccad477e5..3c675509afd0 100644 --- a/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_testnet.md +++ b/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_testnet.md @@ -32,11 +32,11 @@ If you want to develop and iterate quickly, start with the [local network guide] Install the testnet version of the Aztec CLI: ```bash -VERSION=#include_testnet_version bash -i <(curl -sL https://install.aztec.network/#include_testnet_version) +VERSION=4.2.0-aztecnr-rc.2 bash -i <(curl -sL https://install.aztec.network/4.2.0-aztecnr-rc.2) ``` :::warning -Testnet is version-dependent. It is currently running version `#include_testnet_version`. Maintain version consistency when interacting with the testnet to avoid errors. +Testnet is version-dependent. It is currently running version `4.2.0-aztecnr-rc.2`. Maintain version consistency when interacting with the testnet to avoid errors. ::: This installs: From 5abfaa3df253e9be2319d1dbac601238b4f9851c Mon Sep 17 00:00:00 2001 From: Codespace Date: Tue, 7 Apr 2026 14:27:46 -0400 Subject: [PATCH 5/5] docs: update versioned docs and networks page for testnet changes --- .../getting_started_on_local_network.md | 1 + docs/docs/networks.md | 86 +++++++++---------- 2 files changed, 42 insertions(+), 45 deletions(-) diff --git a/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_local_network.md b/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_local_network.md index 8b086cb7b4e6..e9aaaff22048 100644 --- a/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_local_network.md +++ b/docs/developer_versioned_docs/version-v4.2.0-aztecnr-rc.2/getting_started_on_local_network.md @@ -252,4 +252,5 @@ Simulation result: 25n Want to build something cool on Aztec? - Check out the [Token Contract Tutorial](./docs/tutorials/contract_tutorials/token_contract.md) for a beginner tutorial, or jump into more advanced ones +- Ready for a live network? Try [deploying on testnet](./getting_started_on_testnet.md) - Start on your own thing and check out the How To Guides to help you! diff --git a/docs/docs/networks.md b/docs/docs/networks.md index d568037a20e3..dcbf3ab70d96 100644 --- a/docs/docs/networks.md +++ b/docs/docs/networks.md @@ -35,58 +35,50 @@ The developer SDK/aztec-nr version (used for writing and compiling contracts) ma ### L1 Contract Addresses -| Contract Name | Alpha (Mainnet) | Testnet | -|---------------|-------------------|---------| -| **Registry** | [`0x35b22e09ee0390539439e24f06da43d83f90e298`](https://etherscan.io/address/0x35b22e09ee0390539439e24f06da43d83f90e298) | [`0xa0bfb1b494fb49041e5c6e8c2c1be09cd171c6ba`](https://sepolia.etherscan.io/address/0xa0bfb1b494fb49041e5c6e8c2c1be09cd171c6ba) | -| **Rollup** | [`0xae2001f7e21d5ecabf6234e9fdd1e76f50f74962`](https://etherscan.io/address/0xae2001f7e21d5ecabf6234e9fdd1e76f50f74962) | [`0xf6D0D42aCE06829bECB78C74F49879528fC632c1`](https://sepolia.etherscan.io/address/0xf6D0D42aCE06829bECB78C74F49879528fC632c1) | -| **L1 → L2 Inbox** | [`0x8dbf0b6ed495baab6062f5d5365af3c1b2ed4578`](https://etherscan.io/address/0x8dbf0b6ed495baab6062f5d5365af3c1b2ed4578) | [`0xF1bB424AC888Aa239F1E658B5BdDabc65a1c94E6`](https://sepolia.etherscan.io/address/0xF1bB424AC888Aa239F1E658B5BdDabc65a1c94E6) | -| **L2 → L1 Outbox** | [`0xc9698b7adef9ee63f3bf5cff38086e4e836579f0`](https://etherscan.io/address/0xc9698b7adef9ee63f3bf5cff38086e4e836579f0) | [`0x5fE63c32b7ca20445e813bDb1019f1FFC5f52376`](https://sepolia.etherscan.io/address/0x5fE63c32b7ca20445e813bDb1019f1FFC5f52376) | -| **Fee Juice** | [`0xa27ec0006e59f245217ff08cd52a7e8b169e62d2`](https://etherscan.io/address/0xa27ec0006e59f245217ff08cd52a7e8b169e62d2) | [`0x762c132040fda6183066fa3b14d985ee55aa3c18`](https://sepolia.etherscan.io/address/0x762c132040fda6183066fa3b14d985ee55aa3c18) | -| **Staking Asset** | [`0xa27ec0006e59f245217ff08cd52a7e8b169e62d2`](https://etherscan.io/address/0xa27ec0006e59f245217ff08cd52a7e8b169e62d2) | [`0x5595cb9ed193cac2c0bc5393313bc6115817954b`](https://sepolia.etherscan.io/address/0x5595cb9ed193cac2c0bc5393313bc6115817954b) | -| **Fee Juice Portal** | [`0x2891f8b941067f8b5a3f34545a30cf71e3e23617`](https://etherscan.io/address/0x2891f8b941067f8b5a3f34545a30cf71e3e23617) | [`0xd3361019e40026ce8a9745c19e67fd3acc10d596`](https://sepolia.etherscan.io/address/0xd3361019e40026ce8a9745c19e67fd3acc10d596) | -| **Fee Asset Handler** | N/A | [`0x5602c39a6e9c5ace589f64f754927bcda4f4bfc9`](https://sepolia.etherscan.io/address/0x5602c39a6e9c5ace589f64f754927bcda4f4bfc9) | -| **Coin Issuer** | [`0x02fadf157d551aa6d761b2a2237d03af68e41ca6`](https://etherscan.io/address/0x02fadf157d551aa6d761b2a2237d03af68e41ca6) | [`0xe05d0a62045b4237556c1ec423e59eea9a24eaee`](https://sepolia.etherscan.io/address/0xe05d0a62045b4237556c1ec423e59eea9a24eaee) | -| **Reward Distributor** | [`0x3d6a1b00c830c5f278fc5dfb3f6ff0b74db6dfe0`](https://etherscan.io/address/0x3d6a1b00c830c5f278fc5dfb3f6ff0b74db6dfe0) | [`0x030d2780e70f085c31d490268d3900d4cea16606`](https://sepolia.etherscan.io/address/0x030d2780e70f085c31d490268d3900d4cea16606) | -| **Reward Booster** | [`0x7101a6703491a4d808aeabe9f62bc1dc6a20bdf4`](https://etherscan.io/address/0x7101a6703491a4d808aeabe9f62bc1dc6a20bdf4) | [`0x49711056D1EaDcDD3F2eF676DC8EA3F924fB916c`](https://sepolia.etherscan.io/address/0x49711056D1EaDcDD3F2eF676DC8EA3F924fB916c) | -| **Governance Proposer** | [`0x06ef1dcf87e419c48b94a331b252819fadbd63ef`](https://etherscan.io/address/0x06ef1dcf87e419c48b94a331b252819fadbd63ef) | [`0x01c7d4ca153748d2377968fef22894cb162e9480`](https://sepolia.etherscan.io/address/0x01c7d4ca153748d2377968fef22894cb162e9480) | -| **Governance** | [`0x1102471eb3378fee427121c9efcea452e4b6b75e`](https://etherscan.io/address/0x1102471eb3378fee427121c9efcea452e4b6b75e) | [`0xcaf7447721447b22cd0076ac7c63877c3afd329f`](https://sepolia.etherscan.io/address/0xcaf7447721447b22cd0076ac7c63877c3afd329f) | -| **Governance Staking Escrow** | [`0xa92ecfd0e70c9cd5e5cd76c50af0f7da93567a4f`](https://etherscan.io/address/0xa92ecfd0e70c9cd5e5cd76c50af0f7da93567a4f) | [`0xb6a38a51a6c1de9012f9d8ea9745ef957212eaac`](https://sepolia.etherscan.io/address/0xb6a38a51a6c1de9012f9d8ea9745ef957212eaac) | -| **Staking Registry** | [`0x042dF8f42790d6943F41C25C2132400fd727f452`](https://etherscan.io/address/0x042dF8f42790d6943F41C25C2132400fd727f452) | [`0xC6EcC1832c8BF6a41c927BEb4E9ec610FBeDd1C2`](https://sepolia.etherscan.io/address/0xC6EcC1832c8BF6a41c927BEb4E9ec610FBeDd1C2) | -| **Slash Factory** | N/A | [`0x9CF4a0094c8696d5110dd0f0cF3FA5deA174BB17`](https://sepolia.etherscan.io/address/0x9CF4a0094c8696d5110dd0f0cF3FA5deA174BB17) | -| **Slasher** | [`0x64E6e9Bb9f1E33D319578B9f8a9C719Ca6D46eBb`](https://etherscan.io/address/0x64E6e9Bb9f1E33D319578B9f8a9C719Ca6D46eBb) | [`0xf6D0D42aCE06829bECB78C74F49879528fC632c1`](https://sepolia.etherscan.io/address/0xf6D0D42aCE06829bECB78C74F49879528fC632c1) | -| **Tally Slashing Proposer** | [`0x7a318c3daa9f21f8fc8238c65755eb0394fbf189`](https://etherscan.io/address/0x7a318c3daa9f21f8fc8238c65755eb0394fbf189) | [`0x158eCC4B24675dc399031c7D144786e3da2060A8`](https://sepolia.etherscan.io/address/0x158eCC4B24675dc399031c7D144786e3da2060A8) | -| **Honk Verifier** | N/A | [`0x800FbC88054ba6c228B7d822F1DCAf4d627E8F97`](https://sepolia.etherscan.io/address/0x800FbC88054ba6c228B7d822F1DCAf4d627E8F97) | -| **Register New Rollup Version Payload** | N/A | [`0x11f7Ab2324CA94af929A388477a7959E0108C3d6`](https://sepolia.etherscan.io/address/0x11f7Ab2324CA94af929A388477a7959E0108C3d6) | -| **Slash Payload Cloneable** | N/A | [`0xe66d9eeBfF5490E6bfA263cF08028dE7d265321F`](https://sepolia.etherscan.io/address/0xe66d9eeBfF5490E6bfA263cF08028dE7d265321F) | | +| Contract Name | Alpha (Mainnet) | Testnet | +| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | --- | +| **Registry** | [`0x35b22e09ee0390539439e24f06da43d83f90e298`](https://etherscan.io/address/0x35b22e09ee0390539439e24f06da43d83f90e298) | [`0xa0bfb1b494fb49041e5c6e8c2c1be09cd171c6ba`](https://sepolia.etherscan.io/address/0xa0bfb1b494fb49041e5c6e8c2c1be09cd171c6ba) | +| **Rollup** | [`0xae2001f7e21d5ecabf6234e9fdd1e76f50f74962`](https://etherscan.io/address/0xae2001f7e21d5ecabf6234e9fdd1e76f50f74962) | [`0xf6D0D42aCE06829bECB78C74F49879528fC632c1`](https://sepolia.etherscan.io/address/0xf6D0D42aCE06829bECB78C74F49879528fC632c1) | +| **L1 → L2 Inbox** | [`0x8dbf0b6ed495baab6062f5d5365af3c1b2ed4578`](https://etherscan.io/address/0x8dbf0b6ed495baab6062f5d5365af3c1b2ed4578) | [`0xF1bB424AC888Aa239F1E658B5BdDabc65a1c94E6`](https://sepolia.etherscan.io/address/0xF1bB424AC888Aa239F1E658B5BdDabc65a1c94E6) | +| **L2 → L1 Outbox** | [`0xc9698b7adef9ee63f3bf5cff38086e4e836579f0`](https://etherscan.io/address/0xc9698b7adef9ee63f3bf5cff38086e4e836579f0) | [`0x5fE63c32b7ca20445e813bDb1019f1FFC5f52376`](https://sepolia.etherscan.io/address/0x5fE63c32b7ca20445e813bDb1019f1FFC5f52376) | +| **Fee Juice** | [`0xa27ec0006e59f245217ff08cd52a7e8b169e62d2`](https://etherscan.io/address/0xa27ec0006e59f245217ff08cd52a7e8b169e62d2) | [`0x762c132040fda6183066fa3b14d985ee55aa3c18`](https://sepolia.etherscan.io/address/0x762c132040fda6183066fa3b14d985ee55aa3c18) | +| **Staking Asset** | [`0xa27ec0006e59f245217ff08cd52a7e8b169e62d2`](https://etherscan.io/address/0xa27ec0006e59f245217ff08cd52a7e8b169e62d2) | [`0x5595cb9ed193cac2c0bc5393313bc6115817954b`](https://sepolia.etherscan.io/address/0x5595cb9ed193cac2c0bc5393313bc6115817954b) | +| **Fee Juice Portal** | [`0x2891f8b941067f8b5a3f34545a30cf71e3e23617`](https://etherscan.io/address/0x2891f8b941067f8b5a3f34545a30cf71e3e23617) | [`0xd3361019e40026ce8a9745c19e67fd3acc10d596`](https://sepolia.etherscan.io/address/0xd3361019e40026ce8a9745c19e67fd3acc10d596) | +| **Fee Asset Handler** | N/A | [`0x5602c39a6e9c5ace589f64f754927bcda4f4bfc9`](https://sepolia.etherscan.io/address/0x5602c39a6e9c5ace589f64f754927bcda4f4bfc9) | +| **Coin Issuer** | [`0x02fadf157d551aa6d761b2a2237d03af68e41ca6`](https://etherscan.io/address/0x02fadf157d551aa6d761b2a2237d03af68e41ca6) | [`0xe05d0a62045b4237556c1ec423e59eea9a24eaee`](https://sepolia.etherscan.io/address/0xe05d0a62045b4237556c1ec423e59eea9a24eaee) | +| **Reward Distributor** | [`0x3d6a1b00c830c5f278fc5dfb3f6ff0b74db6dfe0`](https://etherscan.io/address/0x3d6a1b00c830c5f278fc5dfb3f6ff0b74db6dfe0) | [`0x030d2780e70f085c31d490268d3900d4cea16606`](https://sepolia.etherscan.io/address/0x030d2780e70f085c31d490268d3900d4cea16606) | +| **Reward Booster** | [`0x7101a6703491a4d808aeabe9f62bc1dc6a20bdf4`](https://etherscan.io/address/0x7101a6703491a4d808aeabe9f62bc1dc6a20bdf4) | [`0x49711056D1EaDcDD3F2eF676DC8EA3F924fB916c`](https://sepolia.etherscan.io/address/0x49711056D1EaDcDD3F2eF676DC8EA3F924fB916c) | +| **Governance Proposer** | [`0x06ef1dcf87e419c48b94a331b252819fadbd63ef`](https://etherscan.io/address/0x06ef1dcf87e419c48b94a331b252819fadbd63ef) | [`0x01c7d4ca153748d2377968fef22894cb162e9480`](https://sepolia.etherscan.io/address/0x01c7d4ca153748d2377968fef22894cb162e9480) | +| **Governance** | [`0x1102471eb3378fee427121c9efcea452e4b6b75e`](https://etherscan.io/address/0x1102471eb3378fee427121c9efcea452e4b6b75e) | [`0xcaf7447721447b22cd0076ac7c63877c3afd329f`](https://sepolia.etherscan.io/address/0xcaf7447721447b22cd0076ac7c63877c3afd329f) | +| **Governance Staking Escrow** | [`0xa92ecfd0e70c9cd5e5cd76c50af0f7da93567a4f`](https://etherscan.io/address/0xa92ecfd0e70c9cd5e5cd76c50af0f7da93567a4f) | [`0xb6a38a51a6c1de9012f9d8ea9745ef957212eaac`](https://sepolia.etherscan.io/address/0xb6a38a51a6c1de9012f9d8ea9745ef957212eaac) | +| **Staking Registry** | [`0x042dF8f42790d6943F41C25C2132400fd727f452`](https://etherscan.io/address/0x042dF8f42790d6943F41C25C2132400fd727f452) | [`0xC6EcC1832c8BF6a41c927BEb4E9ec610FBeDd1C2`](https://sepolia.etherscan.io/address/0xC6EcC1832c8BF6a41c927BEb4E9ec610FBeDd1C2) | +| **Slash Factory** | N/A | [`0x9CF4a0094c8696d5110dd0f0cF3FA5deA174BB17`](https://sepolia.etherscan.io/address/0x9CF4a0094c8696d5110dd0f0cF3FA5deA174BB17) | +| **Slasher** | [`0x64E6e9Bb9f1E33D319578B9f8a9C719Ca6D46eBb`](https://etherscan.io/address/0x64E6e9Bb9f1E33D319578B9f8a9C719Ca6D46eBb) | [`0xf6D0D42aCE06829bECB78C74F49879528fC632c1`](https://sepolia.etherscan.io/address/0xf6D0D42aCE06829bECB78C74F49879528fC632c1) | +| **Tally Slashing Proposer** | [`0x7a318c3daa9f21f8fc8238c65755eb0394fbf189`](https://etherscan.io/address/0x7a318c3daa9f21f8fc8238c65755eb0394fbf189) | [`0x158eCC4B24675dc399031c7D144786e3da2060A8`](https://sepolia.etherscan.io/address/0x158eCC4B24675dc399031c7D144786e3da2060A8) | +| **Honk Verifier** | N/A | [`0x800FbC88054ba6c228B7d822F1DCAf4d627E8F97`](https://sepolia.etherscan.io/address/0x800FbC88054ba6c228B7d822F1DCAf4d627E8F97) | +| **Register New Rollup Version Payload** | N/A | [`0x11f7Ab2324CA94af929A388477a7959E0108C3d6`](https://sepolia.etherscan.io/address/0x11f7Ab2324CA94af929A388477a7959E0108C3d6) | +| **Slash Payload Cloneable** | N/A | [`0xe66d9eeBfF5490E6bfA263cF08028dE7d265321F`](https://sepolia.etherscan.io/address/0xe66d9eeBfF5490E6bfA263cF08028dE7d265321F) | | ### L2 Contract Addresses -| Contract Name | Alpha (Mainnet) | Testnet | -|---------------|-------------------|---------| -| **Instance Registry** | `0x0000000000000000000000000000000000000000000000000000000000000002` | `0x0000000000000000000000000000000000000000000000000000000000000002` | -| **Class Registry** | `0x0000000000000000000000000000000000000000000000000000000000000003` | `0x0000000000000000000000000000000000000000000000000000000000000003` | +| Contract Name | Alpha (Mainnet) | Testnet | +| ------------------------ | -------------------------------------------------------------------- | -------------------------------------------------------------------- | +| **Instance Registry** | `0x0000000000000000000000000000000000000000000000000000000000000002` | `0x0000000000000000000000000000000000000000000000000000000000000002` | +| **Class Registry** | `0x0000000000000000000000000000000000000000000000000000000000000003` | `0x0000000000000000000000000000000000000000000000000000000000000003` | | **MultiCall Entrypoint** | `0x0000000000000000000000000000000000000000000000000000000000000004` | `0x0000000000000000000000000000000000000000000000000000000000000004` | -| **Fee Juice** | `0x0000000000000000000000000000000000000000000000000000000000000005` | `0x0000000000000000000000000000000000000000000000000000000000000005` | -| **SponsoredFPC** | Not deployed | `0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923c` | +| **Fee Juice** | `0x0000000000000000000000000000000000000000000000000000000000000005` | `0x0000000000000000000000000000000000000000000000000000000000000005` | +| **SponsoredFPC** | Not deployed | `0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923c` | ## Governance Parameters -| Parameter | Alpha (Mainnet) | Testnet | -|-----------|-------------------|---------| -| **Proposer Quorum** | 600/1000 | 60/100 | -| **Voting Delay** | 3 days | 12 hours | -| **Voting Duration** | 7 days | 24 hours | -| **Execution Delay** | 7 days | 12 hours | -| **Slashing Quorum** | 65% | 33% | -| **Slashing Round Size** | 128 epochs | 64 epochs | - -## Use Case Suitability - -| Use Case | Alpha (Mainnet) | Testnet | -|----------|-------------------|---------| -| **App Development** | ❌ | ✅ | -| **Sequencer Testing** | ✅ | ✅ | -| **Governance Testing** | ✅ | ✅ | +| Parameter | Alpha (Mainnet) | Testnet | +| ----------------------- | --------------- | --------- | +| **Proposer Quorum** | 600/1000 | 60/100 | +| **Voting Delay** | 3 days | 12 hours | +| **Voting Duration** | 7 days | 24 hours | +| **Execution Delay** | 7 days | 12 hours | +| **Slashing Quorum** | 65% | 33% | +| **Slashing Round Size** | 128 epochs | 64 epochs | --- @@ -101,12 +93,14 @@ Alpha is the Aztec **mainnet** in its initial operational phase, with governance Alpha is connected to Ethereum mainnet and supports user transactions. Governance and staking infrastructure are fully operational. This network requires real stakes for sequencer participation. **Target Users:** + - Validators who want to contribute to the decentralized Aztec Network - Governance participants - Developers deploying production applications - Infrastructure operators **Key Features:** + - Governance system fully operational - Staking required for sequencer participation - Connected to Ethereum Mainnet @@ -123,12 +117,14 @@ Testnet is the production path for Aztec. It operates as a fully decentralized n Testnet is ideal for testing node configurations, governance proposals, and understanding network dynamics without real financial risk. **Target Users:** + - Future Alpha sequencer operators testing configurations - Developers requiring production-like testing conditions - Governance participants practicing proposal workflows - Infrastructure operators validating monitoring setups **Key Features:** + - Fully decentralized sequencer set - Connected to Ethereum Sepolia - Transactions are proven