Skip to content

Latest commit

 

History

617 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LuxHub

LuxHub

Decentralized luxury asset marketplace on Solana
NFT-backed physical assets with verified provenance, on-chain escrow, and tokenized ownership pools.

CI Website Solana License TypeScript Anchor

Website · Features · Access · Security


Why LuxHub?

The $350B+ luxury resale market lacks trustless infrastructure. Buyers can't verify authenticity, sellers face chargebacks, and fractional access doesn't exist. LuxHub solves this:

  • Blockchain-verified provenance — every asset tokenized as an NFT with immutable authentication data
  • Trustless escrow — funds locked on-chain until physical delivery is confirmed
  • Tokenized ownership pools — own luxury watches starting from $1.50, not $100,000
  • Secondary market trading — buy and sell pool tokens on Bags DEX
  • Institutional-grade security — Squads Protocol multisig for all treasury operations
  • AI-powered onboarding — Claude Vision auto-analyzes watch images to fill mint forms in seconds

Features

Marketplace

Feature Description
NFT-Backed Listings Physical luxury items tokenized with IPFS/Arweave metadata
On-Chain Escrow Anchor smart contract locks NFT + funds until delivery
AI Watch Analysis Upload a photo — Claude Vision identifies brand, model, condition, estimated price
Vendor Verification KYC-lite onboarding with invite codes and admin approval
Multi-Image Gallery 5+ photos per listing with lightbox and swipe navigation
Condition Grading 5-grade scale (Unworn → Fair) with filter support
Search & Filter Brand, model, price range, and condition filters
Offers & Negotiation Buyers can make offers with counter-offer support
Dispute Resolution 7-day SLA buyer disputes with admin escalation
Shipping Integration EasyPost carrier tracking and label generation

Tokenized Ownership Pools

Feature Description
$1.50 Minimum Accessible entry point via 1B token supply per pool
Bonding Curve Fair price discovery during funding phase via Bags
Secondary Trading Trade pool tokens on Bags DEX after graduation
Resale Distribution Watch resale proceeds distributed to token holders
Automatic Fee Routing On-chain fee-share config splits fees to stakeholders

Admin & Vendor Tools

Feature Description
Admin Dashboard 9 specialized tabs — mint requests, custody, disputes, Squads proposals
Vendor Dashboard Inventory management, order fulfillment, earnings tracking
Squads Multisig Create, approve, and execute treasury proposals on-chain
Escrow Timeouts Auto-cancel if vendor doesn't ship within 14 days

3D Visualization

Feature Description
Interactive 3D Scene React Three Fiber hero with gyroscope support
Holographic NFT Cards 3D flip animation with sparkle particles and shine effects
Mobile Optimized Vanilla Tilt for device rotation on mobile

Architecture

LuxHub/
├── src/
│   ├── pages/                    # 20+ pages + 51 API endpoints
│   │   ├── api/
│   │   │   ├── bags/             # Bags tokenization (5 endpoints)
│   │   │   ├── pool/             # Pool management (20 endpoints)
│   │   │   ├── escrow/           # Escrow lifecycle (15 endpoints)
│   │   │   ├── admin/            # Admin operations (12 endpoints)
│   │   │   ├── vendor/           # Vendor management (8 endpoints)
│   │   │   ├── squads/           # Squads multisig (5 endpoints)
│   │   │   ├── ai/              # AI analysis (2 endpoints)
│   │   │   └── webhooks/         # Bags + Helius events
│   │   ├── marketplace.tsx       # NFT marketplace grid
│   │   ├── pools.tsx             # Trading terminal
│   │   ├── createNFT.tsx         # Mint form with AI + bulk upload
│   │   └── adminDashboard.tsx    # 9-tab admin panel
│   ├── components/               # 70 React components
│   │   ├── marketplace/          # NFT cards, pool UI, 3D scene
│   │   ├── admin/                # Dashboard tabs, custody mgmt
│   │   ├── vendor/               # Vendor tools, onboarding
│   │   └── common/               # Navbar, cards, wallet UI
│   ├── lib/
│   │   ├── models/               # 18 Mongoose schemas
│   │   ├── services/             # Bags, Squads, DAS, TX verification
│   │   ├── middleware/           # Auth, rate limiting, validation
│   │   └── security/            # AES-256-GCM encryption, wallet auth
│   ├── hooks/                    # usePools, useSWR hooks
│   └── styles/                   # 29+ CSS Modules (chrome glass design)
├── Solana-Anchor/                # Rust smart contracts
│   └── programs/luxhub-marketplace/
│       └── src/
│           ├── instructions/     # 16 on-chain instructions
│           ├── state/            # Escrow, config PDAs
│           └── errors/           # Custom error types
└── public/                       # 3D models, partner logos, assets

Tech Stack

Frontend Next.js 14 · React 18 · TypeScript 5.8 · CSS Modules · Framer Motion · React Three Fiber · SWR · Radix UI
Blockchain Solana · Anchor 0.31 · SPL Token · mpl-core · Helius RPC · Helius DAS API
Backend MongoDB · Mongoose · JWT + Wallet Signature Auth · Zod Validation · AES-256-GCM Encryption
Storage Pinata/IPFS · Irys (Arweave-backed permanent storage)
Integrations Squads Protocol v4 (multisig) · Bags API (tokenization + DEX) · Anthropic Claude (AI analysis) · EasyPost (shipping) · Sentry (monitoring) · Resend (transactional email)
Wallets Phantom · Solflare · Privy · Mobile Wallet Adapter
Deployment Vercel · MongoDB Atlas · Helius RPC

Smart Contract

Program ID (Devnet): kW2w2pHhAP8hFGRLganziunchKu6tjaXyomvF6jxNpj

The Anchor program manages atomic escrow for NFT-backed luxury asset sales:

Instruction Description
initialize_config Configure Squads multisig as treasury authority
initialize Create escrow PDA, lock NFT in vault
exchange Buyer deposits SOL to escrow
confirm_delivery Release NFT to buyer, split funds (97% seller / 3% treasury)
refund_buyer Refund on dispute or timeout
cancel_escrow Cancel sale, return NFT + funds
mint_nft Admin-gated NFT creation
freeze_nft / burn_nft Lock or destroy fraudulent assets
update_price Change listing price
admin_transfer Squads-gated fund movement

Pool Lifecycle

OPEN → FILLED → FUNDED → CUSTODY → ACTIVE → LISTED → SOLD → DISTRIBUTED
  │       │        │         │        │        │       │         │
  │       │        │         │        │        │       │         └─ Proceeds to holders
  │       │        │         │        │        │       └─ Watch sells on market
  │       │        │         │        │        └─ Listed for resale
  │       │        │         │        └─ Tokens tradeable on Bags DEX
  │       │        │         └─ LuxHub receives physical watch
  │       │        └─ Vendor paid 97%
  │       └─ Funding target reached
  └─ Accepting contributions

Access

LuxHub is not open for public contributions at this time. If you're interested in partnering, integrating, or joining the team, reach out:


Security

LuxHub implements defense-in-depth across on-chain and off-chain layers:

Layer Protection
On-chain escrow Funds held in program-owned PDA — not LuxHub wallets
Squads multisig All treasury operations require M-of-N approval
TX verification Every fund movement verified on Solana before database update
Wallet signature auth Ed25519 verification on protected API endpoints
PII encryption AES-256-GCM for sensitive data (shipping addresses)
Escrow timeouts Auto-cancel after 14 days if vendor doesn't ship
Dispute system 7-day SLA with admin escalation and refund authority
Rate limiting Strict limits on purchase and AI endpoints
Admin gating ADMIN_WALLETS env var restricts sensitive operations

See SECURITY.md for our vulnerability disclosure policy.


Roadmap

v1.0: Launch Readiness ✅ (shipped 2026-03-23)

  • End-to-end buy, offer, vendor, and pool flows validated on devnet
  • Security hardening — centralized cluster config, TX verification with replay prevention, Sentry monitoring
  • Multi-treasury tokenomics — 3-wallet revenue routing (Marketplace, Pools, Partner)
  • Marketplace UX — multi-image galleries, 5-grade condition grading, search/filter, drag-and-drop uploads
  • Mobile responsive — 2-column grids, bottom-sheet modals, human-verified at 430px
  • Vendor demo readiness — polished onboarding wizard, chrome glass dashboard, admin approval flow
  • Chrome glass email templates via Resend (17 notification types)
  • useEffectiveWallet hook deployed app-wide (Privy + wallet adapter bridge)
  • 47 requirements satisfied across 6 phases, 20 plans, 152 commits

v1.1: Mainnet Launch (Current)

  • Deploy Anchor program to mainnet-beta
  • Initialize EscrowConfig + Bags partner config PDA on mainnet
  • Switch Irys to mainnet storage
  • Offer countdown timers and withdrawal UI
  • Squads multisig end-to-end on mainnet
  • First vendor onboarding (JC Gold Jewelers, Miami)
  • Community building

v2.0: Scale

  • Advanced analytics dashboards
  • API for third-party integrations
  • Multi-vendor support
  • Enhanced vendor KYC

Data Models

LuxHub uses 18 Mongoose schemas covering the full marketplace lifecycle:

Model Purpose
User Accounts, linked wallets, roles, portfolio
Vendor Business profiles, KYC, verification status
Asset Physical item metadata, authentication data
NFT On-chain NFT records, mint addresses, royalties
Escrow Direct sale escrow with dispute + shipping tracking
Pool Tokenized ownership pools with participant tracking
Transaction All marketplace transactions with 3% auto-royalty
PoolDistribution Resale proceeds split among token holders
Offer Purchase offers with counter-offer support
MintRequest Vendor NFT mint request workflow
Notification User notification system
SavedAddress AES-256-GCM encrypted shipping addresses
DelistRequest Vendor delisting request workflow
AdminRole Admin permissions and access control
GlobalAnalytics Platform-wide statistics
UserAnalytics User portfolio tracking
VendorAnalytics Vendor performance metrics
TreasuryDeposit Treasury fund tracking

Partners

Bags      Squads Protocol      Helius      Metaplex      Privy


Connect


Disclaimer

This software is provided "as is" with no warranty. Use at your own risk — LuxHub is not responsible for any loss of funds or digital assets. Nothing on this platform constitutes financial advice or an offer of securities. See our Terms of Service for full details.


License

This project is licensed under CC-BY-NC-ND-4.0 — you may share with attribution, but commercial use and derivatives are not permitted without explicit permission.


LuxHub — programmable trust for luxury commerce.

About

Authenticated Luxury On-Chain NFT-backed luxury timepieces with verified provenance, secure escrow, and tokenized asset pools.

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Used by

Contributors

Languages