Fuelmint documentation

Introduction

Fuel

Fuel is an execution layer for the modular stack.

Fuel is an execution layer in modular blockchains that provides a fast and efficient solution to scalability. It aims to address the scalability crisis in Ethereum, which has seen modest increase in total throughput with L2 solutions. Fuel is designed to leverage the shift in L1 blockchain architectures from monolithic to modular, where execution is separated from data availability and consensus, leading to increased bandwidth capacity.

Fuel has three key components:

• Parallel transaction execution
• The Fuel virtual machine
• A great developer experience

Fuel provides a flexible throughput with high security and is considered as the engine for the autonomous future, where individuals and groups can access verifiable autonomous systems.

Learn about Fuel here.

Celestia

Celestia is a modular blockchain network whose goal is to build a scalable data availability layer, enabling the next generation of scalable blockchain architectures - modular blockchains.

You can learn more about Celestia in our concepts and build modular pages.

Fuelmint

Fuelmint is a sovereign FuelVM rollups on Celestia using Rollkit and ABCI (Application BlockChain Interface). You can read the announcement blog post here.

In this tutorial, we will show you how to setup Fuelmint, so you can test out the advantages of using Sway while having a sovereign rollup on Celestia.

Let's get started!

Installation

Dependencies

You will need to install the following dependencies on your machine to be able to setup Fuelmint.

• Install Rust and Cargo
• Install Docker
• Install system environment setup for Linux AMD, including Golang
• Install Node.js and NPM

caution

This tutorial has only been tested on Ubuntu LTS on an AMD machine.

Setup Fuelmint

You can find the Fuelmint Repo on GitHub here.

The first step is to clone the Fuelmint repo:

git clone https://github.com/Ferret-san/fuelmint.git

Then, go to the Docker directory:

cd fuelmint/local-da

You can start by running a Docker compose setup with a local data availability (DA) network:

docker compose -f ./docker/test-docker-compose.yml up

In a separate terminal session, you must build the Fuelmint binary with cargo:

note

If this is your first time running cargo to build the Fuelmint binary, it will take some time to install all of the required dependencies.

cd $HOME
rm -rf ~/.fuel/db
cd fuelmint
cargo run --bin fuelmint

caution

When you restart Fuelmint, you will need to remove existing data from Fuelmint and Tendermint.

If you'd like to see the CLI menu for Fuelmint, run this command in the fuelmint directory:

cargo run --bin fuelmint -- --help

Save one of the private keys in the output from the command above, you'll be using this again later in the tutorial.

In another terminal session, you will need to build the Rollkit node with Golang:

cd fuelmint/rollkit-node
go build

In a new terminal clone and install rollkit/tendermint:

git clone https://github.com/rollkit/tendermint.git
cd tendermint
git checkout 8be9b54c8c21
make install

Then, run the following commands from the fuelmint/rollkit-node directory:

rm -rf /tmp/fuelmint/
TMHOME="/tmp/fuelmint" tendermint init
NAMESPACE_ID=$(echo $RANDOM | md5sum | head -c 16; echo;)
./rollkit-node -config "/tmp/fuelmint/config/config.toml" -rollkit.namespace_id $NAMESPACE_ID -rollkit.da_start_height 1

In another terminal, in the fuelmint/rollkit-node directory, view the CLI menu by running:

./rollkit-node -help

Deploy a Sway smart contract

Install Forc

• Install Forc

Counter smart contract

Find the Sway smart contracts here.

Let's deploy a Sway smart contract for counter! First, open a new terminal instance:

cd $HOME
cd fuelmint/examples/counter/contract
forc build
forc deploy --unsigned

This generates the contract-id. You will need to save this along with your private key from earlier in the tutorial and add it to your frontend demo below.

Open fuelmint/examples/counter/frontend/src/App.tsx in your text editor. Get the wallet secret generated when you started fuelmint, and replace it for the WALLET_SECRET on line 9 to allow you to send transactions on the frontend.

Then, replace the CONTRACT_ID with your contract ID from the output of your deployment.

Generate the front end with contract-id.

cd fuelmint/examples/counter/frontend
npm install
npm start

You can now view your counter at http://localhost:3000!

Run Fuelmint on Mocha

caution

Posting to Mocha and Arabica coming soon.

Run a Mocha light node and get it funded here. If you're running both nodes on the same machine (Rollkit and Celestia), you will need to add the --rpc.port string flag to the start command of your light node, similar to this:

celestia light start --core.ip https://rpc-mocha.pops.one --gateway --gateway.addr 127.0.0.1 --gateway.port 26659 --p2p.network mocha --rpc.port 36658

Then clear the existing database with your fuelmint binary:

cd $HOME
rm -rf ~/.fuel/db
cd fuelmint
cargo run --bin fuelmint

In a new terminal, we'll start the Rollkit node:

cd $HOME
cd fuelmint/rollkit-node
NAMESPACE_ID=$(echo $RANDOM | md5sum | head -c 16; echo;)
DA_BLOCK_HEIGHT=$(curl https://rpc-mocha.pops.one/block | jq -r '.result.block.header.height')

From the fuelmint/rollkit-node directory, run the following to clear existing configs and restart the chain on Mocha:

rm -rf /tmp/fuelmint/
TMHOME="/tmp/fuelmint" tendermint init
./rollkit-node -config "/tmp/fuelmint/config/config.toml" -rollkit.aggregator true -rollkit.da_layer celestia -rollkit.da_config='{"base_url":"http://localhost:26659","timeout":60000000000,"gas_limit":6000000,"fee":6000}' -rollkit.namespace_id $NAMESPACE_ID -rollkit.da_start_height $DA_BLOCK_HEIGHT 

You can find more smart contracts here.