Skip to content
This repository has been archived by the owner on Mar 15, 2024. It is now read-only.

0xpolarzero/echoes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Echoes - a contemplative yet interactive collectible.

Just a carefully programmed contemplative entity, made of particles.

Each can take one of 3072 unique combinations, even though the purpose might just be to explore the possibilities on the website, and keep it as a pleasant immersive experience.

Motivation

Everything is available on testnets (Goerli, Mumbai, Arbitrum Goerli), as it should be for anything that is part of a learning process - if not for anything that includes a gamified or interactive aspect.

While this demonstrates only basic interactions between the echoes and their very minimalistic soundscape, as well as with the user, it is a good starting point for more complex interactions. Some ideas include:

  • Evolving soundscapes, based on the particles count, that would progressively change the echo's atmosphere.
  • Echo-to- interactions, such as the echoes being able to attract or repel each other, or even merge - as well as affecting each other's atmosphere, or each other through their atmosphere.
  • Collaborative soundscapes, where the echoes would be able to play sounds together, or even create new sounds (?) based on their interactions, or affinities.

How it works

Each has different attributes, such as colors (spectrum), background (scenery), a movement pattern for the particles (trace) and a soundscape that affects the particles (atmosphere).

Once generated, the echo will grow in particles with time, as well as from interactions with its creator, and will eventually reach a maximum size.

The contracts leave no place for removing any attribute or changing the echo's appearance, but it is possible to add new traits - which would allow for new echoes to be generated with the new traits. The source code can be cloned to display the echoes on your own, or maybe to try out with your own sounds, colors, etc.

Repository structure

frontend

Everything related to the frontend, made with Next.js & React Three Fiber.

hardhat

Everything related to the smart contracts, tests and deployments included.

render

Lightweight page, used for rendering the 3D models on plateforms such as OpenSea ; made with Vite & Three.js.

subgraphs

Everything related to the subgraphs, for indexing and querying contracts events on The Graph (Ethereum Goerli, Polygon Mumbai, Arbitrum Goerli).

Notes

  • ERC721 implementation, yet with a dynamic URI, allowing us to update very small parts of the metadata, as well as retrieving real-time timed data for the attributes.

  • All the metadata is stored on-chain, and is retrieved on the fly, based on the echo's attributes.

  • The echoes retrieved from multiple blockchains are merged into a single list, to display the most expanded ones on the explore page. They can also be displayed separately, which provides a 'top 10' for each chain, as well as a global one.