alonzo-testnet
alonzo-testnet simplifies deploying a private alonzo testnet.
SundaeSwap heavily leverages AWS and consequently, this tooling has been optimized to run in AWS.
Launch Stacks
Launch AWS Cloudformation stack in specified region. Each stack will spin up a single ec2 instance with a private alonzo testnet.
| Region Name | Region | |
|---|---|---|
| US East (N. Virginia) | us-east-1 |  |
| US East (Ohio) | us-east-2 | |
| US West (N. California) | us-west-1 | |
| US West (Oregon) | us-west-2 | |
| Asia Pacific (Mumbai) | ap-south-1 | |
| Asia Pacific (Osaka) | ap-northeast-3 | |
| Asia Pacific (Seoul) | ap-northeast-2 | |
| Asia Pacific (Tokyo) | ap-northeast-1 | |
| Europe (Ireland) | eu-west-1 | |
| Europe (London) | eu-west-2 | |
| Europe (Paris) | eu-west-3 | |
| Europe (Stockholm) | eu-north-1 | |
| South America (São Paulo) | sa-east-1 | |
Build the alonzo-testnet AMI
To create your testnet, begin by creating a custom AWS AMI for the testnet instance. First, create your variables file, variables.pkrvars.hcl. In it, you'll need
region = "your-region-here"
subnet_id = "your-subnet-here"
vpc_id = "your-vpc-here"
packer build -var-file="variables.pkrvars.hcl" cardano-node.pkr.hcl
The AMI contains:
- aws cli
- docker
- a complete nix development environment
- cardano-node built from source using the 1.29.0
Quickstart
Once the AMI has been built, launch an instance that has sufficient memory and CPU to run 3 nodes. It is recommended to use t3.xlarge at a minimum. The instance is built using Ubuntu 20.04 so the login will be ubuntu.
After you log in, you can start your testnet as follows:
bootstrap mkfiles
(nohup "${HOME}/alonzo-testnet/run/all.sh" 2>&1) > /dev/null &
Options
Use a custom testnet-magic
bootstrap mkfiles -m 31415
Increase the max transaction size
bootstrap mkfiles -n maxTxSize=32768
Increase the transaction fees
bootstrap mkfiles -n minFeeA=100 -n minFeeB=12
alonzo - no fee env
bootstrap mkfiles -m 31415 -n maxLovelaceSupply=10000000000000000 -n minFeeA=0
alonzo with 10m epoch
bootstrap mkfiles -m 31415 \
-n networkMagic=31415 \
-n maxLovelaceSupply=10000000000000000 \
-n maxTxSize=16384 \
-n minUTxOValue=1000000 \
-n minFeeB=155381 \
-n minFeeA=44 \
-n epochLength=600 \
--alonzo-del executionPrices \
--alonzo-set collateralPercentage=150 \
--alonzo-set executionPrices.prMem.denominator=10000 \
--alonzo-set executionPrices.prMem.numerator=577 \
--alonzo-set executionPrices.prSteps.denominator=10000000 \
--alonzo-set executionPrices.prSteps.numerator=721 \
--alonzo-set lovelacePerUTxOWord=34482 \
--alonzo-set maxBlockExUnits.exUnitsMem=50000000 \
--alonzo-set maxBlockExUnits.exUnitsSteps=40000000000 \
--alonzo-set maxCollateralInputs=3 \
--alonzo-set maxTxExUnits.exUnitsMem=10000000 \
--alonzo-set maxTxExUnits.exUnitsSteps=10000000000 \
--alonzo-set maxValueSize=5000
Additional Packages
The following additional packages have also been installed to facilitate integration into the development environment
- tailscale client, https://tailscale.com
- AWS EFS client, https://aws.amazon.com/efs/
