1 of 7

Get started here!!

Get started with Lilypad v1

The cloud is just somebody else's computer...

Overview

This guide will take you through

Setting up Metamask Wallet for the Lilypad Lalechuza (eth) Testnet
Funding your wallet with Lilypad Testnet tokens from the faucet.

Setting up Metamask

Connecting to LaLechuza Testnet

Setting up Metamask

Install MetaMask Extension here
Next, add the Lalechuza testnet chain to MetaMask.

Network name: Lilypad Lalechuza testnet

New RPC URL: http://testnet.lilypadnetwork.org:8545

Chain ID: 1337

Currency symbol: lilETH

Block explorer URL: (leave blank)

To do this, open MetaMask then click on the network button at the top left of the popup (in the menu bar):

``

Then click the "Add Network" Button.

Next, click on "Add a network manually" at the bottom of the page and enter the Lilypad Testnet details:

Funding your Wallet from Faucet

With testnet Lilypad ETH

Funding your wallet

To obtain funds, connect to the Lilypad Lalechuza network on your wallet and head to the faucet at http://faucet.lilypad.tech

Faucet: http://faucet.lilypad.tech

Copy your MetaMask wallet address into the bar and click request.

[CLI] Install Run Requirements

Docker & Lilypad, Private Key

Install Requirements

Supported platforms: Linux, macOS, WSL2 on both x86_64 and arm64

Install Docker

installed & running

Install Lilypad CLI in your terminal / command line

Add your private key to your terminal / command line instance:

Get your private key from MetaMask: Accounts -> Account Details -> Show private key

Set your private key in terminal

You can verify you have set it with:

[CLI] Run "Hello, World!" Job

A cowsay job

The following is how to run the "Hello, World!" Job from the Lilypad CLI.

To Run from a smart contract skip to the section [Smart Contract] Run "Hello, World!" Job

Run Hello, World! Job

Start Docker
Open a Terminal window and run the following command:

lilypad run cowsay:v0.0.1 "hello lilypad"

Ensure your user is in the docker group if necessary on your platform

Results:

See the Results

Navigate to the IPFS CID result output in the Results -> https://ipfs.io/ipfs/QmNjJUyFZpSg7HC9akujZ6KHWvJbCEytre3NRSMHzCA6NR

Patience! This could take up to a minute to propagate through the IPFS network.

Then click on the stdout folder and you should see the job result!

[Smart Contract] Run "Hello, World!" Job

How to run a cowsay job from a Smart contract!

Remix

Open the Contract

Click to open the ExampleClient.sol contract in remix

Alternatively, open in your browser and copy in the below ExampleClient.sol :

Connect to the Testnet

Connect MetaMask to the Lalechuza testnet & ensure you have testnet lilETH funds.
In the deploy tab in remix [fourth tab in the side bar], ensure you set the environment to "Injected Provider - MetaMask"

Deploy the Contact In remix, compile the ExampleClient.sol contract [third tab in the side bar]

Deploy an existing ExampleClient.sol contract by using the "At Address" with the following pre-deployed contract address: 0x035C7593D3355b9bE0459dF2296053f887d051f1

Call the runCowsay function

The moment of truth! Let's run the cowsay example!!

Then add the string parameter for what you want the cow to say and click the transact button! Your MetaMask wallet should pop up asking you to confirm the transaction.

Wait a couple of minutes for the job to complete on the compute network. Then you will be able to click the fetchAllResults button to get your IPFS CID result.

Open the string starting with "https://ipfs.io/" in your browser which contains the output of the compute job:

The cowsay result is found under "stdout"

Congrats!

Run "Hello, World" Node

Run a node to provide job services

Currently runs on Linux, macOS, WSL2 - but only x86_64 architectures

Run Hello, World! Node

To contribute your resources to the network and get paid:

sudo -E lilypad serve

That's it! This will run a Lilypad docker node on your local machine which can accept and run jobs.

Resource Provider Flow

As a resource provider:

I register my resource offer and send my deposit against that single offer
The offer is matched with a job and I run the job
if I ran the job properly - I get my deposit back AND the cost of the job
if I was caught cheating - I will lose my deposit

[Smart Contract] Run "Hello, World!" Job

How to run a cowsay job from a Smart contract!

Remix

Open the Contract

Click to open the ExampleClient.sol contract in remix

Alternatively, open in your browser and copy in the below ExampleClient.sol :

Connect to the Testnet

Connect MetaMask to the Lalechuza testnet & ensure you have testnet lilETH funds.
In the deploy tab in remix [fourth tab in the side bar], ensure you set the environment to "Injected Provider - MetaMask"

Deploy the Contact In remix, compile the ExampleClient.sol contract [third tab in the side bar]

Deploy a new contract by pasting in the Modicum contract address () to the constructor

Deploy an existing ExampleClient.sol contract by using the "At Address" with the following pre-deployed contract address: 0x035C7593D3355b9bE0459dF2296053f887d051f1

Call the runCowsay function

The moment of truth! Let's run the cowsay example!!

First, ensure you set remix to pay 2 lilETH to the function by setting the "value" field

Then add the string parameter for what you want the cow to say and click the transact button! Your MetaMask wallet should pop up asking you to confirm the transaction.

Wait a couple of minutes for the job to complete on the compute network. Then you will be able to click the fetchAllResults button to get your IPFS CID result.

See the Results

Open the string starting with "https://ipfs.io/" in your browser which contains the output of the compute job:

The cowsay result is found under "stdout"

Congrats!

// SPDX-License-Identifier: GPLv3
pragma solidity ^0.8.6;

interface ModicumContract {
  function runModuleWithDefaultMediators(string calldata name, string calldata params) external payable returns (uint256);
}

// Payment is 2 lilETH for all jobs currently
// got to testnet.lilypadnetwork.org to fund your wallet
contract ExampleClient {
  address public _contractAddress;
  ModicumContract remoteContractInstance;

  uint256 public lilypadFee = 2;

  struct Result {
      uint256 jobID;
      string cid;
      string httpString;
  }

  Result[] public results;

  event ReceivedJobResults(uint256 jobID, string cid);

  // The Modicum contract address is found here: https://github.com/bacalhau-project/lilypad-modicum/blob/main/latest.txt
  // Current: 0x422F325AA109A3038BDCb7B03Dd0331A4aC2cD1a
  constructor (address contractAddress) {
    require(contractAddress != address(0), "NaiveExamplesClient: contract cannot be zero address");
    _contractAddress = contractAddress;
    remoteContractInstance = ModicumContract(contractAddress);
  }

  function setLilypadFee(uint256 _fee) public {
      lilypadFee = _fee;
  }
  
  function runCowsay(string memory sayWhat) public payable returns (uint256) {
    require(msg.value == lilypadFee * 1 ether, string(abi.encodePacked("Payment of 2 Ether is required")));
    return runModule("cowsay:v0.0.1", sayWhat);
  }

  function runStablediffusion(string memory prompt) public payable returns (uint256) {
    require(msg.value == lilypadFee * 1 ether, string(abi.encodePacked("Payment of 2 Ether is required")));
    return runModule("stable_diffusion:v0.0.1", prompt);
  }

  function runSDXL(string memory prompt) public payable returns (uint256) {
    require(msg.value == lilypadFee * 1 ether, string(abi.encodePacked("Payment of 2 Ether is required")));
    return runModule("sdxl:v0.9-lilypad1", prompt);
  }

 function runModule(string memory name, string memory params) public payable returns (uint256) {
    require(msg.value == lilypadFee * 1 ether, string(abi.encodePacked("Payment of 2 Ether is required")));
    return remoteContractInstance.runModuleWithDefaultMediators{value: msg.value}(name, params);
  }

  // Implemented Modicum interface. This saves results to a results array
  function receiveJobResults(uint256 _jobID, string calldata _cid) public {
    Result memory jobResult = Result({
        jobID: _jobID,
        cid: _cid,
        httpString: string(abi.encodePacked("https://ipfs.io/ipfs/", _cid))
    });
    results.push(jobResult);

    emit ReceivedJobResults(_jobID, _cid);
  }

  function fetchAllResults() public view returns (Result[] memory) {
    return results;
  }
}