cartesi-coprocessor-nonodox

README

A tool for developing Cartesi Coprocessor applications

This tool aims to be an iterative development environment for Cartesi Coprocessor applications

Table of Contents

• Overview
• Getting Started
  • Prerequisites
  • Installation
  • Running

Overview

This is an iterative tool designed to accelerate the "debugging" and "development" process of applications using the Cartesi Coprocessor infrastructure, providing a faster path to the production environment.

Getting Started

Prerequisites

1. Foundry
2. Nonodo

Installation

• Install the binary:

1. Go to latest release page and download the archive for your host platform;
2. Extract the archive;
3. Run <> and you are done!

Quick example of running <> on any Linux amd64:

• Install the package with golang:

go install github.com/Mugen-Builders/cartesi-coprocessor-nonodox/cmd/nonodox@latest

[!WARNING] The command above installs NoNodoX into the bin directory inside the directory defined by the GOPATH environment variable. If you don't set the GOPATH variable, the default install location is $HOME/go/bin. So, to call the nonodox command directly, you should add it to the PATH variable. The command below exemplifies that.

export PATH="$HOME/go/bin:$PATH"

Running

1. Download the state file (.json) and start the anvil instance:

curl -O https://raw.githubusercontent.com/Mugen-Builders/cartesi-coprocessor-nonodox/refs/heads/main/anvil_state.json
anvil --load-state anvil_state.json

[!CAUTION] Before running the command below, please make sure that you have deployed the CoprocesorAdapter instance, passing 0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE as the coprocessor address to its constructor

1. Running the tool:

nonodox

[!NOTE] Before running the command below, ensure you have created a .toml file and set the environment variables correctly. Below is the structure of the content that should be included in the file:

[anvil]
http_url = "http://127.0.0.1:8545"
ws_url = "ws://127.0.0.1:8545"
private_key = "<private-key-without-0x>" 
input_box_block = "7"