Repository files navigation

🌏🆔  Decentralized Identity

Hyperidentity tried to solve the core problem of centralized web services:vendor lock-in,data-ownership, andsingle-point-of-failure.

npm i -g hyperidentity

• Usage
• API
  • Identity
    • id = identity(archive)
    • id.archive
    • id.setMeta(meta, cb)
    • id.getMeta(cb)
    • token = id.serviceLinkToken(service, archiveKey)
    • id.acceptLinkToken(token, cb(err))
    • id.verifyAcceptingness(service, cb(err, verified))
• Architecture
• License

You can use Hyperidentity from CLI:

• Create an identity at./me:

$ hi init me56d0a72488190d37aaa28447a5600eafe67df00bf89ab646def449c17e331a56 // your identity key

• Login to a service:

$ hi login me token

• show a list of services you've logged-in and your identity key

$ hi info me

• bring your identity online:

$ hi up me

check outtest/signup.js,test/service.js, andexample to see how to implement a web service accepting hyperidentity.

An identity is a user with the data he/she want to share with the service. It can also replicate data generated by web services.

var identity = require('hyperidentity').identity

Create a new identity with ahyperdrive archive.

The archive used by this ID.

Set metadata of the ID

Get metadata of the ID

Create a link token forid for the following purpose:

1. verify user really own the ID(archive)
2. give user a service-owned archive tolink to its ID.

service is a hyperservice instance.

Returns a token string.

Accept a link token. Under the hood, this will:

1. write a response to.proofs/${service.publicKey}
2. linkarchiveKey at.links/${service.publicKey}

Check whetherid accepted the link token fromservice.

Hyperidentity use a hybrid architecture between fully decentralized web and traditional web service.

In hyperidentity, we use a p2p hypermedia protocol calledDat to store the most important thing on the web:the data you've created.

Modern web application is all about creating and sharing data in a scalable way. The Dat protocol allows us to both control our data and share it to the web service we trust. Each web service can have their own peer to replicate your data, or just use existing peers as backend. Since all peers have the same data and only you, as the host, can update the data being shared, it avoids problems such asvendor lock-in andsingle-point-of-failure.

However, it's very limiting if the web services can never write their own data. To solve the problem, hyperidentity usedecentralized-symlink to link your identity to an archive hosted by the web service. By merging two archive together, hyperidentity becomes andecentralized eventually-consistent storage.

Since the service-hosted archive is also publicly replicated between you and the web services, you can save or fork the archive whenever backup or data-migration is needed.

The MIT License