Getting started
Humanity Ledger documentation
What Humanity Ledger is, what Ledger Chat does today, and where to read more.
Humanity Ledger builds private communication tools that you sign in to with a wallet you already hold, instead of a phone number or a password. Ledger Chat is our first application: a messenger for direct conversations, communities, calls and payments.
This documentation describes how the product works today, including the parts that are not finished. Where something is still in development, the page says so.
Start here
Quick startSign in, set a PIN and start your first conversation.MessagingWhat is encrypted, what is not, and how to tell the difference.ArchitectureThe parts of the system and what each one can see.DevelopersRun the code locally and find your way around the repository.
What works today
Ledger Chat is in early access. The table below is the honest state of each feature as of the date at the bottom of this page.
Sign in with a walletAvailable
Any Ethereum wallet that can sign a message, using the Sign in with Ethereum standard.
Sign in with emailAvailable
A one time code sent to your inbox. Useful before you have a wallet.
Direct messagesAvailable
Encrypted on your device and delivered through the XMTP network.
Fallback deliveryPartly available
When XMTP delivery fails, a message can travel through our server in readable form. The chat labels these messages.
CommunitiesAvailable
Channels, roles, posts and invite links. Community posts are not yet encrypted end to end.
Voice and video callsAvailable
Direct browser to browser calls, encrypted by WebRTC.
Payments in chatAvailable
Send tokens from your own wallet to the person you are talking to.
Private payments on AztecPartly available
Shield, send, receive by QR code and unshield work on the Aztec test network, with test tokens that have no value. No bridge from Ethereum and no independent audit yet.
AttachmentsPartly available
Files are uploaded to our storage provider and are not yet encrypted end to end.
Windows appPartly available
An unsigned preview build. The web app is the supported client.
iPhone and Android appsIn development
Not yet submitted to the App Store or Google Play.
How the documentation is organised
- Getting started
- Accounts, sign in and the PIN that protects Ledger Chat on your devices.
- Ledger Chat
- Each feature of the messenger, what it does and what it reveals.
- Protocol
- The architecture, the encryption in use and the whitepaper.
- Security
- Our security model, the findings that are still open and how to report a new one.
- Company and legal
- Who we are, how to reach us, and the terms and policies that apply.
Found a mistake?
Every page can be corrected on GitHub. Use the link at the bottom of the page, or open an issue.