From a156b6d104d846cc6d438a6d1368485e7eafd7e0 Mon Sep 17 00:00:00 2001
From: murilo ijanc
Date: Tue, 24 Mar 2026 23:48:42 -0300
Subject: Add brief project description to README

---
 README.md | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index e70a247..8cbe3d7 100644
--- a/README.md
+++ b/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).
+
-- 
cgit v1.2.3