Create a CosmWasm Rollup

Highly Recommended - Opt for Quicklaunch

We strongly advise utilizing the Quicklaunch option for creating a new Rollup, as opposed to manually following the detailed steps. Quicklaunch streamlines the process, ensuring simplicity and efficiency. Save time and reduce complexities by opting for Quicklaunch to set up your new Rollup seamlessly.

1. Clone GitHub Repositories

Start by cloning the necessary repositories from GitHub. Use the following commands in your terminal:

git clone https://github.com/airchains-network/wasm-station.git
git clone https://github.com/airchains-network/tracks.git

If you're utilizing EigenDA, there's no necessity to clone any repository. Otherwise, clone the respective repositories for the DA client you're using.

Avail

wget https://github.com/airchains-network/tracks/releases/download/v0.0.2/avail-light

Celestia

wget https://github.com/airchains-network/tracks/releases/download/v0.0.2/celestia

2. Setting Up and Running the CosmWasm Station

Installing Dependencies

After cloning the repository, navigate into the project directory.

cd wasm-station

Then, tidy up the Go modules to ensure that dependencies are properly managed.

go mod tidy

Running the Project

To run the CosmWasm Station project locally, execute the following command:

/bin/bash ./scripts/local-setup.sh

3. Setting Up DA Keys and Running DA Client

Avail

Generate DA KEY for Avail

Download the Binary to Generate Keys

wget https://github.com/airchains-network/tracks/releases/download/v0.0.2/avail-node

Give Permission to the Downloaded Binary

chmod +x ./avail-node

Generate DA Keys For Avail

SS58 Address is your DA Keys

  ./avail-node key generate
  
  Secret phrase:     sugar genuine grief already basic lend labor audit bread trip space limb
  Network ID:        substrate
  Secret seed:       0x519ca67ed47173559eb0414b489e727343d2d74743545b4b82037e8be7d61fa4
  Public key (hex):  0xd2748458725a993a7d359bb5d502630455591c75c9d220023f3a38c01a45857b
  Account ID:        0xd2748458725a993a7d359bb5d502630455591c75c9d220023f3a38c01a45857b
  Public key (SS58): 5GpeXSmsEPnwT785KyiCdaXmcttmFqyLkNPEjoTrjThwFhPQ
  SS58 Address:      

Running avail da with Custom Identity Configuration

If you possess a specific seed phrase and wish to use it instead of the generated one, you can either modify the default identity configuration file or pass the seed phrase as a flag.

• To modify the default identity configuration file, navigate to ~/.avail/identity/identity.toml and edit it using a text editor such as nano.

nano ~/.avail/identity/identity.toml

• Alternatively, you can create a new identity configuration file and specify your seed phrase. For example:

touch ~/identity.toml
nano ~/identity.toml

Then, execute the availup.sh script with the --identity flag and specify the path to your custom identity configuration file:

Example Identity Configuration

Attention: Using the seed phrase provided below in production environments is strongly discouraged.

Here is an example of the content for the ~/identity.toml file:

avail_secret_seed_phrase = 'sugar genuine grief already basic lend labor audit bread trip space limb'

This seed phrase will be used for identity generation during the execution of the availup.sh script.

Feel free to customize the identity configuration as needed!

Running avail da

To execute the avail da, use the following command:

avail-light --network "turing" --app-id 36 --identity ~/identity.toml

For obtaining Turing Testnet tokens, please visit the Faucet-Avail

Celestia

Initialize the light node

Run the following command:

celestia light init --p2p.network mocha

The output in your terminal will show the location of your node store and config. It will also show confirmation that the node store has been initialized.

Keys and wallets

Download the Binary to Generate Wallet

wget https://github.com/airchains-network/tracks/releases/download/v0.0.2/celestia-key

You can create your key for your node by running the following command with the celestia-key utility

celestia-key add <key-name> --keyring-backend test \
    --node.type light --p2p.network mocha

Generate Your DA Keys For Celestia

The Output is your DA Keys

celestia light auth admin --p2p.network mocha-4

Example Output

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBbGxvdyI6WyJwdWJsaWMiLCJyZWFkIiwid3JpdGUiLCJhZG1pbiJdfQ.Qs4iN4jFKk08pBgooEMYE-zXf-JEA8yu8OyRpO7n4hE

You can start your light node with the key created above by running the following command:

celestia light start --keyring.accname my_celes_key \
    --core.ip rpc-mocha.pops.one --p2p.network mocha

Once you start the light node, a wallet key will be generated for you. You will need to fund that address with testnet tokens to pay for PayForBlob transactions.

For guidance on obtaining Mocha Testnet tokens, please visit the mocha-testnet-tokens

Eigen

Download the Binary to Generate Keys

wget https://github.com/airchains-network/tracks/releases/download/v0.0.2/eigenlayer

Create and List Keys

eigenlayer operator keys create --key-type ecdsa [keyname]

Public Hex Key is the DA key

eigenlayer operator keys create --key-type ecdsa test
? Enter password to encrypt the ecdsa private key:
ECDSA Private Key (Hex):  b3eba201405d5b5f7aaa9adf6bb734dc6c0f448ef64dd39df80ca2d92fca6d7b
Please backup the above private key hex in safe place.

Key location: /home/ubuntu/.eigenlayer/operator_keys/test.ecdsa.key.json
Public Key hex:  
Ethereum Address 0x6a8c0D554a694899041E52a91B4EC3Ff23d8aBD5

4. Setting Up and Running Tracks

Remove Old Data

Before initiating the setup process, ensure that any old data is removed if present. Use the following command:

sudo rm -rf ~/.tracks

Installing Dependencies

After cloning the repository, navigate into the project directory.

cd tracks

Then, tidy up the Go modules to ensure that dependencies are properly managed.

go mod tidy

Initiate Sequencer

To initiate the sequencer, execute the following command:

go run cmd/main.go init --daRpc "da-rpc" --daKey "daKey" --daType "<da-type>" --moniker "<moniker-name>" --stationRpc "http://127.0.0.1:26657" --stationAPI "http://127.0.0.1:1317" --stationType "wasm"

Specify the DA type using the --daType flag with one of the following options:

• "avail" for Avail DA

• "celestia" for Celestia DA

• "eigen" for Eigen DA

• "mock" for Mock DA

The DA keys were defined in the section above when we were setting up the DA. Use the Da Keys Accordingly.

Da Key for Mock-Da is Mock-Key

List of DA RPC

For Avail and Celestia, you have to run their nodes locally.

• Eigen:- disperser-holesky.eigenda.xyz

• Avail:- http://127.0.0.1:7000

• Celestia:- http://127.0.0.1:26658

• MockDA:- mock-rpc

Create Keys for Junction

Generate keys for the Junction component using the following command:

go run cmd/main.go keys junction --accountName <account-name> --accountPath $HOME/.tracks/junction-accounts/keys

Fund Keys for Junction Testnet

Navigate to the Switchyard faucet in the Airchains Discord group and follow the provided steps to obtain Switchyard tokens for funding the keys.

Initiate Prover

Initiate the Prover component using the following command:

go run cmd/main.go prover v1EVM

Create Station on Junction

Create a station on the Junction component with the specified parameters using the following command:

go run cmd/main.go create-station --accountName <account-name> --accountPath $HOME/.tracks/junction-accounts/keys --jsonRPC "<junction-rpc>" --info "EVM Track" --tracks ["track-pilot-1-address","track-pilot-2-address",...] --bootstrapNode "<persistence_peer>"

In the --bootstrapNode parameter, input your persistence peer. Follow these steps to create your bootstrapNode persistence_peer with the node ID:

1. Locate the node ID in the ~/.track/config/seqencer.toml configuration file.

2. Copy the node ID from the configuration file.

3. Insert the copied node ID into the following string format:

"/ip4/<user-ip>/tcp/2300/p2p/<node_id>"

Replace <user-ip> with your actual IP address and <node_id> with the copied node ID.

This ensures that your track ID is correctly linked with the corresponding node ID for persistence_peer configuration.

Start Node

To start the node, execute the following command:

go run cmd/main.go start

This sequence sets up the necessary components for managing tracks effectively. Ensure that each step is executed correctly to ensure smooth operation.