Overview

Torus is a user-friendly, secure, and non-custodial key management system for DApps. We're focused on providing mainstream users a gateway to the decentralized ecosystem.

I want to get coding!

Developers can integrate Torus into their DApps with just a few lines of code - get started here.

Or you can start with experiencing the Torus Wallet (loaded up via IPFS).

What's Torus, How does it work?

General Overview

The architecture consists of four parts:‌

  • Nodes in charge of Distributed Key Generation (DKG)

  • A smart contract in charge of the management of nodes

  • A private BFT network between nodes

  • A front-end client/SDK that interacts with nodes

A smart contract is used for node discovery. Nodes are selected, operate for a fixed period, and generate a set of keys via DKG.‌

When a user arrives at a DApp, the client is loaded. From there, a user logs in, they provide proof that they are logged in, and the proof is verified by each node individually. This proof is integrated with the modern OAuth 2.0 Token Authentication flow. For new users, nodes will assign a new key share from the pre-generated set of key shares, and store this assignment in an internal mapping. For returning users, nodes will look up their internal mapping and return that user's corresponding key share.‌

The client then assembles these shares and reconstructs the users key in the front-end. This key is kept for the session and is not persisted in localstorage, or for native apps kept in memory for a session.

For more, take a look at System Architecture or our high-level write ups