Encrypt and decrypt messages using AEAD with an ephemeral key

Learn more by joining the Handshake Discord Community

I noticed that there wasn’t an encrypt/decrypt function natively provided in Handshake, so I built this using concepts introduced earlier in the Bitcoin space. The benefit of this implementation is that it is complete because of Handshake names. Zooko’s Triangle is solved with Handshake making crypto better than ever!





How it works


Basically, your private key is used in conjunction with the recipient’s public key to generate a common key. This common key is ephemeral. Instead, you can simply share the ciphertext. The system uses hsencrypt

Also go on chain

You can also use zmsg-broadcast which is the same as zmsg, except it will put your message on chain. Then, someone can use zmsgpull to pull messages, and then zmsgread to read them.

The benefit of this is that you can encrypt messages and send them. The world will know you encrypted a message and sent it, but it will not know to whom it was for or what it said.

Of course, opponents might have issue with using a chain for this purpose, but I feel the benefits outweight the cons.

Installation Instructions

  1. Clone
git clone
  1. Get the npms

cd zooko-msg
npm install hsd hs-client readline stream hsencrypt consoleinout
  1. Setup your hsd keys folder

echo "someapikey" > keys/node
echo "somewalletkey" > keys/wallet

You can get these with hsd. Make sure hsd has all the index-tx, index-address and other options enabled.

  1. Run commands!



zmsg <wallet> <yourname> <theirname> "<msg>"


zmsg <wallet> <theirname> <yourname> <encrypted> d


You can also use zmsg-broadcast which will actually write this to the blockchain.


Copyright (c) 2022 Publius Federalist

All Rights Reserved



View Github