From da4853700b4678f2a407118f6043e06cd1745234 Mon Sep 17 00:00:00 2001
From: Joshua <62268199+minimalsm@users.noreply.github.com>
Date: Thu, 30 Oct 2025 11:56:33 +0000
Subject: [PATCH 1/5] Add Bhutan NDI decentralized identity content
---
public/content/decentralized-identity/index.md | 14 ++++++++++++++
public/content/zero-knowledge-proofs/index.md | 17 +++++++++++++++++
2 files changed, 31 insertions(+)
diff --git a/public/content/decentralized-identity/index.md b/public/content/decentralized-identity/index.md
index 6596f75b5e8..d943e84d8be 100644
--- a/public/content/decentralized-identity/index.md
+++ b/public/content/decentralized-identity/index.md
@@ -75,6 +75,20 @@ Decentralized identity can help create online communities that are free of fake
Grant-giving applications that use [quadratic voting](/glossary/#quadratic-voting) are vulnerable to [Sybil attacks](/glossary/#sybil-attack) because the value of a grant is increased when more individuals vote for it, incentivizing users to split their contributions across many identities. Decentralized identities help to prevent this by raising the burden on each participant to prove that they are really human, although often without having to reveal specific private information.
+### 5. National and Government ID {#national-and-government-id}
+
+Governments can use the principles of decentralized identity to issue foundational identity documents—such as national IDs, passports, or driver's licenses—as verifiable credentials on Ethereum, providing strong cryptographic guarantees of authenticity to reduce fraud and forgery in online identity verification. Citizens can store these attestations in their personal [wallet](https://ethereum.org/wallets/) and use them to prove their identity, age, or right to vote.
+
+This model allows for selective disclosure, especially when combined with [zero-knowledge proof (ZKP)](https://ethereum.org/zero-knowledge-proofs/) privacy technology. For example, a citizen could cryptographically prove they are over 18 to access an age-restricted service without revealing their exact date of birth, offering greater privacy than a traditional ID.
+
+#### 💡Case study: Bhutan National Digital ID (NDI) on Ethereum
+
+The Kingdom of Bhutan [launched a National Digital Identity (NDI) system](https://www.dailybhutan.com/article/bhutan-makes-history-as-the-world-s-first-nation-to-launch-a-national-digital-id-on-ethereum) on Ethereum in October 2025, built on the principles of decentralized identity and self-sovereign identity. This nationwide deployment puts the decentralized identity model into practice across the country.
+
+Using decentralized identifiers and verifiable credentials, Bhutan's NDI issues digitally signed credentials directly to a citizen's personal wallet. By anchoring cryptographic proofs of these credentials on Ethereum, the system ensures they are authentic, tamper-proof, and can be verified by any party without querying a central authority.
+
+The system's architecture emphasizes privacy through the use of [Zero-Knowledge Proof (ZKP)](https://ethereum.org/zero-knowledge-proofs/) technology. This implementation of "selective disclosure" allows citizens to prove specific facts (e.g., "I am over 18" or "I am a citizen") to access services without revealing the underlying personal data, such as their full ID number or exact date of birth. This demonstrates a powerful, real-world use of Ethereum for a secure, user-centric, and privacy-preserving national ID system.
+
## What are attestations? {#what-are-attestations}
An attestation is a claim made by one entity about another entity. If you live in the United States, the driver's license issued to you by the Department of Motor Vehicles (one entity) attests that you (another entity) are legally allowed to drive a car.
diff --git a/public/content/zero-knowledge-proofs/index.md b/public/content/zero-knowledge-proofs/index.md
index 506dd58ca6f..30ab9ebe606 100644
--- a/public/content/zero-knowledge-proofs/index.md
+++ b/public/content/zero-knowledge-proofs/index.md
@@ -46,6 +46,23 @@ Current identity management systems put personal information at risk. Zero-knowl
Zero-knowledge proofs are particularly useful in the context of [decentralized identity](/decentralized-identity/). Decentralized identity (also described as ‘self-sovereign identity’) gives the individual the ability to control access to personal identifiers. Proving your citizenship without revealing your tax ID or passport details is a good example of how zero-knowledge technology enables decentralized identity.
+
+
+
+
+ ZKP + Identity in action: Bhutan National Digital ID (NDI) on Ethereum
+
+
+
+ A real-world example of using ZKP for identity management systems is the Kingdom of Bhutan's National Digital ID (NDI) system, built on Ethereum. Bhutan’s NDI uses ZKPs to allow citizens to cryptographically prove facts about themselves, like "I am a citizen" or "I am over 18," without revealing the sensitive personal data on their ID.
+
+
+ Learn more about Bhutan NDI in the Decentralized Identity case study.
+
+
+
+
+
### Proof of Humanity {#proof-of-humanity}
One of the most widely used examples of zero-knowledge proofs in action today is the [World ID protocol](https://world.org/blog/world/world-id-faqs), which can be thought of as “a global digital passport for the age of AI.” It allows people to prove they are unique individuals without revealing personal information. This is achieved through a device called the Orb, which scans a person's iris and generates an iris code. The iris code is checked and verified to confirm the person is a biologically unique human being. After verification, an identity commitment generated on the user’s device (and not linked to or derived from the biometric data) is added to a secure list on the blockchain. Then, whenever the user wants to prove they’re a verified human – whether to sign in, vote, or take other actions – they can generate a zero-knowledge proof that confirms their membership in the list. The beauty of using a zero-knowledge proof is that only one statement is revealed: this person is unique. Everything else stays private.
From ed812ef67fb7fcfdfec3c6da656ae434d06fa0f5 Mon Sep 17 00:00:00 2001
From: Joshua <62268199+minimalsm@users.noreply.github.com>
Date: Thu, 30 Oct 2025 12:00:50 +0000
Subject: [PATCH 2/5] Use relative links for Bhutan NDI references
---
public/content/decentralized-identity/index.md | 6 +++---
public/content/zero-knowledge-proofs/index.md | 2 +-
2 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/public/content/decentralized-identity/index.md b/public/content/decentralized-identity/index.md
index d943e84d8be..c52df0c8042 100644
--- a/public/content/decentralized-identity/index.md
+++ b/public/content/decentralized-identity/index.md
@@ -77,9 +77,9 @@ Grant-giving applications that use [quadratic voting](/glossary/#quadratic-votin
### 5. National and Government ID {#national-and-government-id}
-Governments can use the principles of decentralized identity to issue foundational identity documents—such as national IDs, passports, or driver's licenses—as verifiable credentials on Ethereum, providing strong cryptographic guarantees of authenticity to reduce fraud and forgery in online identity verification. Citizens can store these attestations in their personal [wallet](https://ethereum.org/wallets/) and use them to prove their identity, age, or right to vote.
+Governments can use the principles of decentralized identity to issue foundational identity documents—such as national IDs, passports, or driver's licenses—as verifiable credentials on Ethereum, providing strong cryptographic guarantees of authenticity to reduce fraud and forgery in online identity verification. Citizens can store these attestations in their personal [wallet](/wallets/) and use them to prove their identity, age, or right to vote.
-This model allows for selective disclosure, especially when combined with [zero-knowledge proof (ZKP)](https://ethereum.org/zero-knowledge-proofs/) privacy technology. For example, a citizen could cryptographically prove they are over 18 to access an age-restricted service without revealing their exact date of birth, offering greater privacy than a traditional ID.
+This model allows for selective disclosure, especially when combined with [zero-knowledge proof (ZKP)](/zero-knowledge-proofs/) privacy technology. For example, a citizen could cryptographically prove they are over 18 to access an age-restricted service without revealing their exact date of birth, offering greater privacy than a traditional ID.
#### 💡Case study: Bhutan National Digital ID (NDI) on Ethereum
@@ -87,7 +87,7 @@ The Kingdom of Bhutan [launched a National Digital Identity (NDI) system](https:
Using decentralized identifiers and verifiable credentials, Bhutan's NDI issues digitally signed credentials directly to a citizen's personal wallet. By anchoring cryptographic proofs of these credentials on Ethereum, the system ensures they are authentic, tamper-proof, and can be verified by any party without querying a central authority.
-The system's architecture emphasizes privacy through the use of [Zero-Knowledge Proof (ZKP)](https://ethereum.org/zero-knowledge-proofs/) technology. This implementation of "selective disclosure" allows citizens to prove specific facts (e.g., "I am over 18" or "I am a citizen") to access services without revealing the underlying personal data, such as their full ID number or exact date of birth. This demonstrates a powerful, real-world use of Ethereum for a secure, user-centric, and privacy-preserving national ID system.
+The system's architecture emphasizes privacy through the use of [Zero-Knowledge Proof (ZKP)](/zero-knowledge-proofs/) technology. This implementation of "selective disclosure" allows citizens to prove specific facts (e.g., "I am over 18" or "I am a citizen") to access services without revealing the underlying personal data, such as their full ID number or exact date of birth. This demonstrates a powerful, real-world use of Ethereum for a secure, user-centric, and privacy-preserving national ID system.
## What are attestations? {#what-are-attestations}
diff --git a/public/content/zero-knowledge-proofs/index.md b/public/content/zero-knowledge-proofs/index.md
index 30ab9ebe606..816f367bdc3 100644
--- a/public/content/zero-knowledge-proofs/index.md
+++ b/public/content/zero-knowledge-proofs/index.md
@@ -57,7 +57,7 @@ Zero-knowledge proofs are particularly useful in the context of [decentralized i
A real-world example of using ZKP for identity management systems is the Kingdom of Bhutan's National Digital ID (NDI) system, built on Ethereum. Bhutan’s NDI uses ZKPs to allow citizens to cryptographically prove facts about themselves, like "I am a citizen" or "I am over 18," without revealing the sensitive personal data on their ID.
- Learn more about Bhutan NDI in the Decentralized Identity case study.
+ Learn more about Bhutan NDI in the Decentralized Identity case study.
From e48fd7ff7b53afd8d80808fa540ed40ca271a906 Mon Sep 17 00:00:00 2001
From: Joshua <62268199+minimalsm@users.noreply.github.com>
Date: Thu, 30 Oct 2025 12:03:30 +0000
Subject: [PATCH 3/5] Update public/content/decentralized-identity/index.md
---
public/content/decentralized-identity/index.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/public/content/decentralized-identity/index.md b/public/content/decentralized-identity/index.md
index c52df0c8042..979e936c215 100644
--- a/public/content/decentralized-identity/index.md
+++ b/public/content/decentralized-identity/index.md
@@ -83,9 +83,7 @@ This model allows for selective disclosure, especially when combined with [zero-
#### 💡Case study: Bhutan National Digital ID (NDI) on Ethereum
-The Kingdom of Bhutan [launched a National Digital Identity (NDI) system](https://www.dailybhutan.com/article/bhutan-makes-history-as-the-world-s-first-nation-to-launch-a-national-digital-id-on-ethereum) on Ethereum in October 2025, built on the principles of decentralized identity and self-sovereign identity. This nationwide deployment puts the decentralized identity model into practice across the country.
-
-Using decentralized identifiers and verifiable credentials, Bhutan's NDI issues digitally signed credentials directly to a citizen's personal wallet. By anchoring cryptographic proofs of these credentials on Ethereum, the system ensures they are authentic, tamper-proof, and can be verified by any party without querying a central authority.
+The Kingdom of Bhutan [launched a National Digital Identity (NDI) system](https://www.dailybhutan.com/article/bhutan-makes-history-as-the-world-s-first-nation-to-launch-a-national-digital-id-on-ethereum) on Ethereum in October 2025, built on the principles of decentralized identity and self-sovereign identity. Using decentralized identifiers and verifiable credentials, Bhutan's NDI issues digitally signed credentials directly to a citizen's personal wallet. By anchoring cryptographic proofs of these credentials on Ethereum, the system ensures they are authentic, tamper-proof, and can be verified by any party without querying a central authority.
The system's architecture emphasizes privacy through the use of [Zero-Knowledge Proof (ZKP)](/zero-knowledge-proofs/) technology. This implementation of "selective disclosure" allows citizens to prove specific facts (e.g., "I am over 18" or "I am a citizen") to access services without revealing the underlying personal data, such as their full ID number or exact date of birth. This demonstrates a powerful, real-world use of Ethereum for a secure, user-centric, and privacy-preserving national ID system.
From 3fc5c4b62cbf4a5fb6c24774e602d474bad93dbf Mon Sep 17 00:00:00 2001
From: Melissa Nelson
Date: Fri, 31 Oct 2025 08:41:46 -0400
Subject: [PATCH 4/5] edits and adding QuarkID
---
.../content/decentralized-identity/index.md | 19 +++++++++++++++++--
1 file changed, 17 insertions(+), 2 deletions(-)
diff --git a/public/content/decentralized-identity/index.md b/public/content/decentralized-identity/index.md
index 979e936c215..84dde32a9f1 100644
--- a/public/content/decentralized-identity/index.md
+++ b/public/content/decentralized-identity/index.md
@@ -83,9 +83,24 @@ This model allows for selective disclosure, especially when combined with [zero-
#### 💡Case study: Bhutan National Digital ID (NDI) on Ethereum
-The Kingdom of Bhutan [launched a National Digital Identity (NDI) system](https://www.dailybhutan.com/article/bhutan-makes-history-as-the-world-s-first-nation-to-launch-a-national-digital-id-on-ethereum) on Ethereum in October 2025, built on the principles of decentralized identity and self-sovereign identity. Using decentralized identifiers and verifiable credentials, Bhutan's NDI issues digitally signed credentials directly to a citizen's personal wallet. By anchoring cryptographic proofs of these credentials on Ethereum, the system ensures they are authentic, tamper-proof, and can be verified by any party without querying a central authority.
+* Provides access to verifiable identity credentials for Bhutan's nearly 800,000 citizens
+* Migrated from the Polygon network [to Ethereum mainnet](https://www.bhutanndi.com/article/bhutan-adopts-ethereum-for-national-identity-a-new-chapter-in-digital-sovereignty_2d0c7ec2-5605-4c42-b258-bd9361ae8878) in October 2025
+* Over [234,000 digital IDs](https://www.blockchain-council.org/blockchain/bhutan-uses-blockchain-in-digital-id-project/) issued as of March 2025
+
+The Kingdom of Bhutan [migrated its National Digital Identity (NDI) system](https://www.bhutanndi.com/article/bhutan-adopts-ethereum-for-national-identity-a-new-chapter-in-digital-sovereignty_2d0c7ec2-5605-4c42-b258-bd9361ae8878) to Ethereum in October 2025. Built on the principles of decentralized identity and self-sovereign identity, Bhutan’s NDI system uses decentralized identifiers and verifiable credentials to issue digitally signed credentials directly to a citizen's personal wallet. By anchoring cryptographic proofs of these credentials on Ethereum, the system ensures they are authentic, tamper-proof, and can be verified by any party without querying a central authority.
+
+The system's architecture emphasizes privacy through the use of [zero-knowledge proof (ZKP)](/zero-knowledge-proofs/) technology. This implementation of "selective disclosure" allows citizens to prove specific facts (e.g., "I am over 18" or "I am a citizen") to access services without revealing the underlying personal data, such as their full ID number or exact date of birth. This demonstrates a powerful, real-world use of Ethereum for a secure, user-centric, and privacy-preserving national ID system.
+
+#### 💡Case study: City of Buenos Aires QuarkID on Ethereum [Layer 2](/layer-2/) ZKSync Era
+
+* Issued decentralized identity credentials to over [3.6 million users](https://buenosaires.gob.ar/innovacionytransformaciondigital/miba-con-tecnologia-quarkid-la-ciudad-de-buenos-aires-incorporo) at launch
+* QuarkID is an open-source protocol recognized as a [Digital Public Good](https://www.digitalpublicgoods.net/r/quarkid) under the UN Sustainable Development Goals
+* Emphasizes a "[government-as-user](https://buenosaires.gob.ar/innovacionytransformaciondigital/miba-con-tecnologia-quarkid-la-ciudad-de-buenos-aires-incorporo)" model, where the city does not own the protocol, giving citizens full data ownership and privacy
+
+In 2024, the Government of the City of Buenos Aires (GCBA) integrated QuarkID, the open-source “digital trust framework” built by the GCBA’s Secretariat of Innovation and Digital Transformation, into miBA, the city’s official app for residents to access government services and official documents. At launch, all 3.6 million+ users of miBA were issued decentralized digital identities that allow them to manage and share verifiable digital documents and certificates onchain, including citizenship credentials, birth, marriage, and death certificates, tax records, vaccination records, and more.
+
+Built on Ethereum [Layer 2](/layer-2/) network ZKSync Era, the QuarkID system uses ZKP technology to allow citizens to verify personal credentials peer-to-peer through their mobile devices—without exposing unnecessary personal data. The program highlights a “government-as-user" model in which the GCBA acts as one user of the open-source, interoperable QuarkID protocol, rather than acting as a centralized owner. This ZKP-enabled architecture provides a key privacy feature: no third-party, not even the GCBA, can track how, when, or why a citizen uses their credentials. This successful program provides citizens with full self-sovereign identity and control over their sensitive data, all secured by Ethereum’s globally-distributed network.
-The system's architecture emphasizes privacy through the use of [Zero-Knowledge Proof (ZKP)](/zero-knowledge-proofs/) technology. This implementation of "selective disclosure" allows citizens to prove specific facts (e.g., "I am over 18" or "I am a citizen") to access services without revealing the underlying personal data, such as their full ID number or exact date of birth. This demonstrates a powerful, real-world use of Ethereum for a secure, user-centric, and privacy-preserving national ID system.
## What are attestations? {#what-are-attestations}
From 40ad9cf5e172a9913a4cab1d376012e6f60ee9bf Mon Sep 17 00:00:00 2001
From: Paul Wackerow <54227730+wackerow@users.noreply.github.com>
Date: Mon, 3 Nov 2025 19:22:39 -0600
Subject: [PATCH 5/5] chore: syntax formatting, add custom header ids
---
.../content/decentralized-identity/index.md | 21 +++++++++----------
1 file changed, 10 insertions(+), 11 deletions(-)
diff --git a/public/content/decentralized-identity/index.md b/public/content/decentralized-identity/index.md
index 84dde32a9f1..714e8df822f 100644
--- a/public/content/decentralized-identity/index.md
+++ b/public/content/decentralized-identity/index.md
@@ -81,26 +81,25 @@ Governments can use the principles of decentralized identity to issue foundation
This model allows for selective disclosure, especially when combined with [zero-knowledge proof (ZKP)](/zero-knowledge-proofs/) privacy technology. For example, a citizen could cryptographically prove they are over 18 to access an age-restricted service without revealing their exact date of birth, offering greater privacy than a traditional ID.
-#### 💡Case study: Bhutan National Digital ID (NDI) on Ethereum
+#### 💡Case study: Bhutan National Digital ID (NDI) on Ethereum {#case-study-bhutan-ndi}
-* Provides access to verifiable identity credentials for Bhutan's nearly 800,000 citizens
-* Migrated from the Polygon network [to Ethereum mainnet](https://www.bhutanndi.com/article/bhutan-adopts-ethereum-for-national-identity-a-new-chapter-in-digital-sovereignty_2d0c7ec2-5605-4c42-b258-bd9361ae8878) in October 2025
-* Over [234,000 digital IDs](https://www.blockchain-council.org/blockchain/bhutan-uses-blockchain-in-digital-id-project/) issued as of March 2025
+- Provides access to verifiable identity credentials for Bhutan's nearly 800,000 citizens
+- Migrated from the Polygon network [to Ethereum mainnet](https://www.bhutanndi.com/article/bhutan-adopts-ethereum-for-national-identity-a-new-chapter-in-digital-sovereignty_2d0c7ec2-5605-4c42-b258-bd9361ae8878) in October 2025
+- Over [234,000 digital IDs](https://www.blockchain-council.org/blockchain/bhutan-uses-blockchain-in-digital-id-project/) issued as of March 2025
The Kingdom of Bhutan [migrated its National Digital Identity (NDI) system](https://www.bhutanndi.com/article/bhutan-adopts-ethereum-for-national-identity-a-new-chapter-in-digital-sovereignty_2d0c7ec2-5605-4c42-b258-bd9361ae8878) to Ethereum in October 2025. Built on the principles of decentralized identity and self-sovereign identity, Bhutan’s NDI system uses decentralized identifiers and verifiable credentials to issue digitally signed credentials directly to a citizen's personal wallet. By anchoring cryptographic proofs of these credentials on Ethereum, the system ensures they are authentic, tamper-proof, and can be verified by any party without querying a central authority.
The system's architecture emphasizes privacy through the use of [zero-knowledge proof (ZKP)](/zero-knowledge-proofs/) technology. This implementation of "selective disclosure" allows citizens to prove specific facts (e.g., "I am over 18" or "I am a citizen") to access services without revealing the underlying personal data, such as their full ID number or exact date of birth. This demonstrates a powerful, real-world use of Ethereum for a secure, user-centric, and privacy-preserving national ID system.
-#### 💡Case study: City of Buenos Aires QuarkID on Ethereum [Layer 2](/layer-2/) ZKSync Era
+#### 💡Case study: City of Buenos Aires QuarkID on Ethereum [Layer 2](/layer-2/) ZKSync Era {#case-study-buenos-aires-quarkid}
-* Issued decentralized identity credentials to over [3.6 million users](https://buenosaires.gob.ar/innovacionytransformaciondigital/miba-con-tecnologia-quarkid-la-ciudad-de-buenos-aires-incorporo) at launch
-* QuarkID is an open-source protocol recognized as a [Digital Public Good](https://www.digitalpublicgoods.net/r/quarkid) under the UN Sustainable Development Goals
-* Emphasizes a "[government-as-user](https://buenosaires.gob.ar/innovacionytransformaciondigital/miba-con-tecnologia-quarkid-la-ciudad-de-buenos-aires-incorporo)" model, where the city does not own the protocol, giving citizens full data ownership and privacy
+- Issued decentralized identity credentials to over [3.6 million users](https://buenosaires.gob.ar/innovacionytransformaciondigital/miba-con-tecnologia-quarkid-la-ciudad-de-buenos-aires-incorporo) at launch
+- QuarkID is an open-source protocol recognized as a [Digital Public Good](https://www.digitalpublicgoods.net/r/quarkid) under the UN Sustainable Development Goals
+- Emphasizes a "[government-as-user](https://buenosaires.gob.ar/innovacionytransformaciondigital/miba-con-tecnologia-quarkid-la-ciudad-de-buenos-aires-incorporo)" model, where the city does not own the protocol, giving citizens full data ownership and privacy
-In 2024, the Government of the City of Buenos Aires (GCBA) integrated QuarkID, the open-source “digital trust framework” built by the GCBA’s Secretariat of Innovation and Digital Transformation, into miBA, the city’s official app for residents to access government services and official documents. At launch, all 3.6 million+ users of miBA were issued decentralized digital identities that allow them to manage and share verifiable digital documents and certificates onchain, including citizenship credentials, birth, marriage, and death certificates, tax records, vaccination records, and more.
-
-Built on Ethereum [Layer 2](/layer-2/) network ZKSync Era, the QuarkID system uses ZKP technology to allow citizens to verify personal credentials peer-to-peer through their mobile devices—without exposing unnecessary personal data. The program highlights a “government-as-user" model in which the GCBA acts as one user of the open-source, interoperable QuarkID protocol, rather than acting as a centralized owner. This ZKP-enabled architecture provides a key privacy feature: no third-party, not even the GCBA, can track how, when, or why a citizen uses their credentials. This successful program provides citizens with full self-sovereign identity and control over their sensitive data, all secured by Ethereum’s globally-distributed network.
+In 2024, the Government of the City of Buenos Aires (GCBA) integrated QuarkID, the open-source “digital trust framework” built by the GCBA’s Secretariat of Innovation and Digital Transformation, into miBA, the city’s official app for residents to access government services and official documents. At launch, all 3.6 million+ users of miBA were issued decentralized digital identities that allow them to manage and share verifiable digital documents and certificates onchain, including citizenship credentials, birth, marriage, and death certificates, tax records, vaccination records, and more.
+Built on Ethereum [Layer 2](/layer-2/) network ZKSync Era, the QuarkID system uses ZKP technology to allow citizens to verify personal credentials peer-to-peer through their mobile devices—without exposing unnecessary personal data. The program highlights a “government-as-user" model in which the GCBA acts as one user of the open-source, interoperable QuarkID protocol, rather than acting as a centralized owner. This ZKP-enabled architecture provides a key privacy feature: no third-party, not even the GCBA, can track how, when, or why a citizen uses their credentials. This successful program provides citizens with full self-sovereign identity and control over their sensitive data, all secured by Ethereum’s globally-distributed network.
## What are attestations? {#what-are-attestations}