From 679074a670d703541d072ce15c51966f100414f5 Mon Sep 17 00:00:00 2001 From: udhaykumarbala Date: Sat, 11 Jan 2025 16:16:10 +0530 Subject: [PATCH] Udhay/cleanup whole doc (#96) * cleanup PR * cleanup PR * dAIOS changed to deAIOS * Resolved review comments & conflicts * added quicknode --- docs/0g-chain.md | 4 ++-- docs/0g-compute.md | 8 ++++---- docs/0g-storage.md | 10 +++++----- docs/build-with-0g/compute-network/overview.md | 4 ++-- docs/build-with-0g/explorer.md | 18 +++++++----------- docs/build-with-0g/faucet.md | 1 + .../arbitrum-nitro-on-0g-da.md | 2 +- .../rollups-and-appchains/op-stack-on-0g-da.md | 3 +-- docs/build-with-0g/storage-cli.md | 2 +- docs/da/0g-da-deep-dive.md | 9 ++++----- docs/da/0g-da.md | 16 ++++++++-------- docs/intro.md | 12 ++++++------ docs/node-sale/intro/intro.md | 2 +- docs/preface.md | 10 +++++----- docs/run-a-node/community-docker-repo.md | 17 +++++------------ docs/run-a-node/da-node.md | 11 ++++++----- docs/run-a-node/overview.md | 8 ++++---- docs/run-a-node/storage-node.md | 9 ++++----- docs/run-a-node/testnet-information.md | 17 ++++++++++------- docs/run-a-node/validator-node.md | 2 +- sidebars.ts | 4 ++-- 21 files changed, 80 insertions(+), 89 deletions(-) diff --git a/docs/0g-chain.md b/docs/0g-chain.md index aeeb1cd..088f1d6 100644 --- a/docs/0g-chain.md +++ b/docs/0g-chain.md @@ -7,9 +7,9 @@ sidebar_position: 5 # 0G Chain: The Fastest Modular AI Chain --- -0G Chain is a highly scalable, AI-optimized L1 blockchain designed to meet the needs of data-heavy applications. Built with a modular architecture, it allows for the independent optimization of key components like consensus, execution, and storage—making it ideal for AI-driven workflows. 0G is fully **EVM-compatible**, so decentralized applications (dApps) already deployed on other L1 or L2 chains (such as Ethereum or rollups) can easily leverage 0G's products without needing to migrate entirely. +0G is the largest AI Layer 1 ecosystem, powered by the fastest DeAIOS (decentralized AI Operating System). With $325M raised, 0G is the ultimate home for DeAI. Built with a modular architecture, it allows for the independent optimization of key components like consensus, execution, and storage—making it ideal for AI-driven workflows. 0G is fully **EVM-compatible**, so decentralized applications (dApps) already deployed on other L1 or L2 chains (such as Ethereum or rollups) can easily leverage 0G's products without needing to migrate entirely. -0G Chain supports a [data availability network](./da/0g-da.md), [distributed storage network](0g-storage.md), and [AI compute network](0g-compute.md). All of these networks integrate with 0G Chain's highly scalable consensus network, built to handle massive data volumes suitable for AI. +0G Chain supports a [data availability network](./da/0g-da.md), [distributed storage network](0g-storage.md), and [AI compute network](0g-compute.md). These networks integrate with 0G Chain's highly scalable consensus network, which is built to handle massive data volumes suitable for AI. As the demand for network capacity increases, new consensus networks can be added to enable horizontal scalability, thereby boosting the overall bandwidth and performance of the system. By **decoupling data publication from data storage**, 0G optimizes both throughput and scalability, surpassing the limitations seen in existing data availability (DA) solutions. diff --git a/docs/0g-compute.md b/docs/0g-compute.md index a78046d..97b6ac9 100644 --- a/docs/0g-compute.md +++ b/docs/0g-compute.md @@ -11,17 +11,17 @@ In today's world, AI models are transforming industries, driving innovation, and ## What is 0G Compute Network? -The 0G Compute Network is a decentralized framework that provides AI computing capabilities to our community. It forms a crucial part of dAIOS and, together with the storage network, offers comprehensive end-to-end support for dApp development and services. +The 0G Compute Network is a decentralized framework that provides AI computing capabilities to our community. It forms a crucial part of deAIOS and, together with the storage network, offers comprehensive end-to-end support for dApp development and services. -The first iteration focuses specifically on decentralized settlement for inference, connecting buyers (who want to use AI models) with sellers (who run these models on their GPUs) in a trustless, transparent manner. Sellers, known as service providers, are able to set the price for each model they support and be rewarded real-time for their contributions. It’s a fully decentralized marketplace that eliminates the need for intermediaries, redefining how AI services are accessed and delivered and making them cheaper, more efficient, and accessible to anyone, anywhere. +The first iteration focuses specifically on decentralized settlement for inference, connecting buyers (who want to use AI models) with sellers (who run these models on their GPUs) in a trustless, transparent manner. Sellers, known as service providers, can set the price for each model they support and receive real-time rewards for their contributions. It's a fully decentralized marketplace that eliminates the need for intermediaries, redefining how AI services are accessed and delivered by making them cheaper, more efficient, and accessible to anyone, anywhere. ## How does it work? -The 0G Compute Network contract facilitates secure interactions between users (AI buyers) and service providers (GPU owners running AI models), ensuring smooth data retrieval, fee collection, and service execution. Here’s how it works: +The 0G Compute Network contract facilitates secure interactions between users (AI buyers) and service providers (GPU owners running AI models), ensuring smooth data retrieval, fee collection, and service execution. Here's how it works: 1. **Service Provider Registration:** Service providers first register the type of AI service they offer (e.g., model inference) and set pricing for each type within the smart contract. 2. **User Pre-deposits Fees:** When a user wants to access a service, they pre-deposit a fee into the smart contract associated with the selected service provider. This ensures that funds are available to compensate the service provider. -3. **Request and Response System:** Users send requests for AI inference, and the service provider decides whether to respond based on the sufficiency of the user’s remaining balance. Both the user and the provider sign each request and response, ensuring trustless verification of transactions. +3. **Request and Response System:** Users send requests for AI inference, and the service provider decides whether to respond based on the sufficiency of the user's remaining balance. Both the user and the provider sign each request and response, ensuring trustless verification of transactions. Here are some of the key features of the system: diff --git a/docs/0g-storage.md b/docs/0g-storage.md index e1880d1..0033539 100644 --- a/docs/0g-storage.md +++ b/docs/0g-storage.md @@ -9,16 +9,16 @@ sidebar_position: 3 ## Intro to Storage Systems -Storage systems play a critical role in managing, organizing, and ensuring the accessibility of data. In traditional systems, data is often stored centrally, creating risks around availability, censorship, and data loss due to single points of failure. Decentralized storage, on the other hand, addresses these issues by distributing data across a network of nodes, enhancing security, resilience, and scalability. This decentralization is essential, especially in an era where massive data sets are generated and consumed by AI, Web3 applications, and large-scale businesses. +Storage systems play a critical role in managing, organizing, and ensuring the accessibility of data. In traditional systems, data is often stored centrally, creating risks around availability, censorship, and data loss due to single points of failure. Decentralized storage addresses these issues by distributing data across a network of nodes, enhancing security, resilience, and scalability. This decentralization is essential, especially in an era where massive datasets are generated and consumed by AI, Web3 applications, and large-scale businesses. ## 0G's Storage System -0G Storage is a distributed data storage system designed with on-chain elements to incentivize storage nodes to store data on behalf of a user. Anyone can run a storage node and receive rewards for maintaining one. For information on how to do so, check out our guide [here](./run-a-node/storage-node.md). +0G Storage is a distributed data storage system designed with on-chain elements to incentivize storage nodes to store data on behalf of users. Anyone can run a storage node and receive rewards for maintaining one. For information on how to do so, check out our guide [here](./run-a-node/storage-node.md). -0G's system itself has two parts: +0G's system consists of two parts: -1. **The Data Publishing Lane:** Ensures data availability by allowing quick queries and verification through the 0G Consensus network. This ensures that the data stored can be easily accessed and validated by users or applications when needed. -2. **The Data Storage Lane:** Manages large data transfers and storage, utilizing an erasure-coding mechanism. This splits data into smaller, redundant fragments distributed across different nodes, guaranteeing data recovery in case of node failure or downtime. +1. **The Data Publishing Lane:** Ensures data availability by allowing quick queries and verification through the 0G Consensus network. This ensures that stored data can be easily accessed and validated by users or applications when needed. +2. **The Data Storage Lane:** Manages large data transfers and storage using an erasure-coding mechanism. This splits data into smaller, redundant fragments distributed across different nodes, guaranteeing data recovery even if some nodes fail or experience downtime. For any party wishing to store data with 0G, the data must first be provided alongside payment using 0G's token, which is fully embedded into 0G's main chain. To store this data, it is first *erasure-coded,* meaning that the data being stored is fragmented into redundant smaller pieces distributed across multiple storage locations. Redundancy is essential as it ensures the data can always be recovered, even if some storage locations fail or become unavailable. diff --git a/docs/build-with-0g/compute-network/overview.md b/docs/build-with-0g/compute-network/overview.md index 7e7633b..33c2a57 100644 --- a/docs/build-with-0g/compute-network/overview.md +++ b/docs/build-with-0g/compute-network/overview.md @@ -12,11 +12,11 @@ We integrate various stages of the AI process to make these services both verifi ## Components -**Contract:** This component determines the legitimacy of settlement proofs, manages accounts, and handles service information. To do this, it stores variables during the service process, including account information, service details (such as name and URL), and consensus logic. +**Contract:** This component determines the legitimacy of settlement proofs, manages accounts, and handles service information. It stores variables during the service process, including account information, service details (such as name and URL), and consensus logic. **Provider:** The owners of AI models and hardware who offer their services for a fee. -**User:** Individuals or organizations who use the services listed by Service Providers. They may also use AI services directly or build applications on top of our API. +**User:** Individuals or organizations who use the services listed by Service Providers. They may use AI services directly or build applications on top of our API. ## Process Overview diff --git a/docs/build-with-0g/explorer.md b/docs/build-with-0g/explorer.md index a9f2c09..0ce6f2f 100644 --- a/docs/build-with-0g/explorer.md +++ b/docs/build-with-0g/explorer.md @@ -5,22 +5,20 @@ title: 0G Explorers # 0G Explorers: Visualize the Blockchain Ecosystem --- -Our explorers are designed to give you a user-friendly window into the 0G ecosystem. By offering powerful visualization tools, they eliminate the need for complex CLI commands, making it easier for anyone to understand what's happening on-chain. A well-designed UI enhances your experience, allowing you to focus on insights without having to know specific commands. +Our explorers provide a user-friendly window into the 0G ecosystem. By offering powerful visualization tools, they eliminate the need for complex CLI commands, making it easier for anyone to understand what's happening on-chain. A well-designed UI enhances your experience, allowing you to focus on insights rather than memorizing specific commands. -Explore the 0G Ecosystem with our powerful scanning tools. These explorers provide detailed insights into storage and chain activities, helping you understand and analyze the network effectively. +These explorers provide detailed insights into storage and chain activities, helping you understand and analyze the network effectively. -## [Storage Scan](https://storagescan-newton.0g.ai/) +### [Storage Scan](https://storagescan-newton.0g.ai/) -Storage Scan is your go-to tool for exploring storage-related activities within the network. - -Use Storage Scan to: +Storage Scan is your go-to tool for exploring storage-related activities within the network. Use Storage Scan to: - Track data storage and retrieval activities - Analyze storage capacity and utilization across the network +- View detailed transaction histories and storage metrics -## [Chain Scan](https://chainscan-newton.0g.ai) +### [Chain Scan](https://chainscan-newton.0g.ai) Chain Scan provides a comprehensive view of 0G chain activity and transactions. - Use Chain Scan to: - View real-time blockchain transactions - Explore blocks, addresses, and smart contracts @@ -28,9 +26,7 @@ Use Chain Scan to: ## [Nodes Guru](https://testnet.0g.explorers.guru/) -Nodes Guru provides key information and monitoring tools for validators and node operators to track the health and performance of the network. - -Use Nodes Guru to: +Nodes Guru provides key information and monitoring tools for validators and node operators to track the health and performance of the network. Use Nodes Guru to: - View Validator performance metrics like uptime, block proposals, and missed blocks - Obtain staking and rewards info - Participate in governance proposals and vote on network upgrades or changes diff --git a/docs/build-with-0g/faucet.md b/docs/build-with-0g/faucet.md index f791c1d..7d3761c 100644 --- a/docs/build-with-0g/faucet.md +++ b/docs/build-with-0g/faucet.md @@ -14,6 +14,7 @@ The 0G Faucet provides free testnet tokens, essential for interacting with the 0 ## How to Get Testnet Tokens - **Use the Faucet Website:** The easiest way to request tokens is through our [faucet website](https://faucet.0g.ai). Each user can receive up to 1 A0GI token per day, which is sufficient for most testing needs. +- **Request via thirdweb:** From [thirdweb faucet](https://thirdweb.com/0g-newton-testnet?utm_source=0g&utm_medium=docs), Each user can receive up to 0.01 A0GI token per day. - **Request via Discord:** If you require more than 1 A0GI token per day, please reach out in our vibrant [Discord community](https://discord.com/invite/0glabs) to request additional tokens. :::important diff --git a/docs/build-with-0g/rollups-and-appchains/arbitrum-nitro-on-0g-da.md b/docs/build-with-0g/rollups-and-appchains/arbitrum-nitro-on-0g-da.md index ad698b5..84c4638 100644 --- a/docs/build-with-0g/rollups-and-appchains/arbitrum-nitro-on-0g-da.md +++ b/docs/build-with-0g/rollups-and-appchains/arbitrum-nitro-on-0g-da.md @@ -28,4 +28,4 @@ Find the [repository for this integration](https://github.com/0glabs/nitro) at h - [0G Arbitrum Nitro Rollup Kit](https://github.com/0glabs/nitro) -WARNING:This is a beta integration and we are working on resolving open issues. +> **WARNING:** This is a beta integration and we are working on resolving open issues. diff --git a/docs/build-with-0g/rollups-and-appchains/op-stack-on-0g-da.md b/docs/build-with-0g/rollups-and-appchains/op-stack-on-0g-da.md index 2624d60..dc1c15f 100644 --- a/docs/build-with-0g/rollups-and-appchains/op-stack-on-0g-da.md +++ b/docs/build-with-0g/rollups-and-appchains/op-stack-on-0g-da.md @@ -68,8 +68,7 @@ The Optimism codebase has been extended to integrate with the 0G DA `da-server`. -0G DA DA-server accepts the following flags for 0G DA storage using -[0G DA Open API](https://docs.0g.ai/0g-doc/docs/0g-da/rpc-api/api-1) +0G DA DA-server accepts the following flags for 0G DA storage using 0G DA Open API ```` --zg.server (default: "localhost:51001") diff --git a/docs/build-with-0g/storage-cli.md b/docs/build-with-0g/storage-cli.md index 5466610..c60d4fd 100644 --- a/docs/build-with-0g/storage-cli.md +++ b/docs/build-with-0g/storage-cli.md @@ -120,7 +120,7 @@ The command-line help listing is reproduced below for your convenience. The same **Important Considerations** * **Contract Addresses:** You need the accurate contract addresses for the 0G log contract on the specific blockchain you are using. You can find these on the 0G Storage explorer or in the official documentation. -* **File Root Hash:** To download a file, you must have its root hash. This is provided when you upload a file or can be found by looking up your transaction on the 0G Storage explorer ([https://storagescan-newton.0g.ai/](https://storagescan-newton.0g.ai/)). +* **File Root Hash:** To download a file, you must have its root hash. This is provided when you upload a file or can be found by looking up your transaction on the [0G Storage explorer](https://storagescan-newton.0g.ai/). * **Storage Node RPC Endpoint:** You can use the team-deployed storage node or run your own node for more control and the potential to earn rewards. diff --git a/docs/da/0g-da-deep-dive.md b/docs/da/0g-da-deep-dive.md index bc01ab7..b40b91f 100644 --- a/docs/da/0g-da-deep-dive.md +++ b/docs/da/0g-da-deep-dive.md @@ -5,9 +5,9 @@ sidebar_position: 2 --- # 0G DA Technical Deep Dive -The Data Availability (DA) module allows users to submit a piece of data, referred to as a _**DA blob**_. This data is redundantly encoded by the client's proxy and divided into several slices, which are then sent to DA nodes. _**DA nodes**_ gain eligibility to verify the correctness of DA slices by staking. Each DA node verifies the integrity and correctness of its slice and signs it. Once more than 2/3 of the aggregated signatures are on-chain, the data behind the related hash is considered to be decentralized published. +The Data Availability (DA) module allows users to submit a piece of data, referred to as a _**DA blob**_. This data is redundantly encoded by the client's proxy and divided into several slices, which are then sent to DA nodes. _**DA nodes**_ gain eligibility to verify the correctness of DA slices by staking. Each DA node verifies the integrity and correctness of its slice and signs it. Once more than 2/3 of the aggregated signatures are on-chain, the data behind the related hash is considered to be published decentrally. -To incentivize DA nodes to store the signed data for a period, the signing process itself does not provide any rewards. Instead, rewards are distributed through a process called _**DA Sampling**_. During each DA Sample round, any DA slice within a certain time frame can generate a lottery chance for a reward. DA nodes need to actually store the corresponding slice to redeem the lottery chance and claim the reward. +To incentivize DA nodes to store the signed data for a period, the signing process itself does not provide any rewards. Instead, rewards are distributed through a process called _**DA Sampling**_. During each DA Sample round, any DA slice within a certain timeframe can generate a lottery chance for a reward. DA nodes must store the corresponding slice to redeem the lottery chance and claim the reward. The process of generating DA nodes is the same as the underlying chain's PoS process, both achieved through staking. During each DA epoch (approximately 8 hours), DA nodes are assigned to several quorums. Within each quorum, nodes are assigned numbers 0 through 3071. Each number is assigned to exactly one node, but a node may be assigned to multiple quorums, depending on its staking weight. @@ -84,11 +84,10 @@ Admin adjustable parameters During each period, each DA slice (one row) can be divided into 32 sub-lines. For each sub-line, the `podasQuality` will be computed using the `dataRoot` and assigned `epoch` and `quorumId` of its corresponding DA blob. -\ +The hash value can be viewed interchangeably as either 32 bytes of data or a 256-bit big-endian integer. ```python lineQuality = keccak256(sampleSeed, epoch, quorumId, dataRoot, lineIndex); diff --git a/docs/da/0g-da.md b/docs/da/0g-da.md index cfea36a..73f7f81 100644 --- a/docs/da/0g-da.md +++ b/docs/da/0g-da.md @@ -9,15 +9,15 @@ sidebar_position: 1 ## The Rise of Data Availability Layers -Data availability (DA) refers to proving that data is readily accessible, verifiable, and retrievable. For example, Layer 2 rollups such as Arbitrum or Base reduce the burden from Ethereum by handling transactions off-chain and then publishing the data back to Ethereum, thereby freeing up L1 Ethereum throughput and reducing gas. The transaction data, however, still needs to be made available so that anyone can validate or challenge the transactions through fraud-proofs during the challenge-period. +Data availability (DA) refers to proving that data is readily accessible, verifiable, and retrievable. For example, Layer 2 rollups such as Arbitrum or Base reduce the burden on Ethereum by handling transactions off-chain and then publishing the data back to Ethereum, thereby freeing up L1 throughput and reducing gas costs. The transaction data, however, still needs to be made available so that anyone can validate or challenge the transactions through fraud proofs during the challenge period. As such, DA is crucial to blockchains as it allows for full validation of the blockchain's history and current state by any participant, thus maintaining the decentralized and trustless nature of the network. Without this, validators would not be able to independently verify the legitimacy of transactions and blocks, leading to potential issues like fraud or censorship. -This led to the arrival of *Data Availability Layers (DALs)*, which provide a significantly more efficient manner of storing and verifying data than publishing directly to Ethereum. DALs are critical for several reasons: +This led to the emergence of Data Availability Layers (DALs), which provide a significantly more efficient manner of storing and verifying data than publishing directly to Ethereum. DALs are critical for several reasons: * **Scalability**: DALs allow networks to process more transactions and larger datasets without overwhelming the system, reducing the burden on network nodes and significantly enhancing network scalability. -* **Increased Efficiencies**: DALs optimize how and where data is stored and made available, increasing data throughput and reducing latency while also minimizing associated costs. -* **Interoperability & Innovation**: DALs that can interact with multiple ecosystems allow for fast and highly secure interoperability for data and assets. +* **Increased Efficiency**: DALs optimize how and where data is stored and made available, increasing data throughput and reducing latency while also minimizing associated costs. +* **Interoperability & Innovation**: DALs that can interact with multiple ecosystems enable fast and highly secure interoperability for data and assets. However, it's worth noting that not all DALs are built equally. @@ -43,13 +43,13 @@ There are 4 differentiators of 0G worth highlighting: 2. **Modular and Layered Architecture**: 0G's design decouples storage, data availability, and consensus, allowing each component to be optimized for its specific function. Data availability is ensured through redundancy, with data distributed across decentralized Storage Nodes. Cryptographic proofs (like Merkle trees and zk-proofs) verify data integrity at regular intervals, automatically replacing nodes that fail to produce valid proofs. And combined with 0G's ability to keep adding new consensus networks that scale with demand, 0G can scale efficiently and is ideal for complex AI workflows and large-scale data processing. -3. **Decentralized AI Operating System & High Throughput**: 0G is the first decentralized AI operating system (dAIOS) designed to give users control over their data, while providing the infrastructure necessary to handle the massive throughput demands of AI applications. Beyond its modular architecture and infinite consensus layers, 0G achieves high throughput through parallel data processing, enabled by erasure coding, horizontally scalable consensus networks, and more. With a demonstrated throughput of 50 Gbps on the Newton Testnet, 0G seamlessly supports AI workloads and other high-performance needs, including training large language models and managing AI agent networks. +3. **Decentralized AI Operating System & High Throughput**: 0G is the first decentralized AI operating system (deAIOS) designed to give users control over their data, while providing the infrastructure necessary to handle the massive throughput demands of AI applications. Beyond its modular architecture and infinite consensus layers, 0G achieves high throughput through parallel data processing, enabled by erasure coding, horizontally scalable consensus networks, and more. With a demonstrated throughput of 50 Gbps on the Newton Testnet, 0G seamlessly supports AI workloads and other high-performance needs, including training large language models and managing AI agent networks. These differentiators make 0G uniquely positioned to tackle the challenges of scaling AI on a decentralized platform, which is critical for the future of Web3 and decentralized intelligence. ## How Does This Work? -As covered in #0G_Storage, data within the 0G ecosystem is first erasure-coded and split into "data chunks," which are then distributed across various Storage Nodes in the 0G Storage network. +As covered in [0G Storage](./../0g-storage.md), data within the 0G ecosystem is first erasure-coded and split into "data chunks," which are then distributed across various Storage Nodes in the 0G Storage network. To ensure data availability, 0G uses **Data Availability Nodes** that are randomly chosen using a Verifiable Random Function (VRF). A VRF generates random values in a way that is unpredictable yet verifiable by others, which is important as it prevents potentially malicious nodes from collusion. @@ -60,9 +60,9 @@ The consensus mechanism used by 0G is fast and efficient due to its sampling-bas Validators in the 0G Consensus network Image
-Validators in the 0G Consensus network, who are separate from the DA nodes, verify and finalize these proofs. Although DA nodes ensure data availability, they do not directly participate in the final consensus process, which is the responsibility of 0G validators. Validators use a shared staking mechanism where they stake $0G tokens on a primary network (likely Ethereum). Any slashable event across connected networks leads to slashing on the main network, securing the system's scalability while maintaining robust security. +Validators in the 0G Consensus network, who are separate from the DA nodes, verify and finalize these proofs. Although DA nodes ensure data availability, they do not directly participate in the final consensus process, which is the responsibility of 0G validators. Validators use a shared staking mechanism where they stake 0G tokens on a primary network (likely Ethereum). Any slashable event across connected networks leads to slashing on the main network, securing the system's scalability while maintaining robust security. -This is a key mechanism that allows for the system to scale infinitely while maintaining data availability. In return, validators engaged in shared staking receive $0G tokens on any network managed, which can then be burnt in return for $0G tokens on the mainnet. +This is a key mechanism that allows for the system to scale infinitely while maintaining data availability. In return, validators engaged in shared staking receive 0G tokens on any network managed, which can then be burnt in return for 0G tokens on the mainnet.
consensus process Image
diff --git a/docs/intro.md b/docs/intro.md index e565f41..068a6aa 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -10,11 +10,11 @@ sidebar_position: 2 import LottieAnimation from '@site/src/components/lottieAnimation'; -## The First Decentralized AI Operating System (dAIOS) +## The First Decentralized AI Operating System (deAIOS) **0G (Zero Gravity)** is the first decentralized AI [operating system](https://edu.gcfglobal.org/en/computerbasics/understanding-operating-systems/1/) that acts as the foundational layer for decentralized AI applications and chains. It efficiently orchestrates utilization of hardware resources such as storage and compute and software assets such as data and models to handle the scale and complexity of AI workloads. -Specifically designed for AI (d)applications and chains, 0G features the fastest, infinitely scalable data availability (DA) layer, the cheapest decentralized storage system, and a novel flexible serving framework for inferences and finetuning. Prior to 0G, resource-intensive AI applications would only be feasible “off-chain” due to burdensome on-chain costs, low latency and throughput, and a lack of builder-friendly tooling. +Specifically designed for AI (d)applications and chains, 0G features the fastest, infinitely scalable data availability (DA) layer, the cheapest decentralized storage system, and a novel flexible serving framework for inferences and fine-tuning. Prior to 0G, resource-intensive AI applications would only be feasible "off-chain" due to burdensome on-chain costs, low latency and throughput, and a lack of builder-friendly tooling. For the first time ever, 0G bridges this cost and efficiency gap between Web2 and Web3, empowering builders to confidently deploy AI applications on-chain with _improved_ performance. @@ -22,11 +22,11 @@ For the first time ever, 0G bridges this cost and efficiency gap between Web2 an Democratized AI
-The 0G dAIOS has 4 key components: +The 0G deAIOS has 4 key components: +- **0G Chain**: The fastest, most modular blockchain, making on-chain gaming and AI a reality. - **0G Storage Network**: A decentralized storage network optimized for massive data loads. +- **0G Compute Network**: A versatile framework for AI compute, including fast data retrieval, model inference/training, etc. - **0G DA**: An infinitely scalable and programmable data availability layer designed for high-performance chains. -- **0G Compute Network**: A versatile framework for AI compute, including fast data retrieval, model inference/training and etc. -- **0G Chain**: The fastest, most modular blockchain, making on-chain gaming and AI a reality.
**What is decentralized storage?** @@ -64,7 +64,7 @@ At 0G, our mission is clear: To Make AI a Public Good. Every component of our ecosystem contributes toward this goal, and we invite you to join us in building the foundation for a decentralized AI future. -This introduction serves as your gateway into the 0G ecosystem. For deeper insights on various products, explore the next sections to learn about 0G dAIOS. If you’re ready to dive in, check out our guides: +This introduction serves as your gateway into the 0G ecosystem. For deeper insights on various products, explore the next sections to learn about 0G deAIOS. If you’re ready to dive in, check out our guides: - [Run a Node](/run-a-node/overview) - [Use our Storage Network](/build-with-0g/storage-sdk) diff --git a/docs/node-sale/intro/intro.md b/docs/node-sale/intro/intro.md index 7a7c955..d2aa5a9 100644 --- a/docs/node-sale/intro/intro.md +++ b/docs/node-sale/intro/intro.md @@ -5,7 +5,7 @@ sidebar_position: 1 --- ## Purpose and Benefits of the 0G AI Alignment Node Sale -The objective of 0G Foundation: The 0G Foundation’s node sale aims to create a decentralized AI operating system (dAIOS) that operates transparently, safely, and under community influence. Centralized AI structures may lack these attributes, creating potential risks for data integrity and security. The 0G Foundation’s goal is to develop AI as a public good, fostering an ecosystem that prioritizes transparency and reduces reliance on central authorities, making it suitable for broad public utility. +The objective of 0G Foundation: The 0G Foundation’s node sale aims to create a decentralized AI operating system (deAIOS) that operates transparently, safely, and under community influence. Centralized AI structures may lack these attributes, creating potential risks for data integrity and security. The 0G Foundation’s goal is to develop AI as a public good, fostering an ecosystem that prioritizes transparency and reduces reliance on central authorities, making it suitable for broad public utility. ## What is an AI Alignment Node? Alignment nodes provide the key utility of monitoring whether the other kinds of decentralized nodes in the 0G network - validator nodes, storage nodes, security nodes - faithfully follow network protocols. To start, the nodes will have certain utility, and in the near future, AI Alignment Nodes will have additional utility to monitor on-chain AI model drift and to ensure that 0G’s on-chain AI is behaving as intended. diff --git a/docs/preface.md b/docs/preface.md index f9b4f73..ea6af06 100644 --- a/docs/preface.md +++ b/docs/preface.md @@ -13,7 +13,7 @@ Limitless, abundant productivity and creativity brought by AGI will free humanit However, our current computing infrastructure is [insufficient](https://www.goldmansachs.com/insights/articles/AI-poised-to-drive-160-increase-in-power-demand) to support the development of AGI, and even more alarming is that this immense power is concentrated in the [hands of a few](https://www.ftc.gov/policy/advocacy-research/tech-at-ftc/2023/10/consumers-are-voicing-concerns-about-ai). -A global-scale technology revolution requires both a global-scale technological infrastructure and a global-scale alignment mechanism. A world AI infrastructure could leapfrog the confines of data-centers and support exponential scaling towards AGI so that humanity could benefit from unlimited intelligence. A global scale coordination and alignment mechanism ensure that the benefits of AI can be widely, fairly, and safely distributed. +A global-scale technology revolution requires both a global-scale technological infrastructure and a global-scale alignment mechanism. A world AI infrastructure could leapfrog the confines of data centers and support exponential scaling towards AGI so that humanity could benefit from unlimited intelligence. A global-scale coordination and alignment mechanism ensures that the benefits of AI can be widely, fairly, and safely distributed.
@@ -40,20 +40,20 @@ A global-scale technology revolution requires both a global-scale technological
-## The First Decentralized AI [Operating System](https://edu.gcfglobal.org/en/computerbasics/understanding-operating-systems/1/) (dAIOS) +## The First Decentralized AI [Operating System](https://edu.gcfglobal.org/en/computerbasics/understanding-operating-systems/1/) (deAIOS) 0G is building the global foundation for a better, fairer, and more open AI ecosystem, where power is distributed and innovation thrives. -With 0G dAIOS, the **TOMA** (transparent, owned, monetized, and aligned) future for AGI is near: +With 0G deAIOS, the **TOMA** (transparent, owned, monetized, and aligned) future for AGI is near: - **Transparency**: Centralized AI systems operate as black boxes, with opaque decision-making processes and no clear data provenance. Users who provide training data rarely receive adequate rewards for their contributions, and the system lacks transparency in how value is distributed. _Decentralized AI fosters transparency by providing open, auditable decision-making processes and verifiable data sources, ensuring accountability at every step._ **0G’s modular architecture enables transparent data traceability and verifiable AI models, making every decision and data source traceable.** -- **Ownership**: Centralized AI platforms often sell or misuse personal data, with users having little control or ownership over how their information is collected, stored, or used. _Blockchain technology empowers users to retain control over their data, deciding how and when it’s used. _**With 0G, users can store and manage data on-chain through decentralized storage networks, retaining full ownership and control.** +- **Ownership**: Centralized AI platforms often sell or misuse personal data, with users having little control or ownership over how their information is collected, stored, or used. _Blockchain technology empowers users to retain control over their data, deciding how and when it’s used._ **With 0G, users can store and manage data on-chain through decentralized storage networks, retaining full ownership and control.** - **Monetization**: Centralized AI systems often monopolize profits and leave little incentive for individual contributors. _Blockchain enables the issuance of rewards to incentivize participation and subsequently distribute rewards in a fair and transparent manner._ **Users of 0G’s storage, data availability, or serving platforms pay a small fee for these services, and these rewards are then distributed to the nodes.** - **Alignment**: Centralized AI systems lack oversight and governance processes. A select group may have the authority to censor or promote material, leading to misalignment with human values. _Decentralized AI platforms promote collective governance and oversight by increasing access to AI development, fostering inclusivity and innovation by a broader community rather than a single entity._ **0G provides access to lower-cost compute resources, lowering the high cost barrier to entry for inference, fine-tuning, and training.** -As the first dAIOS, 0G brings together models, compute and data on a single global platform, enabling developers to build AI applications that are more **PLG** (performant, limitless, and global) than ever before: +As the first deAIOS, 0G brings together models, compute, and data on a single global platform, enabling developers to build AI applications that are more **PLG** (performant, limitless, and global) than ever before: - **Performant**: Currently, developers and researchers lack access to high-grade computing and storage resources, limiting their ability to advance at the cutting edge of AI development. _Decentralized GPU networks that run on blockchains provide high-performance compute resources pooled by the community and available to all._ **0G provides access to enterprise-grade compute resources, enabling developers to build AI applications that are more performant than ever before.** diff --git a/docs/run-a-node/community-docker-repo.md b/docs/run-a-node/community-docker-repo.md index 56aeaca..abfe3b5 100644 --- a/docs/run-a-node/community-docker-repo.md +++ b/docs/run-a-node/community-docker-repo.md @@ -1,23 +1,16 @@ ---- -id: community-docker-repo -title: Community Docker Repo -sidebar_position: 6 ---- - +# Community Docker Repository --- -This section provides a list of Docker images 🐳 for 0G DA from the community. For instructions on running 0G nodes via a binary, please visit the node pages directly. +This section provides a list of Docker images 🐳 for 0G DA from the community. For instructions on running 0G nodes via binary installation, please visit the node pages directly. -For most users, Docker offers the simplest method to get 0G nodes up and running. Docker is a platform for containerization, allowing 0G nodes to operate in an isolated environment. This approach enables you to run 0G nodes on your system without the need to install and configure all the necessary dependencies manually. +For most users, Docker offers the simplest method to get 0G nodes up and running. Docker is a platform for containerization, allowing 0G nodes to operate in an isolated environment. This approach enables you to run 0G nodes on your system without needing to install and configure all the necessary dependencies manually. -Most of the officially endorsed 0G docker implementation can be found under the documentation page for each 0G node type.. +Most of the officially endorsed 0G Docker implementations can be found under the documentation page for each 0G node type. -Below is a list of community-maintained Docker images for 0G DA. Please note that these images are not officially endorsed by 0G and users should proceed with caution. +Below is a list of community-maintained Docker images for 0G DA. Please note that these images are not officially endorsed by 0G, and users should proceed with caution. ### All Node Types [Ember Stake](https://docs.emberstake.xyz/networks/zero-gravity/nodes-guide/getting-started) ### Validator Node [CryptoWarden](https://medium.com/@CryptoWarden/guide-to-running-a-node-in-the-0g-labs-project-0g-ai-1bee56ea53ca) - - diff --git a/docs/run-a-node/da-node.md b/docs/run-a-node/da-node.md index 8e8873d..501417a 100644 --- a/docs/run-a-node/da-node.md +++ b/docs/run-a-node/da-node.md @@ -6,14 +6,15 @@ import TabItem from '@theme/TabItem'; # Data Availability Node --- -While there are various approaches to running a DA (Data Availability) node, this guide outlines our recommended method and the necessary hardware specifications. DA Nodes perform the core functions of verifying, signing, and storing encoded blob data. It's important to note that your DA signer needs to operate a DA node to verify encoded blob data, sign it, and store it for future farming and rewards. Currently, in order to run a DA Node on Testnet, users must stake 10 A0GI tokens. These can be obtained via our [faucet](https://faucet.0g.ai/) or via rewards from running Storage Nodes or Validator Nodes. You can also reach out to our technical moderators on [Discord](https://discord.com/invite/0glabs). +While there are various approaches to running a DA (Data Availability) node, this guide outlines our recommended method and the necessary hardware specifications. DA Nodes perform the core functions of verifying, signing, and storing encoded blob data. + +To operate effectively, your DA signer needs to run a DA node to verify encoded blob data, sign it, and store it for future farming and rewards. Currently, to run a DA Node on Testnet, users must stake 10 A0GI tokens. These can be obtained through our [faucet](https://faucet.0g.ai/) or via rewards from running Storage Nodes or Validator Nodes. You can also reach out to our technical moderators on [Discord](https://discord.com/invite/0glabs). ## Hardware Requirements | Node Type | Memory | CPU | Disk | Bandwidth | Additional Notes | |-----------|--------|-----|------|-----------|------------------| -| DA Node | 16 GB | 8 cores | 1 TB NVME SSD | 100 MBps | For Download / Upload | - +| DA Node | 16 GB | 8 cores | 1 TB NVMe SSD | 100 MBps | For Download/Upload | ## Standing up a DA Node and DA Signer @@ -104,7 +105,7 @@ As a DA node operator, your node will perform the following tasks: ### Conclusion -You have now successfully set up and run a 0g DA node as a DA Signer. For more advanced configuration options and usage instructions, please refer to the official GitHub repository. +You have now successfully set up and run a 0g DA node as a DA Signer. For more advanced configuration options and usage instructions, please refer to the [Official GitHub repository](https://github.com/0glabs/0g-da-node). Remember to keep your private keys secure and regularly update your node software to ensure optimal performance and security. @@ -223,7 +224,7 @@ As a DA node operator, your node will perform the following tasks: ## Conclusion -You have now successfully set up and run a 0g DA node as a DA Signer. For more advanced configuration options and usage instructions, please refer to the official GitHub repository. +You have now successfully set up and run a 0g DA node as a DA Signer. For more advanced configuration options and usage instructions, please refer to the [Official GitHub repository](https://github.com/0glabs/0g-da-node). Remember to keep your private keys secure and regularly update your node software to ensure optimal performance and security. diff --git a/docs/run-a-node/overview.md b/docs/run-a-node/overview.md index 337b279..d76b8f7 100644 --- a/docs/run-a-node/overview.md +++ b/docs/run-a-node/overview.md @@ -6,7 +6,7 @@ sidebar_position: 1 --- Want to become an active participant in the 0G network and earn rewards while you're at it? 👇 -Each node type plays a crucial role in maintaining the 0G network's functionality, from transaction validation and data storage to ensuring data availability and retrieval. Here, we'll introduce you to the various types of nodes you can run, each playing a crucial role in maintaining the network's health and security. +Each node type plays a crucial role in maintaining the 0G network's functionality, from transaction validation and data storage to ensuring data availability and retrieval. Here, we'll introduce you to the various types of nodes you can run, each contributing to the network's health and security. ### What Nodes Can I Run? @@ -14,10 +14,10 @@ Each node type plays a crucial role in maintaining the 0G network's functionalit The guardians of the network, validator nodes are responsible for verifying transactions, ensuring consensus, and maintaining the blockchain. They're essential for keeping the 0G blockchain secure and running smoothly. ##### **Storage Nodes** -Unlike the Validator Nodes that focus on securing the blockchain itself, Storage Nodes focus on managing and serving data. They are the backbone of the network's data storage capabilities, ensuring persistence and long-term availability for long-term data storage (e.g. training datasets, large AI models). By running a storage node, you'll be contributing to the decentralized storage of 0G data, making it accessible and resilient. +Unlike Validator Nodes that focus on securing the blockchain itself, Storage Nodes focus on managing and serving data. They are the backbone of the network's data storage capabilities, ensuring persistence and availability for long-term data storage (e.g., training datasets, large AI models). By running a storage node, you'll contribute to the decentralized storage of 0G data, making it accessible and resilient. ##### **Data Availability Services** -DA Nodes are similar to Storage Nodes, but they are focused on immediacy and short-term accessibility to support real-time operations. This data is typically used by Layer 2 and rollup solutions for data availability and is not typically stored long-term. Think of these nodes as the librarians of the network, ensuring that data stored on the network can be quickly retrieved when needed. +DA Nodes are similar to Storage Nodes but focus on immediacy and short-term accessibility to support real-time operations. This data is typically used by Layer 2 and rollup solutions for data availability and is not typically stored long-term. Think of these nodes as the network's librarians, ensuring that data can be quickly retrieved when needed. ### Why Run a Node? @@ -37,7 +37,7 @@ We've made it easy to get started. The table below outlines the hardware require | DA Encoder* | Encodes data for availability purposes | - | - | - | - | | DA Client | Interacts with the Data Availability layer | 8 GB | 2 cores | - | 100 MBps | -*Note: DA Encoder Note: GPU support is currently tested with NVIDIA 12.04 drivers on the RTX 4090. Other NVIDIA GPUs may require parameter adjustments and have not been tuned yet.* +*Note: For DA Encoder, GPU support is currently tested with NVIDIA 12.04 drivers on the RTX 4090. Other NVIDIA GPUs may require parameter adjustments and have not been tuned yet.* #### Next Steps Ready to set up your node? Check out our detailed guides: diff --git a/docs/run-a-node/storage-node.md b/docs/run-a-node/storage-node.md index e0a19d8..ae7aab9 100644 --- a/docs/run-a-node/storage-node.md +++ b/docs/run-a-node/storage-node.md @@ -10,7 +10,7 @@ This guide details the process of running a storage node, including hardware spe | Component | Storage Node | Storage KV | |-----------|--------------|------------| -| Memory | 32 GB RAM | 32 GB RAM | +| Memory | 32 GB RAM | 32 GB RAM | | CPU | 8 cores | 8 cores | | Disk | 500GB / 1TB NVMe SSD | Size matches the KV streams it maintains | | Bandwidth | 100 Mbps (Download / Upload) | - | @@ -55,7 +55,7 @@ Start by installing all the essential tools and libraries required to build the ``` -**Install `rustup`**: (`rustup`) is the Rust toolchain installer, necessary as the 0G node software is written in Rust. +**Install `rustup`**: rustup is the Rust toolchain installer, necessary as the 0G node software is written in Rust. ```bash curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh @@ -156,8 +156,7 @@ cd run Before setting up your 0G Storage KV node: - Understand that 0G KV interacts with on-chain contracts and storage nodes to simulate KV data streams. -- For official deployed contract addresses, visit the [official 0G documentation page]. - Follow the same steps to install dependencies and Rust as in the storage node setup: +- For official deployed contract addresses, visit the [testnet information page](./testnet-information.md). ## Install Dependencies @@ -176,7 +175,7 @@ Follow the same steps to install dependencies and Rust as in the storage node se ``` -**Install `rustup`**: (`rustup`) is the Rust toolchain installer, necessary as the 0G node software is written in Rust. +**Install `rustup`**: rustup is the Rust toolchain installer, necessary as the 0G node software is written in Rust. ```bash curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh diff --git a/docs/run-a-node/testnet-information.md b/docs/run-a-node/testnet-information.md index f7a422f..d499dac 100644 --- a/docs/run-a-node/testnet-information.md +++ b/docs/run-a-node/testnet-information.md @@ -14,7 +14,7 @@ Summary Table | Chain Name | 0G-Newton-Testnet | | Chain ID | 16600 (`zgtendermint_16600-2`) | | Token Symbol | A0GI | -| **Recommended RPC** - Thirdweb | https://16600.rpc.thirdweb.com/ | +| **Recommended RPC** - Thirdweb | https://16600.rpc.thirdweb.com/ | | RPC - Ankr | https://rpc.ankr.com/0g_newton | | RPC | https://evmrpc-testnet.0g.ai | | Storage Indexer Standard RPC | https://indexer-storage-testnet-standard.0g.ai | @@ -30,14 +30,17 @@ Summary Table ### Highly Recommended Third-party RPCs - [Thirdweb](https://thirdweb.com/0g-newton-testnet) -- [Ankr](https://rpc.ankr.com/0g_newton) +- [Ankr](https://www.ankr.com/rpc/0g/) +- [QuickNode](https://www.quicknode.com/chains/0g) -### Community RPCs and Resources +### Community RPCs and Resources -- [Originstake](https://0g-json-rpc-public.originstake.com) -- [Validatorvn](https://0g-rpc-evm01.validatorvn.com) -- [Itrocket](https://og-testnet-jsonrpc.itrocket.net) -- [Zstake](https://0g-evmrpc.zstake.xyz/) +| Provider | RPC Endpoint | +|----------|--------------| +| Originstake | https://0g-json-rpc-public.originstake.com | +| Validatorvn | https://0g-rpc-evm01.validatorvn.com | +| Itrocket | https://og-testnet-jsonrpc.itrocket.net | +| Zstake | https://0g-evmrpc.zstake.xyz/ | :::caution Do not rely on the free community endpoints listed above for production deployments. Production deployments should rely on service providers with SLAs or your own node. diff --git a/docs/run-a-node/validator-node.md b/docs/run-a-node/validator-node.md index 0de773e..afb7305 100644 --- a/docs/run-a-node/validator-node.md +++ b/docs/run-a-node/validator-node.md @@ -122,7 +122,7 @@ For the testnet, due to stress testing with a large number of transactions, a fu ### Troubleshooting -If you encounter any issues during the setup or operation of your validator node, please consult our [FAQ section](../learn-more/how-to-contribute.md) or reach out to our community support channels. +If you encounter any issues during the setup or operation of your validator node, please consult our [FAQ section](./testnet-information.md#node-faq-frequently-asked-questions) or reach out to our community support channels. ### Next Steps diff --git a/sidebars.ts b/sidebars.ts index dcd9704..c366fd3 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -12,7 +12,9 @@ const sidebars: SidebarsConfig = { id: 'intro', }, items: [ + '0g-chain', '0g-storage', + '0g-compute', { type: 'category', label: '0G DA', @@ -21,8 +23,6 @@ const sidebars: SidebarsConfig = { 'da/0g-da-deep-dive', ], }, - '0g-compute', - '0g-chain', ], }, {