commit - 9821aabf0b50d2487b07502d3d2cd89e7d62bdbe
commit + a156b6d104d846cc6d438a6d1368485e7eafd7e0
blob - e70a2473d25b28576abc9ce6e15fbd8323feb532
blob + 8cbe3d7d4fb0f72f9d48c4e28c2717573785c397
--- README.md
+++ README.md
@@ -1,5 +1,26 @@
-# tesseras-dht
+# Tesseras-DHT
 
+A NAT-aware Kademlia DHT library for Rust, designed for decentralized peer-to-peer networking.
+
+## Features
+
+- Distributed key-value storage (iterative FIND_NODE, FIND_VALUE, STORE)
+- NAT traversal via DTUN hole-punching and proxy relay
+- Reliable Datagram Protocol (RDP) with 7-state connection machine
+- Datagram transport with automatic fragmentation/reassembly
+- Ed25519 packet authentication
+- 256-bit node IDs (Ed25519 public keys)
+- Rate limiting, ban list, and eclipse attack mitigation
+- Persistence and metrics
+
+## Links
+
+- [Website](https://tesseras.net)
+- [Source code](https://got.tesseras.net/?action=summary&path=tesseras-dht.git) (primary)
+- [Source hut mirror](https://git.sr.ht/~ijanc/tesseras)
+- [GitHub mirror](https://github.com/ijanc/tesseras)
+
 ## License
 
-ISC
+ISC — see [LICENSE](LICENSE).
+