0G Documentation

https://github.com/0gfoundation/0g-doc
Admin
Official technical documentation for 0G, the trust layer for AI: private compute, encrypted storage,...
Tokens:214,999
Snippets:1,899
Trust Score:9.5
Update:1 week ago
Show doc for...
Tokens:
Raw
================
LIBRARY RULES
================
- 0G is the trust layer for AI. It combines private compute, encrypted storage, and an AI-native EVM L1 chain in one stack where AI work, from inference to agent actions, is verified and audited.
- Network configs, contract addresses, SDK package names and endpoints are consolidated in docs/ai-context.md; prefer it over older third-party summaries.
- Mainnet is chain id 16661 (RPC https://evmrpc.0g.ai); Galileo testnet is chain id 16602 (RPC https://evmrpc-testnet.0g.ai). Chain id 16601 is retired.
- Compute SDK is @0gfoundation/0g-compute-ts-sdk (CLI 0g-compute-cli); @0glabs/0g-serving-broker is deprecated. Storage SDK is @0gfoundation/0g-storage-ts-sdk.
- Every page is also available as markdown by appending .md to its URL; https://docs.0g.ai/llms.txt is the sectioned index and https://docs.0g.ai/llms-full.txt the full corpus.
- Company and project information lives at https://0g.ai, the builder-focused overview at https://build.0g.ai, and how to get the 0G token at https://get.0g.ai.

================
CODE SNIPPETS
================
### Direct SDK Quick Start - CLI setup and funding

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/ai-context.md

Install the 0G Compute CLI, set up the network, log in with a wallet private key, deposit funds, list providers, and transfer funds to a provider. The transfer-fund command auto-acknowledges.

```bash
# Install CLI
pnpm add @0gfoundation/0g-compute-ts-sdk -g

# Setup + fund
0g-compute-cli setup-network
0g-compute-cli login                                    # prompts for wallet private key
0g-compute-cli deposit --amount 10
0g-compute-cli inference list-providers
0g-compute-cli transfer-fund --provider <PROVIDER_ADDRESS> --amount 5  # auto-acknowledges

# Get a per-provider secret key
0g-compute-cli inference get-secret --provider <PROVIDER_ADDRESS>
```

--------------------------------

### TypeScript Starter Kit - Upload a File

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/storage/sdk.md

Clone the TypeScript starter kit, install dependencies, configure your private key, and upload a file. This is a quick start example for uploading a file in under 5 minutes.

```bash
git clone https://github.com/0gfoundation/0g-storage-ts-starter-kit
cd 0g-storage-ts-starter-kit && npm install
cp .env.example .env   # Add your PRIVATE_KEY
npm run upload -- ./file.txt
```

--------------------------------

### Quick start setup commands

Source: https://github.com/0gfoundation/0g-doc/blob/main/README.md

Use these commands to set up the development environment. Requires Node 24 (minimum 22) and pnpm 11. The lockfile is pnpm-lock.yaml; do not use yarn or npm.

```bash
nvm use                          # picks up .nvmrc
corepack enable                  # activates the pinned pnpm
pnpm install --frozen-lockfile   # same as CI
pnpm start                       # dev server with live reload
```

--------------------------------

### Quick Setup Checklist: Install Dependencies and Set Environment Variables

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/agentic-id/integration.md

Install required npm packages and set environment variables for 0G testnet RPC, storage, and compute URLs. Use this before deploying contracts or integrating Agentic IDs.

```bash
# Install dependencies
npm install @0gfoundation/0g-storage-ts-sdk ethers hardhat

# Set environment variables
export PRIVATE_KEY="your-private-key"
export OG_RPC_URL="https://evmrpc-testnet.0g.ai"
export OG_STORAGE_URL="https://storage-testnet.0g.ai"
export OG_COMPUTE_URL="https://compute-testnet.0g.ai"
```

--------------------------------

### Install 0G Storage Go SDK

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/ai-context.md

Install the 0G storage Go client via go get.

```bash
go get github.com/0gfoundation/0g-storage-client
```

--------------------------------

### Download Base Model with huggingface-cli

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning.md

Install huggingface_hub and download the base model used for fine-tuning. The example shows commands for Qwen2.5-0.5B-Instruct and a commented-out command for Qwen3-32B, which requires ~65GB disk space.

```bash
# Install huggingface-cli if not already installed
pip install huggingface_hub

# For Qwen2.5-0.5B-Instruct
huggingface-cli download Qwen/Qwen2.5-0.5B-Instruct --local-dir ./base_model

# For Qwen3-32B (requires ~65GB disk space)
# huggingface-cli download Qwen/Qwen3-32B --local-dir ./base_model
```

--------------------------------

### Install and use 0G Compute CLI

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/ai-context.md

Install the 0G Compute TypeScript SDK globally and start the web UI or use CLI commands for network setup, login, deposit, and listing providers. The web UI opens at http://localhost:3090.

```bash
# Install global CLI
pnpm add @0gfoundation/0g-compute-ts-sdk -g

# Option 1: Web UI (fastest way to start)
0g-compute-cli ui start-web
# Open http://localhost:3090, connect wallet, start using AI

# Option 2: CLI for automation
0g-compute-cli setup-network  # Choose testnet/mainnet
0g-compute-cli login           # Connect your wallet
0g-compute-cli deposit --amount 10  # Fund account
0g-compute-cli inference list-providers  # See available services
```

--------------------------------

### Install Go SDK

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/ai-context.md

Installation command for the 0G Storage Go SDK.

```APIDOC
## Install Go SDK

### Description
Install the 0G Storage Go client library.

### Command
```bash
go get github.com/0gfoundation/0g-storage-client
```
```

--------------------------------

### Install Docker

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning-provider.md

Downloads and installs Docker using the official script.

```bash
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
```

--------------------------------

### Start Geth

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/validator-node.md

Starts the Geth execution client with the provided configuration. Requires placeholders for node IP, datadir, network ID, and log path.

```bash
nohup ./bin/geth --config geth-config.toml \
     --nat extip:{your_node_ip} \
     --datadir {your_geth_datadir} \
     --networkid {network_id} > {your_log_path}/geth.log 2>&1 &
```

--------------------------------

### Initialize project and install dependencies

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/agentic-id/integration.md

Commands to create a new project directory, initialize npm, install required dependencies (0G storage SDK, OpenZeppelin contracts, ethers, hardhat, and hardhat-toolbox), and initialize Hardhat.

```bash
# Create new project
mkdir my-agentic-id-project && cd my-agentic-id-project
npm init -y

# Install required dependencies
npm install @0gfoundation/0g-storage-ts-sdk @openzeppelin/contracts ethers hardhat
npm install --save-dev @nomicfoundation/hardhat-toolbox

# Initialize Hardhat
npx hardhat init
```

--------------------------------

### Start Geth

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/archival-node.md

Start the Geth client in the background with the archive configuration, using the provided bootnodes and network ID.

```bash
cd galileo-v1.2.0
nohup ./bin/geth \
    --config geth-archive-config.toml \
    --nat extip:{your node ip} \
    --bootnodes enode://de7b86d8ac452b1413983049c20eafa2ea0851a3219c2cc12649b971c1677bd83fe24c5331e078471e52a94d95e8cde84cb9d866574fec957124e57ac6056699@8.218.88.60:30303 \
    --datadir /{your data path}/0g-home/geth-home \
    --state.scheme=hash \
    --gcmode archive \
    --networkid 16602 > /{your data path}/0g-home/log/geth.log 2>&1 &
```

--------------------------------

### Initialize Hardhat project

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/ai-context.md

Install Hardhat and the toolbox, then initialize a new project.

```bash
npm install --save-dev hardhat @nomicfoundation/hardhat-toolbox
npx hardhat init
```

--------------------------------

### CLI Tool - Install and Upload with 0g-storage-client

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/ai-context.md

Build the Go CLI from 0g-storage-client and upload a file. Includes commands for installation, basic upload, and upload with client-side encryption (AES-256-CTR).

```bash
# Install
git clone https://github.com/0gfoundation/0g-storage-client.git
cd 0g-storage-client
go build

# Upload file
0g-storage-client upload \
  --url https://evmrpc-testnet.0g.ai \
  --key YOUR_PRIVATE_KEY \
  --indexer https://indexer-storage-testnet-turbo.0g.ai \
  --file /path/to/file

# Upload with client-side encryption (AES-256-CTR)
0g-storage-client upload \
  --url https://evmrpc-testnet.0g.ai \
  --key YOUR_PRIVATE_KEY \
  --indexer https://indexer-storage-testnet-turbo.0g.ai \
  --file /path/to/file \
  --encryption-key <hex_key>
```

--------------------------------

### Setup Network

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning.md

Run the setup-network command to configure the network environment.

```bash
# Setup network
0g-compute-cli setup-network
```

--------------------------------

### Install TypeScript SDK

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/ai-context.md

Installation command for the 0G Storage TypeScript SDK.

```APIDOC
## Install TypeScript SDK

### Description
Install the 0G Storage TypeScript SDK and ethers library.

### Command
```bash
npm install @0gfoundation/0g-storage-ts-sdk ethers
```
```

--------------------------------

### Directory structure after setup

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/archival-node.md

Shows the expected directory layout after a successful archival node setup.

```text
{your data path}/
└── 0g-home/
    ├── geth-home/
    ├── 0gchaind-home/
    │   ├── config/
    │   │   ├── node_key.json
    │   │   └── priv_validator_key.json
    │   └── data/
    │       └── priv_validator_state.json
    └── log/
        ├── 0gchaind.log
        └── geth.log
```

--------------------------------

### Install SDK Package

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/account-management.md

Installs the TypeScript SDK for programmatic access to the 0G Compute Network.

```bash
pnpm add @0gfoundation/0g-compute-ts-sdk
```

--------------------------------

### Install dependencies on Linux

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/storage-node.md

Use apt-get to install required build tools and libraries for the 0G storage node on Linux.

```bash
sudo apt-get update
sudo apt-get install clang cmake build-essential pkg-config libssl-dev protobuf-compiler
```

--------------------------------

### Verify setup by checking logs

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/archival-node.md

Tail the Geth and 0gchaind logs to confirm the node is running correctly.

```bash
# Check Geth logs
tail -f /{your data path}/0g-home/log/geth.log

# Check 0gchaind logs
tail -f /{your data path}/0g-home/log/0gchaind.log
```

--------------------------------

### Setup Network

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/account-management.md

Run 0g-compute-cli setup-network to choose the network (testnet or mainnet) for the CLI environment.

```bash
0g-compute-cli setup-network
```

--------------------------------

### Example Output of get-log Command

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning.md

Example output from the get-log command, showing training steps and a success message.

```bash
creating task....
Step: 0, Logs: {'loss': ..., 'accuracy': ...}
...
Training model for task beb6f0d8-4660-4c62-988d-00246ce913d2 completed successfully
```

--------------------------------

### Start the CVM

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning-provider.md

Starts the CVM instance using dstack run with sudo.

```bash
sudo -E dstack run my-gpu-cvm
```

--------------------------------

### Install 0G Storage TypeScript SDK

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/ai-context.md

Install the 0G storage TypeScript SDK and ethers via npm.

```bash
npm install @0gfoundation/0g-storage-ts-sdk ethers
```

--------------------------------

### Install 0G Compute SDK globally

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/account-management.md

Install the @0gfoundation/0g-compute-ts-sdk package globally using pnpm. Required for both Web UI and CLI interfaces.

```bash
pnpm add @0gfoundation/0g-compute-ts-sdk -g
```

--------------------------------

### SDK Installation

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/inference.md

Install the 0G Compute TypeScript SDK for application integration and programmatic access.

```APIDOC
## SDK Installation

### Description
Install the 0G Compute TypeScript SDK for application integration and programmatic access.

### Method
Package Manager

### Command
pnpm add @0gfoundation/0g-compute-ts-sdk

### Example
```bash
pnpm add @0gfoundation/0g-compute-ts-sdk
```
```

--------------------------------

### Install Other ML Libraries

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning.md

Install transformers, peft, and accelerate for model loading, LoRA adapter support, and device management.

```bash
# Install other ML libraries
pip install transformers peft accelerate
```

--------------------------------

### Copy and edit the environment file

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/node-sale/ai-alignment-node-user-guide.md

Copies the example environment file and opens it in the nano editor for configuration.

```bash
cp .env.example .env
```

```bash
nano .env
```

--------------------------------

### Start the 0G DA node

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/da-node.md

Run this command to start the 0G DA node using the configuration file you created.

```bash
./target/release/server --config config.toml
```

--------------------------------

### Install Packages for CPU-Only Environments

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning.md

Install PyTorch and ML libraries for CPU-only environments without CUDA support.

```bash
pip install torch transformers peft accelerate
```

--------------------------------

### Start Geth execution client

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/validator-node.md

Launches Geth with the provided configuration, external IP, and network ID 16602, in the background with logging.

```bash
cd ~/galileo-v3.0.4

nohup ./bin/geth \
    --config geth-config.toml \
    --nat extip:{your node ip} \
    --datadir {your data path}/0g-home/geth-home \
    --networkid 16602 > {your data path}/0g-home/log/geth.log 2>&1 &
```

--------------------------------

### config.toml example configuration

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/storage-node.md

Example configuration for the storage node, including stream IDs, database directories, log sync settings, RPC options, and misc settings. Placeholders like BLOCKCHAIN_RPC_ENDPOINT and LOG_CONTRACT_ADDRESS must be replaced with actual values.

```toml
#######################################################################
###                   Key-Value Stream Options                      ###
#######################################################################

# Streams to monitor.
stream_ids = ["000000000000000000000000000000000000000000000000000000000000f2bd", "000000000000000000000000000000000000000000000000000000000000f009", "0000000000000000000000000000000000000000000000000000000000016879", "0000000000000000000000000000000000000000000000000000000000002e3d"]

#######################################################################
###                     DB Config Options                           ###
#######################################################################

# Directory to store data.
db_dir = "db"
# Directory to store KV Metadata.
kv_db_dir = "kv.DB"

#######################################################################
###                     Log Sync Config Options                     ###
#######################################################################

blockchain_rpc_endpoint = "BLOCKCHAIN_RPC_ENDPOINT" #rpc endpoint, see testnet information
log_contract_address = "LOG_CONTRACT_ADDRESS" #flow contract address, see testnet information
# log_sync_start_block_number should be earlier than the block number of the first transaction that writes to the stream being monitored.
log_sync_start_block_number = 0

#######################################################################
###                     RPC Config Options                          ###
#######################################################################

# Whether to provide RPC service.
rpc_enabled = true

# HTTP server address to bind for public RPC.
rpc_listen_address = "0.0.0.0:6789"

# Zerog storage nodes to download data from.
zgs_node_urls = "http://127.0.0.1:5678,http://127.0.0.1:5679"

#######################################################################
###                     Misc Config Options                         ###
#######################################################################

log_config_file = "log_config"
```

--------------------------------

### Start 0gchaind

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/archival-node.md

Start the 0gchaind service in the background with the specified configuration flags, including pruning set to nothing for archival mode.

```bash
cd galileo-v1.2.0
nohup ./bin/0gchaind start \
    --rpc.laddr tcp://0.0.0.0:26657 \
    --chaincfg.chain-spec devnet \
    --chaincfg.kzg.trusted-setup-path=kzg-trusted-setup.json \
    --chaincfg.engine.jwt-secret-path=jwt-secret.hex \
    --chaincfg.kzg.implementation=crate-crypto/go-kzg-4844 \
    --chaincfg.block-store-service.enabled \
    --chaincfg.node-api.enabled \
    --chaincfg.node-api.logging \
    --chaincfg.node-api.address 0.0.0.0:3500 \
    --pruning=nothing \
    --home /{your data path}/0g-home/0gchaind-home \
    --p2p.seeds 85a9b9a1b7fa0969704db2bc37f7c100855a75d9@8.218.88.60:26656 \
    --p2p.external_address {your node ip}:26656 > /{your data path}/0g-home/log/0gchaind.log 2>&1 &
```

--------------------------------

### Copy and edit config.toml

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/storage-node.md

Copy the example configuration file to config.toml and open it in the nano editor for updates.

```bash
cp config_example.toml config.toml
nano config.toml
```

--------------------------------

### Launch Web UI

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/account-management.md

Start the 0G Compute Web UI with the command 0g-compute-cli ui start-web. Access the interface at http://localhost:3090/wallet.

```bash
0g-compute-cli ui start-web
```

--------------------------------

### Start reth (execution layer) on mainnet

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/migrate-geth-to-reth.md

Launches reth with the provided genesis and configuration. Ensure the engine API is ready before starting the consensus layer.

```bash
nohup ./bin/reth node \
    --chain geth-genesis.json \
    --http \
    --http.addr 0.0.0.0 \
    --http.api eth,net,admin \
    --authrpc.addr 0.0.0.0 \
    --authrpc.jwtsecret jwt.hex \
    --datadir $DATA_DIR/reth-home \
    --ipcpath $DATA_DIR/reth-home/eth-engine.ipc \
    --engine.persistence-threshold 0 \
    --engine.memory-block-buffer-target 0 \
    --bootnodes="enode://2bf74c837a98c94ad0fa8f5c58a428237d2040f9269fe622c3dbe4fef68141c28e2097d7af6ebaa041194257543dc112514238361a6498f9a38f70fd56493f96@8.221.140.134:30303" \
    --nat extip:$MY_NODE_IP \
    >> $DATA_DIR/log/reth.log 2>&1 &
```

--------------------------------

### Copy config.example.yaml to config.local.yaml

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning-provider.md

Duplicates the example configuration file to create the local configuration file that you will edit.

```bash
cp config.example.yaml config.local.yaml
```

--------------------------------

### Start the alignment node

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/node-sale/ai-alignment-node-user-guide.md

Starts the node in mainnet mode, either in the foreground or in the background using nohup.

```bash
./0g-alignment-node start --mainnet
```

```bash
nohup ./0g-alignment-node start --mainnet > node.log 2>&1 &
```

--------------------------------

### Install dependencies on Mac

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/storage-node.md

Use Homebrew to install required build tools for the 0G storage node on macOS.

```bash
brew install llvm cmake
```

--------------------------------

### Start local proxy server with 0g-compute-cli

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/inference.md

Run a local OpenAI-compatible server using the 0G compute CLI. The first command starts the server on the default port 3000, and the second shows how to specify a custom port with --port.

```bash
# Start server on port 3000 (default)
0g-compute-cli inference serve --provider <PROVIDER_ADDRESS>

# Custom port
0g-compute-cli inference serve --provider <PROVIDER_ADDRESS> --port 8080
```

--------------------------------

### Install 0G Compute CLI

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning.md

Install the 0G Compute CLI globally using pnpm. Requires Node version >= 22.0.0.

```bash
pnpm install @0gfoundation/0g-compute-ts-sdk -g
```

--------------------------------

### Start Geth

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/validator-node.md

Launches the Geth execution client with the specified configuration, external IP, data directory, and network ID. Runs in the background with nohup and logs to geth.log.

```bash
cd ~/aristotle-v1.0.7

nohup ./bin/geth \
    --config geth-config.toml \
    --nat extip:{your node ip} \
    --datadir {your data path}/0g-home/geth-home \
    --networkid 16661 > {your data path}/0g-home/log/geth.log 2>&1 &
```

--------------------------------

### Install other dependencies

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/da-integration.md

Installs protobuf compiler, a specific nightly Rust toolchain with rustfmt, and adds the necessary Rust target.

```bash
# Install Protocol Buffers Compiler
sudo apt-get install -y protobuf-compiler

# Install a specific nightly Rust toolchain and rustfmt
rustup toolchain install nightly-2024-02-04-x86_64-unknown-linux-gnu
rustup component add --toolchain nightly-2024-02-04-x86_64-unknown-linux-gnu rustfmt

# Add the necessary Rust target
rustup target add x86_64-unknown-linux-gnu
```

--------------------------------

### Start 0gchaind consensus client

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/validator-node.md

Launches 0gchaind with testnet parameters, including restaking and block-store service, in the background with logging.

```bash
cd ~/galileo-v3.0.4

nohup ./bin/0gchaind start \
    --rpc.laddr tcp://0.0.0.0:26657 \
    --chaincfg.chain-spec testnet \
    --chaincfg.kzg.trusted-setup-path=kzg-trusted-setup.json \
    --chaincfg.engine.jwt-secret-path=jwt.hex \
    --chaincfg.block-store-service.enabled \
    --chaincfg.restaking.enabled \
    --chaincfg.restaking.symbiotic-rpc-dial-url ${ETH_RPC_URL} \
    --chaincfg.restaking.symbiotic-get-logs-block-range ${BLOCK_NUM} \
    --home {your data path}/0g-home/0gchaind-home \
    --p2p.external_address {your node ip}:26656 > {your data path}/0g-home/log/0gchaind.log 2>&1 &
```

--------------------------------

### Example Output of get-task Command

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning.md

Example output from the get-task command, showing a table with task details including the progress status 'Delivered'.

```bash
┌───────────────────────────────────┬─────────────────────────────────────────────────────────────────────────────────────┐
│ Field                             │ Value                                                                               │
├───────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────────────┤
│ ID                                │ beb6f0d8-4660-4c62-988d-00246ce913d2                                                │
├───────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────────────┤
│ Created At                        │ 2025-03-11T01:20:07.644Z                                                            │
├───────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────────────┤
│ Pre-trained Model Hash            │ 0xcb42b5ca9e998c82dd239ef2d20d22a4ae16b3dc0ce0a855c93b52c7c2bab6dc                  │
├───────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────────────┤
│ Dataset Hash                      │ 0xaae9b4e031e06f84b20f10ec629f36c57719ea512992a6b7e2baea93f447a5fa                  │
├───────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────────────┤
│ Training Params                   │ {......}                                                                            │
├───────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────────────┤
│ Fee (neuron)                      │ 82                                                                                  │
├───────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────────────┤
│ Progress                          │ Delivered                                                                           │
└───────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────────────┘
```

--------------------------------

### Install dependencies for building the DA node

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/da-node.md

Installs required system packages (clang, cmake, build-essential, pkg-config, libssl-dev, protobuf-compiler, llvm, llvm-dev) via apt.

```bash
sudo apt-get update && sudo apt-get install clang cmake build-essential pkg-config libssl-dev protobuf-compiler llvm llvm-dev
```

--------------------------------

### Start Indexer Service with a Trusted Node List

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/storage/storage-cli.md

Alternative way to start the indexer service using a comma-separated list of trusted nodes instead of a single node endpoint.

```bash
0g-storage-client indexer \
  --endpoint :12345 \
  --trusted <node1,node2>
```

--------------------------------

### Start execution layer (reth)

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/migrate-geth-to-reth.md

Starts the reth execution layer with HTTP and engine API configuration. Runs in the background and logs to $DATA_DIR/log/reth.log.

```bash
nohup ./bin/reth node \
    --chain geth-genesis.json \
    --http \
    --http.addr 0.0.0.0 \
    --http.api eth,net,admin \
    --authrpc.addr 0.0.0.0 \
    --authrpc.jwtsecret jwt.hex \
    --datadir $DATA_DIR/reth-home \
    --ipcpath $DATA_DIR/reth-home/eth-engine.ipc \
    --engine.persistence-threshold 0 \
    --engine.memory-block-buffer-target 0 \
    --bootnodes="enode://4f70c6c95329427be4af2a233c9c2305896d37c21bca8c21e7efc36634a862bd5b96b0c4a8a9bb5787b53eb01472fe895aad170d0923f6ea56ebc5f94825c4f7@34.105.23.36:30303" \
    --nat extip:$MY_NODE_IP \
    >> $DATA_DIR/log/reth.log 2>&1 &
```

--------------------------------

### Start Gateway Service with a Local File Repo

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/storage/storage-cli.md

Optionally specify a local file repository with --repo when running the gateway service.

```bash
0g-storage-client gateway \
  --nodes <storage_node_endpoint> \
  --repo <local_path>
```

--------------------------------

### Start Web UI on Alternate Port

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/inference.md

Starts the web UI on port 3091 to avoid conflicts with another service using port 3090.

```bash
0g-compute-cli ui start-web --port 3091
```

--------------------------------

### Start 0gchaind for mainnet (Aristotle)

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/validator-node.md

Starts the 0gchaind node for the mainnet (Aristotle) using --chaincfg.chain-spec mainnet. Requires environment variables ETH_RPC_URL, BLOCK_NUM, and placeholders for home, node IP, and log path. If priv_validator_state.json is missing, create it with {}.

```bash
nohup ./bin/0gchaind start \
    --rpc.laddr tcp://0.0.0.0:26657 \
    --chaincfg.chain-spec mainnet \
    --chaincfg.restaking.enabled \
    --chaincfg.restaking.symbiotic-rpc-dial-url ${ETH_RPC_URL} \
    --chaincfg.restaking.symbiotic-get-logs-block-range ${BLOCK_NUM} \
    --chaincfg.kzg.trusted-setup-path=kzg-trusted-setup.json \
    --chaincfg.engine.jwt-secret-path=jwt.hex \
    --chaincfg.block-store-service.enabled \
    --home {your_cl_home} \
    --p2p.external_address {your_node_ip}:26656 > {your_log_path}/0gchaind.log 2>&1 &
```

--------------------------------

### Navigate to the run directory

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/storage-node.md

Change into the run directory before starting the KV service.

```bash
cd run
```

--------------------------------

### Start consensus layer (0gchaind)

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/migrate-geth-to-reth.md

Starts the 0gchaind consensus layer with required flags for KZG, JWT, block store, and restaking. Runs in the background and logs to $DATA_DIR/log/0gchaind.log.

```bash
nohup ./bin/0gchaind start \
    --rpc.laddr tcp://0.0.0.0:26657 \
    --chaincfg.kzg.trusted-setup-path=kzg-trusted-setup.json \
    --chaincfg.engine.jwt-secret-path=jwt.hex \
    --chaincfg.block-store-service.enabled \
    --chaincfg.restaking.enabled \
    --chaincfg.restaking.symbiotic-get-logs-block-range 1000 \
    --chaincfg.restaking.symbiotic-rpc-dial-url $ETH_RPC_URL \
    --home $DATA_DIR/0gchaind-home \
    --p2p.external_address $MY_NODE_IP:26656 \
    >> $DATA_DIR/log/0gchaind.log 2>&1 &
```

--------------------------------

### Start 0gchaind for testnet (Galileo)

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/validator-node.md

Starts the 0gchaind node for the testnet (Galileo) using --chaincfg.chain-spec testnet. Requires environment variables ETH_RPC_URL, BLOCK_NUM, and placeholders for home, node IP, and log path. If priv_validator_state.json is missing, create it with {}.

```bash
nohup ./bin/0gchaind start \
    --rpc.laddr tcp://0.0.0.0:26657 \
    --chaincfg.chain-spec testnet \
    --chaincfg.restaking.enabled \
    --chaincfg.restaking.symbiotic-rpc-dial-url ${ETH_RPC_URL} \
    --chaincfg.restaking.symbiotic-get-logs-block-range ${BLOCK_NUM} \
    --chaincfg.kzg.trusted-setup-path=kzg-trusted-setup.json \
    --chaincfg.engine.jwt-secret-path=jwt.hex \
    --chaincfg.block-store-service.enabled \
    --home {your_cl_home} \
    --p2p.external_address {your_node_ip}:26656 > {your_log_path}/0gchaind.log 2>&1 &
```

--------------------------------

### Verify Rust installation

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/da-integration.md

Checks the installed Rust version to confirm the installation was successful.

```bash
rustc --version
```

--------------------------------

### Rollback to geth if migration fails

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/migrate-geth-to-reth.md

Stop all processes, restore geth data from backup, and start geth and 0gchaind using the previous startup commands.

```bash
# Stop all processes
pkill -f 0gchaind
pkill -f reth

# Restore geth data from backup
rm -rf $DATA_DIR/geth-home
cp -r $BACKUP_DIR/geth-home $DATA_DIR/geth-home

# Start geth and 0gchaind using the previous startup commands
```

--------------------------------

### Install Rust via curl

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/da-integration.md

Installs Rust using the official rustup script. Requires curl to be installed.

```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

--------------------------------

### 0g-compute-cli inference serve

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/inference.md

Start a local OpenAI-compatible server to serve inference requests.

```APIDOC
## 0g-compute-cli inference serve

### Description
Start a local OpenAI-compatible server to serve inference requests.

### Method
CLI

### Command
0g-compute-cli inference serve --provider <PROVIDER_ADDRESS> [--port <PORT>]

### Parameters
- **--provider** (string) - Required - The provider address.
- **--port** (integer) - Optional - The port to run the server on (default: 3000).

### Example
```bash
# Start server on port 3000 (default)
0g-compute-cli inference serve --provider <PROVIDER_ADDRESS>

# Custom port
0g-compute-cli inference serve --provider <PROVIDER_ADDRESS> --port 8080
```

### Response
Starts a local server. Use any OpenAI-compatible client to connect to `http://localhost:3000`.
```

--------------------------------

### Build and start Docker container

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/da-node.md

Builds the Docker image and runs the container in detached mode.

```bash
docker build -t 0g-da-node .
docker run -d --name 0g-da-node 0g-da-node
```

--------------------------------

### Add 0G DA configuration to getting_started.json

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/rollups-and-appchains/op-stack-on-0g-da.md

Append this JSON block to the bottom of getting_started.json to enable 0G DA.

```json
{
  "useAltDA": true,
  "daCommitmentType": "GenericCommitment",
  "daChallengeWindow": 160,
  "daResolveWindow": 160,
  "daBondSize": 1000000,
  "daResolverRefundPercentage": 0
}
```

--------------------------------

### Start 0gchaind (consensus layer) on mainnet

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/migrate-geth-to-reth.md

Launches the 0gchaind consensus client with the required configuration for mainnet, including restaking and engine settings.

```bash
nohup ./bin/0gchaind start \
    --rpc.laddr tcp://0.0.0.0:26657 \
    --chaincfg.kzg.trusted-setup-path=kzg-trusted-setup.json \
    --chaincfg.engine.jwt-secret-path=jwt.hex \
    --chaincfg.block-store-service.enabled \
    --chaincfg.restaking.enabled \
    --chaincfg.restaking.symbiotic-get-logs-block-range 1 \
    --chaincfg.restaking.symbiotic-rpc-dial-url $ETH_RPC_URL \
    --home $DATA_DIR/0gchaind-home \
    --p2p.external_address $MY_NODE_IP:26656 \
    >> $DATA_DIR/log/0gchaind.log 2>&1 &
```

--------------------------------

### Get node command help

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/node-sale/ai-alignment-node-user-guide.md

Displays help for the alignment node binary and its subcommands.

```bash
./0g-alignment-node --help

./0g-alignment-node <command> --help
```

--------------------------------

### Run op-proposer

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/rollups-and-appchains/op-stack-on-0g-da.md

Starts the op-proposer to submit state roots to L1. Requires the L2 output oracle address and proposer private key.

```bash
cd ~/optimism/op-proposer
./bin/op-proposer \
  --poll-interval=12s \
  --rpc.port=9560 \
  --rollup-rpc=http://localhost:8547 \
  --l2oo-address=$L2OO_ADDR \
  --private-key=$GS_PROPOSER_PRIVATE_KEY \
  --l1-eth-rpc=$L1_RPC_URL
```

--------------------------------

### Verify Docker Installation

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning-provider.md

Checks the Docker version and runs a test container to confirm installation.

```bash
docker --version
docker run hello-world
```

--------------------------------

### Start Gateway Service with Storage Nodes

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/storage/storage-cli.md

Runs the 0g-storage-client gateway service to provide HTTP access to storage, specifying the storage node endpoint(s) with --nodes.

```bash
0g-storage-client gateway \
  --nodes <storage_node_endpoint>
```

--------------------------------

### Run op-node

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/rollups-and-appchains/op-stack-on-0g-da.md

Starts the op-node consensus client with sequencer enabled and Alt-DA enabled. Requires environment variables for L1 RPC and sequencer private key, and a DA server URL.

```bash
cd ~/optimism/op-node
./bin/op-node \
  --l2=http://localhost:9551 \
  --l2.jwt-secret=./jwt.txt \
  --sequencer.enabled \
  --sequencer.l1-confs=5 \
  --verifier.l1-confs=4 \
  --rollup.config=./rollup.json \
  --rpc.addr=0.0.0.0 \
  --rpc.port=8547 \
  --p2p.disable \
  --rpc.enable-admin \
  --p2p.sequencer.key=$GS_SEQUENCER_PRIVATE_KEY \
  --l1=$L1_RPC_URL \
  --l1.rpckind=$L1_RPC_KIND \
  --altda.enabled=true \
  --altda.da-server=<DA_SERVER_HTTP_URL> \
  --altda.da-service=true \
  --l1.beacon.ignore=true
```

--------------------------------

### Verify CUDA installation

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/da-integration.md

Checks the NVIDIA driver and CUDA toolkit versions to confirm the CUDA installation.

```bash
nvidia-smi
nvcc --version
```

--------------------------------

### 0g-compute-cli setup-network

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/ai-context.md

Set up the network configuration for the Direct SDK CLI.

```APIDOC
## 0g-compute-cli setup-network

### Description
Set up the network configuration for the Direct SDK CLI.

### Method
CLI

### Command
0g-compute-cli setup-network

### Parameters
None

### Response
No response body.
```

--------------------------------

### Launch Local KMS

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning-provider.md

Starts the local Key Management Service (KMS) that provides keys for CVM initialization.

```bash
cd private-ml-sdk/meta-dstack-nvidia/dstack/key-provider-build/
./run.sh
```

--------------------------------

### Check dependencies with versions.sh

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/rollups-and-appchains/op-stack-on-0g-da.md

Runs the getting-started versions script to verify dependencies.

```bash
./packages/contracts-bedrock/scripts/getting-started/versions.sh
```

--------------------------------

### Start 0gchaind

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/validator-node.md

Launches the 0gchaind consensus client with validator-specific parameters for restaking and external address. The command runs in the background with nohup and logs to 0gchaind.log.

```bash
cd ~/aristotle-v1.0.7

nohup ./bin/0gchaind start \
    --rpc.laddr tcp://0.0.0.0:26657 \
    --chaincfg.kzg.trusted-setup-path=kzg-trusted-setup.json \
    --chaincfg.engine.jwt-secret-path=jwt.hex \
    --chaincfg.block-store-service.enabled \
    --chaincfg.restaking.enabled \
    --chaincfg.restaking.symbiotic-rpc-dial-url ${ETH_RPC_URL} \
    --chaincfg.restaking.symbiotic-get-logs-block-range ${BLOCK_NUM} \
    --home {your data path}/0g-home/0gchaind-home \
    --p2p.external_address {your node ip}:26656 > {your data path}/0g-home/log/0gchaind.log 2>&1 &
```

--------------------------------

### Import trimmed RLP into reth (background)

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/migrate-geth-to-reth.md

Starts reth import in the background using the trimmed export file, logging to reth-import.log.

```bash
nohup ./bin/reth import \
  --chain geth-genesis.json \
  --datadir $DATA_DIR/reth-home \
  /data/0g-home/chain-export-from-1.rlp \
  >> $DATA_DIR/log/reth-import.log 2>&1 &
```

--------------------------------

### Run the KV service with zgs_kv

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/storage-node.md

Starts the storage KV node using the configuration file config.toml. For long-running sessions, consider using tmux or screen to run the node in the background.

```bash
../target/release/zgs_kv --config config.toml
```

--------------------------------

### Output of wallets.sh script

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/rollups-and-appchains/op-stack-on-0g-da.md

Example output from the wallets.sh script showing environment variables to copy into your .envrc file.

```bash
Copy the following into your .envrc file:
  
# Admin address
export GS_ADMIN_ADDRESS=0x9625B9aF7C42b4Ab7f2C437dbc4ee749d52E19FC
export GS_ADMIN_PRIVATE_KEY=0xbb93a75f64c57c6f464fd259ea37c2d4694110df57b2e293db8226a502b30a34
# Batcher address
export GS_BATCHER_ADDRESS=0xa1AEF4C07AB21E39c37F05466b872094edcf9cB1
export GS_BATCHER_PRIVATE_KEY=0xe4d9cd91a3e53853b7ea0dad275efdb5173666720b1100866fb2d89757ca9c5a
  
# Proposer address
export GS_PROPOSER_ADDRESS=0x40E805e252D0Ee3D587b68736544dEfB419F351b
export GS_PROPOSER_PRIVATE_KEY=0x2d1f265683ebe37d960c67df03a378f79a7859038c6d634a61e40776d561f8a2
  
# Sequencer address
export GS_SEQUENCER_ADDRESS=0xC06566E8Ec6cF81B4B26376880dB620d83d50Dfb
export GS_SEQUENCER_PRIVATE_KEY=0x2a0290473f3838dbd083a5e17783e3cc33c905539c0121f9c76614dda8a38dca
```

--------------------------------

### Run testnet storage service

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/storage-node.md

Starts the testnet storage node using the specified config file and miner private key. Replace <your_private_key> with your actual key.

```bash
cd run
../target/release/zgs_node --config config.toml --miner-key <your_private_key>
```

--------------------------------

### Create .env file with configuration

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/agentic-id/integration.md

Commands to create a .env file with environment variables for private key and 0G testnet URLs (RPC, storage, compute).

```bash
# Create .env file
cat > .env << EOF
PRIVATE_KEY=your_private_key_here
OG_RPC_URL=https://evmrpc-testnet.0g.ai
OG_STORAGE_URL=https://storage-testnet.0g.ai
OG_COMPUTE_URL=https://compute-testnet.0g.ai
EOF
```

--------------------------------

### Install Hardhat verification plugins

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/contracts-on-0g/deploy-contracts.md

Install the required Hardhat plugins for contract verification: @nomicfoundation/hardhat-verify, @nomicfoundation/viem, @nomicfoundation/hardhat-toolbox-viem, and dotenv.

```bash
npm install --save-dev @nomicfoundation/hardhat-verify @nomicfoundation/viem @nomicfoundation/hardhat-toolbox-viem dotenv 
```

--------------------------------

### Configure config.toml for DA node

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/da-node.md

Example configuration file for the DA node. Fill in the signer_bls_private_key, signer_eth_private_key, and miner_eth_private_key fields with your actual private keys.

```toml
log_level = "info"

data_path = "/data"

# path to downloaded params folder
encoder_params_dir = "/params"

# grpc server listen address
grpc_listen_address = "0.0.0.0:34000"
# chain eth rpc endpoint
eth_rpc_endpoint = "https://evmrpc-testnet.0g.ai"
# public grpc service socket address to register in DA contract
# ip:34000 (keep same port as the grpc listen address)
# or if you have dns, fill your dns
socket_address = "<public_ip/dns>:34000"

# data availability contract to interact with
da_entrance_address = "0x857C0A28A8634614BB2C96039Cf4a20AFF709Aa9" # testnet config
# deployed block number of da entrance contract
start_block_number = 940000 # testnet config

# signer BLS private key
signer_bls_private_key = ""
# signer eth account private key
signer_eth_private_key = ""
# miner eth account private key, (could be the same as `signer_eth_private_key`, but not recommended)
miner_eth_private_key = ""

# whether to enable data availability sampling
enable_das = "true"
```

--------------------------------

### Backup data before upgrade

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/validator-node.md

Create a timestamped backup directory and copy the geth and 0gchaind data directories.

```bash
# Create backup directory with timestamp
BACKUP_DIR="backup-$(date +%Y%m%d-%H%M%S)"
mkdir -p $BACKUP_DIR

# Backup execution layer data (geth-home)
cp -r {your_geth_datadir} $BACKUP_DIR/geth-backup

# Backup consensus layer data (0gchaind-home)
cp -r {your_0gchaind_home} $BACKUP_DIR/0gchaind-backup
```

--------------------------------

### Create fine-tuning task with local dataset (Option A)

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning.md

Uploads the dataset to 0G Storage and creates the task in one step. The fee is automatically calculated by the broker based on the actual token count.

```bash
0g-compute-cli fine-tuning create-task \
  --provider <PROVIDER_ADDRESS> \
  --model <MODEL_NAME> \
  --dataset-path <PATH_TO_DATASET> \
  --config-path <PATH_TO_CONFIG_FILE>
```

--------------------------------

### Install PyTorch with CUDA 11.8

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/compute-network/fine-tuning.md

Install PyTorch with CUDA 11.8 support. Ensure your CUDA version matches your environment.

```bash
# For CUDA 11.8
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
```

--------------------------------

### Initialize op-geth datadir

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/developer-hub/building-on-0g/rollups-and-appchains/op-stack-on-0g-da.md

Initializes the op-geth data directory with the genesis file. Run from the op-geth directory.

```bash
cd ~/op-geth
mkdir datadir
build/bin/geth init --datadir=datadir genesis.json
```

--------------------------------

### Initialize Geth with genesis

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/run-a-node/validator-node.md

Initializes the Geth execution client with the genesis configuration. Expected output: "Successfully wrote genesis state".

```bash
./bin/geth init --datadir {your data path}/0g-home/geth-home ./geth-genesis.json
```

--------------------------------

### Initialize Foundry project

Source: https://github.com/0gfoundation/0g-doc/blob/main/docs/ai-context.md

Initialize a new Foundry project and change into its directory.

```bash
forge init my-project
cd my-project
```
Tokens:
Raw