Holochain Key-Value Store

A distributed key-value store built on Holochain.

Quick Start

./scripts/install.sh   # Install dependencies
./scripts/build.sh     # Build the hApp
./scripts/run.sh       # Start the conductor
./scripts/test.sh      # Run integration tests

How do I install?

./scripts/install.sh

This installs Rust, the WASM target, Holochain CLI, and creates the conductor directories.

How do I run a node?

./scripts/build.sh     # Build the hApp first
./scripts/run.sh       # Start the conductor
./scripts/stop.sh      # Stop the conductor

The conductor runs via zinit (if available) or screen as a fallback.

How do I call the chain?

Use the CLI client:

# Build the CLI
cargo build --manifest-path cli/Cargo.toml

# Example commands (with conductor running)
./cli/target/debug/holokvs --port 8888 --app-id kv_store set mykey "Hello World"
./cli/target/debug/holokvs --port 8888 --app-id kv_store get mykey
./cli/target/debug/holokvs --port 8888 --app-id kv_store list
./cli/target/debug/holokvs --port 8888 --app-id kv_store delete mykey

For signed operations, provide an X25519 private key:

./cli/target/debug/holokvs --port 8888 --app-id kv_store set mykey "value" --x25519-sk <hex-key>

Where do I change logic?

• Zome logic: zomes/coordinator/src/lib.rs
• Data model & validation: zomes/integrity/src/lib.rs
• CLI client: cli/src/main.rs

Project Structure

holo_ledger/
├── scripts/            # Build, run, and test scripts
├── zomes/
│   ├── coordinator/    # Application logic
│   └── integrity/      # Data model & validation
├── cli/                # Rust CLI client
├── conductor/          # Conductor config and data
├── workdir/            # DNA/hApp manifests
└── zinit/              # Process management

License

MIT