Skip to content

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 πŸ‘‡

Update README.md

Carter Perez561964d16198
diff --git a/PROJECTS/encrypted-p2p-chat/README.md b/PROJECTS/encrypted-p2p-chat/README.md
index 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/ -v
cd frontend
npm install
npm run dev
-npm run typecheck
npm 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