README
¶
Lava Network
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.
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 git@github.com: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:
-
First, fork the lavanet/lava-config repository to your GitHub account.
-
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> -
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
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
ecosystem
|
|
|
protocol
|
|
|
chainlib
Code generated by MockGen.
|
Code generated by MockGen. |
|
chainlib/chainproxy/rpcclient
package rpcclient implements bi-directional JSON-RPC 2.0 on multiple transports.
|
package rpcclient implements bi-directional JSON-RPC 2.0 on multiple transports. |
|
chainlib/grpcproxy/testproto
Package testproto is a reverse proxy.
|
Package testproto is a reverse proxy. |
|
rpcconsumer
Package rpcconsumer is a generated GoMock package.
|
Package rpcconsumer is a generated GoMock package. |
|
rpcprovider
Code generated by MockGen.
|
Code generated by MockGen. |
|
statetracker/updaters
Package updaters is a generated GoMock package.
|
Package updaters is a generated GoMock package. |
|
testutil
|
|
|
nullify
Package nullify provides methods to init nil values structs for test assertion.
|
Package nullify provides methods to init nil values structs for test assertion. |
|
x
|
|
|
conflict/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |
|
downtime/v1
Package v1 is a reverse proxy.
|
Package v1 is a reverse proxy. |
|
dualstaking/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |
|
epochstorage/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |
|
fixationstore/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |
|
pairing/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |
|
plans/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |
|
projects/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |
|
protocol/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |
|
rewards/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |
|
spec/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |
|
subscription/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |
|
timerstore/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |