Alonzo-testnet
This is the repository for the Cardano Alonzo testnet rollout program.
Here you will find a set of exercises and support material to use on the Alonzo testnet. We will gradually add materials to this repository through the testnet phases to help you understand the testnet and make use of its features.
The planned syllabus is outlined below. Exercises will be deployed here and linked from this page as they are finalised.
Target Audience
The exercises are designed to help those who are unfamiliar with the Cardano node to write and submit Plutus scripts on the Alonzo testnets using the node CLI, so that they can develop their own simple DApps. Those who are already familiar with the node may choose to skip some of the earlier exercises, of course. Note that there will be no Cardano wallet or Plutus application backend support prior to Alonzo Purple, so functionality will be limited compared with the full Plutus experience.
Useful Resources
Documentation
Instructions for installing the Cardano node (pre-compiled, cabal, nix & Docker)
Plutus Scripts and other useful Resources
Plutus Explainer (Technical Terminology)
Executable Nodes
Alonzo-1.30.1 node Linux binary
Alonzo-1.30.1 node MacOSX binary
Alonzo-1.30.1 node Windows binary
Alonzo-1.30.1 node Docker image
Network Configurations
Alonzo Purple and Cardano Testnet configuration files
Exercise 1: Getting Started
- Introduction to the Alonzo Testnet.
- Setting up a node to connect to the testnet.
- Obtaining test Ada.
Exercise 2: Hard Fork (Optional)
See an update proposal submitted to the chain and follow along as we go through the hard fork to the Alonzo era.
(Note that this may be a one-off event for each Testnet since we will need to start the network from scratch - the timing will be notified on the relevant Discord channel).
Exercise 3: Addresses and Transactions
- Managing payment addresses.
- Building, signing and submitting transactions on chain.
- Submitting a transaction containing a pre-built Plutus script.
Exercise 4: Compiling and Submitting Simple Plutus Scripts
- Compiling simple Plutus transactions.
- Submitting simple Plutus transactions.
- Calculating fees for Plutus transactions.
- Determining what effect your Plutus transactions have had on the blockchain.
Exercise 5: Managing Native Tokens
- Minting native tokens using both Mary-era forging scripts
- Minting native tokens using Plutus forging scripts
- Redeeming/burning native tokens
- Minting non-fungible tokens
- Time-based scripts
Exercise 6: DApps
- Building more substantial DApps
- Interacting with external events
Exercise 7: Interacting with the Wallet (Coming Soon)
- The Cardano Wallet CLI
- Submitting transactions with Plutus Scripts from the wallet CLI
- Some simple DApps using the wallet CLI
Feedback
We welcome feedback on any issues you have encountered:
-
Via the Discord channels for general questions or discussion.
-
Via the issue tracker at https://github.com/input-output-hk/cardano-node/issues for any bugs or feature requests in the node etc. Please tag them as Alonzo-related.
-
Via the issue tracker at https://github.com/input-output-hk/plutus/issues for any bugs or feature requests with plutus, playground, PAB etc.
-
Via the issue tracker at https://github.com/input-output-hk/Alonzo-testnet/issues for any issues with the exercises.
Can I join in if I don't yet have an invite to the IOG-run Testnet?
Yes, if you have sufficient technical expertise, you are more than welcome to set up your own private cluster and to try the exercises! We have provided sample solutions to help if you encounter problems and our tutorials and other documentation are all available for you to use. As we open up the Alonzo testnets, we will then be able to integrate you with other community users, including providing access to the Testnet Discord channels. We recommend that you follow the Alonzo Purple exercises. You may find the following setup guides useful.