Skip to content

Latest commit

 

History

History
231 lines (149 loc) · 9.2 KB

README.md

File metadata and controls

231 lines (149 loc) · 9.2 KB
Raw

did:ar | multi-chain DIDs backed by Arweave

- THIS IS A WIP ABSOLUTELY SHOULD NOT BE USED IN PRODUCTION

     ___             ___                             
    (   )  .-.      (   )                            
  .-.| |  ( __)   .-.| |          .---.   ___ .-.    
 /   \ |  (''")  /   \ |         / .-, \ (   )   \   
|  .-. |   | |  |  .-. |   .-.  (__) ; |  | ' .-. ;  
| |  | |   | |  | |  | |  (   )   .'`  |  |  / (___) 
| |  | |   | |  | |  | |   `-'   / .'| |  | |        
| |  | |   | |  | |  | |   .-.  | /  | |  | |        
| '  | |   | |  | '  | |  (   ) ; |  ; |  | |        
' `-'  /   | |  ' `-'  /   `-'  ' `-'  |  | |        
 `.__,'   (___)  `.__,'         `.__.'_. (___)

Disclaimer

This code and oncept are less than 24 hours old. There are ALMOST CERTAINLY flaws in the design. Do not adopt this standard until a tagged release. Also please read this document with a critical lense -- the ideas present have not been validated via peer-review.

Motivation

We live in a multi-chain world. That's a fact.

At Glass we support two chains (ethereum and solana). Maintaining identity across multiple chains is a complex problem. In a mono-chain environment you can rely on name services e.g. ENS or Solana Name Service, but in a multi-chain environment you either have to opt to use one name service or run a centralized server to link identities. In the case of Glass, using a centralized service is a non-option, so we needed to find a way to link multiple identities in a permission-less fashion.

The following is an EXTREMELY ROUGH MVP for multi-chain decentralized identities.

What is a DID?

DID's are a W3 Standard

Decentralized identifiers (DIDs) are a new type of identifier that enables verifiable, decentralized digital identity. A DID refers to any subject (e.g., a person, organization, thing, data model, abstract entity, etc.) as determined by the controller of the DID. In contrast to typical, federated identifiers, DIDs have been designed so that they may be decoupled from centralized registries, identity providers, and certificate authorities. Specifically, while other parties might be used to help enable the discovery of information related to a DID, the design enables the controller of a DID to prove control over it without requiring permission from any other party. DIDs are URIs that associate a DID subject with a DID document allowing trustable interactions associated with that subject.

Each DID document can express cryptographic material, verification methods, or services, which provide a set of mechanisms enabling a DID controller to prove control of the DID. Services enable trusted interactions associated with the DID subject. A DID might provide the means to return the DID subject itself, if the DID subject is an information resource such as a data model.

Read More: https://www.w3.org/TR/did-core/

Technical Discussion

Part of the reason for writing this document was to remove reliance on IPFS. Arweave offers true permanence without the need for coordinated pinning services.

For an IPFS alternative that is FAR MORE developed, be sure to check out our friends at Ceramic.

Genesis

Every DID requires a uniquely generated ID. We opt to use a small data payload Arweave transaction to initialize an ID. The genesis transaction IS NOT A DID, but rather a precursor. The genesis document looks like such:

{
  "version": "2021-10-12",
  "genesis": {
    "signing_key": {
      "key_type": "ETHEREUM",
      "public_key": "0xAbf798E220c6E44E4F8d720E8095E8dB230E9718"
    }
  }
}

Arweave ID: UxKu4zSAYPovRsu7hCepxpnmpE2GVORBX4U_udd8SwY

Tags
Content-Type: application/json
Version : Cal-Versioning
Address : 0xAbf798E220c6E44E4F8d720E8095E8dB230E9718

The genesis document contains the signing key that will be used to initialize the append only log.

NOTE: anyone would be able to resubmit this document to arweave. The reason we add the signing key is to stop someone else from signing the genesis document and claiming that person's DID. The second arweave tx (and creation of a DID document) ABSOLUTELY MUST sign their DID document with the key used in the genesis document.

DID Document

To create a DID document, the genesis transaction is referenced in the DID document. The way that we ensure security with updating the document is requiring the previous document's ID and the authentication payload to be cryptographically signed by one of the authorized keys.

{
  "version": "2021-10-12",
  "document_and_attestation": {
    "document": {
      "context": [
        "https://www.w3.org/ns/did/v1"
      ],
      "id": "did:ar:UxKu4zSAYPovRsu7hCepxpnmpE2GVORBX4U_udd8SwY",
      "authentication": [
        {
          "key_type": "SOLANA",
          "public_key": "9jiixatNTBsLKAnfiv6BztccKai7UVWoEa1g6hKkWxvP"
        },
        {
          "key_type": "ETHEREUM",
          "public_key": "0xAbf798E220c6E44E4F8d720E8095E8dB230E9718"
        }
      ],
      "metadata": {}
    },
    "attestation": {
      "appending": "UxKu4zSAYPovRsu7hCepxpnmpE2GVORBX4U_udd8SwY",
      "signing_key": {
        "key_type": "ETHEREUM",
        "public_key": "0xAbf798E220c6E44E4F8d720E8095E8dB230E9718"
      },
      "signature": "0x8b574b299a8f7c67081ae7254ddddbdccc750ed57aebe70b338fb125db38efa2420e2f0628154a059da8305f06be2eea4b68eedc842b7035156e671d264505fd00"
    }
  }
}

Arweave ID: n8x2zg6mLaE_RsH-Gz-t6qAinq5zPgbF5FxcwrtcziM

Tags
Content-Type: application/json
Version : Cal-Versioning
ID : UxKu4zSAYPovRsu7hCepxpnmpE2GVORBX4U_udd8SwY
Appending : UxKu4zSAYPovRsu7hCepxpnmpE2GVORBX4U_udd8SwY
Address : 0xAbf798E220c6E44E4F8d720E8095E8dB230E9718
Address : 9jiixatNTBsLKAnfiv6BztccKai7UVWoEa1g6hKkWxvP

The log of updates are then cryptographically linked back to the genesis ID. To reiterate, every new data update must not only sign the new data using an approved key but also MUST sign the reference to the previous entry in the DID log. Following this structure allows us to update a DID to add and delete authorized keys.

This method of cryptographically signing the previous log is not novel, but rather a fundamental primative for most blockchains.

Potential Attacks

The most pressing attack is a DDOS attack. One way to remedy this is to appove certain arweave addresses to submit transactions on the DID controller's behalf.

As further discussions develop regarding this approach to managing DID's they will be listed here.

Validation

Anyone can validate the append only log by tracing the latest transactions tagged with a given genesis-id (did:ar:THIS_PART). To expedite this process for a consumer platform, it is recommended to index and validate the transactions in a background-process on their own servers.

To be explicity, NO CENTRAL PARTIES ARE RREQUIRED TO VALIDATE. Furthermore, CREATING A DID:AR IS FULLY PERMISSION-LESS ONCE AGAIN NOT REQUIRING CENTRAL SERVERS.

Why Protocol Buffers?

The W3C standard requests that JSON-LD be used to define document structures. We are breaking the spec by using protocol buffers. The rationale behind using protocol buffers is that they can be used to generate code in many different languages. Adoption is a serious problem for creating standards. We wanted to simplify the process of adoption by reducing developer work for new language SDK's.

Command Line Tool

Genesis Tx

$ go run main.go add-key --arweave-key YOUR_ARWEAVE_KEY.json

Add Key

$ go run main.go genesis --arweave-key YOUR_ARWEAVE_KEY.json

Full Example

did:ar:xrzz5rl5Nr8cj7nf_XbQKbbUVrOsV0xZB6O4Reuja88

$ go run main.go genesis --arweave-key ark.json 
✔ Ethereum
Public Key: 0xAbf798E220c6E44E4F8d720E8095E8dB230E9718
Tx data size: 0.000163MB 
uplaodTx; body: OK, status: 200, txId: UxKu4zSAYPovRsu7hCepxpnmpE2GVORBX4U_udd8SwY 
100.000000% completes, 1/1 

DID: UxKu4zSAYPovRsu7hCepxpnmpE2GVORBX4U_udd8SwY



$ go run main.go add-key --arweave-key ark.json
✔ Ethereum
Public Key: 0xAbf798E220c6E44E4F8d720E8095E8dB230E9718
Private Key: ****************************************************************
Genesis ID: UxKu4zSAYPovRsu7hCepxpnmpE2GVORBX4U_udd8SwY
Previous ID (Genesis if that was last): UxKu4zSAYPovRsu7hCepxpnmpE2GVORBX4U_udd8SwY
✔ Add Key
✔ Solana
Public Key: 9jiixatNTBsLKAnfiv6BztccKai7UVWoEa1g6hKkWxvP
✔ Finalize
Tx data size: 0.000863MB 
uplaodTx; body: OK, status: 200, txId: n8x2zg6mLaE_RsH-Gz-t6qAinq5zPgbF5FxcwrtcziM 
100.000000% completes, 1/1 

NEW DOC: n8x2zg6mLaE_RsH-Gz-t6qAinq5zPgbF5FxcwrtcziM

Genesis Data: https://arweave.net/UxKu4zSAYPovRsu7hCepxpnmpE2GVORBX4U_udd8SwY

Genesis Explorer: https://viewblock.io/arweave/tx/UxKu4zSAYPovRsu7hCepxpnmpE2GVORBX4U_udd8SwY

DID Doc: https://arweave.net/n8x2zg6mLaE_RsH-Gz-t6qAinq5zPgbF5FxcwrtcziM

DID Doc Explorer: https://viewblock.io/arweave/tx/n8x2zg6mLaE_RsH-Gz-t6qAinq5zPgbF5FxcwrtcziM

Feedback

Please send any feedback to via DM to @sam_sends