Installation & Setup

Prerequisites

• Operating System: Linux, MacOS
• Go v1.24 or higher (when building from source)
• NPM & Node v20 or higher (if you wish to run relayer in the same machine)
• Docker and Docker Compose
  • For macOS: Install Docker Desktop from https://www.docker.com/products/docker-desktop/
  • For Linux: Install Docker Engine and Docker Compose from https://docs.docker.com/engine/install/
  • Verify: docker --version and docker compose version
• LZ4 compression tool
  • For macOS: brew install lz4
  • For Ubuntu/Debian: apt-get install lz4

Installation

1. Get Weave Binary

   Homebrew (macOS)

   brew install initia-labs/tap/weave
   

   wget (linux)

   AMD64

   VERSION=$(curl -s https://api.github.com/repos/initia-labs/weave/releases/latest | grep '"tag_name":' | cut -d'"' -f4 | cut -c 2-)
   wget https://github.com/initia-labs/weave/releases/download/v$VERSION/weave-$VERSION-linux-amd64.tar.gz
   tar -xvf weave-$VERSION-linux-amd64.tar.gz
   

   ARM64

   VERSION=$(curl -s https://api.github.com/repos/initia-labs/weave/releases/latest | grep '"tag_name":' | cut -d'"' -f4 | cut -c 2-)
   wget https://github.com/initia-labs/weave/releases/download/v$VERSION/weave-$VERSION-linux-arm64.tar.gz
   tar -xvf weave-$VERSION-linux-arm64.tar.gz
   

   Build from source

   git clone https://github.com/initia-labs/weave.git
   cd weave
   VERSION=$(curl -s https://api.github.com/repos/initia-labs/weave/releases/latest | grep '"tag_name":' | cut -d'"' -f4 | cut -c 2-)
   git checkout tags/v$VERSION
   make install
   
2. Verify Installation

   weave version
   

   This should return the version of the Weave binary you have installed.

3. Quick Start

   To get started with Weave, run

   weave init
   

   It will ask you to set up the Gas Station account and ask which infrastructure you want to set up. After that, Weave will guide you through the setup process step-by-step.

   We recommend reading the Gas Station section to understand the purpose and usage of the Gas Station before proceeding.

By default, Weave collects non-identifiable usage data to help improve the product. If you prefer not to share this data, you can opt out by running the following command:

weave analytics disable

Next Steps

Bootstrapping Initia Node

Setup your Initia node and start syncing with the chain.

Launching Rollup

Configure and launch your own rollup.

Running IBC Relayer

Setup and run the IBC relayer. This is necessary for built-in oracle to work.

Running OPinit Bots

Set up the OPinit bots to complete the optimistic rollup setup.

or run

weave --help

to learn more about all the commands available.