Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Umbra Logo

Privacy Preserving Stealth Payments On The Ethereum Blockchain.

πŸš€ πŸ‘· @msolomon44 πŸ‘· @BenDiFrancesco

Umbra Logo


Umbra is a protocol for enabling stealth payments on the Ethereum blockchain. It enables privacy preserving transactions where the receiver's identity is only known to the sender and receiver.

Umbra Logo
Image via @IoTeX hackernoon.


This repository has three components:


What does Umbra do?

Umbra allows a payer to send funds to a fresh address. That address is controlled by the intended receiver, but only the payer and the receiver know that.

How is Umbra different from Tornado Cash

Tornado Cash is awesome and you should use it! It's an on chain mixer that uses zero knowledge proofs. You put funds in, wait a while for other people to do the same, then use your proof to withdrawal them somewhere else. Since everyone's funds are pooled in the mixer, the link between the origin address and withdrawal address is broken.

Umbra is meant for payments between two entities, and comes with a different set of privacy tradeoffs. Rather than breaking the link between sending and receiving address, Umbra makes that link meaningless. Everyone knows the address funds were sent to, but they don't know who controls that address.

What advantages does Umbra have?

  • Umbra allows arbitrary amounts to be sent, since there is no need for inputs and outputs to be uniform.
  • Umbra does not require the receiver to wait to withdraw fundsβ€” as soon as they're sent, they can be withdrawn to any address the receiver chooses.
  • Umbra ensures only the receiver can withdraw the funds once they're sent. The sender does not hold the private key of the receiving address.
  • Umbra uses significantly less gas, as it does not require the verification of any advanced cryptography on chains. All transactions are simple transfers.
  • Umbra enables ETH and arbitrary ERC20 tokens to be transferred privately. You're not dependent on a large anonymity set developing for each token.

Can you give an example of a practical use of Umbra?

Alice owns a business and hires Bob to subcontract for her. She agrees to pay Bob 1,000 Dai/week for his work.

The first time Bob visits the Umbra app, he sets up his account, enabling hime to be paid privately. Alice uses Umbra to send 1,000 Dai to Bob each weekβ€” she only needs to know his ENS address

On chain, we see Alice pays 1,000 Dai to a different and otherwise empty address each week. Behind the scenes, Bob controls the keys to each of these addresses via Umbra, but nobody else knows as much.

Bob uses Umbra to withdraw his 1,000 Dai each week. He only need provide an address to send it to. Obviously, it's best for him to use an address that's not tied to his identity. He usually chooses to send it straight to an exchange, where he sells it for fiat as needed.

Because Umbra uses Gas Station Network and Uniswap, Bob doesn't have to fund the stealth address with Ether to withdraw his Dai. He can pay for gas with the Dai itself. He can also swap directly to any token of his choice, as long as there's a trading pair available on Uniswap.

How does Umbra actually work?

Here's a high level description of the mechanics of the Umbra protocol:

  1. Users publish signed messages to ENS text records to reveal their Umbra public key. This public key is derived from a random private key specifically generated for use with Umbra.
  2. A payer uses this public key, plus some randomly generated data, to create a new 'stealth' address.
  3. The payer encrypts the random data with the receiver's public key.
  4. The payer sends the funds to the shielded address and sends the encrypted message to Umbra's smart contract. The contract broadcasts the encrypted message as an Event.
  5. The receiver scans the encrypted messages broadcast by the Umbra contract until they find one they can decrypt with their private key.
  6. The receiver uses the contents of the encrypted message, plus their private key, to generate the private key of the stealth address.
  7. The receiver uses the private key of the stealth address to sign a withdrawal transaction, sending the ETH or tokens to the address of their choice.
  8. Optionally, the withdrawal transaction is broadcast via Gas Station Network transaction relayers, obviating the need to fund the stealth address to access tokens. The Umbra contracts swap some of the tokens via Uniswap to pay the GSN relayer for gas.



To set up your development environment, clone this repo, and follow the instructions in each of the project component's subdirectories.

  • umbra-js/
  • contracts/
  • app/ This is the current frontend to use, but ultimately will be removed in favor of /frontend
  • frontend/ This is currently a work in progress and can be ignored for now


Contributions to Umbra are welcome! Fork the project, create a new branch from master, and open a PR. Ensure the project can be fast-forward merged by rebasing if necessary.


Umbra is available under the MIT license.

Copyright (c) 2020 Matthew Solomon and Ben DiFrancesco


πŸŒ•πŸŒ‘ Privacy Preserving Shielded Payments On The Ethereum Blockchain





No releases published


No packages published
You can’t perform that action at this time.