diff --git a/hsd/doc.go b/hsd/doc.go
new file mode 100644
index 0000000..e1f4cc2
--- /dev/null
+++ b/hsd/doc.go
@@ -0,0 +1,16 @@
+// Copyright (c) 2017-2026 Lethean (https://lt.hn)
+//
+// Licensed under the European Union Public Licence (EUPL) version 1.2.
+// SPDX-License-Identifier: EUPL-1.2
+
+// Package hsd provides a typed client for the HSD (Handshake) sidechain RPC.
+//
+// This package is staged here in go-blockchain temporarily.
+// It moves to go-lns (dappco.re/go/core/lns/hsd) when that repo is created.
+// The LNS (Lethean Name Server) is our fork of Handshake's naming system.
+//
+// When federated regions ship, this may be extracted as a standalone go-hsd
+// package for multi-zone HSD communication.
+//
+// For now: go-blockchain/hsd → go-lns/hsd → go-hsd (future)
+package hsd