https://github.com/fabohax/4v4
3D NFT Platform
https://github.com/fabohax/4v4
babylon clarity nextjs stacks
Last synced: about 2 months ago
JSON representation
3D NFT Platform
- Host: GitHub
- URL: https://github.com/fabohax/4v4
- Owner: fabohax
- Created: 2025-03-08T07:23:50.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-13T00:17:15.000Z (12 months ago)
- Last Synced: 2025-06-13T00:32:38.044Z (12 months ago)
- Topics: babylon, clarity, nextjs, stacks
- Language: TypeScript
- Homepage: https://4v4.diy
- Size: 20.5 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
**4V4** is a digital playground for 3D mods, built on the Stacks blockchain. This full-stack dApp enables users to mint, list, and trade 3D models as NFTs using L2 satoshis. It demonstrates how to build scalable and expressive NFT platforms using Clarity smart contracts, Next.js, and Hiro.
⚠️ This project is intended for development purposes only. Contracts have not been audited for production.
---
## 🔥 Features
- Mint 3D models to user wallets as NFTs
- List models for sale with optional takers, expiry, or batch operations
- Trade NFTs using STX, SIP-010 tokens, and (soon) sBTC
- Supports royalties per NFT via `get-royalty-info`
- Secure SIP-009 ownership and transfers
- Pagination for listings
- Hiro wallet integration for devnet testing
---
## 🚀 Getting Started
### Prerequisites
- [Hiro Platform](https://platform.hiro.so) account
- Node.js 18+ and npm/yarn/pnpm
- Recommended: [Clarinet](https://github.com/hirosystems/clarinet) + [Clarity VSCode Extension](https://marketplace.visualstudio.com/items?itemName=HiroSystems.clarity-lsp)
---
### 1. Start Devnet via Hiro Platform
- Log in at [platform.hiro.so](https://platform.hiro.so)
- Start Devnet inside your project
- Copy the API Key from the Devnet API or Settings page
---
### 2. Clone and Set Up Project Locally
```bash
git clone https://github.com/fabohax/4v4.git
cd 4v4/clarity
npm install
cd ../front-end
npm install
cp .env.example .env
```
Add your Hiro Platform API key to `.env`:
```
NEXT_PUBLIC_PLATFORM_HIRO_API_KEY=your-api-key-here
```
---
### 3. Run the Frontend
```bash
npm run dev
```
Visit [http://localhost:3000](http://localhost:3000) to use the UI.
---
OSS Built with ♥️