deroll

Deroll, a TypeScript framework, facilitates the development of decentralized applications (dApps) on the Cartesi blockchain technology. With a focus on simplicity, Deroll offers a toolkit and conventions to streamline your development workflow. Easily onboard using Node.js and Deroll to start building your Cartesi application with ease.

Quick Start

Prerequisites

Ensure you have Node.js and Yarn installed; you can download them from nodejs.org and yarnpkg.com. Additionally, it's necessary to install Cartesi CLI.

Create a new project with the TypeScript template

cartesi create hello-world --template typescript

Add deroll to your project

cd hello-world
yarn add @deroll/app

Write a simple Cartesi application

Open the file src/index.ts and copy and paste the following code:

// Import necessary modules
import { createApp } from "@deroll/app";

// Create the application
const app = createApp({
    url: process.env.ROLLUP_HTTP_SERVER_URL || "http://127.0.0.1:5004",
});

// Handle input encoded in hex
app.addAdvanceHandler(async ({ payload }) => {
    const hexString = payload.replace(/^0x/, "");
    const buffer = Buffer.from(hexString, "hex");

    // Convert the buffer to a UTF-8 string
    const utf8String = buffer.toString("utf8");
    console.log(utf8String);
    return Promise.resolve("accept");
});

// Start the application
app.start().catch((e) => {
    console.error(e);
    process.exit(1);
});

Build and run your dApp

cartesi build
cartesi run

Expected output:

prompt-1     | Anvil running at http://localhost:8545
prompt-1     | GraphQL running at http://localhost:8080/graphql
prompt-1     | Inspect running at http://localhost:8080/inspect/
prompt-1     | Explorer running at http://localhost:8080/explorer/
prompt-1     | Press Ctrl+C to stop the node

Send a message

Open a new terminal and run:

cartesi send

1. Choose Send generic input to the application.
2. After choose Foundry
3. Select the defaults:
   1. Select the RPC URL http://127.0.0.1:8545
   2. Select Mnemonic
   3. Account, DApp address
4. Select Input String encoding and in the input type Hello world! and hit enter.

Expected output:

cartesi send
? Select send sub-command Send generic input to the application.
? Chain Foundry
? RPC URL http://127.0.0.1:8545
? Wallet Mnemonic
? Mnemonic test test test test test test test test test test test junk
? Account 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 9999.969240390387558666 ETH
? DApp address 0x70ac08179605AF2D9e75782b8DEcDD3c22aA4D0C
? Input String encoding
? Input (as string) Hello world!
✔ Input sent: 0xebd90fe6fd50245dfa30f33e2d68236a73b25e2351106484cfa9d815e401939d

Expected output in the cartesi run terminal:

prompt-1     | Anvil running at http://localhost:8545
prompt-1     | GraphQL running at http://localhost:8080/graphql
prompt-1     | Inspect running at http://localhost:8080/inspect/
prompt-1     | Explorer running at http://localhost:8080/explorer/
prompt-1     | Press Ctrl+C to stop the node
validator-1  | [INFO  rollup_http_server::http_service] Received new request of type ADVANCE
validator-1  | [INFO  actix_web::middleware::logger] 127.0.0.1 "POST /finish HTTP/1.1" 200 224 "-" "undici" 0.000960
validator-1  | Hello world!

Now you're ready to start building your Cartesi application with cartesi and deroll!

Build from source

Requirements

• Corepack (with pnpm) or pnpm v8 (8.7.1 recommended)
• Node 20 or greater (LTS)

Installation

Corepack is a package manager that allows you to install packages from different package managers. It is recommended to use it to install deroll because it come with nodejs. But you can use pnpm if you want. To install corepack follow the instructions here.

corepack install
corepack pnpm install

Build

npm run build

How to contribute

TODO

License

This code is licensed under the MIT License.