E M 4f816d5001
move dockerhub username from secret to variable
GitHub's secret masking is value-based, not reference-based: any string equal to a registered secret's value gets scrubbed from logs and refused as a step/job output. Because secrets: inherit registers every secret with the reusable workflow, storing the public DockerHub namespace as a secret poisons every output containing it.

This means the `logos_storage_image` output was masked because its value (logosstorage/...) contains the DOCKERHUB_USERNAME secret value (logosstorage, the public org name). With secrets: inherit, that secret is registered for masking and GitHub skipped the output entirely. So commit #1463's intent ("feed the test job from the build output instead of re-guessing the tag") was silently defeated — the tests only passed because the k8s manifest falls back to a hardcoded `latest-dist-tests` tag.
2026-06-22 14:42:50 +10:00
2023-03-08 12:45:55 +01:00
2021-02-02 19:29:52 +01:00
2021-12-20 13:12:18 -06:00

Logos Storage Filesharing Client

The Logos Storage project aims to create a filesharing client that allows sharing data privately in p2p networks.

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

To build the project, clone it and run:

make update && make
# Tip: use -j{ncpu} to for parallel execution, eg:
# make -j12 update && make -j12

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

Run the client with:

build/storage

Configuration

It is possible to configure a Logos Storage 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 build/storage --help for more information.

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.

Bindings

Logos Storage provides a C API that can be wrapped by other languages. The C API bindings are located in the library folder.

Currently, only Go bindings are provided in this repo. However, Rust bindings for Logos Storage can be found at https://github.com/nipsysdev/storage-rust-bindings.

Build the C library

make libstorage

This produces the shared library under build/.

Run the Go example

See https://github.com/logos-storage/logos-storage-go-bindings-example.

Static vs Dynamic build

By default, Logos Storage builds a dynamic library (libstorage.so/libstorage.dylib/libstroage.dll), which you can load at runtime.

If you prefer a static library (libstorage.a), set the STATIC flag:

# Build dynamic (default)
make libstorage

# Build static
make STATIC=1 libstorage

Limitation

Callbacks must be fast and non-blocking; otherwise, the working thread will hang and prevent other requests from being processed.

Contributing and development

Feel free to dive in, contributions are welcomed! Open an issue or submit PRs.

Linting and formatting

logos-storage-nim uses nph for formatting our code and it is required to adhere to its styling. If you are setting up fresh setup, in order to get nph run make build-nph. In order to format files run make nph/<file/folder you want to format>. If you want you can install Git pre-commit hook using make install-nph-commit, which will format modified files prior committing them. If you are using VSCode and the NimLang extension you can enable "Format On Save" (eq. the nim.formatOnSave property) that will format the files using nph.

Description
Decentralized Durability Engine
Readme
Languages
Nim 89.7%
Python 3.9%
C 3.3%
Shell 1.2%
Makefile 0.9%
Other 0.9%