easylibstorage/README.md

Storage Console

A command-line interface for interacting with libstorage, providing simple file upload and download operations via a distributed storage network.

Prerequisites

• CMake 3.14+
• C11 compiler
• libstorage (build or get binary from logos-storage-nim)

Building

cmake -B build -DLOGOS_STORAGE_NIM_ROOT=/path/to/logos-storage-nim
cmake --build build

Running

./build/storageconsole

Commands

Command	Description
help	Prints available commands
start [API_PORT] [DISC_PORT] [DATA_DIR] [BOOTSTRAP_NODE]	Creates and starts a storage node
stop	Stops and destroys the node
upload [PATH]	Uploads a local file; displays progress and prints CID
download [CID] [PATH]	Downloads content by CID to a local path
quit	Exits the program

Example Session

> start 8080 9090 ./data <bootstrap SPR>
Creating node...
Starting node...
Node started on API port 8080, discovery port 9090.

> upload /path/to/file.txt
Uploading /path/to/file.txt...
  1024 / 1024 bytes
CID: QmXyz...

> download QmXyz... /path/to/output.txt
Downloading QmXyz... to /path/to/output.txt...
  1024 / 1024 bytes
Download complete.

> quit
Quitting...

Testing

cmake --build build
./build/test_runner

Project Structure

storageconsole/
├── main.c              # Console application
├── easylibstorage.h    # Simplified libstorage API
├── easylibstorage.c    # API implementation
├── tests/
│   ├── test_runner.c   # Unit tests
│   └── mock_libstorage.c
└── CMakeLists.txt

License

Dual-licensed under Apache 2.0 and MIT.