Skip to main content

Marlowe starter kit

To jumpstart your Marlowe contract creation, fork and clone the Marlowe starter kit repository.

Introduction​

The Marlowe starter kit aims to offer comprehensive tutorials for developers looking to experiment with simple Marlowe contracts on the Cardano blockchain.

If you are unfamiliar with the Marlowe language, you may want to experiment with the Marlowe Playground before diving into the starter kit.

Lessons​

Basic Operations​

  1. Using Marlowe Runtime's CLI -- a step-by-step guide to creating zero-coupon bonds using Marlowe Runtime's command-line interface.

  2. Using Marlowe Runtime's REST API -- a step-by-step guide to creating zero-coupon bonds using Marlowe Runtime's REST API interface.

Contracts​

  1. Zero-coupon bond using Marlowe's CLI -- demonstrates the steps for creating a zero-coupon bond using Marlowe's command-line interface.

  2. Escrow using Marlowe Runtime's REST API -- demonstrates how to use Marlowe Runtime's REST API to create an escrow contract.

  3. Swap of Ada for Djed using Marlowe Runtime's REST API -- a token-swap example contract that lets parties trade ada for a token. In this example the contract uses role tokens for authorization and Runtime mints them.

  4. Simple web application using a CIP-30 wallet -- shows how to use a Babbage-compatible CIP-30 wallet, such as Nami, to sign Marlowe transactions.

Safety & Testing​

  1. Checking the safety of a Marlowe contract -- a tutorial that shows how to use one of the three tools for checking the safety of a contract before submitting it to the blockchain.

Additional Topics​

  1. Experimental web application using a CIP-45 wallet -- an example that shows how to use a CIP-45 wallet, such as Eternl, to sign Marlowe transactions.

  2. Minting with Marlowe tools -- demonstrates how to mint Cardano native tokens usign Marlowe's CLI tool and how to use such tokens in a Marlowe contract.