Building 70 Projects ranging from beginner to advanced so anyone can β learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company π
Go aicertificationcloud-engineeringcybercybersecuritycybersecurity-analystcybersecurity-certificationcybersecurity-certificationscybersecurity-educationcybersecurity-jobscybersecurity-portfoliocybersecurity-projectscybersecurity-toolsgrchackinglearningpentestingproject-repositoryprojetcspython
Update README.md
Carter Perez561964d16198
diff --git a/PROJECTS/encrypted-p2p-chat/README.md b/PROJECTS/encrypted-p2p-chat/README.mdindex 85dff8c2..26618e1d 100644--- a/PROJECTS/encrypted-p2p-chat/README.md+++ b/PROJECTS/encrypted-p2p-chat/README.md@@ -83,60 +83,190 @@ make down-prod # Stop production environment```encrypted-p2p-chat/-βββ backend/-β βββ app/-β β βββ api/ # API endpoints-β β β βββ auth.py # WebAuthn authentication-β β β βββ encryption.py # Prekey bundle endpoints-β β β βββ websocket.py # WebSocket endpoint-β β βββ core/-β β β βββ encryption/-β β β β βββ x3dh_manager.py # X3DH key exchange-β β β β βββ double_ratchet.py # Double Ratchet engine-β β β βββ passkey/-β β β β βββ passkey_manager.py # WebAuthn manager-β β β βββ exceptions.py # Custom exceptions-β β β βββ redis_manager.py # Redis client-β β β βββ surreal_manager.py # SurrealDB client-β β β βββ websocket_manager.py # WebSocket connections-β β βββ models/ # SQLModel database models-β β βββ schemas/ # Pydantic schemas-β β βββ services/ # Business logic layer-β β βββ config.py # Configuration and constants-β β βββ factory.py # FastAPI app factory-β β βββ main.py # Entry point-β βββ tests/ # Pytest tests-β βββ Dockerfile # Production-β βββ Dockerfile.dev # Development-β βββ pyproject.toml-βββ frontend/-β βββ src/-β β βββ pages/ # SolidJS pages-β β βββ App.tsx # Root component with routes-β β βββ index.tsx # Entry point-β β βββ index.css # Tailwind imports-β β βββ config.ts # Constants-β βββ public/-β β βββ index.html-β βββ Dockerfile # Production-β βββ Dockerfile.dev # Development-β βββ vite.config.ts-β βββ tsconfig.json-β βββ package.json-βββ nginx/-β βββ nginx.dev.conf # Development config-β βββ nginx.prod.conf # Production config-β βββ Dockerfile-βββ docker-compose.yml # Production-βββ docker-compose.dev.yml # Developmentβββ Makefile-βββ .env.example-+βββ README.md+βββ backend+βΒ Β βββ alembic+βΒ Β βΒ Β βββ README+βΒ Β βΒ Β βββ env.py+βΒ Β βΒ Β βββ script.py.mako+βΒ Β βΒ Β βββ versions+βΒ Β βββ alembic.ini+βΒ Β βββ app+βΒ Β βΒ Β βββ api+βΒ Β βΒ Β βΒ Β βββ auth.py+βΒ Β βΒ Β βΒ Β βββ encryption.py+βΒ Β βΒ Β βΒ Β βββ rooms.py+βΒ Β βΒ Β βΒ Β βββ websocket.py+βΒ Β βΒ Β βββ config.py+βΒ Β βΒ Β βββ core+βΒ Β βΒ Β βΒ Β βββ encryption+βΒ Β βΒ Β βΒ Β βΒ Β βββ double_ratchet.py+βΒ Β βΒ Β βΒ Β βΒ Β βββ x3dh_manager.py+βΒ Β βΒ Β βΒ Β βββ enums.py+βΒ Β βΒ Β βΒ Β βββ exception_handlers.py+βΒ Β βΒ Β βΒ Β βββ exceptions.py+βΒ Β βΒ Β βΒ Β βββ passkey+βΒ Β βΒ Β βΒ Β βΒ Β βββ passkey_manager.py+βΒ Β βΒ Β βΒ Β βββ redis_manager.py+βΒ Β βΒ Β βΒ Β βββ surreal_manager.py+βΒ Β βΒ Β βΒ Β βββ websocket_manager.py+βΒ Β βΒ Β βββ factory.py+βΒ Β βΒ Β βββ main.py+βΒ Β βΒ Β βββ models+βΒ Β βΒ Β βΒ Β βββ Base.py+βΒ Β βΒ Β βΒ Β βββ Credential.py+βΒ Β βΒ Β βΒ Β βββ IdentityKey.py+βΒ Β βΒ Β βΒ Β βββ OneTimePrekey.py+βΒ Β βΒ Β βΒ Β βββ RatchetState.py+βΒ Β βΒ Β βΒ Β βββ SignedPrekey.py+βΒ Β βΒ Β βΒ Β βββ SkippedMessageKey.py+βΒ Β βΒ Β βΒ Β βββ User.py+βΒ Β βΒ Β βββ schemas+βΒ Β βΒ Β βΒ Β βββ auth.py+βΒ Β βΒ Β βΒ Β βββ common.py+βΒ Β βΒ Β βΒ Β βββ rooms.py+βΒ Β βΒ Β βΒ Β βββ surreal.py+βΒ Β βΒ Β βΒ Β βββ websocket.py+βΒ Β βΒ Β βββ services+βΒ Β βΒ Β βββ auth_service.py+βΒ Β βΒ Β βββ message_service.py+βΒ Β βΒ Β βββ prekey_service.py+βΒ Β βΒ Β βββ presence_service.py+βΒ Β βΒ Β βββ websocket_service.py+βΒ Β βββ encrypted_p2p_chat.egg-info+βΒ Β βΒ Β βββ PKG-INFO+βΒ Β βΒ Β βββ SOURCES.txt+βΒ Β βΒ Β βββ dependency_links.txt+βΒ Β βΒ Β βββ requires.txt+βΒ Β βΒ Β βββ top_level.txt+βΒ Β βββ pyproject.toml+βΒ Β βββ tests+βΒ Β βββ conftest.py+βΒ Β βββ test_auth_service.py+βΒ Β βββ test_encryption.py+βΒ Β βββ test_message_service.py+βΒ Β βββ test_x3dh.py+βββ conf+βΒ Β βββ docker+βΒ Β βΒ Β βββ dev+βΒ Β βΒ Β βΒ Β βββ fastapi.docker+βΒ Β βΒ Β βΒ Β βββ vite.docker+βΒ Β βΒ Β βββ prod+βΒ Β βΒ Β βββ fastapi.docker+βΒ Β βΒ Β βββ vite.docker+βΒ Β βββ nginx+βΒ Β βββ dev.nginx+βΒ Β βββ http.conf+βΒ Β βββ prod.nginx+βββ docker-compose.dev.yml+βββ docker-compose.prod.yml+βββ frontend+ βββ README.md+ βββ eslint.config.js+ βββ index.html+ βββ package-lock.json+ βββ package.json+ βββ public+ βββ src+ βΒ Β βββ App.tsx+ βΒ Β βββ components+ βΒ Β βΒ Β βββ Auth+ βΒ Β βΒ Β βΒ Β βββ AuthCard.tsx+ βΒ Β βΒ Β βΒ Β βββ AuthForm.tsx+ βΒ Β βΒ Β βΒ Β βββ PasskeyButton.tsx+ βΒ Β βΒ Β βΒ Β βββ index.ts+ βΒ Β βΒ Β βββ Chat+ βΒ Β βΒ Β βΒ Β βββ ChatHeader.tsx+ βΒ Β βΒ Β βΒ Β βββ ChatInput.tsx+ βΒ Β βΒ Β βΒ Β βββ ConversationItem.tsx+ βΒ Β βΒ Β βΒ Β βββ ConversationList.tsx+ βΒ Β βΒ Β βΒ Β βββ EncryptionBadge.tsx+ βΒ Β βΒ Β βΒ Β βββ MessageBubble.tsx+ βΒ Β βΒ Β βΒ Β βββ MessageList.tsx+ βΒ Β βΒ Β βΒ Β βββ NewConversation.tsx+ βΒ Β βΒ Β βΒ Β βββ OnlineStatus.tsx+ βΒ Β βΒ Β βΒ Β βββ TypingIndicator.tsx+ βΒ Β βΒ Β βΒ Β βββ UserSearch.tsx+ βΒ Β βΒ Β βΒ Β βββ index.ts+ βΒ Β βΒ Β βββ Layout+ βΒ Β βΒ Β βΒ Β βββ AppShell.tsx+ βΒ Β βΒ Β βΒ Β βββ Header.tsx+ βΒ Β βΒ Β βΒ Β βββ ProtectedRoute.tsx+ βΒ Β βΒ Β βΒ Β βββ Sidebar.tsx+ βΒ Β βΒ Β βΒ Β βββ index.ts+ βΒ Β βΒ Β βββ UI+ βΒ Β βΒ Β βββ Avatar.tsx+ βΒ Β βΒ Β βββ Badge.tsx+ βΒ Β βΒ Β βββ Button.tsx+ βΒ Β βΒ Β βββ Dropdown.tsx+ βΒ Β βΒ Β βββ IconButton.tsx+ βΒ Β βΒ Β βββ Input.tsx+ βΒ Β βΒ Β βββ Modal.tsx+ βΒ Β βΒ Β βββ Skeleton.tsx+ βΒ Β βΒ Β βββ Spinner.tsx+ βΒ Β βΒ Β βββ TextArea.tsx+ βΒ Β βΒ Β βββ Toast.tsx+ βΒ Β βΒ Β βββ Tooltip.tsx+ βΒ Β βΒ Β βββ index.ts+ βΒ Β βββ config.ts+ βΒ Β βββ crypto+ βΒ Β βΒ Β βββ crypto-service.ts+ βΒ Β βΒ Β βββ double-ratchet.ts+ βΒ Β βΒ Β βββ index.ts+ βΒ Β βΒ Β βββ key-store.ts+ βΒ Β βΒ Β βββ primitives.ts+ βΒ Β βΒ Β βββ x3dh.ts+ βΒ Β βββ index.css+ βΒ Β βββ index.tsx+ βΒ Β βββ lib+ βΒ Β βΒ Β βββ api-client.ts+ βΒ Β βΒ Β βββ base64.ts+ βΒ Β βΒ Β βββ date.ts+ βΒ Β βΒ Β βββ index.ts+ βΒ Β βΒ Β βββ validators.ts+ βΒ Β βββ pages+ βΒ Β βΒ Β βββ Chat.tsx+ βΒ Β βΒ Β βββ Home.tsx+ βΒ Β βΒ Β βββ Login.tsx+ βΒ Β βΒ Β βββ NotFound.tsx+ βΒ Β βΒ Β βββ Register.tsx+ βΒ Β βββ services+ βΒ Β βΒ Β βββ auth.service.ts+ βΒ Β βΒ Β βββ index.ts+ βΒ Β βββ stores+ βΒ Β βΒ Β βββ auth.store.ts+ βΒ Β βΒ Β βββ index.ts+ βΒ Β βΒ Β βββ messages.store.ts+ βΒ Β βΒ Β βββ presence.store.ts+ βΒ Β βΒ Β βββ rooms.store.ts+ βΒ Β βΒ Β βββ session.store.ts+ βΒ Β βΒ Β βββ settings.store.ts+ βΒ Β βΒ Β βββ typing.store.ts+ βΒ Β βΒ Β βββ ui.store.ts+ βΒ Β βββ styles+ βΒ Β βββ types+ βΒ Β βΒ Β βββ api.ts+ βΒ Β βΒ Β βββ auth.ts+ βΒ Β βΒ Β βββ chat.ts+ βΒ Β βΒ Β βββ components.ts+ βΒ Β βΒ Β βββ encryption.ts+ βΒ Β βΒ Β βββ guards.ts+ βΒ Β βΒ Β βββ index.ts+ βΒ Β βΒ Β βββ websocket.ts+ βΒ Β βββ vite-env.d.ts+ βΒ Β βββ websocket+ βΒ Β βββ index.ts+ βΒ Β βββ message-handlers.ts+ βΒ Β βββ websocket-manager.ts+ βββ tsconfig.json+ βββ vite.config.ts+```## Features### Authentication- Passwordless login with WebAuthn/Passkeys-- Discoverable credentials (device-based auth)+- Discoverable credentials (device based auth)- Multi-device support- Signature counter verification@@ -145,7 +275,7 @@ encrypted-p2p-chat/- X3DH key exchange for async messaging- Forward secrecy- Break-in recovery-- Out-of-order message handling+- Out of order message handling### Real-time Messaging- WebSocket connections@@ -173,7 +303,6 @@ python -m pytest tests/ -vcd frontendnpm installnpm run dev-npm run typechecknpm run lint```@@ -224,7 +353,7 @@ Shared SecretβDouble Ratchet Initializationβ-Per-Message Encryption (AES-256-GCM)+Per Message Encryption (AES-256-GCM)```### WebSocket Flow