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

Executable Nodes

Alonzo-purple-1.0.1 node Linux binary

Alonzo-purple-1.0.1 node MacOSX binary

Alonzo-purple-1.0.1 node Windows binary

Alonzo-purple-1.0.1 node Docker image

Network Configurations

Alonzo Purple configuration files

Exercise 1: Getting Started

1. Introduction to the Alonzo Testnet.
2. Setting up a node to connect to the testnet.
3. Obtaining test Ada.

Exercise 1 (Model Solutions)

Instructions for using Docker with the Cardano node

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 2

Exercise 3: Addresses and Transactions

1. Managing payment addresses.
2. Building, signing and submitting transactions on chain.
3. Submitting a transaction containing a pre-built Plutus script.

Exercise 3 (Model Solution)

Exercise 4: Compiling and Submitting Simple Plutus Scripts

1. Compiling simple Plutus transactions.
2. Submitting simple Plutus transactions.
3. Calculating fees for Plutus transactions.
4. Determining what effect your Plutus transactions have had on the blockchain.

Exercise 4 (Model Solution)

Exercise 5: Managing Native Tokens

1. Minting native tokens using both Mary-era forging scripts
2. Minting native tokens using Plutus forging scripts
3. Redeeming/burning native tokens
4. Minting non-fungible tokens
5. Time-based scripts

Exercise 5 (Model Solution)

Exercise 6: DApps

1. Building more substantial DApps
2. Interacting with external events

Exercise 6(Model Solution)

Exercise 7: Interacting with the Wallet (Coming Soon)

1. The Cardano Wallet CLI
2. Submitting transactions with Plutus Scripts from the wallet CLI
3. Some simple DApps using the wallet CLI

Exercise 7 (Model Solution)

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.

How to launch a testnet

Scripts for setting up a testnet

How to Make a Shelley blockchain from scratch