EncryptedCarouselBookmarkFlow Autor: Dim-Elef

ECBF V12E — Encrypted Carousel Bookmark Flow 🇬🇷

Το ECBF είναι ένα πρόσθετο για τον Mozilla Firefox που λειτουργεί ως ενιαίος διαχειριστής σελιδοδεικτών, συνδυάζοντας τους εγγενείς σελιδοδείκτες του Firefox με έναν ξεχωριστό, κρυπτογραφημένο χώρο αποθήκευσης. Παρέχει έλεγχο στην οργάνωση, μεταφορά και προστασία των σελιδοδεικτών.



Firefox Space: Οι κανονικοί σελιδοδείκτες του Firefox μέσω του Bookmarks API. Οι εγγραφές περιορίζονται στο managed subtree (Bookmarks Toolbar) για ελεγχόμενη πρόσβαση.

Encrypted Space: Ξεχωριστός χώρος σε IndexedDB, όπου τα περιεχόμενα των bookmarks (τίτλοι και URLs) αποθηκεύονται κρυπτογραφημένα με AES-256-GCM. Τα απαραίτητα structural metadata (id, parentId, order) παραμένουν διαθέσιμα μόνο ως ανώνυμα identifiers για τη διαχείριση της δομής.

• Argon2id (64 MiB, 3 iterations) για παραγωγή κλειδιού από password
• HKDF για παραγωγή υποκλειδιών
• AES-256-GCM για κρυπτογράφηση και authenticated integrity
• State MAC + Merkle commitment για ανίχνευση μη αναμενόμενων αλλοιώσεων
• Zeroization κλειδιών στη μνήμη κατά το κλείδωμα

Ο Encrypted Space χρησιμοποιεί state machine:

LOCKED / UNLOCKING / UNLOCKED / LOCKING

Το κλείδωμα πραγματοποιείται χειροκίνητα μέσω του 🔒 ή αυτόματα σύμφωνα με το MV3 extension lifecycle. Υποστηρίζεται επίσης αλλαγή κωδικού με ασφαλή περιστροφή των κρυπτογραφικών κλειδιών.

• Διατήρηση ιεραρχίας φακέλων/υποφακέλων και σειράς εμφάνισης
• Αμφίδρομη μεταφορά Firefox ↔ Encrypted
• Two-phase operations με rollback για αποφυγή μερικώς ολοκληρωμένων μεταφορών
• Drag & Drop για άμεση μετακίνηση αντικειμένων
• Multi-select: Ctrl+Click, Shift+Click, Ctrl+A
• Αναζήτηση με prefix matching
• **Φωνητική μεταγραφή ** για ελληνικά/κυριλλικά → Latin

• Άνοιγμα bookmark σε τρέχουσα ή νέα καρτέλα
• Favicons αποκλειστικά από tab.favIconUrl / data URLs
• Δεν χρησιμοποιείται εξωτερικός favicon server
• ZERO-NETWORK σχεδιασμός χωρίς network requests για εικόνες

• Μετονομασία bookmarks και folders
• Κεντρικό μενού ☰ για πρόσβαση στις λειτουργίες
• Context menu με δεξί κλικ στις κάρτες
• Strict Privacy Mode για απόκρυψη τίτλων στο UI, π.χ. κατά το screen sharing

Υποστηρίζονται 4 τύποι export:

• bookmarks
• favicons
• encrypted backup
• encrypted plain export με προειδοποίηση

Υποστηρίζεται import encrypted backup, με authentication μέσω του αντίστοιχου password.

Τα αρχεία export δημιουργούνται αποκλειστικά τοπικά μέσω Blob URLs, χωρίς αποστολή δεδομένων σε server.

• Background layer = Trusted Authority: διαχείριση cryptographic keys, encryption/decryption και IndexedDB
• UI layer = Client: χωρίς άμεση πρόσβαση σε cryptographic keys ή protected storage
• HMAC-signed communication με session, epoch και sequence validation
• Single Writer / Mutation Sequencer: σειριοποίηση των μεταβολών και περιορισμός race conditions
• State integrity mechanisms: State MAC και Merkle commitment

Το ECBF δεν απαιτεί cloud, backend, εξωτερική βάση δεδομένων ή online account.

Δεν αποστέλλει bookmarks ή encrypted data σε τρίτους. Τα δεδομένα, τα encrypted vaults και τα export/import αρχεία παραμένουν τοπικά στον Firefox.

ECBF — one interface, two bookmark spaces, encrypted local storage, zero-network architecture.

⚠ Σημαντικό: Το ECBF είναι ένα προσωπικό project. ΔΕΝ
παρέχουμε εγγύηση ή SLA. Χρησιμοποιήστε το με δική σας ευθύνη.


ECBF V12E — Encrypted Carousel Bookmark Flow 🇺🇸

ECBF is a Mozilla Firefox extension that works as a unified bookmark manager, combining Firefox's native bookmarks with a separate, encrypted storage space. It provides control over the organization, transfer, and protection of bookmarks.

🔐 Two Management Spaces
Firefox Space: Firefox's native bookmarks via the Bookmarks API. Writes are restricted to the managed subtree (Bookmarks Toolbar) for controlled access.

Encrypted Space: A separate space in IndexedDB, where bookmark contents (titles and URLs) are stored encrypted with AES-256-GCM. The necessary structural metadata (id, parentId, order) remain available only as anonymous identifiers for managing the structure.

🔒 Cryptographic Design
Argon2id (64 MiB, 3 iterations) for key derivation from password

HKDF for subkey derivation

AES-256-GCM for encryption and authenticated integrity

State MAC + Merkle commitment for detecting unexpected tampering

Zeroization of keys in memory upon locking

🔓 Lock / Unlock
The Encrypted Space uses a state machine:

LOCKED / UNLOCKING / UNLOCKED / LOCKING

Locking is performed manually via the 🔒 button or automatically according to the MV3 extension lifecycle. Password change is also supported with secure rotation of cryptographic keys.

📂 Organization & Transfer
Preservation of hierarchy of folders/subfolders and display order

Bidirectional transfer Firefox ↔ Encrypted

Two-phase operations with rollback to avoid partially completed transfers

Drag & Drop for direct movement of items

Multi-select: Ctrl+Click, Shift+Click, Ctrl+A

Search with prefix matching

Phonetic transcription for Greek/Cyrillic → Latin

🌐 Opening & Favicons
Open bookmark in current or new tab

Favicons exclusively from tab.favIconUrl / data URLs

No external favicon server is used

ZERO-NETWORK design with no network requests for images

✏ Rename, Menus & Context
Rename bookmarks and folders

Main menu ☰ for accessing features

Context menu via right-click on cards

Strict Privacy Mode for hiding titles in the UI, e.g. during screen sharing

📦 Export / Import
4 export types are supported:

bookmarks

favicons

encrypted backup

encrypted plain export with warning

Import of encrypted backup is supported, with authentication via the corresponding password.

Export files are created exclusively locally via Blob URLs, without sending data to a server.

🛡 Security Architecture
Background layer = Trusted Authority: management of cryptographic keys, encryption/decryption and IndexedDB

UI layer = Client: no direct access to cryptographic keys or protected storage

HMAC-signed communication with session, epoch and sequence validation

Single Writer / Mutation Sequencer: serialization of mutations and limitation of race conditions

State integrity mechanisms: State MAC and Merkle commitment

🌍 ZERO-NETWORK
ECBF does not require cloud, backend, external database or online account.

It does not send bookmarks or encrypted data to third parties. Data, encrypted vaults and export/import files remain locally on Firefox.

ECBF — one interface, two bookmark spaces, encrypted local storage, zero-network architecture.

⚠ Important: ECBF is a personal project. We provide NO warranty or SLA. Use it at your own risk.