Skip to main content
Version: Next

Migrating from Sandbox to Testnet

This guide assumes you have an Aztec app on sandbox and you wish to deploy it onto testnet. If you have never worked with sandbox or testnet, you might want to check out the getting started on testnet guide.

Main differences​

  • The testnet is a remote environment. The sandbox runs locally. You will be running your contracts on a network of sequencers and other contracts and connecting to them via the Private Execution Environment (PXE).
  • The testnet always has proving enabled. Users will prove private transactions and network provers prove public execution of blocks. Proving may take longer on testnet
  • The testnet always has fees enabled. You will need to pay fees, or sponsor fees, when sending a transaction
  • Testnet block times are longer than sandbox (they are about 36 seconds on average, and much longer to settle on L1), so your transaction may take longer to mine and be included in a block
warning

The testnet is version dependent. It is currently running version 0.85.0-alpha-testnet.2. Maintain version consistency when interacting with the testnet to reduce errors.

Sandbox, nodes, and PXE​

To connect a local PXE to testnet, install the testnet version of the sandbox.

VERSION=0.85.0-alpha-testnet.2 aztec-up

When you run aztec-wallet commands, make sure to include a node-url option. An example:

export NODE_URL=http://34.107.66.170
aztec-wallet create-account -a main --register-only --node-url $NODE_URL

You can find a full flow in the getting started on testnet guide.

Instead of running a PXE locally, you can also use one directly with AztecJS in your app. For this, you will need to connect to an Aztec node and initialize the PXE.

In the browser:

import { createPXEService } from "@aztec/pxe/client/lazy";

In Node.js

import { createPXEService } from "@aztec/pxe/server";

Then initialize the PXE:

const pxe = await createPXEService(node, pxeConfig);

Paying for fees​

There are multiple ways to pay for fees on testnet:

  • The user pays for their own (in which case you will need to send them tokens, or get them to use the faucet)
  • It is sponsored by your own contract
  • It is sponsored by the canonical sponsored fee payment contract (FPC) deployed to testnet

You will need to specify the fee-payer for all transactions. An example using aztec-wallet:

aztec-wallet create-account --payment method=fee_juice,feePayer=main --node-url $AZTEC_NODE

An example using Aztec.js:

const receiptForBob = await bananaCoin
  .withWallet(bobWallet)
  .methods.transfer(alice, amountTransferToAlice)
  .send({ fee: { paymentMethod: sponsoredPaymentMethod } })
  .wait();

To learn more about using the faucet or the sponsored fee payment method, read the full fees guide here.

Some things to note​

  • All contracts, including account contracts and the sponsored FPC, will need to be registered in the PXE
  • There will be no 'test accounts' automatically deployed, so you may need to change your Aztec.js scripts and tests
  • Transactions take longer to be mined on testnet than in sandbox, so you may see timeout errors. The transaction is still sent and is still visible on a block explorer - it just needs more time for it to be mined. It is worth noting this when handling errors in your apps, so that users do not think their transaction has failed

Next Steps​

To play more with the Aztec testnet, check out these: