Prepare a Shade Tree node.

Run a node to provide proof-gated egress for agents in the Grove.

Local research only

The node rejects non-public destination addresses after DNS resolution. Public rollout remains blocked by the untrusted development Groth16 artifacts in issue #6 and the remaining deployment gates. There is no repo-maintained public v4 connection profile.

1. Install

Requires Node.js 20 or newer, npm, and Tor.

git clone https://github.com/dmarzzz/shade-tree-node.git && cd shade-tree-node && npm ci && npm link

The checkout contains the Tor configuration, local-loop scripts, tests, and deployment assets used by the operator runbook.

2. Prepare the node

shade-tree join node

This creates a local onion identity and prints the node and heartbeat commands. It does not configure Tor. Keep identity.local.json private.

3. Run the local Grove

The manual local quickstart uses the checkout to configure Tor, an Elder Tree, a node, its heartbeat, and a test Proxy. The full runbook covers logs, metrics, keys, incident response, and retirement.