git404hub

what is troste-onion fr?

80dark/troste-onion — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · developerComplexity · 4/5Setup · hard

tl;dr

A local tool for sending end-to-end encrypted messages directly between two computers over the Tor network, no central server needed.

vibe map

mindmap
  root((Troste Onion))
    What it does
      Encrypted peer to peer letters
      Runs as Tor onion service
      No central database
    Tech stack
      Node.js
      Tor
      AES-256-GCM
      ECDSA
    Use cases
      Private direct messaging
      Peer to peer encrypted delivery
      Self hosted mailbox
    Audience
      Privacy focused users
      Developers
      Security researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Send an end-to-end encrypted message directly to another person without a central server storing it.

VIBE 2

Run your own local mailbox reachable only through the Tor network.

VIBE 3

Learn how a double-encrypted peer to peer messaging protocol can be built with Tor onion services.

VIBE 4

Share sensitive information privately between two computers you both control.

what's the stack?

Node.jsTorAES-256-GCMECDSA

how it stacks up fr

80dark/troste-onion00kaku/gallery-slider-block3rd-eden/ircb.io
Stars0
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-192016-11-16
MaintenanceDormantDormant
Setup difficultyhardeasyeasy
Complexity4/52/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires Node.js 22 or newer plus installing the Tor Expert Bundle, and both sides must keep their daemon running.

The README does not clearly state a license, so check with the repository owner before reusing this work.

in plain english

Troste Onion is a tool for sending encrypted messages, called letters, directly between two people without relying on a central server or database. Instead, each user runs a local program on their own computer that publishes itself as a Tor onion service, a type of hidden address reachable only through the Tor anonymity network. Messages travel straight between these two local programs over Tor rather than passing through any shared cloud service. The README describes this as a working prototype that has not yet gone through an independent security review. When someone sends a letter, the message is encrypted twice on their own computer, once for the recipient's key and signed by the sender, and then wrapped in a second layer of encryption tied to a shared secret code. The local program stores only the encrypted package, a hash of the secret, and an expiration date, never the secret itself or the readable text. The sender shares a special code string with the recipient, which includes the sender's onion address, an identifier, and the secret needed to unlock the outer layer. Only the recipient's own private key can open the inner, readable message. Running it requires Node.js and an internet connection to install dependencies and the Tor software bundle. Once started, it opens a local web interface where you can see when Tor has finished setting up and publishing your mailbox. The three network ports it uses are meant to stay local to your own computer and should not be exposed to the wider internet. The README is honest about its limits: the sender's computer must stay running until the letter is picked up, losing your browser's private keys makes your letters unrecoverable, and Tor reduces exposure but does not make a compromised computer safe. It is currently a desktop only tool, and the author explicitly warns it should not be deployed on services like Vercel because it needs a persistent Tor process and local storage. The README does not clearly state a software license.

prompts (copy fr)

prompt 1
Explain how Troste Onion's double encryption and delivery code system works step by step.
prompt 2
Help me set up Node.js and Tor to run this project's local onion service on my computer.
prompt 3
Walk me through the security tradeoffs this README describes for using Tor onion services.
prompt 4
Show me how to test this project's encryption and expiration features using its test suite.

Frequently asked questions

what is troste-onion fr?

A local tool for sending end-to-end encrypted messages directly between two computers over the Tor network, no central server needed.

What language is troste-onion written in?

Mainly JavaScript. The stack also includes Node.js, Tor, AES-256-GCM.

What license does troste-onion use?

The README does not clearly state a license, so check with the repository owner before reusing this work.

How hard is troste-onion to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is troste-onion for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.