---
title: Sidetree Working Group - DIF
description: "Sidetree is a protocol for creating scalable Decentralized Identifier networks that can run atop any existing decentralized anchoring system"
excerpt: >
Architecturally, Sidetree-based DID Method implementations are overlay networks composed of independent peer nodes (Sidetree nodes) that interact with an underlying decentralized anchoring system (as illustrated under Network Topology) to write, observe, and process replicated DID PKI state operations using deterministic protocol rules that produce an eventually strongly consistent view of all DIDs in the network.
layout: single
permalink: /organizations/decentralized-identity-foundation/wg/sidetree/
canonical_url: 'https://decentralized-id.com/organizations/decentralized-identity-foundation/wg/sidetree/'
categories: ["Open Source Projects"]
tags: ["DIF","Sidetree"]
last_modified_at: 2023-06-12
---
## Main
* [Sidetree Working Group](https://identity.foundation/working-groups/sidetree.html)
> The development and maintenance of the formal Sidetree specification, and a hub of coordination for Sidetree-based DID Method node operators. This group also generates libraries, tooling, and documentation to aid Sidetree-based DID Method node operators.
- [Charter](https://github.com/decentralized-identity/org/blob/master/Org%20documents/WG%20documents/DIF_Sidetree_WG_charter_v1.pdf)
- [Agenda](https://github.com/decentralized-identity/sidetree/blob/master/agenda.md)
- [Mailing list](https://lists.identity.foundation/g/sidetree-wg)
- [GitHub](https://github.com/topics/wg-sidetree)
- [Meetings](https://docs.google.com/spreadsheets/d/1wgccmMvIImx30qVE9GhRKWWv3vmL2ZyUauuKx3IfRmA/edit#gid=1343983492)
## About
* [Decoding the Sidetree Protocol](https://academy.affinidi.com/decoding-the-sidetree-protocol-18d8bfa39257) 2021-05-25 Affinidi
> Sidetree protocols are layer 2 protocols that anchor to the underlying decentralized ledger system. That said, it is ledger agnostic and its primary role is to anchor batches of signed JSON operations to the network.
* [Sidetree Protocol reaches V1](https://blog.identity.foundation/sidetree-protocol-reaches-v1/) 2021-04-12 DIF
> This week, the DIF Steering Committee officially approved the first major release of the Sidetree Protocol specification, "v1" so to speak. This protocol has already been implemented, and four of its implementers have been collaborating intensively for over a year on expanding and extending this specification together.
- [Sidetree Protocol / Element DID and Friends](https://iiw.idcommons.net/Sidetree_Protocol_/_Element_DID_and_Friends) 2020-04-30 IIW30
- [Sidetree did:ion + did:elem Roadmap + dev](https://iiw.idcommons.net/Sidetree_did:ion_%2B_did:elem_Roadmap_%2B_dev) IIW29
> We discussed that it allows the did controller to update their did document, including adding support for experimental features or new key types like GPG and BBS.
>
> Troy from Secure Key explained how they use Sidetree with Hyper Ledger Fabric.
>
> Secure Key uses sidetree for things other than did documents.
>
> Transmute uses Sidetree to store hashlinks to Encrypted Data Vaults / Secure Data Stores as a way of scalably commiting to specific versions of credentials.
- [Sidetree protocol – Massivly Scalable Decentralized Identifiers – DEEP DIVE](https://iiw.idcommons.net/Sidetree_protocol_%E2%80%93_Massivly_Scalable_Decentralized_Identifiers_%E2%80%93_DEEP_DIVE) IIW28
- [Sidetree on Ethereum “Element](https://iiw.idcommons.net/Sidetree_on_Ethereum_%E2%80%9CElement) 2019-10-08 IIW28
> ![](https://iiw.idcommons.net/images/e/ea/IIW29_TH_15H_Sidetree_DID-ion%2Bdid-elem_Roadmap_%26_Dev%281%29.jpg)
## Specs & Projects
### Sidetree
* [Sidetree Protocol](https://identity.foundation/sidetree/spec/)
> Spec, docs, and implementations for the chain/ledger-agnostic DID scaling protocol.
* [decentralized-identity/sidetree](https://github.com/decentralized-identity/sidetree)
> Sidetree Specification and Reference Implementation
* [sidetree-ipfs-datastores](https://github.com/decentralized-identity/sidetree-ipfs-datastores)
> Implementations of IPFS datastore used by sidetree-ipfs microservice
### ION
* [Install Guide](https://github.com/decentralized-identity/ion/blob/master/install-guide.md)
> An implementation of the Sidetree protocol atop the Bitcoin blockchain.
* [decentralized-identity/ion](https://github.com/decentralized-identity/ion)
> ION is a public, permissionless, Decentralized Identifier (DID) network that implements the blockchain-agnostic Sidetree protocol on top of Bitcoin (as a 'Layer 2' overlay) to support DIDs/DPKI (Decentralized Public Key Infrastructure) at scale.
* [ion-integration-test](https://github.com/decentralized-identity/ion-integration-test)
> An integration test script that helps verify that the sidetree microservices are working properly.
* [ion-sdk](https://github.com/decentralized-identity/ion-sdk)
> TypeScript SDK for ION
* [ion-tools](https://github.com/decentralized-identity/ion-tools)
> Tools and utilities to make working with the ION network and using ION DIDs easy peasy lemon squeezy
#### About ION
* [ION 101-401: what is ION (the public, permissionless DID network), how can you use it today, and what comes next](https://iiw.idcommons.net/3A/_ION_101-401:_what_is_ION_(the_public,_permissionless_DID_network),_how_can_you_use_it_today,_and_what_comes_next) 2021-05-06 Daniel Buchner (Microsoft)
> - Decentralization of did:ion if anchoring transactions are batched by an operator: it’s possible to choose the operator or to incur the cost of anchoring the transactions. Furthermore, the operator doesn’t gain access to the private key.
> - ION delivers: massive scale, cost efficiency (despite running on the bitcoin network - best case if bitcoin a transaction costs 100 USD one action costs 1 cent), decentralized & flexible, decentralized registries
> - ION has a type system so that DIDs can be used, e.g. for software packages, vehicles, … This makes it possible to make the centralized data repositories that we rely on today, npm registries etc., to be fully decentralized. This is a Sidetree feature that is currently only used by ION.
> - DIF is currently working on personal data stores. Expected impact on private messaging, social media, gig services, ..
> - ION is live and in production today
> - Ion-tools is a selection of tools to interact with the ION network: [https://github.com/decentralized-identity/ion-tools](https://github.com/decentralized-identity/ion-tools)
> - Resilience of ION: It’s pointed out that not only Bitcoin needs to survive attacks but also the IPFS network as both are required for ION to work properly. With Bitcoin it looks unlikely that it’s currently possible to reverse transactions on the network. However, with IPFS data can be unpinned and potentially disappear from the network.
* [ION – We Have Liftoff!](https://techcommunity.microsoft.com/t5/identity-standards-blog/ion-we-have-liftoff/ba-p/1441555) 2021-03-25
> We are excited to share that v1 of [ION](https://identity.foundation/ion/) is complete and has been launched on Bitcoin mainnet. We have deployed an ION node to our production infrastructure and are working together with other companies and organizations to do so as well. ION does not rely on centralized entities, trusted validators, or special protocol tokens – ION answers to no one but you, the community. Because ION is an open, permissionless system, anyone can run an ION node, in fact the more nodes in operation, the stronger the network becomes. Development of ION, and the Sidetree standard ION is based on, takes place in the [Decentralized Identity Foundation](https://identity.foundation/) (DIF). Read on to learn how you can integrate ION, DIDs, and Verifiable Credentials in your applications and services.
* [Introduction to Ion – a layer 2 network for Decentralized Identifiers with Bitcoin - Daniel Buchner](https://www.slideshare.net/SSIMeetup/introduction-to-ion-a-layer-2-network-for-decentralized-identifiers-with-bitcoin-daniel-buchner) 2019-06-13 [SSI Meetup](https://ssimeetup.org/introduction-ion-layer-2-network-decentralized-identifiers-bitcoin-daniel-buchner-webinar-29/)
> Microsoft presented in May 2019 in New York the first decentralized infrastructure implementation by a major tech company that is built directly on the Bitcoin blockchain called Ion. Daniel Buchner, who is leading this initiative at Microsoft and a founding member of the Decentralized Identity Foundation, will discuss the culture at Microsoft, how decentralized identity works with Bitcoin and what you need to know to use the Bitcoin blockchain for non-financial transactions.
>
> Ion handles the decentralized identifiers, which control the ability to prove you own the keys to this data.
### Element
* [Element](https://element-did.com/) - An implementation of the Sidetree protocol using the Ethereum blockchain. [GitHub](https://github.com/decentralized-identity/element)
* [The Element DID Method: Sidetree, Ethereum & IPFS – Orie Steele](https://www.slideshare.net/SSIMeetup/the-element-did-method-sidetree-ethereum-ipfs-orie-steele) 2019-11-10 [SSI-Meetup](https://ssimeetup.org/element-did-method-sidetree-ethereum-ipfs-orie-steele-webinar-31/)
> Orie Steele is Cofounder and CTO of Transmute, a company developing IAM and Verifiable Credential solutions that integrate Decentralized Identity for Enterprises. He has a BS in Cyber Security and MS in Computer Science from Stevens Institute of Technology where he studied social network malware and botnets between 2007-2012. He was an early engineer at Patient IO, a Techstars backed startup acquired by Athena Health in 2016, where he helped develop and secure a care coordination platform that connected nurses and patients.
>
> In this talk, Orie will discuss the history of the Element DID Method, how it leverages the same Sidetree Protocol that is used by ION on the Bitcoin Network. He’ll introduce the motivation for Element and ION, and then walk through the core components of developing a working DID System, including topics such as wallets, signing, DID resolution, key revocation, and decentralization.