Skip to content

lavanet/lava

Repository files navigation

Logo Lava Network

image

What is Lava?

The Lava Protocol aims to provide decentralized and scalable access to blockchain data through the use of a network of providers and consumers. It utilizes a proof-of-stake consensus mechanism and incentivizes participants through the use of its native LAVA token. The protocol includes features such as a stake-weighted pseudorandom pairing function, backfilling, and a lazy settlement process to improve scalability and efficiency. The roadmap for the Lava Protocol includes further development of governance, conflict resolution, privacy, and quality of service, as well as support for additional API specifications. It is designed to be a public good that enables decentralized access to the Web3 ecosystem.

Read more about Lava in the whitepaper and visit the Docs

Lava blockchain

Lava is built using the Cosmos SDK which runs on top of Tendermint Core consensus engine.

Documentation

Note: Requires Go 1.23

Quick Start

The best way to start working with lava is to use docker, for additional reading go to: Running via compose

Contributing

See CONTRIBUTING.md for details on how to contribute. If you want to follow the updates or learn more about the latest design then join our Discord.

Developing

Installing development dependencies

before running the scripts make sure you have go installed and added to $PATH, you can validate by running which go init_install will install all necessary dependencies to develop on lava.

./scripts/init_install.sh

Building the binaries

LAVA_BINARY=all will build all lava binaries (lavad, lavap, lavavisor) and place them in the go bin path on your environment.

LAVA_BINARY=all make install

Building the binaries locally

You can also build the binaries locally (path will be ./build/...) by running

LAVA_BINARY=all make build

Building only a specific binary

it is possible to build only one binary: lavad/lavap/lavavisor

LAVA_BINARY=lavad make install

Or check out the latest release.

Add lavad/lavap autocomplete

You can add a useful autocomplete feature to lavad & lavap with a simple bash script.

Syncing Specs with lavanet/lava-config repository

The specs in this directory need to be synchronized with the lavanet/lava-config repository. This ensures that the specifications are consistent across the Lava Network ecosystem.

Initial Setup (Historical Reference)

The specs directory was initially set up as a git subtree using these commands:

# Add a remote to track the lava-config repository
git remote add lava-config [email protected]:lavanet/lava-config.git  # This creates a named reference to the remote repository

# Add the subtree by pulling from the remote
git subtree add --prefix=specs https://github.com/lavanet/lava-config.git main --squash

Pulling Updates from lava-config

To get the latest changes from the lava-config repository:

git subtree pull --prefix=specs https://github.com/lavanet/lava-config.git main --squash

Contributing Changes

To contribute changes to lava-config:

  1. First, fork the lavanet/lava-config repository to your GitHub account.

  2. After making your changes to the specs, you can:

    # Create a branch containing only the specs directory history
    git subtree split --prefix=specs -b <branch-name> --squash
    
    # Push your changes to your fork
    git push <your-fork-remote> <branch-name>
  3. Create a Pull Request from your fork to the main lavanet/lava-config repository.

The git remote add command creates a named reference ("lava-config") to the remote repository, making it easier to push and pull changes. Without it, you'd need to specify the full repository URL each time.

The git subtree split command is useful when you want to extract the history of just the specs directory into its own branch. This can be helpful when preparing changes for a pull request, as it gives you a clean history of only the specs-related changes.

Remember to always test your changes locally before submitting a PR to ensure the specifications are valid and properly formatted.

Join Lava

Join Lava's testnet, read instructions here

⚠️ THERE'S NO MAINNET LAVA TOKEN, BE AWARE OF SCAMS.

Community