Skip to content

Latest commit

 

History

History
170 lines (130 loc) · 18.2 KB

README.md

File metadata and controls

170 lines (130 loc) · 18.2 KB
art_canvas

Collaborative art canvas on Starknet

Check Workflow Status Build Workflow Status

Exploration_Team

Overview

art/peace is a collaborative art game where users can place pixels on a large shared canvas and receive rewards for collaborating to build art. The game will run over X days, and end with a final snapshot of the board. The goal is to give users the feeling of collectively building on a highly responsive art canvas, which they can explore, interact with, and compete on.

Some of the features include :

  • Placing Pixels : This will be the main user interaction, where every X minutes a user will be allowed to place a pixel onto the canvas.
  • Quests : Tasks to get extra pixels to place on-top of the one every X minutes.
  • Voting : In addition to the base colors, there will be a vote to add new colors to the palette every day.
  • Templates : Artwork templates used to help communities collaborate on an art piece. Bounties can be added to a template to incentivize creation.
  • NFTs : Mint NFTs from the canvas.

Running

Docker Run ( Recommended )

docker compose up

To stop the run use Ctrl-C.

For a complete reset of the state and rebuild of the containers use :

# WARNING! This will clear the state (volumes) of all the DBs and the Devnet
docker compose down --volumes
docker compose build

Local Run

# Must install all the dependencies first
# Use npm install inside the `frontend` directory
# Change the user on `configs/database.config.json` for postgres
make integration-test-local

To stop the run use Ctrl-C.

Component Run

Each component can also be run individually, check the Components section below for more details.

Build

Docker Build ( Recommended )

docker compose build

Local Build

make build

Component Build

Use the make build-X command for each corresponding component X. See the Components section below for more details.

Components

  • Onchain: Starknet contract(s) for trustless onchain interactions.
  • Backend: Monolithic Go backend for managing requests, interactions, and DBs.
  • Frontend: Reactjs application for users to interact with.
  • Indexer: Apibara indexer for monitoring Starknet events and forwarding to the DBs.
  • Postgres: DB for storing general data used for analytics, frontend, and backend.
  • Redis: In memory DB used to store the compressed Canvas data for fast retrieval
  • tests: Integration tests for local, docker, ...

art/peace diagram

Dependencies

Its recommended to use docker compose when building and running, so the only dependencies would be docker and docker compose

However, it might be worth running only certain components for development/testing sometimes. Each component has various dependencies, check dependencies.txt for more details.

References

Contributors ✨

Thanks goes to these wonderful people. Follow the contributors guide if you'd like to take part.

Brandon R
Brandon R

💻
Adeyemi Gbenga
Adeyemi Gbenga

💻
Tristan
Tristan

💻
Abdulhakeem Abdulazeez Ayodeji
Abdulhakeem Abdulazeez Ayodeji

💻
Trunks @ Carbonable
Trunks @ Carbonable

💻
ptisserand
ptisserand

💻
Mubarak Muhammad Aminu
Mubarak Muhammad Aminu

💻
0xK2
0xK2

💻
Fishon Amos
Fishon Amos

💻
Xaxxoo
Xaxxoo

💻
Mano.dev
Mano.dev

💻
Abdulsamad sadiq
Abdulsamad sadiq

💻
Agada Gabriel
Agada Gabriel

💻
Abdulqahar Usman
Abdulqahar Usman

💻
Awe Olumide David
Awe Olumide David

💻
Catherine Jonathan
Catherine Jonathan

💻
Emmaunuel Ejembi
Emmaunuel Ejembi

💻
CollinsC1O
CollinsC1O

💻
Alfred Emmanuel
Alfred Emmanuel

💻
princeibs
princeibs

💻
Oshioke Salaki
Oshioke Salaki

💻
Caleb
Caleb

💻
Immanuelolivia
Immanuelolivia

💻
Stephanie Nwankwo
Stephanie Nwankwo

💻
Joy Adah
Joy Adah

💻
Na'omi Emmanuel Gift
Na'omi Emmanuel Gift

💻
Yusuf Habib
Yusuf Habib

💻
drspacemn
drspacemn

💻
Emmanuel A Akalo
Emmanuel A Akalo

💻
Kenee Patel
Kenee Patel

💻
BillXJ
BillXJ

💻
Jemiiah
Jemiiah

💻
Umar I Salihu
Umar I Salihu

💻
Add your contributions

This project follows the all-contributors specification. Contributions of any kind welcome!