The Arbor Protocol, or more simply called Arbor, is a schelling game where the objective is to publicly co-create songs worthy of purchase by NFT collectors.
LIVE DEMO: https://arbor.audio
This application is run on the Polygon Mainnet network. All contracts are deployed at the following addresses:
| Contract | Address |
|---|---|
| PolyechoNFT | 0x6F6f53296049149a02373E3458fb105171481268 |
| StemQueue | 0x16480B6d607952090fa4948EC75395659cC7D32A |
| Verifier20 | 0x7810D24738405b6B38ee8a6150E438Bc57595029 |
| PoseidonT3 | 0xe48fe3C863EDaD6c33EE9e4b51fcaFf5d48Ca9D3 |
| IncrementalMerkleTree | 0x559975Ff0024FBfF2fb9c9E8553c7263F691515d |
Arbor uses zero knowledge technologies to incorporate anonymous voting on stems that are within a Project's Stem Queue. It accomplishes this by using a series of zkSNARKs and relying on some of the packages to incorporate these into the dApp.
| Library | Use Case |
|---|---|
| @semaphore-protocol/group | To create the on-chain Semaphore voting group for a given Project |
| @zk-kit/identity | To create the anonymous identity for the voter |
| @zk-kit/protocols | To generate the off-chain proof and witness to submit to the on-chain verifier that a voter is a member of the Project's voting group |
The workflow for the zkSNARK use with Semaphore groups within the dApp are as follows:
- A user creates a new project. A new Semaphore group is created on chain and tied to a unique identifier for the project.
- A user uploads a stem onto a project. The stem is put into the Stem Queue.
- With stems availabe in the queue, a user can register to be a voter for this project. A message is signed and an identity commitment is created from the signature. The commitment is then submitted to the on-chain group and stored in the Merkle tree for the given group that is tied to the given Project.
- Only registered users can cast votes on available stems within the Stem Queue. When a user votes on a stem, the signal is the stem's unique identifier stored in MongoDB. A Merkle proof is generated from the voter's identity along with all the other identities stored from other users within the voting group. A witness is generated from this proof and used to create a full proof with the WASM and verification key SNARK-based files initially created from the trusted setup. This full proof is then submitted along with the signal to the StemQueue.sol contract. The contract function then verifies the proof. If all is okay, the function will succeed and the vote is stored on-chain, anonymously.
- With stems having at least one vote, a collaborator of the Project can then approve the stem to be added on for the next slot. This will remove the stem from the Stem Queue.
- The user who uploaded the approved stem will now become a collaborator on the Project and will gain approval permissions.
- Collaborators can register and vote within the Stem Queue as well, allowing them to remain anonymous and contribute to voting.
First, clone this repository to your local machine:
git clone https://github.com/arbor-protocol/ui.gitThere is some local setup that needs to happen to fully run this client application locally.
Dependencies:
- npm or yarn
- Node.js
- MongoDB
You can download the latest version of Node.js here. You can check that you are running NPM and Node with the following commands:
node -v
# v16.14.0
npm -v
# 8.3.1Install the client dependencies with the following command:
yarn install
# or
npm installNext, set up local environment variables by copying over the values from .env to a .env.local file. Run the following command:
# Unix
cp .env .env.local
# windows
xcopy .env .env.localNOTE: Please reach out to the core team for a set of values to fill in your local env file.
Finally, you can run the development server using the following command:
yarn dev
# or
npm run devOpen http://localhost:3000 with your browser to see the result.
This client application is using the built-in Next.js API routes that read and write to a local Mongo database. Here are our recommended steps for getting up and running with a local MongoDB environemnt:
We recommend using MongoDB Community Edition, because it is free and has all the necessary features.
This will set up a host to run in the background on the machine. You can then connect to it via a number of methods when it is up.
- For Mac users, you can follow the steps listed here.
- For Windows users, you can follow the steps listed here.
There are many ways to interact with a MongoDB host. My recommendation is to use a GUI, as it makes for viewing the data easily, and MongoDB Compass is free and easy to use. Install it using the documentation here.
Once MongoDB Compass is installed and you have a MongoDB host running in the background, you can now connect the client to the host and set up this new connection. Open up Compass and click "New Connection" in the top left of the GUI, or in the menubar. Paste in the local connection string; it should look similar to this on Mac:
mongodb://localhost:27017/?readPreference=primary&appname=MongoDB%20Compass&ssl=falseCreate a new database for Arbor. Title it arbor-protocol or whatever suits your fancy. It may prompt you to add a collection to it as well. Please add a users collection.
The important bit is to update your local environment variables in the client app. Update the following in .env.local to your new connection string:
MONGODB_URI=mongodb://localhost/arbor-protocolThis will now allow the client app to work with the local MongoDB instance, and you can now interact with it through Compass as a GUI.
NOTE: You can always shut down the background mongo daemon that's running after using it. For Mac and Homebrew users, you can check that it's running with brew services list, and then you can shut it down with brew services stop mongodb-community. For Windows users, it would be net stop MongoDB, which is the default service name from the installer.
We encourage the open-source atmosphere. If you find any bugs or issues with this repository, don't hesitate to file an issue for it. We will work to continually engage with these issues and encourage you to contribute.