fabianbormann / WalkInWallet

WalkInWallet | The NFT Gallery App

WalkInWallet | The NFT Gallery App

WalkInWallet allows you to walk in wallets as you walk in galleries.

WalkInWallet is an open-source React project that allows you to walk through wallets as you would walk in galleries. It generates a random 3D gallery out of every NFT in your wallet. The project is based on Babylon.js for the 3D rendering. The galleries are created using the wallet address as a seed for the random function, ensuring that a gallery would only be extended by new NFTs but never changed completely. The application is built on the Cardano blockchain and uses Koios to query the chain data.

✨ Features

• 3D Galleries: Explore NFTs in visually appealing 3D galleries.
• Random Seed Based: Each gallery is generated based on a random seed, preserving the uniqueness.
• Koios Integration: Query Cardano on-chain data seamlessly using Koios integration.
• jpg.store Link: The link displayed below every NFT will bring you directly to jpg.store.
• ADA Handles Support: Resolve simple and memorable names to Cardano addresses.

🎬 Demo

See the project in action by visiting our demo wallet.

🛠️ Installation

1. Clone the repository: git clone https://github.com/fabianbormann/WalkInWallet.git
2. Change directory: cd WalkInWallet
3. Install dependencies: npm i
4. Start the development server: npm start

🚀 Usage

1. Make sure you have an ADA Handle, stake address or payment address of a Cardano wallet containing NFTs.
2. Open the application in your browser or goto https://walkinwallet.com/<ADA_HANDLE | ADDRESS | POLICY_ID>.
3. Enjoy walking through 3D galleries!

🤝 Contributing

We appreciate every kind of contribution! If you want to contribute to the project, please follow these steps:

1. Fork the repository.
2. Create a new branch: git checkout -b feature/your-feature-name
3. Make your changes and commit them using Conventional Commits: git commit -m 'feat: add some feature'
4. Push the changes to your fork: git push origin feature/your-feature-name
5. Submit a pull request to the main repository.

Please ensure your code follows the project's coding style and that tests pass before submitting the pull request.

📜 License

WalkInWallet is licensed under the GPLv3 License. See the LICENSE file for more details.

🙏 Acknowledgments

• Babylon.js - One of the most powerful, beautiful, simple, and open web rendering engines in the world.
• Koios - A distributed & open-source public API query layer for Cardano.

📞 Support

If you have any questions or need assistance, please reach out to [e-mail] or contact us on Discord.