Files
dvs a2d492e9f8 Add dvs_enc.py and document the two-module requirement
The client imports its backend from a module named `dvs_enc`, but the
repository only shipped that backend as `qtmain.py`. Starting the application
from a fresh clone therefore failed immediately:

    ModuleNotFoundError: No module named 'dvs_enc'

`dvs_enc.py` is now included. It carries the same content as `qtmain.py`, so
the import resolves to the identical implementation.

Verified end to end:

  - without dvs_enc.py: import qtmain raises ModuleNotFoundError
  - with dvs_enc.py:    import qtmain succeeds, all 14 backend classes present

Functional tests against a clean copy of the repository pass: text
round-trip, 4096-byte binary round-trip, HMAC authentication, AccountDB and
HistoryDB construction.

Also exercised the full client/server protocol against a live relay: register,
login, create group, join group, and ciphertext relay between two clients.
The relay forwards the payload verbatim without inspecting it.

Documentation
- README: new "Module layout" section explaining why both files are required,
  and what the failure looks like when dvs_enc.py is absent; repository layout
  and troubleshooting table updated to match
- CHANGELOG: structure table updated
2026-09-27 17:16:56 +08:00

74 lines
2.6 KiB
Markdown

# Changelog
All notable changes to this project are documented in this file.
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/).
---
## [3.0.0] — 2026-09-27
First release as a standalone repository. The application code is unchanged
from the version previously distributed inside the ChaosCrypt repository; this
release separates it into its own project with its own documentation and
licence.
### Added
- `README.md` — overview, architecture, installation, running instructions,
data locations, security properties and troubleshooting.
- `SECURITY.md` — threat model, protected properties, cryptographic building
blocks, and a detailed list of known limitations.
- `LICENSE` — MIT.
- `.gitignore` — excludes application data, session tokens, local databases
and media from version control.
### Changed
- Distributed as its own repository rather than a subdirectory of ChaosCrypt.
- Documentation written specifically for this application, rather than
inheriting the cipher's documentation.
### Structure
| File | Role |
|---|---|
| `qtmain.py` | PyQt5 client together with the complete backend |
| `dvs_enc.py` | The backend module that `qtmain.py` imports at runtime |
| `server.py` | Optional central relay server, standard library only |
`dvs_enc.py` carries the same content as `qtmain.py`. The client imports its
backend classes from `dvs_enc`, so both files must be present in the same
directory or startup fails. Shipping it explicitly makes the package complete
on its own.
### Notes
The application code is byte-for-byte identical to the version shipped with
ChaosCrypt 2.0.0. No functional changes were made in this release.
---
## [2.0.0] — 2026-08-26
Released as part of the ChaosCrypt project.
### Added
- End-to-end encrypted chat on top of the ChaosCrypt cipher.
- Two group modes: direct peer-to-peer, and a central relay for NAT traversal.
- Voice messages: record, encrypt, transmit, decrypt, play.
- Image and arbitrary file transfer, encrypted like any other payload.
- Group management: create, join, rename, announcements, kicking members,
join approval.
- Message withdrawal within a time window.
- Per-user keys for member authentication, preventing impersonation.
- SQLite-backed history that survives restarts.
- HMAC integrity checking on every message.
- PyQt5 interface with rounded, adaptive message bubbles.
- Account and history storage in SQLite, with salted password hashing.
[3.0.0]: https://git.dvscloud.net/dvs/ChaosCryptChat/releases/tag/v3.0.0
[2.0.0]: https://git.dvscloud.net/dvs/ChaosCrypt/releases/tag/v2.0.0