Skip to content

Commit 485464b

Browse files
2colormishmosh
andauthored
Apply suggestions from code review
Co-authored-by: Mosh <1306020+mishmosh@users.noreply.github.com>
1 parent 0c90dce commit 485464b

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

docs/concepts/case-study-snapshot.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Snapshot is unique in its use of IPFS to store proposals and user votes using a
2323

2424
This means that voting with Snapshot is practically free since voters don’t need to pay gas for transactions, i.e. *gasless voting*. In doing so, Snapshot lowers the barrier to entry for voting, increases governance participation, and allows projects and communities to scale their voter base.
2525

26-
Transparency, one of the core tenets of governance in the Web3 space is achieved by having all proposals and votes persisted using _content addressing_ on IPFS, thereby allowing anyone to view, audit, and replicate a copy of the CIDs containing the cryptographic signature.
26+
Transparency, one of the core tenets of governance in the Web3 space, is achieved by having all proposals and votes persisted using _content addressing_ on IPFS, thereby allowing anyone to view, audit, and replicate a copy of the CIDs containing the cryptographic signature.
2727

2828
Web3 projects and Decentralized Autonomous Organizations (DAOs) are typically characterized by their bottom-up approach to governance, where control is spread out across the participants (or token holders), rather than being built on a top-down hierarchy. While there are many different approaches to bottom-up community governance, almost all involve _voting_ as a mechanism to engage the community and distribute control.
2929

@@ -40,15 +40,15 @@ In essence, Snapshot allows projects and DAOs aiming for decentralization to pol
4040

4141
## The story
4242

43-
Snapshot was originally built as a side project while Fabien, Snapshot's founder was working for the automated market maker Balancer. The goal was to create a "simple voting platform”. Fabien realized his gas-efficient implementation using IPFS could be used by other projects.
43+
Snapshot was originally built as a side project while Fabien, Snapshot's founder, was working for the automated market maker Balancer. The goal was to create a "simple voting platform”. Fabien realized his gas-efficient implementation using IPFS could be used by other projects.
4444

4545
After open-sourcing an early version of Snapshot, it was quickly adopted by early DeFi projects like Yam and Yearn and has since taken over the governance landscape.
4646

47-
Today, Snapshot is the leading voting platform with over 9,645 spaces among which are many of the leading Ethereum projects, including Gitcoin, Ethereum Name System (ENS), Aave, Uniswap, and Sushi.
47+
Today, Snapshot is the leading voting platform used by over 9,645 projects. Their users include many of the leading Ethereum projects, including Gitcoin, Ethereum Name System (ENS), Aave, Uniswap, and Sushi.
4848

4949
## How Snapshot works
5050

51-
In snapshot, all proposals and votes are associated with a **space,** where each space is an organization’s (or project’s) page on Snapshot. Voters can access spaces by using the project's [Ethereum Name System (ENS)](http://ens.domains/) name, e.g. `https://snapshot.org/#/gitcoindao.eth`, where `gitcoindao.eth` is the ENS name.
51+
In Snapshot, all proposals and votes are associated with a **space,** where each space is an organization’s (or project’s) page on Snapshot. Voters can access spaces by using the project's [Ethereum Name System (ENS)](http://ens.domains/) name, e.g. `https://snapshot.org/#/gitcoindao.eth`, where `gitcoindao.eth` is the ENS name.
5252

5353
The only requirement for using Snapshot is to have an ENS name. To create a space, you create an [ENS text record](https://docs.ens.domains/ens-improvement-proposals/ensip-5-text-records) with the key `snapshot` pointing to an IPFS CID containing the JSON configuration for the space. For example, GnosisDAO with the [gnosis.eth ENS name has the `snapshot`](https://app.ens.domains/name/gnosis.eth/details) text record set to [`ipfs://QmWUemB5QDr6Zkp2tqQRcEW1ZC7n4MiLaE6CFneVJUeYyD`](https://ipfs.io/ipfs/QmWUemB5QDr6Zkp2tqQRcEW1ZC7n4MiLaE6CFneVJUeYyD) which contains the JSON configuration for the space.
5454

@@ -84,11 +84,11 @@ These voting systems are used to calculate the results of a vote based on the vo
8484

8585
## How Snapshot uses IPFS
8686

87-
Snapshot uses IPFS to make the whole voting process fully transparent and auditable. In practice, every space, proposal, vote, and user action is added to IPFS and has [CID](/concepts/content-addressing/).
87+
Snapshot uses IPFS to make the whole voting process fully transparent and auditable. Every space, proposal, vote, and user action is added to IPFS and has a [content identifier (CID)](/concepts/content-addressing/).
8888

8989
Additionally, the Snapshot UI is also [available on IPFS](https://bafybeihzjoqahhgrhnsksyfubnlmjvkt66aliodeicywwtofodeuo2icde.ipfs.dweb.link/).
9090

91-
To understand how Snapshot uses IPFS, it's useful to understand how the whole architecture was designed. Snapshot is a hybrid app combining design patterns common to Web2 and Web3 apps, and built based on the three-tier architecture:
91+
To understand how Snapshot uses IPFS, it's useful to understand how the whole architecture was designed. Snapshot is a hybrid app combining design patterns common to Web2 and Web3 apps, and is based on the three-tier architecture:
9292

9393
- **Presentation tier:** [The Snapshot UI](https://github.com/snapshot-labs/snapshot). The UI is also available over IPFS (see the `x-ipfs-path` header when making an HTTP request to `https://snapshot.org`.)
9494
- **Logic tier:** The [snapshot-hub](https://github.com/snapshot-labs/snapshot-hub) node.js server that exposes a GraphQL API.
@@ -110,7 +110,7 @@ After data is added to the IPFS network via pinning services, it is also made av
110110

111111
## IPFS benefits
112112

113-
When the Snapshot team set out to build openly auditable voting systems, they chose IPFS because it’s the standard for storing data that is too large to store on blockchains while being fully verifiable.
113+
When the Snapshot team set out to build openly auditable voting systems, they chose IPFS because it’s the standard for storing data that must be fully verifiable, but is too large to store on blockchains.
114114

115115
The combination of user-controlled keys (via non-custodial crypto wallets), cryptographic signatures that prove the authenticity of user actions, and content addressable storage via the IPFS network have proven to be critical to Snapshot's success.
116116

@@ -124,7 +124,7 @@ Moreover, IPFS has several properties that enable that mission:
124124

125125
## Snapshot & IPFS: the future
126126

127-
As Snapshot continues to evolve, the team looks forward to decentralizing its tech stack so that anyone can run a node reducing the dependency on the Snapshot Node.js severs. Thanks to IPFS's integral role in Snapshot, a significant part of their data layer is already decentralized.
127+
As Snapshot continues to evolve, the team looks forward to decentralizing its tech stack so that anyone can run a node, reducing the dependency on the Snapshot Node.js severs. Thanks to IPFS's integral role in Snapshot, a significant part of their data layer is already decentralized.
128128

129129
::: callout
130130
**"Anytime we need to store data in Snapshot, we use IPFS so that users get full transparency and the ability to also take an active part in replicating that data."**

0 commit comments

Comments
 (0)