Decentralized Storage
Go to file
Ben Bierens 308dda1b8b
Fix manifestItem in openapi.yaml
treeCid and datasetSize were misnamed.

Signed-off-by: Ben Bierens <39762930+benbierens@users.noreply.github.com>
2024-10-29 11:47:41 +01:00
.github Build Postman Collection (#973) 2024-10-28 13:53:41 +00:00
benchmarks
codex feat: add metadata to the manifest (#960) 2024-10-25 13:43:19 +00:00
docker Use CLI args when passed for cirdl in Docker entrypoint (#927) 2024-10-01 13:05:22 +00:00
metrics
tests feat: add metadata to the manifest (#960) 2024-10-25 13:43:19 +00:00
tools/cirdl Adds log for cirdl download URL (#948) 2024-10-10 12:05:03 +00:00
vendor feat: partial rewards and withdraws (#880) 2024-10-10 11:53:33 +00:00
.dockerignore
.editorconfig
.gitignore Add MIT/Apache licenses (#861) 2024-08-13 15:38:17 +00:00
.gitmodules Rework circuit downloader (#882) 2024-09-23 14:37:17 +00:00
LICENSE-APACHEv2 Remove extra license file (#876) 2024-08-19 09:48:03 +00:00
LICENSE-MIT Add MIT/Apache licenses (#861) 2024-08-13 15:38:17 +00:00
Makefile Rework circuit downloader (#882) 2024-09-23 14:37:17 +00:00
README.md Remove moved docs (#930) 2024-10-03 08:55:54 +00:00
build.nims Rework circuit downloader (#882) 2024-09-23 14:37:17 +00:00
codecov.yml
codex.nim Rework circuit downloader (#882) 2024-09-23 14:37:17 +00:00
codex.nimble remove stale and misleading dependency version metadata (#833) 2024-06-17 14:31:10 +00:00
config.nims Chronos v4 Update (v3 Compat Mode) (#814) 2024-07-18 21:04:33 +00:00
env.sh
openapi.yaml Fix manifestItem in openapi.yaml 2024-10-29 11:47:41 +01:00

README.md

Codex Decentralized Durability Engine

The Codex project aims to create a decentralized durability engine that allows persisting data in p2p networks. In other words, it allows storing files and data with predictable durability guarantees for later retrieval.

WARNING: This project is under active development and is considered pre-alpha.

License: Apache License: MIT Stability: experimental CI Docker Codecov Discord Docker Pulls

Build and Run

For detailed instructions on preparing to build nim-codex see Build Codex.

To build the project, clone it and run:

make update && make

The executable will be placed under the build directory under the project root.

Run the client with:

build/codex

Configuration

It is possible to configure a Codex node in several ways:

  1. CLI options
  2. Environment variables
  3. Configuration file

The order of priority is the same as above: CLI options --> Environment variables --> Configuration file.

Please check documentation for more information.

Guides

To get acquainted with Codex, consider:

API

The client exposes a REST API that can be used to interact with the clients. Overview of the API can be found on api.codex.storage.