Skip to content

Holo-Host/h2hc-linker

Repository files navigation

h2hc-linker

CI License: CAL-1.0

Warning

Alpha software. h2hc-linker is under active development. APIs may change between releases. Not yet recommended for production use.

Network edge gateway providing DHT access for lightweight browser clients.

Overview

h2hc-linker is designed to serve zero-arc Holochain nodes that don't participate in gossip. Instead, these lightweight clients (like browser extensions) fetch and publish data through the gateway.

API

See API.md for full endpoint documentation.

Building

cargo build --release

Running

# Default: localhost:8090
./target/release/h2hc-linker

# Custom address/port
./target/release/h2hc-linker --address 0.0.0.0 --port 8080

# Environment variables
H2HC_LINKER_ADDRESS=0.0.0.0 H2HC_LINKER_PORT=8080 ./target/release/h2hc-linker

Configuration

Environment variables:

Variable Description Default
H2HC_LINKER_ADDRESS Bind address 127.0.0.1
H2HC_LINKER_PORT Bind port 8090
H2HC_LINKER_BOOTSTRAP_URL Kitsune bootstrap server (required)
H2HC_LINKER_RELAY_URL Iroh relay server None
H2HC_LINKER_CONDUCTOR_URL Conductor address for zome call proxying None

Releasing

Releases are triggered by pushing a git tag:

git tag v0.1.0
git push origin v0.1.0

This runs the GitHub Actions release workflow which builds binaries for:

  • Linux x86_64
  • Linux aarch64
  • macOS aarch64 (Apple Silicon)

All binaries are uploaded to a GitHub Release. Tags containing - (e.g., v0.1.0-rc.1) are marked as prereleases.

See COMPATIBILITY.md for version compatibility with the Holo Web Conductor extension.

License

CAL-1.0 (Cryptographic Autonomy License)

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages