This document describes how to set up a hosted version of the Marlowe Runtime services and Cardano node through demeter.run.
The demeter.run web3 development platform provides an extension, Cardano Marlowe Runtime, that has Marlowe tools installed. This extension provides the Marlowe Runtime backend services and a Cardano node, so you don't need to set environment variables, install tools or run backend services.
Visit demeter.run.
Sign in or create an account.
Along the top navigation bar, select Projects. The Projects panel displays.
Select NEW PROJECT +
The Project creation wizard displays.
Enter a project name in the Name field.
Enter a project description in the Description field.
Create an organization or select one if you have previously created an organization.
Select a cluster (US Central or Europe).
Select Create Project. The project dashboard displays.
Obtain DCUs (Demeter Compute Units) according to your project needs. For your first project, Demeter.run offers 6,000,000 free DCUs. Later, you will need to determine your payment method so you can purchase DCUs in the future.
Along the top navigation bar, select Extensions. The Extensions page displays.
Select Cardano Nodes. The Cardano Nodes Extensions panel displays.
Under the heading Shared instances, click the toggle switch corresponding to the Preview network instance. Initially it says Disconnected. After clicking the toggle switch, it says Connecting in orange. Once connected, it displays Connected in green.
At the top of the Cardano Nodes Extensions page, click Extensions to return to the list of Extensions.
From the list of extensions, select Cardano Marlowe Runtime. The Cardano Marlowe Runtime panel displays.
From the list of shared instances, click the toggle switch for the Preview network corresponding to the latest version of Marlowe Runtime. Initially it says Disconnected. After clicking the toggle switch, it says Connecting in orange. Once connected, it displays Connected in green.
At the top of the Cardano Marlowe Extensions page, click Extensions to return to the list of Extensions.
Now you will be able to use services from the Node and Runtime.
Along the top navigation bar, select Workloads. The Create workload page displays.
Under the Create workload heading, click Workspace. The Create Workspace page displays.
Under the heading "Are you cloning an existing repository?" click the toggle switch for "Activate to enter repository URL." Two fields display.
In the URL field, enter the URL for the Marlowe Starter Kit:
In the Branch field, leave the default value of "main" in place.
Scroll down the page until you see the heading Select your extras.
Under this heading, click Cardano Binaries. The Cardano Binaries item is highlighted to indicate it is selected.
Under the same heading, select Jupyter Notebook. The Jupyter Notebook item is highlighted to indicate it is selected.
Under the heading Select the Workspace Size, select Medium.
Under the heading Select the network to connect, select Preview.
Under the heading Advanced, in the Workspace name field, enter a name for your workspace.
Enter your name in the Git Author field.
Enter your email address in the Git Email field.
Click the Create button. You will return to the Demeter > Playground page.
Under the Dashboard heading, your new workspace is shown with the status of Provisioning. Demeter run is now provisioning your selected services.
In approximately one minute or so, the status of your new workspace will change to Running.
Just above the Running status message on the right side of the panel, click the VS Code icon located just above the word "RUNNING" to enter a VS Code window.
The prompt message Do you trust the authors of the files in this folder? displays. Select Yes, I trust the authors.
A view of the cloned version of the Marlowe Starter Kit displays. The folders and files are listed in a panel in the left side of the workspace.
From the left column, expand the item "lessons," then expand the folder "01-runtime-cli".
Select the first lesson: 01-runtime.cli.jpynb. This opens the file titled "Zero-Coupon Bond Using Marlowe Runtime's Command-Line Interface."
You have now completed the setup process for Demeter.run. Please proceed to following the guidance contained in lesson one.