# Install hsd with Homebrew, Nix Handshake Daemon & Full Node. Version 8.0.0 via Homebrew; verified 2026-06-22. ## Install ```sh sudo av install brew:hsd ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install hsd ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#hsd ``` Evidence: nixpkgs package indexes: pkgs/by-name/hs/hsd/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:hsd - **Package manager:** Homebrew - **Package manager page:** - **Version:** 8.0.0 - **Source summary:** Handshake Daemon & Full Node - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-22T14:03:43-07:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - hs-seeder (cli) - hs-wallet (cli) - hsd (cli) - hsd-cli (cli) - hsd-node (cli) - hsd-rpc (cli) - hsd-spvnode (cli) - hsw-cli (cli) - hsw-rpc (cli) - hs-seeder (alias) - hs-wallet (alias) - hsd (alias) - hsd-cli (alias) - hsd-node (alias) - hsd-rpc (alias) - hsd-spvnode (alias) - hsw-cli (alias) - hsw-rpc (alias) ## Dependencies - node - unbound ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 8.0.0 - Package-manager updated: 2026-06-22 - Local data: ok - Upstream repository: https://github.com/handshake-org/hsd - Upstream latest detected: v8.0.0 (current) ## Project history and usage HSD is the JavaScript full-node and daemon implementation of the Handshake protocol, a decentralized naming and certificate-authority experiment built around a peer-to-peer root zone. ### Project history Handshake's own site identifies hsd as the initial code for the protocol, and the hsd README describes it as an implementation of Handshake. The project grew as a node, wallet, DNS resolver, RPC server, and CLI suite rather than as a single-purpose daemon. The README and install guide show a Node.js-based project distributed from the official GitHub repository, installable from source, Git refs, Homebrew, and container images. The command set includes hsd, hsd-cli, hsw-cli, RPC shortcuts, wallet tools, and seeding utilities. ### Adoption history HSD adoption is tied to Handshake network participation: running a full node, serving recursive or authoritative DNS, managing wallets, mining, claiming names through DNSSEC proofs, and participating in name auctions. The Homebrew and Nix package metadata in the input shows packaging beyond npm-style installation. The release notes show long-running protocol maintenance with network soft forks, database and wallet migrations, API changes, and DNS/name-resolution improvements. That makes hsd closer to Bitcoin-derived node software than to a disposable CLI. ### How it is used Common usage is operational: run hsd as a full node, query it with hsd-cli, manage wallet state with hsw-cli, expose node and wallet HTTP APIs, and configure DNS ports for recursive or authoritative service. The README emphasizes bitcoind-style RPC plus additional REST APIs, name auction commands such as sendopen, sendbid, sendreveal, sendupdate, and DNSSEC-based claim flows. ### Why package nerds care For package maintainers, hsd is significant because it packages a full blockchain/DNS stack with native dependency considerations such as libunbound, network ports, persistent state under ~/.hsd, wallet migrations, and security-sensitive API keys. It is also a good example of an ecosystem package where the formula is not just installing a binary: the package participates in a protocol, has stateful upgrades, and exposes multiple command-line entry points. ### Timeline - 2018-2019: Public v0.x tags and testnet tags appear in the upstream repository. - 2020: v1.0.0 appears in the upstream tag series. - 2023: v6.0.0 release notes include the ICANN Lockup soft fork and configuration changes. - 2024: v7.0.0 release notes describe wallet migrations, interactive rescans, and history API changes. - 2025: v8.0.0 release notes include the End Airdrop soft fork. ### Related projects - Related projects include the Handshake protocol documentation, hs-client for RPC helpers, Bob Wallet as a GUI wallet, bns for DNS-related functionality, and libunbound for recursive resolver support. ### Sources - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.hsd/hsd.conf, ~/.hsd/hsw.conf, ~/.hsd//hsd.conf ## Credential files - Unix: ~/.hsd/hsd.conf, ~/.hsd/hsw.conf ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** hsd - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - hsd: normalized package name match | nixpkgs package indexes: pkgs/by-name/hs/hsd/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Web development packages](https://www.automicvault.com/pkg/web-dev-tools/) - Matched web development metadata. - [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew. - [unbound](https://www.automicvault.com/pkg/brew/unbound/) - Runtime dependency declared by Homebrew. - [btcli](https://www.automicvault.com/pkg/brew/btcli/) - Shares av.db curated category or tags: blockchain, cli, networking. - [floresta](https://www.automicvault.com/pkg/brew/floresta/) - Shares av.db curated category or tags: blockchain, cli, full-node, networking. - [lighthouse](https://www.automicvault.com/pkg/brew/lighthouse/) - Shares av.db curated category or tags: blockchain, cli, networking. - [oasis](https://www.automicvault.com/pkg/brew/oasis/) - Shares av.db curated category or tags: blockchain, cli, networking. - [stellar-core](https://www.automicvault.com/pkg/brew/stellar-core/) - Shares av.db curated category or tags: blockchain, cli, networking. - [teku](https://www.automicvault.com/pkg/brew/teku/) - Shares av.db curated category or tags: blockchain, cli, networking. - [bitcoin](https://www.automicvault.com/pkg/brew/bitcoin/) - Shares av.db curated category or tags: blockchain, cli, full-node, networking. - [ctrld](https://www.automicvault.com/pkg/brew/ctrld/) - Shares av.db curated category or tags: cli, daemon, dns, networking. ## Combined YAML source View the package source record on GitHub. [combined/hsd.yml](https://github.com/automic-vault/db/blob/main/combined/hsd.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph