How to Use Madara with Avail

Introduction

Embark on setting up your own Madara-based Validium, leveraging Avail as the data availability layer. This guide is tailored for deploying on Ethereum's Sepolia testnet and integrating with the Avail Goldberg testnet. To gain a comprehensive understanding of Madara Starknet, review the Madara documentation (opens in a new tab).

In this guide, you will conduct the following:

• Introduction
• Prerequisites
  • Hardware Requirements
• Launch an Avail-Powered Madara Validium
  • Running a Single-Node Development Chain
  • Setting Up Avail as the DA Layer
  • Deploying an Account on Your Chain
  • Using Avail in Madara

Prerequisites

Ensure you have installed the following software.

Installation commands are based on Ubuntu 20.04 LTS:

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup toolchain install nightly
 
# Install nvm and Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
nvm install --lts
 
# Install Cairo
curl -L https://github.com/franalgaba/cairo-installer/raw/main/bin/cairo-installer | bash

Hardware Requirements

The Madara stack, being a StarkNet sequencer, has specific hardware requirements for efficient operation. These requirements are particularly important when integrating Avail as the DA Layer.

Launch an Avail-Powered Madara Validium

1. Clone the Madara repository:

   git clone git@github.com:keep-starknet-strange/madara.git
   cd madara

2. Build the chain in release mode:

   cargo build --release

Running a Single-Node Development Chain

1. Start the development chain:

   ./target/release/madara --dev

2. Purge the chain's state:

   ./target/release/madara purge-chain --dev

3. Start with detailed logging:

   RUST_BACKTRACE=1 ./target/release/madara -ldebug --dev

4. Create a plain chain spec:

   ./target/release/madara build-spec > ./infra/chain-sepcs/chain-spec-plain.json

Setting Up Avail as the DA Layer

1. Configure Avail for Madara:

   # Configuration for local Avail node
   cat > da-config.json <<EOF
   {
     "ws_provider": "ws://127.0.0.1:9945",
     "app_id": 0,
     "validate_codegen": false,
     "seed": "//Alice"
   }
   EOF

2. Start Avail Node (in another terminal):

   ./data-avail --dev --rpc-port 9945 --port 30334

3. Setup Madara for Avail:

   ./madara setup --chain=dev --from-remote --base-path=../.madara

4. Launch Madara with Avail:

   ./madara --chain=dev --base-path=../.madara --da-layer=avail --force-authoring --alice

Deploying an Account on Your Chain

• After setting up your chain, you can deploy your own account and start making transactions.

Using Avail in Madara

• Specify --da-layer avail when launching a Madara node to use Avail for publishing the state_diff.