From 105c5b63bf7e7528cea49a9fd86bbf5de32ff6b1 Mon Sep 17 00:00:00 2001 From: MayaTheShy Date: Mon, 10 Nov 2025 01:52:02 -0500 Subject: [PATCH] fix: update README to reflect connection drop issue due to server-side HMAC verification --- README.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 1c40902..ca75eb0 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,18 @@ Starworld is an [Overte](https://overte.org) client that renders virtual world entities inside the [StardustXR](https://stardustxr.org) compositor. It bridges Overte's entity protocol with Stardust's spatial computing environment, allowing you to view and interact with Overte domains in XR. -**Current Status:** ✨ **3D model rendering with HTTP asset downloading!** Entities render as GLTF/GLB models loaded from the local cache. ModelCache automatically downloads models from http:// and https:// URLs to `~/.cache/starworld/models/`. Primitive models (cube, sphere, suzanne) are pre-generated in `~/.cache/starworld/primitives/` using Blender. +**Current Status:** ⚠️ **Connection establishes but drops after 11-18 seconds due to server-side HMAC verification issue.** + +✨ **Working Features:** +- Complete DomainConnectRequest implementation with OAuth authentication +- Local ID assignment and parsing (fixed byte order bugs) +- 3D model rendering with HTTP asset downloading +- ModelCache automatically downloads models from http:// and https:// URLs to `~/.cache/starworld/models/` +- Primitive models (cube, sphere, suzanne) pre-generated in `~/.cache/starworld/primitives/` +- HMAC-MD5 packet verification implementation (correct but blocked by server config) + +⚠️ **Known Issue:** +Connection is killed after 11-18 seconds due to HMAC verification deadlock on the server side. See [`docs/NETWORK_PROTOCOL_INVESTIGATION.md`](docs/NETWORK_PROTOCOL_INVESTIGATION.md) for detailed analysis. The client implementation is correct; the issue is server-side configuration where HMAC verification is required but not properly initialized for new nodes. ### About the Technologies