🤔 Got questions? Schedule an office hours session.
Virtual TestNets
CI/CD
Stage Contracts

Stage Contracts on TestNets

Deploy the latest code and to Virtual TestNets make it available for your team by sharing the RPC link and contract addresses.

Tenderly Docs
Continuous integration (CI) and continous deployment (CD) with Virtual TestNets
Code Sample: Staging Contracts to Virtual TestNet
REST API: Create and manage Virtual TestNets

Create a TestNet

Create a new Virtual TestNet to stage your contracts, either by:

Set up environment variables

To create a Virtual TestNet and then deploy and verify contracts, set up the following environment variables:

  • TENDERLY_ACCOUNT_ID with your account ID
  • TENDERLY_PROJECT with your project (slug)
  • TENDERLY_ACCESS_KEY with the access key you’ve generated
  • ORIGINAL_NETWORK_ID with the ID of the network you want to base the TestNet on
  • FOUNDRY_REPO with the path to Foundry repo
  • DEPLOYER_ADDRESS with the account you’re deploying from
  • Add other environment variables needed for the deployment scripts
export TENDERLY_ACCOUNT_ID=<USERNAME>
export TENDERLY_PROJECT=<PROJECT>
export TENDERLY_ACCESS_KEY=<ACCESS_KEY>
 
## TestNet Configuration
export TENDERLY_TESTNET_NAME=staging
export PURPOSE=development
export ORIGINAL_NETWORK_ID=1
export BLOCK_NUMBER=latest
 
## Custom Chain ID (Prefixed with 7357 - test)
export CHAIN_ID=7357$ORIGINAL_NETWORK_ID
 
## Public explorer verification visibility
## abi | full | none
export VERIFICATION_VISIBILITY=abi
 
# Foundry Repo (Absolute path only!)
export FOUNDRY_REPO=<ABSOLUTE PATH TO FOUNDRY PROJECT>
 
## Deployer address
export DEPLOYER_ADDRESS=...
 
## Custom stuff needed for deployment scripts
## Add your custom stuff here
export ADMIN_ADDRESS=...

Write your deployment commands

Edit deploy-command.sh and add commands to deploy your contracts. Note you’ll have to add verification to your Foundry or Hardhat project.

For example:

#!/bin/bash
 
cd $FOUNDRY_REPO
 
## TODO: Your deployment command here:
MAX_SEGMENT_COUNT=3
 
FOUNDRY_PROFILE=optimized \
forge script script/DeployCore.s.sol \
  --broadcast \
  --rpc-url $TENDERLY_VIRTUAL_TESTNET_RPC \
  --sig "run(address)" \
  --verify \
  --verifier-url $VERIFICATION_URL \
  $ADMIN_ADDRESS

Stage contracts

Run the following commands that will:

  • create a new Virtual TestNet
  • fund the $DEPLOYER_ADDRESS with test ETH using the Infinite faucet
  • configure Foundry’s foundry.toml for verification on your custom chain
  • deploy your contracts
  • and finally clean up foundry.toml
# create a testnet - or paste the Unlocked TestNet RPC URL
source src/contracts-staging/.env
cd src/contracts-staging
 
## Create a fresh testnet
export VIRTUAL_NETWORK_RPC_URL=$(./create-testnet.sh)
echo "Created a Virtual TestNet at ${VIRTUAL_NETWORK_RPC_URL}"
 
### run the deployment
./deploy-to-testnet.sh

The RPC Link is shown in the output, and your contracts are deployed and verified on the Virtual TestNet.

Share the addresses

Collect the ABIs and addresses of deployed contracts and distribute them to your team, together with TestNet RPC.

Foundry & Github ActionsStage Dapps