https://github.com/walterthesmart/luxurygoodss
The Luxury Goods smart contract, built on the Stacks blockchain using the Clarity language, enables users to purchase luxury items using STX or sBTC. Each purchase mints a unique NFT as proof of ownership. The contract ensures secure payments and transfers, while the interactive front-end UI, is written in TypeScript.
https://github.com/walterthesmart/luxurygoodss
bitcoin blockchain ecommerce luxury nft smart-contracts
Last synced: about 2 months ago
JSON representation
The Luxury Goods smart contract, built on the Stacks blockchain using the Clarity language, enables users to purchase luxury items using STX or sBTC. Each purchase mints a unique NFT as proof of ownership. The contract ensures secure payments and transfers, while the interactive front-end UI, is written in TypeScript.
- Host: GitHub
- URL: https://github.com/walterthesmart/luxurygoodss
- Owner: walterthesmart
- Created: 2024-09-21T10:56:37.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-02-28T18:39:43.000Z (3 months ago)
- Last Synced: 2025-02-28T22:35:57.259Z (3 months ago)
- Topics: bitcoin, blockchain, ecommerce, luxury, nft, smart-contracts
- Language: Clarity
- Homepage:
- Size: 202 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Luxury Goods Smart Contract
The Luxury Goods smart contract is built on the Stacks blockchain using the Clarity language. This contract enables users to purchase luxury goods using STX or sBTC and receive NFTs as proof of purchase. The front end provides an interactive UI for browsing and buying luxury items.
## Key Features
1. **Flexible Payments**: Users can make payments using STX or sBTC, offering flexibility in payment methods and catering to different user preferences.
2. **NFT Minting**: Each user receives an NFT minted after every purchase, serving as a digital receipt and proof of ownership. These NFTs are unique and can be used to verify the authenticity of the purchased goods.
3. **Security Measures**: The smart contract incorporates robust security measures to ensure safe payments and secure NFT transfers. This includes encryption, validation checks, and secure wallet integrations.
4. **Interactive UI**: The front end, written in TypeScript, provides an engaging user experience where luxury goods are showcased. Users can connect their wallets using the Stacks.js module for seamless transactions.
## How It Works
1. **Browse Luxury Goods**: Users can explore the available luxury goods through the interactive UI. Each item is displayed with detailed information, images, and pricing.
2. **Make Payments**: Users can select their preferred payment method (STX or sBTC) and proceed with the payment for their selected items. The smart contract handles the payment processing securely.
3. **Receive NFT**: After a successful purchase, an NFT is automatically minted and sent to the user's wallet as proof of purchase. The NFT contains metadata about the purchase, including the item details and transaction information.
4. **Secure Transactions**: The smart contract ensures all transactions are secure, protecting both payments and NFT transfers. This includes multi-signature wallets and two-factor authentication where necessary.
## Installation and Usage
### Smart Contract Deployment
1. **Clone the Repository**:
```bash
git clone https://github.com/yourusername/luxury-goods-smart-contract.git
cd luxury-goods-smart-contract
```
2. **Deploy the Smart Contract**:
- Use the Stacks CLI or your preferred method to deploy the smart contract on the Stacks blockchain.
- Ensure you have sufficient STX or sBTC for deployment and transaction fees.
- Compile and deploy the contract using:
```bash
clarity-cli check ./contracts/luxury-goods.clar
clarity-cli launch ./contracts/luxury-goods.clar
```
### Front End Setup
1. **Navigate to the Front End Directory**:
```bash
cd frontend
```
2. **Install Dependencies**:
```bash
npm install
```
3. **Run the Development Server**:
```bash
npm start
```
4. **Connect Wallet**:
- Users can connect their wallets using the Stacks.js module integrated into the front end.
- The front end provides a simple interface for users to connect their Stacks wallets and authorize transactions.
### Making a Purchase
1. **Select an Item**: Browse the list of luxury goods and select the item you wish to purchase.
2. **Choose Payment Method**: Select whether you want to pay with STX or sBTC.
3. **Confirm Payment**: Follow the on-screen instructions to complete the payment process.
4. **Receive NFT**: After the payment is confirmed, the NFT will be minted and sent to your connected wallet.
## Contributing
We welcome contributions! If you would like to contribute to this project, please follow these steps:
1. Fork the repository.
2. Create a new branch (`git checkout -b feature/your-feature`).
3. Commit your changes (`git commit -am 'Add your feature'`).
4. Push to the branch (`git push origin feature/your-feature`).
5. Create a new Pull Request.
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.
## Acknowledgements
- [Stacks Blockchain](https://stacks.co/) for providing the blockchain infrastructure.
- [Clarity Language](https://clarity-lang.org/) for the smart contract language.
- [Stacks.js](https://github.com/blockstack/stacks.js) for the wallet connection module.
- [TypeScript](https://www.typescriptlang.org/) for the front-end language.
---
Feel free to adjust any details or add more sections as needed to fit your project's specifics.