Go to file
dependabot[bot] 116046366a
Bump thread_local from 1.1.3 to 1.1.8 in /version-meld/discv5 (#140)
Bumps [thread_local](https://github.com/Amanieu/thread_local-rs) from 1.1.3 to 1.1.8.
- [Commits](https://github.com/Amanieu/thread_local-rs/compare/v1.1.3...1.1.8)

---
updated-dependencies:
- dependency-name: thread_local
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-07-22 15:51:45 +08:00
.gitbook/assets @peter/doc (#22) 2024-03-24 22:37:46 +08:00
.github Use inner lock in storage and use async lock. (#92) 2024-06-29 17:08:02 +08:00
0g-storage-contracts@25bc14a274 Support multiple mine submission (#124) 2024-07-12 17:31:53 +08:00
common Generate sync proof with the given tx seq. (#123) 2024-07-12 15:55:57 +08:00
docs Docs improvements (#82) 2024-07-11 14:10:57 +08:00
node feat: add all_shards in admin_getFileLocation (#138) 2024-07-22 11:28:05 +08:00
run feat: file location admin rpc; refactor: all_shards_available (#134) 2024-07-19 11:55:18 +08:00
scripts @peter/update config script (#106) 2024-07-03 08:22:02 +08:00
tests Handle chunk write of rpc in parallel. (#126) 2024-07-15 15:50:51 +08:00
version-meld Bump thread_local from 1.1.3 to 1.1.8 in /version-meld/discv5 (#140) 2024-07-22 15:51:45 +08:00
.bookignore @peter/doc (#22) 2024-03-24 22:37:46 +08:00
.gitignore Change miner id logic & request miner id automatically (#60) 2024-04-27 11:15:57 +08:00
.gitmodules Remove cli build from server build workflow (#54) 2024-04-23 14:35:24 +08:00
Cargo.lock feat: file location admin rpc; refactor: all_shards_available (#134) 2024-07-19 11:55:18 +08:00
Cargo.toml Implement Pruner to delete unwanted data. (#70) 2024-05-31 13:11:06 +08:00
codecov.yml Initial commit 2024-01-04 18:05:32 +08:00
contributing.md @peter/doc (#22) 2024-03-24 22:37:46 +08:00
LICENSE.lighthouse Initial commit 2024-01-04 18:05:32 +08:00
NOTICE @peter/doc (#22) 2024-03-24 22:37:46 +08:00
README.md Docs improvements (#82) 2024-07-11 14:10:57 +08:00
requirements.txt add readme for python tests (#5) 2024-01-19 21:26:33 +08:00
rust-toolchain fix build dependency isuse (#12) 2024-01-26 19:48:40 +08:00
rustlint.sh fix build dependency isuse (#12) 2024-01-26 19:48:40 +08:00
SUMMARY.md @peter/doc (#22) 2024-03-24 22:37:46 +08:00

0G Storage

Overview

0G Storage is the storage layer for the ZeroGravity data availability (DA) system. The 0G Storage layer holds three important features:

  • Buit-in - It is natively built into the ZeroGravity DA system for data storage and retrieval.
  • General purpose - It is designed to support atomic transactions, mutable kv stores as well as archive log systems to enable wide range of applications with various data types.
  • Incentive - Instead of being just a decentralized database, 0G Storage introduces PoRA mining algorithm to incentivize storage network participants.

To dive deep into the technical details, continue reading 0G Storage Spec.

Integration

We provide a SDK for users to easily integrate 0G Storage in their applications with the following features:

  • File Merkle Tree Class
  • Flow Contract Types
  • RPC methods support
  • File upload
  • Support browser environment
  • Tests for different environments (In Progress)
  • File download (In Progress)

Deployment

Please refer to Deployment page for detailed steps to compile and start a 0G Storage node.

Test

Prerequisites

  • Required python version: 3.8, 3.9, 3.10, higher version is not guaranteed (e.g. failed to install pysha3).
  • Install dependencies under root folder: pip3 install -r requirements.txt

Dependencies

Python test framework will launch blockchain fullnodes at local for storage node to interact with. There are 2 kinds of fullnodes supported:

  • Conflux eSpace node (by default).
  • BSC node (geth).

For Conflux eSpace node, the test framework will automatically compile the binary at runtime, and copy the binary to tests/tmp folder. For BSC node, the test framework will automatically download the latest version binary from github to tests/tmp folder.

Alternatively, you could also manually copy specific version binaries (conflux or geth) to the tests/tmp folder. Note, do NOT copy released conflux binary on github, since block height of some CIPs are hardcoded.

For testing, it's also dependent on the following repos:

  • 0G Storage Contract: It essentially provides two abi interfaces for 0G Storage Node to interact with the on-chain contracts.
    • ZgsFlow: It contains apis to submit chunk data.
    • PoraMine: It contains apis to submit PoRA answers.
  • 0G Storage Client: It is used to interact with certain 0G Storage Nodes to upload/download files.

Run Tests

Go to the tests folder and run the following command to run all tests:

python test_all.py

or, run any single test, e.g.

python sync_test.py

Contributing

To make contributions to the project, please follow the guidelines here.