Skip to content

Commit 210d216

Browse files
Updation : Intro Section
1 parent 3d049a9 commit 210d216

File tree

5 files changed

+134
-30
lines changed

5 files changed

+134
-30
lines changed

.env.example

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
ALGOLIA_APP_ID=
22
ALGOLIA_API_KEY=
3-
ALGOLIA_INDEX_NAME=
3+
ALGOLIA_INDEX_NAME=

docs/intro/how-lava-work.md

+64
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
---
2+
slug: /how-lava-work
3+
title: ⚙️ How Lava works
4+
---
5+
6+
# **How Lava Works ⚙️**
7+
8+
The Lava Network facilitates seamless, decentralized data exchange across multiple blockchains, driven by key mechanisms and incentivized roles. Lava operates as both a blockchain and an off-chain protocol, with specifications as the essential blueprints defining how blockchain data is accessed, processed, and verified. These specifications outline everything from supported APIs to data handling rules, guiding the interactions among Data Providers, Consumers, Validators, Champions, and Delegators to maintain a secure and efficient data-sharing network.
9+
10+
### 🔍 **Specifications: Foundation of the Lava Network**
11+
12+
At the heart of Lava are **specifications** 📜, JSON-based blueprints created by **Spec Champions**. Specifications define the requirements for each blockchain or API, including supported chain types, data transfer rules, Compute Units (CU) for API calls, and data validation checks. As blockchain technology evolves, Spec Champions update specifications to address new demands, ensuring Lava remains adaptable and reliable.
13+
14+
Data Providers use these specifications to configure their services according to Lava's standards, ensuring accurate and consistent data delivery across the network. Consumers, in turn, rely on these specifications to understand available data and how to access it.
15+
16+
### 🎁 **Incentive Pools: Extra Rewards for Providers & Restakers**
17+
18+
Lava **Incentive Pools** 💸 provide additional rewards funded by ecosystem stakeholders like DAOs, foundations, and major contributors. These pools incentivize Providers by offering extra rewards for delivering RPC data to Consumers. Here’s how they work:
19+
20+
- **Rewards**: Incentive pools are funded with LAVA tokens and other tokens, providing incentives for specific services or blockchains. For example, a NEAR RPC Provider on Lava could earn NEAR tokens.
21+
- **Distribution**: Providers serving data under relevant specifications receive rewards from both the incentive pools and the regular network incentives (e.g., LAVA).
22+
23+
The pool structure follows a configurable emission schedule and maintains a minimum funding threshold to ensure quality service. This threshold ensures that token rewards meet a minimum value, preventing spam and incentivizing high-quality service.
24+
25+
### 🔄 **Restaking: Boosting Network Security and Capital Efficiency**
26+
27+
Lava’s **restaking** mechanism allows users to enhance Providers’ capabilities by staking tokens with Lava Validators and then restaking them with selected Data Providers. By restaking, Providers can increase their delegation and their stake-weight in the selection algorithm, allowing them to handle more RPC requests and earn more rewards.
28+
29+
Restaking also improves network security, reduces costs, and increases capital efficiency, as node runners must stake with a Validator before becoming a Provider.
30+
31+
**Restaking Benefits**:
32+
33+
- **Capital Efficiency** 💼: Providers who have staked with Validators can restake to boost trusted Providers, enhancing the network's overall service quality.
34+
- **Reduced Security Costs** 🛡️: By enabling double-layered staking, restaking lowers the overall costs for securing the network while incentivizing high-performing Providers.
35+
36+
In the future, Lava’s restaking mechanism could expand to support additional services beyond RPC, allowing contributors to participate in and elevate other critical functions across the network.
37+
38+
### 🏗️ **Lava as a Blockchain and Off-Chain Protocol**
39+
40+
Node runners join Lava by restaking on the Lava blockchain, making them eligible to appear on **Pairing Lists** 📄.
41+
42+
The **Pairing List** serves as a dynamic directory, stored on the Lava blockchain, of available Providers ranked by metrics like stake, geographic proximity, response time, uptime, and data reliability. This list helps Consumers identify and connect with the best-performing Providers for their needs and is valid for a defined period called an **epoch**.
43+
44+
The Lava protocol facilitates data exchange via off-chain, **peer-to-peer (P2P) connections** 🔗:
45+
46+
1. **Pairing List Access** 📜: Consumers retrieve a pairing list from the blockchain to find the best-matching Providers based on their requirements.
47+
2. **Direct Connection** 🔌: Consumers initiate P2P connections with their chosen Providers for efficient data transfer.
48+
3. **Compute Units (CU)** 🖥️: Providers calculate CU based on the computational work involved in fulfilling requests. CU acts as a measure of resource use, helping Providers earn proportionate rewards.
49+
50+
This off-chain approach ensures fast data delivery while maintaining a reputation score for each Provider, reflecting their historical performance in latency, uptime, and accuracy. Over time, Consumers tend to select Providers with consistently high scores, reinforcing Lava’s focus on reliable service.
51+
52+
### 🌐 **Roles in the Lava Network**
53+
54+
The Lava ecosystem functions through the coordinated efforts of several roles, each contributing to data reliability and security.
55+
56+
- **Data Providers** 🌍: Use the **Provider Kit** to deliver data in line with Lava specifications. They stake LAVA tokens with Validators and set up nodes to serve requests. Providers are ranked in the pairing list and rewarded based on their performance and CU output.
57+
- **Data Consumers** 📲: Access blockchain data via **LavaSDK**, **incentivized endpoints**, or **Gateway Endpoints**. They spend LAVA tokens to retrieve data from Providers selected through the pairing list, setting up P2P connections for direct data exchange.
58+
- **Validators** 🔐: Maintain network security by validating transactions, proposing blocks, and achieving consensus. Validators are rewarded in LAVA tokens for contributing to network stability.
59+
- **Champions** 🛠️: As the creators and maintainers of specifications, Champions set the standards that govern data access and delivery on Lava. They update specifications as needed, adapting to the evolving blockchain landscape.
60+
- **Delegators** 💼: Support the network by staking and restaking LAVA tokens with high-performing Providers and Validators. Delegators share in the rewards based on the entities they back, contributing to Lava’s data reliability and service quality.
61+
62+
### 🔄 **Revenue Switching in Lava**
63+
64+
Lava’s revenue switching is a mechanism by which it can expand to additional services beyond RPC. By dynamically adjusting incentives to support diverse data services, Lava enables contributors and restakers to participate in multiple layers of the network. This adaptability ensures that Lava can evolve as blockchain and data-sharing demands grow over time.

docs/intro/intro.md

+18-28
Original file line numberDiff line numberDiff line change
@@ -1,55 +1,45 @@
11
---
22
slug: /
3-
title: Introduction
3+
title: Getting Started
44
---
55

66
import RoadmapItem from '@site/src/components/RoadmapItem';
77
import LatestVersion from '@site/src/components/LatestVersion';
88
import LatestDocsVersion from '@site/src/components/LatestDocsVersion';
99

10-
1110
# Lava Docs 📑
1211

13-
![Intro Banner](/img/banner/Intro.jpg)
14-
15-
:::danger Testnet is up and running!
16-
Welcome testers! Thank you for joining the testnet. If you find errors in our docs, please consider [contributing!](https://github.com/lavanet/docs)
17-
:::
18-
19-
## Overview 🔍
12+
![Intro Banner](/img/banner/Intro.jpg)
2013

21-
Today, RPC & data infrastructure is not up to par for scaling Ethereum, its rollups and all other blockchains. Lava’s novel architecture aims to offer developers fast, reliable and accurate access to any chain. RPC is the first service on Lava, but we will be expanding to subgraphs, oracles and more.
14+
## Quick Links ⚡
2215

23-
Lava is built as an application-specific L1 PoS Blockchain, based on CosmosSDK. The protocol introduces a primitive called “specs”. Specs are modules defining APIs in JSON-format, which can then be served by the network of providers to meet demand. We envision a modular economy for data infrastructure for web3 and beyond.
16+
[<RoadmapItem icon="📚" title="Getting Started with Lava" description="Begin with an introduction to the Lava Network, covering essential concepts, key features, and the Lava whitepaper."/>](/intro/about.md)
2417

25-
Lava documentation is intended to be the definitive reference for all technical aspects of Lava Protocol. For other information about Lava Network, please visit our [blog](https://www.lavanet.xyz/blog?utm_source=intro-page&utm_medium=docs) or review our new [research](https://community.lavanet.xyz/c/research/9?utm_source=intro-page&utm_medium=docs)!
18+
[<RoadmapItem icon="🔌" title="Guides for Data Providers" description="How to join Lava and serve RPC, run nodes and claim rewards for 40+ supported chains on Lava"/>](/provider)
2619

20+
[<RoadmapItem icon="🚀" title="Guides for dApp Developers" description="Integrate your dApp with Lava’s decentralized RPC network, with configuration tips and examples for various chains."/>](/developer)
2721

28-
## Getting started 🌪️
22+
[<RoadmapItem icon="🔐" title="Guides for Validators" description="Learn how to set up and manage a Lava blockchain validator node to help secure the network."/>](/validator)
2923

30-
[<RoadmapItem icon="⛓️" title="Supported Chains" description="Learn more about the Chains that Lava supports."/>](/chains)
24+
[<RoadmapItem icon="🔄" title="Guides for Restakers" description="Restake your LAVA tokens to secure the Lava blockchain and boost top Providers."/>](/tokenomics/rewards-restaking.md)
3125

32-
[<RoadmapItem icon="⚡️" title="Access Web3 APIs" description="Start using Web3 APIs, seamlessly onboarding Lava's network"/>](/developer)
26+
[<RoadmapItem icon="🏅" title="Contributing to Lava" description="Discover how to become a Spec Champion and expand Lava’s support to additional chains and services."/>](/spec)
3327

34-
[<RoadmapItem icon="🌋" title="Become a Lava Validator" description="Validate blocks, secure the network, earn rewards"/>](/validator)
35-
36-
[<RoadmapItem icon="🔄" title="Become an API Provider" description="Service chain access, grow the network, earn rewards"/>](/provider)
28+
[<RoadmapItem icon="📂" title="Additional Resources" description="Access tutorials and resources to support your journey in the Lava ecosystem."/>](tutorials.md)
3729

3830
## Version Information ℹ️
3931

40-
| | |
41-
|-----------|-------------------|
42-
| *Lava* Version | **<LatestVersion />** |
43-
| *Go* Version | > ** 1.20.5 ** |
44-
| CosmosSDK | ** v0.47 ** |
45-
| Current Testnet | `lava-testnet-2` |
46-
| Docs Version | **<LatestDocsVersion />** |
32+
| | |
33+
| --------------- | ------------------------- |
34+
| _Lava_ Version | **<LatestVersion />** |
35+
| _Go_ Version | > ** 1.20.5 ** |
36+
| CosmosSDK | ** v0.47 ** |
37+
| Current Testnet | `lava-testnet-2` |
38+
| Docs Version | **<LatestDocsVersion />** |
4739

48-
## Quick Links 🔗
40+
## Additional Links 🔗
4941

5042
- [🚪 Gateway](https://gateway.lavanet.xyz/?utm_source=intro-page&utm_medium=docs&utm_campaign=docs-to-gateway) - Quick access APIs
5143
- [🔭 Explorer](https://lava.explorers.guru/) - Use our Official Block Explorer
5244
- [💬 Community Forum](https://community.lavanet.xyz/?utm_source=intro-page&utm_medium=docs) - Long-form Discussion
5345
- [🐦 Twitter/X Account](https://twitter.com/lavanetxyz) - Follow us on X!
54-
55-

docs/intro/key-roles.md

+48
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
slug: /key-roles
3+
title: 🔑 Key Roles
4+
---
5+
6+
# **Key Roles in Lava 🔑**
7+
8+
Lava Network comprises five primary roles, each playing a distinct and critical role in ensuring the network’s reliability, security, and functionality. These roles are integral to the operation of Lava’s ecosystem:
9+
10+
### **1.2.1 Data Providers** 🌐
11+
12+
- **Role Overview:**
13+
- Data Providers serve as the backbone of Lava, responsible for delivering blockchain data through RPCs across different interfaces.
14+
- **Responsibilities:**
15+
- Providers stake LAVA tokens to serve data and earn rewards based on performance.
16+
- They follow specifications, which outline the service requirements and ensure compliance with Lava’s standards.
17+
18+
### **1.2.2 Data Consumers** 📲
19+
20+
- **Role Overview:**
21+
- Data Consumers include developers, wallets, dApps, exchanges, and indexers that use the Lava Network to access blockchain data.
22+
- **Responsibilities:**
23+
- Consumers spend LAVA tokens to retrieve data via Lava’s endpoints, utilizing tools like **LavaSDK**, **ipRPC endpoints**, and **Gateway Endpoints**.
24+
- They engage directly with data providers through P2P connections, facilitated by Lava’s pairing mechanism.
25+
26+
### **1.2.3 Validators** 🔒
27+
28+
- **Role Overview:**
29+
- Validators ensure the security and consensus of the Lava Network, similar to validators on other chains.
30+
- **Responsibilities:**
31+
- Validators propose, vote, and validate blocks, maintaining the network’s integrity.
32+
- They earn LAVA as compensation for their role in securing the chain and processing transactions.
33+
34+
### **1.2.4 Spec Champions** 🛠️
35+
36+
- **Role Overview:**
37+
- Spec Champions play a vital role in the Lava ecosystem by creating, maintaining, and managing specifications that define Lava’s data services and extend coverage to more chains.
38+
- **Responsibilities:**
39+
- Champions propose new specifications, update existing ones, and write software that aligns with these specs (e.g., node clients, API clients, and indexers).
40+
- They earn LAVA rewards for their contributions, ensuring that Lava remains adaptive to evolving blockchain needs.
41+
42+
### **1.2.5 Delegators** 💰
43+
44+
- **Role Overview:**
45+
- Delegators contribute to network security and performance by staking LAVA tokens to validators and restaking to Providers.
46+
- **Responsibilities:**
47+
- Delegators earn rewards based on the performance of the providers and validators they support, sharing in both the risks and rewards.
48+
- By staking and restaking LAVA, they enhance network security and boost Providers in the pairing mechanism.

sidebars.js

+3-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ const sidebars = {
55
theSidebar: [
66
{
77
type: "category",
8-
label: "Introduction 🎉",
8+
label: "Getting Started 🎉",
99
link: {
1010
type: "doc",
1111
id: "intro/intro",
@@ -14,6 +14,8 @@ const sidebars = {
1414
collapsed: true,
1515
items: [
1616
"intro/about",
17+
"intro/key-roles",
18+
"intro/how-lava-work",
1719
"intro/explorers",
1820
"intro/key-terms",
1921
"intro/key-variables",

0 commit comments

Comments
 (0)